Add personal/team note visibility and edit history.

Notes can be marked personal or team, with revision snapshots and restore from the notes UI.

apps/api/prisma/migrations/20260927140000_note_visibility_revisions/migration.sql

@@ -0,0 +1,40 @@
+-- AlterTable
+ALTER TABLE "Note" ADD COLUMN "visibility" TEXT NOT NULL DEFAULT 'team';
+
+-- CreateIndex
+CREATE INDEX "Note_organizationId_visibility_idx" ON "Note"("organizationId", "visibility");
+
+-- CreateTable
+CREATE TABLE "NoteRevision" (
+    "id" TEXT NOT NULL,
+    "organizationId" TEXT NOT NULL,
+    "noteId" TEXT NOT NULL,
+    "editorId" TEXT,
+    "title" TEXT,
+    "body" TEXT NOT NULL,
+    "noteType" TEXT NOT NULL,
+    "visibility" TEXT NOT NULL DEFAULT 'team',
+    "tags" TEXT[] DEFAULT ARRAY[]::TEXT[],
+    "checklist" JSONB,
+    "createdAt" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+
+    CONSTRAINT "NoteRevision_pkey" PRIMARY KEY ("id")
+);
+
+-- CreateIndex
+CREATE INDEX "NoteRevision_noteId_createdAt_idx" ON "NoteRevision"("noteId", "createdAt");
+
+-- CreateIndex
+CREATE INDEX "NoteRevision_organizationId_idx" ON "NoteRevision"("organizationId");
+
+-- CreateIndex
+CREATE INDEX "NoteRevision_editorId_idx" ON "NoteRevision"("editorId");
+
+-- AddForeignKey
+ALTER TABLE "NoteRevision" ADD CONSTRAINT "NoteRevision_organizationId_fkey" FOREIGN KEY ("organizationId") REFERENCES "Organization"("id") ON DELETE CASCADE ON UPDATE CASCADE;
+
+-- AddForeignKey
+ALTER TABLE "NoteRevision" ADD CONSTRAINT "NoteRevision_noteId_fkey" FOREIGN KEY ("noteId") REFERENCES "Note"("id") ON DELETE CASCADE ON UPDATE CASCADE;
+
+-- AddForeignKey
+ALTER TABLE "NoteRevision" ADD CONSTRAINT "NoteRevision_editorId_fkey" FOREIGN KEY ("editorId") REFERENCES "User"("id") ON DELETE SET NULL ON UPDATE CASCADE;

apps/api/prisma/schema.prisma

@@ -162,6 +162,7 @@ model Organization {
   deals             Deal[]
   activities        Activity[]
   notes             Note[]
+  noteRevisions     NoteRevision[]
   customFields      CustomFieldDefinition[]
   products          Product[]
   notifications     Notification[]
@@ -231,6 +232,7 @@ model User {
   activities     Activity[]   @relation("ActivityAssignee")
   createdActivities Activity[] @relation("ActivityCreator")
   notes          Note[]       @relation("NoteAuthor")
+  noteRevisions  NoteRevision[] @relation("NoteRevisionEditor")
   noteAttachments NoteAttachment[] @relation("NoteAttachmentUploader")
   notifications  Notification[]
   salesGoals     SalesGoal[]  @relation("SalesGoalUser")
@@ -591,14 +593,18 @@ model Note {
   activity       Activity?    @relation(fields: [activityId], references: [id], onDelete: SetNull)
   authorId       String?
   author         User?        @relation("NoteAuthor", fields: [authorId], references: [id], onDelete: SetNull)
+  /// team = قابل‌مشاهده برای تیم/سازمان در محدوده پرونده | personal = فقط نویسنده
+  visibility     String       @default("team")
   attachments    NoteAttachment[]
   aiSuggestion   NoteAiSuggestion?
+  revisions      NoteRevision[]
   createdAt      DateTime     @default(now())
   updatedAt      DateTime     @updatedAt
 
   @@index([organizationId, pinned, updatedAt])
   @@index([organizationId, noteType, updatedAt])
   @@index([organizationId, reminderAt])
+  @@index([organizationId, visibility])
   @@index([personId])
   @@index([companyId])
   @@index([dealId])
@@ -606,6 +612,28 @@ model Note {
   @@index([authorId])
 }
 
+/// اسنپ‌شات متن قبل از هر ویرایش معنادار یادداشت
+model NoteRevision {
+  id             String       @id @default(cuid())
+  organizationId String
+  organization   Organization @relation(fields: [organizationId], references: [id], onDelete: Cascade)
+  noteId         String
+  note           Note         @relation(fields: [noteId], references: [id], onDelete: Cascade)
+  editorId       String?
+  editor         User?        @relation("NoteRevisionEditor", fields: [editorId], references: [id], onDelete: SetNull)
+  title          String?
+  body           String
+  noteType       String
+  visibility     String       @default("team")
+  tags           String[]     @default([])
+  checklist      Json?
+  createdAt      DateTime     @default(now())
+
+  @@index([noteId, createdAt])
+  @@index([organizationId])
+  @@index([editorId])
+}
+
 model NoteAttachment {
   id             String       @id @default(cuid())
   organizationId String

apps/api/src/common/record-scope.ts

@@ -61,18 +61,30 @@ export function assigneeWhere(
   return { assigneeId: { in: ids } };
 }
 
-/** یادداشت: نویسنده یا پرونده‌های تحت مالکیت در محدوده دید */
+/** یادداشت: نویسنده یا پرونده‌های تحت مالکیت در محدوده دید + محرمانگی شخصی */
 export function noteAccessWhere(
   actor: Pick<Actor, 'userId' | 'role' | 'dataVisibility' | 'visibleUserIds'>,
 ): Prisma.NoteWhereInput {
   const ids = scopedOwnerIds(actor);
-  if (!ids) return {};
+  const personalGate: Prisma.NoteWhereInput = {
-  return {
     OR: [
-      { authorId: { in: ids } },
+      { visibility: { not: 'personal' } },
-      { deal: { ownerId: { in: ids } } },
+      { visibility: 'personal', authorId: actor.userId },
-      { person: { ownerId: { in: ids } } },
+      // رکوردهای قدیمی بدون فیلد visibility در DB با default team می‌آیند
-      { company: { ownerId: { in: ids } } },
+    ],
+  };
+  if (!ids) return personalGate;
+  return {
+    AND: [
+      personalGate,
+      {
+        OR: [
+          { authorId: { in: ids } },
+          { deal: { ownerId: { in: ids } } },
+          { person: { ownerId: { in: ids } } },
+          { company: { ownerId: { in: ids } } },
+        ],
+      },
     ],
   };
 }

apps/api/src/notes/dto.ts

@@ -28,6 +28,8 @@ const NOTE_TYPES = [
   'personal',
 ] as const;
 
+const NOTE_VISIBILITIES = ['team', 'personal'] as const;
+
 const NOTE_SORTS = ['updatedAt', 'createdAt', 'reminderAt'] as const;
 
 export class NoteChecklistItemDto {
@@ -74,6 +76,10 @@ export class ListNotesQueryDto {
   @IsIn(NOTE_TYPES)
   noteType?: (typeof NOTE_TYPES)[number];
 
+  @IsOptional()
+  @IsIn(NOTE_VISIBILITIES)
+  visibility?: (typeof NOTE_VISIBILITIES)[number];
+
   @IsOptional()
   @IsIn(NOTE_SORTS)
   sort?: (typeof NOTE_SORTS)[number];
@@ -107,6 +113,10 @@ export class CreateNoteDto {
   @IsIn(NOTE_TYPES)
   noteType?: (typeof NOTE_TYPES)[number];
 
+  @IsOptional()
+  @IsIn(NOTE_VISIBILITIES)
+  visibility?: (typeof NOTE_VISIBILITIES)[number];
+
   @IsOptional()
   @IsBoolean()
   pinned?: boolean;
@@ -180,6 +190,10 @@ export class UpdateNoteDto {
   @IsIn(NOTE_TYPES)
   noteType?: (typeof NOTE_TYPES)[number];
 
+  @IsOptional()
+  @IsIn(NOTE_VISIBILITIES)
+  visibility?: (typeof NOTE_VISIBILITIES)[number];
+
   @IsOptional()
   @IsBoolean()
   pinned?: boolean;

apps/api/src/notes/notes.controller.ts

@@ -19,8 +19,15 @@ import { CurrentUser } from '../auth/current-user.decorator';
 import { CreateNoteDto, ListNotesQueryDto, UpdateNoteDto, ApplyNoteAiSuggestionDto } from './dto';
 import { NoteAiService } from './note-ai.service';
 import { NotesService } from './notes.service';
+import type { DataVisibility } from '@mento/shared';
 
-type AuthUser = { organizationId: string; userId: string; role: string };
+type AuthUser = {
+  organizationId: string;
+  userId: string;
+  role: string;
+  dataVisibility?: DataVisibility;
+  visibleUserIds?: string[] | null;
+};
 
 @Controller('notes')
 @UseGuards(JwtAuthGuard)
@@ -43,12 +50,32 @@ export class NotesController {
       dealId: query.dealId,
       tag: query.tag,
       noteType: query.noteType,
+      visibility: query.visibility,
       sort: query.sort,
       page: query.page ?? 1,
       limit: query.limit ?? 50,
     });
   }
 
+  @Get(':id/revisions')
+  listRevisions(@CurrentUser() user: AuthUser, @Param('id') id: string) {
+    return this.notesService.listRevisions(user.organizationId, id, user);
+  }
+
+  @Post(':id/revisions/:revisionId/restore')
+  restoreRevision(
+    @CurrentUser() user: AuthUser,
+    @Param('id') id: string,
+    @Param('revisionId') revisionId: string,
+  ) {
+    return this.notesService.restoreRevision(
+      user.organizationId,
+      id,
+      revisionId,
+      user,
+    );
+  }
+
   @Get(':id')
   get(@CurrentUser() user: AuthUser, @Param('id') id: string) {
     return this.notesService.get(user.organizationId, id, user);

apps/api/src/notes/notes.service.ts

@@ -8,6 +8,8 @@ import type {
   NoteAttachmentDto,
   NoteChecklistItemDto,
   NoteDto,
+  NoteRevisionDto,
+  NoteVisibility,
   PaginatedResponse,
   UpdateNoteRequest,
 } from '@mento/shared';
@@ -22,13 +24,17 @@ import {
   ownerWhere,
 } from '../common/record-scope';
 
-type NoteActor = Pick<Actor, 'userId' | 'role'>;
+type NoteActor = Pick<
+  Actor,
+  'userId' | 'role' | 'dataVisibility' | 'visibleUserIds'
+>;
 
 type NoteRow = {
   id: string;
   title: string | null;
   body: string;
   noteType: string;
+  visibility: string;
   pinned: boolean;
   color: string | null;
   tags: string[];
@@ -50,6 +56,7 @@ type NoteRow = {
     sizeBytes: number;
     createdAt: Date;
   }>;
+  _count?: { revisions: number };
 };
 
 const include = {
@@ -68,6 +75,7 @@ const include = {
     },
     orderBy: { createdAt: 'asc' as const },
   },
+  _count: { select: { revisions: true } },
 } satisfies Prisma.NoteInclude;
 
 const MAX_ATTACHMENT_BYTES = 10 * 1024 * 1024;
@@ -113,6 +121,7 @@ export class NotesService {
       dealId?: string;
       tag?: string;
       noteType?: string;
+      visibility?: string;
       sort?: 'updatedAt' | 'createdAt' | 'reminderAt';
       page?: number;
       limit?: number;
@@ -138,6 +147,9 @@ export class NotesService {
       ...(opts.companyId ? { companyId: opts.companyId } : {}),
       ...(opts.dealId ? { dealId: opts.dealId } : {}),
       ...(opts.noteType ? { noteType: opts.noteType } : {}),
+      ...(opts.visibility === 'personal' || opts.visibility === 'team'
+        ? { visibility: opts.visibility }
+        : {}),
       ...(opts.tag?.trim() ? { tags: { has: opts.tag.trim() } } : {}),
       ...(search
         ? { AND: [access, search] }
@@ -202,6 +214,7 @@ export class NotesService {
         title: emptyToNull(dto.title),
         body: dto.body.trim(),
         noteType: dto.noteType?.trim() || 'general',
+        visibility: normalizeVisibility(dto.visibility),
         pinned: dto.pinned ?? false,
         color: emptyToNull(dto.color) ?? 'default',
         tags: normalizeTags(dto.tags),
@@ -227,13 +240,19 @@ export class NotesService {
     actor: NoteActor,
     dto: UpdateNoteRequest,
   ): Promise<NoteDto> {
-    await this.ensureExists(organizationId, id, actor);
+    const existing = await this.prisma.note.findFirst({
+      where: { id, organizationId, ...noteAccessWhere(actor) },
+    });
+    if (!existing) throw new NotFoundException('یادداشت پیدا نشد');
     await this.assertLinks(organizationId, actor, dto);
 
     const data: Prisma.NoteUncheckedUpdateInput = {};
     if ('title' in dto) data.title = emptyToNull(dto.title);
     if (dto.body !== undefined) data.body = dto.body.trim();
     if (dto.noteType !== undefined) data.noteType = dto.noteType.trim() || 'general';
+    if (dto.visibility !== undefined) {
+      data.visibility = normalizeVisibility(dto.visibility);
+    }
     if (dto.pinned !== undefined) data.pinned = dto.pinned;
     if ('color' in dto) data.color = emptyToNull(dto.color) ?? 'default';
     if (dto.tags !== undefined) data.tags = normalizeTags(dto.tags);
@@ -259,6 +278,49 @@ export class NotesService {
       data.activityId = emptyToNull(dto.activityId ?? null);
     }
 
+    const nextTitle =
+      'title' in dto ? emptyToNull(dto.title) : existing.title;
+    const nextBody = dto.body !== undefined ? dto.body.trim() : existing.body;
+    const nextType =
+      dto.noteType !== undefined
+        ? dto.noteType.trim() || 'general'
+        : existing.noteType;
+    const nextVisibility =
+      dto.visibility !== undefined
+        ? normalizeVisibility(dto.visibility)
+        : normalizeVisibility(existing.visibility);
+    const nextTags =
+      dto.tags !== undefined ? normalizeTags(dto.tags) : existing.tags;
+    const nextChecklist =
+      dto.checklist !== undefined
+        ? parseChecklist(dto.checklist)
+        : parseChecklist(existing.checklist);
+
+    const contentChanged =
+      (nextTitle ?? '') !== (existing.title ?? '') ||
+      nextBody !== existing.body ||
+      nextType !== existing.noteType ||
+      nextVisibility !== normalizeVisibility(existing.visibility) ||
+      JSON.stringify(nextTags) !== JSON.stringify(existing.tags) ||
+      JSON.stringify(nextChecklist) !==
+        JSON.stringify(parseChecklist(existing.checklist));
+
+    if (contentChanged) {
+      await this.prisma.noteRevision.create({
+        data: {
+          organizationId,
+          noteId: id,
+          editorId: actor.userId,
+          title: existing.title,
+          body: existing.body,
+          noteType: existing.noteType,
+          visibility: normalizeVisibility(existing.visibility),
+          tags: existing.tags,
+          checklist: existing.checklist ?? Prisma.JsonNull,
+        },
+      });
+    }
+
     const row = await this.prisma.note.update({
       where: { id },
       data,
@@ -267,6 +329,52 @@ export class NotesService {
     return this.toDto(row);
   }
 
+  async listRevisions(
+    organizationId: string,
+    noteId: string,
+    actor: NoteActor,
+  ): Promise<NoteRevisionDto[]> {
+    await this.ensureExists(organizationId, noteId, actor);
+    const rows = await this.prisma.noteRevision.findMany({
+      where: { noteId, organizationId },
+      include: { editor: { select: { id: true, fullName: true } } },
+      orderBy: { createdAt: 'desc' },
+      take: 50,
+    });
+    return rows.map((row) => ({
+      id: row.id,
+      title: row.title,
+      body: row.body,
+      noteType: row.noteType,
+      visibility: normalizeVisibility(row.visibility),
+      tags: row.tags,
+      checklist: parseChecklist(row.checklist),
+      editor: row.editor,
+      createdAt: row.createdAt.toISOString(),
+    }));
+  }
+
+  async restoreRevision(
+    organizationId: string,
+    noteId: string,
+    revisionId: string,
+    actor: NoteActor,
+  ): Promise<NoteDto> {
+    await this.ensureExists(organizationId, noteId, actor);
+    const revision = await this.prisma.noteRevision.findFirst({
+      where: { id: revisionId, noteId, organizationId },
+    });
+    if (!revision) throw new NotFoundException('نسخه پیدا نشد');
+    return this.update(organizationId, noteId, actor, {
+      title: revision.title,
+      body: revision.body,
+      noteType: revision.noteType,
+      visibility: normalizeVisibility(revision.visibility),
+      tags: revision.tags,
+      checklist: parseChecklist(revision.checklist),
+    });
+  }
+
   async togglePin(
     organizationId: string,
     id: string,
@@ -491,6 +599,7 @@ export class NotesService {
       title: row.title,
       body: row.body,
       noteType: row.noteType,
+      visibility: normalizeVisibility(row.visibility),
       pinned: row.pinned,
       color: row.color,
       tags: row.tags,
@@ -509,6 +618,7 @@ export class NotesService {
       activity: row.activity,
       author: row.author,
       attachments: (row.attachments ?? []).map((a) => this.toAttachmentDto(a)),
+      revisionCount: row._count?.revisions ?? 0,
       createdAt: row.createdAt.toISOString(),
       updatedAt: row.updatedAt.toISOString(),
     };
@@ -537,6 +647,10 @@ function emptyToNull(value?: string | null): string | null {
   return trimmed.length ? trimmed : null;
 }
 
+function normalizeVisibility(value?: string | null): NoteVisibility {
+  return value === 'personal' ? 'personal' : 'team';
+}
+
 function normalizeTags(tags?: string[]): string[] {
   if (!tags?.length) return [];
   const seen = new Set<string>();

apps/web/src/views/NotesView.vue

@@ -21,11 +21,14 @@ import type {
   NoteAiSuggestionDto,
   NoteChecklistItemDto,
   NoteDto,
+  NoteRevisionDto,
   NoteType,
+  NoteVisibility,
   PaginatedResponse,
   PersonDto,
   PipelineBoardDto,
 } from '@mento/shared';
+import { NOTE_VISIBILITY_LABELS } from '@mento/shared';
 
 type ViewMode = 'grid' | 'list';
 type SortKey = 'updatedAt' | 'createdAt' | 'reminderAt';
@@ -39,6 +42,7 @@ const saving = ref(false);
 const error = ref('');
 const q = ref('');
 const typeFilter = ref<NoteType | 'all'>('all');
+const visibilityFilter = ref<NoteVisibility | 'all'>('all');
 const sortKey = ref<SortKey>('updatedAt');
 const viewMode = ref<ViewMode>('grid');
 const notes = ref<NoteDto[]>([]);
@@ -67,10 +71,17 @@ const draftReminder = ref('');
 const draftLocation = ref('');
 const draftAnalyze = ref(true);
 const draftPinned = ref(false);
+const draftVisibility = ref<NoteVisibility>('team');
 const draftChecklist = ref<NoteChecklistItemDto[]>([]);
 const draftFiles = ref<File[]>([]);
 const existingAttachments = ref<NoteAttachmentDto[]>([]);
 
+const historyOpen = ref(false);
+const historyLoading = ref(false);
+const historyError = ref('');
+const historyNoteId = ref<string | null>(null);
+const historyItems = ref<NoteRevisionDto[]>([]);
+
 const imageInput = ref<HTMLInputElement | null>(null);
 const fileInput = ref<HTMLInputElement | null>(null);
 const audioInput = ref<HTMLInputElement | null>(null);
@@ -127,6 +138,10 @@ const typeLabelMap: Record<string, string> = {
 
 const editorTitle = computed(() => (editingId.value ? 'ویرایش' : 'یادداشت جدید'));
 const draftColorCss = computed(() => colorToCss(draftColor.value));
+const historyNoteRevisionCount = computed(() => {
+  if (!editingId.value) return 0;
+  return notes.value.find((n) => n.id === editingId.value)?.revisionCount ?? 0;
+});
 const personName = (id: string) =>
   people.value.find((p) => p.id === id)?.fullName ?? '';
 
@@ -314,6 +329,10 @@ async function load() {
         params: {
           q: q.value || undefined,
           noteType: typeFilter.value === 'all' ? undefined : typeFilter.value,
+          visibility:
+            visibilityFilter.value === 'all'
+              ? undefined
+              : visibilityFilter.value,
           sort: sortKey.value,
           limit: 100,
         },
@@ -361,6 +380,7 @@ function resetDraft() {
   draftLocation.value = '';
   draftAnalyze.value = true;
   draftPinned.value = false;
+  draftVisibility.value = 'team';
   draftChecklist.value = [];
   draftFiles.value = [];
   existingAttachments.value = [];
@@ -384,6 +404,8 @@ function openEditor(mode: OpenMode = 'default', note?: NoteDto) {
     draftLocation.value = note.locationText ?? '';
     draftAnalyze.value = note.analyzeEnabled !== false;
     draftPinned.value = note.pinned;
+    draftVisibility.value =
+      note.visibility === 'personal' ? 'personal' : 'team';
     draftChecklist.value = [...(note.checklist ?? [])];
     draftFiles.value = [];
     existingAttachments.value = [...note.attachments];
@@ -487,6 +509,7 @@ async function saveNote() {
       title: draftTitle.value.trim() || null,
       body: body || (checklist.length ? 'چک‌لیست' : ''),
       noteType: draftType.value,
+      visibility: draftVisibility.value,
       color: draftColor.value === 'default' ? 'default' : draftColor.value,
       tags: parseTags(draftTags.value),
       personId: draftPersonId.value || null,
@@ -532,6 +555,56 @@ async function saveNote() {
   }
 }
 
+async function openHistory(note: NoteDto) {
+  menuOpenId.value = null;
+  historyNoteId.value = note.id;
+  historyOpen.value = true;
+  historyLoading.value = true;
+  historyError.value = '';
+  historyItems.value = [];
+  try {
+    const { data } = await api.get<NoteRevisionDto[]>(
+      `/notes/${note.id}/revisions`,
+    );
+    historyItems.value = data;
+  } catch (e) {
+    historyError.value = axios.isAxiosError(e)
+      ? String(
+          (e.response?.data as { message?: string })?.message ??
+            'بارگذاری تاریخچه ناموفق بود.',
+        )
+      : 'بارگذاری تاریخچه ناموفق بود.';
+  } finally {
+    historyLoading.value = false;
+  }
+}
+
+function closeHistory() {
+  historyOpen.value = false;
+  historyNoteId.value = null;
+  historyItems.value = [];
+  historyError.value = '';
+}
+
+async function restoreRevision(revisionId: string) {
+  if (!historyNoteId.value) return;
+  if (!confirm('این نسخه جایگزین متن فعلی شود؟')) return;
+  try {
+    await api.post(
+      `/notes/${historyNoteId.value}/revisions/${revisionId}/restore`,
+    );
+    closeHistory();
+    await load();
+  } catch (e) {
+    historyError.value = axios.isAxiosError(e)
+      ? String(
+          (e.response?.data as { message?: string })?.message ??
+            'بازگردانی ناموفق بود.',
+        )
+      : 'بازگردانی ناموفق بود.';
+  }
+}
+
 async function togglePin(id: string) {
   menuOpenId.value = null;
   await api.patch(`/notes/${id}/pin`);
@@ -587,6 +660,9 @@ function onDocClick(ev: MouseEvent) {
 watch(typeFilter, () => {
   void load();
 });
+watch(visibilityFilter, () => {
+  void load();
+});
 watch(sortKey, () => {
   void load();
 });
@@ -636,6 +712,31 @@ onBeforeUnmount(() => {
           <span v-if="chip.value !== 'all'" class="dot" />
           {{ chip.label }}
         </button>
+        <span class="chip-sep" aria-hidden="true" />
+        <button
+          type="button"
+          class="chip"
+          :class="{ active: visibilityFilter === 'all' }"
+          @click="visibilityFilter = 'all'"
+        >
+          همه دسترسی‌ها
+        </button>
+        <button
+          type="button"
+          class="chip tone-team"
+          :class="{ active: visibilityFilter === 'team' }"
+          @click="visibilityFilter = 'team'"
+        >
+          تیمی
+        </button>
+        <button
+          type="button"
+          class="chip tone-private"
+          :class="{ active: visibilityFilter === 'personal' }"
+          @click="visibilityFilter = 'personal'"
+        >
+          فقط من
+        </button>
       </div>
       <div class="toolbar-end">
         <div class="view-toggle" role="group" aria-label="نمای لیست">
@@ -725,6 +826,31 @@ onBeforeUnmount(() => {
         <span v-if="chip.value !== 'all'" class="dot" />
         {{ chip.label }}
       </button>
+      <span class="chip-sep" aria-hidden="true" />
+      <button
+        type="button"
+        class="chip"
+        :class="{ active: visibilityFilter === 'all' }"
+        @click="visibilityFilter = 'all'"
+      >
+        همه دسترسی‌ها
+      </button>
+      <button
+        type="button"
+        class="chip tone-team"
+        :class="{ active: visibilityFilter === 'team' }"
+        @click="visibilityFilter = 'team'"
+      >
+        تیمی
+      </button>
+      <button
+        type="button"
+        class="chip tone-private"
+        :class="{ active: visibilityFilter === 'personal' }"
+        @click="visibilityFilter = 'personal'"
+      >
+        فقط من
+      </button>
     </div>
 
     <p v-if="loading" class="state-msg">در حال بارگذاری…</p>
@@ -763,6 +889,13 @@ onBeforeUnmount(() => {
               <button type="button" @click="togglePin(note.id)">
                 {{ note.pinned ? 'برداشتن سنجاق' : 'سنجاق کردن' }}
               </button>
+              <button
+                v-if="(note.revisionCount ?? 0) > 0"
+                type="button"
+                @click="openHistory(note)"
+              >
+                تاریخچه ویرایش
+              </button>
               <button type="button" class="danger" @click="removeNote(note.id)">حذف</button>
             </div>
           </div>
@@ -819,6 +952,16 @@ onBeforeUnmount(() => {
           <span class="type-badge" :class="`tone-${typeTone(String(note.noteType))}`">
             {{ typeLabel(String(note.noteType)) }}
           </span>
+          <span
+            class="vis-badge"
+            :class="note.visibility === 'personal' ? 'private' : 'team'"
+          >
+            {{
+              note.visibility === 'personal'
+                ? NOTE_VISIBILITY_LABELS.personal
+                : NOTE_VISIBILITY_LABELS.team
+            }}
+          </span>
           <span v-if="pendingAi[note.id]" class="ai-badge" title="پیشنهاد AI">
             <UiIcon name="sparkle" :size="12" />
             AI
@@ -891,6 +1034,19 @@ onBeforeUnmount(() => {
           <header class="panel-head">
             <h2>{{ editorTitle }}</h2>
             <div class="panel-head-actions">
+              <button
+                v-if="editingId && historyNoteRevisionCount > 0"
+                type="button"
+                class="btn-ghost history-btn"
+                @click="
+                  openHistory({
+                    id: editingId,
+                    revisionCount: historyNoteRevisionCount,
+                  } as NoteDto)
+                "
+              >
+                تاریخچه
+              </button>
               <button
                 type="button"
                 class="btn-save mobile-only-flex"
@@ -1028,6 +1184,15 @@ onBeforeUnmount(() => {
                   </option>
                 </select>
               </label>
+              <label class="field">
+                <span>سطح دسترسی</span>
+                <select v-model="draftVisibility">
+                  <option value="team">{{ NOTE_VISIBILITY_LABELS.team }}</option>
+                  <option value="personal">
+                    {{ NOTE_VISIBILITY_LABELS.personal }}
+                  </option>
+                </select>
+              </label>
               <div class="field-row">
                 <label class="field">
                   <span>مرتبط با — مشتری</span>
@@ -1075,6 +1240,13 @@ onBeforeUnmount(() => {
               <span v-if="draftPersonId" class="tag-chip">{{ personName(draftPersonId) }}</span>
               <span v-if="draftDealId" class="tag-chip">معامله</span>
               <span v-if="draftLocation" class="tag-chip">{{ draftLocation }}</span>
+              <span class="tag-chip">
+                {{
+                  draftVisibility === 'personal'
+                    ? NOTE_VISIBILITY_LABELS.personal
+                    : NOTE_VISIBILITY_LABELS.team
+                }}
+              </span>
             </div>
 
             <NoteAiSuggestionPanel
@@ -1178,6 +1350,15 @@ onBeforeUnmount(() => {
                   </option>
                 </select>
               </label>
+              <label class="field">
+                <span>سطح دسترسی</span>
+                <select v-model="draftVisibility">
+                  <option value="team">{{ NOTE_VISIBILITY_LABELS.team }}</option>
+                  <option value="personal">
+                    {{ NOTE_VISIBILITY_LABELS.personal }}
+                  </option>
+                </select>
+              </label>
               <label class="field">
                 <span>یادآوری</span>
                 <JalaliDateInput v-model="draftReminder" mode="datetime" icon="bell" />
@@ -1201,6 +1382,58 @@ onBeforeUnmount(() => {
         </aside>
       </div>
     </Teleport>
+
+    <Teleport to="body">
+      <div v-if="historyOpen" class="history-root">
+        <div class="history-backdrop" @click="closeHistory" />
+        <aside class="history-panel" role="dialog" aria-label="تاریخچه ویرایش">
+          <header class="history-head">
+            <h2>تاریخچه ویرایش</h2>
+            <button type="button" class="icon-btn" @click="closeHistory">
+              <UiIcon name="x" :size="20" />
+            </button>
+          </header>
+          <p v-if="historyLoading" class="state-msg">در حال بارگذاری…</p>
+          <p v-else-if="historyError" class="banner-error">{{ historyError }}</p>
+          <p v-else-if="!historyItems.length" class="state-msg">
+            هنوز نسخه‌ای ذخیره نشده.
+          </p>
+          <ul v-else class="history-list">
+            <li v-for="rev in historyItems" :key="rev.id" class="history-item">
+              <div class="history-meta">
+                <strong>
+                  {{ formatJalaliDay(new Date(rev.createdAt)) }}
+                  ·
+                  {{ formatClockFa(new Date(rev.createdAt)) }}
+                </strong>
+                <span v-if="rev.editor?.fullName" class="muted">
+                  {{ rev.editor.fullName }}
+                </span>
+                <span
+                  class="vis-badge"
+                  :class="rev.visibility === 'personal' ? 'private' : 'team'"
+                >
+                  {{
+                    rev.visibility === 'personal'
+                      ? NOTE_VISIBILITY_LABELS.personal
+                      : NOTE_VISIBILITY_LABELS.team
+                  }}
+                </span>
+              </div>
+              <h4 v-if="rev.title">{{ rev.title }}</h4>
+              <p class="history-body">{{ previewBody(rev.body) }}</p>
+              <button
+                type="button"
+                class="btn-ghost"
+                @click="restoreRevision(rev.id)"
+              >
+                بازگردانی این نسخه
+              </button>
+            </li>
+          </ul>
+        </aside>
+      </div>
+    </Teleport>
   </section>
 </template>
 
@@ -1336,6 +1569,34 @@ onBeforeUnmount(() => {
   background: #f5f3ff;
   border-color: #c4b5fd;
 }
+.chip-sep {
+  width: 1px;
+  align-self: stretch;
+  margin: 0.15rem 0.2rem;
+  background: #e2e8f0;
+  flex-shrink: 0;
+}
+.chip.tone-team {
+  color: #0f766e;
+}
+.chip.tone-team.active {
+  background: #ccfbf1;
+  border-color: #5eead4;
+  color: #0f766e;
+}
+.chip.tone-private {
+  color: #9a3412;
+}
+.chip.tone-private.active {
+  background: #ffedd5;
+  border-color: #fdba74;
+  color: #9a3412;
+}
+.chip:not([class*='tone-']).active {
+  background: var(--teal);
+  border-color: var(--teal);
+  color: #fff;
+}
 
 .view-toggle {
   display: inline-flex;
@@ -1678,6 +1939,22 @@ onBeforeUnmount(() => {
   background: #f5f3ff;
   color: #7c3aed;
 }
+.vis-badge {
+  font-size: 0.7rem;
+  font-weight: 600;
+  padding: 0.15rem 0.45rem;
+  border-radius: 999px;
+  background: #ecfdf5;
+  color: #0f766e;
+}
+.vis-badge.private {
+  background: #ffedd5;
+  color: #9a3412;
+}
+.vis-badge.team {
+  background: #ecfdf5;
+  color: #0f766e;
+}
 .ai-badge {
   display: inline-flex;
   align-items: center;
@@ -2193,4 +2470,90 @@ onBeforeUnmount(() => {
     font-size: 0.88rem;
   }
 }
+
+.history-btn {
+  padding: 0.35rem 0.65rem;
+  font-size: 0.82rem;
+}
+.history-root {
+  position: fixed;
+  inset: 0;
+  z-index: 120;
+  display: grid;
+  place-items: center;
+  padding: 1rem;
+}
+.history-backdrop {
+  position: absolute;
+  inset: 0;
+  background: rgba(15, 23, 42, 0.45);
+}
+.history-panel {
+  position: relative;
+  z-index: 1;
+  width: min(100%, 480px);
+  max-height: min(88vh, 640px);
+  overflow: auto;
+  background: #fff;
+  border-radius: 12px;
+  box-shadow: 0 18px 50px rgba(15, 23, 42, 0.18);
+  padding: 1rem 1.1rem 1.25rem;
+}
+.history-head {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  gap: 0.75rem;
+  margin-bottom: 0.75rem;
+}
+.history-head h2 {
+  margin: 0;
+  font-size: 1.1rem;
+  font-weight: 650;
+  color: #0f172a;
+}
+.history-list {
+  list-style: none;
+  margin: 0;
+  padding: 0;
+  display: flex;
+  flex-direction: column;
+  gap: 0.85rem;
+}
+.history-item {
+  border: 1px solid #e2e8f0;
+  border-radius: 10px;
+  padding: 0.75rem 0.85rem;
+  display: flex;
+  flex-direction: column;
+  gap: 0.4rem;
+}
+.history-meta {
+  display: flex;
+  flex-wrap: wrap;
+  gap: 0.35rem 0.55rem;
+  align-items: center;
+  font-size: 0.82rem;
+  color: #334155;
+}
+.history-meta .muted {
+  color: #94a3b8;
+}
+.history-item h4 {
+  margin: 0;
+  font-size: 0.92rem;
+  color: #0f172a;
+}
+.history-body {
+  margin: 0;
+  font-size: 0.88rem;
+  color: #475569;
+  white-space: pre-wrap;
+  line-height: 1.55;
+}
+.history-item .btn-ghost {
+  align-self: flex-start;
+  padding: 0.35rem 0.7rem;
+  font-size: 0.8rem;
+}
 </style>

docs/راهنما-و-نقشه-راه.md

@@ -50,7 +50,7 @@
 | مایل‌استون | وضعیت | محتوا |
 |---|---|---|
 | **۱-الف** هسته فروش | انجام شده | مخاطب، کاریز، فعالیت، تقویم، اکسل، نقش، چندارزی، UI |
-| **۱-ب** Smart Notes / AI | تقریباً کامل | Composer، Memory، Ask Montact، Voice-to-Text؛ باقی: Note شخصی/تیمی، تاریخچه ویرایش |
+| **۱-ب** Smart Notes / AI | انجام شده | Composer، Memory، Ask، Voice؛ شخصی/تیمی + تاریخچه ویرایش |
 | **۱-ج** سرنخ و مالی | انجام شده | فرم‌ساز، پیش‌فاکتور، فاکتور/اقساط، هدف فروش |
 | **۱-د** پس‌ازفروش | انجام شده | تیکت، پرتال OTP، پروژه، باشگاه، ته‌حساب |
 | **۱-هـ** گزارش و اتصال | نیمه‌کاره | گزارش و اتوماسیون و SMS عملیاتی آماده؛ API عمومی/وب‌هوک/درگاه هنوز نه |
@@ -99,9 +99,8 @@
 
 1. **API عمومی + وب‌هوک** — اتصال سیستم‌های بیرونی بدون دستکاری هسته  
 2. **پرداخت / پیامک مدیریتی** — اگر مشتری بخواهد از داخل CRM مدیریت کند  
-3. **صیقل Smart Notes** — Note شخصی/تیمی، تاریخچه ویرایش  
+3. **لندینگ Nuxt** — بعد از ثبات UI و استقرار  
-4. **لندینگ Nuxt** — بعد از ثبات UI و استقرار  
+4. **`platform_admin` SaaS** — فقط وقتی فروش حساب چندمستأجری عمومی شروع شود  
-5. **`platform_admin` SaaS** — فقط وقتی فروش حساب چندمستأجری عمومی شروع شود  
 
 ---
 

docs/راهنمای-کاربری.md

@@ -189,9 +189,11 @@
 
 1. **یادداشت‌ها** را باز کنید.  
 2. نوع یادداشت را انتخاب کنید و متن را بنویسید (یا با دکمه **میکروفون** دیکته کنید).  
-3. به شخص/شرکت/معامله وصل کنید؛ در صورت نیاز پین/برچسب/یادآور.  
+3. **سطح دسترسی** را تنظیم کنید: تیمی (پیش‌فرض) یا شخصی (فقط شما).  
-4. پیشنهاد هوشمند یا Memory را فقط بعد از خواندن و **تأیید** اعمال کنید.  
+4. به شخص/شرکت/معامله وصل کنید؛ در صورت نیاز پین/برچسب/یادآور.  
-5. از کادر **از منتکت بپرس** سؤال زبان طبیعی بپرسید (مثلاً «آخرین بار درباره قیمت چه گفت؟»).
+5. پیشنهاد هوشمند یا Memory را فقط بعد از خواندن و **تأیید** اعمال کنید.  
+6. از منوی کارت یا دکمهٔ **تاریخچه** در ویرایش، نسخه‌های قبلی را ببینید و در صورت نیاز بازگردانید.  
+7. از کادر **از منتکت بپرس** سؤال زبان طبیعی بپرسید (مثلاً «آخرین بار درباره قیمت چه گفت؟»).
 
 پیوست فایل روی یادداشت از همان فرم قابل افزودن است.
 

docs/قابلیت‌های-منتکت.md

@@ -117,6 +117,12 @@
 ### پین، برچسب و یادآور
 سازمان‌دهی سریع یادداشت‌ها.
 
+### شخصی / تیمی
+یادداشت تیمی برای تیم؛ شخصی فقط برای نویسنده.
+
+### تاریخچه ویرایش
+نسخه‌های قبلی ذخیره و قابل بازگردانی است.
+
 ### تبدیل به وظیفه
 از روی یادداشت فعالیت ساخته می‌شود.
 

docs/وضعیت-پیشرفت.md

@@ -1,7 +1,7 @@
 # وضعیت پیشرفت منتکت (Montact CRM)
 
 سند زندهٔ کارها — با هر قابلیت جدید همین فایل به‌روز می‌شود.  
-آخرین به‌روزرسانی: ۲۰ شهریور ۱۴۰۵
+آخرین به‌روزرسانی: ۵ مهر ۱۴۰۵
 
 **راهنما:**  
 - `[x]` انجام شده  
@@ -14,6 +14,7 @@
 
 | تاریخ | مورد |
 |---|---|
+| ۱۴۰۵/۷/۵ | صیقل Smart Notes: یادداشت شخصی/تیمی + تاریخچه ویرایش و بازگردانی |
 | ۱۴۰۵/۶/۲۰ | پورسانت کارشناس (درصد پیش‌فرض + تغییر روی فاکتور) و دفتر چک وصل به پرداخت |
 | ۱۴۰۵/۶/۱۹ | انبار داخلی + مانده طرف‌حساب وقتی ته‌حساب وصل نیست؛ خروج کالا با صدور فاکتور |
 | ۱۴۰۵/۶/۱۴ | هم‌تراز کردن ظاهر صفحات قدیمی با زبان بصری منتکت (لیست/فرم/تنظیمات/گزارش) + جداکننده هزارگان روی فیلدهای مبلغ |
@@ -70,8 +71,8 @@
 | [x] | Montact Memory با منبع | خلاصه پایدار + ویرایش/حذف |
 | [x] | Ask Montact | پرسش زبان طبیعی روی یادداشت‌ها / پروفایل / خانه |
 | [x] | Voice-to-Text | دکمه دیکته (Pipecat/STT) روی Note و فرم‌ها |
-| [ ] | Note شخصی در برابر تیمی | |
+| [x] | Note شخصی در برابر تیمی | visibility=team|personal + فیلتر UI |
-| [ ] | تاریخچه ویرایش Note | |
+| [x] | تاریخچه ویرایش Note | NoteRevision + بازگردانی |
 | [ ] | خلاصه خودکار تماس تلفنی کامل | فراتر از دیکته متن |
 
 ---
@@ -132,8 +133,8 @@
 
 1. API عمومی و وب‌هوک خروجی  
 2. پنل پیامکی / درگاه پرداخت (در صورت نیاز کسب‌وکار)  
-3. Note شخصی/تیمی و تاریخچه ویرایش  
+3. ارتقای فایل به MinIO در استقرار بزرگ  
-4. ارتقای فایل به MinIO در استقرار بزرگ  
+4. خلاصه خودکار تماس تلفنی کامل  
 
 ---
 

packages/shared/src/index.ts

@@ -991,6 +991,8 @@ export interface NoteDto {
   title: string | null;
   body: string;
   noteType: NoteType | string;
+  /** team = تیمی | personal = فقط نویسنده */
+  visibility: NoteVisibility;
   pinned: boolean;
   color: string | null;
   tags: string[];
@@ -1004,14 +1006,38 @@ export interface NoteDto {
   activity: { id: string; title: string } | null;
   author: UserSummaryDto | null;
   attachments: NoteAttachmentDto[];
+  /** تعداد نسخه‌های قبلی (برای نمایش دکمه تاریخچه) */
+  revisionCount?: number;
   createdAt: string;
   updatedAt: string;
 }
 
+export type NoteVisibility = "team" | "personal";
+
+export const NOTE_VISIBILITIES: NoteVisibility[] = ["team", "personal"];
+
+export const NOTE_VISIBILITY_LABELS: Record<NoteVisibility, string> = {
+  team: "تیمی",
+  personal: "شخصی (فقط من)",
+};
+
+export interface NoteRevisionDto {
+  id: string;
+  title: string | null;
+  body: string;
+  noteType: string;
+  visibility: NoteVisibility;
+  tags: string[];
+  checklist: NoteChecklistItemDto[];
+  editor: UserSummaryDto | null;
+  createdAt: string;
+}
+
 export interface CreateNoteRequest {
   title?: string;
   body: string;
   noteType?: NoteType | string;
+  visibility?: NoteVisibility;
   pinned?: boolean;
   color?: string;
   tags?: string[];
@@ -1029,6 +1055,7 @@ export interface UpdateNoteRequest {
   title?: string | null;
   body?: string;
   noteType?: NoteType | string;
+  visibility?: NoteVisibility;
   pinned?: boolean;
   color?: string | null;
   tags?: string[];