# Multi-Wallet Program Master Index

Date: 2026-03-30  
Audience: Engineering, Architecture, QA, Product, Operations  
Status: ready-for-execution

## 1. Program Objective
Deliver multi-wallet capabilities in the existing repository without breaking current production behavior:
- Multiple wallet products per customer (including same-type wallet products)
- Sub-wallet lifecycle as child of wallet product
- Multi-currency configuration per wallet product with primary/display-only behavior

Primary functional source:
- docs/multiwallet_suggested.md

Primary architecture constraints:
- docs/adr/0001-app-boundaries.md
- docs/adr/0002-eventing-and-outbox.md
- docs/adr/0003-financial-ledger-invariants.md
- docs/adr/0004-idempotency-and-locking-strategy.md
- docs/adr/0005-api-error-and-idempotency-response-contract.md
- docs/adr/0007-observability-and-audit-traceability-standard.md
- docs/adr/0010-release-strategy-and-migration-rollback.md
- docs/adr/0012-testing-strategy-and-quality-gates.md

## 2. Execution Artifacts
- Program tracker: docs/multi-wallet/multi-wallet-phase-tracker.md
- Phase 1 checklist: docs/multi-wallet/phase-1-discovery-and-gap-mapping.md
- Phase 2 checklist: docs/multi-wallet/phase-2-domain-contract-and-adr-alignment.md
- Phase 3 checklist: docs/multi-wallet/phase-3-persistence-and-migration-foundation.md
- Phase 4 checklist: docs/multi-wallet/phase-4-wallet-product-and-subwallet-domain-services.md
- Phase 5 checklist: docs/multi-wallet/phase-5-ledger-transactions-and-idempotency-controls.md
- Phase 6 checklist: docs/multi-wallet/phase-6-api-and-channel-integration.md
- Phase 7 checklist: docs/multi-wallet/phase-7-eventing-observability-and-compliance-hardening.md
- Phase 8 checklist: docs/multi-wallet/phase-8-e2e-validation-and-release-readiness.md
- Phase 9 checklist: docs/multi-wallet/phase-9-rollout-migration-and-hypercare.md

## 3. Program Flow
1. Complete each phase checklist in order.
2. Attach evidence links before moving a phase to done.
3. Update tracker after each sprint/weekly review.
4. Do not start release activities until Phase 8 exit criteria is met.

## 4. Definition of Done (Program)
The multi-wallet program is complete when all conditions are true:
- Phase 1 through Phase 9 status is done in tracker.
- All P0 checklist items are checked.
- Data migration rollback is tested.
- Idempotency, locking, and ledger invariants pass test gates.
- Product, Security, Compliance, and Operations sign-off is captured.