How ciphrchai/bhumi-x works
BHUMI-X is an urban-planning decision-support platform for exploring parcels, assessing environmental and development conditions, and comparing scenarios. Its user workflow is routed through React pages; the explorer combines parcel data with interactive mapping, while analysis and simulation pages support decision-making. FastAPI exposes separate parcel, geospatial, analysis, data-health, reporting, simulation, and ML endpoints. The README describes the broader data-to-decision stages and capabilities; some implementation details and frontend-to-backend endpoint mappings were not shown, so those links are omitted.
Main entry points: App.tsx Route application · index.ts Service exports · main.py FastAPI application · parcelService.ts Parcel service
Components 30
Application UI
- Route application
src/App.tsx - Parcel explorer
src/pages/ExplorerPage.tsx - GIS map
src/components/gis/MapContainer.tsx - Parcel intelligence
src/pages/ParcelPage.tsx - Spatial analysis
src/pages/AnalysisPage.tsx - Analysis results
src/pages/ResultsPage.tsx - Scenario simulator
src/pages/SimulatorPage.tsx - Urban planning
src/pages/UrbanPlanningPage.tsx - Decision overview
src/pages/OverviewPage.tsx - Reports
src/pages/ReportsPage.tsx - Data health
src/pages/DataHealthPage.tsx - Planning scene
src/components/urban-planning/PlanningScene.tsx
Frontend Data
- Service exports
src/services/index.ts - Parcel service
src/services/parcelService.ts - Analysis service
src/services/analysisService.ts - Simulation service
src/services/simulationService.ts - Report service
src/services/reportService.ts - Data-health service
src/services/dataHealthService.ts - API and mock config
src/services/config.ts
API Capabilities
- FastAPI application
backend/app/main.py - Parcel endpoints
backend/app/routers/parcels.py - GeoJSON endpoints
backend/app/routers/geojson.py - Analysis endpoints
backend/app/routers/analysis.py - Data-health endpoints
backend/app/routers/data_health.py - Report endpoints
backend/app/routers/reports.py - Simulation endpoints
backend/app/routers/simulation.py - ML endpoints
backend/app/routers/ml.py
ML Workbench
- Dataset generation
ml/generate_bhumi_x_dataset.py - Local explanations
ml/local_explanation.py
Other components
- Planner or developer
Connections 41
- Planner or developer → Route application: uses
src/App.tsx - Route application → Parcel explorer: routes to
src/App.tsx - Route application → Parcel intelligence: routes to
src/App.tsx - Route application → Spatial analysis: routes to
src/App.tsx - Route application → Analysis results: routes to
src/App.tsx - Route application → Scenario simulator: routes to
src/App.tsx - Route application → Urban planning: routes to
src/App.tsx - Route application → Decision overview: routes to
src/App.tsx - Route application → Reports: routes to
src/App.tsx - Route application → Data health: routes to
src/App.tsx - Parcel explorer → GIS map: renders
src/pages/ExplorerPage.tsx - Parcel explorer → Parcel service: loads parcels
src/pages/ExplorerPage.tsx - GIS map → Parcel service: loads GeoJSON
- Parcel intelligence → Service exports: uses services
src/pages/ParcelPage.tsx - Spatial analysis → Service exports: uses services
src/pages/AnalysisPage.tsx - Analysis results → Analysis service: loads results
src/pages/ResultsPage.tsx - Analysis results → Parcel service: loads parcels
src/pages/ResultsPage.tsx - Scenario simulator → Service exports: uses services
src/pages/SimulatorPage.tsx - Planning scene → Urban planning: renders scene
- Service exports → Parcel service: exports
src/services/index.ts - Service exports → Analysis service: exports
src/services/index.ts - Service exports → Simulation service: exports
src/services/index.ts - Service exports → Report service: exports
src/services/index.ts - Service exports → Data-health service: exports
src/services/index.ts - Parcel service → API and mock config: requests API
src/services/parcelService.ts - Analysis service → API and mock config: requests API
src/services/analysisService.ts - Simulation service → API and mock config: requests API
src/services/simulationService.ts - Report service → API and mock config: requests API
src/services/reportService.ts - Data-health service → API and mock config: requests API
src/services/dataHealthService.ts - FastAPI application → GeoJSON endpoints: registers router
backend/app/main.py - FastAPI application → Parcel endpoints: registers router
backend/app/main.py - FastAPI application → Analysis endpoints: registers router
backend/app/main.py - FastAPI application → Data-health endpoints: registers router
backend/app/main.py - FastAPI application → Report endpoints: registers router
backend/app/main.py - FastAPI application → Simulation endpoints: registers router
backend/app/main.py - FastAPI application → ML endpoints: registers router
backend/app/main.py - Report endpoints → Analysis endpoints: uses analysis
backend/app/routers/reports.py - Analysis endpoints → Parcel endpoints: uses parcel data
- Simulation endpoints → Analysis endpoints: uses analysis
- ML endpoints → Local explanations: explains predictions
- Dataset generation → ML endpoints: supplies data