Chapter 04 / 14

Repository map

Runtime directories

API/: Sanic application, models, migrations, rules, PDF rendering, providers, tools, voice, telephony, tasks, and tests.
PWA/: public PyScript PWA, legal pages, source assets, and browser vendor code.
OPS/: operator PWA and its Python development server.
OTA/: signed update service, configuration, storage, and tests.

Supporting directories

scripts/: Python generators, release checks, OTA publishing, and data pipelines.
documents/: generated static plan, slide, and handbook deployments.
docs/: maintained architecture, safety, operations, decisions, and handbook Markdown.
tests/: cross-surface, artifact, deployment, OTA, slide, and documentation gates.
android/: native shell and clearly separated vendored Java/JavaScript.

Generated-code rule

Maintained project logic is Python. Browser-mandated JavaScript is accepted only as deterministic output of a Python generator. Vendored third-party JavaScript remains vendor code and is tracked by provenance manifests. Generated files say which command owns them and must reproduce byte-for-byte.

Owner: Engineering Reviewed: 2026-09-01 Revision: domain-schema-v2-2026-09-01