ecoinboxhub/nigeria-ai-backend

# Nigeria Construction AI Platform (Backend MVP) AI-powered construction management backend for Nigerian projects, focused on delay risk, procurement intelligence, safety/compliance analysis, cost forecasting, workforce optimization, maintenance prediction, progress deviation, and tender risk extraction. ## Scope - Backend-only MVP (no frontend) - FastAPI API gateway with RBAC and token issuance - 10 modular AI service domains - Synthetic-data pipelines to bootstrap training/evaluation - MLflow experiment logging and DVC pipeline stages - Dockerized deployment and GitHub Actions CI ## Repository Structure - `backend/app/main.py`: FastAPI entrypoint - `backend/app/api/v1/router.py`: API gateway routing - `backend/app/modules/*`: Module-specific schemas/services/routes - `backend/pipelines/models/*`: Training scripts for key modules - `backend/pipelines/rag/build_indexes.py`: RAG reference corpus build step - `backend/scripts/bootstrap_data.py`: Synthetic data generator for local MVP runs - `dvc.yaml`: Data/model pipeline orchestration - `.github/workflows/ci.yml`: CI checks and test run ## Module Coverage 1. Project Tracker: ensemble-inspired delay scoring endpoint (`LSTM + DT + RF` stack contract). 2. Procurement Assistant: supplier quote intelligence + ARIMA forecast training script. 3. Safety Dashboard: log analysis endpoint + recall-oriented hazard detector training script. 4. Document Analyzer: clause extraction + compliance scoring endpoint and classifier script. 5. Cost Estimator: Naira-focused estimator endpoint + ensemble regression training script. 6. Workforce Scheduler: shift allocation and idle-rate optimizer. 7. Maintenance Predictor: equipment risk inference + time-series pipeline script. 8. Progress Visualizer: completion deviation analysis with threshold trigger. 9. Tender Analyzer: risk phrase extraction and LLM-style summary output. 10. Integration Suite: API key gated token issuance and RBAC foundation. ## Quickstart 1. Create env file: ```ba …