ٽيسٽ اسٽريٽيگي

سنڌ آءِ ٽي پورٽل — سهولت ڊيسڪ (SITP) لاءِ ماسٽر ٽيسٽ ۽ تصديق جي اسٽريٽيگي: ٽيسٽنگ پِهرامڊ، اوزار، ڪوريج مَنزلَن، CI/CD گیٽس، ٽيسٽ ڊيٽا اسٽريٽيگي، نمائنده ٽيسٽ ڪيسز (TC-<EPIC>-<nnn>-<nn>)، Gherkin-as-spec، لوڪلائيزيشن/RTL، رسائي، سيڪيورٽي، پرفارمنس/لوڊ، UAT، ريگريشن، خاميءَ جو انتظام، ۽ فنڪشنل ضرورت ← يوزر اسٽوري ← قبوليت جي معيار ← ٽيسٽ ڪيس تائين ٻه طرفو ٽريسيبلٽي.

1. مقصد ۽ هن دستاويز کي پڙهڻ جو طريقو

هي دستاويز SITP لاءِ مستند تصديقي معاهده آهي. اها انجنيئرنگ، QA، MAAHIR آپريشنز، ۽ S&ITD قبوليت جي اسٽيڪ هولڊرز کي ٻڌائي ٿي ته ڇا ٽيسٽ ڪيو وڃي ٿو، ڪهڙي تہه ۾، ڪهڙي اوزار سان، ڪهڙي مَنزل تائين، ۽ هر ٽيسٽ ڪيس ڪيئن هڪ يوزر اسٽوري، ان جي قبوليت جي معيارن، ۽ پيدا ٿيندڙ فنڪشنل ضرورت سان ڳنڍيل آهي. هي RFP ۽ ٽينڊر لاءِ تيار لکيو ويو آهي، ۽ PPP جي جوابداهي جي معيار کي پورو ڪرڻ لاءِ ته هر شيپ ٿيل صلاحيت واضح طور تصديق ٿيل آهي.

1.1 هڪ ئي تصديق لاءِ پڙهڻ جي ترتيب

فنڪشنل ضرورت (FR-...) → يوزر اسٽوري (US-...) → قبوليت جو معيار (Gherkin Scenario) → ٽيسٽ ڪيس (TC-<EPIC>-<nnn>-<nn>) → ٽيسٽ ليئر (يونٽ / انٽيگريشن / e2e / مينول) → CI گیٽ / NFR مَنزل.

هن دستاويز ۾ درج هر TC /specs/sd/01-prd/ ۾ هڪ يا وڌيڪ Gherkin منظرنامن کي عملي ۽ ورٿ可再生 بنائڻ لاءِ موجود آهي. IDs مستحڪم، ٻولي-غيرجانبدار آهن، ۽ ڪڏهن به ترجمو ناهين ڪيا ويا.

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 خاميون طور سڀاڻيو وڃي ٿو؛ هڪ ٽيسٽ جيڪو تعين وارو ناهي بنائي سگهجي ان کي قرنطينو ڪيو وڃي ٿو ۽ هڪ اسپرنٽ اندر ٻيهر لکيو وڃي ٿو (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/sd/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 اينٽيٽي فڪسچر ڪوريج

هر اينٽيٽي ٽائپ لاءِ گهٽ ۾ گهٽ هڪ ڪينونيڪل فڪسچر ۽ هڪ ايڊج ڪيس فڪسچر آهي، تنهنڪrameته شرطي منطق (اینٽيٽي ٽائپ مخصوص رجسٽريشن، ڪيٽگري مخصوص ٽڪيٽ فيلڊز، 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 ۾ موجود آهي تنهنڪrameته 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/sd/01-prd/ ۾ هڪ Scenario: بلاڪ اهڙي دستاويز ناهي جاڪا پوءِ الڳ ٽيسٽ اسڪرپٽ ۾ ترجمو ٿئي. اها قابلِ عمل اسپيسيفيڪيشن آهي. Gherkin متن ٻن طريقن سان آٽوميشن سان ٻڌل آهي:

1. Cucumber (PyTest لاءِ Behave / TS لاءِ @cucumber/cucumber) — لفظي Gherkin Given/When/Then اسٽيپس اسٽيپ ڊيفينيشن فنڪشنز سان ٻڌل آهن. منظرنامو جو متن ۽ ٽيسٽ هڪ ئي آرٽيفڪٽ آهن؛ منظرنامو تبديل ڪرڻ سان ٽيسٽ تبديل ٿي وڃي ٿو.
2. Playwright + data-testid بائنڊنگ — e2e لاءِ، ساڳيو Gherkin منظرنامو مستحڪم data-testid سليڪٽرز سان اينوٽيٽ ٿيل آهي تنهنڪrameته دعوا UI ريفيڪٽرز ۾ پورٽيبل رهي.

ورڪڊ مثال — حل جي ثبوت گیٽ منظرنامو (US-TKT-006) TC-TKT-006-01 بڻجي ٿو:

# Reused verbatim from /specs/sd/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 پنهنجي اصلي يوزر اسٽوري، اهي فنڪشنل ضرورت(ون) جيڪي اها پوري ڪن ٿيون، بنيادي ٽيسٽ ليئر، ۽ اها ترجيح جاڪا ريگريشن ۾ شموليت جو تعين ڪندي آهي، سان ميپ ٿئي ٿو (§14 ڏسو).

ترجيح ڪلي. P0 — لانچ بلاڪنگ؛ هر CI پائيپ لائن ۽ ريگريشن ۾ هلندو آهي. P1 — V1 ۾ ضروري رويو پر گهٽ بلے ريڊيس؛ CI ۽ ريليز اڳ ريگريشن ۾ هلندو آهي.

سوٽ مڪمل ٿيڻ جو نوٽ. مٿيان 23 ڪيس نمائنده ريڙه جي هڏي آهن. مڪمل ٽيسٽ مئنيجمينٽ ڪيٽلاگ E1–E17 ۾ هر قبوليت جي معيار لاءِ گهٽ ۾ گهٽ هڪ TC-<EPIC>-<nnn>-<nn> اخذ ڪري ٿو (PRD جي في اپڪ AC شمار مطابق)، جنهنڪrameته 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/sd/11-security-compliance/ ۾ ڪنٽرول ڪيٽلاگ جي تصديق ڪري ٿي. اها مسلسل آٽوميشن کي آزاد ماھرانہ ريويو سان ڳنڍي ٿي.

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

12.2 اجازت ميٽرڪس ٽيسٽس (خودڪار)

هڪ پيراميٽرائزڊ ٽيسٽ ميٽرڪس هر role × هر حساس ايڪشن کي هلائي ٿو، اها دعويٰ ڪندي ته allow/deny /specs/sd/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/sd/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/sd/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/sd/01-prd/ ۾ هر [M] قبوليت جي معيار لاءِ گهٽ ۾ گهٽ هڪ ڪامياب خودڪار ٽيسٽ ڪيس هجي (§1.2). QA ٽيسٽ مئنيجمينٽ ٽول في ريليز ٽريسيبلٽي ميٽرڪس رپورٽ تيار ڪري ٿو جاڪا ڏيکاري ٿي ته، هر اپڪ لاءِ، ڪل ACs جي مقابلي ۾ passing-TCs سان ACs جو تناسب؛ [M] ACs لاءِ 100 % کان گهٽ قدر ريلیز گیٽ بلاڪ ڪري ٿي.

17.3 ڪراس دستاويز حوالا

• فنڪشنل ضرورتون: /specs/sd/02-functional-reqs/.
• پرفارمنس/سيڪيورٽي/a11y سوٽس پاران تصديق ٿيل non-functional مَنزلَن: /specs/sd/03-non-functional-reqs/.
• ٽيسٽ هيٺ ٽڪيٽ ورڪ فلوف ۽ اسٽيٽ ٽرانزشنز: /specs/sd/06-ticket-workflow/.
• §12 پاران تصديق ٿيل سيڪيورٽي ڪنٽرول ڪيٽلاگ: /specs/sd/11-security-compliance/.
• انٽيگريشن ٽيسٽس لاءِ ايڊاپٽر موڪ: /specs/sd/08-integrations-spec/.
• ڪنٽريڪٽ ٽيسٽس لاءِ API/Webhook ڪنٽريڪٽس: /specs/sd/12-api-contract/.

18. RACI خلاصو

19. فيز هم آهنگي

هي اسٽريٽيگي /specs/sd/14-roadmap-release/ ۾ روڊ ميپ مطابق وڌندڙ لاڳو ٿيندي آهي:

20. کُليون شيون [TBD/confirm]

انهن شين کي /specs/sd/14-roadmap-release/ ۾ بندش تائين ٽريڪ ڪيو وڃي ٿو ۽ جيئن فيصلا ٿينديا آهن هن دستاويز ۾ واپس ظاهر ڪيا وڃن ٿا.

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