7cc7c47805
Home Assistant Integration: - New homeassistant.py module with webhook support - Webhooks for scan results, new devices, and device departures - Absence detection with configurable timeout - Documentation in docs/HOME_ASSISTANT.md CLI Improvements: - Replace 'web' command with start/stop/restart/status - Background daemon mode with PID file management - Foreground mode for debugging (--foreground) Web UI Enhancements: - Improved device list styling and layout - Better floor assignment UI - Enhanced map visualization Documentation: - Add CHANGELOG.md - Add docs/API.md with full endpoint reference - Add docs/CHEATSHEET.md for quick reference - Update project documentation Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
132 lines
3.2 KiB
Markdown
132 lines
3.2 KiB
Markdown
# RF Mapper Roadmap
|
|
|
|
## Current Version: v0.3.0-dev
|
|
|
|
---
|
|
|
|
## 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 (IN PROGRESS)
|
|
|
|
- [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
|
|
- [ ] Device trails/history visualization
|
|
|
|
---
|
|
|
|
## 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.0.0 - Production Ready
|
|
|
|
- [ ] 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)
|
|
- [ ] 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 | TBD | 3D visualization |
|