Skip to content

Commit 6a1dbe0

Browse files
author
Dennis Braun
committed
Expand roadmap based on community research (vodafonekabelforum.de)
New items: - Upstream Channel Count Monitoring - Ingress/Return Path Scoring - Plain-Language Explanations - Alerting & Notifications section (Telegram, Discord, webhook, ntfy) - Power Level Drift Detection - Scheduled Health Digest - Gaming/Real-Time Quality Index - Smokeping Integration - Segment load indicator - Network uptime calendar - Vodafone Station / CommScope driver - Arris / Technicolor / Sagemcom drivers Enhanced existing items with user context from forum research.
1 parent b1cf56d commit 6a1dbe0

File tree

1 file changed

+20
-8
lines changed

1 file changed

+20
-8
lines changed

README.md

Lines changed: 20 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -159,31 +159,43 @@ DOCSight can optionally publish all channel data to Home Assistant via MQTT Auto
159159
## Roadmap
160160

161161
### Modulation & Signal Intelligence
162-
- [ ] **Modulation Watchdog**: Track and alert on QAM modulation changes per channel (e.g. 256QAM dropping to 16QAM)
162+
- [ ] **Modulation Watchdog**: Track and alert on QAM modulation changes per channel (e.g. 256QAM dropping to 16QAM) — the #1 symptom users report in cable forums
163163
- [ ] **Channel Heatmap**: Visual grid of all channels color-coded by modulation quality — spot frequency-dependent issues at a glance
164-
- [ ] **OFDMA Analysis**: Detect whether the modem uses a wide OFDMA block vs. many narrow SC-QAMs; flag subcarrier count fluctuations as potential ingress indicators
164+
- [ ] **OFDMA Analysis**: Detect whether the modem uses a wide OFDMA block vs. many narrow SC-QAMs; flag subcarrier count fluctuations as potential ingress indicators; track OFDMA enable/disable impact
165165
- [ ] **Adaptive Polling**: Automatically increase poll frequency (e.g. every 10-30s) when uncorrectable errors spike, to capture incidents in high resolution
166+
- [ ] **Upstream Channel Count Monitoring**: Alert when upstream channels drop (e.g. from 5 to 1) — early indicator of return path issues
167+
- [ ] **Ingress/Return Path Scoring**: Composite score based on upstream power levels, modulation quality, and channel count to detect return path interference before total failure
166168

167169
### Diagnosis & Reporting
168-
- [ ] **Incident Report Export**: One-click PDF/report with worst modulation values, max power levels, error sums, and auto-generated ISP complaint text referencing DIN thresholds
169-
- [ ] **Ping Correlation**: Built-in latency monitor (ping to Google/Cloudflare) overlaid on error graphs to prove causality between physical layer issues and packet loss
170+
- [ ] **Incident Report Export**: One-click PDF/report with worst modulation values, max power levels, error sums, and auto-generated ISP complaint text referencing DIN thresholds — ready to email to your ISP's tech support
171+
- [ ] **Ping Correlation**: Built-in latency monitor (ping to configurable targets) overlaid on error graphs to prove causality between physical layer issues and packet loss — replaces manual PingPlotter usage
170172
- [ ] **Before/After Comparison**: Side-by-side overlay of two time periods (e.g. week before vs. after technician visit) to quantify improvements
171173
- [ ] **FritzBox Event Log Parser**: Extract and display T3/T4 Timeout events, Ranging Request failures, and other DOCSIS error codes from the modem's event log
174+
- [ ] **Plain-Language Explanations**: "What does this mean?" tooltips translating technical values into actionable advice (e.g. "Your upstream power is critically high — this means the signal has to travel too far or passes through damaged cable")
175+
176+
### Alerting & Notifications
177+
- [ ] **Notification System**: Configurable alerts via webhook, Telegram, Discord, email, or Gotify/ntfy on health degradation, modulation drops, or connectivity loss
178+
- [ ] **Power Level Drift Detection**: Alert on relative changes (e.g. +3 dB in 24h) in addition to absolute thresholds — catch creeping degradation before it causes outages
179+
- [ ] **Scheduled Health Digest**: Daily/weekly summary email or message with connection quality score, error trends, and notable events
180+
- [ ] **Gaming/Real-Time Quality Index**: Dedicated score for latency-sensitive applications based on jitter, packet loss bursts, and modulation stability
172181

173182
### External Monitoring Integration
174183
- [x] **ThinkBroadband BQM**: Daily fetch and archive of external broadband quality graphs (latency, packet loss)
175184
- [ ] **Speedtest Tracker**: Pull speed test results (download, upload, ping, jitter) from self-hosted [Speedtest Tracker](https://github.com/alexjustesen/speedtest-tracker)
185+
- [ ] **Smokeping Integration**: Import or display Smokeping latency data alongside DOCSIS metrics for end-to-end correlation
176186

177187
### Enhanced Dashboard
178-
- [ ] Combined timeline: DOCSIS health + speed tests + BQM graph on a single time axis
179-
- [ ] Notification system: Webhooks on health degradation
188+
- [ ] Combined timeline: DOCSIS health + speed tests + BQM graph + ping data on a single time axis
180189
- [ ] Mobile-responsive layout
181-
- [ ] Power level drift detection: Alert on relative changes (e.g. +3 dB in 24h) in addition to absolute thresholds
190+
- [ ] Segment load indicator: Visualize peak-hour degradation patterns (e.g. 20:00–23:00 slowdowns)
191+
- [ ] Network uptime calendar: Month-view heatmap showing daily connection quality at a glance
182192

183193
### Multi-Modem Support
184194
- [ ] Plugin architecture for modem drivers
195+
- [ ] **Vodafone Station / CommScope driver**: Support for the most common ISP-provided cable modem in Germany
196+
- [ ] **Arris / Technicolor / Sagemcom drivers**: Cover the long tail of ISP-provided hardware
185197
- [ ] SNMP-based generic driver for additional cable modem models
186-
- [ ] Community-contributed drivers (Arris, Technicolor, Sagemcom, etc.)
198+
- [ ] Community-contributed drivers with documentation template
187199

188200
## Contributing
189201

0 commit comments

Comments
 (0)