Skip to main content

Readiness

:::info Source Sourced from services/delivery-service/SERVICE_READINESS.md in the documentation repo. :::

1. Level per Milestone

MLevelScope
M0Design skeleton + storyboards
M1L3Player MVP + AI tutor + offline + resume + progress emission
M2L3— (additive)
M3L4SCORM 2004 + xAPI runtime + branching scenarios
M4L4Live collab (discuss board), LTI 1.3 launch
M5L4Mobile native parity

2. Gates

G1 — Domain

  • PlaySession aggregate; state machine init → 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.v1 registered.
  • Outbox + inbox.

G4 — Sync

  • PlaySession registered — 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

SLITarget
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.