Uh oh!
There was an error while loading. Please reload this page.
docs(db): modular redesign spec + epic rollout plan - #263
Conversation
Design spec (conventions charter, per-domain target DDL, catalog transform, migration sequencing) and the epic rollout plan (10 PR slices into epic/db-modular-redesign, PR1 detailed, staging->prod promotion runbook). Docs only; seeds the epic branch. Supersedes #137/#138/#142/#259/#260. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Important Review skippedAuto reviews are disabled on base/target branches other than the default branch. Please check the settings in the CodeRabbit UI or the ⚙️ Run configurationConfiguration used: defaults Review profile: CHILL Plan: Pro Plus Run ID: You can disable this status message by setting the Use the checkbox below for a quick retry:
✨ Finishing Touches🧪 Generate unit tests (beta)
Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out. Comment |
Deploying with |
| Status | Name | Latest Commit | Preview URL | Updated (UTC) |
|---|---|---|---|---|
| ✅ Deployment successful! View logs | frontend-staging | e3b9e32 | Commit Preview URL Branch Preview URL | Jun 23 2026, 10:32 PM |
Uh oh!
There was an error while loading. Please reload this page.
What this is
The design spec and epic rollout plan for the full modular redesign of the Sapling DB schema. Docs-only — no schema or code changes land here. This PR seeds the
epic/db-modular-redesignbranch that subsequent per-domain slice PRs will target.Context
coursescurrently conflates three concepts (abstract course + per-term offering + free-text'Spring 2026'semester), which is the root of the semester work (#137/#138/#142/#259/#260). Fixing it properly pulls in a broader convention pass. Prod has no user data — only the course catalog, so we design the correct shapes directly (clean breaking migrations) and only transform the catalog once.Documents
docs/superpowers/specs/2026-06-23-db-modular-redesign-design.md— conventions charter (9 rules), per-domain target DDL for every table, the catalog transform, migration sequencing, downstream code impact, open decisions.docs/superpowers/plans/2026-06-23-db-modular-redesign-epic.md— branch strategy, 10 ordered PR slices (migration + code + tests each), PR 1 detailed with runnable migration SQL, and the staging→prod promotion runbook.Headline change
courses→ abstractcourses+course_offerings(per-term) +terms(orderable, date-ranged);user_courses→enrollments(FK to an offering). "Current term" is date-derived. Grades & analytics inherit the term through existing joins.Delivery model
One PR per DB-affecting change, each targeting this epic branch; the epic branch may be WIP-red between slices; the final epic → main PR is the green cutover.
Resolved decisions
offering_id; addschools; encrypted points stay 🔒text; enum sets read off code per slice.Issues this epic will close / supersede
Supersedes #137/#138/#142/#259/#260; closes#160/#161/#176/#177/#178/#179/#180/#181/#195/#247; re-scopes #258 (seed against the new schema).
🤖 Generated with Claude Code