Reference¶
For humans and LLM agents writing CORA code, and for code reviewers. Not a tutorial. The rules to honor when modifying CORA so the codebase doesn't drift. If the code disagrees with this page, the code is wrong. For collaboration on the design (not the code), see Contributing.
Pages¶
-
Workflow
Reading order, commits, branch flow, migrations, tests.
-
Layout
BC structure, imports, naming, bootstrap, shared code.
-
Modeling
Event sourcing, value objects, field grouping.
-
Patterns
Read side, query slices, projections, idempotency, cross-aggregate validation.
-
Conventions
Identifiers, units of measurement, personal data, schema-validated values.
-
Runtime
Production hardening, logging, HTTP errors.
-
Glossary
Terms defined once and used the same way in code, commits, and prose.
-
Contributing
What this project is and isn't asking for. Beamline collaborators welcome; drive-by code PRs not.