How rajeevranjan-023/matrix-compliers works
ShelterIQ turns a location and building brief into climate-adapted shelter recommendations, then presents simulation, comfort, material, sustainability, and comparison results. The principal flow is browser inputs → design API → climate resolution and design computation → interactive results. The route and selected engines were sampled; the internal wiring of the central engine and several result calculations is inferred from module names and response fields, so those uncertain call relationships are not expanded.
Main entry points: App.jsx ShelterIQ app · core.js Design orchestrator · design.js Design API · api.js Browser API client
Components 24
Design workspace
- ShelterIQ app
frontend/src/App.jsx - Design inputs
frontend/src/components/InputPanel.jsx - Design results
frontend/src/components/ResultsPanel.jsx - 3D building view
frontend/src/components/Building3D.jsx - Thermal simulation
frontend/src/components/SimulationChart.jsx - Comfort score
frontend/src/components/ComfortScore.jsx - Design comparison
frontend/src/components/ComparisonPanel.jsx - Materials and cost
frontend/src/components/MaterialTable.jsx - Sustainability
frontend/src/components/SustainabilityPanel.jsx - City comparison
frontend/src/components/MultiLocationPanel.jsx - Browser API client
frontend/src/lib/api.js
Backend workflow
- HTTP server
backend/src/server.js - Design API
backend/src/routes/design.js
Design engines
- Design orchestrator
backend/src/engines/core.js - Climate classifier
backend/src/engines/climateClassifier.js - Design rules
backend/src/engines/designEngine.js - Material selector
backend/src/engines/materialEngine.js - Thermal simulator
backend/src/engines/simulationEngine.js - Baseline comparison
backend/src/engines/comparisonEngine.js - Comfort scoring
backend/src/engines/comfortScore.js
Climate data
- Climate resolver
backend/src/services/weatherService.js - Regional climate profiles
backend/src/data/climateDb.js
Other components
- Designer
- OpenWeather
Connections 27
- Designer → Design inputs: sets brief
- Design inputs → ShelterIQ app: updates inputs
- ShelterIQ app → Browser API client: requests design
- Browser API client → Design API: posts design
- Design API → Climate resolver: resolves climate
- Climate resolver → Regional climate profiles: uses fallback
- Climate resolver → OpenWeather: fetches conditions
- Design API → Design orchestrator: runs design
- Design API → ShelterIQ app: returns results
- ShelterIQ app → Design results: shows results
- ShelterIQ app → 3D building view: renders model
- ShelterIQ app → Thermal simulation: shows simulation
- ShelterIQ app → Comfort score: shows score
- ShelterIQ app → Design comparison: shows comparison
- ShelterIQ app → Materials and cost: shows materials
- ShelterIQ app → Sustainability: shows sustainability
- ShelterIQ app → City comparison: shows city comparison
- ShelterIQ app → Browser API client: loads locations
- Browser API client → Design API: gets locations
- Designer → City comparison: selects city
- City comparison → ShelterIQ app: requests comparison
- Design orchestrator → Climate classifier
- Design orchestrator → Design rules
- Design orchestrator → Material selector
- Design orchestrator → Thermal simulator
- Design orchestrator → Baseline comparison
- Design orchestrator → Comfort scoring