← بازگشت به صفحه اصلی
Quality

کیفیت پر شدن بخش‌ها

روی هر بخش کلیک کنید تا ببینید از نظر کیفیت به دنبال چه هستیم، چطور رسیدن به آن را می‌سنجیم، و فهرست توابع/متغیرها (توضیح فارسی و نام انگلیسی در پرانتز) به‌همراه فیلدهای پرشونده را مرور کنید. گروه‌ها: استخراج، پیشینه، ادعا، توصیف، بازنویسی میراث، گفتگو (discover/draft)، و Office Action.

بازنویسی

بازنویسی HTTP / میراث draft.edit

خروجی replacements برای تست محلی؛ کل سند را از صفر بازتولید نمی‌کند. مسیر محصول ویرایش در گروه گفتگو (conversation-draft) است.

توضیح کامل

تابع اجرای بازنویسی (run_draft_rewrite) روی درخواست بازنویسی (DraftRewriteRequest) کار می‌کند. دامنه می‌تواند انتخاب (scope=selection)، بخش (section) یا کل سند با جایگزینی اصطلاح (document + term_replacements) باشد. نوع سند ادعا، توصیف یا هر دو (document_type=claims|description|both) است. مسیر HTTP برای تست multipart است. صف draft.edit.requested و DraftEditHandler در compose باقی‌اند ولی مسیر محصول ویرایش نیستند؛ draft.fragment_edit.* بازنشسته شده.

از نظر کیفیت به دنبال چه هستیم؟

جملات مفهومی؛ هر شناسه با نام فارسی و سپس نام انگلیسی در پرانتز.

  • فقط واحد هدف‌شده عوض شود و بقیه پیش‌نویس دست‌نخورده بماند
  • فهرست جایگزینی واحدها (replacements) معتبر باشد؛ با متن فارسی جدید (text_fa) غیرخالی و خلاصه تغییر (change_summary_fa)
  • دستور کاربر رعایت شود؛ بدون بازنویسی بی‌مورد کل سند
  • مسیر محصول ویرایش از conversation draft باشد، نه از این endpoint

چطور مطمئن می‌شویم رسیده‌ایم؟

نشانه رسیدن: توضیح فارسی و سپس متغیر، تابع یا کد انگلیسی در پرانتز.

  • پاسخ HTTP برای تست محلی حداقل یک جایگزینی (replacement) داشته باشد
  • نوع واحد (unit_type) و شماره ادعا (claim_number) یا کلید بخش (section_key) با درخواست هم‌خوان باشند
  • خطای دامنه (scope) یا فایل الزامی قبل از فراخوانی LLM با کد HTTP 400 برگردد
  • کلید artifact نامعتبر روی مسیر میراث draft.edit به INVALID_ARTIFACT_KEY منجر شود

توابع و نقاط ورود

هر مورد: توضیح فارسی و سپس نام انگلیسی در پرانتز.

  • تابع اجرای بازنویسی (run_draft_rewrite)
  • تابع بارگذاری بایت‌های ادعانامه (load_claims_draft_bytes)
  • تابع بارگذاری بایت‌های توصیف (load_description_draft_bytes)
  • هندلر worker میراث ویرایش پیش‌نویس (DraftEditHandler.handle_requested)

متغیرها، فیلدها و تنظیمات

هر مورد: توضیح فارسی و سپس شناسه انگلیسی در پرانتز.

  • درخواست بازنویسی (DraftRewriteRequest)
  • دامنه بازنویسی (scope: selection | section | document)
  • نوع سند (document_type: claims | description | both)
  • هدف بخش یا شماره ادعا (RewriteTarget: section_key / claim_number)
  • متن انتخاب‌شده (RewriteSelection.text)
  • جایگزینی اصطلاح از و به (TermReplacement.from_ / to)
  • فهرست جایگزینی واحدها (replacements)
  • نوع واحد جایگزین‌شده (unit_type: claim | section)
  • متن فارسی جدید واحد (text_fa)
  • خلاصه تغییر فارسی (change_summary_fa)
  • کلید artifact ادعانامه (claims_draft_artifact_key)
  • کلید artifact توصیف (description_draft_artifact_key)

چه چیزهایی پر می‌شوند؟

جایگزینی واحدها (replacements)

replacements[].text_fa

چطور: scope برابر selection یا section یا document روی claims_draft و/یا description_draft

ویژگی‌ها:

  • unit_type برابر claim یا section
  • change_summary_fa خلاصه تغییر

کنترل‌های کیفیت

  • فایل الزامی متناسب با document_type در مسیر HTTP
  • اعتبارسنجی scope و target قبل از LLM در DraftRewriteRequest
  • مسیر محصول: conversation-draft + Core draft_edit_apply (بدون Slice از worker)
  • کلید artifact نامعتبر روی مسیر میراث → draft.edit.failed با INVALID_ARTIFACT_KEY

نکات

  • fragment-edit-mock را مقابل Core فعلی راه نیندازید (event-schema ADR-0011 / Core ADR-0020)
  • برای معیار کیفیت ویرایش محصول به بخش conversation-draft مراجعه کنید