# 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 |