Adviser, Advisor, and the Cost of One Letter
A legal noun, a product-language variant, and a search synonym can coexist only when the content model assigns each one a job.
Read noteENGINEERING NOTES
How the training portal works.
Source-backed field notes on the architecture, safeguards, and operating choices behind this self-hosted, shared-LAN learning system.
Read the first note Implementation documentation for this private LAN deployment.
BUILD LOG
Inside the implementation
Each note connects design decisions to concrete implementation details, operational constraints, and the portal surfaces they support.
Inside the LAN: Next.js, PostgreSQL, and One Shared Learning State
The portal is a small two-service system with explicit server boundaries, durable shared state, and an operational trust assumption that must not be mistaken for authentication.
Read noteFrom TypeScript Graph to Immutable Curriculum Release
The curriculum is authored as typed relationships, validated as a complete graph, exported as a content-addressed artifact, and only then published to PostgreSQL.
Read noteCases Before Checkmarks: Engineering Interactive Lessons for Judgment
Four-section lessons combine explanatory prose, a client decision, an accessible visual, exam transfer, and feedback that teaches why every choice succeeds or fails.
Read noteAssessment Realism Without Counterfeit Authority
Blueprint arithmetic, original items, deferred-feedback mechanics, and explicit non-endorsement copy create useful practice without impersonating NASAA.
Read noteFreeze the Attempt, Grade on the Server
Question revisions become session snapshots, learner APIs receive reduced payloads, and transactional locks make response and finish semantics explicit.
Read noteOne Curriculum, Multiple Paths, and a Story That Never Locks the Door
Typed pathways and a fictional campaign project the same thirty lessons into different planning experiences without duplicating content or turning progress into a credential.
Read noteVisual Meaning, Text Equivalence, and Browser-Provided Narration
Typed visuals render semantically, purposeful images carry complete teaching equivalents, and learner-initiated narration uses voices supplied by the browser.
Read noteTest the Pointer Path and the One-Point Boundary
Playwright drives visible learner controls across success and failure bands, then proves that 91 and 92 scored answers remain different even when pretest performance reverses.
Read noteDraft, Publish, Deploy, Back Up, Roll Back
Transactional content administration and versioned pve21 releases reduce partial-state failures, while explicit recovery boundaries keep operational confidence grounded.
Read note