# 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)
- [ ] Position smoothing/averaging
- [ ] Device trails/history visualization

---

## v0.4.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.5.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.6.0 - Alerts & Automation

- [ ] New device alerts
- [ ] Signal threshold alerts
- [ ] Webhook notifications
- [ ] Home Assistant integration (MQTT)
- [ ] Presence detection automation
- [ ] Device absence detection
- [ ] 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 |