db/academics-code: rewire app onto courses/offerings/terms/enrollments (epic slice PR2) - #268

Merged
AndresL230 merged 1 commit into
epic/db-modular-redesignfrom
db/academics-code
Jun 24, 2026
Merged

db/academics-code: rewire app onto courses/offerings/terms/enrollments (epic slice PR2)#268
AndresL230 merged 1 commit into
epic/db-modular-redesignfrom
db/academics-code

Conversation

@AndresL230

@AndresL230AndresL230 commented Jun 24, 2026

Copy link
Copy Markdown
Collaborator

Code-only slice (PR2, the spine) of the DB modular redesign. Rewires the application onto the already-landed academics split (migrations 0019–0027 from #264) — no migrations here. Targets the epic branch.

Locked contract (decided with the user)

  • API boundary keeps the abstract course_id. No section/instructor in any contract.
  • Semester/term is the real second axis.GET /api/semesters (from terms); get_courses returns each course's term.
  • Enrollment = (user, offering) internally; offering = (course, current term, section = NULL), created if the catalog lacks it so new enrollments land in the real current semester (not legacy Spring 2026).
  • Knowledge graph stays on the abstract course_id (cumulative); resolved via enrollment.offering_id → course_offerings.course_id.

What changed

  • services/academics.py (new): the term/offering/enrollment resolver everything builds on.
  • graph_service: enrollments→course_offerings→courses/terms join reshaped to the legacy flat shape; enroll/color/nickname/delete resolve offerings; analytics refresh resolves abstract→offerings.
  • course_context_service: offering-scoped analytics (offering_concept_stats/offering_summary); resolves offering→abstract course for graph_nodes; free-text semester gone.
  • graph_read: misconceptions read offering_concept_stats by offering_id.
  • routes:onboarding enrolls into the current-term offering; new routes/academics.py exposes GET /api/semesters; learn/profile course resolution via enrollments.

Scope decisions

  • gradebook.py deliberately excluded → goes whole to db/gradebook-code (PR3, with curve + drop-lowest, Rewire bell-curve + drop-lowest grading onto the redesigned gradebook (post-redesign) #266), built on this slice's enrollment-by-semester resolver.
  • course_context_service analytics absorbed here (the migrated offering tables force offering-keying, inseparable from the spine) → PR4 shrinks to social.py.
  • Other-slice callers (documents/quiz) degrade gracefully (empty reads / no-op) until their slices land — expected for the WIP-red epic.
  • school is ""/None for now (free-text courses.school retired; schools unpopulated) — frontend/seed follow-up.

Verification

  • Full backend suite: 724 passed; ruff check . clean.
  • New tests/test_academics.py; updated graph_service / shared_course_context / graph_read_tools / onboarding / learn suites.

Plan: docs/superpowers/plans/2026-06-24-db-academics-code.md. Spec: docs/superpowers/specs/2026-06-23-db-modular-redesign-design.md.

Unblocks the parallel code slices (graph / analytics / gradebook / identity / study / ops).

@AndresL230@claude
feat(db): academics-code — rewire app onto courses/offerings/terms/en…
788e8df
…rollments (epic slice PR2)
Code-only slice against the already-landed academics split (migrations 0019-0027).
The public API keeps the abstract `course_id`; the term/semester becomes a real
second axis; enrollment resolves to a per-term offering internally.
- services/academics.py (new): term/offering/enrollment resolver — current_term
(date-derived, latest-term fallback), list_terms, resolve_offering (current term,
create-if-missing so new enrollments land in the real current semester),
offering_course_id, user_offering_ids_for_course, term_for_offering.
- graph_service: enrollments→course_offerings→courses/terms join reshaped to the
legacy flat shape; graph stays keyed on the ABSTRACT course_id; add/color/nickname/
delete resolve offerings; get_courses now surfaces `term`.
- course_context_service: offering-scoped analytics (offering_concept_stats/
offering_summary); resolves offering→abstract course for graph_nodes; semester gone.
- graph_read: misconceptions read offering_concept_stats by offering_id.
- onboarding/graph routes: enroll into the current-term offering; GET /api/semesters
(routes/academics.py) from terms; learn/profile course resolution via enrollments.
`gradebook.py` is intentionally left to db/gradebook-code (PR3, with curve+drop-lowest).
Other-slice callers (documents/quiz) degrade gracefully until their slices land.
Tests: +test_academics; updated graph_service/shared_course_context/graph_read_tools/
onboarding/learn suites. Full backend suite 724 passed; ruff clean.
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@coderabbitai

coderabbitaiBot commented Jun 24, 2026

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: 47b9404d-132e-4233-be0a-1ac6689e50ce

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/academics-code

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 24, 2026

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-staging788e8dfCommit Preview URL

Branch Preview URL		Jun 24 2026, 07:50 AM

@AndresL230
AndresL230 merged commit c4fe2a0 into epic/db-modular-redesignJun 24, 2026
4 checks passed
@AndresL230AndresL230 mentioned this pull request Jun 24, 2026
Merged
@AndresL230
AndresL230 deleted the db/academics-code 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.

1 participant

@AndresL230
, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Add copy buttons to all 
 blocks\n(function() {\n function addCopyButtons() {\n document.querySelectorAll('pre code').forEach(function(codeBlock) {\n if (codeBlock.parentElement.hasAttribute('data-copy-added')) return;\n codeBlock.parentElement.setAttribute('data-copy-added', 'true');\n \n var btn = document.createElement('button');\n btn.textContent = 'Copy';\n 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;';\n btn.onmouseover = function() { this.style.opacity = '1'; };\n btn.onmouseout = function() { this.style.opacity = '0.7'; };\n btn.onclick = function() {\n navigator.clipboard.writeText(codeBlock.textContent).then(function() {\n btn.textContent = 'Copied!';\n setTimeout(function() { btn.textContent = 'Copy'; }, 1500);\n });\n };\n codeBlock.parentElement.style.position = 'relative';\n codeBlock.parentElement.appendChild(btn);\n });\n }\n \n addCopyButtons();\n \n // Re-run on dynamic content\n var observer = new MutationObserver(addCopyButtons);\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "Add Copy Buttons to Code Blocks");
}
} 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
db/academics-code: rewire app onto courses/offerings/terms/enrollments (epic slice PR2) - #268
Merged
AndresL230 merged 1 commit into
epic/db-modular-redesignfrom 
db/academics-code
Jun 24, 2026
Merged
db/academics-code: rewire app onto courses/offerings/terms/enrollments (epic slice PR2)#268
AndresL230 merged 1 commit into
epic/db-modular-redesignfrom 
db/academics-code
Conversation
@AndresL230
@AndresL230AndresL230
commented
Jun 24, 2026

Copy link


Copy Markdown

Collaborator
Code-only slice (PR2, the spine) of the DB modular redesign. Rewires the application onto the already-landed academics split (migrations 0019–0027 from #264) — no migrations here. Targets the epic branch.
Locked contract (decided with the user)
  • API boundary keeps the abstract course_id. No section/instructor in any contract.
  • Semester/term is the real second axis.GET /api/semesters (from terms); get_courses returns each course's term.
  • Enrollment = (user, offering) internally; offering = (course, current term, section = NULL), created if the catalog lacks it so new enrollments land in the real current semester (not legacy Spring 2026).
  • Knowledge graph stays on the abstract course_id (cumulative); resolved via enrollment.offering_id → course_offerings.course_id.
What changed
  • services/academics.py (new): the term/offering/enrollment resolver everything builds on.
  • graph_service: enrollments→course_offerings→courses/terms join reshaped to the legacy flat shape; enroll/color/nickname/delete resolve offerings; analytics refresh resolves abstract→offerings.
  • course_context_service: offering-scoped analytics (offering_concept_stats/offering_summary); resolves offering→abstract course for graph_nodes; free-text semester gone.
  • graph_read: misconceptions read offering_concept_stats by offering_id.
  • routes:onboarding enrolls into the current-term offering; new routes/academics.py exposes GET /api/semesters; learn/profile course resolution via enrollments.
Scope decisions
  • gradebook.py deliberately excluded → goes whole to db/gradebook-code (PR3, with curve + drop-lowest, Rewire bell-curve + drop-lowest grading onto the redesigned gradebook (post-redesign) #266), built on this slice's enrollment-by-semester resolver.
  • course_context_service analytics absorbed here (the migrated offering tables force offering-keying, inseparable from the spine) → PR4 shrinks to social.py.
  • Other-slice callers (documents/quiz) degrade gracefully (empty reads / no-op) until their slices land — expected for the WIP-red epic.
  • school is ""/None for now (free-text courses.school retired; schools unpopulated) — frontend/seed follow-up.
Verification
  • Full backend suite: 724 passed; ruff check . clean.
  • New tests/test_academics.py; updated graph_service / shared_course_context / graph_read_tools / onboarding / learn suites.
Plan: docs/superpowers/plans/2026-06-24-db-academics-code.md. Spec: docs/superpowers/specs/2026-06-23-db-modular-redesign-design.md.
Unblocks the parallel code slices (graph / analytics / gradebook / identity / study / ops).
@AndresL230@claude
feat(db): academics-code — rewire app onto courses/offerings/terms/en…
788e8df
…rollments (epic slice PR2)
Code-only slice against the already-landed academics split (migrations 0019-0027).
The public API keeps the abstract `course_id`; the term/semester becomes a real
second axis; enrollment resolves to a per-term offering internally.
- services/academics.py (new): term/offering/enrollment resolver — current_term
(date-derived, latest-term fallback), list_terms, resolve_offering (current term,
create-if-missing so new enrollments land in the real current semester),
offering_course_id, user_offering_ids_for_course, term_for_offering.
- graph_service: enrollments→course_offerings→courses/terms join reshaped to the
legacy flat shape; graph stays keyed on the ABSTRACT course_id; add/color/nickname/
delete resolve offerings; get_courses now surfaces `term`.
- course_context_service: offering-scoped analytics (offering_concept_stats/
offering_summary); resolves offering→abstract course for graph_nodes; semester gone.
- graph_read: misconceptions read offering_concept_stats by offering_id.
- onboarding/graph routes: enroll into the current-term offering; GET /api/semesters
(routes/academics.py) from terms; learn/profile course resolution via enrollments.
`gradebook.py` is intentionally left to db/gradebook-code (PR3, with curve+drop-lowest).
Other-slice callers (documents/quiz) degrade gracefully until their slices land.
Tests: +test_academics; updated graph_service/shared_course_context/graph_read_tools/
onboarding/learn suites. Full backend suite 724 passed; ruff clean.
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@coderabbitai
coderabbitaiBot
commented
Jun 24, 2026

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: 47b9404d-132e-4233-be0a-1ac6689e50ce
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/academics-code
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 24, 2026

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-staging788e8dfCommit Preview URL

Branch Preview URL		Jun 24 2026, 07:50 AM
@AndresL230
AndresL230
merged commit c4fe2a0
into
epic/db-modular-redesignJun 24, 2026

4 checks passed

@AndresL230AndresL230
mentioned this pull request
Jun 24, 2026
 Merged

@AndresL230
AndresL230
deleted the

db/academics-code

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.

1 participant

@AndresL230

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

Skip to content
db/academics-code: rewire app onto courses/offerings/terms/enrollments (epic slice PR2) - #268
Merged
AndresL230 merged 1 commit into
epic/db-modular-redesignfrom 
db/academics-code
Jun 24, 2026
Merged
db/academics-code: rewire app onto courses/offerings/terms/enrollments (epic slice PR2)#268
AndresL230 merged 1 commit into
epic/db-modular-redesignfrom 
db/academics-code
Conversation
@AndresL230
@AndresL230AndresL230
commented
Jun 24, 2026

Copy link


Copy Markdown

Collaborator
Code-only slice (PR2, the spine) of the DB modular redesign. Rewires the application onto the already-landed academics split (migrations 0019–0027 from #264) — no migrations here. Targets the epic branch.
Locked contract (decided with the user)
  • API boundary keeps the abstract course_id. No section/instructor in any contract.
  • Semester/term is the real second axis.GET /api/semesters (from terms); get_courses returns each course's term.
  • Enrollment = (user, offering) internally; offering = (course, current term, section = NULL), created if the catalog lacks it so new enrollments land in the real current semester (not legacy Spring 2026).
  • Knowledge graph stays on the abstract course_id (cumulative); resolved via enrollment.offering_id → course_offerings.course_id.
What changed
  • services/academics.py (new): the term/offering/enrollment resolver everything builds on.
  • graph_service: enrollments→course_offerings→courses/terms join reshaped to the legacy flat shape; enroll/color/nickname/delete resolve offerings; analytics refresh resolves abstract→offerings.
  • course_context_service: offering-scoped analytics (offering_concept_stats/offering_summary); resolves offering→abstract course for graph_nodes; free-text semester gone.
  • graph_read: misconceptions read offering_concept_stats by offering_id.
  • routes:onboarding enrolls into the current-term offering; new routes/academics.py exposes GET /api/semesters; learn/profile course resolution via enrollments.
Scope decisions
  • gradebook.py deliberately excluded → goes whole to db/gradebook-code (PR3, with curve + drop-lowest, Rewire bell-curve + drop-lowest grading onto the redesigned gradebook (post-redesign) #266), built on this slice's enrollment-by-semester resolver.
  • course_context_service analytics absorbed here (the migrated offering tables force offering-keying, inseparable from the spine) → PR4 shrinks to social.py.
  • Other-slice callers (documents/quiz) degrade gracefully (empty reads / no-op) until their slices land — expected for the WIP-red epic.
  • school is ""/None for now (free-text courses.school retired; schools unpopulated) — frontend/seed follow-up.
Verification
  • Full backend suite: 724 passed; ruff check . clean.
  • New tests/test_academics.py; updated graph_service / shared_course_context / graph_read_tools / onboarding / learn suites.
Plan: docs/superpowers/plans/2026-06-24-db-academics-code.md. Spec: docs/superpowers/specs/2026-06-23-db-modular-redesign-design.md.
Unblocks the parallel code slices (graph / analytics / gradebook / identity / study / ops).
@AndresL230@claude
feat(db): academics-code — rewire app onto courses/offerings/terms/en…
788e8df
…rollments (epic slice PR2)
Code-only slice against the already-landed academics split (migrations 0019-0027).
The public API keeps the abstract `course_id`; the term/semester becomes a real
second axis; enrollment resolves to a per-term offering internally.
- services/academics.py (new): term/offering/enrollment resolver — current_term
(date-derived, latest-term fallback), list_terms, resolve_offering (current term,
create-if-missing so new enrollments land in the real current semester),
offering_course_id, user_offering_ids_for_course, term_for_offering.
- graph_service: enrollments→course_offerings→courses/terms join reshaped to the
legacy flat shape; graph stays keyed on the ABSTRACT course_id; add/color/nickname/
delete resolve offerings; get_courses now surfaces `term`.
- course_context_service: offering-scoped analytics (offering_concept_stats/
offering_summary); resolves offering→abstract course for graph_nodes; semester gone.
- graph_read: misconceptions read offering_concept_stats by offering_id.
- onboarding/graph routes: enroll into the current-term offering; GET /api/semesters
(routes/academics.py) from terms; learn/profile course resolution via enrollments.
`gradebook.py` is intentionally left to db/gradebook-code (PR3, with curve+drop-lowest).
Other-slice callers (documents/quiz) degrade gracefully until their slices land.
Tests: +test_academics; updated graph_service/shared_course_context/graph_read_tools/
onboarding/learn suites. Full backend suite 724 passed; ruff clean.
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@coderabbitai
coderabbitaiBot
commented
Jun 24, 2026

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: 47b9404d-132e-4233-be0a-1ac6689e50ce
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/academics-code
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 24, 2026

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-staging788e8dfCommit Preview URL

Branch Preview URL		Jun 24 2026, 07:50 AM
@AndresL230
AndresL230
merged commit c4fe2a0
into
epic/db-modular-redesignJun 24, 2026

4 checks passed

@AndresL230AndresL230
mentioned this pull request
Jun 24, 2026
 Merged

@AndresL230
AndresL230
deleted the

db/academics-code

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.

1 participant

@AndresL230

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

Skip to content
db/academics-code: rewire app onto courses/offerings/terms/enrollments (epic slice PR2) - #268
Merged
AndresL230 merged 1 commit into
epic/db-modular-redesignfrom 
db/academics-code
Jun 24, 2026
Merged
db/academics-code: rewire app onto courses/offerings/terms/enrollments (epic slice PR2)#268
AndresL230 merged 1 commit into
epic/db-modular-redesignfrom 
db/academics-code
Conversation
@AndresL230
@AndresL230AndresL230
commented
Jun 24, 2026

Copy link


Copy Markdown

Collaborator
Code-only slice (PR2, the spine) of the DB modular redesign. Rewires the application onto the already-landed academics split (migrations 0019–0027 from #264) — no migrations here. Targets the epic branch.
Locked contract (decided with the user)
  • API boundary keeps the abstract course_id. No section/instructor in any contract.
  • Semester/term is the real second axis.GET /api/semesters (from terms); get_courses returns each course's term.
  • Enrollment = (user, offering) internally; offering = (course, current term, section = NULL), created if the catalog lacks it so new enrollments land in the real current semester (not legacy Spring 2026).
  • Knowledge graph stays on the abstract course_id (cumulative); resolved via enrollment.offering_id → course_offerings.course_id.
What changed
  • services/academics.py (new): the term/offering/enrollment resolver everything builds on.
  • graph_service: enrollments→course_offerings→courses/terms join reshaped to the legacy flat shape; enroll/color/nickname/delete resolve offerings; analytics refresh resolves abstract→offerings.
  • course_context_service: offering-scoped analytics (offering_concept_stats/offering_summary); resolves offering→abstract course for graph_nodes; free-text semester gone.
  • graph_read: misconceptions read offering_concept_stats by offering_id.
  • routes:onboarding enrolls into the current-term offering; new routes/academics.py exposes GET /api/semesters; learn/profile course resolution via enrollments.
Scope decisions
  • gradebook.py deliberately excluded → goes whole to db/gradebook-code (PR3, with curve + drop-lowest, Rewire bell-curve + drop-lowest grading onto the redesigned gradebook (post-redesign) #266), built on this slice's enrollment-by-semester resolver.
  • course_context_service analytics absorbed here (the migrated offering tables force offering-keying, inseparable from the spine) → PR4 shrinks to social.py.
  • Other-slice callers (documents/quiz) degrade gracefully (empty reads / no-op) until their slices land — expected for the WIP-red epic.
  • school is ""/None for now (free-text courses.school retired; schools unpopulated) — frontend/seed follow-up.
Verification
  • Full backend suite: 724 passed; ruff check . clean.
  • New tests/test_academics.py; updated graph_service / shared_course_context / graph_read_tools / onboarding / learn suites.
Plan: docs/superpowers/plans/2026-06-24-db-academics-code.md. Spec: docs/superpowers/specs/2026-06-23-db-modular-redesign-design.md.
Unblocks the parallel code slices (graph / analytics / gradebook / identity / study / ops).
@AndresL230@claude
feat(db): academics-code — rewire app onto courses/offerings/terms/en…
788e8df
…rollments (epic slice PR2)
Code-only slice against the already-landed academics split (migrations 0019-0027).
The public API keeps the abstract `course_id`; the term/semester becomes a real
second axis; enrollment resolves to a per-term offering internally.
- services/academics.py (new): term/offering/enrollment resolver — current_term
(date-derived, latest-term fallback), list_terms, resolve_offering (current term,
create-if-missing so new enrollments land in the real current semester),
offering_course_id, user_offering_ids_for_course, term_for_offering.
- graph_service: enrollments→course_offerings→courses/terms join reshaped to the
legacy flat shape; graph stays keyed on the ABSTRACT course_id; add/color/nickname/
delete resolve offerings; get_courses now surfaces `term`.
- course_context_service: offering-scoped analytics (offering_concept_stats/
offering_summary); resolves offering→abstract course for graph_nodes; semester gone.
- graph_read: misconceptions read offering_concept_stats by offering_id.
- onboarding/graph routes: enroll into the current-term offering; GET /api/semesters
(routes/academics.py) from terms; learn/profile course resolution via enrollments.
`gradebook.py` is intentionally left to db/gradebook-code (PR3, with curve+drop-lowest).
Other-slice callers (documents/quiz) degrade gracefully until their slices land.
Tests: +test_academics; updated graph_service/shared_course_context/graph_read_tools/
onboarding/learn suites. Full backend suite 724 passed; ruff clean.
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@coderabbitai
coderabbitaiBot
commented
Jun 24, 2026

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: 47b9404d-132e-4233-be0a-1ac6689e50ce
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/academics-code
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 24, 2026

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-staging788e8dfCommit Preview URL

Branch Preview URL		Jun 24 2026, 07:50 AM
@AndresL230
AndresL230
merged commit c4fe2a0
into
epic/db-modular-redesignJun 24, 2026

4 checks passed

@AndresL230AndresL230
mentioned this pull request
Jun 24, 2026
 Merged

@AndresL230
AndresL230
deleted the

db/academics-code

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.

1 participant

@AndresL230

, 'i');
if (__m === '*' || __re.test(location.href)) {
injectUserscript("// Strip utm_, fbclid, gclid, etc. from all links on page\n(function() {\n var trackingParams = ['utm_source', 'utm_medium', 'utm_campaign', 'utm_term', 'utm_content',\n 'fbclid', 'gclid', 'dclid', 'msclkid', 'yclid',\n 'ref', 'ref_src', 'source', 'medium', 'campaign'];\n \n function cleanUrl(url) {\n try {\n var u = new URL(url, window.location.origin);\n var changed = false;\n trackingParams.forEach(function(p) {\n if (u.searchParams.has(p)) {\n u.searchParams.delete(p);\n changed = true;\n }\n });\n return changed ? u.toString() : url;\n } catch (e) {\n return url;\n }\n }\n \n function cleanLinks() {\n document.querySelectorAll('a[href]').forEach(function(a) {\n var clean = cleanUrl(a.href);\n if (clean !== a.href) a.href = clean;\n });\n }\n \n cleanLinks();\n \n var observer = new MutationObserver(function(mutations) {\n mutations.forEach(function(m) {\n m.addedNodes.forEach(function(node) {\n if (node.nodeType === 1) {\n if (node.tagName === 'A') cleanLinks();\n node.querySelectorAll('a[href]').forEach(function(a) {\n var clean = cleanUrl(a.href);\n if (clean !== a.href) a.href = clean;\n });\n }\n });\n });\n });\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "Remove Tracking Parameters from Links");
}
} 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
db/academics-code: rewire app onto courses/offerings/terms/enrollments (epic slice PR2) - #268
Merged
AndresL230 merged 1 commit into
epic/db-modular-redesignfrom 
db/academics-code
Jun 24, 2026
Merged
db/academics-code: rewire app onto courses/offerings/terms/enrollments (epic slice PR2)#268
AndresL230 merged 1 commit into
epic/db-modular-redesignfrom 
db/academics-code
Conversation
@AndresL230
@AndresL230AndresL230
commented
Jun 24, 2026

Copy link


Copy Markdown

Collaborator
Code-only slice (PR2, the spine) of the DB modular redesign. Rewires the application onto the already-landed academics split (migrations 0019–0027 from #264) — no migrations here. Targets the epic branch.
Locked contract (decided with the user)
  • API boundary keeps the abstract course_id. No section/instructor in any contract.
  • Semester/term is the real second axis.GET /api/semesters (from terms); get_courses returns each course's term.
  • Enrollment = (user, offering) internally; offering = (course, current term, section = NULL), created if the catalog lacks it so new enrollments land in the real current semester (not legacy Spring 2026).
  • Knowledge graph stays on the abstract course_id (cumulative); resolved via enrollment.offering_id → course_offerings.course_id.
What changed
  • services/academics.py (new): the term/offering/enrollment resolver everything builds on.
  • graph_service: enrollments→course_offerings→courses/terms join reshaped to the legacy flat shape; enroll/color/nickname/delete resolve offerings; analytics refresh resolves abstract→offerings.
  • course_context_service: offering-scoped analytics (offering_concept_stats/offering_summary); resolves offering→abstract course for graph_nodes; free-text semester gone.
  • graph_read: misconceptions read offering_concept_stats by offering_id.
  • routes:onboarding enrolls into the current-term offering; new routes/academics.py exposes GET /api/semesters; learn/profile course resolution via enrollments.
Scope decisions
  • gradebook.py deliberately excluded → goes whole to db/gradebook-code (PR3, with curve + drop-lowest, Rewire bell-curve + drop-lowest grading onto the redesigned gradebook (post-redesign) #266), built on this slice's enrollment-by-semester resolver.
  • course_context_service analytics absorbed here (the migrated offering tables force offering-keying, inseparable from the spine) → PR4 shrinks to social.py.
  • Other-slice callers (documents/quiz) degrade gracefully (empty reads / no-op) until their slices land — expected for the WIP-red epic.
  • school is ""/None for now (free-text courses.school retired; schools unpopulated) — frontend/seed follow-up.
Verification
  • Full backend suite: 724 passed; ruff check . clean.
  • New tests/test_academics.py; updated graph_service / shared_course_context / graph_read_tools / onboarding / learn suites.
Plan: docs/superpowers/plans/2026-06-24-db-academics-code.md. Spec: docs/superpowers/specs/2026-06-23-db-modular-redesign-design.md.
Unblocks the parallel code slices (graph / analytics / gradebook / identity / study / ops).
@AndresL230@claude
feat(db): academics-code — rewire app onto courses/offerings/terms/en…
788e8df
…rollments (epic slice PR2)
Code-only slice against the already-landed academics split (migrations 0019-0027).
The public API keeps the abstract `course_id`; the term/semester becomes a real
second axis; enrollment resolves to a per-term offering internally.
- services/academics.py (new): term/offering/enrollment resolver — current_term
(date-derived, latest-term fallback), list_terms, resolve_offering (current term,
create-if-missing so new enrollments land in the real current semester),
offering_course_id, user_offering_ids_for_course, term_for_offering.
- graph_service: enrollments→course_offerings→courses/terms join reshaped to the
legacy flat shape; graph stays keyed on the ABSTRACT course_id; add/color/nickname/
delete resolve offerings; get_courses now surfaces `term`.
- course_context_service: offering-scoped analytics (offering_concept_stats/
offering_summary); resolves offering→abstract course for graph_nodes; semester gone.
- graph_read: misconceptions read offering_concept_stats by offering_id.
- onboarding/graph routes: enroll into the current-term offering; GET /api/semesters
(routes/academics.py) from terms; learn/profile course resolution via enrollments.
`gradebook.py` is intentionally left to db/gradebook-code (PR3, with curve+drop-lowest).
Other-slice callers (documents/quiz) degrade gracefully until their slices land.
Tests: +test_academics; updated graph_service/shared_course_context/graph_read_tools/
onboarding/learn suites. Full backend suite 724 passed; ruff clean.
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@coderabbitai
coderabbitaiBot
commented
Jun 24, 2026

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: 47b9404d-132e-4233-be0a-1ac6689e50ce
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/academics-code
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 24, 2026

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-staging788e8dfCommit Preview URL

Branch Preview URL		Jun 24 2026, 07:50 AM
@AndresL230
AndresL230
merged commit c4fe2a0
into
epic/db-modular-redesignJun 24, 2026

4 checks passed

@AndresL230AndresL230
mentioned this pull request
Jun 24, 2026
 Merged

@AndresL230
AndresL230
deleted the

db/academics-code

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.

1 participant

@AndresL230

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

Skip to content
db/academics-code: rewire app onto courses/offerings/terms/enrollments (epic slice PR2) - #268
Merged
AndresL230 merged 1 commit into
epic/db-modular-redesignfrom 
db/academics-code
Jun 24, 2026
Merged
db/academics-code: rewire app onto courses/offerings/terms/enrollments (epic slice PR2)#268
AndresL230 merged 1 commit into
epic/db-modular-redesignfrom 
db/academics-code
Conversation
@AndresL230
@AndresL230AndresL230
commented
Jun 24, 2026

Copy link


Copy Markdown

Collaborator
Code-only slice (PR2, the spine) of the DB modular redesign. Rewires the application onto the already-landed academics split (migrations 0019–0027 from #264) — no migrations here. Targets the epic branch.
Locked contract (decided with the user)
  • API boundary keeps the abstract course_id. No section/instructor in any contract.
  • Semester/term is the real second axis.GET /api/semesters (from terms); get_courses returns each course's term.
  • Enrollment = (user, offering) internally; offering = (course, current term, section = NULL), created if the catalog lacks it so new enrollments land in the real current semester (not legacy Spring 2026).
  • Knowledge graph stays on the abstract course_id (cumulative); resolved via enrollment.offering_id → course_offerings.course_id.
What changed
  • services/academics.py (new): the term/offering/enrollment resolver everything builds on.
  • graph_service: enrollments→course_offerings→courses/terms join reshaped to the legacy flat shape; enroll/color/nickname/delete resolve offerings; analytics refresh resolves abstract→offerings.
  • course_context_service: offering-scoped analytics (offering_concept_stats/offering_summary); resolves offering→abstract course for graph_nodes; free-text semester gone.
  • graph_read: misconceptions read offering_concept_stats by offering_id.
  • routes:onboarding enrolls into the current-term offering; new routes/academics.py exposes GET /api/semesters; learn/profile course resolution via enrollments.
Scope decisions
  • gradebook.py deliberately excluded → goes whole to db/gradebook-code (PR3, with curve + drop-lowest, Rewire bell-curve + drop-lowest grading onto the redesigned gradebook (post-redesign) #266), built on this slice's enrollment-by-semester resolver.
  • course_context_service analytics absorbed here (the migrated offering tables force offering-keying, inseparable from the spine) → PR4 shrinks to social.py.
  • Other-slice callers (documents/quiz) degrade gracefully (empty reads / no-op) until their slices land — expected for the WIP-red epic.
  • school is ""/None for now (free-text courses.school retired; schools unpopulated) — frontend/seed follow-up.
Verification
  • Full backend suite: 724 passed; ruff check . clean.
  • New tests/test_academics.py; updated graph_service / shared_course_context / graph_read_tools / onboarding / learn suites.
Plan: docs/superpowers/plans/2026-06-24-db-academics-code.md. Spec: docs/superpowers/specs/2026-06-23-db-modular-redesign-design.md.
Unblocks the parallel code slices (graph / analytics / gradebook / identity / study / ops).
@AndresL230@claude
feat(db): academics-code — rewire app onto courses/offerings/terms/en…
788e8df
…rollments (epic slice PR2)
Code-only slice against the already-landed academics split (migrations 0019-0027).
The public API keeps the abstract `course_id`; the term/semester becomes a real
second axis; enrollment resolves to a per-term offering internally.
- services/academics.py (new): term/offering/enrollment resolver — current_term
(date-derived, latest-term fallback), list_terms, resolve_offering (current term,
create-if-missing so new enrollments land in the real current semester),
offering_course_id, user_offering_ids_for_course, term_for_offering.
- graph_service: enrollments→course_offerings→courses/terms join reshaped to the
legacy flat shape; graph stays keyed on the ABSTRACT course_id; add/color/nickname/
delete resolve offerings; get_courses now surfaces `term`.
- course_context_service: offering-scoped analytics (offering_concept_stats/
offering_summary); resolves offering→abstract course for graph_nodes; semester gone.
- graph_read: misconceptions read offering_concept_stats by offering_id.
- onboarding/graph routes: enroll into the current-term offering; GET /api/semesters
(routes/academics.py) from terms; learn/profile course resolution via enrollments.
`gradebook.py` is intentionally left to db/gradebook-code (PR3, with curve+drop-lowest).
Other-slice callers (documents/quiz) degrade gracefully until their slices land.
Tests: +test_academics; updated graph_service/shared_course_context/graph_read_tools/
onboarding/learn suites. Full backend suite 724 passed; ruff clean.
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@coderabbitai
coderabbitaiBot
commented
Jun 24, 2026

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: 47b9404d-132e-4233-be0a-1ac6689e50ce
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/academics-code
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 24, 2026

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-staging788e8dfCommit Preview URL

Branch Preview URL		Jun 24 2026, 07:50 AM
@AndresL230
AndresL230
merged commit c4fe2a0
into
epic/db-modular-redesignJun 24, 2026

4 checks passed

@AndresL230AndresL230
mentioned this pull request
Jun 24, 2026
 Merged

@AndresL230
AndresL230
deleted the

db/academics-code

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.

1 participant

@AndresL230

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

Skip to content
db/academics-code: rewire app onto courses/offerings/terms/enrollments (epic slice PR2) - #268
Merged
AndresL230 merged 1 commit into
epic/db-modular-redesignfrom 
db/academics-code
Jun 24, 2026
Merged
db/academics-code: rewire app onto courses/offerings/terms/enrollments (epic slice PR2)#268
AndresL230 merged 1 commit into
epic/db-modular-redesignfrom 
db/academics-code
Conversation
@AndresL230
@AndresL230AndresL230
commented
Jun 24, 2026

Copy link


Copy Markdown

Collaborator
Code-only slice (PR2, the spine) of the DB modular redesign. Rewires the application onto the already-landed academics split (migrations 0019–0027 from #264) — no migrations here. Targets the epic branch.
Locked contract (decided with the user)
  • API boundary keeps the abstract course_id. No section/instructor in any contract.
  • Semester/term is the real second axis.GET /api/semesters (from terms); get_courses returns each course's term.
  • Enrollment = (user, offering) internally; offering = (course, current term, section = NULL), created if the catalog lacks it so new enrollments land in the real current semester (not legacy Spring 2026).
  • Knowledge graph stays on the abstract course_id (cumulative); resolved via enrollment.offering_id → course_offerings.course_id.
What changed
  • services/academics.py (new): the term/offering/enrollment resolver everything builds on.
  • graph_service: enrollments→course_offerings→courses/terms join reshaped to the legacy flat shape; enroll/color/nickname/delete resolve offerings; analytics refresh resolves abstract→offerings.
  • course_context_service: offering-scoped analytics (offering_concept_stats/offering_summary); resolves offering→abstract course for graph_nodes; free-text semester gone.
  • graph_read: misconceptions read offering_concept_stats by offering_id.
  • routes:onboarding enrolls into the current-term offering; new routes/academics.py exposes GET /api/semesters; learn/profile course resolution via enrollments.
Scope decisions
  • gradebook.py deliberately excluded → goes whole to db/gradebook-code (PR3, with curve + drop-lowest, Rewire bell-curve + drop-lowest grading onto the redesigned gradebook (post-redesign) #266), built on this slice's enrollment-by-semester resolver.
  • course_context_service analytics absorbed here (the migrated offering tables force offering-keying, inseparable from the spine) → PR4 shrinks to social.py.
  • Other-slice callers (documents/quiz) degrade gracefully (empty reads / no-op) until their slices land — expected for the WIP-red epic.
  • school is ""/None for now (free-text courses.school retired; schools unpopulated) — frontend/seed follow-up.
Verification
  • Full backend suite: 724 passed; ruff check . clean.
  • New tests/test_academics.py; updated graph_service / shared_course_context / graph_read_tools / onboarding / learn suites.
Plan: docs/superpowers/plans/2026-06-24-db-academics-code.md. Spec: docs/superpowers/specs/2026-06-23-db-modular-redesign-design.md.
Unblocks the parallel code slices (graph / analytics / gradebook / identity / study / ops).
@AndresL230@claude
feat(db): academics-code — rewire app onto courses/offerings/terms/en…
788e8df
…rollments (epic slice PR2)
Code-only slice against the already-landed academics split (migrations 0019-0027).
The public API keeps the abstract `course_id`; the term/semester becomes a real
second axis; enrollment resolves to a per-term offering internally.
- services/academics.py (new): term/offering/enrollment resolver — current_term
(date-derived, latest-term fallback), list_terms, resolve_offering (current term,
create-if-missing so new enrollments land in the real current semester),
offering_course_id, user_offering_ids_for_course, term_for_offering.
- graph_service: enrollments→course_offerings→courses/terms join reshaped to the
legacy flat shape; graph stays keyed on the ABSTRACT course_id; add/color/nickname/
delete resolve offerings; get_courses now surfaces `term`.
- course_context_service: offering-scoped analytics (offering_concept_stats/
offering_summary); resolves offering→abstract course for graph_nodes; semester gone.
- graph_read: misconceptions read offering_concept_stats by offering_id.
- onboarding/graph routes: enroll into the current-term offering; GET /api/semesters
(routes/academics.py) from terms; learn/profile course resolution via enrollments.
`gradebook.py` is intentionally left to db/gradebook-code (PR3, with curve+drop-lowest).
Other-slice callers (documents/quiz) degrade gracefully until their slices land.
Tests: +test_academics; updated graph_service/shared_course_context/graph_read_tools/
onboarding/learn suites. Full backend suite 724 passed; ruff clean.
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@coderabbitai
coderabbitaiBot
commented
Jun 24, 2026

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: 47b9404d-132e-4233-be0a-1ac6689e50ce
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/academics-code
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 24, 2026

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-staging788e8dfCommit Preview URL

Branch Preview URL		Jun 24 2026, 07:50 AM
@AndresL230
AndresL230
merged commit c4fe2a0
into
epic/db-modular-redesignJun 24, 2026

4 checks passed

@AndresL230AndresL230
mentioned this pull request
Jun 24, 2026
 Merged

@AndresL230
AndresL230
deleted the

db/academics-code

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.

1 participant

@AndresL230

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

Skip to content
db/academics-code: rewire app onto courses/offerings/terms/enrollments (epic slice PR2) - #268
Merged
AndresL230 merged 1 commit into
epic/db-modular-redesignfrom 
db/academics-code
Jun 24, 2026
Merged
db/academics-code: rewire app onto courses/offerings/terms/enrollments (epic slice PR2)#268
AndresL230 merged 1 commit into
epic/db-modular-redesignfrom 
db/academics-code
Conversation
@AndresL230
@AndresL230AndresL230
commented
Jun 24, 2026

Copy link


Copy Markdown

Collaborator
Code-only slice (PR2, the spine) of the DB modular redesign. Rewires the application onto the already-landed academics split (migrations 0019–0027 from #264) — no migrations here. Targets the epic branch.
Locked contract (decided with the user)
  • API boundary keeps the abstract course_id. No section/instructor in any contract.
  • Semester/term is the real second axis.GET /api/semesters (from terms); get_courses returns each course's term.
  • Enrollment = (user, offering) internally; offering = (course, current term, section = NULL), created if the catalog lacks it so new enrollments land in the real current semester (not legacy Spring 2026).
  • Knowledge graph stays on the abstract course_id (cumulative); resolved via enrollment.offering_id → course_offerings.course_id.
What changed
  • services/academics.py (new): the term/offering/enrollment resolver everything builds on.
  • graph_service: enrollments→course_offerings→courses/terms join reshaped to the legacy flat shape; enroll/color/nickname/delete resolve offerings; analytics refresh resolves abstract→offerings.
  • course_context_service: offering-scoped analytics (offering_concept_stats/offering_summary); resolves offering→abstract course for graph_nodes; free-text semester gone.
  • graph_read: misconceptions read offering_concept_stats by offering_id.
  • routes:onboarding enrolls into the current-term offering; new routes/academics.py exposes GET /api/semesters; learn/profile course resolution via enrollments.
Scope decisions
  • gradebook.py deliberately excluded → goes whole to db/gradebook-code (PR3, with curve + drop-lowest, Rewire bell-curve + drop-lowest grading onto the redesigned gradebook (post-redesign) #266), built on this slice's enrollment-by-semester resolver.
  • course_context_service analytics absorbed here (the migrated offering tables force offering-keying, inseparable from the spine) → PR4 shrinks to social.py.
  • Other-slice callers (documents/quiz) degrade gracefully (empty reads / no-op) until their slices land — expected for the WIP-red epic.
  • school is ""/None for now (free-text courses.school retired; schools unpopulated) — frontend/seed follow-up.
Verification
  • Full backend suite: 724 passed; ruff check . clean.
  • New tests/test_academics.py; updated graph_service / shared_course_context / graph_read_tools / onboarding / learn suites.
Plan: docs/superpowers/plans/2026-06-24-db-academics-code.md. Spec: docs/superpowers/specs/2026-06-23-db-modular-redesign-design.md.
Unblocks the parallel code slices (graph / analytics / gradebook / identity / study / ops).
@AndresL230@claude
feat(db): academics-code — rewire app onto courses/offerings/terms/en…
788e8df
…rollments (epic slice PR2)
Code-only slice against the already-landed academics split (migrations 0019-0027).
The public API keeps the abstract `course_id`; the term/semester becomes a real
second axis; enrollment resolves to a per-term offering internally.
- services/academics.py (new): term/offering/enrollment resolver — current_term
(date-derived, latest-term fallback), list_terms, resolve_offering (current term,
create-if-missing so new enrollments land in the real current semester),
offering_course_id, user_offering_ids_for_course, term_for_offering.
- graph_service: enrollments→course_offerings→courses/terms join reshaped to the
legacy flat shape; graph stays keyed on the ABSTRACT course_id; add/color/nickname/
delete resolve offerings; get_courses now surfaces `term`.
- course_context_service: offering-scoped analytics (offering_concept_stats/
offering_summary); resolves offering→abstract course for graph_nodes; semester gone.
- graph_read: misconceptions read offering_concept_stats by offering_id.
- onboarding/graph routes: enroll into the current-term offering; GET /api/semesters
(routes/academics.py) from terms; learn/profile course resolution via enrollments.
`gradebook.py` is intentionally left to db/gradebook-code (PR3, with curve+drop-lowest).
Other-slice callers (documents/quiz) degrade gracefully until their slices land.
Tests: +test_academics; updated graph_service/shared_course_context/graph_read_tools/
onboarding/learn suites. Full backend suite 724 passed; ruff clean.
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@coderabbitai
coderabbitaiBot
commented
Jun 24, 2026

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: 47b9404d-132e-4233-be0a-1ac6689e50ce
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/academics-code
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 24, 2026

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-staging788e8dfCommit Preview URL

Branch Preview URL		Jun 24 2026, 07:50 AM
@AndresL230
AndresL230
merged commit c4fe2a0
into
epic/db-modular-redesignJun 24, 2026

4 checks passed

@AndresL230AndresL230
mentioned this pull request
Jun 24, 2026
 Merged

@AndresL230
AndresL230
deleted the

db/academics-code

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.

1 participant

@AndresL230