Auth0 → OpenIddict Migration¶
This directory is a temporary planning space for the Auth0 → OpenIddict migration work. Delete these planning docs after the migration completes.
Epic issue: #2418
Structure¶
- strategy.md — Current 5-phase plan (revised after Phase 1 shipped). The source of truth for phase scope and sequencing.
- actions-openiddict-mapping.md — Maps Auth0 custom actions to OpenIddict equivalents.
- phases/ — Per-phase execution artefacts (context, roadmap, slices, summaries). These come from the milestones tracked during implementation.
- _archive/ — Superseded plans preserved for reference (e.g. the original BFF-only strategy that predates the "BFF + Auth0 first" revision).
Phase status¶
| Phase | Title | Status | Execution detail |
|---|---|---|---|
| 1 | BFF Infrastructure | Shipped (PR #2416) | — |
| 2 | Identity Service Readiness | Shipped | phases/02-identity-service-readiness/ |
| 3 | Parallel Authentication | Shipped | phases/03-parallel-authentication/ |
| 4 | User Migration | Shipped | phases/04-user-migration/ |
| 5 | Cutover + Decommission | Planned | phases/05-cutover-decommission/ |
Phase numbering follows strategy.md. Phase 1 is documented via PR #2416 and does not have a separate phase directory.
Why this lives under docs/planning/¶
Per the project documentation framework, temporary planning documents go in docs/planning/. These docs will be deleted or archived once the migration is complete and the production system is fully on OpenIddict.
The per-phase execution artefacts under phases/ were previously tracked in .gsd/milestones/M001-M005/. They are moved here so they live alongside the strategy document and are discoverable through the docs site.