GovFinance V1 — MVP
Sovereign AI financial assistant for French local governments. Built as a controlled architecture with a deterministic rules engine and a source-cited AI orchestration layer, not a generic chatbot. Every figure shown to a public officer traces back to a file and a row number.
⚙️
Tech Stack
Docker · Sovereign hosting
đź§
Core Technologies
- Next.js 14 — App Router · server components · SSR dashboards
- Python FastAPI — Ingestion · rules engine · async pipelines
- pgvector RAG — Embeddings on imported finance docs + audit traceback
- Claude API — Structured output · citations · explanation · confidence
📦
V1 Deliverables
âś“
Drag-drop import of XLSX / CSV public-finance files
V1âś“
Semi-automatic column mapping with confidence scoring
V1âś“
Quality checks · duplicates · missing market refs · coherence
V1âś“
Budget execution dashboards · chapters · articles · drill-down
V1âś“
Engagements & mandatements tracking with age flags
V1âś“
Supplier concentration analytics + duplicate fusion workflow
V1âś“
AI chat with structured sourced answers (citations · limits · confidence)
V1âś“
15 deterministic alert rules · severity · explanation · recommendation
V1âś“
Note generation · Word / PDF / Excel export
V1âś“
Multi-tenant isolation · per-collectivité data segregation
V1âś“
Role-based access (DGS · DAF · agent · lecture seule)
V1âś“
Audit log of every AI answer and rule trigger
V1→
API connectors · Berger-Levrault eGF
V2→
API connectors · JVS Mairistem
V2→
API connectors · Civil-Net Finances
V2→
Real-time sync vs nightly batch imports
V2→
Forecasting engine · seasonality + DM scenarios
V2→
Regulatory document generation (DOB · ROB · CA)
V2→
DGFiP integration · Hélios / PES V2
V2→
Advanced supplier risk scoring · public-market compliance
V2
🏛
Architecture Layers
CLIENT
Next.js 14 · TypeScript · Tailwind · server components
DATA INGESTION
Pandas · openpyxl · column-mapping ML · quality checks
RULES ENGINE
Python deterministic rules · 15 contrôles · audit trail
RAG INDEX
pgvector · LlamaIndex · embeddings cited by file+row
AI ORCHESTRATION
Claude API · structured output · sources · confidence
DASHBOARDS
Chapters · suppliers · alerts · drill-down · drift
EXPORTS
Word · PDF · Excel · notes · DOB / ROB templates
AUTH & AUDIT
NextAuth · RBAC · per-tenant isolation · immutable logs