How khadija10/realstateai works
RealStateAI is a French real-estate decision-support prototype. Its central user journey is to enter property details in the estimation interface, send requests through the shared API client to FastAPI, and receive a DVF-based estimate. The product also exposes market trends, financing dossiers, capital-gains calculations, and estimation history. A separate data pipeline ingests and enriches DVF data; financing calculations have their own domain package. Connections among unsampled page implementations and backend endpoints are limited to documented or indexed evidence.
Main entry points: App.jsx Page router · main.py FastAPI endpoints · client.js HTTP client · pipeline.py Pipeline orchestrator
Components 27
Web application
- Page router
Frontend/src/App.jsx - Estimation page
Frontend/src/pages/EstimationPage.jsx - Market pages
Frontend/src/pages/MarchePage.jsx - Financing page
Frontend/src/pages/FinancementPage.jsx - Capital gains
Frontend/src/pages/PlusValuePage.jsx - Estimation history
Frontend/src/pages/HistoriquePage.jsx - HTTP client
Frontend/src/api/client.js
API and estimation
- FastAPI endpoints
Backend/main.py - Address parsing
Backend/utils/address_parser.py - DVF search
Backend/utils/dvf_search.py - Price calculation
Backend/utils/price_calculation.py - Financing endpoints
Backend/financing_api.py
Property data
- DVF records
- Pipeline orchestrator
data-pipeline/src/realstate_data/pipeline.py - DVF ingestion
data-pipeline/src/realstate_data/ingestion/dvf_downloader.py - Cleaning and dedup
data-pipeline/src/realstate_data/cleaning/silver.py - Data enrichment
data-pipeline/src/realstate_data/enrichment - Feature building
data-pipeline/src/realstate_data/features/gold.py - Quality checks
data-pipeline/src/realstate_data/quality/validators.py
Financing domain
- Loan dossier
financement/src/realstate_financement/dossier.py - Financing agent
financement/src/realstate_financement/agent.py - Loan calculations
financement/src/realstate_financement/moteur.py - Borrower models
financement/src/realstate_financement/modeles.py
Model lifecycle
- Model estimation
ml/estimator.py - Model training
ml/train.py - Model monitoring
ml/monitoring.py
Other components
- Property seeker
Connections 30
- Property seeker → Page router: uses
Frontend/src/App.jsx - Page router → Estimation page: routes to
Frontend/src/App.jsx - Page router → Market pages: routes to
Frontend/src/App.jsx - Page router → Financing page: routes to
Frontend/src/App.jsx - Page router → Capital gains: routes to
Frontend/src/App.jsx - Page router → Estimation history: routes to
Frontend/src/App.jsx - Estimation page → HTTP client: requests via
- Market pages → HTTP client: requests via
- Financing page → HTTP client: requests via
- Capital gains → HTTP client: requests via
- Estimation history → HTTP client: requests via
- HTTP client → FastAPI endpoints: sends HTTP
Frontend/src/api/client.js - FastAPI endpoints → Address parsing: uses parser
Backend/main.py - FastAPI endpoints → DVF search: calls search
Backend/main.py - FastAPI endpoints → Price calculation: calls calculation
Backend/main.py - FastAPI endpoints → Financing endpoints: registers routes
Backend/main.py - Pipeline orchestrator → DVF ingestion: dispatches
data-pipeline/src/realstate_data/pipeline.py - Pipeline orchestrator → Cleaning and dedup: dispatches
data-pipeline/src/realstate_data/pipeline.py - Pipeline orchestrator → Feature building: dispatches
data-pipeline/src/realstate_data/pipeline.py - Pipeline orchestrator → Quality checks: dispatches
data-pipeline/src/realstate_data/pipeline.py - Pipeline orchestrator → Data enrichment: dispatches
data-pipeline/src/realstate_data/pipeline.py - Feature building → Cleaning and dedup: imports
data-pipeline/src/realstate_data/features/gold.py - DVF ingestion → DVF records: downloads
- DVF records → FastAPI endpoints: loads DVF
README.md - Financing endpoints → Loan dossier: generates dossier
Backend/financing_api.py - Loan dossier → Loan calculations: uses calculations
financement/src/realstate_financement/dossier.py - Loan dossier → Borrower models: uses models
financement/src/realstate_financement/dossier.py - Financing agent → Loan calculations: uses tools
financement/src/realstate_financement/agent.py - Model training → Model estimation: trains model
- Model monitoring → Model estimation: monitors model