How nadjibsalmi/qleanflow-water-quantum works
QleanFlow is a Ghana water-contamination risk dashboard. Users explore regional summaries, community locations, and contamination comparisons, or enter indicators into a browser-side Random Forest estimator to receive a threshold-based triage score and domain-status warning. The data service reads and aggregates the bundled CSV. Separate model and methodology pages explain validation and limitations; a quantum-kernel demo and QSVC utilities provide historical comparison, not the live inference path. Edges reflect excerpts or SOURCE INDEX references; unsampled capabilities are represented cautiously.
Main entry points: (dashboard)/page.tsx Overview page · regions/page.tsx Regions page · model/page.tsx Model page · Header.tsx Page header
Components 22
Risk exploration
- Overview page
src/app/(dashboard)/page.tsx - Regions page
src/app/(dashboard)/regions/page.tsx - CSV summaries
src/services/waterQualityData.ts - Regional chart
src/components/dashboard/RegionContaminationChart.tsx - Contamination chart
src/components/dashboard/ContaminationTypeChart.tsx - Community map
src/components/dashboard/CommunityMap.tsx
Risk inference
- Deferred estimator
src/components/dashboard/DeferredRandomForestRiskEstimator.tsx - Risk estimator
src/components/dashboard/RandomForestRiskEstimator.tsx - Random Forest inference
src/algorithms/randomForestEstimator.ts
Model comparison
- Model page
src/app/(dashboard)/model/page.tsx - Methodology page
src/app/(dashboard)/methodology/page.tsx - Quantum kernel demo
src/components/dashboard/QuantumKernelDemo.tsx - QSVC utilities
src/algorithms/qsvcEstimator.ts - QSVC parameters
src/algorithms/data/qsvcParams.ts - Quantum simulator
src/algorithms/quantumSimulator.ts
Shared presentation
- Page header
src/components/dashboard/Header.tsx - Mobile navigation
src/components/dashboard/MobileNav.tsx - Sidebar navigation
src/components/dashboard/Sidebar.tsx - Navigation items
src/components/dashboard/navItems.ts - Content card
src/components/ui/Card.tsx - KPI card
src/components/ui/KpiCard.tsx
Other components
- Dashboard user
Connections 29
- Dashboard user → Overview page: opens
src/app/(dashboard)/page.tsx - Dashboard user → Regions page: opens
src/app/(dashboard)/regions/page.tsx - Dashboard user → Model page: opens
src/app/(dashboard)/model/page.tsx - Overview page → CSV summaries: requests summaries
src/app/(dashboard)/page.tsx - Overview page → Deferred estimator: renders
src/app/(dashboard)/page.tsx - Overview page → Regional chart: renders
src/app/(dashboard)/page.tsx - Overview page → Contamination chart: renders
src/app/(dashboard)/page.tsx - Regions page → CSV summaries: requests records
src/app/(dashboard)/regions/page.tsx - Regions page → Community map: renders
src/app/(dashboard)/regions/page.tsx - Community map → CSV summaries: uses records
src/components/dashboard/CommunityMap.tsx - Regional chart → CSV summaries: uses summaries
src/components/dashboard/RegionContaminationChart.tsx - Deferred estimator → Risk estimator: loads
src/components/dashboard/DeferredRandomForestRiskEstimator.tsx - Risk estimator → Random Forest inference: requests estimate
src/components/dashboard/RandomForestRiskEstimator.tsx - Model page → Random Forest inference: reads metadata
src/app/(dashboard)/model/page.tsx - Model page → Quantum kernel demo: renders
src/app/(dashboard)/model/page.tsx - Quantum kernel demo → Quantum simulator: uses simulator
src/components/dashboard/QuantumKernelDemo.tsx - QSVC utilities → Quantum simulator: uses simulator
src/algorithms/qsvcEstimator.ts - QSVC utilities → QSVC parameters: uses parameters
src/algorithms/qsvcEstimator.ts - Overview page → Page header: renders
src/app/(dashboard)/page.tsx - Regions page → Page header: renders
src/app/(dashboard)/regions/page.tsx - Model page → Page header: renders
src/app/(dashboard)/model/page.tsx - Methodology page → Page header: renders
src/app/(dashboard)/methodology/page.tsx - Page header → Mobile navigation: renders
src/components/dashboard/Header.tsx - Mobile navigation → Navigation items: uses links
src/components/dashboard/MobileNav.tsx - Sidebar navigation → Navigation items: uses links
src/components/dashboard/Sidebar.tsx - Overview page → KPI card: renders
src/app/(dashboard)/page.tsx - Overview page → Content card: renders
src/app/(dashboard)/page.tsx - Regions page → Content card: renders
src/app/(dashboard)/regions/page.tsx - Model page → Content card: renders
src/app/(dashboard)/model/page.tsx