# ESP32-Web Roadmap

## v0.1.0 - Project Scaffold [DONE]

- [x] Flask app factory with blueprints
- [x] SQLAlchemy models (Sensor, Device, Sighting, Alert, Event, Probe)
- [x] UDP collector for sensor data streams
- [x] Core API endpoints
- [x] pytest setup
- [x] Containerfile + Makefile

## v0.1.1 - Server Management [DONE]

- [x] start/stop/restart/status via Makefile
- [x] Health endpoint with uptime
- [x] Database migrations (Flask-Migrate)
- [x] Listen on all interfaces
- [x] make help target

## v0.1.2 - OSINT Features [DONE]

- [x] MAC vendor lookup (IEEE OUI database)
- [x] BLE company_id to manufacturer mapping
- [x] Device profile enrichment
- [x] Export endpoints (CSV, JSON)

## v0.1.3 - Fleet Management [DONE]

- [x] Sensor config endpoint (GET/PUT)
- [x] OTA trigger endpoint
- [x] Calibration trigger endpoint
- [ ] Sensor history/metrics (moved to v0.1.5)

## v0.1.4 - Device Intelligence Dashboard [DONE]

- [x] Base dashboard layout (htmx + Pico CSS + D3.js dark theme)
- [x] Vendor treemap (D3 treemap by device type and vendor)
- [x] SSID social graph (D3 force-directed, shared probed SSIDs as edges)
- [x] Device fingerprint clusters (D3 packed circles by behavior)
- [x] Intelligence API endpoints (3 endpoints)
- [x] Vendored static assets (`make vendor`)
- [x] Pagination totals, request logging, data retention

## v0.1.5 - Zones & Presence

- [ ] Zone management (assign sensors to areas)
- [ ] Device zone tracking
- [ ] Dwell time analysis
- [ ] Presence history

## v0.1.6 - Production Ready

- [ ] Authentication (API keys or JWT)
- [ ] Rate limiting
- [ ] PostgreSQL support
- [ ] Podman container deployment (quadlet/systemd unit)
- [ ] Production deployment guide

## v0.2.0 - Visualization Dashboard

- [x] Base dashboard layout (htmx + Pico CSS + D3.js) — done in v0.1.4
- [x] Vendor treemap — done in v0.1.4
- [x] SSID social graph — done in v0.1.4
- [x] Device fingerprint clusters — done in v0.1.4
- [ ] Presence timeline (device enter/leave Gantt chart)
- [ ] Deauth attack timeline (alert overlay with source/target)

## Future

- RSSI heatmap / triangulation
- CSI radar display
- Temporal knowledge graph
- Entropy dashboard (ambient awareness metric)
- WebSocket for real-time updates
- Home Assistant integration
- Grafana dashboards
- Webhook callbacks for alerts