تجزیات و کلیدی کارکردگی اشاریے (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 ایمبیڈنگ، ECharts/Recharts، WebSocket لائیو پش، سرور سائیڈ برآمد، cron خلاصے) کا خلاصہ §3 میں ہے اور تفصیل /specs/ur/15-tech-architecture/ §14 میں۔

2. تجزیات کے اصول

SITP میں ہر میٹرک، ڈیش بورڈ، اور رپورٹ درج ذیل دس اصولوں پر عمل کرتی ہے۔ ان کا حوالہ شناخت (AP-1 … AP-10) سے اس دستاویز اور قبول کے معیار میں دیا جاتا ہے۔

3. تجزیات کا فن تعمیر (دہرائو)

اس حصے میں /specs/ur/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 ٹیبل ہیں جو ایک single nightly ورکر سے anl_mv_* سے بھرے جاتے ہیں، دبانے کے قواعد لاگو کیے گئے (§11 دیکھیں)۔ عوامی ڈیش بورڈ صرف anl_pub_* سے پڑھتا ہے۔

بھاری تاریخی queries اور Metabase ad-hoc reads ایک ریڈ ریپلیکا کے خلاف چلتے ہیں جب ریڈ ریپلیکاز متعارف ہوں (/specs/ur/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/ur/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/ur/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/ur/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

دستاویز کا اختتام۔