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>
3.8 KiB
3.8 KiB
RF Mapper Roadmap
Current Version: v1.0.0
v0.1.0 - Core Scanning (COMPLETED)
- WiFi network scanning via
iw - Bluetooth device scanning (Classic + BLE)
- OUI manufacturer lookup
- Device class decoding
- Distance estimation (RSSI-based)
- JSON scan output
- CLI interface
- Basic configuration (YAML)
v0.2.0 - Web Dashboard (COMPLETED)
- Flask web server
- Radar visualization (canvas)
- 2D map view (Leaflet + OSM)
- Device cards with signal bars
- Manual scan trigger
- Auto-scan scheduling
- Bluetooth device identification
- GPS position configuration
v0.3.0 - 3D Visualization (COMPLETED)
- MapLibre GL JS integration
- 3D building extrusion
- Floor-based device positioning
- Floor selector UI
- Device floor assignment (popup)
- Custom distance override
- Live BT tracking mode
- Moving device detection (purple markers)
- Filter-aware scanning (WiFi/BT toggle)
- Reliable RSSI acquisition for movement tracking (bleak)
- Position smoothing/averaging (statistical, 5-sample + stddev)
- Floor persistence in SQLite database
- Popup persistence during live updates
- Device trails/history visualization
v1.0.0 - Multi-Scanner Peer Sync (COMPLETED)
- Scanner identity configuration (id, name, floor, position)
- Peer registration API (
/api/peers/register) - Bidirectional device sync (
/api/sync/devices) - Timestamp-based conflict resolution
- Source scanner tracking for synced devices
- Device positions relative to detecting scanner
- Peer scanner markers on 3D map
- Background sync thread with configurable interval
- 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
- SQLite database for scan history
- Device tracking over time
- Historical signal strength graphs (UI)
- First seen / last seen timestamps
- Device naming/labeling
- Favorites/known devices
- Export to CSV/Excel
v0.4.0 - Home Assistant Integration (COMPLETED)
- Webhook-based HA communication
- Scan results webhook (device_tracker.see)
- New device alerts webhook
- Device departure detection webhook
- Configurable timeout for departure detection
v0.5.0 - Alerts & Automation
- New device alerts (via HA webhook)
- Signal threshold alerts
- Webhook notifications
- Home Assistant MQTT auto-discovery
- Presence detection automation (via HA webhook)
- 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+)
- 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 |