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>
3.2 KiB
3.2 KiB
RF Mapper Roadmap
Current Version: v0.3.0-dev
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 (IN PROGRESS)
- 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
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.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 |