flowchart LR
  system(["System boundary: Knowledge"])
  A1(["تکنسین میدانی"])
  A2(["تکنسین ارشد"])
  A3(["مدرس"])
  A4(["کیوریتور دانش"])
  A5(["مدیر فنی"])
  A6(["Assistant Provider"])
  UC1(("جستجوی دانش ساختاریافته آسانسور"))
  system --- UC1
  A1 --> UC1
  UC2(("عیب‌یابی نشانه یا کد خطا"))
  system --- UC2
  A2 --> UC2
  UC3(("ورود PDF فارسی و سوالات آزمون"))
  system --- UC3
  A3 --> UC3
  UC4(("بازبینی provenance و confidence"))
  system --- UC4
  A4 --> UC4
  UC5(("ساخت آزمون آموزشی و امتیاز مهارت"))
  system --- UC5
  A5 --> UC5
  UC6(("تولید دیالوگ synthetic آسانسور"))
  system --- UC6
  A6 --> UC6
  UC7(("ساخت offline pack"))
  system --- UC7
  A1 --> UC7
  classDef actor fill:#dbeafe,stroke:#2563eb,color:#0f172a
  classDef usecase fill:#f8fafc,stroke:#64748b,color:#0f172a

flowchart TD
  S1["کیوریتور source و taxonomy را ثبت می‌کند"]
  S2["سیستم PDF و سوالات را همراه provenance parse می‌کند"]
  S1 --> S2
  S3["Review workflow آیتم‌های نامطمئن را اعتبارسنجی می‌کند"]
  S2 --> S3
  S4["تکنسین جستجو می‌کند یا سوال عیب‌یابی می‌پرسد"]
  S3 --> S4
  S5["دستیار facts، hypotheses و safety warnings را جدا می‌کند"]
  S4 --> S5
  S6["مدرس دانش بازبینی‌شده را به آزمون تبدیل می‌کند"]
  S5 --> S6
  S7["مدیر شکاف مهارت و پوشش محتوا را بررسی می‌کند"]
  S6 --> S7
  classDef start fill:#dcfce7,stroke:#16a34a,color:#0f172a
  classDef normal fill:#ffffff,stroke:#2563eb,color:#0f172a
  class S1 start
  class S2 normal
  class S3 normal
  class S4 normal
  class S5 normal
  class S6 normal
  class S7 normal

sequenceDiagram
  autonumber
  participant Technician as Technician
  participant Next_js_UI as Next.js UI
  participant FastAPI as FastAPI
  participant Retrieval as Retrieval
  participant Assistant_Provider as Assistant Provider
  participant Knowledge_Store as Knowledge Store
  participant Review_Queue as Review Queue
  Technician->>Next_js_UI: جستجوی symptom/code
  Next_js_UI->>FastAPI: درخواست troubleshooting
  FastAPI->>Retrieval: واکشی taxonomy، source و evidence
  Retrieval->>Assistant_Provider: ساخت پاسخ با context مستند
  Assistant_Provider->>FastAPI: facts، hypotheses و warnings
  FastAPI->>Review_Queue: علامت‌گذاری آیتم کم‌اطمینان
  FastAPI->>Technician: بازگرداندن پاسخ عیب‌یابی راهنما

block-beta
  columns 3
  B1["Source Registry"]
  B2["Taxonomy"]
  B3["PDF Parser"]
  B4["Review Queue"]
  B5["Search"]
  B6["Assistant"]
  B7["Synthetic Lab"]
  B8["Training"]
  B9["Offline Pack"]

flowchart LR
  subgraph L1["ورود دانش"]
    L1S1["آپلود یا import source"]
    L1S2["Parse PDF/questions"]
    L1S1 --> L1S2
    L1S3["اتصال provenance"]
    L1S2 --> L1S3
  end
  subgraph L2["بازبینی"]
    L2S1["امتیازدهی confidence"]
    L2S2["تایید یا رد"]
    L2S1 --> L2S2
    L2S3["انتشار دانش"]
    L2S2 --> L2S3
  end
  L1S3 --> L2S1
  subgraph L3["یادگیری"]
    L3S1["ساخت آزمون"]
    L3S2["امتیازدهی competency"]
    L3S1 --> L3S2
    L3S3["گزارش gap"]
    L3S2 --> L3S3
  end
  L2S3 --> L3S1
  classDef lane fill:#f8fafc,stroke:#cbd5e1,color:#0f172a

journey
  title Knowledge business journey
  section Discover and act
    کیوریتور source و taxonomy را ثبت می‌کند: 4: User,System
    سیستم PDF و سوالات را همراه provenance parse می‌کند: 5: User,System
    Review workflow آیتم‌های نامطمئن را اعتبارسنجی می‌کند: 3: User,System
    تکنسین جستجو می‌کند یا سوال عیب‌یابی می‌پرسد: 4: User,System
    دستیار facts، hypotheses و safety warnings را جدا می‌کند: 5: User,System
    مدرس دانش بازبینی‌شده را به آزمون تبدیل می‌کند: 3: User,System