How masamune21-dev/kusumavisionnms works
KusumaVision NMS is an FTTH network-management platform for ZTE, C-Data, and HiOSO OLTs, with a Laravel/Vue web interface and an Android client. Operators monitor OLTs and ONUs, provision and manage devices, map customers and ODPs, and respond to alarms; REST API v1 supports integrations. The graph also preserves documented reporting, administration, GenieACS, Telegram, and FCM capabilities. Several subsystems are represented at directory level because their source was not sampled; links based on documented product behavior cite the README.
Main entry points: SmartOltController.php OLT operations · Dashboard.vue Web interface · OnuActionController.php ONU actions API · AlarmEvaluator.php Alarm evaluator
Components 25
Access and API
- Web interface
resources/js/Pages/Dashboard.vue - Android app
mobile/android/app/src/main/kotlin/net/kusumavision/kusumavision_nms/MainActivity.kt - REST API v1
routes/api.php
OLT Operations
- OLT operations
app/Http/Controllers/SmartOltController.php - ONU actions API
app/Http/Controllers/Api/V1/OnuActionController.php - ONU inventory
app/Services/OnuInventoryService.php - Vendor driver resolver
app/Services/SmartOltSnmpServiceResolver.php - ZTE management
app/Services/ZteRemoteOnuService.php - C-Data management
app/Services/CData - HiOSO management
app/Services/Hioso/HiosoEponSnmpService.php - SNMP client
app/Services/Snmp/OltSnmpClient.php - Go SNMP poller
cmd/kv-snmp-poller/main.go
Mapping and ACS
- ONU and ODP map
app/Services/Map/OnuMapPayloadService.php - GenieACS bridge
app/Services/Genieacs
Alarms and Messaging
- Alarm evaluator
app/Services/AlarmEvaluator.php - Alarm records
app/Models/AlarmEvent.php - Telegram notifications
app/Services/Telegram/TelegramNotifier.php - Android push
app/Services/Fcm/FcmAlarmNotifier.php
Platform Services
- Reports and exports
app/Services/Report/ReportService.php - Administration and audit
app/Http/Controllers/SettingsController.php - Application data
app/Models/SnmpOlt.php
Other components
- Network operator
- Managed OLTs
- GenieACS server
- Telegram platform
Connections 33
- Network operator → Web interface: uses
- Network operator → Android app: uses
- Web interface → OLT operations: operates through
- Android app → REST API v1: requests
- REST API v1 → ONU actions API: routes actions
app/Http/Controllers/Api/V1/OnuActionController.php - OLT operations → ONU inventory: collects inventory
app/Http/Controllers/SmartOltController.php - OLT operations → ZTE management: manages ONUs
app/Http/Controllers/SmartOltController.php - ONU actions API → ZTE management: dispatches ZTE actions
app/Http/Controllers/Api/V1/OnuActionController.php - ONU actions API → C-Data management: dispatches C-Data actions
app/Http/Controllers/Api/V1/OnuActionController.php - ONU actions API → HiOSO management: dispatches HiOSO actions
app/Http/Controllers/Api/V1/OnuActionController.php - Vendor driver resolver → C-Data management: resolves driver
app/Services/SmartOltSnmpServiceResolver.php - Vendor driver resolver → HiOSO management: resolves driver
app/Services/SmartOltSnmpServiceResolver.php - Vendor driver resolver → SNMP client: uses SNMP helpers
app/Services/SmartOltSnmpServiceResolver.php - OLT operations → Vendor driver resolver: selects vendor driver
app/Http/Controllers/SmartOltController.php - ONU inventory → SNMP client: reads device state
- SNMP client → Managed OLTs: queries
- ZTE management → Managed OLTs: provisions and manages
- C-Data management → Managed OLTs: manages
- HiOSO management → Managed OLTs: manages
- Go SNMP poller → Managed OLTs: polls
- Web interface → ONU and ODP map: views customer map
- Web interface → GenieACS bridge: uses ACS features
- GenieACS bridge → GenieACS server: calls NBI
- OLT operations → Alarm evaluator: supports alarm operations
app/Http/Controllers/SmartOltController.php - Alarm evaluator → Alarm records: records events
app/Models/AlarmEvent.php - Alarm evaluator → Telegram notifications: notifies
- Telegram notifications → Telegram platform: sends messages
app/Services/Telegram/TelegramNotifier.php - Alarm evaluator → Android push: sends push alerts
app/Services/Fcm/FcmAlarmNotifier.php - Android push → Android app: delivers notifications
- Web interface → Reports and exports: exports reports
- Network operator → Administration and audit: administers
- Administration and audit → Application data: manages settings
- OLT operations → Application data: reads and updates OLTs
app/Http/Controllers/SmartOltController.php