How muhil-amuthan/carbonwise-application works
CarbonWise is a carbon-intelligence platform for consumers and city/system administrators. The documented workflow runs from user and city sensor/device activity through the Spring API and AI forecasts/recommendations to dashboards, appliance timing, alerts, and reports; IoT devices exchange telemetry and control messages over MQTT. The graph preserves the major documented capabilities, but several are represented at directory level because their implementation files were not sampled. Some README integrations are documented architecture rather than verified runtime calls.
Main entry points: controller REST Controllers · app.py AI HTTP API · mqtt_gateway.py MQTT Gateway · AuthService.java Authentication
Components 27
Spring API
- REST Controllers
carbonwise-backend/src/main/java/com/carbonwise/controller - Authentication
carbonwise-backend/src/main/java/com/carbonwise/service/AuthService.java - Appliance Devices
carbonwise-backend/src/main/java/com/carbonwise/controller/DeviceController.java - Scheduling
carbonwise-backend/src/main/java/com/carbonwise/controller/ScheduleController.java - City GIS
carbonwise-backend/src/main/java/com/carbonwise/controller/GisController.java - Sensor Monitoring
carbonwise-backend/src/main/java/com/carbonwise/controller/SensorController.java - Reports
carbonwise-backend/src/main/java/com/carbonwise/service/ReportService.java - Notifications
carbonwise-backend/src/main/java/com/carbonwise/notification/NotificationService.java - AI Service Client
carbonwise-backend/src/main/java/com/carbonwise/ai/AiServiceClient.java - Prediction Service
carbonwise-backend/src/main/java/com/carbonwise/service/PredictionService.java
Carbon Intelligence
- AI HTTP API
carbonwise-ai/api/app.py - Carbon Predictor
carbonwise-ai/prediction/predictor.py - Recommendation Engine
carbonwise-ai/recommendation/recommender.py - Model Training
carbonwise-ai/training/train.py - Data Cleaning
carbonwise-ai/preprocessing/data_cleaner.py - Model Evaluation
carbonwise-ai/evaluation/evaluate.py
IoT Network
- MQTT Service
carbonwise-backend/src/main/java/com/carbonwise/mqtt/MqttService.java - MQTT Gateway
carbonwise-iot/gateway/mqtt_gateway.py - ESP32 Sensor
carbonwise-iot/esp32/sensor_node.cpp - Device Controllers
carbonwise-iot/firmware
Persistence
- PostgreSQL
Other components
- Consumer
- City Admin
- System Admin
- MQTT Broker
- Google Maps API
- Firebase Services
Connections 27
- Consumer → REST Controllers: uses
README.md - City Admin → REST Controllers: uses
README.md - System Admin → REST Controllers: uses
README.md - REST Controllers → Authentication: routes auth
- REST Controllers → Appliance Devices: routes devices
- REST Controllers → Scheduling: routes schedules
- REST Controllers → City GIS: routes GIS
- REST Controllers → Sensor Monitoring: routes sensors
- REST Controllers → Reports: routes reports
- REST Controllers → Notifications: routes alerts
- REST Controllers → Prediction Service: routes forecasts
- Prediction Service → AI HTTP API: requests forecast
carbonwise-backend/src/main/java/com/carbonwise/service/PredictionService.java - AI HTTP API → Carbon Predictor: calls
carbonwise-ai/api/app.py - AI HTTP API → Recommendation Engine: calls
carbonwise-ai/api/app.py - City GIS → Google Maps API: map integration
README.md - Sensor Monitoring → MQTT Service: telemetry path
README.md - MQTT Service → MQTT Broker: communicates
README.md - MQTT Gateway → MQTT Broker: communicates
README.md - ESP32 Sensor → MQTT Gateway: sends telemetry
README.md - Device Controllers → MQTT Gateway: receives control
README.md - Authentication → PostgreSQL: persists users
- Appliance Devices → PostgreSQL: reads/writes devices
- Reports → PostgreSQL: reads reports
carbonwise-backend/src/main/java/com/carbonwise/service/ReportService.java - Notifications → PostgreSQL: saves alerts
carbonwise-backend/src/main/java/com/carbonwise/notification/NotificationService.java - Model Training → Data Cleaning: uses cleaned data
- Model Evaluation → Model Training: evaluates models
- REST Controllers → Firebase Services: push/storage integration
README.md