Skip to main content

Migration Plan

:::info Source Sourced from services/enrollment-service/MIGRATION_PLAN.md in the documentation repo. :::

1. Rules​

  • Enrollment lifecycle (F30) frozen M1 start; additive states only.
  • Source kinds additive; enum changes dual-publish.

2. Database​

Additive columns. State enum additive (new states OK).

3. API​

URL major on breaking.

4. Event Versioning​

All v1 additive.

5. Source Kind Evolution​

  • Add new source: bundle_gift, promotion, etc. — additive.
  • Refactor existing source: deprecate kind + add new; dual-support.

6. Data Residency​

Enrollments pinned to tenant homeRegion.

7. GDPR​

Erase user enrollments. Retain tenant-level aggregates.

8. Changelog​

Per-release: new source kinds, state additions, bulk API improvements.