Repository Layout¶

This page gives a curated view of the repository tree. It is intentionally more useful than a raw tree dump: it keeps the folders that matter for architecture and omits generated directories such as .venv/, node_modules/, and docs/_build/.

Figure 1: Repository domains¶

        flowchart TB
    ROOT[Repository root]
    ROOT --> FE[frontend/]
    ROOT --> STATIC[homepage/ + onboarding/]
    ROOT --> SVC[services/]
    ROOT --> PKG[packages/]
    ROOT --> BACK[backend/]
    ROOT --> INFRA[infra/]
    ROOT --> MON[monitoring/]
    ROOT --> DOCS[docs/]
    ROOT --> TESTS[tests/]

    SVC --> ONLINE[Python APIs and workers]
    SVC --> IMPORT[importer services and shared ingestion crate]
    PKG --> CORE[shared runtime and retrieval libraries]
    BACK --> RUST[Rust web/document API]

Curated project tree¶

.
├── docker-compose.yaml
├── frontend/
│   ├── public/
│   └── src/
├── homepage/
├── onboarding/
├── services/
│   ├── api-gateway/
│   ├── rag-service/
│   ├── rerank-service/
│   ├── embedding-service/
│   ├── chunking-worker/
│   ├── embedding-worker/
│   ├── extraction-worker/
│   ├── ingestion_service/
│   ├── eurlex_service/
│   ├── eba_service/
│   ├── esma_service/
│   ├── eiopa_service/
│   ├── amf_*_service/
│   ├── legifrance_service/
│   ├── pdf_extract/
│   └── cors-proxy/
├── packages/
│   ├── lalandre_core/
│   ├── lalandre_rag/
│   ├── lalandre_embedding/
│   ├── lalandre_extraction/
│   ├── lalandre_db_postgres/
│   ├── lalandre_db_qdrant/
│   ├── lalandre_db_neo4j/
│   └── lalandre_chunking/
├── backend/
│   └── src/
├── infra/
│   ├── compose/
│   ├── postgres/
│   ├── qdrant/
│   ├── neo4j/
│   └── importers/
├── monitoring/
│   ├── grafana/
│   ├── postgres_exporter/
│   ├── docker_stats_exporter/
│   └── vault/
├── docs/
│   ├── getting-started/
│   ├── architecture/
│   ├── runtime/
│   └── operations/
├── scripts/
└── tests/

How to navigate the codebase¶

If you want to understand…	Start here
the chat runtime	`services/rag-service/` and `packages/lalandre_rag/`
shared config and LLM plumbing	`packages/lalandre_core/`
graph and retrieval behavior	`packages/lalandre_rag/lalandre_rag/graph/` and `packages/lalandre_rag/lalandre_rag/retrieval/`
Rust importer flow	`services/*_service/` and `services/ingestion_service/`
Rust web/document API	`backend/src/`
ingestion and enrichment workers	`services/chunking-worker/`, `services/embedding-worker/`, `services/extraction-worker/`
deployment topology	`infra/compose/`
dashboards and metrics	`monitoring/` and `docs/operations/`
static production surfaces	`frontend/`, `homepage/`, and `onboarding/`
test coverage	`tests/` and package-local `tests/` folders

Reading order for new contributors¶

Read System Overview.
Read Architecture Notes.
Read Request Flow.
Read Agentic Runtime if you need the retrieval planner details.