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:
- 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). - Delivery is phased into Phase 0 → Phase 4 (see
_context.md§9). - 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:
- Service-Level Agreements (SLAs) — operational, availability, and resolution SLAs with penalties and remedies.
- Source-code escrow — deposit at every release, release to S&ITD on trigger events (M07).
- Intellectual Property (IP) ownership — IP vests in S&ITD (M08, rolling).
- Knowledge transfer (KT) — per phase and at contract milestones (M09).
- 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):
- Phase 1 ships the Must-tier core as a controlled pilot / soft launch with a limited cohort of departments and companies. This is the end-to-end Must journey: register → file → route → resolve → close → track, in EN/UR/SD with basic AI.
- Phase 2 completes the Must set to General Availability (GA): full Must-quality Sindhi linguistic QA and RTL polish; the full SLA engine (configurable tiers, pause-on-await, Sindh holiday calendar, complete escalation ladder to the SACM); the Must-tier TRI meetings + MoM; and the remaining Must modules (officials CMS, full dashboards). Phase 2 exit = V1.0 public GA.
- Phase 3 delivers the Should-tier (advanced ticket operations, PKI e-sign + QR letters, exam-gated certification, multi-channel intake, NITB e-Office, public API, security hardening + penetration test) and deepens appeal adjudication.
- Phase 4 delivers the Could-tier and mobile/advanced capabilities.
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).
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
- Roadshows (Phase 1 exit onward): quarterly multi-city events (Karachi, Hyderabad, Sukkur, Larkana, Mirpurkhas) jointly with PSEB/P@SHA — live demos, on-the-spot registration help, FAQ sessions in EN/UR/SD.
- Onboarding drives: time-bound campaigns (e.g., "First 500 verified entities") with the onboarding wizard (US-PUB-005) guiding each of the 5 entity types.
- Department training & certification (Phase 3): the exam-gated certification (US-ORG-007,
/specs/en/20-training-certification/) ensures every officer handling live tickets is trained and certified. Pre-GA, founding departments get intensive enablement. - Leadership dashboards as adoption leverage: the CM/SACM and Secretary dashboards make department performance visible, creating top-down pull.
- Multilingual, accessible comms: all adoption material in EN/UR/SD, WCAG 2.1 AA, Ajrak-branded, with the public transparency dashboard as the "proof of responsiveness" story.
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
- Primary: ADP (Annual Development Programme) budget line. S&ITD establishes a dedicated ADP line for the Portal covering build (Phase 0–4) and initial sustainment. The ADP line is the locked funding source and is reflected in the PPP contract.
- Path to self-sustaining. As adoption matures, the model evolves toward cost-recovery / self-sustaining options (e.g., tiered value-added services for companies, sponsored KB content, integration fees) — only where they do not compromise free core facilitation for the IT industry. Any monetization is subject to S&ITD and government approval and must preserve free filing for all 5 entity types.
- Renewal/exit funding is pre-negotiated in the PPP so that a transition (M10/M11) is fundable without disruption.
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
- Patch releases (bug fixes, security patches, hotfixes): as needed, target ≤72h for Sev-1.
- Minor releases (features, improvements): every 4–6 weeks, behind feature flags, with escrow deposit + KT note per release.
- Major releases: aligned to ADP/fiscal planning cycles and the PPP contract review points.
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
- Project context (locked decisions):
../_context.md - Documentation conventions:
../_conventions.md - Vision & scope:
/specs/en/00-vision-scope/ - PRD (MoSCoW per story):
/specs/en/01-prd/ - Functional requirements:
/specs/en/02-functional-reqs/ - Non-functional requirements:
/specs/en/03-non-functional-reqs/ - Roles & permissions:
/specs/en/04-roles-permissions/ - Ticket workflow:
/specs/en/06-ticket-workflow/ - AI/OCR spec:
/specs/en/07-ai-ocr-spec/ - Integrations spec:
/specs/en/08-integrations-spec/ - UX/sitemap/flows:
/specs/en/10-ux-sitemap-flows/ - Security & compliance:
/specs/en/11-security-compliance/ - API contract:
/specs/en/12-api-contract/ - Test strategy:
/specs/en/13-test-strategy/ - Tech architecture:
/specs/en/15-tech-architecture/ - Branding & design system:
/specs/en/16-branding-design-system/ - Analytics & KPIs:
/specs/en/17-analytics-kpis/ - Knowledge base & SOPs:
/specs/en/18-knowledge-base-sop/ - Multi-channel intake:
/specs/en/19-multichannel-intake/ - Training & certification:
/specs/en/20-training-certification/ - MoM & meetings:
/specs/en/21-mom-meetings/ - Governance & legal:
/specs/en/22-governance-legal/ - PPP vendor & exit:
/specs/en/23-ppp-vendor-exit/ - Trust & safety:
/specs/en/24-trust-safety/
14.2 External benchmarks
- India CPGRAMS (
pgportal.gov.in) — phased adoption of appeal, feedback, mobile apps, AI chatbot, Urdu+Sindhi support. - Pakistan Citizens Portal (PCP) — mobile-first routing and ministerial dashboards.
- SIFC "One Window" — investor single-window model provincialized for IT.
End of document. Urdu and Sindhi parallel translations (ur.md, sd.md) follow this master structure exactly.