Repository directory map
Where everything lives in the trustrelay-atlas
repository, and which doc page explains it.
Backend — src/
| Path | What | Docs |
|---|---|---|
src/api/ | FastAPI app, routers, middleware | Backend, API |
src/database/ | asyncpg pool, repositories | Data model |
src/ontology/ | Resolution, reconciliation, survivorship, synthesis | Entity resolution, Claims |
src/integrations/ | Plugin loader, provider router, TranslationRegistry | Plugins |
src/graph/ | Neo4j/AGE clients, sync, parity | Graph sync |
src/temporal/ | Durable workflows & activities | Temporal workflows |
src/mutation_queue/ | Mutation & conflict provenance | Mutation queue |
src/risk_matrix/ | Configurable risk engine | Risk scoring |
src/reference_data/ | Versioned reference datasets | Reference data |
src/source_contracts/ | Provider field contracts | Source contracts |
src/ontology_schema/ | Schema versioning & field configs | Ontology |
src/pipelines/ | LangGraph pipelines, model factory | Ingestion |
src/tools/ | MCP tool adapters | Plugins |
src/services/ | Reports, MinIO, geocoding | Reporting |
src/security/ | AES-GCM credential encryption | Security |
src/observability/ | Langfuse tracing | Observability |
src/workflows/ | Low-code workflow engine | ADR-007 |
src/models/, src/events/, src/settings/ | Models, domain events, settings | Backend |
Frontend — frontend/src/
| Path | What | Docs |
|---|---|---|
api/, hooks/ | Axios client, query keys, domain hooks | Frontend |
auth/ | Keycloak + tenant providers | Authentication |
components/, pages/ | UI components and routes | Frontend |
stores/ | Zustand state | Frontend |
Supporting trees
| Path | What | Docs |
|---|---|---|
plugins/ | _example, kvk, northdata, osint | Plugins |
schemas/ontology/ontology_v3.5.yaml | Active ontology | Ontology schema |
migrations/ | 130+ Flyway scripts | Data model |
charts/api, charts/ui, charts/worker | Helm charts | Deployment |
config/ | Workflow & risk-matrix schemas, reference data | Risk scoring |
docs/, docs/adr/ | Source docs & ADRs | ADRs |
.planning/ | Roadmap, phases, milestones | — |
Phase context
The platform is built in numbered phases recorded under .planning/phases/. Several are
referenced throughout these docs — for example Phase 85 (RLS), Phase 96.1 (protected fields &
NorthData attrs), Phases 109–111 (entity claims), Phase 113.2 (ontology v3.5.2), and Phase 114
(TranslationRegistry). The phase history is the narrative behind the architecture decisions.