Integrations
Owner: Architecture
Reviewers: Backend, DevOps, Operations
Status: Draft
Version: 0.1
Last Updated: 2026-09-16
Review Cycle: Per integration change
| Integration |
Usage |
Status |
| PostgreSQL / TimescaleDB |
Core business data and telemetry. |
CONFIRMED |
| Redis |
Runtime cache/session support. |
CONFIRMED |
| Mosquitto MQTT |
Device telemetry and local command broker. |
CONFIRMED |
| Telegraf |
MQTT-to-database staging ingestion. |
CONFIRMED |
| IoT worker |
Telemetry normalization and optional cloud ingest hooks. |
CONFIRMED |
| Google Cloud Storage |
File/storage support from backend dependency. |
CONFIRMED |
| Gmail/nodemailer |
Email sending for tickets/password/notifications. |
PARTIAL |
| Kubernetes/GKE |
Backend API deployment target. |
CONFIRMED |
SRS Integration Requirements
| Code |
Integration |
Requirement |
Current Status |
| INT-01 |
Sensor data ingestion |
Receive sensor data through push or pull; final mechanism depends on device/gateway design. |
PARTIAL |
| INT-02 |
Device control gateway |
Send on/off/mode commands and receive execution responses. |
PARTIAL |
| INT-03 |
Email service |
Send reset password, ticket, escalation and weekly report emails. |
PARTIAL |
| INT-04 |
Push notification |
Mobile app receives push notifications for alerts, tickets and important events. |
PARTIAL / PLANNED |
| INT-05 |
Object storage |
Store ticket photos/videos, chatbot images and exported report files with access control. |
PARTIAL |
| INT-06 |
AI/LLM service |
Integrate AI services for chatbot, image analysis and recommendations by phase. |
PLANNED |
| INT-07 |
Future channels |
SMS, Zalo and automated calls are future channels, not MVP requirements. |
FUTURE |
Open Decisions
- Production email provider and domain authentication.
- Production MQTT broker strategy and device credential lifecycle.
- Storage bucket naming, access policy and retention.
- Monitoring/logging/alert provider.
- Push notification provider and mobile delivery SLA.
- Future communication channels, including SMS/Zalo/calls.