| title | Decisions |
|---|---|
| description | Why the system is built the way it is |
| audience | architect |
The "why" pages — trade-offs behind the architecture, written for architects (and anyone about to propose changing one of these). Each page states the forces, the costs accepted, and when to revisit.
| Page | Decision |
|---|---|
| Why Flat JSON Files | The filesystem is the datastore |
| Why a Custom JSON Router | ~240 owned lines instead of json-server (+ GraphQL's removal) |
| Why Persistent Writes + Resets | Real CRUD for anyone, healed on a schedule |
| Why a Sandboxed Playground | Untrusted code in a null-origin iframe |