Readiness
:::info Source
Sourced from services/delivery-service/SERVICE_READINESS.md in the documentation repo.
:::
1. Level per Milestone
| M | Level | Scope |
|---|---|---|
| M0 | — | Design skeleton + storyboards |
| M1 | L3 | Player MVP + AI tutor + offline + resume + progress emission |
| M2 | L3 | — (additive) |
| M3 | L4 | SCORM 2004 + xAPI runtime + branching scenarios |
| M4 | L4 | Live collab (discuss board), LTI 1.3 launch |
| M5 | L4 | Mobile native parity |
2. Gates
G1 — Domain
-
PlaySessionaggregate; state machineinit → active → paused → completed | abandoned. - Navigation cursor invariants (monotonic per course-structure order).
- 95% unit / 80% mutation.
G2 — API
- OpenAPI; Idempotency-Key; problem+json; cursor pagination.
- SSE for AI tutor stream.
- Pact: consumer of content, enrollment, ai-gateway; producer of progress.
G3 — Events
-
delivery.play_session.*,delivery.tutor_turn.*,delivery.offline_mounted.v1,.unmounted.v1registered. - Outbox + inbox.
G4 — Sync
-
PlaySessionregistered —server_authoritative(server wins on cursor conflicts). - Statements outbox client-side (7-day offline).
G5 — AI
- Tutor calls via AIClient; local+cloud parity.
- Provenance on every turn.
- Refusal UX (ai.refused.safety + custom tutor-specific).
- Prompts registered: tutor, explain-concept, summarize, nudge.
- Red-team corpus passes.
- Accept-rate ≥ 50% (S1 target).
G6 — Observability
- Player RUM metrics (LCP, INP, CLS).
- Session duration, completion rate, bounce rate dashboards.
- AI: first-token p95, cost/session, refusal rate.
G7 — Performance
- Player LCP < 1s online.
- Offline cold mount < 600ms.
- AI tutor first-token < 600ms p95.
- 10k concurrent sessions/region sustained.
G8 — Security
- License envelope enforcement verified.
- Cross-tenant resume blocked.
- Bundle tamper → session-abandon + event.
- Two-tenant iso green.
- Pen-test M1 scope closed.
3. SLOs
| SLI | Target |
|---|---|
| Session start p95 | < 300ms |
| AI tutor first-token p95 | < 600ms |
| Statement emit success | ≥ 99.99% (with outbox retry) |
| Offline mount cold p95 | < 600ms |
| Progress resume accuracy | ≥ 99.9% |
4. DoD per Story
- Unit + integration + contract + E2E tests green.
- OpenAPI updated.
- AI changes → prompt regression + safety eval pass.
- Airplane-mode E2E if offline-touching.
- Two-tenant iso test.
- Dashboards + runbooks updated.
5. Release Checklists
S1 (M1)
- Player MVP: navigation, resume, progress, offline, AI tutor.
- AI tutor accept-rate ≥ 50%; red-team corpus.
- Offline cold mount < 600ms on low-end Android.
- Airplane-mode J-12 E2E green.
- Tamper detection E2E.
- Accessibility: WCAG 2.2 AA on player.
S4 (M3)
- SCORM 2004 runtime: all cmi.* interactions pass conformance.
- xAPI 1.0.3 runtime.
- Branching scenarios: 5-level depth tested.
- Compliance reports visible to org admins.
S6 (M5)
- Mobile native parity (iOS + Android) ≥ 4.5 app store rating.
- Multi-region session affinity.
- HIPAA-compliant tenant session isolation.