ٹیسٹ سٹریٹیجی

سندھ آئی ٹی پورٹل — سہولت ڈیسک (SITP) کے لیے مرکزی ٹیسٹ اور تصدیق کی سٹریٹیجی: ٹیسٹنگ پیرامڈ، ٹولز، کوریج ہداف، CI/CD گیٹس، ٹیسٹ ڈیٹا سٹریٹیجی، نمونہ ٹیسٹ کیسز (TC-<EPIC>-<nnn>-<nn>)، Gherkin-as-spec، لوکلائزیشن/RTL، رسائی، سیکیورٹی، پرفارمنس/لوڈ، UAT، ریگریشن، خرابی کا انتظام، اور فنکشنل ریquirement ← یوزر اسٹوری ← قبولیت کے معیار ← ٹیسٹ کیس تک دو طرفہ ٹریس ایبلٹی۔

1. مقصد اور اس دستاویز کو پڑھنے کا طریقہ

یہ دستاویز SITP کے لیے مستند تصدیقی معاہدہ ہے۔ یہ انجینئرنگ، QA، MAAHIR آپریشنز، اور S&ITD قبولیت کے اسٹیک ہولڈرز کو بتاتی ہے کہ کیا ٹیسٹ کیا جاتا ہے، کس تہہ میں، کس ٹول کے ساتھ، کس ہدف تک، اور ہر ٹیسٹ کیس کس طرح کسی یوزر اسٹوری، اس کے قبولیت کے معیارات، اور اس سے پیدا ہونے والے فنکشنل ریquirement سے جڑا ہے۔ اسے RFP اور ٹینڈر کے لیے تیار بنایا گیا ہے، اور PPP کی جواب دہی کے معیار کو پورا کرنے کے لیے کہ ہر شیپ شدہ صلاحیت واضح طور پر تصدیق شدہ ہے۔

1.1 ایک ہی تصدیق کے لیے پڑھنے کی ترتیب

فنکشنل ریquirement (FR-...) → یوزر اسٹوری (US-...) → قبولیت کا معیار (Gherkin Scenario) → ٹیسٹ کیس (TC-<EPIC>-<nnn>-<nn>) → ٹیسٹ لیئر (یونٹ / انٹیگریشن / e2e / مینول) → CI گیٹ / NFR ہدف۔

اس دستاویز میں درج ہر TC /specs/ur/01-prd/ میں سے ایک یا زیادہ Gherkin منظرناموں کو عمل اور قابلِ تکرار بنانے کے لیے موجود ہے۔ ID مستقل، زبان سے آزاد ہیں، اور کبھی ترجمہ نہیں کیے جاتے۔

1.2 کوالٹی بار (ایک لائن بیان)

پورٹل اس وقت شیپ ابل ہے جب (a) PRD میں ہر [M] قبولیت کے معیار کے لیے کم از کم ایک کامیاب خودکار ٹیسٹ کیس ہو، (b) §5 کے کوریج ہداف پورے ہوں، (c) §6 کا ہر CI/CD گیٹ سبز ہو، اور (d) §13 کے UAT ایگزٹ معیارات پر پائلٹ محکموں نے دستخط کریں۔

1.3 دائرہ کار

2. ٹیسٹنگ کے اصول

1. بائیں کی طرف شفٹ کریں۔ یونٹ لیئر پر خرابیوں کو ٹھیک کرنا سب سے سستا ہے۔ ہر PR اپنے ٹیسٹس لاتا ہے؛ کچھ بھی بغیر تصدیق کے main تک نہیں پہنچتا (NFR-MAINT-003)۔
2. رویے کا ٹیسٹ کریں، نہ کہ عمل درآمد کا۔ ٹیسٹ Gherkin منظرناموں سے قابلِ مشاہدہ نتائج کا دعویٰ کرتے ہیں؛ وہ پرائیویٹ طریقہ کے دستخط یا DB کالم کے ناموں کا دعویٰ نہیں کرتے۔ یہ ماڈیولر مونولیتھ کو ریفیکٹر کے قابل رکھتا ہے (NFR-MAINT-001)۔
3. Gherkin معاہدہ ہے۔ PRD میں ایک Scenario: واحد حقیقت کا منبع ہے: یہ اسٹیک ہولڈرز کے لیے ارادے کو دستاویز کرتا ہے اور Cucumber/Playwright کے اسٹیپ بائنڈنگز کے ذریعے آٹومیشن چلاتا ہے (§8 دیکھیں)۔ کوئی متوازی، مختلف "ٹیسٹ اسپیک" نہیں ہے۔
4. گہرائی میں دفاع۔ سیکیورٹی، پرائیویسی، رسائی، اور i18n سنگل گیٹ چیکس نہیں ہیں؛ ہر ایک کی تصدیقی ایک خودکار تہہ (CI) پلس ایک مینول/ماہرانہ تہہ (فی ریلیز آڈٹ) سے ہوتی ہے۔ §10–§12 دیکھیں۔
5. پہلے تعین۔ فلیکی ٹیسٹس کو P1 خرابیوں کے طور پر Treat کیا جاتا ہے؛ ایک ٹیسٹ جسے تعین بنایا نہیں جا سکتا اسے قرنطینہ کیا جاتا ہے اور ایک اسپرنٹ کے اندر دوبارہ لکھا جاتا ہے (QA پر لاگو NFR-RELY-004 طرزِ خیال)۔
6. پروڈکشن حقیقت پسندی۔ پرفارمنس، لوکلائزیشن، اور گریس فل ڈیگریڈیشن ٹیسٹس ایک اسٹیجنگ ماحول کے خلاف چلتے ہیں جو پروڈکشن ٹاپالوجی کی عکاسی کرتا ہے (NFR-PORT-001، NFR-SCAL-001) حقیقت پسندانہ کارڈینلٹی پر (§7)۔

3. ٹیسٹنگ پیرامڈ

SITP کلاسک ٹیسٹنگ پیرامڈ پر عمل کرتا ہے: ایک وسیع، تیز یونٹ بیس؛ ایک تنگ انٹیگریشن بینڈ؛ ایک چھوٹا، سست اینڈ ٹو اینڈ (e2e) چوٹی؛ اور ایک پتلی مینول / UAT تہہ جو ایکسپلوریٹری ٹیسٹنگ، رسائی آڈٹ، سیکیورٹی پین ٹیسٹ، اور اسٹیک ہولڈر قبولیت کے لیے مخصوص ہے۔ یہ شکل جان بوجھ کر رکھی گئی ہے — وسیع اکثریت دعووں کی سب سے سستی، تیز ترین تہہ پر رہتی ہے۔

تحریری وضاحت۔ پیرامڈ کو نیچے سے اوپر پڑھا جاتا ہے: سب سے وسیع تہہ (یونٹ) سب سے زیادہ دعوے رکھتی ہے اور ہر پل ریکوئسٹ پر ملی سیکنڈ میں چلتی ہے۔ ہر اگلی تہہ کم دعوے رکھتی ہے، چلانے کے لیے زیادہ لاگت آتی ہے، اور کم بار بار چلتی ہے۔ بیس اس بات کی تصدیق کرتی ہے کہ ہر ماڈیول کا خالص منطق — SLA کیلکولیٹرز، حل کا ثبوت گیٹ، اسکیلیشن لیڈر شیڈولر، PII حذف و ترمیم میپرز، RBAC ریذولوشن، لوکیل کیٹلاگ مکملیت — الگ تھلگ درست سلوک کرتا ہے۔ انٹیگریشن بینڈ اس بات کی تصدیق کرتا ہے کہ ماڈیولز اپنے شائع شدہ انٹرفیس کے ذریعے اور Testcontainers کے ذریعے حقیقی MariaDB/Redis/MinIO کے خلاف تعاون کرتے ہیں۔ e2e چوٹی ان چند سفرات کو چلاتی ہے جو صرف اس وقت معنی رکھتے ہیں جب پورا اسٹیک (پورٹل + API + ورکرز + AI سروس + ایڈاپٹرز) لائیو ہو — ٹکٹ داخل کریں، ID سے ٹریک کریں، ثبوت کے ساتھ حل کریں، اسکیلیٹ کریں، MoM شائع کریں، QR سائن شدہ خط کی تصدیق کریں۔ مینول تہہ ان چیزوں کے لیے مخصوص ہے جو خودکار نہیں کی جا سکتیں: ایکسپلوریٹری ٹیسٹنگ، WCAG اسکرین ریڈر آڈٹ، آزاد پین ٹیسٹ، اور پائلٹ محکموں کا UAT دستخط۔

3.1 لیئر بہ لیئر معاہدہ

4. ٹولز اور اسٹیک

ٹولز کو _context.md §3 میں مقفل ٹیکنالوجی اسٹیک اور /specs/ur/03-non-functional-reqs/ §3.9 میں قابلِ维护یت گیٹس سے ملانے کے لیے منتخب کیا گیا ہے۔ کوئی ایسا ٹول متعارف نہیں کرایا گیا جو ہر پل ریکوئسٹ پر CI میں نہ چل سکے۔

5. کوریج ہداف

کوریج ہداف NFR-MAINT-002 سے ہم آہنگ ہیں اور سب سے زیادہ خطرے والے فیصلہ گیٹس کے لیے سخت تر معیار شامل کرتے ہیں۔ کوریج ایک فرش ہے، چھت نہیں؛ یہ ضروری ہے لیکن کافی نہیں (اونچا اسکور لیکن اتھلے دعوے ایک جانا پہچانا اینٹی پیٹرن ہے، جس کا مقابلہ §4 میں میوٹیشن ٹیسٹنگ آپشن سے کیا جاتا ہے)۔

ایک PR جو مجموعی کوریج کو فرش سے نیچے لاتی ہے وہ بلڈ فیل کرتا ہے۔ کوریج گیٹ ڈیلٹا (تبدیل شدہ لائنوں) پر چلتا ہے پورے پراجیکٹ کے کل کے علاوہ، تاکہ لیجیسی کوڈ پر جرمانہ نہ ہو لیکن نیا کوڈ معیار کا پابند ہو۔

5.1 100 % فیصلہ گیٹس

یہ وہ تنگ، بلے-ریڈیس کوڈ پاتھ ہیں جہاں ایک چھوٹا سا مس برانچ تعمیل یا اعتماد کی ناکامی ہے۔ انہیں صریح طور پر نامزد ٹیسٹ کیسز کے ساتھ 100 % لائن اور برانچ کوریج تک پہنچنا چاہیے، ماڈیول پر مبنی فرش سے قطع نظر:

6. CI/CD گیٹس اور پائپ لائن

نیچے دیا گیا ہر گیٹ main اور پروڈکشن ڈپلائے کے راستے پر ایک ہارڈ بلاک ہے، جسے برانچ پروٹیکشن (NFR-MAINT-003) کے ذریعے نافذ کیا جاتا ہے۔ ایک ڈپلائے جو گیٹ کو چھوڑ دے وہ ایک واقعہ ہے۔

تحریری وضاحت۔ ایک پل ریکوئسٹ بائیں جانب پائپ لائن میں داخل ہوتی ہے اور مرج ہونے سے پہلے بائیں سے دائیں ہر گیٹ پاس کرنا چاہیے۔ لنٹ اور ٹائپ چیک سب سے سستے کیچز ہیں اور پہلے چلتے ہیں۔ کوریج گیٹ کے ساتھ یونٹ ٹیسٹس اس کے بعد آتے ہیں، پھر انٹیگریشن ٹیسٹس جو Testcontainers کے ذریعے حقیقی MariaDB/Redis/MinIO کو چلاتے ہیں۔ کنٹریکٹ ٹیسٹس (شائع شدہ اسپیک کے خلاف OpenAPI ڈف، webhooks کے لیے Pact) پارٹنرز تک پہنچنے سے پہلے بریکنگ تبدیلیوں کو پکڑتے ہیں۔ بلڈ کنٹینرز اور بنڈلز تیار کرتا ہے۔ SCA + secrets ڈپینڈنسیز اور سورس میں معلوم کمزوریوں اور لیکڈ کریڈینشلز کو اسکین کرتا ہے (NFR-SEC-006، NFR-SEC-011)۔ رسائی (axe-core، Pa11y، Lighthouse) اور i18n/RTL (لوکیل پیرٹی، بصری ڈف) اس کے بعد چلتے ہیں۔ ایک e2e smoke سوٹ اوپری اہم سفرات کو کور کرتا ہے۔ License + SBOM جنریشن فی PR بلاک کو بند کرتی ہے۔ انسانی ریویو اور مرج کے بعد، راتوں رات مکمل سوٹ سستے، گہرے چیکس چلاتا ہے — ZAP DAST، k6 لوڈ، تینوں لوکیلز میں مکمل e2e، اور (اختیاری طور پر) میوٹیشن ٹیسٹنگ۔ ایک ریلیز گیٹ ہیومن ان-دی-لوپ چیکس شامل کرتا ہے: آزاد پین ٹیسٹ، مینول رسائی آڈٹ، اور پائلٹ محکمہ UAT دستخط۔ تبھی ایک زیرو ڈاؤن ٹائم ڈپلائے آگے بڑھتا ہے (NFR-AVAIL-006)۔

6.1 گیٹ کیٹلاگ

7. ٹیسٹ ڈیٹا سٹریٹیجی

ٹیسٹ ڈیٹا بذریعہ ڈیفالٹ سنتیٹک ہے؛ حقیقی PII کبھی پروڈکشن سے نہیں نکلتی، اور چند کارپسز جو PII کی نقل کرتے ہیں وہ ماسکڈ اور رسائی کنٹرولڈ ہیں۔ ڈیٹا سٹریٹیجی NFR-PRIV-001 (کم سے کم) اور NFR-PRIV-003 (PII والٹنگ) کے تحت منظم ہے۔

7.1 ڈیٹا ذرائع

7.2 اینٹیٹی فکسچر کوریج

ہر اینٹیٹی ٹائپ کے لیے کم از کم ایک کینونیکل فکسچر اور ایک ایڈج کیس فکسچر ہے، تاکہ شرطی منطق (اینٹیٹی ٹائپ مخصوص رجسٹریشن، کیٹگری مخصوص ٹکٹ فیلڈز، role-ٹیمپلیٹ اوورائیڈز) کو چلایا جا سکے:

• کمپنی — فی اینٹیٹی ٹائپ ایک: SECP کمپنی، سول پروپرائٹر/شراکت، فری لینسر، غیر ملکی شاخ، ابتدائی اسٹارٹ اپ (عارضی) (US-ORG-001 بمطابق)۔
• نمائندہ — فی role ٹیمپلیٹ ایک: بنیادی، ایڈمن، فائلر، ویور، نوٹیفائی؛ اس کے علاوہ ایک گرینولر اوورائیڈ کیس (US-ORG-004 بمطابق)۔
• محکمہ — ایک نسٹڈ فکسچر: محکمہ → سیکشن → عملہ، جس میں DG + سیکریٹری نگرانی تفویض شدہ ہے (US-ORG-005 بمطابق)۔
• ٹکٹ — ہیپی پاتھ، شرطی فارم (فی کیٹگری)، مسودہ، ذیلی ٹاسک پیرنٹ/چائلڈ، مرجڈ پرائمری/سیکنڈری، کانفیڈنشل/VIP، RTI کیٹگری (قانونی ڈیڈ لائن)۔
• MoM — اسکینڈ امیج (OCR پر مجبور)، ٹیکسٹ-PDF، Word؛ ایکشن آئٹمز کے ساتھ اور بغیر؛ حساس/VIP ویرینٹ۔
• خط / سرٹیفکیٹ — تین زبانی، سائنڈ/غیر سائنڈ، QR تصدیق کے لیے ٹیمپرڈ ہیش ویرینٹ۔
• اطلاع — فی چینل (ای میل، SMS، واٹس ایپ، ان ایپ) اور فی ایونٹ (بنایا، تفویض، اسکیلیٹ، حل، بند، MoM شائع)۔

7.3 ملٹی لنگول کارپس (3 لوکیلز)

ہر ٹیکسٹ بیئرنگ فکسچر EN، UR، اور SD میں موجود ہے تاکہ OCR، سرچ، AI ترجمہ، اطلاع رینڈرنگ، اور RTL لے آؤٹ تمام حقیقی اسکرپٹ مواد کے خلاف چلائے جائیں:

• لاطینی (EN) — بیس لائن۔
• اردو (UR) — نسطلیق، RTL۔
• سندھی (SD) — نسخ عربی اسکرپٹ، RTL۔
• ایک مکسڈ اسکرپٹ فکسچر (EN باڈی + UR اٹیچمنٹ) ترجمہ اور PII حذف و ترمیم ایڈج کیسز کے لیے۔

7.4 ڈیٹا حفاظت کے اصول

• کوئی حقیقی CNIC، حقیقی فون نمبر، یا حقیقی ای میل کسی بھی فکسچر یا کمٹڈ سیڈ میں نہیں آتا۔ Faker لوکیل قابلِ یقین شکلوں کے لیے en_PK پر سیٹ ہے۔
• ماسکڈ PII کارپس رسائی کنٹرولڈ اسٹور میں رہتا ہے؛ CI صرف حذف و ترمیم/پین ٹیسٹ جابس کے لیے شارٹ لائیوڈ ٹوکن کے ذریعے اسے کھینچتا ہے۔
• ٹیسٹ ڈیٹا بیس عارضی ہیں (Testcontainers) اور فی اسپیک رن پر توڑ دیے جاتے ہیں؛ کوئی کراس اسپیک لیکج نہیں۔
• پرفارمنس ٹیسٹس کے لیے پروڈکشن جیسا کارڈینلٹی ایک سیڈر کے ذریعے جنریٹ کیا جاتا ہے جو NFR-SCAL-004/005 کی تعمیل کرتا ہے (100k ٹکٹس، 100k نمائندگان، 10k عملہ تک)۔

8. Gherkin منظرنامے بطور خودکار اسپیکس دوبارہ استعمال

/specs/ur/01-prd/ میں ایک Scenario: بلاک کوئی دستاویز نہیں ہے جسے پھر الگ ٹیسٹ اسکرپٹ میں ترجمہ کیا جائے۔ یہ قابلِ عمل اسپیسفیکیشن ہے۔ Gherkin متن دو طریقوں سے آٹومیشن سے باندھا جاتا ہے:

1. Cucumber (PyTest کے لیے Behave / TS کے لیے @cucumber/cucumber) — لفظی Gherkin Given/When/Then اسٹیپس اسٹیپ ڈیفینیشن فنکشنز سے باندھے جاتے ہیں۔ منظرنامے کا متن اور ٹیسٹ ایک ہی آرٹیفیکٹ ہیں؛ منظرنامہ تبدیل کرنے سے ٹیسٹ تبدیل ہوتا ہے۔
2. Playwright + data-testid بائنڈنگ — e2e کے لیے، ایک ہی Gherkin منظرنامے کو مستقل data-testid سلیکٹرز کے ساتھ اینوٹیٹ کیا جاتا ہے تاکہ دعوا UI ریفیکٹرز میں پورٹیبل رہے۔

ورکڈ مثال — حل کا ثبوت گیٹ منظرنامہ (US-TKT-006) TC-TKT-006-01 بن جاتا ہے:

# Reused verbatim from /specs/ur/01-prd/ (US-TKT-006, Scenario: Resolution requires evidence and a note)
Scenario: Resolution requires evidence and a note
  Given a staff member attempts to move a ticket to "Resolved"
  When no evidence attachment and resolution note are present
  Then the transition is blocked
  And the system states which required items are missing

باندھی ہوئی آٹومیشن (وضاحتی):

// tests/integration/ticket/proof-gate.steps.ts
Given('a staff member attempts to move a ticket to {string}', async (status) => {
  this.ticket = await ticketFactory.create({ status: 'InProgress' });
  this.attempt = () => ticketsApi.transition(this.ticket.id, status);
});

When('no evidence attachment and resolution note are present', async () => {
  // factory created the ticket without attachments and without a note — nothing to do
});

Then('the transition is blocked', async () => {
  await expect(this.attempt()).rejects.toMatchObject({ status: 409, code: 'PROOF_GATE_MISSING' });
});

Then('the system states which required items are missing', async () => {
  const err = await this.attempt().catch(e => e);
  expect(err.details.missing).toEqual(expect.arrayContaining(['evidence_attachment', 'resolution_note']));
});

آرٹنگ رول: اگر ایک ٹیسٹ کیس Gherkin منظرنامے تک ٹریس نہیں ہو سکتا، تو یا تو منظرنامہ غائب ہے (اسے PRD میں شامل کریں) یا ٹیسٹ کیس عمل درآمد کی تفصیل کا ٹیسٹ کر رہا ہے (اسے ریفیکٹر یا حذف کریں)۔ یہ رول اسپیک اور سوٹ کو الگ ہونے سے روکتا ہے۔

9. نمونہ ٹیسٹ کیسز (TC-<EPIC>-<nnn>-<nn>)

نیچے دی گئی ٹیبل نمائندہ ٹیسٹ کیسز کی فہرست دیتی ہے جو _context.md §5 میں مقفل رویے کے فیصلوں اور PRD میں [M]/[S] یوزر اسٹوریز کو چلاتے ہیں۔ یہ مکمل سوٹ نہیں ہے — مکمل کیٹلاگ (E1–E17 میں ہر قبولیت کے معیار کے لیے ایک یا زیادہ TCs) QA ٹیسٹ مینجمنٹ ٹول میں رہتا ہے۔ یہاں ہر TC اپنی اصل یوزر اسٹوری، وہ فنکشنل ریquirement(s) جو یہ پورا کرتا ہے، بنیادی ٹیسٹ لیئر، اور وہ ترجیح جو ریگریشن میں شمولیت کا تعین کرتی ہے، سے میپ ہوتا ہے (§14 دیکھیں)۔

ترجیح کلید۔ P0 — لانچ بلاکنگ؛ ہر CI پائپ لائن اور ریگریشن میں چلتا ہے۔ P1 — V1 میں ضروری رویہ لیکن کم بلے ریڈیس؛ CI اور ریلیز پہلے ریگریشن میں چلتا ہے۔

سوٹ مکمل ہونے کا نوٹ۔ اوپر 23 کیسز نمائندہ ریڑھ کی ہڈی ہیں۔ مکمل ٹیسٹ مینجمنٹ کیٹلاگ E1–E17 میں ہر قبولیت کے معیار کے لیے کم از کم ایک TC-<EPIC>-<nnn>-<nn> اخذ کرتا ہے (PRD کے فی ایپک AC شمار کے مطابق)، جس سے V1 لانچ پر تخمیناً 200+ خودکار کیسز ملتے ہیں، فی فیز بڑھتے ہوئے۔ [M] ACs کی کوریج لانچ ریڈینس ایگزٹ معیار ہے (§1.2)۔

10. لوکلائزیشن اور RTL ٹیسٹنگ

لوکلائزیشن ایک فرسٹ کلاس ٹیسٹ تشویش ہے، فائنل پاس چیک نہیں، کیونکہ SITP تین قانونی صوبائی زبانیں سنبھالتا ہے جن میں سے دو دائیں سے بائیں ہیں۔ یہ سیکشن NFR-I18N-001…006 کو عملی شکل دیتا ہے۔

10.1 خودکار (ہر PR)

10.2 بصری (فی ریلیز)

• Playwright اسکرین شاٹ ڈف اوپر 20 صفحات کے لیے، تینوں لوکیلز میں اور دونوں سمتوں میں (EN کے لیے LTR، UR/SD کے لیے RTL) کیپچر کیا گیا۔ ٹالرینس سے آگے پکسل ڈرفت ریویور منظوری چاہیے۔
• RTL کے لیے میر چیکس: نیویگیشن، آئیکنوگرافی، بریڈ کررم ترتیب، ٹیبل کالم ترتیب، ماڈل کلوز بٹن پلیسمنٹ، اور چارٹ ایکسس سمت سب درست میر کرتے ہیں۔ منطقی CSS پراپرٹیز (padding-inline-start، وغیرہ) خصوصاً استعمال ہوتی ہیں — ان لائن سمت ہیکس کو لنٹ آؤٹ کیا جاتا ہے (NFR-I18N-002)۔
• فانٹ رینڈرنگ برانڈ ٹائپ سائز پر Noto Nastaliq Urdu اور Noto Naskh Arabic کے لیے تصدیق شدہ۔

10.3 مینول (فی ریلیز)

• تبدیل شدہ اسکرینز کے لیے ایک منظور شدہ اردو ریویور اور ایک منظور شدہ سندھی ریویور کے ذریعے لسانی ریویو، گلاسری کے خلاف لاگڈ۔
• ملٹی لنگول کارپس کے خلاف UR اور SD میں سرچ کوالٹی اسپاٹ چیک (Meilisearch اسکرپٹ ہینڈلنگ)۔

11. رسائی ٹیسٹنگ

رسائی ایک حکومتی سروس کے لیے قانونی سے متعلق ہے اور تینوں زبانوں میں WCAG 2.1 لیول AA پر مقفل ہے (_context.md §2)۔ یہ سیکشن NFR-A11Y-001…004 کو عملی شکل دیتا ہے۔

11.1 خودکار (ہر PR)

• axe-core (@axe-core/playwright کے ذریعے) اوپر 20 صفحات پر — زیرو کریٹیکل خلاف ورزیاں ہارڈ گیٹ ہیں۔
• Pa11y اضافی طور پر Docusaurus ڈاکس سائٹ کو اسکین کرتا ہے۔
• Lighthouse CI رسائی کیٹگری ≥ 90 اوپر 10 صفحات پر؛ رجحان فی بلڈ ٹریک کیا جاتا ہے۔
• برانڈ ٹوکن پلیٹ (اجرک انڈگو/مرون) پر تمام ٹیکسٹ سائز پر کلر کنٹراسٹ یونٹ ٹیسٹ — 4.5:1 نارمل، 3:1 بڑا (NFR-A11Y-004)۔

11.2 مینول (فی ریلیز)

• ہر اہم سفر کی کی بورڈ صرف واک تھرو: مرئی فوکس انڈیکیٹر، منطقی ٹیب ترتیب، کوئی کی بورڈ ٹریپ نہیں، skip-to-content لنک موجود (NFR-A11Y-003)۔
• اہم سفرات پر NVDA + Firefox، JAWS + Edge، VoiceOver + Safari/iOS، TalkBack + Android کے ساتھ اسکرین ریڈر پاس؛ متحرک ریجنز (ٹکٹ تھریڈز، ڈیش بورڈز، چیٹ) پر ARIA سیمینٹکس تصدیق شدہ (NFR-A11Y-002)۔
• خرابیاں شدت کے مطابق ٹرایج کی گئیں؛ WCAG ناکامیاں ریلیز بلاک کرتی ہیں۔

11.3 فیز-2 (ملتوی، ٹریکڈ)

پاکستان سائن لینگویج سائن ویڈیو گائیڈز (NFR-A11Y-005) اور ڈسلیکسیا دوست + وائس نیویگیشن موڈ (NFR-A11Y-006) فیز-2 کے ہیں اور ان کا اپنا ریلیز گیٹ ہے؛ یہ V1 بلاکرز نہیں ہیں۔

12. سیکیورٹی ٹیسٹنگ

سیکیورٹی ٹیسٹنگ NFR-SEC-001…013 اور /specs/ur/11-security-compliance/ میں کنٹرول کیٹلاگ کی تصدیق کرتی ہے۔ یہ مسلسل آٹومیشن کو آزاد ماہرانہ ریویو کے ساتھ جوڑتی ہے۔

12.1 مسلسل (CI/راتوں رات)

12.2 اجازت میٹرکس ٹیسٹس (خودکار)

ایک پیرامیٹرائزڈ ٹیسٹ میٹرکس ہر role × ہر حساس ایکشن کو چلاتا ہے، یہ دعویٰ کرتے ہوئے کہ allow/deny /specs/ur/04-roles-permissions/ میں اجازت میٹرکس سے میل کھاتا ہے۔ roles: کمپنی بنیادی/ایڈمن/فائلر/ویور/نوٹیفائی؛ حکومتی سیکشن عملہ/افسر/محکمہ ایڈمن/DG/سیکریٹری/سپر ایڈمن؛ پبلک وزٹر۔ ایکشنز: ٹکٹ پڑھیں، تبصرہ لکھیں، حیثیت تبدیل کریں، VIP بند کریں، PII ایکسپورٹ کریں، بنیادی نمائندہ تبدیل کریں، فیچر فلیگ ٹوگل کریں، آڈٹ لاگ پڑھیں، وغیرہ۔ کوئی بے میل بلڈ بلاک کرتا ہے۔

12.3 ABAC کانفیڈنشل/VIP ٹیسٹس (خودکار، 100 % گیٹ)

کانفیڈنشل/VIP رسائی چیک (§5.1) ایک مخصوص کیس میٹرکس کے ساتھ چلایا جاتا ہے: میچنگ ایٹریبیوٹ کے ساتھ اور بغیر ہر عملے کا role، لسٹ ویو، سرچ نتائج، براہ راست URL رسائی، اور API کال میں۔ متوقع نتیجہ غیر میچنگ کیس کے لیے deny + log ہے؛ مرئیت صفر ہونی چاہیے (شمار، سرچ تجاویز، یا مسترد فریق کے آڈٹ ریڈز کے ذریعے کوئی لیکج نہیں)۔

12.4 آزاد پین ٹیسٹ (فی ریلیز گیٹ)

عوامی go-live سے پہلے، اس کے بعد سالانہ، اور کسی بھی سیکیورٹی حساس تبدیلی کے بعد آزاد بیرونی نفوذ جانچ (NFR-SEC-007) ضروری ہے۔ دائرہ کار:

• پورٹل، API، WebSocket گیٹ وے، AI سروس، اور ڈاکس سائٹ۔
• تصدیق، سیشن، اور step-up فلوز (Keycloak)۔
• فائل اپ لوڈ/ڈاؤن لوڈ (ClamAV بائ پاس کوششیں، پاتھ ٹریورسل)۔
• PII حذف و ترمیم باؤنڈری (Restricted کلاس پر کلاؤڈ AI کال کی کوشش)۔
• Webhook سائننگ اور ریپلے۔
• کمپنیوں اور محکموں میں IDOR / ہوریزنٹل پرائیویلیج ایسکلیشن۔
• login/OTP/ٹریکنگ-ID lookup پر ریٹ لمٹنگ اور brute-force مزاحمت۔

کریٹیکل فائنڈنگز 30 دن میں، ہائی 60 دن میں دور کی جاتی ہیں؛ بندش کا ثبوت فیز گیٹ پر ریویو کیا جاتا ہے۔ پین ٹیسٹ رپورٹ ASVS L2 تعمیل کے لیے بنیادی ثبوت ہے (NFR-SEC-001)۔

13. پرفارمنس اور لوڈ ٹیسٹنگ

پرفارمنس ہداف NFR-PERF-001…011 میں مقدار میں بیان کیے گئے ہیں؛ یہ سیکشن بتاتا ہے کہ ان کی تصدیق کیسے کی جاتی ہے۔ تمام پرفارمنس ٹیسٹس اسٹیجنگ ماحول کے خلاف چلتے ہیں جو پروڈکشن ٹاپالوجی (NFR-PORT-001) کی عکاسی کرتا ہے حقیقت پسندانہ کارڈینلٹی پر (§7.4)۔

13.1 ہدف خلاصہ (دستاویز 03 سے)

13.2 k6 منظرنامے

• سموک — فی ریلیز؛ 50 ورچول یوزرز، 5 min؛ اوپر read/write پاتھس؛ sanity۔
• لوڈ — فی ریلیز؛ V1 concurrency ہدف (PERF-008) تک rimپ اور 30 min ہولڈ؛ p95 لیٹینسی ہداف اور ≤ 1 % 5xx کا دعویٰ۔
• سوک — فی ریلیز + ڈیمانڈ پر؛ 60 min کے لیے ہدف کا 110 %؛ میموری لیکس، کنکشن پول تھکاوٹ، قطار بیک لاگ نمو کا پتہ لگائیں (PERF-008 پیمائش کا طریقہ)۔
• اسپائک — ڈیمانڈ پر؛ < 30 s میں ہدف کا 2×؛ سرکٹ بریکرز اور گریس فل ڈیگریڈیشن ہولڈ کی تصدیق (NFR-AVAIL-003)۔
• ملٹی لنگول سرچ — سہ ماہی؛ Meilisearch (PERF-010) کے خلاف 100-query EN/UR/SD سوٹ۔

13.3 AI/OCR ٹائم آؤٹ اور گریس فل ڈیگریڈیشن

• AI خلاصہ اور OCR جابس کا دعویٰ ہے کہ وہ اپنے p95 سیلنگز (PERF-004/005) کی تعمیل کرتے ہیں اور صاف طور پر ٹائم آؤٹ ہوتے ہیں — ایک رکا ہوا انجن ریکوئسٹ پاتھ کو بلاک نہیں کرنا چاہیے (قطار لیولڈ آرکیٹیکچر، NFR-SCAL-002)۔
• فالٹ انجیکشن سوٹ (فی ریلیز): ہر بیرونی ڈپینڈنسی (AI پرووائیڈر، OCR انجن، NADRA/SECP/FBR/SRB/PSEB/e-Office، Mailjet/SMS/واٹس ایپ) کو باری باری kill کیا جاتا ہے؛ اہم یوزر سفرات (داخل، ٹریک، تبصرہ، حل، بند) کو اب بھی پاس ہونا چاہیے، جس میں ڈپینڈنٹ صلاحیت واضح طور پر "عارضی طور پر دستیاب نہیں" نشان زد ہو (NFR-AVAIL-003، NFR-RELY-001)۔

14. ریگریشن سٹریٹیجی

ریگریشن ان رویوں کی حفاظت کرتا ہے جو پہلے سے کام کرتے ہیں جبکہ نیا کوڈ شپ ہوتا ہے۔ SITP ریگریشن رسک ویٹڈ ہے، "ہمیشہ سب کچھ چلائیں" نہیں۔

ٹیگنگ۔ ہر ٹیسٹ کے ساتھ ٹیگ کیا جاتا ہے: ماڈیول کوڈ (جیسے، TKT، ORG)، ترجیح (P0/P1/P2)، لوکیل (EN/UR/SD)، سمت (LTR/RTL)، اور اصل US-/FR- IDs۔ یہ ہاٹ فکس برانچز پر تیز، ہدف ریگریشن کو قابل بناتا ہے۔

بائسیکشن۔ ایک ریگریشن جو main میں آتی ہے بائسیکٹیبل ہے کیونکہ راتوں رات سوٹ فی کمٹ گرین/ریڈ سگنل دیتی ہے؛ P0 ریگریشنز کے لیے خطا کار کمٹ اسی کاروباری دن میں ریورٹ کر دیا جاتا ہے۔

15. UAT پلان

یوزر ایکسیپٹنس ٹیسٹنگ وہ جگہ ہے جہاں پائلٹ محکمے اور IT کمپنیوں کا ایک گروہ اس بات کی تصدیق کرتا ہے کہ سسٹم حقیقی کام کے لیے کام کرتا ہے، صرف ٹیسٹ سوٹ کے لیے نہیں۔ UAT ہر فیز کے لائیو ہونے سے پہلے ہیومن گیٹ ہے (/specs/ur/14-roadmap-release/ بمطابق)۔

15.1 پائلٹ اسٹرکچر

15.2 UAT اینٹری معیارات

• ریلیز پہلے ریگریشن (§14) سبز۔
• پائلٹ ڈیٹا سیڈڈ؛ پائلٹ یوزرز تربیت یافتہ (ایپک E15 تربیت بمطابق)۔
• §16 کے مطابق یا اس کے نیچے کی جانچ پہچان خرابیاں (کوئی کھلا P0 نہیں؛ ≤ 5 کھلے P1)۔
• UAT اسکرپٹس (فی پائلٹ) پائلٹ لیڈ کے ذریعے ریویو شدہ۔

15.3 UAT ایگزٹ معیارات (دستخط)

• دائرہ کار میں 100 % [M] قبولیت کے معیارات پائلٹ کو پاس دکھائے گئے۔
• فی پائلٹ گروہ، فی زبان سسٹم استعمالیٹی سکیل (SUS) ≥ 70 (NFR-USA-006)۔
• پائلٹ ٹکٹس پر CSAT اکٹھا اور ریویو کیا گیا۔
• کوئی کھلا P0 خرابی نہیں؛ کھلی P1 خرابیوں کا ایک قبول شدہ اصلاحی پلان تاریخ کے ساتھ ہے۔
• پائلٹ محکمہ سیکریٹری اور S&ITD کی طرف سے دستخط شدہ UAT رپورٹ۔

15.4 فیڈبیک لوپ

پائلٹ فائنڈنگز uat- لیبل کے ساتھ خرابی ٹریکر (§16) میں بہتی ہیں؛ پیٹرنز (جیسے، کسی فلوف میں بار بار الجھن) /specs/ur/10-ux-sitemap-flows/ اور KB/SOPs (ایپک E10) میں واپس بہتے ہیں۔

16. خرابی کا انتظام

ورک فلوف۔ ہر خرابی کے ساتھ لاگ کیا جاتا ہے: دہرا قابل اقدامات، متوقع بمقابلہ حقیقی، ماحول، لوکیل، ناکام TC- (یا "no TC" → نیا TC متحرک کرتا ہے)، شدت، اور اسٹیجنگ/پروڈکشن لاگ سے trace_id۔ خرابیوں کی ٹرایج UAT کے دوران روزانہ اور دیگر صورت میں ہفتہ وار کی جاتی ہے۔ ایک خرابی جس کے لیے کوڈ تبدیلی ضروری تھی اسے ایک ٹیسٹ کیس ضرور شامل یا اپ ڈیٹ کرنا چاہیے جو اسے پکڑ لیتا — لوپ بند کرنا اور ریگریشن سوٹ بڑھانا (NFR-RELY-004 طرزِ خیال)۔

فلیکینیس پالیسی۔ ایک فلیکی ٹیسٹ ایک خرابی ہے۔ اسے ایک واقعہ کے اندر قرنطینہ کیا جاتا ہے اور یا تو ٹھیک (تعین) یا ایک اسپرنٹ کے اندر دوبارہ لکھا جاتا ہے؛ یہ ایک معلوم غیر مستحکم گیٹ کے طور پر نہیں رہتا۔

17. ٹریس ایبلٹی

ٹریس ایبلٹی دو طرفہ ہے اور یہ آڈٹ ثبوت ہے کہ ہر شیپ شدہ صلاحیت تصدیق شدہ ہے اور ہر ٹیسٹ کسی دستاویز کردہ وجہ سے موجود ہے۔ زنجیر یہ ہے:

FR (FR-<MOD>-<nnn>) → US (US-<EPIC>-<nnn>) → AC (Gherkin Scenario) → TC (TC-<EPIC>-<nnn>-<nn>) → ٹیسٹ لیئر + NFR ہدف۔

17.1 نمائندہ ٹریس ایبلٹی اقتباس

17.2 قبولیت معیارات کی کوریج

لانچ ریڈینس کے لیے ضروری ہے کہ /specs/ur/01-prd/ میں ہر [M] قبولیت کے معیار کے لیے کم از کم ایک کامیاب خودکار ٹیسٹ کیس ہو (§1.2)۔ QA ٹیسٹ مینجمنٹ ٹول فی ریلیز ٹریس ایبلٹی میٹرکس رپورٹ تیار کرتا ہے جو دکھاتی ہے کہ، ہر ایپک کے لیے، کل ACs کے مقابلے میں passing-TCs کے ساتھ ACs کا تناسب؛ [M] ACs کے لیے 100 % سے کم ویلیو ریلیز گیٹ بلاک کرتی ہے۔

17.3 کراس دستاویز حوالہ جات

• فنکشنل ریquirements: /specs/ur/02-functional-reqs/۔
• پرفارمنس/سیکیورٹی/a11y سوٹس کے ذریعے تصدیق شدہ non-functional ہداف: /specs/ur/03-non-functional-reqs/۔
• ٹیسٹ کے تحت ٹکٹ ورک فلوف اور اسٹیٹ ٹرانزیشنز: /specs/ur/06-ticket-workflow/۔
• §12 کے ذریعے تصدیق شدہ سیکیورٹی کنٹرول کیٹلاگ: /specs/ur/11-security-compliance/۔
• انٹیگریشن ٹیسٹس کے لیے ایڈاپٹر موک: /specs/ur/08-integrations-spec/۔
• کنٹریکٹ ٹیسٹس کے لیے API/Webhook کنٹریکٹس: /specs/ur/12-api-contract/۔

18. RACI خلاصہ

19. فیز ہم آہنگی

یہ سٹریٹیجی /specs/ur/14-roadmap-release/ میں روڈ میپ کے مطابق بڑھتے ہوئے لاگو کی جاتی ہے:

20. کھلے اشیاء [TBD/confirm]

ان اشیاء کو /specs/ur/14-roadmap-release/ میں بندش تک ٹریک کیا جاتا ہے اور جیسے جیسے فیصلے ہوتے ہیں اس دستاویز میں واپس ظاہر کیا جاتا ہے۔

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