How bode327/kusumavisionnms works
KusumaVision NMS is an FTTH network management platform for multi-vendor OLTs. Operators use the web UI or REST API to monitor equipment, provision and manage ONUs, and work with alarms, maps, and reports; Android clients provide a mobile path to monitoring and actions. The architecture separates HTTP interfaces, vendor-specific network access, persisted network state, and operational integrations. README statements support several product-level links; sampled source confirms selected service calls, while unsampled subsystems are represented without speculative internal wiring.
Main entry points: SmartOltController.php Web controllers · api.php REST API v1 · SmartOltSnmpServiceResolver.php Vendor selection · AlarmEvaluator.php Alarm evaluation
Components 25
User interfaces
- Web controllers
app/Http/Controllers/SmartOltController.php - Web UI
resources/js/Pages/SmartOlt - REST API v1
routes/api.php - Android app
mobile/android/app/src/main/kotlin/net/kusumavision/kusumavision_nms/MainActivity.kt
OLT operations
- Vendor selection
app/Services/SmartOltSnmpServiceResolver.php - ZTE SNMP client
app/Services/Snmp/OltSnmpClient.php - HiOSO driver
app/Services/Hioso/HiosoEponSnmpService.php - HsAirPo CLI
app/Services/HsAirPo/HsAirPoCliService.php - ZTE provisioning
app/Services/ZteCliProvisioningExecutor.php - OLT capabilities
app/Support/SmartOltSupport.php - Go SNMP poller
cmd/kv-snmp-poller/main.go
Network state
- OLT inventory
app/Models/SnmpOlt.php - ONU–ODP mapping
app/Services/OnuOdpService.php - Map pins
app/Models/OnuMapPin.php - Users and roles
app/Models/User.php
Operations
- Alarm evaluation
app/Services/AlarmEvaluator.php - Telegram notifications
app/Services/Telegram/TelegramNotifier.php - FCM push
app/Services/Fcm/FcmAlarmNotifier.php - Telegram bot
app/Services/Telegram/TelegramOnuQueryService.php - Webhook management
app/Services/Telegram/TelegramWebhookManager.php - Reports and audit
app/Services/Report/ReportService.php
External integrations
- Managed OLTs
- Telegram service
- Android devices
Other components
- Network operator
Connections 26
- Network operator → Web UI: uses
README.md - Web UI → Web controllers: requests
README.md - Web controllers → OLT inventory: reads and updates
app/Http/Controllers/SmartOltController.php - Web controllers → Vendor selection: resolves driver
app/Http/Controllers/SmartOltController.php - Web controllers → ONU–ODP mapping: loads ODP options
app/Http/Controllers/SmartOltController.php - Network operator → REST API v1: integrates
README.md - REST API v1 → Managed OLTs: manages ONUs
README.md - Android app → REST API v1: calls
README.md - REST API v1 → ZTE SNMP client: uses for ZTE
- REST API v1 → ZTE provisioning: runs actions
- Vendor selection → HiOSO driver: selects driver
app/Services/SmartOltSnmpServiceResolver.php - Vendor selection → OLT inventory: reads OLT family
app/Services/SmartOltSnmpServiceResolver.php - ZTE SNMP client → Managed OLTs: polls and queries
README.md - ZTE provisioning → Managed OLTs: provisions ONUs
README.md - HsAirPo CLI → Managed OLTs: accesses CLI
- Go SNMP poller → Managed OLTs: polls SNMP
README.md - ONU–ODP mapping → Map pins: reads and links
app/Services/OnuOdpService.php - Web controllers → Alarm evaluation: serves alarms
- Alarm evaluation → Telegram notifications: notifies
- Alarm evaluation → FCM push: pushes alarms
README.md - Telegram notifications → Telegram service: sends alerts
README.md - Telegram bot → OLT inventory: reads ONU snapshots
app/Services/Telegram/TelegramOnuQueryService.php - Webhook management → Telegram service: registers webhook
app/Services/Telegram/TelegramWebhookManager.php - Android devices → Android app: delivers push
README.md - Web controllers → Reports and audit: serves reports
- Web controllers → Users and roles: enforces access