علم جو بنياد و SOP

سندھ آءِ ٽي پورٽل — سهولت ڊيسڪ (SITP) جي علم جي بنياد (KB) لاءِ مستند تصريح: مواد جا قسم، ورژن وارا SOPs، AI سيمنٽڪ ڳولا جي پرت، ڦيرائو جي سرگزشت، سروس ڪئٽلاگ، تصنيف ۽ اشاعت جو ورڪ فلو، مواد جي حڪمراني، گهڻ لساني مواد، فارمز لائبريري، درجه بنديون، ان فلو مضمون جا مشورا، ۽ KB تجزيا.

فيلڊ	قدر
دستاويز آءِ ڊي	18
حيثيت	مسودو
مالڪ	S&ITD / MAAHIR
ٻوليون	EN (ماسٽر) · UR · SD
منحصر بشمول	`_context.md`، `_conventions.md`، `_glossary.md`، `/specs/sd/02-functional-reqs/`، `/specs/sd/07-ai-ocr-spec/`، `/specs/sd/06-ticket-workflow/`، `/specs/sd/09-i18n-localization/`، `/specs/sd/17-analytics-kpis/`، `/specs/sd/15-tech-architecture/`
لاڳو بشمول ماڊيولز	J (KB)، A (PUB)، B (TKT)، E (AI)، I (ANL)
نفاذ جي سطح	NestJS `kb` ماڊيول + Meilisearch هائبرڊ انڊيڪس + FastAI ايمبيڊنگ اڊاپٽر + BullMQ ٻيهر انڊيڪس ورڪرز

1. مقصد و دائروڪار

هي دستاويز ان ڳالهه جو هڪڙو مستند ذريعو آهي ته SITP جي علم جي بنياد (KB) کي ڪيئن تصنيف، ورژن، ڳولا، نمايان، حڪمراني، ۽ ماپيو ويندو آهي. KB پورٽل جو ماڊيول J آهي (_context.md §4) ۽ هڪڙي مشترڪه کارپس سان ٽن قسم جي سامعين جي خدمت ڪري ٿو:

عوام — آءِ ٽي ڪمپنيون، فري لينسرز، اسٽارٽ اپس، ۽ شهر جيڪي ٽڪيٽ داخل ڪرڻ کان اڳ يا ان جي بدران جواب ڳولهين ٿا.
ڪمپني نمائندا — داخل ڪندڙ ۽ درخواستگار جيڪي ٽڪيٽ مرتب ڪرڻ وقت مضمون جا مشورا حاصل ڪن ٿا.
S&ITD ۽ محڪمي جو عملو — آفيسر، سهولت ڪار، فرزبندي، ۽ نگراني جا ڪردار جيڪي جواب ڏيڻ وقت ساڳيا مضمون جا مشورا حاصل ڪن ٿا، مستقل، ثبوت تي مبني فيصلن لاءِ.

1.1 KB ڇو موجود آهي

KB ٽن مقفل سببن لاءِ موجود آهي (ماڊيول J، _context.md §4):

خود خدمت. زائرين ۽ ڪمپنيون EN، اردو، ۽ سنڌي ۾ مستند جواب ڳولهي وٺن ٿا، ٽڪيٽ داخل ڪرڻ، رجسٽر ٿيڻ، يا ڪاروباري ڪلاڪن جي انتظار کان سواءِ.
ڦيرائو. امڪاني ٽڪيٽن جو هڪڙو معنيٰ دار حصو ڳولا يا داخل ڪرڻ وقت نمايان ڪيل هڪڙي مناسب مضمون سان جواب ياب ٿي ويندو آهي، جنهن سان محڪمن ۽ S&ITD فرزبندي تي غير ضروري بوجھ گهٽجي ٿو.
مستقل فيصلا. مختلف محڪمن جا آفيسر جواب ڏيڻ وقت ساڳيا SOPs، فارمز، ۽ قانوني حوالا ڏين ٿا، تنهنڪري هڪڙي ئي معاملي تي ٻن ٽڪيٽن کي ساڳيو جواب ملندو آهي.

1.2 دائروڪار ۾ ڇا آهي

مواد جا قسم، درجه بندي، ورژن وارا SOPs، سروس ڪئٽلاگ، ۽ فارمز لائبريري.
AI سيمنٽڪ ڳولا جي پرت (Meilisearch هائبرڊ انڊيڪس، آن پریمس ايمبيڊنگز، گهڻ لساني ميچنگ، متعلقه درجه بندي، "ڇا توهان جو مطلب هيءُ هو"، فلٽرز).
ڦيرائو جي سرگزشت ۽ "ڇا هيءُ مددگار هو" فيڊ بیک لوپ.
آفيسرن کي (جواب جو مسودو تيار ڪرڻ وقت) ۽ ڪمپنين کي (داخل/مرتب ڪرڻ وقت) ان فلو مضمون جا مشورا.
تصنيف ۽ اشاعت جو ورڪ فلو، ڪردار، شيڊيوڊ اشاعت/ختم ٿيڻ، ۽ مواد جي حڪمراني.
گهڻ لساني مواد جي تيارڪاري (AI-ترجمو + انساني جائزو، گلاسري تي مبني).
KB تجزيا ۽ فعلي/سرگزشت ميپنگ.

1.3 دائروڪار کان ٻاهر ڇا آهي

مڪمل AI انجن ايبسٽريڪشن، پرامپٽ ورژنگ، ۽ PII ريڊڪشن پائيپ لائن /specs/sd/07-ai-ocr-spec/ ۾ تصريح ٿيل آهن ۽ هتي حوالو ڏنو ويو آهي، ٻيهر تصريح نه ڪيو ويو.
عوامي چيٽ بوٽ جي ڳالهه ٻولهه جو رويو /specs/sd/07-ai-ocr-spec/ §4.8 ۾ رهي ٿو؛ KB رڳو ان جو ريٽرايول کارپس فراهم ڪري ٿو.
RBAC تفصيل (ڪير تصنيف/اشاعت ڪري سگهي ٿو) §11 ۾ خلاصو ڪئي وئي آهي ۽ /specs/sd/04-roles-permissions/ ۾ مڪمل تصريح ٿيل آهي.
ڊيٽا ماڊل ٽيبلز §17 ۾ خلاصو ڪيا ويا آهن؛ مڪمل اسڪيما /specs/sd/05-data-model/ ۾ رهن ٿا.

1.4 KB اصول

هر KB رويو هيٺين اصولن پايل آهي، جن کي منظوريءَ جي معيار ۾ آءِ ڊي (KB-1 … KB-8) ذريعي حوالو ڏنو ويندو آهي.

آءِ ڊي	اصول	عمل ۾ ان جو مطلب
KB-1	انگريزي ماسٽر آهي؛ UR/SD متوازي ترجما آهن.	EN پهرين تصنيف ٿيندي آهي؛ UR ۽ SD `_glossary.md` استعمال ڪندي وفادار ترجما طور تيار ڪيا ويندا آهن. ڪو به مضمو ڪنهن لوڪل ۾ "اشاعت ٿيل" ناهي جيستائين ان جي ترجمي جو جائزو نه ورتو وڃي. ڪنهن به اختلاف تي EN ورزن مستند ذريعو آهي.
KB-2	`pgvector` ناهي؛ ویکٽرز Meilisearch + AI سروس ۾ رهن ٿا.	رڪارڊ جو نظام MariaDB 10.11 آهي؛ سيمنٽڪ/ويکٽر ڳولا Meilisearch (هائبرڊ ليڪسيڪل + ویکٽر) ۽ FastAPI AI سروس جي ايمبيڊنگ اسٽور کي سونپي ويندي آهي. MariaDB ٽيبلز ٻيهر انڊيڪس ڪرڻ لاءِ استعمال ٿيندڙ مستند مضمون متن رکن ٿا.
KB-3	AI مدد ڪري ٿو؛ انسان منظور ڪن ٿا.	AI درجه بنديون مشورا ڏي ٿو، ترجمن جو مسودو تيار ڪري ٿو، متعلقه مضمون مشورا ڏي ٿو، ۽ نتيجن جي درجه بندي ڪري ٿو. ڪو به AI آئوٽ پٽ اشاعت ٿيل مضمون، اشاعت ٿيل ترجمو، يا خودڪار ڦيرائو نسبت بغير انساني تصديق يا گهٽ خطري وارن ڪيسن تائين محدود صريح لاگڊ آٽو ايپلائي رول جي پوري ناهي ٿيندو.
KB-4	همیشه موجودھ فارمز.	فارمز لائبريري جو لنڪ همیشه ان فارم جي تازہ ترين اشاعت ٿيل ورزن تي حل ٿيندو آهي. ورژنگ فارم تي ٿيندي آهي، لنڪ تي ناهي، تنهنڪري ٻاهريان حوالا ۽ پرنٽ ٿيل مواد ڪڏهين بہ نه ٽٽندا آهن.
KB-5	هر ورزن ٻيهر حاصل ڪرڻ جوڳو آهي.	ڪا به تبديليءَ جي اشاعت سان نئون ورزن ٺهندو آهي؛ اڳوڻا ورزن محفوظ، رسائي جوڳا، ۽ ڪڏهين به اوور رائٽ نه ٿيندا آهن. موجوده اشاعت ٿيل ورزن غير مبهم هوندو آهي.
KB-6	هر ميٽرڪ جي هڪ تعريف؛ هڪ مستند ڪئٽلاگ.	ڪنهن سروس يا SOP جو بلڪل هڪڙو مستند اندراج هوندو آهي. KB ۾ درج SLA انگ `sla_definitions` (`/specs/sd/06-ticket-workflow/` §5) سان ملندو آهي ته جيئن داخل ڪندڙ ساڳيو انگ ڏسي جيڪو آفيسر استعمال ڪري.
KB-7	مشورا دائروڪار جي احترام ڪن ٿا.	ڪنهن آفيسر يا ڪمپني کي ان فلو مضمون جا مشورا صارف جي ڪردار ۽ ٽڪيٽ جي محڪمي/قسم جي مطابق محدود هوندا آهن. ڪنهن آفيسر کي پنهنجي محڪمي جي اشاعت ٿيل SOPs کان ٻاهر جو مضمو ان وقت تائين نه ملندو جيستائين اهو صريح طور ڪراس لنک ٿيل هجي.
KB-8	مددگار، ڪڏهين به روڪڻ وارو ناهي.	جيڪڏهن ڳولا انڊيڪس، ايمبيڊنگ ماڊل، يا ڪابه AI صلاحيت بند هجي، ته KB رڳو ليڪسيڪل ڳولا ۽ دستي تصنيف تائين گريڊ ٿي ويندي آهي. ڪابه KB ناڪامي ٽڪيٽ داخل ڪرڻ، جواب ڏيڻ، يا حل ڪرڻ کي بلاڪ نه ڪندي.

2. مواد جا قسم

KB ست قسمن جو مواد رکي ٿي. هر قسم جا پنهنجا تصنيف فيلڊز، لائف سائيڪل، تازگي جي کُڌِي، ۽ ڳولا جو رويو آهي. هر KB آئٽم تي kb_content_type enum مقفل آهي.

ڪوڊ	مواد جو قسم	وضاحت	عام ڊگهائي	تازگي جي کُڌِي (بنيادي)	تصنيف ڪندڙ
`how_to`	هائو ٽو مضمون	ڪنهن مخصوص ڪم لاءِ مرحلو وار هلندڙ هدايتون (ڪمپني رجسٽر ڪريو، ليبر شڪايت داخل ڪريو، NTN تبديليءَ جي درخواست ڏيو). نمبر وارا مرحلا، اسڪرين شاٽس/ڊاياگرام جائز آهن.	200–800 لفظ	180 ڏينهن	KB تصنيف ڪندڙ (محڪمو)
`faq`	FAQ	ڪنهن هڪ ٻيهر اچڻ واري سوال تي مختصر سوال + جواب. هلڪو، اسڪين جوڳو، عوامي FAQ/مدد مرڪز کان لنڪ جوڳو (`/specs/sd/02-functional-reqs/` FR-PUB-003).	50–200 لفظ	180 ڏينهن	KB تصنيف ڪندڙ (محڪمو)
`sop`	ورژن وارو SOP	ڪنهن محڪمي/قسم لاءِ مستند اسٽينڊرڊ آپريٽنگ پروسيجر. ان ۾ نافذ تاريخ، ورزن، منظوريءَ جو رڪارڊ شامل هوندو آهي، ۽ هڪ يا وڌيڪ ٽڪيٽ قسمن سان منسلڪ هوندو آهي. مڪمل ورژنگ §4 ۾.	1–20 صفحا	365 ڏينهن	KB تصنيف ڪندڙ → ايڊيٽر → پبلشر (گیٽڊ)
`form`	ڊائون لوڊ جوڳو فارم	هڪڙو حڪومتي فارم (PDF/DOCX) ان جي داخل ڪرڻ جي هدايتن، گهربل دستاويزن جي فهرست، ۽ فيس (جيڪڏهن ڪا هجي) سان گڏ. فارمز لائبريري (§8) ۽ سروس ڪئٽلاگ ۾ رهي ٿو.	n/a (فائل + ≤ 300 لفظ)	365 ڏينهن	KB تصنيف ڪندڙ (محڪمو) + فارمز لائبريرين
`guide`	پروسيس گائڊ	ڪنهن اينڊ ٽو اينڊ پروسيس جي ڊگهي، بيانائي وضاحت (مثال طور "TRI ميٽنگ ڪيئن ڪم ڪري ٿي"، "اپيل جو رستو وضاحت"). SOPs، FAQs، ۽ فارمز ڪراس لنڪ ڪري ٿو.	800–3000 لفظ	365 ڏينهن	KB تصنيف ڪندڙ (محڪمو/S&ITD)
`legal`	قانوني / پاليسي حوالو	ڪنهن قانون، قاعدي، نوٽيفڪيشن، يا پاليسيءَ جو حوالو (مثال طور سنڌ شفافيت ۽ معلومات جي حق ايڪٽ 2016، محڪماني نوٽيفڪيشن). همیشه ماخذ ۽ نافذ تاريخ ڏيکاري ٿو.	مختلف	365 ڏينهن (ترميم لاءِ جائزو)	S&ITD قانوني + محڪمو
`video`	ويڊيو ٽيوٽوريل	مختصر اسڪرين رڪارڊنگ يا وضاحتي ويڊيو، EN/UR/SD ۾ ڪيپشنز ۽ متن ٽرانسڪرپٽ سان (ڳولا لاءِ انڊيڪس ٿيل).	1–6 منٽ	365 ڏينهن	KB تصنيف ڪندڙ (S&ITD)

هر KB آئٽم تي عام فيلڊز (قسم جي مخصوص فيلڊز کان علاوه): id، title (في لوڪل)، summary (في لوڪل، ≤ 60 لفظ، ڳولا نتيجن ۾ ڏسڻ ۾ ايندي)، body (في لوڪل، Markdown)، content_type، owning_department، categories[]، tags[]، audience[]، locale_status{en,ur,sd}، version، status (draft/in_review/scheduled/published/retired)، effective_from، expires_at، last_reviewed_at، freshness_window_days، helpful_votes، unhelpful_votes، view_count، deflection_count، created_by، updated_by۔

3. درجه بندي

KB درجه بندي ٽن پرتن تي مشتمل آهي ۽ سڀني قسمن جي مواد ۾ مشترڪه آهي. اها سروس ڪئٽلاگ (§5)، ان فلو مشورن (§7)، ۽ عوامي FAQ/مدد مرڪز جي ریڙھ جي هڏي پڻ آهي.

پرت	ڪارڊينالٽي	مثالون	استعمال ڪندڙ
قسم	هر مواد آئٽم تي هڪ، سروس ڪئٽلاگ قسم جي وڻ مان	`Labour / Unpaid dues`، `SECP / Name reservation`، `SRB / Refund`، `S&ITD / RTI request`	ڳولا فيسٽ، سروس ڪئٽلاگ جوائن، ٽڪيٽ قسم جو لنڪ، ڦيرائو نسبت
ٽيگز	هر مواد آئٽم تي 0–N، ڪنٽرولڊ ذخيرو لفظن جي اندر آزاد	`urgent`، `foreign-investment`، `PSEB-membership`، `startup`، `reopened`	ڳولا فيسٽ، متعلقه مواد، "ڇا توهان جو مطلب هيءُ هو" توسيع
سامعين	هر مواد آئٽم تي 1–N	`public`، `company`، `officer`، `facilitator`، `dg`، `secretary`	مرئيت اسڪوپنگ؛ جيڪو `legal` آئٽم رڳو `officer` لاءِ هجي اهو عوام کي ڪڏهين نه ڏنو ويندو

قاعدا.

قسم جو وڻ ٽڪيٽ قسم جي وڻ جو عکس آهي (/specs/sd/06-ticket-workflow/ §4.1 ڏسو). ڪنهن مواد آئٽم جو قسم ان وڻ ۾ هڪڙو ليف هجڻ گهرجن، ته جيئن مضمون کي ان جي متعلقه ٽڪيٽن سان غير مبهم طور منسلڪ ڪري سگهجي.
ٽيگز S&ITD KB ايڊيٽرز جي نگراني هيٺ ڪنٽرولڊ ذخيرو لفظن مان کنيا وڃن ٿا؛ فري ٽيڪسٽ ٽيگز محفوظ ڪرڻ تي نارملائيز ٿيندا آهن ۽ نئون هجڻ جي صورت ۾ جائزي لاءِ نشان زد ٿيندا آهن.
سامعين جو اسڪوپنگ ڳولا جي پرت (§6) ۽ ريٽرايول تي لاڳو ڪيو ويندو آهي: جنهن آئٽم جي audience ۾ درخواستگار جو ڪردار شامل نه هجي، اهو ڪڏهين واپس نه ڪيو ويندو، ڪنهن مشوري ۾ ايمبيڊ نه ڪيو ويندو، ۽ ان درخواستگار جي ڦيرائي ۾ شمار نه ٿيندو.

4. ورژن وارا SOPs

SOPs سڀ کان وڌيڪ نتيجو خيز مواد جو قسم آهن: ڪو آفيسر جواب ڏيڻ وقت انهن مان هڪڙي جو حوالو ڏي ٿو، ۽ ڪا ڪمپني داخل ڪرڻ جو فيصلو ڪرڻ وقت ان تي ڀاڙي ٿي. تنهنڪري انهن ۾ سخت ترين ورژنگ ۽ منظوريءَ جو ضابطو هوندو آهي.

4.1 SOP جي ورژن وارو هجڻ جو ڇا مطلب آهي

هر sop آئٽم تعمير جي اعتبار سان ورژن ٿيل آهي (KB-5، FR-KB-002). اشاعت ٿيل تبديلي ڪڏهين اوور رائٽ نه ڪندي؛ اها نئون ورزن قطار ٺاهيندي، ۽ هر اڳوڻو ورزن محفوظ، حاصل ڪرڻ جوڳو، ۽ حوالو جوڳو رهندو. هڪڙو SOP قطار هيٺين رکي ٿو:

فيلڊ	مطلب	مثال
`sop_id`	مستحڪم SOP سڃاڻپ ڪندڙ، ڪڏهين ٻيهر نمبر نه ڏنو ويندو	`SOP-SRD-014`
`version`	هڪ طرفي انٽيجر، هر اشاعت تي وڌايو ويندو آهي	`7`
`version_label`	انساني ليبل، اختياري	`2026-Rev-A`
`effective_from`	جنهن تاريخ تي هي ورزن نافذ ٿيندو آهي (گريگورين + هجري)	`2026-08-01` (1 صفر 1448)
`supersedes_version`	جنهن ورزن کي هي تبديل ڪري ٿو	`6`
`change_summary`	ڇا تبديلي آئي جو هڪ لائين خلاصو	"PSEB ڪراس چيڪ مرحلو شامل ڪيو (3.2)"
`change_log`	منظم تاريخ جو اندراج (ڇا، ڇو، اداڪار، تاريخ)	§4.3 ڏسو
`approval`	منظوري ورڪ فلو رڪارڊ (منظور ڪندڙ، فيصلو، ٽائم اسٽيمپ)	§4.4 ڏسو
`linked_categories`	ٽڪيٽ قسما جنهن کي هي SOP ڪنٽرول ڪري ٿو (1–N)	`SRB/Refund`، `SRB/Refund-e-filing`
`canonical_url`	مستحڪم لنڪ جيڪو همیشه موجوده ورزن تي حل ٿيندو	`/kb/sop/SOP-SRD-014`
`status`	`draft` / `in_review` / `scheduled` / `published` / `retired`	`published`

4.2 SOP ورژنگ ميٽرڪس

واقعو	ورزن جو رويو	عوام کي نظر اچي ٿو؟	نافذ تاريخ جو انتظام
پهرين اشاعت	`version = 1`، `supersedes_version = null`	ها، `effective_from` کان	`effective_from` = اشاعت جي تاريخ جيستائين شيڊيوڊ نه هجي
معمولي ترميم جي ٻيهر اشاعت	`version = n+1`، تبديلي `minor` ٽيگ ٿيل (املائي غلطيون، فارميٽنگ)	ها، اشاعت تي فوراً	`effective_from` = اشاعت جي تاريخ
بنيادي تبديلي جي ٻيهر اشاعت	`version = n+1`، تبديلي `major` ٽيگ ٿيل؛ مڪمل چينج لاگ اندراج ضروري	ها `effective_from` تي؛ جيڪڏهن شيڊيوڊ هجي ته اڳوڻو ورزن ان وقت تائين عوامي رهندو	`effective_from` مستقبل جي تاريخ ٿي سگهي ٿي (شيڊيوڊ اشاعت، §11.4)
واپس ورتو / ریٽائر	`status = retired`، `expires_at` سيٽ؛ ورزن ۾ واڌارو ناهي	ناهي (آئٽم 410 Gone واپس ڪندو، "ریٽائر، جانشين ڏسو" نوٽس سان)	`expires_at` = ریٽائرمنٽ جي تاريخ؛ `successor_id` متبادل ڏيکاري سگهي ٿو
اڳوڻي ورزن تي موٽڻ	`version = n+1` جنهن جو متن اڳوڻي ورزن جي برابر هجي، چينج لاگ سبب سان	ها، اشاعت تي	`effective_from` = موٽڻ جي تاريخ
ریٽائر SOP بحال ڪرڻ	`status` واپس `published`، نئون `version`، چينج لاگ سبب سان	ها، اشاعت تي	`effective_from` = بحاليءَ جي تاريخ

4.3 چينج لاگ

هر ورزن هڪ منظم change_log اندراج کنيو آهي جيڪو شامل ڪيو ويندو آهي (ڪڏهين اوور رائٽ ناهي). چينج لاگ پاڻ SOP صفحي تي رينڊر ٿيندو آهي ۽ آڊٽ لاءِ ايڪسپورٽ جوڳو هوندو آهي.

فيلڊ	مطلب
`from_version`	جنهن ورزن کي تبديل ڪيو پئي وڃي
`to_version`	نئون ورزن
`change_type`	`minor` / `major` / `revert` / `retire` / `restore`
`summary`	≤ 200 لفظ: ڇا تبديل ٿيو ۽ ڇو
`rationale`	محرڪ: پاليسي تبديلي، قانوني ترميم، آپريشنل سک، فيڊ بیک لوپ (§10)
`changed_sections[]`	متاثر سڪشن اينڪرز
`actor`	اهو پبلشر جنهن منظور ڪيو (§11.2)
`approved_at`	منظوريءَ جو ٽائم اسٽيمپ
`review_refs[]`	ايڊيٽوريل جائزو رڪارڊ ۽ ڪنهن به منظوريءَ جي دستخطن جا لنڪس

4.4 منظوريءَ جو ورڪ فلو

ڪنهن بنيادي SOP تبديليءَ لاءِ ٽن ڪردارن جي منظوري ضروري آهي (KB-3، §11.2):

مرحلو	ڪردار	عمل
1. مسودو	KB تصنيف ڪندڙ (محڪمو)	نئون ورزن تصنيف ڪري ٿو؛ جائزي لاءِ جمع ڪري ٿو.
2. ايڊيٽوريل جائزو	KB ايڊيٽر (S&ITD)	وضاحت، گهڻ لساني تيارڪاري، درجه بندي، ڪراس لنڪس چيڪ ڪري ٿو؛ ترميمون گهرڻ يا منظور ڪرڻ.
3. منظوري	KB پبلشر (محڪمي جو سربراهه يا مندوب)	تصديق ڪري ٿو ته SOP آپريشنل طور صحيح آهي ۽ اشاعت منظور ڪري ٿو. اهڙن SOPs لاءِ جيڪي SLA يا قانوني حوالا تبديل ڪن ٿا، ڪنفيگريشن مطابق S&ITD قانوني کان ٻي منظوري گهربل ٿي سگهي ٿي.
4. اشاعت	نظام	منظوريءَ تي (۽ `effective_from` تي جيڪڏهن شيڊيوڊ هجي)، نئون ورزن موجوده ٿيندو آهي؛ اڳوڻو ورزن محفوظ ٿيندو آهي؛ چينج لاگ لکيو ويندو آهي؛ انڊيڪس ٻيهر انڊيڪس ٿيندو آهي؛ واچرز ۽ منسلڪ قسمن کي اطلاع ڏنو ويندو آهي.

4.5 SOPs کي ٽڪيٽ قسمن سان منسلڪ ڪرڻ

هر SOP linked_categories[] جو اعلان ڪري ٿو جيڪي ساڳئي وڻ مان کنيا وڃن ٿا جيڪو ٽڪيٽنگ ماڊيول استعمال ڪري ٿو (/specs/sd/06-ticket-workflow/ §4.1). هي لنڪ ان فلو مشورن (§7) ۽ ڦيرائي نسبت (§9) کي هلائي ٿو: جڏهن ڪو آفيسر يا داخل ڪندڙ قسم SRB/Refund ۾ ڪنهن ٽڪيٽ تي هوندو آهي، نظام ان قسم سان منسلڪ SOP(s) — ۽ ان جي آبائن سان — متعلقہ درجه بندي مطابق حاصل ڪندو آهي.

ڪارڊينالٽي. ڪنهن قسم جا 0–N منسلڪ SOPs ٿي سگهن ٿا؛ هڪ SOP 1–N قسمن سان منسلڪ ٿي سگهي ٿو. جڏهن صفر SOPs منسلڪ هجن، مشوري جي پرت محڪمي جي اسڪوپ سان پوري KB تي سيمنٽڪ ڳولا تي پويهر پئي ويندي.

5. سروس ڪئٽلاگ

سروس ڪئٽلاگ اهو عوامي، فلٽر جوڳو ڊائريڪٽري آهي جيڪو پورٽل کي، في محڪمو ۽ قسم مطابق، سنڀاليندو آهي. اهو عوامي سائيٽ تي شايع ٿيندو آهي (/specs/sd/02-functional-reqs/ FR-PUB-007، FR-KB-007) ۽ خود خدمت ۽ داخل ڪرڻ ٻنهي لاءِ بنيادي داخلي نقطو آهي.

5.1 اسڪيما

هر ڪئٽلاگ اندراج (department_code, category_code) سان ڪيليدز ٿيل هڪ قطار آهي. هيٺ ڏنل اسڪيما ڪئٽلاگ، KB، انٽيڪ فارم، ۽ تجزين جي وچ ۾ مستند معاهدو آهي.

فيلڊ	قسم	مطلب	مثال
`department_code`	اسٽرنگ	مالڪ محڪمو (3–5 اکر)	`LBR` (Labour)
`department_name`	في لوڪل	محڪمي جو ڊسپلي نالو (EN/UR/SD)	"Labour Department"
`category_code`	اسٽرنگ	ليف قسم جو ڪوڊ	`LBR-UNPAID`
`category_name`	في لوڪل	قسم جو ڊسپلي نالو	"Unpaid dues / wages"
`parent_category`	اسٽرنگ	پيرنٽ قسم جو ڪوڊ (وڻ)	`LBR-WAGES`
`description`	في لوڪل	سروس جي سادي ٻوليءَ ۾ وضاحت (≤ 150 لفظ)	"باقي اجرت، اوور ٽائم، يا گريجوٽي جي وصولي…"
`services_handled`	في لوڪل	هن قسم هيٺ مخصوص خدمتن جي بلٽ فهرست	"Wage recovery · Overtime · Gratuity · Final settlement"
`expected_resolution_time`	اسٽرنگ	عوام کي ڏسڻ ۾ ايندڙ SLA اميد، `sla_definitions` مان	"پهرين جواب 2 ڪاروباري ڏينهن اندر؛ حل جو هدف 10 ڪاروباري ڏينهن."
`required_documents`	في لوڪل	داخل ڪرڻ لاءِ دستاويزن جي چيڪ لسٽ	"داخل ڪندڙ جو CNIC؛ تقريري خط؛ پويون 3 پگهار پچيون؛ بينڪ بيان"
`fees`	في لوڪل	فيس، جيڪڏهن ڪا هجي، ڪرنسي ۽ معافي جي نوٽس سان	"ڪابه فيس ناهي. RTI درخواستون: مفت."
`linked_sops[]`	ref[]	هن قسم کي ڪنٽرول ڪندڙ SOPs (§4.5)	`SOP-LBR-002`
`linked_forms[]`	ref[]	هن قسم لاءِ استعمال ٿيندڙ فارمز (§8)	`FORM-LBR-WAGE-CLAIM`
`linked_faqs[]`	ref[]	ڪئٽلاگ صفحي تي نمايان FAQs	`FAQ-LBR-011`
`sla_definition_id`	ref	اهو SLA قطار جنهن جو عکس اشاعت ٿيل اميد آهي (KB-6)	`sla_def_id = 1042`
`intake_form_schema_id`	ref	هن قسم لاءِ متحرڪ انٽيڪ فارم	`ifs_LBR_UNPAID_v3`
`audience`	enum[]	ڪئٽلاگ اندراجن لاءِ همیشه `public` شامل	`[public, company, officer]`
`last_reviewed_at`	تاريخ	ڪئٽلاگ اندراج جي تازگي	`2026-06-30`

5.2 في محڪمو اندراج

پورٽل تي حڪومتِ سنڌ جو هر محڪمو پنهنجا ڪئٽلاگ اندراج جو مالڪ آهي. ڪئٽلاگ محڪمي ۽ قسم مطابق فلٽر جوڳو آهي (FR-KB-007)، ۽ هر اندراج پنهنجن SOPs، فارمز، ۽ SLA اميد سان منسلڪ هوندو آهي. هڪڙو نمائندو حصو (تمثيلي، جامع ناهي — مڪمل ڪئٽلاگ kb_service_catalog ۾ محفوظ آهي):

محڪمو (ڪوڊ)	مثال قسم	متوقع حل	اهم گهربل دستاويزون	فيس
Science & IT (SITD)	آءِ ٽي ڪمپني آن بورڊنگ استفسار	2 / 10 ڪاروباري ڏينهن	SECP سرٽيفڪيٽ؛ NTN	ڪابه ناهي
Labour (LBR)	باقي پگهار / اجرت	2 / 10 ڪاروباري ڏينهن	CNIC؛ تقريري خط؛ پگهار پچيون	ڪابه ناهي
SECP (SEP)	نالو محفوظ ڪرڻ جو تڪرار	2 / 10 ڪاروباري ڏينهن	تجويز ڪيل نالو؛ محفوظ نمبر؛ رد خط	SECP فيس شيڊول مطابق
FBR/NTN (FBR)	NTN تبديلي	2 / 10 ڪاروباري ڏينهن	CNIC؛ NTN؛ معاون ثبوت	ڪابه ناهي
SRB (SRB)	سيلز ٽيڪس ريفنڊ	2 / 10 ڪاروباري ڏينهن	ريٽرن؛ چالان؛ بينڪ تفصيلات	ڪابه ناهي
S&ITD (SITD)	RTI درخواست (قانوني)	10 ڪم ڪندڙ ڏينهن (RTI Act 2016)	RTI درخواست فارم	ڪابه ناهي (ايڪٽ مطابق فيس معافي)

5.3 تازگي ۽ SLA عڪس

عوام کي ڏسڻ ۾ ايندڙ expected_resolution_time sla_definitions مان اخذ ٿيل آهي (KB-6). جڏهن ڪا SLA قطار بدلجندي آهي، ته منحصر ڪئٽلاگ اندراج ايڊيٽوريل جائزي لاءِ نشان زد ٿيندا آهن ته جيئن عوامي انگ آپريشنل انگ کان خاموشيءَ سان مختلف نه ٿيندو.
ڪئٽلاگ اندراج پنهنجي پيرنٽ محڪمي جي تازگي جي ڪيڊنس ورثہ ۾ وٺندا آهن ۽ مواد جي حڪمراني ڊيش بورڊ تي نمايان ٿيندا آهن (§12).

6. AI سيمنٽڪ ڳولا

ڳولا KB جو اڳيون دروازو آهي. اها عوامي مدد مرڪز (FR-PUB-003)، عوامي چيٽ بوٽ جي ريٽرايول کارپس (/specs/sd/07-ai-ocr-spec/ §4.8)، ان فلو مشورا (§7)، ۽ اسٽاف اسسٽنٽ (AI اسپڪ §5) کي هلائي ٿي. ڳولا تعمير جي اعتبار سان گهڻ لساني آهي (KB-1) ۽ دائروڪار جو احترام ڪري ٿي (KB-7).

6.1 انڊيڪس: Meilisearch هائبرڊ (ليڪسيڪل + ویکٹر)

ڳولا انڊيڪس Meilisearch آهي (_context.md §3، AI اسپڪ §5.2 ۾ مقفل). Meilisearch هڪڙي انڊيڪس ۾ گهڻ لساني ليڪسيڪل ٽوڪنائيزيشن (اردو/سنڌي جو سٺو هينڊلنگ) ۽ هائبرڊ ویکٹر مشابهت فراهم ڪري ٿو. اسٽيڪ ۾ ڪٿي به ڪابه pgvector انحصار ناهي (KB-2).

ليڪسيڪل پرت — EN، UR (نستعليق)، ۽ SD (نسخ) لاءِ لوڪل آگاهه اينالائزرز سان گهڻ لساني ٽوڪنائيزيشن. انڊيڪس ۽ استفسار جي وقت تي ڊجٽل فارم نارملائيزيشن (مغربي ↔ عربي انڊک) سنڀاليندو آهي.
ویکٹر پرت — هر اشاعت ٿيل KB آئٽم هڪڙي آن پریمس ايمبيڊنگ ماڊل (AI سروس جي LLMClient.embed انٽرفيس؛ ايمبيڊنگز بائونڊري کان ٻاهر ڪڏهين ناهي وينديون) ذريعي ايمبيڊ ڪيو ويندو آهي. ايمبيڊنگز اشاعت ۽ بنيادي ترميم تي ٻيهر ڪمپيوٽ ٿينديون آهن.
مستند ماخذ — MariaDB ٽيبلز kb_items، kb_item_versions، kb_service_catalog، kb_forms مستند ذريعو آهن. Meilisearch انهن مان ٺهيل هڪڙو اخذ ٿيل انڊيڪس آهي؛ ڪو به ٻيهر انڊيڪس ورڪر ڪنهن به وقت MariaDB مان Meilisearch ٻيهر ٺاهي سگهي ٿو.

6.2 استفسار جو وهڪرو

flowchart TD Q["User query (text + locale + role + scope filters)"] FF{"Feature flag ai.kb.semantic enabled?"} FAIL["Degrade: lexical-only search (KB-8 — never blocks)"] EMB["Embed query (on-prem embedding model)"] LEX["Lexical tokenize (locale analyzer; digit normalization)"] DYM["Spell / script normalize → 'did you mean' candidates"] HYB["Hybrid retrieval in Meilisearch (lexical + vector similarity)"] SCOPE["Apply scope filters (department, category, audience, locale, content_type)"] RER["Rerank top-K (cross-encoder or LLM rerank)"] ATTR["Attach signals: type, dept, freshness, view_count, helpful ratio, is_canonical"] RES["Ranked results + facets + 'did you mean' + zero-result path"] LOG["Log search event (query, locale, result_count, has_results, session)"] Q --> FF FF -- no --> LEX FF -- yes --> EMB EMB --> HYB LEX --> HYB Q --> DYM DYM --> HYB HYB --> SCOPE SCOPE --> RER RER --> ATTR ATTR --> RES RES --> LOG LEX -. fallback .-> SCOPE

تحريري وضاحت. هڪڙو استفسار پنهنجو متن، صارف جو لوڪل، ڪردار، ۽ اسڪوپ فلٽرز (محڪمو/قسم جيڪڏهن معلوم هجن، سامعين، مواد جو قسم) کڻي اچي ٿو. گیٽ کیپر پهرين سيمنٽڪ ڳولا فيچر فليگ چيڪ ڪري ٿو: جيڪڏهن بند هجي، ته استفسار رڳو ليڪسيڪل ڳولا تائين گريڊ ٿي ويندو آهي ۽ ڪڏهين ايڙر ناهي ڏيندو (KB-8). جڏهن چالو هجي، استفسار جو متن آن پریمس ايمبيڊنگ ماڊل ذريعي ايمبيڊ ڪيو ويندو آهي (ايمبيڊنگز بائونڊري کان ٻاهر ناهن وينديون) ۽ لوڪل آگاهه اينالائزر ذريعي ٽوڪنائيز ڪيو ويندو آهي، جيڪو مغربي ↔ عربي انڊڪ ڊجٽس نارملائيز ڪري ٿو ۽ نستعليق/نسخ شيپنگ سنڀاليندو آهي. هڪڙو "ڇا توهان جو مطلب هيءُ هو" پاسو هجي ۽ اسڪرپٽ نارملائيزڊ اميدوار فارمز ٺاهيندو آهي (مثال طور رومن اردو استفسار کي نستعليق انڊيڪس خلاف، يا منتقل ٿيل سنڌي اصطلاح کي پڪڙي وٺندو آهي). Meilisearch هائبرڊ ريٽرايول ليڪسيڪل ميچنگ ۽ ویکٹر مشابهت کي گڏ ڪري ٿو؛ پوءِ نتيجا اسڪوپ (محڪمو، قسم، سامعين، لوڪل، content_type) سان فلٽر ٿيندا آهن ته جيئن ڪنهن آفيسر کي پنهنجي اشاعت ٿيل SOPs کان ٻاهر جو مضمو ڪڏهين نه ملي ۽ عوامي زائر کي اسٽاف لاءِ مخصوص مواد ڪڏهين نه ملي. مٿانهين K اميدوارن کي درستگي لاءِ ڪراس اينڪوڊر يا LLM ريرينڪ پاس ذريعي ٻيهر درجه بندي ڪيو ويندو آهي. هر نتيجو پنهنجا سگنلز (قسم، محڪمو، تازگي، ويو ڪائونٽ، مددگار تناسب، مستند فليگ) کڻي هلندو آهي جيڪي درجه بندي ۽ UI کي فيڊ ڪندا آهن. ڳولا جو واقعو استفسار، لوڪل، نتيجو ڪائونٽ، نتيجا آهن فليگ، ۽ سيشن آءِ ڊي سان لاگ ٿيندو آهي — §13 جي تجزين کي فيڊ ڪري ٿو (خاص طور تي ڳولا ۾ ڪابه نتيجو نه هجڻ جي شرح).

6.3 متعلقه درجه بندي

درجه بندي هڪڙو وزن دار ميلاپ آهي. وزن في سطح (عوامي مدد مرڪز بمقابله آفيسر مشورو) ڪنفيگريشن جوڳا آهن ۽ ڪلڪ تھرو ۽ مددگاريءَ جي سگنلز (§10) مان ٽيون ڪيا ويندا آهن.

سگنل	وزن (بنيادي)	نوٽس
Semantic similarity (vector)	0.35	ڪليدي لفظن کان پري ارادي ميچ
Lexical match (title > summary > body)	0.25	عنوان هٽس غالب
Scope correctness (dept/category)	0.15	سخت فلٽر؛ ٽاءِ بریک لاءِ وزن طور شامل
Freshness (recency within freshness window)	0.10	کُڌِي کان گذريل پراڻن آئٽمز کي سزا ڏي ٿو
Helpfulness ratio (`helpful / (helpful+unhelpful)`)	0.10	مواد جي معيار جو سگنل
Popularity (`view_count`, time-decayed)	0.05	پراڻن آئٽمز جي مستقل غالبيت کان بچي ٿو
Canonical / official (`is_canonical`)	boost	مستند SOPs/قانوني حوالا ڪميونٽي جهڙي مواد تي اڳڀرو آهن

6.4 "ڇا توهان جو مطلب هيءُ هو"

ڪنهن به اهڙي استفسار لاءِ جيڪو ڪمزور يا صفر نتيجا واپس ڪري، ڳولا جي پرت هيٺين کي استعمال ڪندي متبادل فارمز مشورا ڏيندي آهي:

ڪنٽرولڊ ذخيرو لفظن ۽ KB کارپس خلاف هجي درستگي.
اسڪرپٽ نارملائيزيشن (رومن اردو ↔ نستعليق؛ منتقل ٿيل سنڌي).
_glossary.md مان مترادف/اصطلاح توسيع (مثال طور "NTN" ↔ "National Tax Number" ↔ "قومي ٽيڪس نمبر").
قسم جو مشورو جڏهن استفسار ڪنهن سروس ڪئٽلاگ اندراج سان سڌو سنڌو ميچ ٿيندو آهي ("ليبر شڪايت ڪيئن داخل ڪجي" → LBR ڪئٽلاگ اندراج + مٿاهين SOP).

"ڇا توهان جو مطلب هيءُ هو" نتيجن جي مٿان رينڊر ٿيندو آهي ۽ پاڻ هڪڙو لاگ ٿيل واقعو آهي ته جيئن مترادف جون گهڻيون گلاسري ۾ شامل ڪري سگهجن.

6.5 فلٽرز

عوامي مدد مرڪز ۽ آفيسر مشوري جي سطح ٻنهي فلٽرز پيش ڪن ٿا. بنيادي فلٽر فيسٽس: محڪمو، قسم، مواد جو قسم (how-to / FAQ / SOP / form / guide / legal / video)، سامعين، ۽ ٻولي. آفيسر کي ڳولا ۾ هڪڙو "رڳو منهجو محڪمو" ٽوگل (KB-7) پڻ پيش ڪندي آهي. فلٽرز ڳولا لاگ ۽ تجزين ۾ ظاهر ٿيندا آهن.

7. ٽڪيٽ وهڪري ۾ ايمبيڊنگز

ساڳيو KB کارپس ۽ ايمبيڊنگ انڊيڪس جيڪو ڳولا کي سنڀاليندو آهي، ٽڪيٽ وهڪري جي اندر ٻيهر استعمال ٿيندو آهي ته جيئن ٻن انتها موثر لحظن تي متعلقه مضمون نمايان ڪيا وڃن. هي KB-7 جو آپريشنل اظهار آهي ۽ سمارٽ داخل اسسٽنٽ (US-TKT-004، FR-TKT-021) ۽ مسودو جواب (US-AI-004، FR-AI-005) فيصلن سان مطابقت رکي ٿو.

7.1 ڪمپني کي داخل ڪرڻ وقت (ڦيرائو طرف)

جڏهن ڪو ڪمپني نمائندو ٽڪيٽ مرتب ڪندو آهي، عنوان ۽ وضاحت آن پریمس ايمبيڊ ٿيندي آهي ۽ ممڪن محڪمي/قسم جي اسڪوپ سان KB سان ميچ ڪئي ويندي آهي (جيڪا پاڻ AI روٽنگ مشوري مان ايندي آهي، /specs/sd/07-ai-ocr-spec/ §4.3).

ڇا ڏيکاريو ويندو آهي: 3 تائين درجه بنديل مضمون (SOPs، FAQs، how-tos) عنوان، خلاصو، ۽ "هيءُ منهجه مسئلي جو جواب آهي" عمل سان.
ڦيرائو عمل: جيڪڏهن نمائندو تصديق ڪري ته ڪو مضمون انهن جي مسئلي جو جواب آهي، مسودو مسترد ڪيو ويندو آهي ۽ هڪڙو ڦيرائو واقعو رڪارڊ ڪيو ويندو آهي (§9). ڪو به ٽڪيٽ نه ٺاهيو ويندو.
اڳتي وڌڻ: جيڪڏهن ڪو به مسئلي جو جواب نه هجي، نمائندو داخل ڪرڻ جاري رکندو؛ اها حقيقت ته مضمون پيش ڪيا ويا (۽ قبول نه ٿيا) تجزين لاءِ رڪارڊ ڪئي ويندي آهي.
دائروڪار: رڳو اهي مضمون جن جي audience ۾ public يا company شامل هجي، اهل آهن.

7.2 آفيسر کي جواب ڏيڻ وقت (استقلال طرف)

جڏهن ڪو تفويض ٿيل آفيسر جواب جو مسودو تيار ڪندو آهي، ٽڪيٽ جو قسم + تاريخ متعلقه SOP(s) ۽ FAQs حاصل ڪرڻ لاءِ استعمال ٿيندي آهي. هي مسودو جواب جي صلاحيت (/specs/sd/07-ai-ocr-spec/ §4.5) تي پرت لڳائي ويندي آهي: حاصل ٿيل KB چنکس حوالو ٿيل سياق و سباق بڻجن ٿا جن ۾ مسودو جڙيل هوندو آهي.

ڇا ڏيکاريو ويندو آهي: ٽڪيٽ جي قسم سان منسلڪ SOP(s) (§4.5)، ان کان علاوه سيمنٽڪ طور مشابهت FAQs/گائڊز، هر هڪ "جواب ۾ حوالو ڏيو" عمل سان.
حوالو: جڏهن آفيسر ڪنهن مضمون جو حوالو ڏيندو آهي، حوالو (type: kb، id) موڪليل پيغام ۽ ڪنهن به AI مسودي (AI اسپڪ §2.1 Citation) سان منسلڪ ٿيندو آهي.
دائروڪار: آفيسر جي محڪمي ۽ ٽڪيٽ جي قسم مطابق اسڪوپڊ؛ ڪراس محڪماني مضمون رڳو ان وقت ظاهر ٿيندا آهن جڏهن صريح طور ڪراس لنڪ ٿيل هجن.
استقلال لوپ: حوالو ٿيل مضمون ۽ انهن جي قبوليت مددگاري ۽ استقلال تجزين (§13) کي فيڊ ڪندي آهي.

7.3 ناڪامي جا طريقا

جيڪڏهن ايمبيڊنگ ماڊل دستياب نه هجي، ته ٻئي سطحون KB تي ليڪسيڪل ڳولا تائين گريڊ ٿي وينديون (KB-8).
جيڪڏهن پورو ڳولا انڊيڪس دستياب نه هجي، مشوري جون سطحون خوش اسلوب سان لڪي وينديون؛ داخل ڪرڻ ۽ جواب ڏيڻ مشورن کان سواءِ هلندو.

8. فارمز لائبريري

فارمز لائبريري ڊائون لوڊ جوڳن حڪومتي فارمز جو همیشه موجودھ گهر آهي جيڪي سروس ڪئٽلاگ ۽ SOPs پاران حوالو ڏنا وڃن ٿا. اها FR-KB-004 (لاگ ان کان سواءِ ڊائون لوڊ جوڳا) ۽ KB-4 (همیشه موجوده لنڪس) کي پوري ڪري ٿي.

فيلڊ	مطلب
`form_id`	مستحڪم فارم سڃاڻپ ڪندڙ (ڪڏهين ٻيهر نمبر نه ڏنو ويندو)
`title`	في لوڪل
`owning_department`	اهو محڪمو جيڪو فارم جو مالڪ/نگهداشت ڪري ٿو
`linked_categories[]`	سروس ڪئٽلاگ قسما جيڪي هي فارم استعمال ڪن ٿا
`current_version`	تازہ ترين اشاعت ٿيل فارم فائل جو پوائنٽر
`versions[]`	ورزن ٿيل فائل اٽيچمينٽس (MinIO؛ AV-scanned) — هر اڳوڻو ورزن محفوظ
`canonical_url`	مستحڪم لنڪ جيڪو `current_version` تي حل ٿيندو آهي (KB-4)
`instructions`	في لوڪل: ڪيئن پُر ڪجي، ڪٿي جمع ڪرائجي، گهربل منسلڪات
`required_documents`	سنگتي دستاويزون جيڪي داخل ڪندڙ کي منسلڪ ڪرڻ گهرجن
`fees`	فارم/سروس جي فيس، جيڪڏهن ڪا هجي
`last_reviewed_at`	تازگيءَ جي تاريخ
`status`	`draft` / `published` / `retired`

همیشه موجوده لنڪس. مستند URL (/kb/forms/<form_id>) فارم ڪيترا ڀيرا اپڊيٽ ٿئي، تازہ ترين اشاعت ٿيل ورزن تي حل ٿيندو آهي. ٻاهريان حوالا — ٻين حڪومتي سائيٽن تي، پرنٽ ٿيل آن بورڊنگ پيڪن ۾، SOPs ۾ — ڪڏهين نه ٽٽندا. هڪڙو ریٹائر فارم پنهنجو URL برقرار رکندو آهي، 410 Gone "جن جي جانشيني ٿيل" نوٽس ۽ جانشين جي لنڪ سان واپس ايندو آهي.

ورژنگ ۽ آڊٽ. فارم ٻيهر اپ لوڊ ڪرڻ سان نئون ورزن ٺهندو آهي (KB-5)؛ اڳوڻو ورزن محفوظ ٿيندو آهي ۽ مجاز اسٽاف لاءِ ڊائون لوڊ جوڳو هوندو آهي. فارم لائبريرين ڪردار ۽ مالڪ محڪمي کي فارم جي تازگيءَ جي کُڌِي ختم ٿيڻ تي اطلاع ڏنو ويندو آهي.

9. ڦيرائو سرگزشت

ڦيرائو KB جو ماپيل تعاون آهي غير ضروري ٽڪيٽن کي گهٽ ڪرڻ ۾. هڪڙو ڦيرائو واقعو ان وقت رڪارڊ ڪيو ويندو آهي جڏهن ڪو صارف جواب KB ۾ ڳولهي وٺندو آهي ۽ اهو ٽڪيٽ نه داخل ڪندو آهي جيڪو هو ٻي صورت ڪندو. ڦيرائو هڪڙي Should صلاحيت آهي (FR-KB-006) ۽ تجزين جي انگيجمينٽ خاندان (KPI-COM-012) کي فيڊ ڪري ٿو.

9.1 ڦيرائي جو وهڪرو

flowchart TD V["Visitor / company rep on public help center or filing flow"] Search["Searches KB or composes a draft ticket"] Offer["System offers ranked article(s) scoped to likely dept/category"] Read["User opens an article (or chatbot answers from KB)"] Helpful{"User marks 'was this helpful'? → Yes"} Filed{"Filing intent abandoned?"} DEF["Deflection event recorded attributed to the article(s) offered, the query, the locale, the dept/category"] Chat["Chatbot resolves session without human handoff"] NoHelp["User continues / files"] Ticket["Ticket filed (offer-shown-but-not-accepted also logged)"] V --> Search Search --> Offer Offer --> Read Read --> Helpful Helpful -- Yes --> Filed Helpful -- No/No vote --> NoHelp Filed -- Yes, abandoned within window --> DEF Filed -- No, proceeded to file --> Ticket Search -. chatbot path .-> Chat Chat --> DEF NoHelp --> Ticket

تحريري وضاحت. ڪو زائر يا ڪمپني نمائندو KB ڳولي ٿو يا ٽڪيٽ جو مسودو مرتب ڪرڻ شروع ڪري ٿو. نظام ممڪن محڪمي ۽ قسم جي اسڪوپ سان درجه بنديل مضمون پيش ڪري ٿو. جڏهن صارف ڪو مضمون کولي ٿو (يا عوامي چيٽ بوٽ KB کارپس مان جواب ڏي ٿو) ۽ پوءِ، ڪنفيگريشن جوڳي نسبت جي کُڌِي اندر، ٽڪيٽ داخل نه ڪري ٿو، ته هڪڙو ڦيرائو واقعو رڪارڊ ڪيو ويندو آهي ۽ پيش ڪيل مضمون، اصل استفسار، لوڪل، ۽ استنتاجي محڪمي/قسم سان منسوب ڪيو ويندو آهي. ٻن نسبت جي رستن کي تسليم ڪيو ويندو آهي: (a) صارف صريح طور مضمون "ڇا هيءُ مددگار هو" → ها نشان زد ڪري ٿو ۽ کُڌِي اندر داخل نه ڪري ٿو؛ ۽ (b) چيٽ بوٽ ڪنهن سيشن کي انسان جي حوالي کان سواءِ حل ڪري ٿو (/specs/sd/07-ai-ocr-spec/ §4.8، KPI-AIM-008). جيڪڏهن صارف پيشڪش جي باوجود داخل ڪرڻ لاءِ اڳتي وڌي ٿو، ته هڪڙو "پيشڪش ڏيکاري، قبول نه ٿيل" واقعو اڃا تائين لاگ ڪيو ويندو آهي (ڦيرائي طور شمار ڪرڻ کان سواءِ) ته جيئن مواد بهتريءَ جو لوپ اهڙن مضمونن جو پتو لڳائي سگهي جيڪي نمايان ته ٿي رهيا آهن پر لينڊ نه ٿي رهيا. ڦيرائي جا واقعا واقعي جي سطح تي PII کان پاڪ آهن (ڪو ٽڪيٽ متن ناهي، ڪابه ذاتي سڃاڻپ ڪندڙ ناهي سواءِ هڪڙي مبهم سيشن/ڪمپني بينڊ جي) ۽ تجزين جي انگيجمينٽ خاندان (KPI-COM-012) ۽ §13 جي KB تجزين کي فيڊ ڪن ٿا.

9.2 نسبت جي کُڌِي ۽ قاعدا

نسبت جي کُڌِي — پيشڪش/جواب کان "داخل نه ڪيو" تائين بنيادي 24 ڪلاڪ. في ماحول ڪنفيگريشن جوڳي.
نسبت جا هدف — پيش ڪيل مضمون، استفسار، لوڪل، استنتاجي محڪمو/قسم، ۽ سطح (مدد مرڪز / داخل ڪرڻ جو وهڪرو / چيٽ بوٽ).
ٻوڙو شمار نه — هڪڙو سيشن وڌيڪ ۾ وڌيڪ هڪ ڀيرو ڦيرائي ٿيندو آهي، مددگار نشان زد مٿانهين درجه بنديل مضمون (يا، چيٽ بوٽ رستي لاءِ، حوالو ٿيل مضمون) سان منسوب ٿيندو آهي.
بنيادي طور تي محتاط — رڳو صريح "مددگار → داخل نه ٿيو" ۽ "چيٽ بوٽ حل ٿيل" رستا سرخي ڦيرائي شرح ۾ شمار ٿيندا آهن. "پيشڪش ڏيکاري، قبول نه ٿيل، پوءِ داخل نه ٿيو" الڳ طور هڪڙي ممڪن ڦيرائي طور رپورٽ ٿيندو آهي، سرخي ۾ جمع نه ٿيندو.

9.3 ميٽرڪس

ڦيرائو هيٺين ميٽرڪس کي فيڊ ڪري ٿو (تفصيل /specs/sd/17-analytics-kpis/ ۾):

ميٽرڪ	تعريف	ماخذ
KB ڦيرائو شرح	`Deflected sessions ÷ KB sessions`	`KPI-COM-012`
چيٽ بوٽ ڦيرائو شرح	`Chatbot sessions resolved without human ÷ chatbot sessions`	`KPI-AIM-008`
في مضمون ڦيرائو ڪائونٽ	ڪنهن مخصوص مضمون سان منسوب ڦيراوا	`kb_*`
في محڪمو ڦيرائو	استنتاجي محڪمي/قسم مطابق گروپ ٿيل ڦيراوا	`kb_*`
پيشڪش ڏيکاري قبول نه ٿيل	اهي سيشن جتي مضمون پيش ڪيو ويو پر ٽڪيٽ پوءِ به داخل ڪيو ويو	`kb_*`

10. "ڇا هيءُ مددگار هو" فيڊ بیک لوپ

هر عوامي KB آئٽم تي هڪڙو "ڇا هيءُ مددگار هو" ڪنٽرول (ها / نه، اختياري فري ٽيڪسٽ سبب سان) هوندو آهي. اهو FR-KB-005 آهي ۽ ڳولا تجزين سان گڏ مواد بهتريءَ جو بنيادي سگنل آهي.

10.1 حصول

في مضمون — مضمون جي صفحي تي ها/نه ووٽ؛ اختياري سبب متن. في سيشن في مضمون هڪڙو ووٽ شور گهٽ ڪرڻ لاءِ.
مشوري جي سطحن تي — جڏهن ڪو مضمون ان فلو (§7) پيش ڪيو ويندو آهي ۽ صارف ان تي عمل ڪندو آهي (جواب ۾ حوالو ڏيندو آهي، يا "هيءُ منهجه مسئلي جو جواب آهي" نشان زد ڪندو آهي)، اهو تعامل ضمني مددگار/غير مددگار سگنل طور حاصل ڪيو ويندو آهي.
چيٽ بوٽ جوابن تي — چيٽ بوٽ جو ٿمبز اپ/ڊائون (ai_feedback) حوالو ٿيل KB مضمون سان واپس منسلڪ ٿيندو آهي.

10.2 مجموعو

ووٽ في مضمون، في لوڪل، ۽ في قسم گڏ ڪيا ويندا آهن، ۽ KB تصنيف ڪندڙن ۽ ايڊيٽرن لاءِ تصنيف ڊيش بورڊ تي ڏسڻ ۾ ايندا آهن. مجموعن ۾ شامل آهن: مددگار ڪائونٽ، غير مددگار ڪائونٽ، مددگار تناسب، تازگيءَ جي کُڌِي تي رجحان، ۽ مٿانهين فري ٽيڪسٽ سبب (ڪلسٽرڊ).

10.3 بهتريءَ جو لوپ

فيڊ بیک لوپ تصنيف ۽ حڪمراني ۾ بند ٿيندو آهي:

سگنل	محرڪ	عمل
گهٽ مددگار تناسب (< 0.5 براه راست N ويوز تي)	مضمون گهٽ ڪارڪردگي ڏيکاري ٿو	ايڊيٽوريل جائزي لاءِ نشان زد؛ ايڊيٽر جي فرزبندي قطار تي ظاهر ٿيندو (§12.3).
ٻيهر اچڻ وارو فري ٽيڪسٽ سبب ڪلسٽر	سببن جو ڪو ڪلسٽر ورجائي ٿو (مثال طور "پراڻو"، "غلط فيس")	مضمون ۽ متعلقه SOP/فارم سان منسلڪ هڪڙو مواد بهتريءَ جو ٽاسڪ پاڻمرادو ٺهي ٿو.
وڌيڪ پيشڪش ڏيکاري قبول نه ٿيل (§9)	مضمون اڪثر نمايان ٿيندو آهي پر شاذ و نادر لينڊ ٿيندو آهي	ٻيهر درجه بندي وزن جائزي يا مواد ٻيهر تحرير لاءِ نشان زد.
وڌيڪ غير مددگار رڳو هڪڙي لوڪل تي	EN مددگار، UR/SD غير مددگار	ترجمو انساني جائزي لاءِ نشان زد (§14).
مسلسل وڌيڪ مددگار + وڌندڙ ويوز	مضمون قيمتي آهي	ڪراس لنڪنگ، ترجمي جي ترجيح، يا مستند ۾ ترقي لاءِ اميدوار.

هر مواد بهتريءَ جو عمل متاثر ٿيل آئٽم جي چينج لاگ (§4.3) کي فيڊ ڪري ٿو ته جيئن لوپ سر تا سر آڊٽ جوڳو هجي.

11. تصنيف ۽ اشاعت جو ورڪ فلو

تصنيف هڪڙو گیٽڊ، ڪردار تي مبني ورڪ فلو آهي جنهن ۾ شيڊيوڊ اشاعت ۽ ختم ٿيڻ شامل آهي. اهو FR-KB-001 ۽ FR-KB-002 کي پورو ڪري ٿو.

11.1 ڪردار

ڪردار	ڪير	اهم حق
KB تصنيف ڪندڙ	محڪمي جو عملو يا S&ITD مواد جو عملو	پنهنجي محڪمي جي اسڪوپ ۾ مضمونن، SOPs، فارمز، گائڊز، FAQs جا مسودا ٺاهيو/ترميم ڪريو؛ جائزي لاءِ جمع ڪريو؛ اشاعت نه ڪري سگهو.
KB ايڊيٽر	S&ITD ايڊيٽوريل عملو	ڪنهن به جمع ٿيل آئٽم جي وضاحت، گهڻ لساني تيارڪاري، درجه بندي، ڪراس لنڪس جو جائزو وٺو؛ ترميمون گهرو؛ اشاعت قطار تائين منظور ڪريو؛ بنيادي SOP تبديلين لاءِ ڪنهن محڪمي جي طرفان اشاعت نه ڪري سگهو.
KB پبلشر	محڪمي جو سربراهه يا مندوب پبلشر	پنهنجي محڪمي جي اسڪوپ ۾ آئٽمز منظور ۽ شايع ڪريو؛ اشاعت/ختم ٿيڻ شيڊيوول ڪريو؛ آئٽمز ریٽائر ڪريو؛ SOP چينج لاگ تي دستخط ڪريو.
فارمز لائبريرين	S&ITD آپريشنز	فارمز لائبريري (§8) سنڀاليو: ورزن اپ لوڊ ڪريو، مستند لنڪس سيٽ ڪريو، تازگيءَ جو جائزو وٺو.
سپر ايڊمن	S&ITD	اوور رائڊ، ملڪيت ٻيهر تفويض، درجه بندي ڪنفيگر، فيچر فليگز سنڀاليو.

مڪمل RBAC، بشمول باريڪ في اجازت اوور رائڊز، /specs/sd/04-roles-permissions/ ۾ آهي.

11.2 تصنيف + اشاعت ورڪ فلو

stateDiagram-v2 [*] --> Draft: Author creates item Draft --> Draft: Author edits / autosaves Draft --> InReview: Author submits for review InReview --> Draft: Editor requests revisions InReview --> Approved: Editor approves Approved --> Scheduled: Publisher sets effective_from in future Approved --> Published: Publisher publishes now Scheduled --> Published: at effective_from (auto) Published --> Retired: Publisher retires (expires_at) Published --> Draft: substantive change → new version, prior version archived Retired --> Published: restore (new version) Retired --> [*] Published --> [*]: terminal (current)

تحريري وضاحت. ڪو تصنيف ڪندڙ آئٽم کي Draft طور ٺاهيندو آهي ۽ آزاديءَ سان آٽو سيو ڪري سگهندو آهي. جمع ڪرڻ تي، آئٽم InReview ۾ داخل ٿيندو آهي ۽ KB ايڊيٽر کي اطلاع ڏنو ويندو آهي. ايڊيٽر يا ته ترميمون گهرندو آهي (Draft ڏانهن واپس) يا منظور ڪندو آهي (Approved تائين). Approved مان، پبلشر يا ته فوراً شايع ڪندو آهي (Published) يا مستقبل جي effective_from تي اشاعت شيڊيوول ڪندو آهي (Scheduled، جڏهن تاريخ ايندي پاڻمرادو اشاعت — §11.4). ڪو Published آئٽم ریٽائر (Retired، expires_at ۽ اختياري جانشين سان) ٿي سگهي ٿو، يا بنيادي تبديلي لاءِ کوليو ويندو آهي، جيڪو هڪڙو نئون ورزن ٺاهيندو آهي جنهن جي مسودو حالت Draft هوندي آهي جڏهن ته اڳوڻو ورزن موجوده اشاعت ٿيل ورزن رهندو آهي جيستائين نئون ورزن شايع ٿئي (KB-5). ڪو ریٽائر آئٽم بحال ٿي سگهي ٿو، جيڪو نئون ورزن شايع ڪندو آهي. ٽرمينل حالتون Published (موجوده) ۽ Retired آهن. هر منتقلي هڪڙو آڊٽ واقعو لکندي آهي ۽، اشاعت تي، هڪڙو ورزن/چينج لاگ قطار ۽ ٻيهر انڊيڪس جاب.

11.3 گهڻ لساني تيارڪاري گیٽ

ڪنهن آئٽم کي ڪنهن مخصوص لوڪل ۾ Approved → Published منتقل ڪرڻ کان اڳ، ان لوڪل کي تيار نشان زد ٿيڻ گهرجن: ان جو ترجمو موجود آهي، انساني جائزي (§14) مان گذريو آهي، ۽ منظور ٿيل _glossary.md اصطلاح استعمال ڪري ٿو. ڪو آئٽم EN ۾ Published ٿي سگهي ٿو جڏهن ته UR/SD ۾ اڃا تائين Draft هجي؛ عوامي سطحون ان آئٽم لاءِ رڳو انهن لوڪلز کي ڏيکارينديون آهن جيڪي شايع ٿي چڪا آهن، باقي تي هڪڙو مرئي "ترجمو جاري آهي" نوٽ سان، انگريزي مواد تي لوٽڻ بدران.

11.4 شيڊيوڊ اشاعت ۽ ختم ٿيڻ

شيڊيوڊ اشاعت — ڪو پبلشر effective_from مستقبل جي تاريخ تي سيٽ ڪري سگهي ٿو؛ آئٽم Scheduled ۾ منتقل ٿيندو آهي ۽ ان ٽائم اسٽيمپ تي پاڻمرادو شايع ٿيندو آهي. ڪنهن نوٽيفڪيشن تاريخ مطابق پاليسي تبديلين لاءِ ڪارآمد.
ختم ٿيڻ — ڪنهن به اشاعت ٿيل آئٽم تي expires_at ٿي سگهي ٿو؛ ان تاريخ تي اهو پاڻمرادو ریٽائر ٿيندو آهي (جيڪڏهن اعلان ٿيل هجي ته جانشين سان). ختم ٿيڻ عام طور تي وقت بند سرڪيولرز ۽ نوٽسز لاءِ استعمال ٿيندو آهي، SOPs لاءِ ناهي.
ٽائم زونز — سڀ شيڊيوولنگ UTC ۾ محفوظ آهي ۽ _context.md §2 مطابق هجري تاريخن سان Asia/Karachi (PKT) ۾ رينڊر ٿيندي آهي.

12. مواد جي حڪمراني

حڪمراني کارپس کي صحيح، ملڪيت، ۽ تازو رکي ٿي. اها FR-KB-008 (پراڻي مواد جو نشان زد) کي پوري ڪري ٿي.

12.1 ملڪيت

هر KB آئٽم جو هڪڙو مالڪ محڪمو هوندو آهي ۽، ان جي اندر، هڪڙو جوابده مالڪ (نامزد KB پبلشر). ملڪيت اهو طع ڪندي آهي ته جائزي لاءِ ڪنهن کي اطلاع ڏنو وڃي، ڪير اشاعت ڪري سگهي ٿو، ۽ ڪنهن جي ڊيش بورڊ تي آئٽم ظاهر ٿيندو آهي. موجوده مالڪ کان سواءِ آئٽمز "يتيم" نشان زد ٿيندا آهن ۽ سپر ايڊمن حڪمراني ويو تي ظاهر ٿيندا آهن.

12.2 جائزي جي ڪيڊنس

هر مواد جي قسم جي هڪڙي بنيادي تازگيءَ جي کُڌِي (§2) هوندي آهي. کُڌِي ختم ٿيڻ تي، آئٽم Needs Review نشان زد ٿيندو آهي ۽ ان جي مالڪ کي اطلاع ڏنو ويندو آهي. ڪيڊنس في محڪمو ۽ في مواد جي قسم ڪنفيگريشن جوڳي آهي.

مواد جو قسم	بنيادي تازگي	بنيادي جائزي جي ڪيڊنس
how_to, faq	180 ڏينهن	هر 180 ڏينهن
sop, guide	365 ڏينهن	هر 365 ڏينهن؛ جيڪڏهن منسلڪ SLA يا قانون بدلجي ته جلد
form	365 ڏينهن	هر 365 ڏينهن؛ جڏهن ماخذ فارم ۾ ترميم ٿئي ته فوراً
legal	365 ڏينهن	هر 365 ڏينهن؛ قانون/نوٽيفڪيشن جي ترميم تي فوراً
video	365 ڏينهن	هر 365 ڏينهن؛ بنيادي پروسيس تبديليءَ تي ٻيهر رڪارڊ ڪريو

12.3 پراڻي مواد جا فليگز

ڪو آئٽم هيٺين مان ڪنهن تي پراڻو (Needs Review) نشان زد ٿيندو آهي:

ان جي تازگيءَ جي کُڌِي last_reviewed_at کان پوءِ گذري وئي آهي.
ڪا منسلڪ SLA قطار (sla_definitions) آئٽم جي آخري جائزي کان پوءِ بدلي وئي آهي.
ڪو منسلڪ قانون/نوٽيفڪيشن (legal آئٽمز لاءِ) last_reviewed_at کان پوءِ رڪارڊ ٿيل ترميم رکي ٿو.
ان جو مددگار تناسب ٻن مسلسل کُڌين لاءِ حد کان هيٺ لهي ويو آهي (§10.3).
ان جو مالڪ محڪمو ٻيهر منظم ڪيو ويو آهي (قسم جي وڻ جي تبديلي) ۽ آئٽم جو قسم هاڻي حل ناهي ٿيندو.

پراڻا آئٽمز مالڪ ۽ ايڊيٽر جي جائزي وارن قطارن تي ظاهر ٿيندا آهن، عوامي صفحي تي بصري طور نشان زد ٿيندا آهن ("جائزي هيٺ — مواد اپڊيٽ ٿي سگهي ٿو")، ۽ جائزو ورتو وڃي تائين ڳولا درجه بندي جي مٿانهين کان خارج ڪيا ويندا آهن.

13. تجزيا

KB تجزيا /specs/sd/17-analytics-kpis/ ۾ انگيجمينٽ/ڪمز ميٽرڪ خاندان جو حصو آهن ۽ سپر ايڊمن ۽ S&ITD ڊيش بورڊز تي ڏسڻ ۾ ايندا آهن.

13.1 KB ميٽرڪس

ميٽرڪ	تعريف	ريفريش
ويوز	في آئٽم ۽ في قسم ويو ڪائونٽس، في لوڪل ۽ سطح (مدد مرڪز / داخل ڪرڻ / آفيسر / چيٽ بوٽ) مطابق.	ڪلاڪ وار
مددگاري	في آئٽم مددگار تناسب ۽ مطلق ڪائونٽس؛ في قسم ۽ محڪمو مجموعو.	روزانو
ڦيرائو شرح	`KPI-COM-012`؛ في مضمون، في محڪمو، في سطح (§9.3).	روزانو
ڳولا ۾ ڪابه نتيجو نه هجڻ جي شرح	`Zero-result queries ÷ all queries`، في لوڪل ۽ استنتاجي قسم مطابق. گلاسري ۽ مواد جي فرق جي ڪم کي هلائي ٿو.	ڪلاڪ وار
"ڇا توهان جو مطلب هيءُ هو" قبوليت	شرح جنهن تي مشورو ڏنل متبادل ڪلڪ ڪيو ويو.	روزانو
مٿانهين استفسار	سڀ کان وڌيڪ ڳولا ٿيل اصطلاح، في لوڪل ۽ قسم مطابق، پنهنجن نتيجو ڪائونٽس ۽ مددگار تناسب سان.	روزانو
مواد جا فرق	استفسار (يا استفسار ڪلسٽرز) جن جا صفر يا گهٽ معيار نتيجا آهن، تعدد مطابق درجه بنديل — نئين مضمونن لاءِ اميدوار موضوع.	هفتيوار
ان فلو مشورو قبوليت	شرح جنهن تي آفيسر پيش ڪيل مضمون جو حوالو ڏين ٿا ۽ جنهن تي داخل ڪندڙ مضمون کي پنهنجي مسئلي جو جواب تسليم ڪن ٿا.	روزانو
تازگي ڪوريج	`Items within freshness window ÷ all published items`، في محڪمو ۽ قسم مطابق.	روزانو
ترجمو ڪوريج	`Items published in UR ÷ in EN` ۽ `in SD ÷ in EN`، بڪ لاگ سان.	روزانو

13.2 ڊيش بورڊز

KB ميٽرڪس هنن تي ظاهر ٿيندا آهن: سپر ايڊمن ڊيش بورڊ (مڪمل KB خاندان + تازگي + فرق)؛ S&ITD ايڊيٽر ڊيش بورڊ (جائزي قطار، پراڻا آئٽمز، فيڊ بیک ڪلسٽرز، ترجمو بڪ لاگ)؛ ۽ في محڪمو پبلشر ڊيش بورڊ (هنن جي آئٽمز جا ويوز، مددگاري، ڦيرائو، تازگي). سڀ ڪردار اسکوپنگ (AP-3 /specs/sd/17-analytics-kpis/) پائين ٿا.

13.3 عوامي شفافيت

مجموعي، گمنام KB ميٽرڪس (ڪل ڦيراوا، مجموعي مددگاري، ڳولا ڪاميابي شرح) عوامي شفافيت ڊيش بورڊ (/specs/sd/02-functional-reqs/ FR-PUB-008) تي اشاعت جو اهل آهن، anl_pub_* مان ننڍڙي سيل سپريشن سان، لائيو استفسارن مان ڪڏهين ناهي.

14. گهڻ لساني مواد

گهٽ لساني مواد اشاعت ٿيل مواد لاءِ لازمي انساني جائزي سان AI پهرين تيار ڪيو ويندو آهي، _glossary.md کان هلائي ويندو آهي. اهو KB-1 کي پورو ڪري ٿو ۽ ترجمو صلاحيت (/specs/sd/07-ai-ocr-spec/ §4.6) سان مطابقت رکي ٿو.

14.1 پائيپ لائن

EN ۾ تصنيف — ماسٽر لوڪل. تصنيف ڪندڙ EN متن لکي ٿو ۽ انهن اصطلاحن کي نشان زد ڪري ٿو جن کي گلاسري ميپنگ استعمال ڪرڻ گهرجن.
AI پري ٽرانسليشن — ترجمو صلاحيت (گلاسري انجيڪٽڊ LLM، AI اسپڪ §3.1 مطابق UR/SD لاءِ آن پریمس Qwen 2.5 ترجيحي) UR ۽ SD مسودا ٺاهي ٿي.
انساني جائزو — هڪڙو ٻه لساني جائزو ڪندڙ هر لوڪل کي ترتيب ڏي ٿو. شهري سامهون قانوني متن، RTI جوابن، ۽ سرڪامٽي خط جي ڊومين واري مواد جو انساني جائزو انجن کان قطع نظر همیشه لازمي آهي (AI اسپڪ §4.6).
گلاسري لاڳو — اصطلاح _glossary.md خلاف چيڪ ڪيا ويندا آهن؛ انحراف نشان زد ٿيندا آهن. نيون اصطلاح اشاعت تي گلاسري ۾ شامل ڪيا ويندا آهن.
لوڪل تيارڪاري — هر لوڪل آزاد طور تيار نشان زد ٿيندو آهي (§11.3)؛ ڪو آئٽم UR/SD کان اڳ EN ۾ شايع ٿي سگهي ٿو.

14.2 معيار

ترجمي جي معيار في لوڪل (AI اسپڪ §9.2) ماپي ويندي آهي ته جيئن مضبوط EN اسڪور ڪمزور SD اسڪور کي ڍڪي نه سگهي.
جنهن لوڪل جو مددگار تناسب EN کان نمایان طور گهٽ هجي (§10.3) ان کي ان جي تازگيءَ جي کُڌِي اندر به ترجمي جي جائزي لاءِ نشان زد ڪيو ويندو آهي.
UR (Noto Nastaliq Urdu) ۽ SD (Noto Naskh Arabic) لاءِ RTL رينڊرنگ _context.md §2 ۽ /specs/sd/09-i18n-localization/ مطابق لاڳو ڪئي ويندي آهي.

15. فعلي تقاضن جي ميپنگ

هي دستاويز /specs/sd/02-functional-reqs/ §KB ۾ KB فعلي تقاضن کي واقع ڪري ٿو. ڪراس ريفرنسز:

FR	عنوان	هي دستاويز
`FR-KB-001`	مضمون، SOPs، ۽ فارمز تصنيف ۽ شايع ڪريو	§2، §11
`FR-KB-002`	SOPs ۽ مضمونن کي چينج لاگ سان ورزن ڪريو	§4
`FR-KB-003`	KB ۾ AI سيمنٽڪ ڳولا فراهم ڪريو	§6
`FR-KB-004`	لاگ ان کان سواءِ ڊائون لوڊ جوڳا فارمز پيش ڪريو	§8
`FR-KB-005`	"ڇا هيءُ مددگار هو" فيڊ بیک جي سرگزشت ڪريو	§10
`FR-KB-006`	KB مواد سان منسوب ٽڪيٽ ڦيرائي جي سرگزشت ڪريو	§9
`FR-KB-007`	سروس ڪئٽلاگ شايع ۽ سنڀاليو	§5
`FR-KB-008`	پراڻي مواد کي جائزي لاءِ نشان زد ڪريو	§12

اضافي KB رویا جيڪي هتي تصريح ٿيا آهن ۽ /specs/sd/01-prd/ ۾ صارف ڪهاڻين ڏانهن وڃن ٿا:

FR (هي دستاويز)	عنوان	MoSCoW
`FR-KB-009`	جواب ڏيڻ وقت آفيسر کي ۽ داخل ڪرڻ وقت ڪمپني کي متعلقه KB مضمون مشورو ڪريو	Should
`FR-KB-010`	"ڇا توهان جو مطلب هيءُ هو"، فلٽرز، ۽ درجه بنديل گهڻ لساني ڳولا نتيجا فراهم ڪريو	Must
`FR-KB-011`	همیشه موجوده مستند لنڪس ۽ ورژنگ سان فارمز لائبريري سنڀاليو	Must
`FR-KB-012`	في محڪمو ملڪيت، جائزي جي ڪيڊنس، ۽ پراڻن فليگز سان مواد سنڀاليو	Should
`FR-KB-013`	AI + انساني جائزي ذريعي UR/SD مواد تيار ڪريو، گلاسري تي مبني، لوڪل تيارڪاري گیٽ سان	Must
`FR-KB-014`	KB تجزيا نمايان ڪريو (ويوز، مددگاري، ڦيرائو، ڳولا ۾ ڪابه نتيجو نه، مواد جا فرق)	Should

16. فيچر فليگز

KB صلاحيتون سپر ايڊمن پاران في ماحول/محڪمو فيچر فليگ ماڊيول (Q) ذريعي ٽوگل جوڳيون آهن.

فليگ ڪليد	بنيادي	اسڪوپ	بند ٿيڻ جو اثر
`kb.enabled`	on	env	KB لڪيل؛ ڪئٽلاگ لڪيل؛ داخل ڪرڻ/آفيسر مشورا لڪيل
`ai.kb.semantic.enabled`	on	dept/env	سيمنٽڪ/ویکٹر ڳولا بند؛ رڳو ليڪسيڪل ڳولا (KB-8)
`ai.kb.suggest.filing.enabled`	on	dept/env	داخل ڪندڙن کي ڪابه مضمون مشورا ناهي (§7.1)
`ai.kb.suggest.reply.enabled`	on	dept/env	آفيسرن کي ڪابه مضمون مشورا ناهي (§7.2)
`kb.deflection.tracking.enabled`	on	env	ڦيرائو واقعا رڪارڊ نه ٿيندا (ڳولا/مددگاري اڃا تائين ڪم ڪن ٿا)
`kb.translation.auto.enabled`	on	dept/env	UR/SD مسودا پاڻمرادو پيدا نه ٿيندا؛ رڳو انساني ترجمو
`kb.chatbot_corpus.enabled`	on	env	KB چيٽ بوٽ ريٽرايول کارپس کان خارج
`kb.scheduled_publish.enabled`	on	env	شيڊيوڊ اشاعت/ختم ٿيڻ بند (اشاعت فوري آهي)

ايمبيڊنگ ۽ ريرينڪ مرحلن لاءِ انجن جو چونڊ ai_engine_configs (AI اسپڪ §2.2) ذريعي ڪنفيگر ڪيو ويندو آهي؛ ايمبيڊنگز همیشه آن پریمس آهن.

17. ڊيٽا ماڊل (خلاصو)

MariaDB ۾ KB مخصوص ٽيبلز (مڪمل اسڪيما /specs/sd/05-data-model/ ۾). Meilisearch انهن مان ٺهيل هڪڙو اخذ ٿيل انڊيڪس آهي.

ٽيبل	مقصد
`kb_items`	في KB آئٽم هڪ قطار (id، type، owning dept، categories، tags، audience، status، freshness window، current version).
`kb_item_versions`	في ورزن في لوڪل هڪ قطار (item_id، version، locale، title، summary، body، change_log، effective_from، status، authored_by، approved_by).
`kb_change_log`	في SOP/مضمون ورزن منظم تبديلي تاريخ (from/to، change_type، summary، rationale، actor).
`kb_forms`	فارمز لائبريري اندراج (form_id، owning dept، linked categories، canonical URL، current version).
`kb_form_versions`	ورزن ٿيل فارم فائل اٽيچمينٽس (MinIO ڪليدز، AV-scan حالت، اپ لوڊر، ٽائم اسٽيمپ).
`kb_service_catalog`	§5.1 مطابق في (محڪمو، قسم) سروس ڪئٽلاگ قطارون.
`kb_taxonomy`	قسمن، ٽيگز، سامعين لاءِ ڪنٽرولڊ ذخيرو لفظ.
`kb_feedback`	في مضمون مددگار/غير مددگار ووٽس + اختياري سبب + سيشن (PII کان پاڪ).
`kb_deflections`	ڦيرائو واقعا (منسوب مضمون، استفسار، لوڪل، محڪمو/قسم، سطح، ٽائم اسٽيمپ).
`kb_search_events`	ڳولا استفسار لوڪل، نتيجو ڪائونٽ، has-results، did-you-mean-accepted، سيشن سان.
`kb_ownerships`	في آئٽم مالڪ محڪمو + جوابده پبلشر + ايڊيٽر.
`kb_review_queue`	آئٽمز Needs Review / پراڻو / يتيم نشان زد، سبب ۽ تفويض ٿيل سان.

ايمبيڊنگ ویکٹرز AI سروس جي ايمبيڊنگ اسٽور ۽ Meilisearch ۾ رکيا ويندا آهن؛ ai_embeddings (AI اسپڪ §2.4) ٻيهر انڊيڪس ڪرڻ جو مستند ماخذ آهي. ڪابه pgvector ناهي.

18. سرگزشت

موضوع	مستند ماخذ
پيداوار سڃاڻپ، ٽيڪ اسٽيڪ، ماڊيول J فيصلو	`_context.md` §1، §3، §4
دستاويزي روايتون	`_conventions.md`
ٽي لساني اصطلاح	`_glossary.md`
KB فعلي تقاضا	`/specs/sd/02-functional-reqs/` §KB
AI صلاحيتون، انجن ايبسٽريڪشن، ايمبيڊنگز، RAG	`/specs/sd/07-ai-ocr-spec/` §2، §4.5، §4.6، §4.8، §5
ٽڪيٽ لائف سائيڪل، SLA، قسما	`/specs/sd/06-ticket-workflow/`
i18n / RTL / لوڪلائيزيشن	`/specs/sd/09-i18n-localization/`
KB تجزيا KPIs	`/specs/sd/17-analytics-kpis/` §6.7 (`KPI-COM-012`)، §6.6 (`KPI-AIM-008`)
ڊيٽا ماڊل	`/specs/sd/05-data-model/`
تصنيف/ايڊيٽر/پبلشر لاءِ RBAC	`/specs/sd/04-roles-permissions/`

دستاويز جو خاتمو۔