How 2501pr0ject/traboule works
Traboule is a local-first territorial-intelligence engine for answering questions about Lyon Métropole establishments, PLU-H zoning, and written planning rules, with sourced, time-anchored answers and explicit abstention. Its documented workflow combines establishment data, spatially associates locations with zones, and relates zones to rule passages; document extraction and indexing support the rule-retrieval branch. The tree also contains ingestion, geographic reference, and evaluation stages. No query-serving implementation is shown in the sampled files, so the graph does not invent a runtime request pipeline; some documented capabilities are represented as subsystems without asserted call edges.
Main entry points: config.py Project configuration · question.py Question contract · passage.py Passage contract · database.py Local data build
Components 21
Data ingestion
- Source downloads
packages/traboule/ingestion/download.py - Sirene processing
packages/traboule/ingestion/sirene.py - Data catalogue
packages/traboule/catalogue.py - Local data build
packages/traboule/ingestion/database.py - DuckDB datasets
Geographic analysis
- Geo reference
packages/traboule/geo/referentiel.py - Zone association
packages/traboule/geo/jointure.py - Zone confidence
packages/traboule/geo/confiance.py - Count minorants
packages/traboule/geo/minorant.py - Zone-rule mapping
packages/traboule/geo/zones_reglement.py
Rule documents
- Regulation parsing
packages/traboule/retrieval/reglement.py - Cahier parsing
packages/traboule/retrieval/cahiers.py - PDF extraction
packages/traboule/retrieval/extraction.py - Passage splitting
packages/traboule/retrieval/decoupage.py - Vector index
packages/traboule/retrieval/index.py
Contracts and evaluation
- Question contract
packages/traboule/contracts/question.py - Sourced response
packages/traboule/contracts/reponse.py - Passage contract
packages/traboule/contracts/passage.py - Confidence review
packages/traboule/evaluation/tirage.py - Project configuration
packages/traboule/config.py
Other components
- Questioner
Connections 16
- Questioner → Question contract: asks
README.md - Question contract → Sourced response: answered by
README.md - Source downloads → Project configuration: reads settings
packages/traboule/ingestion/download.py - Sirene processing → Project configuration: reads settings
packages/traboule/ingestion/sirene.py - Local data build → Data catalogue: documents tables
packages/traboule/ingestion/database.py - Local data build → DuckDB datasets: builds
packages/traboule/ingestion/database.py - Zone association → Zone confidence: uses confidence
packages/traboule/geo/jointure.py - Zone association → Project configuration: reads thresholds
packages/traboule/geo/jointure.py - Count minorants → Project configuration: reads thresholds
packages/traboule/geo/minorant.py - Regulation parsing → Zone-rule mapping: maps zone codes
packages/traboule/retrieval/reglement.py - Regulation parsing → Passage contract: builds passages
packages/traboule/retrieval/reglement.py - Cahier parsing → Passage contract: builds passages
packages/traboule/retrieval/cahiers.py - Vector index → Passage contract: indexes passages
packages/traboule/retrieval/index.py - Vector index → Zone-rule mapping: uses zone metadata
packages/traboule/retrieval/index.py - Sourced response → Question contract: uses route
packages/traboule/contracts/reponse.py - Confidence review → Project configuration: reads settings
packages/traboule/evaluation/tirage.py