98e2c6fc42
- PROJECT.md: Add peer sync feature description and architecture - ROADMAP.md: Update to v1.0.0, mark peer sync complete - TASKS.md: Add peer sync completed tasks, update sprint - TODO.md: Add multi-scanner section, mark items done - CHANGELOG.md: Add v0.4.0 (HA) and v1.0.0 (peer sync) entries Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
148 lines
3.8 KiB
Markdown
148 lines
3.8 KiB
Markdown
# RF Mapper Roadmap
|
|
|
|
## Current Version: v1.0.0
|
|
|
|
---
|
|
|
|
## v0.1.0 - Core Scanning (COMPLETED)
|
|
|
|
- [x] WiFi network scanning via `iw`
|
|
- [x] Bluetooth device scanning (Classic + BLE)
|
|
- [x] OUI manufacturer lookup
|
|
- [x] Device class decoding
|
|
- [x] Distance estimation (RSSI-based)
|
|
- [x] JSON scan output
|
|
- [x] CLI interface
|
|
- [x] Basic configuration (YAML)
|
|
|
|
---
|
|
|
|
## v0.2.0 - Web Dashboard (COMPLETED)
|
|
|
|
- [x] Flask web server
|
|
- [x] Radar visualization (canvas)
|
|
- [x] 2D map view (Leaflet + OSM)
|
|
- [x] Device cards with signal bars
|
|
- [x] Manual scan trigger
|
|
- [x] Auto-scan scheduling
|
|
- [x] Bluetooth device identification
|
|
- [x] GPS position configuration
|
|
|
|
---
|
|
|
|
## v0.3.0 - 3D Visualization (COMPLETED)
|
|
|
|
- [x] MapLibre GL JS integration
|
|
- [x] 3D building extrusion
|
|
- [x] Floor-based device positioning
|
|
- [x] Floor selector UI
|
|
- [x] Device floor assignment (popup)
|
|
- [x] Custom distance override
|
|
- [x] Live BT tracking mode
|
|
- [x] Moving device detection (purple markers)
|
|
- [x] Filter-aware scanning (WiFi/BT toggle)
|
|
- [x] Reliable RSSI acquisition for movement tracking (bleak)
|
|
- [x] Position smoothing/averaging (statistical, 5-sample + stddev)
|
|
- [x] Floor persistence in SQLite database
|
|
- [x] Popup persistence during live updates
|
|
- [x] Device trails/history visualization
|
|
|
|
---
|
|
|
|
## v1.0.0 - Multi-Scanner Peer Sync (COMPLETED)
|
|
|
|
- [x] Scanner identity configuration (id, name, floor, position)
|
|
- [x] Peer registration API (`/api/peers/register`)
|
|
- [x] Bidirectional device sync (`/api/sync/devices`)
|
|
- [x] Timestamp-based conflict resolution
|
|
- [x] Source scanner tracking for synced devices
|
|
- [x] Device positions relative to detecting scanner
|
|
- [x] Peer scanner markers on 3D map
|
|
- [x] Background sync thread with configurable interval
|
|
- [x] Automatic mutual registration between peers
|
|
|
|
---
|
|
|
|
## v0.6.0 - Multilateration & Positioning
|
|
|
|
- [ ] Multi-point scanning (move scanner, record positions)
|
|
- [ ] Trilateration algorithm for device positioning
|
|
- [ ] Heat map visualization
|
|
- [ ] Signal strength interpolation
|
|
- [ ] Calibration mode for distance estimation
|
|
- [ ] Reference point management
|
|
- [ ] Position confidence indicators
|
|
|
|
---
|
|
|
|
## v0.7.0 - Persistence & History
|
|
|
|
- [x] SQLite database for scan history
|
|
- [x] Device tracking over time
|
|
- [ ] Historical signal strength graphs (UI)
|
|
- [x] First seen / last seen timestamps
|
|
- [x] Device naming/labeling
|
|
- [x] Favorites/known devices
|
|
- [ ] Export to CSV/Excel
|
|
|
|
---
|
|
|
|
## v0.4.0 - Home Assistant Integration (COMPLETED)
|
|
|
|
- [x] Webhook-based HA communication
|
|
- [x] Scan results webhook (device_tracker.see)
|
|
- [x] New device alerts webhook
|
|
- [x] Device departure detection webhook
|
|
- [x] Configurable timeout for departure detection
|
|
|
|
---
|
|
|
|
## v0.5.0 - Alerts & Automation
|
|
|
|
- [x] New device alerts (via HA webhook)
|
|
- [ ] Signal threshold alerts
|
|
- [x] Webhook notifications
|
|
- [ ] Home Assistant MQTT auto-discovery
|
|
- [x] Presence detection automation (via HA webhook)
|
|
- [x] Device absence detection (via HA webhook)
|
|
- [ ] Scheduled reports
|
|
|
|
---
|
|
|
|
## v1.1.0 - Production Hardening
|
|
|
|
- [ ] Comprehensive test suite
|
|
- [ ] Performance optimization
|
|
- [ ] Docker container
|
|
- [ ] systemd service file
|
|
- [ ] Multi-user support
|
|
- [ ] Authentication (optional)
|
|
- [ ] Complete documentation
|
|
- [ ] PyPI package release
|
|
|
|
---
|
|
|
|
## Future Ideas (v2.0+)
|
|
|
|
- [x] Multiple scanner nodes (distributed scanning) - Done in v1.0.0
|
|
- [ ] Mesh network visualization
|
|
- [ ] Spectrum analyzer integration
|
|
- [ ] RTL-SDR support for wider RF
|
|
- [ ] Machine learning device classification
|
|
- [ ] Mobile app companion
|
|
- [ ] AR visualization mode
|
|
- [ ] Integration with Wireshark
|
|
- [ ] Packet capture correlation
|
|
|
|
---
|
|
|
|
## Version History
|
|
|
|
| Version | Date | Highlights |
|
|
|---------|------|------------|
|
|
| v0.1.0 | 2026-01 | Initial CLI scanner |
|
|
| v0.2.0 | 2026-01 | Web dashboard |
|
|
| v0.3.0 | 2026-02 | 3D visualization, floor positioning |
|
|
| v0.4.0 | 2026-02 | Home Assistant integration |
|
|
| v1.0.0 | 2026-02 | Multi-scanner peer sync |
|