Skip to content

Touli Rollout Plan, Risk Register, and Readiness Checklist

Purpose

Define phased rollout planning for AI verification, points, and blockchain modules, including risk controls and implementation kickoff readiness.

Phased Rollout Plan

Phase A: Points Foundation

Scope:

  • Deterministic points engine design freeze
  • config snapshot model
  • ledger invariants and idempotency approach

Exit criteria:

  • calculation contract approved
  • invariants documented and test strategy defined
  • schema delta for points domain approved

Phase B: Verification Foundation

Scope:

  • rules-first verification architecture
  • confidence routing
  • manual review pathway

Exit criteria:

  • state machine approved
  • escalation SLA and reason code taxonomy approved
  • data lifecycle controls specified

Phase C: AI + Labels Integration

Scope:

  • vision adapter contract
  • feature and label capture architecture
  • cost and fallback policies

Exit criteria:

  • provider interface approved
  • outage fallback and retry policy approved
  • labeling strategy approved

Phase D: Blockchain Anchoring

Scope:

  • leaf schema and pseudonymization
  • batch lifecycle and reconciliation model
  • proof retrieval contract

Exit criteria:

  • anchoring DLD approved
  • replay/reconciliation policy approved
  • privacy unlinkability controls approved

Phase E: Operational Hardening

Scope:

  • observability SLOs
  • runbooks and on-call readiness
  • compliance checkpoint validation

Exit criteria:

  • SLO dashboard definition approved
  • runbooks accepted
  • go/no-go checklist green

2-Week Architecture Finalization Timeline

Week 1:

  • Day 1-2: HLD alignment workshop and decision log
  • Day 3-4: DLD deep dives (verification + points)
  • Day 5: schema delta and interface review

Week 2:

  • Day 1-2: blockchain + compliance review
  • Day 3: risk workshop and mitigation ownership
  • Day 4: readiness review and sign-offs
  • Day 5: architecture freeze package handoff

Risk Register

Risk IDRiskLikelihoodImpactMitigationOwner
R1Points logic drift between product docs and engine configMediumHighsnapshot versioning + single source of truth review gateProduct + Architecture
R2Duplicate credits from retries/concurrencyMediumHighidempotency keys + unique constraints + replay-safe workersBackend
R3Manual review backlog exceeds SLAHighMediumqueue capacity planning + degrade-to-safe routing + staffing fallbackTrust Ops
R4AI provider outage/degradationMediumMediumadapter abstraction + retry policy + manual fallbackPlatform
R5Residency/compliance policy mismatch by marketMediumHighmarket policy engine + pre-launch legal checklistCompliance
R6On-chain anchoring delays or failed confirmationsMediumMediumasync decoupling + reconciliation + replay attemptsPlatform
R7Erasure request does not fully break chain relinkabilityLowHighrotating pseudonyms + mapping destruction verificationSecurity + Compliance
R8Schema expansion increases query latencyMediumMediumindex strategy + read model projections + performance budgetData
R9Contract drift between API and event consumersMediumMediumversioned schemas + consumer compatibility testsBackend
R10Scope creep before implementation startHighMediumarchitecture freeze and change-control processPM + Architecture

Readiness Checklist (Go/No-Go for Dev Start)

A. Architecture Readiness

  • [ ] HLD approved by architecture owner.
  • [ ] DLDs approved for verification, points, and anchoring.
  • [ ] ADR set approved and signed.
  • [ ] Open questions resolved or logged with explicit assumptions.

B. Data and Contract Readiness

  • [ ] Schema delta spec approved (proposal level).
  • [ ] API contracts approved (v1).
  • [ ] Event contracts approved with versioning rules.
  • [ ] Idempotency and replay semantics documented per flow.

C. Compliance Readiness

  • [ ] Age/consent policy matrix approved per launch market.
  • [ ] Data retention/deletion control design approved.
  • [ ] Human review and contestability pathway approved.
  • [ ] Residency and processor boundary controls approved.

D. Operations Readiness

  • [ ] SLOs defined for verification, points, and anchoring.
  • [ ] Alerting and dashboard metric list approved.
  • [ ] Runbooks drafted for queue backlog, AI outage, chain failure.
  • [ ] Incident ownership and escalation tree defined.

E. Planning Readiness

  • [ ] Phase milestones aligned with engineering capacity.
  • [ ] Dependencies and blockers mapped.
  • [ ] Risk register ownership accepted.
  • [ ] Architecture freeze date committed.

Change Control After Freeze

  • Any post-freeze changes require:
    • change request record
    • impact assessment (data, compliance, contracts, delivery)
    • architecture owner approval
    • updated ADR entry