Skip to content

Architecture

Implementation guides for engineers: wire formats, sync protocols, deployment constraints, and diagrams. Product decisions (why, v1 scope, UX principles) stay under Planning.

DocumentWhat it covers
Database schemaImplemented tables, foreign keys, and Mermaid ER diagrams — including study plan templates, tracks, electives, and mentorship curriculum
Note CRDT syncAutomerge note bodies, GraphQL pull/push, server merge, offline client, deployment risks
Rich text formatJSON envelope for note bodies and study plan instructions; TipTap schema, markdown interchange
DocumentUse when
Study plansTemplate resolution, step lifecycle, admin AI
TracksHourglass curriculum, modules, electives, mentor assignment

When adding a new implementation doc, link it here and from the relevant Planning page so product and engineering stay separated.