Skip to main content

Readiness

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

1. Level per Milestone

MLevelScope
M0L1Event pipeline skeleton
M1L3Basic progress + transcripts; statement ingest; completion event
M2L3
M3L4Full xAPI 1.0.3 + cmi5 conformance; SCORM 2004 statement mapping
M4L4Branching scenario statements
M5L4Multi-region + HIPAA tier

2. Gates

G1 — Domain

  • Attempt, Statement, CompletionRecord aggregates + 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.v1 registered.
  • Outbox + inbox.

G4 — Sync

  • Statement append_only; Attempt + CompletionRecord server_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

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