The ADM, applied to this platform
Each phase of the Architecture Development Method mapped to artifacts this project actually produced — plus the architecture principles the repo enforces.
Architecture principles
Fakes over mocks
Every external business system is simulated by a real, persistent service with a realistic API — never an in-process mock.
Provider-neutral LLM access
All model access goes through the LLMPort interface; LangChain model wrappers never appear in domain code.
One database per service
Each service owns its own Postgres database on one shared instance; no service reads another's tables.
Explicit orchestration graphs
Agent behavior is defined as explicit LangGraph StateGraphs — no prebuilt agent abstractions.
Decisions live in ADRs and bind
Architecture decisions are recorded in docs/adr and are binding until revised in a commit that also updates dependents.
Honest data basis
Every figure is labeled actual or illustrative, and every simulated component is marked as simulated.
Runnable locally, always
Every demo runs end-to-end via docker compose with seed data and health checks.
Structure follows the TOGAF® Standard, 10th Edition (The Open Group); this page maps the method to artifacts produced in this project and is not affiliated with The Open Group.