تجزيو ۽ اهم ڪارڪردگي اشاريا (KPIs)

سنڌ آءِ ٽي پورٽل — سهولت ڊيسڪ (SITP) لاءِ مڪمل ماپ جو نظام: نو ميٽرڪ خاندان، ست ڪردار جا ڊيش بورڊ، GIS هيٽ ميپ، عوامي شفافيت جي تھ، وقت بند خلاصا، برآمد، بے ضابطگي جي سڃاڻپ، خود خدمت رپورٽ ٺاهڻ، ۽ ماسٽر KPI فهرست.

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

هن دستاويز ۾ اھو ھر ميٽرڪ، ڊيش بورڊ، رپورٽ، ۽ ڪنٽرول مشخص ڪيو ويو آھي جيڪو SITP جو تجزياتي پليٽ پيدا ڪرڻ ضروري آھي. ھي ھڪڙوئي حوالو آھي جيڪو انجنيئرنگ ٽيم (MAAHIR) لاءِ ميٽيريلائيزڊ ويوز ٺاهڻ، S&ITD پيداوار مالڪ لاءِ ڊيش بورڊ منظور ڪرڻ، محڪمي سان لاڳاپيل اسٽيڪ ھولڊرن لاءِ پنھنجي ڪارڪردگي جي تشريح ڪرڻ، ۽ عوام لاءِ ھي سمجھڻ لاءِ استعمال ٿيندو آھي ته ڇا شايع ٿيل آھي ۽ ڇا ناھي.

تجزياتي پليٽ جون ٽي ذميداريون آھن:

1. عملي بصيرت — آفيسرن، DGs، محڪمي ايڊمنز، سيڪريٽرين، SACM/وزير، ۽ سپر ايڊمن کي SLAs ۽ مقصدن جي مقابلي ۾ پورٽل جي سڌي ۽ تاريخي حالت ڏسڻ جي سھولت.
2. جوابدهي ۽ شفافيت — ڪمپنين کي پنھنجي تعاملن کي ٽريڪ ڪرڻ ۽ عوام کي ھي ڏسڻ جي سھولت ته محڪما IT صنعت جي خدمت ڪيئن ڪري رھيا آھن، ان جا گمنام مجموعا ڏسڻ.
3. حڪمراني ۽ لاگت ڪنٽرول — S&ITD کي ڊيٽا تائين رسائي، AI خرچ، ريٽينشن، ۽ آڊٽ جي تکميل کي ساڳئي پليٽ مان govern ڪرڻ جي سھولت.

هن دستاويز ۾ نو ميٽرڪ خاندان، ست ڪردار ڊيش بورڊ (عوامي شفافيت ڊيش بورڊ سميت)، GIS/ضلعو هيٽ ميپ، وقت بند خلاصا، برآمد، بے ضابطگي جي سڃاڻپ ۽ SLA خلاف ورزي جي اڳڪٿي، محفوظ منظر / پسنديده / ايڪسپورٽ ڪرڻ جوڳا ويجيٽ، ھڪ تعريفن جي لغت، ڊيٽا جي تازگي ۽ درستگي ڪنٽرول، ۽ خود خدمت رپورٽ بلڊر (Metabase) شامل آھن. بنيادي فن تعمير (MariaDB ميٽيريلائيزڊ ويوز/ڪيوبز، Metabase embedding، ECharts/Recharts، WebSocket لائيو پش، سرور سائيڊ برآمد، cron خلاصا) جو خلاصو §3 ۾ آھي ۽ تفصيل /specs/sd/15-tech-architecture/ §14 ۾.

2. تجزيو جا اصول

SITP ۾ ھر ميٽرڪ، ڊيش بورڊ، ۽ رپورٽ ھيٺيان ڏنل ڏھن اصولن تي عمل ڪري ٿي. انهن جو حوالو سڃاڻپ (AP-1 … AP-10) سان هن دستاويز ۽ قبول واري معيار ۾ ڏنو ويندو آھي.

3. تجزيو جو فن تعمير (ٻيهر بيان)

هن حصي ۾ /specs/sd/15-tech-architecture/ §14 جو تجزياتي حصو ٻيهر بيان ڪيو ويو آھي ته ھي دستاويز پاڻ مرادو ھجي. مڪمل جزو بہ جزو منطق تکنيڪي فن تعمير واري دستاويز ۾ آھي.

3.1 مجموعو سازي جي حڪمت عملي

ڊيش بورڊ reads سڌي طرح transactional ٽيبلز تي ڪڏهن نٿا ھلن. تجزيو ماڊيول MariaDB ۾ ميٽيريلائيزڊ ويوز ۽ ھلڪن ڪيوبز جو ھڪ سيٽ برقرار رکي ٿو، جيڪي وقت بند BullMQ ورڪرز کان في KPI معين ڪيڊنس تي تازا ٿين ٿا (§6 ڏسو). پیٽرن ھي آھي:

• Transactional ٽيبلز (tkt_*, org_*, aud_*, ai_*, not_*, …) system of record آھن.
• مجموعو ٽيبلز (anl_mv_*) denormalized، اڳ ۾ ئي گروپ ٿيل rollups آھن (ڏينهن × محڪمو × قسم × ضلعو × شدت × … مطابق) جيڪي ڊيش بورڊ جي گرم ترين group-by queries لاءِ ڪليد ٿيل آھن. ھر anl_mv_* پنھنجي شڊول تي تازو ٿئي ٿو (لائيو-ish لاءِ ھر 5 منٽ؛ عملي لاءِ ڪلاڪيوار؛ تاريخي تکميل لاءِ nightly).
• ڪيوپ طرز ٽيبلز (anl_cube_*) گهڻ رُخي sums ۽ counts رکندا آھن جيڪي UI کي transactional ٽيبلز کي ٻيهر query ڪرڻ بغير ڪنھن به pre-cubed رُخ مطابق pivot ڪرڻ جي سھولت ڏين ٿا.
• عوامي مجموعا (anl_pub_*) بلڪل علحده، گمنام، denormalized ٽيبل آھن جيڪي ھڪ ئي nightly ورڪر کان anl_mv_* مان ڀرجن ٿا، دٻائڻ جا قاعدا لاڳو ڪيا ويا (§11 ڏسو). عوامي ڊيش بورڊ صرف anl_pub_* مان پڙهي ٿو.

ڀاري تاريخي queries ۽ Metabase ad-hoc reads ھڪ ريڊ ريپليڪا جي خلاف هلن ٿا جڏهن ريڊ ريپليڪاز متعارف ٿين (/specs/sd/15-tech-architecture/ §5.6 ڏسو). انهن تائين، Metabase کي ھڪ low-priority ڪنيڪشن پول تي لڳايو ويندو آھي جنھن جو پنھنجو throttle آھي ته جيئن تجزيو ڪار reads request path کي بک نه ڪري سگھن.

3.2 بصري اضلاع جو اسٽيك

• ڪسٽم ڊيش بورڊ — ست ڪردار ڊيش بورڊ، GIS/ضلعو هيٽ ميپ، ۽ عوامي شفافيت ڊيش بورڊ لاءِ Next.js پورٽل ۾ ECharts/Recharts. ٽائلز فلٽرز کي سھولت ڏين ٿا (تاريخ جو حد، محڪمو، قسم، ضلعو، چينل، شدت، locale).
• Metabase (embedded) — self-hosted؛ internal ڪردارن لاءِ signed URLs ذريعي embedded. ad-hoc ڇنڊ ڇاڻ، deep-dive عملي رپورٽنگ، ۽ خود خدمت رپورٽ بلڊر لاءِ استعمال (§15 ڏسو). Metabase تجزيو اسکيمي سان read-only ڳنڍجن ٿو؛ اھو ڪڏهن لکي نٿو سگھي.
• WebSocket لائيو پش — چونڊيل ٽائلز (کليل ٽِڪيٽ جي ڪائونٽ، خلاف ورزي ڪندڙ ٽِڪيٽس، ان ڪلاڪ جو مقدار، آفيسر active/idle) WebSocket گیٽ وي کي سبسڪرائب ٿين ٿا. Counts BullMQ ورڪرز ۽ domain events تي API کان push ٿين ٿا؛ مڪمل re-renders debounced آھن (§3.4 ڏسو).
• سرور سائيڊ برآمد — Puppeteer ذريعي PDF (letter معيار، letterhead-capable رپورٽس لاءِ) ۽ ExcelJS ذريعي Excel (تجزيو ڪار دوست گهڻ tab ورڪ بڪ لاءِ). raw ايڪسٽريڪٽس لاءِ CSV. سڀ برآمد BullMQ ورڪرز کان ٺاھيا وڃن ٿا ۽ presigned MinIO URLs ذريعي deliver ٿين ٿا (§12 ڏسو).

3.3 عوامي شفافيت جي عليحدگي

عوامي ڊيش بورڊ صرف anl_pub_* مان پڙهن ٿا. ڪابه لائيو query رستو عوامي route کي transactional يا internal aggregate ٽيبلز سان نه ڳنڍيندو آھي. ھي garantي ڏي ٿو ته عوامي UI ۾ bug ڪنھن ٽِڪيٽ قطار، ڪمپني نالي، يا آفيسر نالي کي لڪ نه ڪري سگھي. جيڪو nightly ورڪر anl_pub_* ڀري ٿو اھو §11.3 جا دٻائڻ جا قاعدا لاڳو ڪري ٿو.

3.4 لائيو پش ۽ پراڻي پڻ جو معاھدو

لائيو ٽائلز RBAC جي دائري ۾ channels کي سبسڪرائب ٿين ٿا؛ گیٽ وي ڪڏهن به client-asserted دائري تي اعتبار نٿو ڪري. Pushes debounced آھن (مثال طور، ھڪ ڪائونٽ ٽائل burst ھيٺ به وڌ ۾ وڌ ھر 5 سيڪنڊ ۾ ھڪ ڀيرو re-render ٿئي ٿو). ھر ٽائل ھڪ last_refreshed_at timestamp ۽ ھڪ تازگي SLA رکي ٿو (§17 ڏسو). جيڪڏهن ورڪر پوئتي رھي ته ٽائل ھڪ visible بيج سان stale نشان زد ٿئي ٿو؛ پراڻو ڊيٽا ڪڏهن به خاموشي سان موجوده طور پيش نٿو ڪيو وڃي.

4. تجزيو جو ڊيٽا وهڪرو (ڊاياگرام + تفصيل)

ڊاياگرام ڏيکاري ٿو ته ھڪ domain واقعو (ٽِڪيٽ حالت جي تبديلي، AI ڪال، notification delivery، آڊٽ write) تجزياتي پليٽ مان ڪيئن گذري ٿو ۽ ڊيش بورڊ، خلاصن، برآمد، ۽ عوامي صفحي تي ڪيئن ظاهر ٿئي ٿو.

تحريري تفصيل. ھر stateful ماڊيول مان domain events — ٽِڪيٽ transitions، org/RBAC تبديليون، AI ڪال آڊٽ قطارون، notification delivery receipts، آڊٽ لاگ writes، ۽ comms سرگرمي — ھڪ Redis pub-sub fan-out تي شايع ٿين ٿا. ٽن قسمن جا BullMQ ورڪرز انهن واقعن کي consume ڪن ٿا ۽ تجزيو اسٽور برقرار رکن ٿا: ميٽيريلائيزڊ ويو refreshers anl_mv_* کي 5 منٽ يا ڪلاڪيوار ڪيڊنس تي تازو رکن ٿا؛ ڪيوپ refreshers anl_cube_* کي ڪلاڪيوار يا nightly ٻيهر ٺاهين ٿا؛ ۽ عوامي گمنام ساز ورڪر anl_mv_* کي ھڪ ڀيرو nightly پڙهي ٿو ۽ مڪمل گمنام، دٻائڻ جا قاعدا لاڳو anl_pub_* ٽيبل لکي ٿو جيڪو صرف عوامي ڊيش بورڊ پڙهي ٿو. کنفيگريشن — مقصد، حدون، digest شڊول، بے ضابطگي قاعدا — anl_cfg_* ۾ رهي ٿي ۽ surfaces (ته جيئن ٽائلز مقصد لائينون ڏيکارين) ۽ anomaly/digest ورڪرز ٻنھي کي feed ڪري ٿي.

ڇھ surfaces تجزيو اسٽور consume ڪن ٿا: ڪردار ڊيش بورڊ (ڪسٽم ECharts/Recharts، anl_mv_* plus ڪائونٽ ٽائلز لاءِ WebSocket لائيو پش کان feed)؛ ad-hoc ڇنڊ ڇاڻ لاءِ embedded Metabase anl_cube_* تي؛ anl_mv_* مان render ٿيل وقت بند خلاصا؛ anl_mv_* مان PDF/Excel/CSV پيدا ڪندڙ برآمد ورڪرز؛ anl_cfg_* جي حدن جي خلاف anl_mv_* ۾ رجحان پڙهندڙ بے ضابطگي detector ۽ SLA خلاف ورزي predictor؛ ۽ صرف anl_pub_* مان پڙهندڙ عوامي شفافيت ڊيش بورڊ. خلاف ورزي جي اڳڪٿي جون alerts notifications pipeline (خلاصا، in-app، WebSocket) ذريعي واپي وهن ٿيون ۽ پنھنجي RBAC دائري کان ٻاهر وصول ڪندڙن کي raw ٽِڪيٽ ڊيٽا ڪڏهن به ظاهر نٿيون ڪن.

5. KPI فهرست ۾ استعمال ٿيندڙ روايتون

KPI فهرست (§6) ۽ ماسٽر ٽيبل (§18) انهن روايتن جو استعمال ڪن ٿا:

• KPI سڃاڻپ — KPI-<FAM>-<nnn> جتي <FAM> ٽن اکرن جو خاندان ڪوڊ آھي (VOL, SPD, SLA, QLT, PERF, AIM, COM, GOV, PUB). سڃاڻپون EN/UR/SD ۾ مستحڪم آھن ۽ ڪڏهن به renumbered نٿيون ٿين.
• اڪائي — canonical اڪائي (count, ratio (0–1), percent, minutes, hours, days, PKR, tokens, events/day, score (0–5 يا 0–100 جيئن نوٽ ڪيو ويو آھي)).
• مقصد — default V1 مقصد. مقصد anl_cfg_* ذريعي في محڪمو configurable آھن؛ ٽيبل پليٽ فارم default ڏيکاري ٿو.
• ذريعو — بنيادي source ٽيبل يا event stream. tkt_* = ticketing؛ org_* = org/RBAC؛ aud_* = audit؛ ai_* = AI ڪال آڊٽ؛ not_* = notifications؛ com_* = comms؛ int_* = integrations؛ fil_* = files. سڀ KPIs انهن sources مان ماخوذ anl_mv_* rollups مان پڙھيا وڃن ٿا.
• سامعين — ڪردار ڪوڊز: SA سپر ايڊمن، DA محڪمي ايڊمن، DG ڊائريڪٽر جنرل، OF آفيسر، SEC سيڪريٽري، MIN وزير/SACM، CO ڪمپني، PUB عوام. ھڪ KPI جون سامعين اھو ڪردارن جو سيٽ آھن جن جا ڊيش بورڊ انهن کي ڏيکارين ٿا (§7 ڏسو).
• تازي ڪاري — وڌ ۾ وڌ پراڻو پڻ جيڪو ٽائل پراڻي نشان کان اڳ ڏيکاريندو: live (≤ 5 سيڪنڊ WebSocket ذريعي)، 5m، 15m، hourly، daily، weekly، monthly. سڀني لاءِ nightly تاريخي تکميل جي مطابقت مرعي آھي.
• سڀ time-windowed KPIs ڪنھن به bounded تاريخ جي حد ۽ معياري grains (ڪلاڪ، ڏينهن، ISO ھفتو، Gregorian مهينو، Gregorian سال) مان ڪنھن تي به قابلِ حساب آھن. Hijri مساوي صرف پيشکش تي حاصل ڪيا وڃن ٿا.

6. نو ميٽرڪ خاندان — KPI فهرست

6.1 خاندان 1 — مقدار ۽ ٿرو پُٽ (VOL)

مقدار ۽ ٿرو پُٽ ماپن ٿا ته پورٽل ڪيترو مطالبو جذب ڪري رھيو آھي ۽ اھو مطالبو ڪھڙي رفتار سان بند ٿي رھيو آھي، ھر معنيٰ خيز cut مطابق (محڪمو، قسم، ضلعو، چينل، شدت، ڪمپني سائز tier).

6.2 خاندان 2 — رفتار (SPD)

رفتار ٽِڪيٽ لائيف سائيڪل ۾ latency ماپي ٿي: ڪمپني کي جواب ڪھڙي رفتار سان ملي ٿو، مسئلو ڪھڙي رفتار سان حل ٿئي ٿو، ۽ workflow جي اندر وقت ڪٿي گڏ ٿئي ٿو.

6.3 خاندان 3 — SLA ۽ اِسڪيليشن (SLA)

SLA ميٽرڪس configurable response/resolution ونڊوز (default 2 / 5 / 10 ڏينهن) ۽ اِسڪيليشن ڏاڪي جي رویي جي تعميل ماپن ٿا.

6.4 خاندان 4 — معيار ۽ نتيجو (QLT)

معيار ميٽرڪس ماپن ٿا ته آيا حل درست طور ڪمپني کي مطمئن ڪيا، آيا proof-of-resolution گیٽ برقرار رهيو، ۽ آيا پھريون رابطو ڪافي ھو.

6.5 خاندان 5 — محڪمي ۽ عملي ڪارڪردگي (PERF)

محڪمي ۽ عملي ڪارڪردگي ميٽرڪس leaderboards، workload توازن، ۽ bottleneck جي سڃاڻپ هلائين ٿا. سڀ PERF KPIs محڪمي کان scoped آھن جيستائين صارف Super Admin (cross-department) يا Public (صرف گمنام محڪمو ranking — §11 ڏسو) نه ھجي.

6.6 خاندان 6 — AI ماڊل ميٽرڪس (AIM)

AI ميٽرڪس ھر AI صلاحيت جي معيار ۽ ان کي ھلائڻ جي لاگت ٻنھي ماپن ٿا. ھر معيار KPI کي انجڻ ۽ token/cost رُخ سان جوڙيو ويو آھي ته جيئن S&ITD AI خرچ کي ساڳئين ڊيش بورڊز مان govern ڪري سگھي جيڪي AI معيار ڏيکاريندا آھن.

6.7 خاندان 7 — مصروفيت ۽ مواصلات (COM)

مصروفيت ۽ comms ميٽرڪس ماپن ٿا ته آيا پورٽل جا notification ۽ چيٽ چينلز پنھنجن سامعين تائين درست پھچي رھيا آھن ۽ استعمال ٿي رھيا آھن.

6.8 خاندان 8 — حڪمراني ۽ تعميل (GOV)

حڪمراني ۽ تعميل ميٽرڪس S&ITD کي يقين ڏياريندا آھن ته رسائي review ٿي، آڊٽ مڪمل ٿيو، retention جو احترام ٿيو، ۽ قانوني قسمن (RTI) وقت تي نمٽايا ويا.

6.9 خاندان 9 — عوامي شفافيت (PUB)

پبلڪ خاندان عوامي شفافيت ڊيش بورڊ تي ظاهر ٿيندڙ KPIs جو واحد سيٽ آھي (§11 ڏسو). ھتي ھر KPI anl_pub_* مان ماخوذ آھي (nightly گمنام)، ڪڏهن به لائيو transactional query مان ناھي، ۽ §11.3 جي دٻائڻ جي قاعدن تي عمل ڪري ٿو.

7. ست ڪردار ڊيش بورڊ

ھر ڪردار کي پنھنجي فيصلن مطابق ڊيش بورڊ ملي ٿو. ھر ٽائل AP-1 (live + historical) ۽ AP-2 (scoped ٽِڪيٽ فهرست تائين ڊرل ڊائون) پوري ڪري ٿي. ھتي استعمال ٿيندڙ ڪردار ڪوڊ /specs/sd/04-roles-permissions/ سان ملن ٿا.

7.1 سپر ايڊمن ڊيش بورڊ (SA)

Cross-department، cross-channel، system-wide view. اھوئي ڪردار جو infrastructure + AI-cost + governance ٽائلز عملي KPIs سان گڏ رکي ٿو.

عملي ٽائلز: KPI-VOL-001..006, 013, 015 · KPI-SPD-001, 002, 008, 011 · KPI-SLA-001, 002, 003, 004 · KPI-QLT-001, 006, 012 · KPI-PERF-001, 009. مقدار cuts: چينل، قسم، ضلعو، محڪمو، ڪمپني سائز tier مطابق مقدار (KPI-VOL-007..011). AI خرچ ۽ معيار: KPI-AIM-001, 004, 006, 008, 014, 015, 017, 018, 019, 020 (مڪمل AI خاندان قابلِ رسائي). مصروفيت/comms: KPI-COM-001..004, 008, 010. حڪمراني/تعميل: مڪمل GOV خاندان (KPI-GOV-001..013)، access-review تکميل، آڊٽ تکميل، retention executions، step-up واقعا، privileged-action ڪائونٽ سميت. Config surfaces: مقصد (anl_cfg_*)، feature-flag status خلاصو، digest schedule صحت، سڀني anl_mv_* ورڪرز لاءِ freshness/staleness monitor (§17 ڏسو). خاص: system health badges (پبلڪ status صفحي مان portal/API/docs/notifications uptime)، MariaDB/Redis/MinIO exporter خلاصا (read-only)، Metabase launch لنڪ.

7.2 محڪمي ايڊمن ڊيش بورڊ (DA)

ھڪ محڪمي ۽ ان جي nested سيڪشنز تائين scoped. staffing ۽ workload فيصلا هلائي ٿو.

عملي ٽائلز: KPI-VOL-001..003, 005, 007, 008 (dept-scoped) · KPI-SPD-001, 003, 004, 007, 012 · KPI-SLA-001, 002, 003, 009 · KPI-QLT-001, 002, 005, 008. Workload ۽ عملو: KPI-PERF-002 (Gini)، KPI-PERF-005, 006, 007, 008, 013، KPI-PERF-010 (bottleneck سيڪشن)، KPI-PERF-011, 012 (top/under performers). سيڪشن ڊرل: ھر مجموعو سيڪشن ۽ انفرادي آفيسر جي قطار تائين drillable. مصروفيت: dept-scoped KPI-COM-008, 009, 010, 011. برآمد: گردش لاءِ one-click daily dept pack (PDF).

7.3 DG / ڊائريڪٽر ڊيش بورڊ (DG)

DG جي اختيار هيٺ محڪمن جي نگراني، SLA خطري ۽ اِسڪيليشن تي مرڪوز. configurable oversight matrix مطابق notify-only بمقابله action اختيارن جو احترام ڪيو ويو (/specs/sd/04-roles-permissions/ §9).

At-risk ڌيان: KPI-SLA-002, 003 (breach + at-risk، live)، KPI-SLA-005 (escalation rung distribution)، KPI-SPD-010 (time-in-escalation)، KPI-SLA-011 (breach recovery). نتيجو: KPI-QLT-001, 005, 006, 012، KPI-PERF-001 (purview لاءِ leaderboard). محڪمو موازنو: purview هيٺ side-by-side dept ٽائلز، في dept KPI-SPD-011, 013 سان. Action surface: حساس/VIP closures منظور ڪريو، ٽِڪيٽس کي اِسڪيليشن ڏاڪي مان هيٺ push ڪريو — ٻئي oversight config ۽ step-up auth کان gated.

7.4 آفيسر ڊيش بورڊ (OF)

ذاتي پيداواریت view: "منهنجي قطار، منهنجو SLA ڪلڪ، منهنجو CSAT."

منهنجي قطار: مون کي تفويض ٿيل کليل ٽِڪيٽس (live)، SLA-due مطابق sort؛ aging buckets KPI-SPD-008 (منهنجا)؛ KPI-SLA-003 (منهنجا at-risk ٽِڪيٽس). منهنجي رفتار: KPI-SPD-001, 005, 006 (منهنجو FRT، time-to-ack، handle وقت). منهنجو معيار: KPI-PERF-003, 004, 005, 006 (منهنجو CSAT، حل شرح، throughput، handle وقت)، KPI-QLT-008 (منهنجو FCR). مسودا ۽ AI assist: منهنجي draft-adoption شرح (KPI-AIM-006، ذاتي view)، منهنجي review هيٺ AI تجويزون (summary، routing، draft). Comms: منهنجا mentions/DMs (KPI-COM-010 منهنجي جوابدهي لاءِ)، منهنجا presence ڪلاڪ (KPI-COM-011).

7.5 سيڪريٽري / وزير ڊيش بورڊ (SEC / MIN)

سياسي ۽ انتظامي قيادت (سيڪريٽري S&ITD، وزير/SACM) لاءِ executive-summary view. نمبر platform-wide يا purview-wide آھن؛ تفصيل ھڪ ڪلڪ تي آھي پر تنهنجي نظر ۾ ناھي.

Headline ٽائلز: KPI-VOL-001, 002, 005، KPI-SLA-001, 010، KPI-QLT-001, 012، KPI-PUB-010. جوابدهي: KPI-PERF-001 (محڪمو leaderboard)، KPI-PERF-009 (bottleneck dept)، KPI-SLA-005 (ھر escalation rung تي ڪيترا، rung 3 = SACM سميت). رجحان: KPI-VOL-013 (MoM/YoY واڌ)، SLA تعميل ۽ CSAT تي 90 ڏينهن جون رجحان لائينون. AI ۽ لاگت (صرف MIN/SEC): KPI-AIM-018 (في انجن cost rollup)، KPI-AIM-008 (چيٽ بوٽ deflection)، KPI-AIM-020 (on-prem/cloud share — data-residency وضو). RTI: KPI-GOV-007, 008 (RTI مقدار + قانوني تعميل). عوامي شفافيت پيش نظارو: هن وقت عوام جيڪو ڏسي ٿو ان جو read-only mirror (§11)، ته جيئن قيادت internal بمقابله published نمبرز جو موازنو ڪري سگھي. Delivery: ڊيش بورڊ مواد scheduled digest طور به push ڪيو ويندو آھي (§8).

7.6 ڪمپني ڊيش بورڊ (CO)

ڪمپني نمائندي جو پنھنجو تجزيو: منهنجا ٽِڪيٽس، منهنجا جواب اوقات، منهنجو اطمينان — سختيءَ سان منهنجي ڪمپني جي ٽِڪيٽس تائين scoped (RBAC نافذ؛ ڪڏهن به ڪنهن ٻي ڪمپني جو ڊيٽا ناھي).

منهنجا ٽِڪيٽس: کليل/بند/حل ٿيل counts، aging buckets، في ٽِڪيٽ موجوده SLA status، at-risk flag. منهنجي جوابدهي: KPI-SPD-009 (await-on-company مدت — اھو وقت جيڪو ڪمپني پاڻ شامل ڪيو)، ڪمپني پاران inbound جواب شرح. منهنجو اطمينان: CSAT جيڪو مون ڏنو، appeals جيڪي مون داخل ڪيا، appeal status. منهنجا تعامل: notifications جيڪي مون وصول ڪيا ۽ پڙهيا، ڊيسڪ سان چيٽ sessions، KB مضمون جيڪي مون مددگار لڳا. Action surface: ٽِڪيٽ file ڪريو، await جو جواب ڏيو، TRI ميٽنگ جي درخواست، CSAT جمع ڪريو.

7.7 عوامي شفافيت ڊيش بورڊ (PUB)

بغير authentication جي visible ھڪڙوئي ڊيش بورڊ. تفصيل §11 ۾. خصوصاً anl_pub_* مان ماخوذ. ٽائلز: KPI-PUB-001..010، GIS هيٽ ميپ (§10)، ھر ميٽرڪ جي وضاحت ڪندڙ plain-language FAQ، ۽ "data published on" timestamp.

8. وقت بند خلاصا

ھڪ cron-driven BullMQ job configurable ڪيڊنس تي في ڪردار، في محڪمو خلاصا render ڪري ٿو ۽ کين notifications pipeline ذريعي push ڪري ٿو (email/SMS/WhatsApp/in-app، وصول ڪندڙ جي ترجيح مطابق). سڀ خلاصا گهڻ لساني آھن (وصول ڪندڙ جو locale) ۽ Gregorian + Hijri تاريخون رکن ٿا.

8.1 Default digest شڊول

مٿي ھر ڪيڊنس anl_cfg_* ذريعي في وصول ڪندڙ، في محڪمو، ۽ في ماحول configurable آھي. Preference center ڪنهن به صارف کي digest قسم مطابق mute، digest-only تي switch، يا چينل تبديل ڪرڻ ڏي ٿو.

8.2 نمونو digest layout (سيڪريٽري، روزانه)

Sindh IT Portal — Facilitation Desk
Daily Digest · S&ITD Secretary
Gregorian: Mon 17 Jul 2026 · Hijri: 2 Safar 1448

1. HEADLINE  (yesterday / rolling 7-day)
   - Tickets created:        312   (7-day avg 298)
   - Tickets resolved:       287   (7-day avg 271)
   - Open backlog:          1,453
   - SLA compliance:         96.2% (target 95%) ▲
   - CSAT:                   4.3 / 5
   - At-risk (next 24h):      18   [drill]
   - Breaching:                6   [drill]

2. DEPARTMENT LEADERBOARD (top 5 / bottom 3)
   Top:    Labour (98.4%) · IT (97.9%) · Investment (97.1%)
   Bottom: Excise (89.2%) · Revenue (90.1%) · Works (91.4%)

3. ESCALATION RUNG
   Rung 1 (2d, DG):   42
   Rung 2 (5d, Sec):   9
   Rung 3 (10d, SACM): 2   [drill]

4. RTI  (statutory)
   RTI handled:           7
   RTI within deadline: 100%

5. AI & COST
   AI calls yesterday: 2,114   cost: PKR 41,320
   On-prem share: 38%  Chatbot deflection: 47%

6. ANOMALY ALERTS  (from §14)
   - Excise dept SLA down 6.1pts vs 7-day avg.
   - FBR intake volume +220% vs baseline (spike).

[View full dashboard]   [Drill at-risk]   [Manage preferences]

8.3 Digest ڪنٽرولز

• Composability: ھر digest جا sections anl_cfg_* ۾ KPI سڃاڻپن سان map ٿين ٿا، تنھنڪري ھڪ ايڊمن ڪوڊ بغير sections شامل/هٽائي سگھي ٿو.
• دٻائڻ: خلاصا عوامي ڊيش بورڊ وانگر گمنام سازي/دٻائڻ جي قاعدن جو احترام ڪن ٿا جتي ڪو section PUB خاندان KPIs ۾ داخل ھجي.
• ناڪامي کان نمٽڻ: جيڪڏهن digest job ناڪام ٿئي ته failed-recipient فهرست backoff سان ٻيهر tried ٿيندي ۽ Super Admin freshness/staleness monitor تي ظاهر ٿيندي.

9. برآمد

9.1 Format ۽ engines

سڀ برآمد BullMQ ورڪرز کان پيدا ٿين ٿا؛ صارف کي (in-app + email) مطلع ڪيو ويندو آھي جڏهن file تيار ھجي ۽ مختصر TTL سان presigned MinIO URL ذريعي download ٿيندي آھي.

9.2 برآمد معاھدو

• فلٽرز محفوظ: ھر برآمد استعمال ٿيل exact فلٽرز ۽ grain (تاريخ جو حد، محڪمو، قسم، ضلعو، چينل، شدت، locale) file header ۽ aud_event قطار ٻنھي ۾ record ڪري ٿو.
• RBAC نافذ: برآمد ورڪر generation جي وقت درخواست ڪندڙ صارف جي دائري جي ٻيهر check ڪري ٿو (defence in depth — پراڻو session دائري کي وسيع نٿو ڪري سگھي).
• حساس لاءِ step-up: confidential/VIP ٽِڪيٽس يا PII تي مشتمل برآمد job queued ٿيڻ کان اڳ step-up auth جي ضرورت.
• آڊٽ: KPI-GOV-009 (برآمد واقعا) ھر برآمد لاءِ who/what/when/filters capture ڪري ٿو.
• Retention: برآمد artifacts data-class retention rule مطابق MinIO مان expire ٿين ٿا؛ aud_event قطار آڊٽ ونڊو لاءِ retained.

10. GIS / ضلعو هيٽ ميپ

GIS/ضلعو هيٽ ميپ KPI-VOL-009، KPI-PUB-009، ۽ KPI-SLA-010/KPI-PUB-007 کي سنڌ جي ضلعن جي نقشي تي visualize ڪري ٿو.

تفصيل:

• Layer: سنڌ ضلعو polygons تي choropleth (_diagrams/gis/ ۾ versioned، حڪومت کان منظور ٿيل boundary file مان ماخوذ GeoJSON).
• Metric selector: مقدار / SLA تعميل / median TAT / CSAT — صارف (internal) جي چونڊ مطابق يا مقدار + SLA تعميل تي fixed (عوام).
• Grain: ضلعو؛ جتي ڊيٽا حجم اجازت ڏيي اتي tehsil تائين optional drill (عوامي layer لاءِ ضلعي کان هيٺ دٻائڻ جا قاعدا لاڳو).
• وقت selector: ڪو به bounded range؛ default آخري 30 ڏينهن.
• رنگ scale: sequential single-hue (Ajrak انڊigo ramp)؛ colour-blind safe؛ threshold bands anl_cfg_* ۾ configurable.
• Interactivity: hover → ضلعو نالو + قدر + sample سائز؛ click → ڊرل ڊائون فهرست (internal ڪردار) يا ضلعو خلاصو ڪارڊ (عوام).
• گمنام سازي (عوام): عوامي هيٽ ميپ anl_pub_* مان پڙهي ٿو ۽ §11.3 جي دٻائڻ جي قاعدن تي عمل ڪري ٿو (n ٽِڪيٽس کان گهٽ ڪابه ضلعو قدر سان نٿو ڏيکاريو وڃي؛ ان کي "Other / insufficient data" bucket ۾ group ڪيو وڃي ٿو — n configurable آھي، default 5).
• ڪارڪردگي: client-side ECharts geo سان render؛ geometry pre-simplified serve؛ ڊيٽا payload 50 KB کان هيٺ رکيو.

Implementation note: ڪابه PostGIS dependency ناھي — هيٽ ميپ bounding-box math ۽ ھڪ lightweight spatial index استعمال ڪري ٿو (/specs/sd/15-tech-architecture/ §5.1 ڏسو).

11. عوامي شفافيت ڊيش بورڊ

عوامي ڊيش بورڊ پورٽل جي جوابدهي جو واعدو آھي: ڪو به شهري، صحافي، يا ڪمپني ھڪ نظر ۾ ڏسي سگھي ٿو ته سنڌ آءِ ٽي پورٽل IT صنعت لاءِ ڪيئن ڪارڪردغي ڏيکاري رھيو آھي — login ڪرڻ بغير ۽ ڪنھن به انفرادي طور قابلِ سڃاڻپ ڊيٽا کي ظاهر ڪرڻ بغير.

11.1 ڇا ڏيکاريو وڃي ٿو

• KPI-PUB-001 ڪل موصولہ، KPI-PUB-002 ڪل حل ٿيل، KPI-PUB-003 في الحال کليل.
• KPI-PUB-006/KPI-PUB-007 محڪمو مطابق مقدار ۽ SLA تعميل (محڪما نالا public bodies آھن ۽ ڏيکاريا وڃن ٿا).
• KPI-PUB-008 قسم مطابق مقدار.
• KPI-PUB-009 GIS ضلعو هيٽ ميپ (§10).
• ھڪ plain-language "ان نمبرز جو ڇا مطلب آھي؟" FAQ (گهڻ لساني) ۽ "data published on" timestamp.

11.2 گمنام سازي جا قاعدا

1. ڪابه PII ناھي، ڪڏهن به ناھي. عوامي ڊيش بورڊ تي ڪابه ڪمپني نالو، آفيسر نالو، درخواست گزار نالو، ٽِڪيٽ سڃاڻپ، يا free-text ظاهر نٿو ٿئي.
2. علحده ٽيبل. سڀ عوامي KPIs anl_pub_* مان پڙهن ٿا، جيڪي anl_mv_* مان nightly گمنام ساز ورڪر کان ڀرجن ٿا. ڪابه لائيو query رستو عوامي route کي transactional ٽيبلز سان نه ڳنڍندو.
3. صرف مجموعو. ھر عوامي نمبر ≥ n ٽِڪيٽس (default n = 5) تي مجموعو آھي. ننڍڙا cells دٻايا وڃن ٿا يا "Other / insufficient data" ۾ roll ڪيا وڃن ٿا.
4. ننڍڙي cell جو لِيك ناھي. ٻن عوامي dimensions کي cross-tab ڪرڻ (مثال طور، محڪمو × قسم) اتي دٻايو وڃي ٿو جتي ڪو cell n کان هيٺ ھجي، ته جيئن تفريق سان re-identification روڪجي.
5. تاخير. عوامي ڊيٽا 24 ڪلاڪن جي تاخير سان شايع ٿئي ٿو (ڪالهه جو گمنام rollup)، تنھنڪري ھڪ filer پنھنجو اھاڻ جمع ٿيل ٽِڪيٽ نمبرز ۾ نه سڃاڻي سگھندو.
6. ڪابه raw برآمد ناھي. عوامي ڊيش بورڊ بنيادي قطارن جي CSV/Excel برآمد پيش نٿو ڪري — صرف شايع ٿيل مجموعا.
7. آڊٽ. ھر publish واقعو (ورڪر run، دٻائڻ کان اڳ/پوءِ قطار counts) aud_event ۾ لکيو وڃي ٿو ۽ Super Admin کي visible.

11.3 دٻائڻ جا parameters (configurable)

11.4 تازي ڪاري

Nightly (01:00 PKT) گمنام ساز ورڪر ذريعي. صفحي تي "data published on" timestamp آخري ڪامياب publish کي ظاهر ڪري ٿو؛ ناڪام publish پوئين ڏينهن جو ڊيٽا visible ڇڏي ٿو ۽ Super Admin alert کڙو ڪري ٿو (§17).

12. محفوظ منظر، پسنديده، ۽ Embeddable ويجيٽ

12.1 محفوظ منظر

ڪو به internal صارف ڊيش بورڊ حالت (ٽائلز + فلٽرز + grain + تاريخ جو حد) ھڪ named view طور save ڪري سگھي ٿو. محفوظ منظر default طور private آھن ۽ صارف جي محڪمي اندر shareable. Super Admin ھڪ محفوظ view کي محڪمو default تي promote ڪري سگھي ٿو.

12.2 پسنديده

ڪو به ٽائل يا KPI ھڪ پسنديده طور pin ٿي سگھي ٿو؛ پسنديده صارف جي ڊيش بورڊ جي top تي ھڪ ذاتي "My view" ٽائل strip ۾ گڏ ٿين ٿا. پسنديده sessions ۽ locales ۾ برقرار رهن ٿا.

12.3 Embeddable ويجيٽ

چونڊيل ٽائلز کي embeddable ويجيٽ (signed، time-limited iframe URLs) طور برآمد ڪري سگھجي ٿو ھيٺ ڏنل ۾ embed ڪرڻ لاءِ:

• محڪمو intranets ۽ S&ITD عوامي site.
• وزير/SACM briefing صفحا.
• Partner پورٽلز (PSEB، P@SHA) cross-industry visibility لاءِ — صرف PUB خاندان KPIs externally embeddable آھن.

Embeddable ويجيٽ rotating key سان signed، مخصوص KPI + filter مطابق scoped، ۽ rate-limited آھن. اھي ڪڏهن credentials نٿا رکن؛ اھي صرف گمنام يا اڳ ۾ ئي authorized مجموعا ڏيکاريندا آھن.

13. بے ضابطگي Detection ۽ SLA خلاف ورزي Prediction

13.1 بے ضابطگي detection

ھڪ scheduled ورڪر anl_mv_* کي شماراتي طور غير معمولي تبديلين لاءِ scan ڪري ٿو ۽ alerts کڙا ڪري ٿو:

• Threshold قاعدا (anl_cfg_* ۾ configurable): مثال طور، "محڪمو SLA تعميل 7 ڏينهن جي سراسري جي مقابلي ۾ > 5 پوائنٽس گهٽجي وڃي"، "ڪنهن چينل لاءِ intake حجم baseline جو > 200%"، "ڪنهن محڪمي لاءِ 3 ڏينهن تائين CSAT < 3.5".
• شماراتي anomalies: trailing window تي سادو z-score / rolling-median-plus-MAD، في KPI في cut. V1 تي ڪابه black-box ML ناھي — پهرين explainable قاعدا.
• Alert routing: anomalies notifications pipeline (in-app، WebSocket، ۽ ايندڙ متعلقہ digest ۾) ۽ Super Admin freshness/anomaly monitor تي وهن ٿا.

13.2 SLA خلاف ورزي prediction

KPI-SLA-003 (at-risk ڪائونٽ) ھڪ lightweight predictor مان حساب ٿئي ٿو:

• ھر کليل ٽِڪيٽ لاءِ remaining SLA budget بمقابله remaining SLA ڪلڪ compute ڪريو، ٽِڪيٽ جي category-historical TAT distribution ۽ تفويض ڪندڙ جي حاليه velocity کي factor ڪندي.
• جيڪڏهن projected حل > SLA due ھجي p confidence کان وڌيڪ، ته ٽِڪيٽ at-risk flag ڪريو.
• p configurable آھي (default 0.70). predictor KPI-SLA-003 لاءِ ھر refresh cycle ۽ live ٽائل لاءِ ھر متعلقہ domain واقعي تي ٻيهر حساب ٿئي ٿو.
• predictor جي درستگي پاھي tracked آھي (predicted_at_risk_that_breached ÷ predicted_at_risk) ھڪ governance check طور؛ alert ٿڪاوٽ کي محدود ڪرڻ لاءِ مقصد ≥ 0.70 precision.

13.3 Alert حفظان صحت

• ھر anomaly/breach alert ھڪ window اندر deduplicate ۽ في وصول ڪندڙ rate-limited آھي ته جيئن ٿڪاوٽ کان بچجي.
• Alerts scoped ٽِڪيٽ فهرست ۾ ھڪ drill لنڪ رکن ٿا (AP-2) ته جيئن وصول ڪندڙ فوراً action ڪري سگھي.
• Alert تعريفون versioned آھن؛ تبديليون ڪنھن ٻيءَ config تبديلي وانگر آڊٽ ٿين ٿيون.

14. ڊيٽا تازگي ۽ درستگي ڪنٽرول

14.1 تازگي SLAs

ھر anl_mv_* ٽيبل جي ھڪ شايع ٿيل تازگي SLA (KPI فهرست ۾ Refresh column) آھي. ھڪ monitor actual last-refresh کي SLA سان مقابلي ڪري ٿو؛ خلاف ورزي متاثر ٿيل ٽائلز تي stale بيج ۽ Super Admin alert کڙو ڪندي آھي.

14.2 مطابقت

ھر nightly run anl_mv_* کي transactional source totals (قطار counts ۽ sum checks) جي خلاف reconcile ڪري ٿو. threshold کان مٿي discrepancies Super Admin alert ۽ re-compute job کڙو ڪن ٿيون؛ متاثر ٿيل ٽائلز reconcile ٿيڻ تائين stale نشان زد آھن.

14.3 درستگي ڪنٽرول

• في KPI ھڪ تعريف (AP-5) — لغت §16 ڏسو.
• Sampled آڊٽس: Super Admin ڪنهن به KPI جي raw قطارن جي خلاف sampled re-computation trigger ڪري سگھي ٿو؛ نتيجا freshness monitor سان ڳنڍيل.
• Reproducibility: ھر برآمد ۽ ھر محفوظ view پنھنجو filter سيٽ record ڪري ٿو، تنھنڪري رپورٽ ۾ ڪو به نمبر anl_mv_* + filter سيٽ + تعريف جي version مان reproduce ٿي سگھي ٿو.

15. خود خدمت رپورٽ بلڊر (Metabase)

Internal ڪردارن (بنيادي طور تي Super Admin، Dept Admin، DG، سيڪريٽري) کي ad-hoc ڇنڊ ڇاڻ ۽ bespoke رپورٽن لاءِ embedded Metabase ملي ٿو.

• رسائي: پورٽل ۾ signed-URL embedding؛ صارف Metabase login screen ڪڏهن نٿا ڏسڻ. RBAC scopes embedding parameters طور passed ٿين ٿا ته جيئن Dept Admin جو Metabase session اڳ ۾ ئي پنھنجي محڪمي مطابق scoped ھجي.
• ڊيٽا boundary: Metabase anl_cube_* (۽ چونڊيل anl_mv_*) سان read-only ڳنڍجن ٿو؛ ڪڏهن transactional ٽيبلز سان ناھي؛ ڪڏهن anl_pub_* سان ناھي (عوامي writer اتي واحد writer آھي).
• محفوظ سوال ۽ ڊيش بورڊ: Metabase سوال/ڊيش بورڊ privately save يا role اندر share ٿي سگھن ٿا؛ sharing ساڳيءَ RBAC govern ڪري ٿي.
• Metabase مان برآمد: ساڳئي آڊٽ ٿيل برآمد path (§9) ذريعي CSV/Excel پيدا ڪن ٿا ته جيئن اھي KPI-GOV-009 ۾ ظاهر ٿين.
• Sandboxing: row-level sandboxing DB-level scope جي مٿان Metabase sandboxing ذريعي نافذ آھي، تنھنڪري Dept Admin ڪنهن ٻيءَ محڪمي جون قطارون select نٿو ڪري سگھي.
• عوامي embedding: ad-hoc سوالن لاءِ disabled. صرف curated PUB خاندان ٽائلز (§12.3) externally embeddable آھن.

16. تعريفن جي لغت (Metrics)

ھي لغت ھر ميٽرڪ اصطلاح لاءِ canonical source آھي. ھي (صرف metric-key طور) _glossary.md ۾ mirror آھي ته جيئن ساڳيون تعريفون UR/سنڌي ڊيش بورڊز ۾ نظر اچن. جتي تعريف غير واضح ھجي اتي فارمولا ڏنل آھي.

17. کنفيگريشن Surface (خلاصو)

سڀ tunables anl_cfg_* ۾ آھن ۽ Super Admin پاران editable آھن (step-up auth). تبديليون آڊٽ (aud_event) ۽ versioned آھن.

18. ماسٽر KPI فهرست

مڪمل فهرست: 9 خاندان، 120 KPIs. في خاندان counts: VOL 15 · SPD 13 · SLA 12 · QLT 12 · PERF 13 · AIM 20 · COM 12 · GOV 13 · PUB 10.

19. کليل سوال / TBD

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