Sindh IT Portal — Facilitation DeskSpecification documents
Englishاردوسنڌي
← All documents

Roadmap & Release Plan

The phased delivery and release plan for the Sindh IT Portal — Facilitation Desk (SITP): how a Public-Private Partnership builds, launches, sustains, and ultimately hands over the platform, sequenced by MoSCoW priority even though the entire scope is V1.

Field Value
Doc ID 14
Status Draft
Owner S&ITD / MAAHIR
Languages EN (master) · UR · SD

1. Purpose & How to Read This Document

This document defines what gets built when, by whom, against which gate, and how the Government of Sindh retains continuity regardless of the operator. It is written to be RFP- and tender-ready and is the authoritative source for the S&ITD program office, the MAAHIR delivery team, Server4Sale (host), and the departmental and ecosystem stakeholders.

It aligns with three locked facts in _context.md:

  1. All features are V1 scope. The MoSCoW tag ([M] Must, [S] Should, [C] Could, [W] Won't) controls sequencing, not inclusion (see /specs/en/01-prd/ §1.2, §3).
  2. Delivery is phased into Phase 0 → Phase 4 (see _context.md §9).
  3. Delivery model is a Public-Private Partnership (PPP). Owner: S&ITD. Operator: MAAHIR. Host: Server4Sale. Canonical URL: https://sindhitportal.maahir.io. Footer: "Operated by MAAHIR · Powered by Server4Sale."

This roadmap cross-references: requirements /specs/en/02-functional-reqs/, NFRs /specs/en/03-non-functional-reqs/, ticket workflow /specs/en/06-ticket-workflow/, AI/OCR /specs/en/07-ai-ocr-spec/, integrations /specs/en/08-integrations-spec/, security /specs/en/11-security-compliance/, test strategy /specs/en/13-test-strategy/, architecture /specs/en/15-tech-architecture/, analytics/KPIs /specs/en/17-analytics-kpis/, governance/legal /specs/en/22-governance-legal/, PPP/exit /specs/en/23-ppp-vendor-exit/, and trust/safety /specs/en/24-trust-safety/.


2. Delivery Model — Public-Private Partnership (PPP)

2.1 Roles in the PPP

Party Role in delivery What they provide
S&ITD (Owner) Political & administrative authority; product owner; legal mandate holder. Legal notification binding departments to SLA response; per-department MoUs; data-sharing approvals for NADRA/SECP/FBR/SRB/PSEB; ADP budget line; acceptance authority.
MAAHIR (Operator) Design, build, operate, maintain under binding SLAs. Engineering team (Next.js/NestJS/Python); product/design; QA; ops/SRE; AI engineering; trilingual content; managed services across the contract term.
Server4Sale (Host) Infrastructure ("Powered by Server4Sale"). Verified environment: Ubuntu 24.04.4 LTS, Node 22, MariaDB 10.11, nginx, Docker, 3.4 TB disk, 243 GB RAM; networking, backups, DR facility.
Departments (40+) Resolvers & escalation tiers. Nominated officers, DGs, Secretaries; SOPs; KB content; participation in tripartite hearings.
Ecosystem (NADRA, SECP, FBR, SRB, PSEB, P@SHA, NITB) Verification & integration partners; adoption channels. API access; verification data; outreach and onboarding of IT companies.

2.2 PPP safeguards (binding)

The PPP contract MUST embed the safeguards detailed in /specs/en/23-ppp-vendor-exit/. The five non-negotiables, mapped to their milestone in §7, are:

  1. Service-Level Agreements (SLAs) — operational, availability, and resolution SLAs with penalties and remedies.
  2. Source-code escrow — deposit at every release, release to S&ITD on trigger events (M07).
  3. Intellectual Property (IP) ownership — IP vests in S&ITD (M08, rolling).
  4. Knowledge transfer (KT) — per phase and at contract milestones (M09).
  5. Exit / handover plan — a tested, executable transition so continuity is never operator-dependent (M10, M11).

2.3 Why PPP (and not in-house or pure-outsourced)

A PPP gives S&ITD speed and specialist capability (MAAHIR's product/AI engineering; Server4Sale's infra) while retaining public ownership, accountability, and continuity through the safeguards above. It also matches the SIFC-style "single window" ambition: a private-operator cadence inside a government mandate.


3. Phasing Principle

Although the entire scope is V1, delivery is sequenced by MoSCoW so that value lands early, risk retires progressively, and adoption builds before the platform is publicly generalized.

Key reconciliation (read this before the phase tables):

Where a Must capability spans phases (e.g., Must AI routing ships in Phase 1; the richer Should-tier AI lands in Phase 2/3), the MoSCoW→Phase table in §6 makes the split explicit. No requirement tagged [W] (Won't) is in any V1 phase; deferred items live in §11.


4. Phase Plan Overview (Gantt)

The five phases run sequentially with short stabilization overlaps. Durations are indicative planning bands for a single cross-functional MAAHIR team plus S&ITD product/QA; they assume the critical-path dependencies in §8 are met on time.

Written description. Phase 0 (Discovery) runs 2–3 weeks and produces the baselined specs, provisioned environment, and lodged applications. Phase 1 (MVP Core) runs 8–10 weeks and culminates in a controlled soft launch (MVP pilot). Phase 2 (AI + Sindhi + SLA) runs 6–8 weeks and ends at public GA (V1.0). Phase 3 (Appeal + Integrations + Security) runs 6–8 weeks and ends at V1.1. Phase 4 (Mobile + Advanced) runs 6–8 weeks and ends at V1.2. Sustainment runs continuously from GA onward under the ADP-funded managed-services arrangement (§10).

gantt title SITP V1 — Phased Delivery (indicative, weeks) dateFormat YYYY-MM-DD axisFormat W%V section Phase 0 — Discovery Specs, design, env, legal & API kick-off :p0, 2026-01-05, 3w section Phase 1 — MVP Core (Must) Register / File / Route / Resolve / Track :p1a, after p0, 6w Soft-launch pilot (limited cohort) :p1b, after p1a, 3w Milestone M03 — MVP pilot live :milestone, m1, after p1b, 0d section Phase 2 — AI + Sindhi + SLA Rich AI capabilities :p2a, after p1b, 3w Sindhi QA + full SLA engine :p2b, after p1b, 4w TRI + MoM + officials CMS + dashboards :p2c, after p1b, 4w Milestone M04 — V1.0 Public GA :milestone, m2, after p2a, 0d section Phase 3 — Appeal / Integrations / Security Advanced ticket ops + e-sign + letters :p3a, after m2, 4w Integrations (e-Office, API, webhooks) :p3b, after m2, 4w Exam-gate, multi-channel intake, pen-test :p3c, after m2, 4w Milestone M05 — V1.1 :milestone, m3, after p3a, 0d section Phase 4 — Mobile / Advanced Native mobile (React Native/Expo) :p4a, after m3, 5w Could-tier (channels, suggestion, BI) :p4b, after m3, 4w Milestone M06 — V1.2 :milestone, m4, after p4a, 0d

5. Phase Detail

Each phase below states scope (epics/modules/features with MoSCoW), entry criteria, exit criteria, key deliverables, dependencies, and risks.


5.1 Phase 0 — Discovery (2–3 weeks)

Goal. Convert the approved documentation set into a baselined, build-ready program; provision the environment; and lodge every external dependency that has long lead-times (legal mandate, department MoUs, API access, escrow).

Scope.

Area What happens in Phase 0 MoSCoW lens
Requirements Baseline the PRD, FR/NFR catalogues, RBAC matrix, data model, workflows, AI/OCR spec, integrations spec, API contract, test strategy. All [M] stories identified and sized.
UX & brand Sitemap, user flows, wireframes, Ajrak-inspired design system v0; trilingual content plan. Per /specs/en/10-ux-sitemap-flows/, /specs/en/16-branding-design-system/.
Architecture Architecture decisions finalized (NestJS modular monolith, MariaDB 10.11, Redis, Meilisearch, Keycloak, MinIO+ClamAV, pluggable AI). See /specs/en/15-tech-architecture/. Tech stack locked in _context.md §3.
Environment Server4Sale environment provisioned: dev, staging, prod-equivalent; CI/CD (GitHub Actions/GitLab CI); observability (Sentry, Grafana/Loki, OpenTelemetry).
Legal & governance Draft the S&ITD notification binding departments to SLA response; begin per-department MoUs; appoint source-code escrow agent; confirm IP-assignment clauses. See /specs/en/22-governance-legal/, /specs/en/23-ppp-vendor-exit/.
Integrations kickoff Lodge API access requests with NADRA (CNIC), SECP, FBR/NTN, SRB, PSEB; confirm NITB e-Office technical feasibility. See /specs/en/08-integrations-spec/.
People Recruit/confirm trilingual reviewers (native Urdu & Sindhi); confirm department nodal officers; confirm PSEB/P@SHA outreach partners. De-risks trilingual quality (R5) and adoption (R1).

Entry criteria. (1) PPP contract in force (M01); (2) Statement of Work signed; (3) S&ITD product owner and MAAHIR delivery lead named; (4) Server4Sale environment accessible.

Exit criteria (= Milestone M02). (1) Baseline specs approved by S&ITD; (2) environments (dev/staging) live; (3) escrow agent appointed and escrow agreement signed; (4) all API access requests lodged with receipts; (5) at least 3 founding department MoUs in draft; (6) risk register baselined; (7) change-management & adoption plan drafted (§9).

Key deliverables. Baselined PRD/FR/NFR/RBAC/data model/workflow/AI/integrations/API/test docs; design system v0; provisioned environments; CI/CD pipelines; initial risk register; adoption & training plan v0; escrow agreement; API-access request tracker.

Dependencies. PPP contract execution (M01); department willingness to nominate officers; ecosystem bodies' responsiveness; availability of native Sindhi reviewers.

Top risks. (R-legal) Slow legal notification; (R-api) API access delays from NADRA/SECP/FBR/SRB; (R-dept) Departments slow to engage; (R-brand) Brand approvals iterate. Mitigations in §12.


5.2 Phase 1 — MVP Core (8–10 weeks)[Must]

Goal. Deliver the end-to-end Must-tier journey as a controlled pilot / soft launch: an IT company registers (file-first, provisional), files a ticket with attachments, the ticket is AI-routed and tracked by ID, the concerned department resolves it with the proof-of-resolution gate, the company rates it (CSAT), and leadership sees core dashboards — in EN/UR/SD.

Scope (Must stories from the relevant epics).

Epic Module Phase 1 Must scope MoSCoW
E1 PUB Multilingual (EN/UR/SD) info site, FAQ/help center search, AI chatbot with human handoff, service catalog, public transparency dashboard (basic aggregate slice). [M]
E2 TKT File via dynamic conditional form; AI auto-route suggestion; track by ID without login; draft & save-later + smart filing assistant; proof-of-resolution gate (evidence + note → auto-close); reopen; basic appeal; CSAT. [M]
E3 ORG Register as one of 5 entity types; file-first, verify-in-parallel with Provisional badge; multiple reps with exactly one Primary; role templates + granular overrides; nested departments (Dept → Section → Staff) with DG/Secretary oversight; automated account lifecycle. [M]
E4 FILE Upload within size/type limits; ClamAV scan + encrypted object storage; signed, time-limited download links. [M]
E5 AI Multilingual OCR (EN/UR/SD); summary + classification + routing suggestion; pluggable-engine abstraction with per-feature flags. (Richer Should-tier AI deferred to Phase 2/3.) [M]
E6 COM Tier 1: ticket-scoped private threads; audit logging & retention of all messages. [M]
E7 NOT Multichannel delivery (email/SMS/WhatsApp/in-app); templated, multilingual (EN/UR/SD), Gregorian+Hijri dates. [M]
E8 INT Verification APIs: NADRA (CNIC), SECP, FBR/NTN, SRB, PSEB (file-first, verify-in-parallel). (NITB e-Office, public API, webhooks deferred to Phase 3.) [M]
E9 ANL Core dashboards: officer queue, company view, and basic public transparency; SLA-compliance metric. [M]
E12 DOC Trilingual official letter generation on letterhead (basic). (Full PKI e-sign + QR in Phase 3.) [M]
E16 OFC Basic officials records (Minister/Secretary/DG). (Full historical accuracy in Phase 2.) [M]
E17 FFG Feature-flag foundation; every Phase 1 capability toggleable by Super Admin. [M]

Entry criteria. Phase 0 exit (M02) met; environments ready; at least the first department MoU signed.

Exit criteria (= Milestone M03 — MVP pilot live). (1) All Phase 1 Must stories pass acceptance per /specs/en/13-test-strategy/; (2) end-to-end UAT green on the register→file→route→resolve→close→track journey; (3) security baseline (2FA, ClamAV, encryption, rate-limiting) verified; (4) trilingual (EN/UR/SD) rendering verified including RTL; (5) soft launch operational with a limited cohort (e.g., S&ITD + 2–3 founding departments + a closed group of ~20–50 IT companies); (6) escrow deposit for this release made (M07); (7) KT session delivered (M09).

Key deliverables. Working MVP (soft launch); UAT report; security baseline report; trilingual QA report; initial SOPs for officers; source-code escrow deposit (release 1); runbooks v0; pilot metrics baseline.

Dependencies. Phase 0 dependencies continuing (API access must be live for verify-in-parallel; department officers onboarded and trained); holiday calendar data for SLA.

Top risks. (R-integ) Verification API latency/downtime; (R-ux) Onboarding friction in real cohort; (R-i18n) Sindhi rendering edge cases; (R-sec) Early security findings. Mitigations in §12.


5.3 Phase 2 — AI + Sindhi + SLA (6–8 weeks)[Must] completion → GA

Goal. Complete the Must set to public General Availability (V1.0): full-quality Sindhi and RTL; the complete, configurable SLA engine with the full escalation ladder; the Must-tier TRI meetings + MoM upload; the remaining Must modules (officials CMS historical accuracy, full analytics); and the richer Should-tier AI capabilities that elevate the experience.

Scope.

Epic Module Phase 2 scope MoSCoW
E5 AI Urgency/sentiment scoring; draft reply suggestions + translation (EN/UR/SD); duplicate/similarity detection; PII redaction before cloud processing; public chatbot deepening; trends/analytics insights; MoM action-item extraction (with E13). [S]
E6 COM Tier 2: org-wide inbox (1:1 and group DMs). [S]
E8 INT OIDC SSO hardening. [S]
E9 ANL Full 9 metric families; 7 role dashboards incl. CM/SACM, Secretary, DG, Officer, Company, Public, Operator; GIS/district heatmap; exports (PDF/Excel/CSV). [M+S]
E10 KB Knowledge base + SOPs: articles, downloadable forms, versioned SOPs, AI semantic search, deflection tracking, service catalog. [S]
E13 MTG Tripartite (TRI) hybrid meetings (Company + S&ITD + Dept), physical + virtual (Zoom/Meet/Teams), calendar; MoM upload-first → AI extracts action items → sub-tasks; approval gating for sensitive/VIP tickets; auto-share to participants. [M]
E16 OFC Historical accuracy (date-aware letters/records); propagation to site, letters, dashboards. [S]
Cross i18n Full Sindhi linguistic QA + RTL polish; AI/OCR tuning for Sindhi script; maintained glossary parity. [M]
Cross SLA Full SLA engine: configurable tiers (default 2/5/10), pause-on-await, Sindh public holiday calendar, weekends, complete escalation ladder (Staff → DG → Secretary → SACM), department scorecards on the public dashboard. [M]

Entry criteria. Phase 1 exit (M03); pilot operating without severity-1 defects; API access stable; at least one TRI-worthy stalled ticket or realistic simulation available.

Exit criteria (= Milestone M04 — V1.0 Public GA). (1) All remaining Must stories pass acceptance; (2) Go/No-Go launch checklist (§9.4) is GREEN; (3) public transparency dashboard live; (4) full SLA engine verified end-to-end incl. escalation to SACM; (5) Sindhi WCAG 2.1 AA verified; (6) TRI + MoM flow demonstrated end-to-end; (7) escrow deposit (release 2) made; (8) KT delivered; (9) change-management & adoption plan executing (roadshows scheduled).

Key deliverables. V1.0 GA release; analytics suite; KB/SOP library seeded; TRI capability; full SLA engine; Sindhi QA sign-off; department scorecards; escrow deposit (release 2); GA runbooks.

Dependencies. Sindh holiday calendar data; department participation in TRI pilots; AI provider provisioning (cloud or self-hosted per data sensitivity); PSEB/P@SHA outreach active.

Top risks. (R-ai) AI quality/hallucination; (R-sla) Departments resist published scorecards; (R-tri) Departments decline TRI participation; (R-sd) Sindhi quality gaps surface late. Mitigations in §12.


5.4 Phase 3 — Appeal + Integrations + Security (6–8 weeks)[Should] → V1.1

Goal. Deliver the Should-tier: advanced ticket operations, PKI e-sign + QR-verifiable letters, exam-gated staff certification, multi-channel intake, the remaining integrations (NITB e-Office, public REST API, webhooks), deepened appeal adjudication, and security hardening including penetration testing.

Scope.

Epic Module Phase 3 scope MoSCoW
E2 TKT Sub-tasks; merge/split; link/relate; watchers/CC; bulk actions; appeal adjudication deepening (multi-tier appeal workflow, sensitive/VIP closure approval by Chair/DG). [S]
E3 ORG Step-up authentication for sensitive actions; confidential/VIP attribute-based access control (ABAC); exam-gate (staff must pass certification before handling live tickets). [S]
E4 FILE In-app preview; versioning; retention-policy linkage (Sindh Archives rules). [S]
E5 AI Deeper AI tuning; per-department draft-reply and routing models; AI explainability/audit improvements. [S]
E6 COM Presence, typing, read receipts, full-text multilingual search. [S]
E7 NOT Two-way inbound replies (reply-to-email / reply-to-WhatsApp appends to ticket); preference center (digests, quiet hours). [S]
E8 INT NITB e-Office integration (ticket/MoM → official file movement); public REST API; outbound webhooks. [S]
E11 MCI Multi-channel intake: email/SMS/WhatsApp-to-ticket, toll-free IVR/voice, walk-in/offline entry. [S]
E12 DOC PKI digital signing; QR verification of letters (anti-forgery). [M+S]
E15 TRN LMS-lite: staff courses + exam-gated certification. [S]
Cross Security Penetration testing; CERT-PK coordination; Critical Information Infrastructure (CII) registration; abuse/moderation tooling (with /specs/en/24-trust-safety/). [Must] NFRs

Entry criteria. Phase 2 exit (M04, V1.0 GA); platform stable in production; security engagement scoped.

Exit criteria (= Milestone M05 — V1.1). (1) Should-tier stories pass acceptance; (2) penetration test remediated to agreed severity threshold; (3) CII registration submitted; (4) exam-gate enforced (no uncertified staff on live tickets); (5) e-signed QR-verifiable letters in production; (6) NITB e-Office integration live (where technically available); (7) escrow deposit (release 3) made; (8) KT delivered.

Key deliverables. V1.1 release; penetration-test report + remediation evidence; CII registration; certification program live; e-sign capability; public API; multi-channel intake; escrow deposit (release 3).

Dependencies. NITB e-Office technical availability (A8); PKI/certificate authority arrangement; IVR/voice provider; security firm engaged; training content authored.

Top risks. (R-nitb) NITB e-Office not ready; (R-pki) PKI CA delays; (R-pentest) Material security findings; (R-exam) Low exam pass-rate stalls staff onboarding. Mitigations in §12.


5.5 Phase 4 — Mobile + Advanced (6–8 weeks)[Could] → V1.2

Goal. Deliver the Could-tier and the native mobile experience, taking the platform from "fully functional web V1" to "best-in-class, mobile-first, advanced".

Scope.

Epic Module Phase 4 scope MoSCoW
Mobile Native mobile apps (Android + iOS) via React Native (Expo), mirroring core company + officer journeys; push notifications. (PWA existed since Phase 1.) [Could]
E6 COM Tier 3: channel-based chat (Slack-style: channels per department/topic, ad-hoc channels, threads, pins). [Could]
E9 ANL Advanced BI / embedded Metabase; predictive analytics (volume forecasting). [Could]
E14 SUG Suggestion box; circulars/announcements; versioned document repository. [Could]
E15 TRN Extended certification curriculum; company-facing learning content. [Could]
Cross AI/Advanced Auto-assignment / load-balancing of tickets (currently [W] in vision; revisited here as a candidate). [Could]

Entry criteria. Phase 3 exit (M05); V1.1 stable; app-store/developer accounts provisioned.

Exit criteria (= Milestone M06 — V1.2). (1) Mobile apps pass store review and acceptance; (2) Could-tier stories pass acceptance; (3) escrow deposit (release 4) made; (4) KT delivered; (5) sustainment transition confirmed (§10).

Key deliverables. V1.2 release; Android + iOS apps; channel-based chat; advanced BI; suggestion portal; escrow deposit (release 4).

Dependencies. App-store accounts; push-notification provider; Metabase embedding finalized.

Top risks. (R-mobile) Store review cycles; (R-channel) Adoption of internal chat vs existing tools; (R-scope) Scope creep from Could→Must pressure. Mitigations in §12.


6. MoSCoW → Phase Mapping

This is the single mapping that reconciles the PRD's MoSCoW tags (/specs/en/01-prd/) with the phase themes. "P1" = MVP core; "P2" = AI+Sindhi+SLA; "P3" = Appeal/Integrations/Security; "P4" = Mobile/Advanced. = not in that phase.

Epic Code Phase 1 (Must core) Phase 2 (AI+Sindhi+SLA) Phase 3 (Appeal/Integ/Sec) Phase 4 (Mobile/Adv)
E1 Public Site PUB [M] site, FAQ/help, chatbot, service catalog, transparency (basic), multilingual [S] SEO/hreflang, onboarding wizard, full Sindhi QA [C] advanced CMS
E2 Ticketing Core TKT [M] file, route, track, draft, proof gate, CSAT, reopen, basic appeal [S] sub-tasks, merge/split, link, watchers, bulk; appeal deepening [C] auto-assignment (candidate)
E3 Org & RBAC ORG [M] register, file-first, multi-rep, RBAC, nested depts, lifecycle [S] officials CMS historical accuracy (shared w/ E16) [S] step-up auth, ABAC, exam-gate
E4 Files FILE [M] upload, ClamAV, encryption, secure download [S] preview, versioning, retention
E5 AI AI [M] OCR, summary/classify/route, pluggable engine [S] urgency/sentiment, draft replies, translation, duplicate, PII redaction, chatbot, trends, MoM-extract [S] deeper tuning [C] advanced
E6 Internal Comms COM [M] Tier 1 ticket threads, audit/retention [S] Tier 2 org inbox [S] presence, search [C] Tier 3 channels
E7 Notifications NOT [M] multichannel delivery, templated multilingual [S] two-way inbound, preference center
E8 Integrations INT [M] verification APIs (NADRA/SECP/FBR/SRB/PSEB) [S] OIDC SSO hardening [S] NITB e-Office, public API, webhooks [C] additional
E9 Analytics ANL [M] core dashboards + basic transparency [M+S] full 9 families, 7 dashboards, GIS, exports [S] scheduled digests [C] advanced BI, predictive
E10 Knowledge Base KB [S] KB + SOPs, AI semantic search, deflection
E11 Multi-channel Intake MCI [S] email/SMS/WA-to-ticket, IVR, walk-in [C] voice AI
E12 Doc Gen + e-Sign DOC [M] trilingual letter generation (basic) [M+S] PKI e-sign, QR verification
E13 Hearings + TRI + MoM MTG [M] TRI meetings, MoM upload, approval gating [S] MoM AI deepening [C] advanced
E14 Suggestion Portal SUG [C] suggestion box, circulars
E15 Training & Cert TRN [S] staff courses foundation [S] exam-gated certification [C] extended curriculum
E16 Brand & Officials OFC [M] basic officials records [S] historical accuracy, propagation
E17 Feature Flags FFG [M] flag foundation [M] coverage expansion [M] full coverage

Reading the table. Every [M] story completes by the end of Phase 2 (V1.0 GA) at the latest; most Must ships in Phase 1. [S] completes by end of Phase 3 (V1.1). [C] lands in Phase 4 (V1.2). [W] (Won't) items — native mobile before P4, e-payments, auto-assignment before P4, detailed DR runbooks, non-IT sectors — are explicitly deferred (§11) and not in any V1 phase gate.


7. Milestone Register

Twelve program milestones govern planning, billing, and acceptance. PPP handover milestones (M07–M11) are cross-referenced to /specs/en/23-ppp-vendor-exit/.

ID Milestone Phase Gate / Trigger Primary owner
M01 PPP contract execution & program kickoff Phase 0 entry Contract signed; SoW appended. S&ITD / MAAHIR
M02 Discovery & baseline sign-off Phase 0 exit → P1 Baseline specs approved; env live; API requests lodged; escrow agent appointed. S&ITD / MAAHIR
M03 MVP pilot live (soft launch) Phase 1 exit Must journey UAT green; limited cohort operational. MAAHIR
M04 V1.0 Public GA Phase 2 exit Go/No-Go checklist GREEN; full Must complete; public dashboard live. S&ITD / MAAHIR
M05 V1.1 release Phase 3 exit Should-tier delivered; pen-test remediated; exam-gate enforced; e-sign live. MAAHIR
M06 V1.2 release Phase 4 exit Mobile apps live; Could-tier delivered. MAAHIR
M07 Source-code escrow deposit (PPP) Each release Source + build docs deposited to escrow agent at M03, M04, M05, M06 and ongoing. MAAHIR → Escrow agent
M08 IP transfer / assignment (PPP) Rolling IP in deliverables vests in S&ITD per contract; assignment recorded per release. S&ITD / MAAHIR
M09 Knowledge transfer (KT) (PPP) Per phase + key events KT sessions + runbooks handed over at each phase exit and before any transition. MAAHIR → S&ITD
M10 Exit / transition readiness review (PPP) Pre contract-end Transition plan tested (dry run); S&ITD confirms takeover capability. S&ITD / MAAHIR
M11 Full handover / contract close-out (PPP) Contract end Operations transferred; escrow released if triggered; lessons learned archived. S&ITD
M12 Go/No-Go launch decision gate End of Phase 2 The §9.4 checklist is reviewed and a formal GA decision is recorded. S&ITD (authority)

8. Critical-Path Dependencies

These dependencies are on the critical path: slippage on any one delays the corresponding phase gate. They are tracked weekly by the program office.

# Dependency Owner Affects phase(s) Notes
C1 Legal mandate + per-department MoUs binding departments to SLA response. S&ITD (Secretary) P0 → all Without this, inter-department compliance is voluntary (R2). See /specs/en/22-governance-legal/.
C2 API access to NADRA (CNIC), SECP, FBR/NTN, SRB, PSEB. Ecosystem bodies P0 → P1 Drives file-first, verify-in-parallel registration (US-ORG-002). See /specs/en/08-integrations-spec/.
C3 Server4Sale hosting at the required availability, capacity, security standard. Server4Sale P0 → all Environment verified (Ubuntu 24.04, Node 22, MariaDB 10.11, 3.4 TB disk, 243 GB RAM).
C4 PPP contract in force with SLAs, escrow, IP, exit plan. S&ITD / MAAHIR P0 entry Safeguards in /specs/en/23-ppp-vendor-exit/.
C5 Source-code escrow established. S&ITD / escrow agent P0 → all First deposit at M03.
C6 Exam & certification content authored and validated. S&ITD SMEs / MAAHIR P3 Blocks exam-gate (US-ORG-007). See /specs/en/20-training-certification/.
C7 Sindh public holiday calendar provided and maintained. S&ITD P2 Drives SLA-clock pausing.
C8 Department participation in TRI hearings + MoU + scorecards. Departments P2 → P3 Without departments, facilitation has no resolvers.
C9 NITB e-Office technical availability. NITB P3 Public API/file movement (A8). May descope gracefully if delayed.
C10 Trilingual reviewers (native Urdu & Sindhi) available for QA. MAAHIR / S&ITD P0 → P2 De-risks Sindhi quality (R5).
C11 AI provider provisioning (cloud keys or self-hosted GPU capacity). MAAHIR P1 → P2 Pluggable engines per data sensitivity.
C12 PSEB / P@SHA partnership for outreach and adoption. S&ITD / PSEB / P@SHA P1 → sustainment De-risks adoption (R1).

9. Change-Management & Adoption Plan

Government portals often succeed technically but fail on adoption. This program treats adoption as a first-class workstream with its own plan, owners, and KPIs (§9.5), running from Phase 0 through sustainment. It is the single most important non-technical risk (R1, R2).

9.1 Adoption thesis

The Portal only delivers value when (a) IT companies register and file, and (b) departments respond within SLA. Both are behavioral changes. The plan therefore invests in partnerships, presence, and pull — not just push communications — and uses the public transparency dashboard as the structural incentive for departments to perform.

9.2 Partnerships

Partner Role in adoption
PSEB (Pakistan Software Export Board) Co-branded onboarding drives; PSEB member data as a registration seed; joint roadshows in Karachi/Hyderabad/Sukkur/other IT clusters.
P@SHA (Pakistan Software Houses Association) Chapter events; member onboarding; industry feedback loop into the KB and SOPs.
PSEB-certified IT parks & incubators On-site registration desks; resident-company onboarding.
Universities & freelancers Freelancer entity-type onboarding (one of the 5 entity types); campus drives.
Chambers of Commerce & investors Foreign-branch and startup entity-type outreach; investor-facing transparency.

9.3 Roadshows, onboarding drives, and training

9.4 Go/No-Go launch checklist (M12 / M04)

The checklist below is reviewed at the Go/No-Go gate before V1.0 Public GA. A lighter subset applies at the MVP soft-launch gate (M03). Status: required-pass; required-acceptable-with-plan.

# Check Owner Status
1 All Phase 1 + Phase 2 Must stories pass acceptance (per test strategy). MAAHIR QA
2 End-to-end UAT green (register→file→route→resolve→close→track→appeal). S&ITD UAT
3 Trilingual (EN/UR/SD) verified incl. RTL; Sindhi WCAG 2.1 AA. i18n lead
4 SLA engine verified incl. escalation to SACM + holiday pause. MAAHIR
5 Security baseline: 2FA, ClamAV, encryption at rest/in transit, rate-limiting, observability. Security
6 Pen-test (initial scope) — no open severity-1/2 findings, or remediation plan accepted. Security
7 DR/BCP baseline: backups, failover, RPO/RTO verified. Server4Sale/MAAHIR
8 Public transparency dashboard live and accurate. Analytics
9 Performance/load meets NFRs (/specs/en/03-non-functional-reqs/). MAAHIR
10 Escrow deposit made for this release (M07); IP assignment recorded (M08). S&ITD/MAAHIR
11 Legal mandate issued; ≥ founding department MoUs signed. S&ITD
12 API access (NADRA/SECP/FBR/SRB/PSEB) stable. Integrations
13 KT delivered for this release (M09); runbooks published. MAAHIR
14 Adoption plan executing: roadshows scheduled, PSEB/P@SHA partnered, onboarding wizard live. S&ITD
15 Support model live: facilitation desk, notification channels, abuse moderation. MAAHIR
16 Privacy/RTI compliance confirmed (Sindh RTI Act 2016). Legal
17 Go/No-Go decision formally recorded by S&ITD. Secretary S&ITD

9.5 Adoption KPIs

Tracked in /specs/en/17-analytics-kpis/: registered entities by type (target ≥1,500 verified in 12 months); active departments with certified officers (≥40); filing-to-resolution funnel; deflection rate (≥30%); CSAT; department SLA compliance (public scorecard).


10. Post-Launch Sustainment & Funding

10.1 Operating model after GA

From V1.0 GA onward, MAAHIR operates the platform under the PPP managed-services arrangement, with Server4Sale hosting. Sustainment covers: managed services (L2/L3), incident response, security operations, trilingual content maintenance, AI model upkeep, KB/SOP curation, analytics/reporting, and continuous improvement against the KPIs in §11.

10.2 Funding

10.3 Continuous improvement

Each release after GA follows the release cadence (§13). The product backlog is fed by: analytics insights, CSAT/appeal trends, department feedback, AI draft-acceptance metrics, and the suggestion portal (Phase 4).


11. KPIs Per Phase

KPI definitions, formulas, thresholds, and cadences are owned by /specs/en/17-analytics-kpis/. The roadmap's per-phase KPI focus is:

Phase Primary KPI focus Indicative target by phase exit
Phase 0 Baseline readiness; dependency closure. 100% baseline specs approved; 100% API requests lodged; escrow signed.
Phase 1 Pilot journey health; trilingual correctness. End-to-end UAT pass; 0 open Sev-1; Sindhi QA pass on pilot scope; ≥20–50 pilot entities.
Phase 2 (GA) Resolution speed; SLA compliance; transparency; participation. Public dashboard live; SLA engine verified to SACM; 7 dashboards live; ≥ founding departments onboarded with certified officers.
Phase 3 Security posture; deflection; e-sign adoption; certification. Pen-test remediated; ≥30% deflection trend established; exam pass-rate ≥ set threshold; QR letters in use.
Phase 4 Reach & mobile adoption; advanced analytics. Mobile apps live; registered entities on ≥1,500 trajectory; advanced BI in use.
Sustainment Long-term G1–G10 (vision doc §4): TAT ≤15 working days; ≥1,500 verified entities; ≥40 departments; ≥30% deflection; CSAT trending up. 12-month post-GA horizon.

12. Risk Register & Mitigations

Risks are inherited/extended from /specs/en/00-vision-scope/ §12 and made phase-aware. Likelihood (L) and Impact (I): L/M/H.

ID Risk L I Phase(s) Mitigation
R1 Low adoption by IT companies and departments. M H P1→sustain Change-management plan (§9); PSEB/P@SHA partnerships; roadshows; onboarding wizard; public dashboard demonstrating responsiveness.
R2 Inter-department non-compliance with SLAs. H H P2→sustain Legal mandate + per-department MoUs (C1); escalation ladder to DG→Secretary→SACM; published department scorecards.
R3 Data sensitivity / sovereignty (cloud AI on gov/citizen data). M H P1→P2 Pluggable AI/OCR engines; self-hosted toggle (Llama/Qwen + Tesseract); PII redaction; encryption.
R4 Scope creep. H M All MoSCoW on every requirement; phased delivery; feature flags (Module Q); change-control via the program office.
R5 Trilingual quality drift (esp. Sindhi). M M P0→P2 Maintained _glossary.md; native-speaker review (C10); structural parity; CPGRAMS proves Urdu+Sindhi is achievable.
R6 PPP vendor lock-in. M H All Source-code escrow (M07); documented IP ownership (M08); binding exit/handover plan (M10/M11); standards-based stack.
R7 Cybersecurity threats (defacement, breach, DDoS). M H P1→P3 Pen-test (P3); CERT-PK coordination; CII registration; ClamAV; rate-limiting; 2FA; observability.
R8 Abuse / false complaints. M M P1→P3 Moderation; false-complaint penalties; CAPTCHA; rate-limiting; whistleblower channel; identity-verification appeals (/specs/en/24-trust-safety/).
R9 Political / leadership change. M M All Officials CMS (Module P) makes the product leadership-agnostic and historically accurate; standalone architecture.
R10 AI quality / hallucination erodes trust. M H P1→P2 Human-in-the-loop on every consequential action; AI never closes/signs; PII redaction; draft-acceptance metrics.
R11 API access delays (NADRA/SECP/FBR/SRB/PSEB). M H P0→P1 Lodge requests in Phase 0 (C2); design verify-in-parallel to degrade gracefully (manual verification fallback) if an API lags.
R12 NITB e-Office not ready. M M P3 Decouple as a Should-tier item; feature-flag; deliver public API + webhooks independently.
R13 Pen-test material findings. M H P3 Engage security firm early (Phase 2); budget remediation time; severity-based go-criteria.
R14 Low exam pass-rate stalls staff onboarding. M M P3 Iterative content; practice tests; departmental prep; provisional handling with supervisor oversight pre-cert.
R15 Sustainment funding gap after ADP cycle. L H Sustain Pre-negotiated renewal/exit funding (§10); path-to-self-sustaining options; KPI-driven business case.

13. Release Cadence & Versioning

13.1 Versioning

Semantic versioning at the platform level (the deployed product), independent of internal module versions:

Release Version Trigger Phase gate
MVP pilot (soft launch) v0.9.0 Phase 1 exit M03
Public GA v1.0.0 Phase 2 exit + Go/No-Go GREEN M04
Appeal/Integrations/Security v1.1.0 Phase 3 exit M05
Mobile/Advanced v1.2.0 Phase 4 exit M06
Post-GA continuous releases v1.x.y patches / v1.minor.0 features Cadence below

13.2 Cadence after GA

13.3 Release governance

Every release passes: automated CI (lint/type/test), security scan, trilingual QA on touched surfaces, UAT for changed journeys, release notes (EN/UR/SD), escrow deposit (M07), IP assignment note (M08), and a KT note (M09). Rollback is tested before each release. The Super Admin feature-flag console (Module Q) controls per-department/env exposure.


14. References

14.1 Internal documentation

14.2 External benchmarks


End of document. Urdu and Sindhi parallel translations (ur.md, sd.md) follow this master structure exactly.