Readiness
:::info Source
Sourced from services/progress-service/SERVICE_READINESS.md in the documentation repo.
:::
1. Level per Milestone
| M | Level | Scope |
|---|---|---|
| M0 | L1 | Event pipeline skeleton |
| M1 | L3 | Basic progress + transcripts; statement ingest; completion event |
| M2 | L3 | — |
| M3 | L4 | Full xAPI 1.0.3 + cmi5 conformance; SCORM 2004 statement mapping |
| M4 | L4 | Branching scenario statements |
| M5 | L4 | Multi-region + HIPAA tier |
2. Gates
G1 — Domain
-
Attempt,Statement,CompletionRecordaggregates + invariants. - State machine
open → closed. - 95% unit / 80% mutation.
G2 — API
- xAPI 1.0.3 conformance.
- OpenAPI for internal.
- Idempotency on internal writes.
- cursor pagination.
G3 — Events
-
progress.statement.stored.v1,.attempt.*,.completion.recorded.v1registered. - Outbox + inbox.
G4 — Sync
- Statement
append_only; Attempt + CompletionRecordserver_authoritative. - Offline statements outbox 7-day.
G5 — AI
- No direct AI; data exposed to ai-gateway consumers.
- PII-redacted analytics firehose.
G6 — Observability
- Ingestion, projection, query dashboards.
- DLQ alerts.
G7 — Performance
- 10k statements/sec/region sustained.
- Transcript < 2s p95.
- xAPI query < 300ms p95.
G8 — Security
- Tenant iso green (RLS + tenant-hash partitioning).
- Merkle-anchored audit.
- Signed-statement verification.
- GDPR saga participation.
3. SLOs
| SLI | Target |
|---|---|
| Ingestion availability | 99.99% |
| Statement→completion event p95 | < 5s |
| xAPI query p95 | < 300ms |
| Transcript render p95 | < 2s |
| Outbox lag p99 | < 30s |
4. DoD
- Unit + integration + contract + xAPI conformance green.
- OpenAPI updated.
- Event schemas registered.
- Migrations fwd+back; replay test.
- Two-tenant iso test.
- Dashboards + runbook.
5. Release Checklists
S1 (M1)
- Basic transcripts (JSON + PDF).
- Completion-event triggers certificate issuance E2E.
- Offline replay E2E (50+ statements).
- 10k/sec load test green.
S4 (M3)
- xAPI 1.0.3 ADL conformance badge.
- cmi5 session/registration semantics validated.
- SCORM 2004 → xAPI statement mapping coverage.
- Compliance officer export tools.
S6 (M5)
- HIPAA PHI envelope encryption per-tenant.
- Multi-region active-active reads.
- Cross-region audit chain.