How freyderpd07/waterqualitysensors works
WaterMLdetect monitors community water quality: sensor readings arrive through LoRaWAN/MQTT or direct HTTP, are normalized and classified, stored separately from derived predictions, and exposed through public and authenticated dashboards. Users can also ask HelioWater questions and submit alteration reports; administrators manage reports. The README documents additional dashboard capabilities, including alerting, prediction views, network status, and CSV export. Edges reflect excerpted calls, indexed imports, or README statements; some frontend/API details and unsampled subsystems are documented rather than directly inspected.
Main entry points: api.js REST API · lecturasRepository.js Raw readings · index.js Gateway bootstrap · ia.js HelioWater service
Components 25
Sensor acquisition
- LoRaWAN sensors
- TTN / ChirpStack
- MQTT ingestion
gateway/src/mqtt.js - HTTP sensor intake
gateway/src/ttnSensor.js
Gateway services
- Gateway bootstrap
gateway/src/index.js - REST API
gateway/src/api.js - Accounts and JWT
gateway/src/auth.js - Quality classification
gateway/src/calidad.js - Alteration reports
gateway/src/reportes.js - Demo simulator
gateway/src/simulador.js
Water data
- Raw readings
gateway/src/lecturasRepository.js - ML predictions
gateway/src/prediccionesRepository.js - MongoDB
Web experience
- Public water status
frontend/index.html - Authenticated dashboard
frontend/app/index.js - Dashboard charts
frontend/app/grafica.js - Login and registration
frontend/app/login.js - Profile management
frontend/app/perfil.js - HelioWater chat
frontend/app/chat.js - Report workflow
frontend/app/index.js
AI assistant
- HelioWater service
gateway/src/ia.js - Assistant prompt
gateway/prompts/asistente_agua.md - OpenRouter
Other components
- Community users
- Administrator
Connections 37
- LoRaWAN sensors → TTN / ChirpStack: sends uplinks
README.md - TTN / ChirpStack → MQTT ingestion: forwards MQTT
README.md - MQTT ingestion → Raw readings: saves readings
gateway/src/mqtt.js - HTTP sensor intake → Raw readings: saves readings
gateway/src/ttnSensor.js - Gateway bootstrap → MQTT ingestion: starts client
gateway/src/index.js - Gateway bootstrap → REST API: registers routes
gateway/src/index.js - Gateway bootstrap → Accounts and JWT: registers routes
gateway/src/index.js - Gateway bootstrap → Alteration reports: registers routes
gateway/src/index.js - Gateway bootstrap → HTTP sensor intake: registers routes
gateway/src/index.js - Raw readings → Quality classification: normalizes with
gateway/src/lecturasRepository.js - Raw readings → ML predictions: registers prediction
gateway/src/lecturasRepository.js - ML predictions → MongoDB: stores predictions
gateway/src/prediccionesRepository.js - Raw readings → MongoDB: stores readings
gateway/src/lecturasRepository.js - REST API → Raw readings: queries readings
gateway/src/api.js - REST API → ML predictions: queries predictions
gateway/src/api.js - REST API → Quality classification: generates alerts
gateway/src/api.js - REST API → Demo simulator: uses demo data
gateway/src/api.js - Community users → Public water status: views status
README.md - Community users → Authenticated dashboard: views dashboard
README.md - Authenticated dashboard → REST API: requests data
README.md - Public water status → REST API: requests status
README.md - Authenticated dashboard → Dashboard charts: renders charts
- Community users → Login and registration: registers or signs in
README.md - Login and registration → Accounts and JWT: authenticates
README.md - Community users → Profile management: edits profile
README.md - Profile management → Accounts and JWT: updates account
- Community users → HelioWater chat: asks questions
README.md - HelioWater chat → REST API: sends chat request
- REST API → HelioWater service: answers questions
gateway/src/api.js - HelioWater service → Quality classification: uses thresholds
gateway/src/ia.js - HelioWater service → Assistant prompt: loads prompt
gateway/src/ia.js - HelioWater service → OpenRouter: calls model
gateway/src/ia.js - Community users → Report workflow: submits report
README.md - Report workflow → Alteration reports: posts report
- Alteration reports → MongoDB: stores reports
gateway/src/reportes.js - Administrator → Alteration reports: reviews reports
README.md - Administrator → Authenticated dashboard: exports CSV
README.md