0009 — The database is the Academy catalog; the TypeScript curriculum is no longer served
A recorded institutional decision, with reasoning and result.
- Authority rank
- 5
- Version
- v1.0
- Adopted
- unrecorded
- Held by
- Stewardship Office
- System
- SYS-10
Source · docs/codices/DECISIONS/0009-academy-catalog-cutover.md · registered by rule
Date: 2026-08-01 · Office: Technology (DIV-05), with the Academy (DIV-01) · Review: 2027-02-01
Extends: DECISIONS/0005 (the Standards), and the Codex V data foundation. Governs SURF-11, ENG-02, SYS-02 (Learning).
1. Decision
a. The canonical Academy catalog is the database. lrn_schools, lrn_programs, lrn_courses, lrn_modules, and lrn_lessons are the single source of the seven schools, their 45 programs, 443 courses, 904 modules, and 2,957 lessons, each lesson carrying its written body.
b. There is no fallback. src/lib/academy-catalog.server.ts no longer serves the TypeScript curriculum when a canonical row is absent. A miss is logged and the surface reports the absence; a course absent from the database is absent from the Academy. Two sources of truth for one catalog violated Article Zero's "one place" (Codex 0 §00) and hid publication state from the faculty.
c. The TypeScript curriculum is retained as authoring input only. src/lib/academy/ remains the origin of the import (scripts/import-academy.ts) and the origin of the shared editorial types the surfaces render. It is never read at request time.
d. Publication state governs advance, not visibility of the record. Course and lesson lifecycle stays with the faculty workflow (/faculty), where each transition is recorded with the reason given for it.
2. Why
Parity was verified before the cutover: every school, program, course, module, and lesson present in the TypeScript curriculum is present in the database, and every lesson has a body. Keeping a silent fallback past that point meant the institution could not tell a complete catalog from a broken read.
3. What was traded
The surfaces are now dependent on a single system at request time. That debt is repaid by the logged miss, which names the exact route that failed, and by the faculty dossier, which names what is outstanding before a course may be published.
4. Result — to be written at review
Recorded 2027-02-01 whether or not it flatters the decision: how many canonical misses were logged, and whether any surface degraded for a reader.