feat(db): schema-foundation migrations 0019-0026 (target schema) - #264

Merged
AndresL230 merged 3 commits into
epic/db-modular-redesignfrom
db/schema-foundation
Jun 24, 2026
Merged

feat(db): schema-foundation migrations 0019-0026 (target schema)#264
AndresL230 merged 3 commits into
epic/db-modular-redesignfrom
db/schema-foundation

Conversation

@AndresL230

@AndresL230AndresL230 commented Jun 23, 2026

Copy link
Copy Markdown
Collaborator

What this is

The schema source of truth for the modular redesign — migrations 0019–0026 authored as one coherent set (per the schema-first decision). Targets the epic branch. Draft until it gets a staging apply + review.

Spec: docs/superpowers/specs/2026-06-23-db-modular-redesign-design.md · Plan: docs/superpowers/plans/2026-06-23-db-modular-redesign-epic.md

Migrations

FileDoes
0019_conventions_terms_schoolsset_updated_at() trigger fn; terms (seeded, date-derived "current"); schools. Additive.
0020_academics_splitData-preserving catalog transform: courses → abstract courses + course_offerings (per-term, FK to terms); user_courses → enrollments(offering_id).
0021_gradebookcourse_categories → gradebook_categories, assignments re-keyed to enrollment_id; due_date date; type/source CHECK enums.
0022_analyticscourse_concept_stats/course_summary → offering_* keyed on offering_id; free-text semester retired.
0023_graph_integritygraph FKs, UNIQUE dedup (retires dedup_nodes.py), indexes, node_mastery_events (atomic mastery).
0024_identity_splituser_profiles (1:1); profile columns removed from usersanduser_settings; oauth_tokens.expires_at → timestamptz.
0025_study_integritynotes FKs, offering scoping, indexes, enums, soft-delete; re-adds enrollments.syllabus_doc_id FK.
0026_opsfeedback/issue_reports user FKs; integer-seq PKs → text.

Conventions applied

Text PKs (decision: uuid deferred — would force a big-bang) · FKs everywhere with explicit ON DELETE · created_at/updated_at + trigger · real types (date/timestamptz) except 🔒 encrypted columns (kept TEXT) · CHECK enums read off the code (e.g. mastery_tier includes subject_root; assignment.source is manual/syllabus, not google).

Validation

Applied the full 0001→0026 chain against a throwaway Postgres 15 with a synthetic catalog (incl. two sections of one course in one term). All assertions passed: abstract-course dedup correct, every offering mapped to course+term, legacy tables dropped, profile-column duplication removed, exactly one "current" term. Not yet applied to staging — that's the pre-merge step.

Notes / decisions baked in

  • Catalog transform is data-driven — runs the same on prod's real catalog. Before prod: SELECT DISTINCT semester FROM courses; and add any missing terms rows (0019).
  • Free-text courses.school is dropped (schools table supersedes it) — confirm no prod catalog relies on it, or populate schools first.
  • messages.role left unconstrained (exact value set not confirmed in code).

Next

After this merges to the epic: the per-domain code PRs (db/academics-code first) adapt routes/services against this schema.

🤖 Generated with Claude Code

@AndresL230@claude
feat(db): schema-foundation migrations 0019-0026 (full target schema)
72443e9
Authors the complete modular target schema as one coherent set: terms+schools+updated_at trigger (0019), academics catalog/offering/enrollment split with data-preserving catalog transform (0020), gradebook re-keyed to enrollment (0021), analytics re-keyed to offering (0022), graph integrity + mastery events (0023), identity profile split (0024), study/sessions integrity (0025), ops cleanup (0026). Text PKs, FKs+ON DELETE, real types, CHECK enums read off code, encryption columns kept TEXT. Validated 0001->0026 end-to-end against Postgres 15 incl. the catalog transform. Source of truth for the per-domain code PRs.
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@coderabbitai

coderabbitaiBot commented Jun 23, 2026•
edited
Loading

Copy link
Copy Markdown

Important

Review skipped

Auto reviews are disabled on base/target branches other than the default branch.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro Plus

Run ID: 44462477-b9f5-4e7e-b780-5d14dfa84722

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

  • 🔍 Trigger review
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch db/schema-foundation

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.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

@cloudflare-workers-and-pages

cloudflare-workers-and-pagesBot commented Jun 23, 2026•
edited
Loading

Copy link
Copy Markdown

Deploying with Cloudflare Workers Cloudflare Workers

The latest updates on your project. Learn more about integrating Git with Workers.

StatusNameLatest CommitPreview URLUpdated (UTC)
✅ Deployment successful!
View logs		frontend-stagingc26ecf4Commit Preview URL

Branch Preview URL		Jun 24 2026, 06:40 AM

Jose-Gael-Cruz-Lopezand others added 2 commits June 24, 2026 01:19
@Jose-Gael-Cruz-Lopez
fix(db): add gen_random_uuid default to course_offerings and enrollme…
e826464
…nts ids
The renamed baseline tables inherited a TEXT PRIMARY KEY with no default,
unlike every other table in the redesign. Add gen_random_uuid()::text so the
app does not have to supply ids on insert for these two tables.
@AndresL230@claude
feat(db): absorb parallel gradebook/newsletter/gradescope schema into…
c26ecf4
… redesign
Folds the in-flight DB changes from origin/Gradebook and origin/chore/staging-ops-scripts into the redesign so nothing is lost and the schema stays the single source of truth: drop-lowest -> gradebook_categories.drop_lowest; bell-curve policy -> enrollments.curve_*; per-assignment curve stats + gradescope_assignment_id -> assignments; gradescope_credentials + gradescope_course_links (link re-targeted to enrollment_id) -> 0027; newsletter_emails.approved_at -> 0026. Those branches' migration files are now superseded; their CODE rewire is tracked in filed issues. Validated 0001->0027 against Postgres 15.
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
This was referenced Jun 24, 2026
Closed
Closed
Closed
@AndresL230
AndresL230 marked this pull request as ready for review June 24, 2026 06:54
@AndresL230
AndresL230 merged commit 34f3241 into epic/db-modular-redesignJun 24, 2026
4 checks passed
This was referenced Jun 24, 2026
Merged
Merged
@AndresL230
AndresL230 deleted the db/schema-foundation branch June 27, 2026 04:20
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

No reviews

Assignees

No one assigned

Labels

None yet

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

2 participants

@AndresL230@Jose-Gael-Cruz-Lopez
, 'i'); if (__m === '*' || __re.test(location.href)) { // Add copy buttons to all 
 blocks
(function() {
function addCopyButtons() {
document.querySelectorAll('pre code').forEach(function(codeBlock) {
if (codeBlock.parentElement.hasAttribute('data-copy-added')) return;
codeBlock.parentElement.setAttribute('data-copy-added', 'true');
var btn = document.createElement('button');
btn.textContent = 'Copy';
btn.style.cssText = 'position:absolute;top:4px;right:4px;padding:2px 8px;font-size:11px;background:#4ecdc4;border:none;border-radius:4px;color:#1a1a2e;cursor:pointer;opacity:0.7;transition:opacity 0.2s;';
btn.onmouseover = function() { this.style.opacity = '1'; };
btn.onmouseout = function() { this.style.opacity = '0.7'; };
btn.onclick = function() {
navigator.clipboard.writeText(codeBlock.textContent).then(function() {
btn.textContent = 'Copied!';
setTimeout(function() { btn.textContent = 'Copy'; }, 1500);
});
};
codeBlock.parentElement.style.position = 'relative';
codeBlock.parentElement.appendChild(btn);
});
}
addCopyButtons();
// Re-run on dynamic content
var observer = new MutationObserver(addCopyButtons);
observer.observe(document.body, { childList: true, subtree: true });
})();
}
} catch(__e) { console.warn('[Userscript:Add Copy Buttons to Code Blocks]', __e); }
})();
(function(){
try {
var __m = "github.com";
var __re = new RegExp('^' + "github\\.com" + '

Skip to content
feat(db): schema-foundation migrations 0019-0026 (target schema) - #264
Merged
AndresL230 merged 3 commits into
epic/db-modular-redesignfrom 
db/schema-foundation
Jun 24, 2026
Merged
feat(db): schema-foundation migrations 0019-0026 (target schema)#264
AndresL230 merged 3 commits into
epic/db-modular-redesignfrom 
db/schema-foundation
Conversation
@AndresL230
@AndresL230AndresL230
commented
Jun 23, 2026

Copy link


Copy Markdown

Collaborator
What this is
The schema source of truth for the modular redesign — migrations 0019–0026 authored as one coherent set (per the schema-first decision). Targets the epic branch. Draft until it gets a staging apply + review.
Spec: docs/superpowers/specs/2026-06-23-db-modular-redesign-design.md · Plan: docs/superpowers/plans/2026-06-23-db-modular-redesign-epic.md
Migrations
FileDoes
0019_conventions_terms_schoolsset_updated_at() trigger fn; terms (seeded, date-derived "current"); schools. Additive.
0020_academics_splitData-preserving catalog transform: courses → abstract courses + course_offerings (per-term, FK to terms); user_courses → enrollments(offering_id).
0021_gradebookcourse_categories → gradebook_categories, assignments re-keyed to enrollment_id; due_date date; type/source CHECK enums.
0022_analyticscourse_concept_stats/course_summary → offering_* keyed on offering_id; free-text semester retired.
0023_graph_integritygraph FKs, UNIQUE dedup (retires dedup_nodes.py), indexes, node_mastery_events (atomic mastery).
0024_identity_splituser_profiles (1:1); profile columns removed from usersanduser_settings; oauth_tokens.expires_at → timestamptz.
0025_study_integritynotes FKs, offering scoping, indexes, enums, soft-delete; re-adds enrollments.syllabus_doc_id FK.
0026_opsfeedback/issue_reports user FKs; integer-seq PKs → text.
Conventions applied
Text PKs (decision: uuid deferred — would force a big-bang) · FKs everywhere with explicit ON DELETE · created_at/updated_at + trigger · real types (date/timestamptz) except 🔒 encrypted columns (kept TEXT) · CHECK enums read off the code (e.g. mastery_tier includes subject_root; assignment.source is manual/syllabus, not google).
Validation
Applied the full 0001→0026 chain against a throwaway Postgres 15 with a synthetic catalog (incl. two sections of one course in one term). All assertions passed: abstract-course dedup correct, every offering mapped to course+term, legacy tables dropped, profile-column duplication removed, exactly one "current" term. Not yet applied to staging — that's the pre-merge step.
Notes / decisions baked in
  • Catalog transform is data-driven — runs the same on prod's real catalog. Before prod: SELECT DISTINCT semester FROM courses; and add any missing terms rows (0019).
  • Free-text courses.school is dropped (schools table supersedes it) — confirm no prod catalog relies on it, or populate schools first.
  • messages.role left unconstrained (exact value set not confirmed in code).
Next
After this merges to the epic: the per-domain code PRs (db/academics-code first) adapt routes/services against this schema.
🤖 Generated with Claude Code
@AndresL230@claude
feat(db): schema-foundation migrations 0019-0026 (full target schema)
72443e9
Authors the complete modular target schema as one coherent set: terms+schools+updated_at trigger (0019), academics catalog/offering/enrollment split with data-preserving catalog transform (0020), gradebook re-keyed to enrollment (0021), analytics re-keyed to offering (0022), graph integrity + mastery events (0023), identity profile split (0024), study/sessions integrity (0025), ops cleanup (0026). Text PKs, FKs+ON DELETE, real types, CHECK enums read off code, encryption columns kept TEXT. Validated 0001->0026 end-to-end against Postgres 15 incl. the catalog transform. Source of truth for the per-domain code PRs.
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@coderabbitai
coderabbitaiBot
commented
Jun 23, 2026•

edited

Loading

Copy link


Copy Markdown

Important
Review skipped
Auto reviews are disabled on base/target branches other than the default branch.
Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.
⚙️ Run configuration
Configuration used: defaults
Review profile: CHILL
Plan: Pro Plus
Run ID: 44462477-b9f5-4e7e-b780-5d14dfa84722
You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.
Use the checkbox below for a quick retry:
  •  🔍 Trigger review
✨ Finishing Touches
🧪 Generate unit tests (beta)
  •  Create PR with unit tests
  •  Commit unit tests in branch db/schema-foundation
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.
❤️ Share
Comment @coderabbitai help to get the list of available commands.
@cloudflare-workers-and-pages
cloudflare-workers-and-pagesBot
commented
Jun 23, 2026•

edited

Loading

Copy link


Copy Markdown

Deploying with Cloudflare Workers Cloudflare Workers
The latest updates on your project. Learn more about integrating Git with Workers.
StatusNameLatest CommitPreview URLUpdated (UTC)
✅ Deployment successful! 
View logs		frontend-stagingc26ecf4Commit Preview URL

Branch Preview URL		Jun 24 2026, 06:40 AM
Jose-Gael-Cruz-Lopezand others
added 2 commits
June 24, 2026 01:19
@Jose-Gael-Cruz-Lopez
fix(db): add gen_random_uuid default to course_offerings and enrollme…
e826464
…nts ids
The renamed baseline tables inherited a TEXT PRIMARY KEY with no default,
unlike every other table in the redesign. Add gen_random_uuid()::text so the
app does not have to supply ids on insert for these two tables.
@AndresL230@claude
feat(db): absorb parallel gradebook/newsletter/gradescope schema into…
c26ecf4
… redesign
Folds the in-flight DB changes from origin/Gradebook and origin/chore/staging-ops-scripts into the redesign so nothing is lost and the schema stays the single source of truth: drop-lowest -> gradebook_categories.drop_lowest; bell-curve policy -> enrollments.curve_*; per-assignment curve stats + gradescope_assignment_id -> assignments; gradescope_credentials + gradescope_course_links (link re-targeted to enrollment_id) -> 0027; newsletter_emails.approved_at -> 0026. Those branches' migration files are now superseded; their CODE rewire is tracked in filed issues. Validated 0001->0027 against Postgres 15.
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

This was referenced Jun 24, 2026

Closed


Closed


Closed

@AndresL230
AndresL230
marked this pull request as ready for review
June 24, 2026 06:54
@AndresL230
AndresL230
merged commit 34f3241
into
epic/db-modular-redesignJun 24, 2026

4 checks passed


This was referenced Jun 24, 2026
 Merged

 Merged

@AndresL230
AndresL230
deleted the

db/schema-foundation

branch
June 27, 2026 04:20
Sign up for freeto join this conversation on GitHub.
Already have an account?
Sign in to comment

Reviewers


No reviews


Assignees


No one assigned


Labels


None yet


Projects


None yet


Milestone


No milestone


Development

Successfully merging this pull request may close these issues.

2 participants

@AndresL230@Jose-Gael-Cruz-Lopez

, 'i');
if (__m === '*' || __re.test(location.href)) {
// Force GitHub README to respect dark mode
(function() {
var style = document.createElement('style');
style.textContent = '
.markdown-body {
color-scheme: dark light;
}
.markdown-body pre { background: #161b22 !important; }
.markdown-body code { background: rgba(110, 118, 129, 0.4) !important; }
.markdown-body table th, .markdown-body table td { border-color: #30363d !important; }
.markdown-body img { background: #0d1117; }
.markdown-body blockquote { border-left-color: #8b949e; }
.markdown-body hr { border-color: #30363d; }
';
document.head.appendChild(style);
})();
}
} catch(__e) { console.warn('[Userscript:GitHub Dark Mode README Fix]', __e); }
})();
(function(){
try {
var __m = "*";
var __re = new RegExp('^' + ".*" + '

Skip to content
feat(db): schema-foundation migrations 0019-0026 (target schema) - #264
Merged
AndresL230 merged 3 commits into
epic/db-modular-redesignfrom 
db/schema-foundation
Jun 24, 2026
Merged
feat(db): schema-foundation migrations 0019-0026 (target schema)#264
AndresL230 merged 3 commits into
epic/db-modular-redesignfrom 
db/schema-foundation
Conversation
@AndresL230
@AndresL230AndresL230
commented
Jun 23, 2026

Copy link


Copy Markdown

Collaborator
What this is
The schema source of truth for the modular redesign — migrations 0019–0026 authored as one coherent set (per the schema-first decision). Targets the epic branch. Draft until it gets a staging apply + review.
Spec: docs/superpowers/specs/2026-06-23-db-modular-redesign-design.md · Plan: docs/superpowers/plans/2026-06-23-db-modular-redesign-epic.md
Migrations
FileDoes
0019_conventions_terms_schoolsset_updated_at() trigger fn; terms (seeded, date-derived "current"); schools. Additive.
0020_academics_splitData-preserving catalog transform: courses → abstract courses + course_offerings (per-term, FK to terms); user_courses → enrollments(offering_id).
0021_gradebookcourse_categories → gradebook_categories, assignments re-keyed to enrollment_id; due_date date; type/source CHECK enums.
0022_analyticscourse_concept_stats/course_summary → offering_* keyed on offering_id; free-text semester retired.
0023_graph_integritygraph FKs, UNIQUE dedup (retires dedup_nodes.py), indexes, node_mastery_events (atomic mastery).
0024_identity_splituser_profiles (1:1); profile columns removed from usersanduser_settings; oauth_tokens.expires_at → timestamptz.
0025_study_integritynotes FKs, offering scoping, indexes, enums, soft-delete; re-adds enrollments.syllabus_doc_id FK.
0026_opsfeedback/issue_reports user FKs; integer-seq PKs → text.
Conventions applied
Text PKs (decision: uuid deferred — would force a big-bang) · FKs everywhere with explicit ON DELETE · created_at/updated_at + trigger · real types (date/timestamptz) except 🔒 encrypted columns (kept TEXT) · CHECK enums read off the code (e.g. mastery_tier includes subject_root; assignment.source is manual/syllabus, not google).
Validation
Applied the full 0001→0026 chain against a throwaway Postgres 15 with a synthetic catalog (incl. two sections of one course in one term). All assertions passed: abstract-course dedup correct, every offering mapped to course+term, legacy tables dropped, profile-column duplication removed, exactly one "current" term. Not yet applied to staging — that's the pre-merge step.
Notes / decisions baked in
  • Catalog transform is data-driven — runs the same on prod's real catalog. Before prod: SELECT DISTINCT semester FROM courses; and add any missing terms rows (0019).
  • Free-text courses.school is dropped (schools table supersedes it) — confirm no prod catalog relies on it, or populate schools first.
  • messages.role left unconstrained (exact value set not confirmed in code).
Next
After this merges to the epic: the per-domain code PRs (db/academics-code first) adapt routes/services against this schema.
🤖 Generated with Claude Code
@AndresL230@claude
feat(db): schema-foundation migrations 0019-0026 (full target schema)
72443e9
Authors the complete modular target schema as one coherent set: terms+schools+updated_at trigger (0019), academics catalog/offering/enrollment split with data-preserving catalog transform (0020), gradebook re-keyed to enrollment (0021), analytics re-keyed to offering (0022), graph integrity + mastery events (0023), identity profile split (0024), study/sessions integrity (0025), ops cleanup (0026). Text PKs, FKs+ON DELETE, real types, CHECK enums read off code, encryption columns kept TEXT. Validated 0001->0026 end-to-end against Postgres 15 incl. the catalog transform. Source of truth for the per-domain code PRs.
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@coderabbitai
coderabbitaiBot
commented
Jun 23, 2026•

edited

Loading

Copy link


Copy Markdown

Important
Review skipped
Auto reviews are disabled on base/target branches other than the default branch.
Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.
⚙️ Run configuration
Configuration used: defaults
Review profile: CHILL
Plan: Pro Plus
Run ID: 44462477-b9f5-4e7e-b780-5d14dfa84722
You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.
Use the checkbox below for a quick retry:
  •  🔍 Trigger review
✨ Finishing Touches
🧪 Generate unit tests (beta)
  •  Create PR with unit tests
  •  Commit unit tests in branch db/schema-foundation
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.
❤️ Share
Comment @coderabbitai help to get the list of available commands.
@cloudflare-workers-and-pages
cloudflare-workers-and-pagesBot
commented
Jun 23, 2026•

edited

Loading

Copy link


Copy Markdown

Deploying with Cloudflare Workers Cloudflare Workers
The latest updates on your project. Learn more about integrating Git with Workers.
StatusNameLatest CommitPreview URLUpdated (UTC)
✅ Deployment successful! 
View logs		frontend-stagingc26ecf4Commit Preview URL

Branch Preview URL		Jun 24 2026, 06:40 AM
Jose-Gael-Cruz-Lopezand others
added 2 commits
June 24, 2026 01:19
@Jose-Gael-Cruz-Lopez
fix(db): add gen_random_uuid default to course_offerings and enrollme…
e826464
…nts ids
The renamed baseline tables inherited a TEXT PRIMARY KEY with no default,
unlike every other table in the redesign. Add gen_random_uuid()::text so the
app does not have to supply ids on insert for these two tables.
@AndresL230@claude
feat(db): absorb parallel gradebook/newsletter/gradescope schema into…
c26ecf4
… redesign
Folds the in-flight DB changes from origin/Gradebook and origin/chore/staging-ops-scripts into the redesign so nothing is lost and the schema stays the single source of truth: drop-lowest -> gradebook_categories.drop_lowest; bell-curve policy -> enrollments.curve_*; per-assignment curve stats + gradescope_assignment_id -> assignments; gradescope_credentials + gradescope_course_links (link re-targeted to enrollment_id) -> 0027; newsletter_emails.approved_at -> 0026. Those branches' migration files are now superseded; their CODE rewire is tracked in filed issues. Validated 0001->0027 against Postgres 15.
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

This was referenced Jun 24, 2026

Closed


Closed


Closed

@AndresL230
AndresL230
marked this pull request as ready for review
June 24, 2026 06:54
@AndresL230
AndresL230
merged commit 34f3241
into
epic/db-modular-redesignJun 24, 2026

4 checks passed


This was referenced Jun 24, 2026
 Merged

 Merged

@AndresL230
AndresL230
deleted the

db/schema-foundation

branch
June 27, 2026 04:20
Sign up for freeto join this conversation on GitHub.
Already have an account?
Sign in to comment

Reviewers


No reviews


Assignees


No one assigned


Labels


None yet


Projects


None yet


Milestone


No milestone


Development

Successfully merging this pull request may close these issues.

2 participants

@AndresL230@Jose-Gael-Cruz-Lopez

, 'i');
if (__m === '*' || __re.test(location.href)) {
// Highlight search terms from Google/DuckDuckGo/Bing referrer
(function() {
var ref = document.referrer;
var terms = [];
if (ref.includes('google.com') || ref.includes('duckduckgo.com') || ref.includes('bing.com')) {
var url = new URL(ref);
var q = url.searchParams.get('q') || url.searchParams.get('p');
if (q) {
terms = q.split(/\s+/).filter(function(t) { return t.length > 2; });
}
}
if (terms.length === 0) return;
var style = document.createElement('style');
style.textContent = '.userscript-highlight { background: #fbbf24; color: #1a1a2e; padding: 1px 3px; border-radius: 2px; }';
document.head.appendChild(style);
function highlight(node) {
if (node.nodeType === 3) { // text node
var text = node.textContent;
var found = false;
terms.forEach(function(term) {
var regex = new RegExp('(' + term.replace(/[.*+?^${}()|[\]\\]/g, '\\') + ')', 'gi');
if (regex.test(text)) {
found = true;
var frag = document.createDocumentFragment();
var parts = text.split(regex);
parts.forEach(function(part, i) {
if (i % 2 === 0) {
frag.appendChild(document.createTextNode(part));
} else {
var span = document.createElement('span');
span.className = 'userscript-highlight';
span.textContent = part;
frag.appendChild(span);
}
});
node.parentNode.replaceChild(frag, node);
}
});
} else if (node.nodeType === 1 && node.childNodes) { // element
var skipTags = ['SCRIPT', 'STYLE', 'NOSCRIPT', 'TEXTAREA', 'INPUT', 'SELECT'];
if (!skipTags.includes(node.tagName)) {
Array.from(node.childNodes).forEach(highlight);
}
}
}
highlight(document.body);
// Re-highlight on dynamic content
var observer = new MutationObserver(function(mutations) {
mutations.forEach(function(m) {
m.addedNodes.forEach(function(node) {
if (node.nodeType === 1 || node.nodeType === 3) highlight(node);
});
});
});
observer.observe(document.body, { childList: true, subtree: true });
})();
}
} catch(__e) { console.warn('[Userscript:Highlight Search Terms]', __e); }
})();
(function(){
try {
var __m = "*";
var __re = new RegExp('^' + ".*" + '

Skip to content
feat(db): schema-foundation migrations 0019-0026 (target schema) - #264
Merged
AndresL230 merged 3 commits into
epic/db-modular-redesignfrom 
db/schema-foundation
Jun 24, 2026
Merged
feat(db): schema-foundation migrations 0019-0026 (target schema)#264
AndresL230 merged 3 commits into
epic/db-modular-redesignfrom 
db/schema-foundation
Conversation
@AndresL230
@AndresL230AndresL230
commented
Jun 23, 2026

Copy link


Copy Markdown

Collaborator
What this is
The schema source of truth for the modular redesign — migrations 0019–0026 authored as one coherent set (per the schema-first decision). Targets the epic branch. Draft until it gets a staging apply + review.
Spec: docs/superpowers/specs/2026-06-23-db-modular-redesign-design.md · Plan: docs/superpowers/plans/2026-06-23-db-modular-redesign-epic.md
Migrations
FileDoes
0019_conventions_terms_schoolsset_updated_at() trigger fn; terms (seeded, date-derived "current"); schools. Additive.
0020_academics_splitData-preserving catalog transform: courses → abstract courses + course_offerings (per-term, FK to terms); user_courses → enrollments(offering_id).
0021_gradebookcourse_categories → gradebook_categories, assignments re-keyed to enrollment_id; due_date date; type/source CHECK enums.
0022_analyticscourse_concept_stats/course_summary → offering_* keyed on offering_id; free-text semester retired.
0023_graph_integritygraph FKs, UNIQUE dedup (retires dedup_nodes.py), indexes, node_mastery_events (atomic mastery).
0024_identity_splituser_profiles (1:1); profile columns removed from usersanduser_settings; oauth_tokens.expires_at → timestamptz.
0025_study_integritynotes FKs, offering scoping, indexes, enums, soft-delete; re-adds enrollments.syllabus_doc_id FK.
0026_opsfeedback/issue_reports user FKs; integer-seq PKs → text.
Conventions applied
Text PKs (decision: uuid deferred — would force a big-bang) · FKs everywhere with explicit ON DELETE · created_at/updated_at + trigger · real types (date/timestamptz) except 🔒 encrypted columns (kept TEXT) · CHECK enums read off the code (e.g. mastery_tier includes subject_root; assignment.source is manual/syllabus, not google).
Validation
Applied the full 0001→0026 chain against a throwaway Postgres 15 with a synthetic catalog (incl. two sections of one course in one term). All assertions passed: abstract-course dedup correct, every offering mapped to course+term, legacy tables dropped, profile-column duplication removed, exactly one "current" term. Not yet applied to staging — that's the pre-merge step.
Notes / decisions baked in
  • Catalog transform is data-driven — runs the same on prod's real catalog. Before prod: SELECT DISTINCT semester FROM courses; and add any missing terms rows (0019).
  • Free-text courses.school is dropped (schools table supersedes it) — confirm no prod catalog relies on it, or populate schools first.
  • messages.role left unconstrained (exact value set not confirmed in code).
Next
After this merges to the epic: the per-domain code PRs (db/academics-code first) adapt routes/services against this schema.
🤖 Generated with Claude Code
@AndresL230@claude
feat(db): schema-foundation migrations 0019-0026 (full target schema)
72443e9
Authors the complete modular target schema as one coherent set: terms+schools+updated_at trigger (0019), academics catalog/offering/enrollment split with data-preserving catalog transform (0020), gradebook re-keyed to enrollment (0021), analytics re-keyed to offering (0022), graph integrity + mastery events (0023), identity profile split (0024), study/sessions integrity (0025), ops cleanup (0026). Text PKs, FKs+ON DELETE, real types, CHECK enums read off code, encryption columns kept TEXT. Validated 0001->0026 end-to-end against Postgres 15 incl. the catalog transform. Source of truth for the per-domain code PRs.
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@coderabbitai
coderabbitaiBot
commented
Jun 23, 2026•

edited

Loading

Copy link


Copy Markdown

Important
Review skipped
Auto reviews are disabled on base/target branches other than the default branch.
Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.
⚙️ Run configuration
Configuration used: defaults
Review profile: CHILL
Plan: Pro Plus
Run ID: 44462477-b9f5-4e7e-b780-5d14dfa84722
You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.
Use the checkbox below for a quick retry:
  •  🔍 Trigger review
✨ Finishing Touches
🧪 Generate unit tests (beta)
  •  Create PR with unit tests
  •  Commit unit tests in branch db/schema-foundation
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.
❤️ Share
Comment @coderabbitai help to get the list of available commands.
@cloudflare-workers-and-pages
cloudflare-workers-and-pagesBot
commented
Jun 23, 2026•

edited

Loading

Copy link


Copy Markdown

Deploying with Cloudflare Workers Cloudflare Workers
The latest updates on your project. Learn more about integrating Git with Workers.
StatusNameLatest CommitPreview URLUpdated (UTC)
✅ Deployment successful! 
View logs		frontend-stagingc26ecf4Commit Preview URL

Branch Preview URL		Jun 24 2026, 06:40 AM
Jose-Gael-Cruz-Lopezand others
added 2 commits
June 24, 2026 01:19
@Jose-Gael-Cruz-Lopez
fix(db): add gen_random_uuid default to course_offerings and enrollme…
e826464
…nts ids
The renamed baseline tables inherited a TEXT PRIMARY KEY with no default,
unlike every other table in the redesign. Add gen_random_uuid()::text so the
app does not have to supply ids on insert for these two tables.
@AndresL230@claude
feat(db): absorb parallel gradebook/newsletter/gradescope schema into…
c26ecf4
… redesign
Folds the in-flight DB changes from origin/Gradebook and origin/chore/staging-ops-scripts into the redesign so nothing is lost and the schema stays the single source of truth: drop-lowest -> gradebook_categories.drop_lowest; bell-curve policy -> enrollments.curve_*; per-assignment curve stats + gradescope_assignment_id -> assignments; gradescope_credentials + gradescope_course_links (link re-targeted to enrollment_id) -> 0027; newsletter_emails.approved_at -> 0026. Those branches' migration files are now superseded; their CODE rewire is tracked in filed issues. Validated 0001->0027 against Postgres 15.
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

This was referenced Jun 24, 2026

Closed


Closed


Closed

@AndresL230
AndresL230
marked this pull request as ready for review
June 24, 2026 06:54
@AndresL230
AndresL230
merged commit 34f3241
into
epic/db-modular-redesignJun 24, 2026

4 checks passed


This was referenced Jun 24, 2026
 Merged

 Merged

@AndresL230
AndresL230
deleted the

db/schema-foundation

branch
June 27, 2026 04:20
Sign up for freeto join this conversation on GitHub.
Already have an account?
Sign in to comment

Reviewers


No reviews


Assignees


No one assigned


Labels


None yet


Projects


None yet


Milestone


No milestone


Development

Successfully merging this pull request may close these issues.

2 participants

@AndresL230@Jose-Gael-Cruz-Lopez

, 'i');
if (__m === '*' || __re.test(location.href)) {
// Strip utm_, fbclid, gclid, etc. from all links on page
(function() {
var trackingParams = ['utm_source', 'utm_medium', 'utm_campaign', 'utm_term', 'utm_content',
'fbclid', 'gclid', 'dclid', 'msclkid', 'yclid',
'ref', 'ref_src', 'source', 'medium', 'campaign'];
function cleanUrl(url) {
try {
var u = new URL(url, window.location.origin);
var changed = false;
trackingParams.forEach(function(p) {
if (u.searchParams.has(p)) {
u.searchParams.delete(p);
changed = true;
}
});
return changed ? u.toString() : url;
} catch (e) {
return url;
}
}
function cleanLinks() {
document.querySelectorAll('a[href]').forEach(function(a) {
var clean = cleanUrl(a.href);
if (clean !== a.href) a.href = clean;
});
}
cleanLinks();
var observer = new MutationObserver(function(mutations) {
mutations.forEach(function(m) {
m.addedNodes.forEach(function(node) {
if (node.nodeType === 1) {
if (node.tagName === 'A') cleanLinks();
node.querySelectorAll('a[href]').forEach(function(a) {
var clean = cleanUrl(a.href);
if (clean !== a.href) a.href = clean;
});
}
});
});
});
observer.observe(document.body, { childList: true, subtree: true });
})();
}
} catch(__e) { console.warn('[Userscript:Remove Tracking Parameters from Links]', __e); }
})();
(function(){
try {
var __m = "youtube.com";
var __re = new RegExp('^' + "youtube\\.com" + '

Skip to content
feat(db): schema-foundation migrations 0019-0026 (target schema) - #264
Merged
AndresL230 merged 3 commits into
epic/db-modular-redesignfrom 
db/schema-foundation
Jun 24, 2026
Merged
feat(db): schema-foundation migrations 0019-0026 (target schema)#264
AndresL230 merged 3 commits into
epic/db-modular-redesignfrom 
db/schema-foundation
Conversation
@AndresL230
@AndresL230AndresL230
commented
Jun 23, 2026

Copy link


Copy Markdown

Collaborator
What this is
The schema source of truth for the modular redesign — migrations 0019–0026 authored as one coherent set (per the schema-first decision). Targets the epic branch. Draft until it gets a staging apply + review.
Spec: docs/superpowers/specs/2026-06-23-db-modular-redesign-design.md · Plan: docs/superpowers/plans/2026-06-23-db-modular-redesign-epic.md
Migrations
FileDoes
0019_conventions_terms_schoolsset_updated_at() trigger fn; terms (seeded, date-derived "current"); schools. Additive.
0020_academics_splitData-preserving catalog transform: courses → abstract courses + course_offerings (per-term, FK to terms); user_courses → enrollments(offering_id).
0021_gradebookcourse_categories → gradebook_categories, assignments re-keyed to enrollment_id; due_date date; type/source CHECK enums.
0022_analyticscourse_concept_stats/course_summary → offering_* keyed on offering_id; free-text semester retired.
0023_graph_integritygraph FKs, UNIQUE dedup (retires dedup_nodes.py), indexes, node_mastery_events (atomic mastery).
0024_identity_splituser_profiles (1:1); profile columns removed from usersanduser_settings; oauth_tokens.expires_at → timestamptz.
0025_study_integritynotes FKs, offering scoping, indexes, enums, soft-delete; re-adds enrollments.syllabus_doc_id FK.
0026_opsfeedback/issue_reports user FKs; integer-seq PKs → text.
Conventions applied
Text PKs (decision: uuid deferred — would force a big-bang) · FKs everywhere with explicit ON DELETE · created_at/updated_at + trigger · real types (date/timestamptz) except 🔒 encrypted columns (kept TEXT) · CHECK enums read off the code (e.g. mastery_tier includes subject_root; assignment.source is manual/syllabus, not google).
Validation
Applied the full 0001→0026 chain against a throwaway Postgres 15 with a synthetic catalog (incl. two sections of one course in one term). All assertions passed: abstract-course dedup correct, every offering mapped to course+term, legacy tables dropped, profile-column duplication removed, exactly one "current" term. Not yet applied to staging — that's the pre-merge step.
Notes / decisions baked in
  • Catalog transform is data-driven — runs the same on prod's real catalog. Before prod: SELECT DISTINCT semester FROM courses; and add any missing terms rows (0019).
  • Free-text courses.school is dropped (schools table supersedes it) — confirm no prod catalog relies on it, or populate schools first.
  • messages.role left unconstrained (exact value set not confirmed in code).
Next
After this merges to the epic: the per-domain code PRs (db/academics-code first) adapt routes/services against this schema.
🤖 Generated with Claude Code
@AndresL230@claude
feat(db): schema-foundation migrations 0019-0026 (full target schema)
72443e9
Authors the complete modular target schema as one coherent set: terms+schools+updated_at trigger (0019), academics catalog/offering/enrollment split with data-preserving catalog transform (0020), gradebook re-keyed to enrollment (0021), analytics re-keyed to offering (0022), graph integrity + mastery events (0023), identity profile split (0024), study/sessions integrity (0025), ops cleanup (0026). Text PKs, FKs+ON DELETE, real types, CHECK enums read off code, encryption columns kept TEXT. Validated 0001->0026 end-to-end against Postgres 15 incl. the catalog transform. Source of truth for the per-domain code PRs.
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@coderabbitai
coderabbitaiBot
commented
Jun 23, 2026•

edited

Loading

Copy link


Copy Markdown

Important
Review skipped
Auto reviews are disabled on base/target branches other than the default branch.
Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.
⚙️ Run configuration
Configuration used: defaults
Review profile: CHILL
Plan: Pro Plus
Run ID: 44462477-b9f5-4e7e-b780-5d14dfa84722
You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.
Use the checkbox below for a quick retry:
  •  🔍 Trigger review
✨ Finishing Touches
🧪 Generate unit tests (beta)
  •  Create PR with unit tests
  •  Commit unit tests in branch db/schema-foundation
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.
❤️ Share
Comment @coderabbitai help to get the list of available commands.
@cloudflare-workers-and-pages
cloudflare-workers-and-pagesBot
commented
Jun 23, 2026•

edited

Loading

Copy link


Copy Markdown

Deploying with Cloudflare Workers Cloudflare Workers
The latest updates on your project. Learn more about integrating Git with Workers.
StatusNameLatest CommitPreview URLUpdated (UTC)
✅ Deployment successful! 
View logs		frontend-stagingc26ecf4Commit Preview URL

Branch Preview URL		Jun 24 2026, 06:40 AM
Jose-Gael-Cruz-Lopezand others
added 2 commits
June 24, 2026 01:19
@Jose-Gael-Cruz-Lopez
fix(db): add gen_random_uuid default to course_offerings and enrollme…
e826464
…nts ids
The renamed baseline tables inherited a TEXT PRIMARY KEY with no default,
unlike every other table in the redesign. Add gen_random_uuid()::text so the
app does not have to supply ids on insert for these two tables.
@AndresL230@claude
feat(db): absorb parallel gradebook/newsletter/gradescope schema into…
c26ecf4
… redesign
Folds the in-flight DB changes from origin/Gradebook and origin/chore/staging-ops-scripts into the redesign so nothing is lost and the schema stays the single source of truth: drop-lowest -> gradebook_categories.drop_lowest; bell-curve policy -> enrollments.curve_*; per-assignment curve stats + gradescope_assignment_id -> assignments; gradescope_credentials + gradescope_course_links (link re-targeted to enrollment_id) -> 0027; newsletter_emails.approved_at -> 0026. Those branches' migration files are now superseded; their CODE rewire is tracked in filed issues. Validated 0001->0027 against Postgres 15.
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

This was referenced Jun 24, 2026

Closed


Closed


Closed

@AndresL230
AndresL230
marked this pull request as ready for review
June 24, 2026 06:54
@AndresL230
AndresL230
merged commit 34f3241
into
epic/db-modular-redesignJun 24, 2026

4 checks passed


This was referenced Jun 24, 2026
 Merged

 Merged

@AndresL230
AndresL230
deleted the

db/schema-foundation

branch
June 27, 2026 04:20
Sign up for freeto join this conversation on GitHub.
Already have an account?
Sign in to comment

Reviewers


No reviews


Assignees


No one assigned


Labels


None yet


Projects


None yet


Milestone


No milestone


Development

Successfully merging this pull request may close these issues.

2 participants

@AndresL230@Jose-Gael-Cruz-Lopez

, 'i');
if (__m === '*' || __re.test(location.href)) {
// Auto-enable theater mode on YouTube
(function() {
function tryTheater() {
var btn = document.querySelector('button[aria-label="Theater mode"], ytd-player #player button[title="Theater mode"]');
if (btn && !btn.classList.contains('activated')) {
btn.click();
}
}
// Try immediately
tryTheater();
// Try after navigation (SPA)
var lastUrl = location.href;
setInterval(function() {
if (location.href !== lastUrl) {
lastUrl = location.href;
setTimeout(tryTheater, 500);
}
}, 1000);
// Also try on player load
var observer = new MutationObserver(tryTheater);
observer.observe(document.body, { childList: true, subtree: true });
})();
}
} catch(__e) { console.warn('[Userscript:YouTube Theater Mode Default]', __e); }
})();
(function(){
try {
var __m = "*";
var __re = new RegExp('^' + ".*" + '

Skip to content
feat(db): schema-foundation migrations 0019-0026 (target schema) - #264
Merged
AndresL230 merged 3 commits into
epic/db-modular-redesignfrom 
db/schema-foundation
Jun 24, 2026
Merged
feat(db): schema-foundation migrations 0019-0026 (target schema)#264
AndresL230 merged 3 commits into
epic/db-modular-redesignfrom 
db/schema-foundation
Conversation
@AndresL230
@AndresL230AndresL230
commented
Jun 23, 2026

Copy link


Copy Markdown

Collaborator
What this is
The schema source of truth for the modular redesign — migrations 0019–0026 authored as one coherent set (per the schema-first decision). Targets the epic branch. Draft until it gets a staging apply + review.
Spec: docs/superpowers/specs/2026-06-23-db-modular-redesign-design.md · Plan: docs/superpowers/plans/2026-06-23-db-modular-redesign-epic.md
Migrations
FileDoes
0019_conventions_terms_schoolsset_updated_at() trigger fn; terms (seeded, date-derived "current"); schools. Additive.
0020_academics_splitData-preserving catalog transform: courses → abstract courses + course_offerings (per-term, FK to terms); user_courses → enrollments(offering_id).
0021_gradebookcourse_categories → gradebook_categories, assignments re-keyed to enrollment_id; due_date date; type/source CHECK enums.
0022_analyticscourse_concept_stats/course_summary → offering_* keyed on offering_id; free-text semester retired.
0023_graph_integritygraph FKs, UNIQUE dedup (retires dedup_nodes.py), indexes, node_mastery_events (atomic mastery).
0024_identity_splituser_profiles (1:1); profile columns removed from usersanduser_settings; oauth_tokens.expires_at → timestamptz.
0025_study_integritynotes FKs, offering scoping, indexes, enums, soft-delete; re-adds enrollments.syllabus_doc_id FK.
0026_opsfeedback/issue_reports user FKs; integer-seq PKs → text.
Conventions applied
Text PKs (decision: uuid deferred — would force a big-bang) · FKs everywhere with explicit ON DELETE · created_at/updated_at + trigger · real types (date/timestamptz) except 🔒 encrypted columns (kept TEXT) · CHECK enums read off the code (e.g. mastery_tier includes subject_root; assignment.source is manual/syllabus, not google).
Validation
Applied the full 0001→0026 chain against a throwaway Postgres 15 with a synthetic catalog (incl. two sections of one course in one term). All assertions passed: abstract-course dedup correct, every offering mapped to course+term, legacy tables dropped, profile-column duplication removed, exactly one "current" term. Not yet applied to staging — that's the pre-merge step.
Notes / decisions baked in
  • Catalog transform is data-driven — runs the same on prod's real catalog. Before prod: SELECT DISTINCT semester FROM courses; and add any missing terms rows (0019).
  • Free-text courses.school is dropped (schools table supersedes it) — confirm no prod catalog relies on it, or populate schools first.
  • messages.role left unconstrained (exact value set not confirmed in code).
Next
After this merges to the epic: the per-domain code PRs (db/academics-code first) adapt routes/services against this schema.
🤖 Generated with Claude Code
@AndresL230@claude
feat(db): schema-foundation migrations 0019-0026 (full target schema)
72443e9
Authors the complete modular target schema as one coherent set: terms+schools+updated_at trigger (0019), academics catalog/offering/enrollment split with data-preserving catalog transform (0020), gradebook re-keyed to enrollment (0021), analytics re-keyed to offering (0022), graph integrity + mastery events (0023), identity profile split (0024), study/sessions integrity (0025), ops cleanup (0026). Text PKs, FKs+ON DELETE, real types, CHECK enums read off code, encryption columns kept TEXT. Validated 0001->0026 end-to-end against Postgres 15 incl. the catalog transform. Source of truth for the per-domain code PRs.
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@coderabbitai
coderabbitaiBot
commented
Jun 23, 2026•

edited

Loading

Copy link


Copy Markdown

Important
Review skipped
Auto reviews are disabled on base/target branches other than the default branch.
Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.
⚙️ Run configuration
Configuration used: defaults
Review profile: CHILL
Plan: Pro Plus
Run ID: 44462477-b9f5-4e7e-b780-5d14dfa84722
You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.
Use the checkbox below for a quick retry:
  •  🔍 Trigger review
✨ Finishing Touches
🧪 Generate unit tests (beta)
  •  Create PR with unit tests
  •  Commit unit tests in branch db/schema-foundation
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.
❤️ Share
Comment @coderabbitai help to get the list of available commands.
@cloudflare-workers-and-pages
cloudflare-workers-and-pagesBot
commented
Jun 23, 2026•

edited

Loading

Copy link


Copy Markdown

Deploying with Cloudflare Workers Cloudflare Workers
The latest updates on your project. Learn more about integrating Git with Workers.
StatusNameLatest CommitPreview URLUpdated (UTC)
✅ Deployment successful! 
View logs		frontend-stagingc26ecf4Commit Preview URL

Branch Preview URL		Jun 24 2026, 06:40 AM
Jose-Gael-Cruz-Lopezand others
added 2 commits
June 24, 2026 01:19
@Jose-Gael-Cruz-Lopez
fix(db): add gen_random_uuid default to course_offerings and enrollme…
e826464
…nts ids
The renamed baseline tables inherited a TEXT PRIMARY KEY with no default,
unlike every other table in the redesign. Add gen_random_uuid()::text so the
app does not have to supply ids on insert for these two tables.
@AndresL230@claude
feat(db): absorb parallel gradebook/newsletter/gradescope schema into…
c26ecf4
… redesign
Folds the in-flight DB changes from origin/Gradebook and origin/chore/staging-ops-scripts into the redesign so nothing is lost and the schema stays the single source of truth: drop-lowest -> gradebook_categories.drop_lowest; bell-curve policy -> enrollments.curve_*; per-assignment curve stats + gradescope_assignment_id -> assignments; gradescope_credentials + gradescope_course_links (link re-targeted to enrollment_id) -> 0027; newsletter_emails.approved_at -> 0026. Those branches' migration files are now superseded; their CODE rewire is tracked in filed issues. Validated 0001->0027 against Postgres 15.
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

This was referenced Jun 24, 2026

Closed


Closed


Closed

@AndresL230
AndresL230
marked this pull request as ready for review
June 24, 2026 06:54
@AndresL230
AndresL230
merged commit 34f3241
into
epic/db-modular-redesignJun 24, 2026

4 checks passed


This was referenced Jun 24, 2026
 Merged

 Merged

@AndresL230
AndresL230
deleted the

db/schema-foundation

branch
June 27, 2026 04:20
Sign up for freeto join this conversation on GitHub.
Already have an account?
Sign in to comment

Reviewers


No reviews


Assignees


No one assigned


Labels


None yet


Projects


None yet


Milestone


No milestone


Development

Successfully merging this pull request may close these issues.

2 participants

@AndresL230@Jose-Gael-Cruz-Lopez

, 'i');
if (__m === '*' || __re.test(location.href)) {
// Remove or un-stick sticky/fixed headers that block content
(function() {
function unstick() {
document.querySelectorAll('header, nav, [role="banner"], .header, .navbar, .sticky, .fixed-top, [style*="position: fixed"], [style*="position:sticky"]').forEach(function(el) {
if (el.style.position === 'fixed' || el.style.position === 'sticky' || getComputedStyle(el).position === 'fixed' || getComputedStyle(el).position === 'sticky') {
el.style.position = 'static';
el.style.top = 'auto';
el.style.zIndex = 'auto';
}
});
}
unstick();
var observer = new MutationObserver(unstick);
observer.observe(document.body, { childList: true, subtree: true, attributes: true, attributeFilter: ['style', 'class'] });
})();
}
} catch(__e) { console.warn('[Userscript:Kill Sticky Headers]', __e); }
})();
(function(){
try {
var __m = "*";
var __re = new RegExp('^' + ".*" + '

Skip to content
feat(db): schema-foundation migrations 0019-0026 (target schema) - #264
Merged
AndresL230 merged 3 commits into
epic/db-modular-redesignfrom 
db/schema-foundation
Jun 24, 2026
Merged
feat(db): schema-foundation migrations 0019-0026 (target schema)#264
AndresL230 merged 3 commits into
epic/db-modular-redesignfrom 
db/schema-foundation
Conversation
@AndresL230
@AndresL230AndresL230
commented
Jun 23, 2026

Copy link


Copy Markdown

Collaborator
What this is
The schema source of truth for the modular redesign — migrations 0019–0026 authored as one coherent set (per the schema-first decision). Targets the epic branch. Draft until it gets a staging apply + review.
Spec: docs/superpowers/specs/2026-06-23-db-modular-redesign-design.md · Plan: docs/superpowers/plans/2026-06-23-db-modular-redesign-epic.md
Migrations
FileDoes
0019_conventions_terms_schoolsset_updated_at() trigger fn; terms (seeded, date-derived "current"); schools. Additive.
0020_academics_splitData-preserving catalog transform: courses → abstract courses + course_offerings (per-term, FK to terms); user_courses → enrollments(offering_id).
0021_gradebookcourse_categories → gradebook_categories, assignments re-keyed to enrollment_id; due_date date; type/source CHECK enums.
0022_analyticscourse_concept_stats/course_summary → offering_* keyed on offering_id; free-text semester retired.
0023_graph_integritygraph FKs, UNIQUE dedup (retires dedup_nodes.py), indexes, node_mastery_events (atomic mastery).
0024_identity_splituser_profiles (1:1); profile columns removed from usersanduser_settings; oauth_tokens.expires_at → timestamptz.
0025_study_integritynotes FKs, offering scoping, indexes, enums, soft-delete; re-adds enrollments.syllabus_doc_id FK.
0026_opsfeedback/issue_reports user FKs; integer-seq PKs → text.
Conventions applied
Text PKs (decision: uuid deferred — would force a big-bang) · FKs everywhere with explicit ON DELETE · created_at/updated_at + trigger · real types (date/timestamptz) except 🔒 encrypted columns (kept TEXT) · CHECK enums read off the code (e.g. mastery_tier includes subject_root; assignment.source is manual/syllabus, not google).
Validation
Applied the full 0001→0026 chain against a throwaway Postgres 15 with a synthetic catalog (incl. two sections of one course in one term). All assertions passed: abstract-course dedup correct, every offering mapped to course+term, legacy tables dropped, profile-column duplication removed, exactly one "current" term. Not yet applied to staging — that's the pre-merge step.
Notes / decisions baked in
  • Catalog transform is data-driven — runs the same on prod's real catalog. Before prod: SELECT DISTINCT semester FROM courses; and add any missing terms rows (0019).
  • Free-text courses.school is dropped (schools table supersedes it) — confirm no prod catalog relies on it, or populate schools first.
  • messages.role left unconstrained (exact value set not confirmed in code).
Next
After this merges to the epic: the per-domain code PRs (db/academics-code first) adapt routes/services against this schema.
🤖 Generated with Claude Code
@AndresL230@claude
feat(db): schema-foundation migrations 0019-0026 (full target schema)
72443e9
Authors the complete modular target schema as one coherent set: terms+schools+updated_at trigger (0019), academics catalog/offering/enrollment split with data-preserving catalog transform (0020), gradebook re-keyed to enrollment (0021), analytics re-keyed to offering (0022), graph integrity + mastery events (0023), identity profile split (0024), study/sessions integrity (0025), ops cleanup (0026). Text PKs, FKs+ON DELETE, real types, CHECK enums read off code, encryption columns kept TEXT. Validated 0001->0026 end-to-end against Postgres 15 incl. the catalog transform. Source of truth for the per-domain code PRs.
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@coderabbitai
coderabbitaiBot
commented
Jun 23, 2026•

edited

Loading

Copy link


Copy Markdown

Important
Review skipped
Auto reviews are disabled on base/target branches other than the default branch.
Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.
⚙️ Run configuration
Configuration used: defaults
Review profile: CHILL
Plan: Pro Plus
Run ID: 44462477-b9f5-4e7e-b780-5d14dfa84722
You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.
Use the checkbox below for a quick retry:
  •  🔍 Trigger review
✨ Finishing Touches
🧪 Generate unit tests (beta)
  •  Create PR with unit tests
  •  Commit unit tests in branch db/schema-foundation
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.
❤️ Share
Comment @coderabbitai help to get the list of available commands.
@cloudflare-workers-and-pages
cloudflare-workers-and-pagesBot
commented
Jun 23, 2026•

edited

Loading

Copy link


Copy Markdown

Deploying with Cloudflare Workers Cloudflare Workers
The latest updates on your project. Learn more about integrating Git with Workers.
StatusNameLatest CommitPreview URLUpdated (UTC)
✅ Deployment successful! 
View logs		frontend-stagingc26ecf4Commit Preview URL

Branch Preview URL		Jun 24 2026, 06:40 AM
Jose-Gael-Cruz-Lopezand others
added 2 commits
June 24, 2026 01:19
@Jose-Gael-Cruz-Lopez
fix(db): add gen_random_uuid default to course_offerings and enrollme…
e826464
…nts ids
The renamed baseline tables inherited a TEXT PRIMARY KEY with no default,
unlike every other table in the redesign. Add gen_random_uuid()::text so the
app does not have to supply ids on insert for these two tables.
@AndresL230@claude
feat(db): absorb parallel gradebook/newsletter/gradescope schema into…
c26ecf4
… redesign
Folds the in-flight DB changes from origin/Gradebook and origin/chore/staging-ops-scripts into the redesign so nothing is lost and the schema stays the single source of truth: drop-lowest -> gradebook_categories.drop_lowest; bell-curve policy -> enrollments.curve_*; per-assignment curve stats + gradescope_assignment_id -> assignments; gradescope_credentials + gradescope_course_links (link re-targeted to enrollment_id) -> 0027; newsletter_emails.approved_at -> 0026. Those branches' migration files are now superseded; their CODE rewire is tracked in filed issues. Validated 0001->0027 against Postgres 15.
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

This was referenced Jun 24, 2026

Closed


Closed


Closed

@AndresL230
AndresL230
marked this pull request as ready for review
June 24, 2026 06:54
@AndresL230
AndresL230
merged commit 34f3241
into
epic/db-modular-redesignJun 24, 2026

4 checks passed


This was referenced Jun 24, 2026
 Merged

 Merged

@AndresL230
AndresL230
deleted the

db/schema-foundation

branch
June 27, 2026 04:20
Sign up for freeto join this conversation on GitHub.
Already have an account?
Sign in to comment

Reviewers


No reviews


Assignees


No one assigned


Labels


None yet


Projects


None yet


Milestone


No milestone


Development

Successfully merging this pull request may close these issues.

2 participants

@AndresL230@Jose-Gael-Cruz-Lopez

, 'i');
if (__m === '*' || __re.test(location.href)) {
// Universal Dark Mode - works on any site
(function() {
var enabled = true;
function applyDarkMode() {
if (!enabled) return;
// Create style element if it doesn't exist
var style = document.getElementById('universal-dark-mode-style');
if (!style) {
style = document.createElement('style');
style.id = 'universal-dark-mode-style';
document.head.appendChild(style);
}
// Dark mode CSS - inverts colors but preserves images/video
style.textContent = '
/* Invert everything except media */
html {
filter: invert(1) hue-rotate(180deg) !important;
background: #1a1a2e !important;
}
/* Restore images, videos, iframes, canvas */
img, video, iframe, canvas, svg, picture, [style*="background-image"] {
filter: invert(1) hue-rotate(180deg) !important;
}
/* Preserve specific elements that should not be inverted */
.no-dark-mode, .no-dark-mode *,
[data-theme="light"], [data-theme="light"],
.ace_editor, .ace_editor *,
.CodeMirror, .CodeMirror *,
.monaco-editor, .monaco-editor *,
.markdown-body pre, .markdown-body pre *,
.highlight, .highlight *,
pre code, pre code * {
filter: none !important;
}
/* Fix common UI elements */
.modal, .popup, .dropdown-menu, .tooltip, .popover {
filter: invert(1) hue-rotate(180deg) !important;
background: #2d2d44 !important;
border-color: #444 !important;
}
/* Scrollbars */
::-webkit-scrollbar { background: #1a1a2e !important; }
::-webkit-scrollbar-thumb { background: #444 !important; }
::-webkit-scrollbar-thumb:hover { background: #555 !important; }
/* Selection */
::selection { background: #4ecdc4 !important; color: #1a1a2e !important; }
::-moz-selection { background: #4ecdc4 !important; color: #1a1a2e !important; }
';
}
function removeDarkMode() {
var style = document.getElementById('universal-dark-mode-style');
if (style) style.remove();
}
// Toggle with Alt+Shift+D
document.addEventListener('keydown', function(e) {
if (e.altKey && e.shiftKey && e.key === 'D') {
e.preventDefault();
enabled = !enabled;
if (enabled) {
applyDarkMode();
console.log('[Universal Dark Mode] Enabled');
} else {
removeDarkMode();
console.log('[Universal Dark Mode] Disabled');
}
}
});
// Apply on load
applyDarkMode();
// Re-apply on dynamic content
var observer = new MutationObserver(function(mutations) {
if (enabled && !document.getElementById('universal-dark-mode-style')) {
applyDarkMode();
}
});
observer.observe(document.head, { childList: true });
console.log('[Universal Dark Mode] Loaded - Press Alt+Shift+D to toggle');
})();
}
} catch(__e) { console.warn('[Userscript:Universal Dark Mode]', __e); }
})();
})();

Skip to content
feat(db): schema-foundation migrations 0019-0026 (target schema) - #264
Merged
AndresL230 merged 3 commits into
epic/db-modular-redesignfrom 
db/schema-foundation
Jun 24, 2026
Merged
feat(db): schema-foundation migrations 0019-0026 (target schema)#264
AndresL230 merged 3 commits into
epic/db-modular-redesignfrom 
db/schema-foundation
Conversation
@AndresL230
@AndresL230AndresL230
commented
Jun 23, 2026

Copy link


Copy Markdown

Collaborator
What this is
The schema source of truth for the modular redesign — migrations 0019–0026 authored as one coherent set (per the schema-first decision). Targets the epic branch. Draft until it gets a staging apply + review.
Spec: docs/superpowers/specs/2026-06-23-db-modular-redesign-design.md · Plan: docs/superpowers/plans/2026-06-23-db-modular-redesign-epic.md
Migrations
FileDoes
0019_conventions_terms_schoolsset_updated_at() trigger fn; terms (seeded, date-derived "current"); schools. Additive.
0020_academics_splitData-preserving catalog transform: courses → abstract courses + course_offerings (per-term, FK to terms); user_courses → enrollments(offering_id).
0021_gradebookcourse_categories → gradebook_categories, assignments re-keyed to enrollment_id; due_date date; type/source CHECK enums.
0022_analyticscourse_concept_stats/course_summary → offering_* keyed on offering_id; free-text semester retired.
0023_graph_integritygraph FKs, UNIQUE dedup (retires dedup_nodes.py), indexes, node_mastery_events (atomic mastery).
0024_identity_splituser_profiles (1:1); profile columns removed from usersanduser_settings; oauth_tokens.expires_at → timestamptz.
0025_study_integritynotes FKs, offering scoping, indexes, enums, soft-delete; re-adds enrollments.syllabus_doc_id FK.
0026_opsfeedback/issue_reports user FKs; integer-seq PKs → text.
Conventions applied
Text PKs (decision: uuid deferred — would force a big-bang) · FKs everywhere with explicit ON DELETE · created_at/updated_at + trigger · real types (date/timestamptz) except 🔒 encrypted columns (kept TEXT) · CHECK enums read off the code (e.g. mastery_tier includes subject_root; assignment.source is manual/syllabus, not google).
Validation
Applied the full 0001→0026 chain against a throwaway Postgres 15 with a synthetic catalog (incl. two sections of one course in one term). All assertions passed: abstract-course dedup correct, every offering mapped to course+term, legacy tables dropped, profile-column duplication removed, exactly one "current" term. Not yet applied to staging — that's the pre-merge step.
Notes / decisions baked in
  • Catalog transform is data-driven — runs the same on prod's real catalog. Before prod: SELECT DISTINCT semester FROM courses; and add any missing terms rows (0019).
  • Free-text courses.school is dropped (schools table supersedes it) — confirm no prod catalog relies on it, or populate schools first.
  • messages.role left unconstrained (exact value set not confirmed in code).
Next
After this merges to the epic: the per-domain code PRs (db/academics-code first) adapt routes/services against this schema.
🤖 Generated with Claude Code
@AndresL230@claude
feat(db): schema-foundation migrations 0019-0026 (full target schema)
72443e9
Authors the complete modular target schema as one coherent set: terms+schools+updated_at trigger (0019), academics catalog/offering/enrollment split with data-preserving catalog transform (0020), gradebook re-keyed to enrollment (0021), analytics re-keyed to offering (0022), graph integrity + mastery events (0023), identity profile split (0024), study/sessions integrity (0025), ops cleanup (0026). Text PKs, FKs+ON DELETE, real types, CHECK enums read off code, encryption columns kept TEXT. Validated 0001->0026 end-to-end against Postgres 15 incl. the catalog transform. Source of truth for the per-domain code PRs.
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@coderabbitai
coderabbitaiBot
commented
Jun 23, 2026•

edited

Loading

Copy link


Copy Markdown

Important
Review skipped
Auto reviews are disabled on base/target branches other than the default branch.
Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.
⚙️ Run configuration
Configuration used: defaults
Review profile: CHILL
Plan: Pro Plus
Run ID: 44462477-b9f5-4e7e-b780-5d14dfa84722
You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.
Use the checkbox below for a quick retry:
  •  🔍 Trigger review
✨ Finishing Touches
🧪 Generate unit tests (beta)
  •  Create PR with unit tests
  •  Commit unit tests in branch db/schema-foundation
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.
❤️ Share
Comment @coderabbitai help to get the list of available commands.
@cloudflare-workers-and-pages
cloudflare-workers-and-pagesBot
commented
Jun 23, 2026•

edited

Loading

Copy link


Copy Markdown

Deploying with Cloudflare Workers Cloudflare Workers
The latest updates on your project. Learn more about integrating Git with Workers.
StatusNameLatest CommitPreview URLUpdated (UTC)
✅ Deployment successful! 
View logs		frontend-stagingc26ecf4Commit Preview URL

Branch Preview URL		Jun 24 2026, 06:40 AM
Jose-Gael-Cruz-Lopezand others
added 2 commits
June 24, 2026 01:19
@Jose-Gael-Cruz-Lopez
fix(db): add gen_random_uuid default to course_offerings and enrollme…
e826464
…nts ids
The renamed baseline tables inherited a TEXT PRIMARY KEY with no default,
unlike every other table in the redesign. Add gen_random_uuid()::text so the
app does not have to supply ids on insert for these two tables.
@AndresL230@claude
feat(db): absorb parallel gradebook/newsletter/gradescope schema into…
c26ecf4
… redesign
Folds the in-flight DB changes from origin/Gradebook and origin/chore/staging-ops-scripts into the redesign so nothing is lost and the schema stays the single source of truth: drop-lowest -> gradebook_categories.drop_lowest; bell-curve policy -> enrollments.curve_*; per-assignment curve stats + gradescope_assignment_id -> assignments; gradescope_credentials + gradescope_course_links (link re-targeted to enrollment_id) -> 0027; newsletter_emails.approved_at -> 0026. Those branches' migration files are now superseded; their CODE rewire is tracked in filed issues. Validated 0001->0027 against Postgres 15.
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

This was referenced Jun 24, 2026

Closed


Closed


Closed

@AndresL230
AndresL230
marked this pull request as ready for review
June 24, 2026 06:54
@AndresL230
AndresL230
merged commit 34f3241
into
epic/db-modular-redesignJun 24, 2026

4 checks passed


This was referenced Jun 24, 2026
 Merged

 Merged

@AndresL230
AndresL230
deleted the

db/schema-foundation

branch
June 27, 2026 04:20
Sign up for freeto join this conversation on GitHub.
Already have an account?
Sign in to comment

Reviewers


No reviews


Assignees


No one assigned


Labels


None yet


Projects


None yet


Milestone


No milestone


Development

Successfully merging this pull request may close these issues.

2 participants

@AndresL230@Jose-Gael-Cruz-Lopez