
Privacy-first occupancy tracking via ARP scanning with a React dashboard, React Native app, and FastAPI backend
Full-stack presence-sensing platform that turns any local Wi-Fi network into an occupancy engine with no extra hardware required. The Python backend performs ARP sweeps every 30 s with Scapy (nmap fallback), records devices in PostgreSQL, and exposes a FastAPI REST API consumed by both a React + Vite admin dashboard (deployed to GitHub Pages) and a React Native + Expo mobile app with background geofencing.
Privacy-first occupancy tracker powered entirely by existing Wi-Fi infrastructure.
• Backend: FastAPI + Uvicorn; SQLAlchemy ORM against PostgreSQL; background ARP scanner using Scapy with nmap fallback.
• Detection: devices not seen in 5 minutes are marked offline; round-trip variance (pseudo-CSI) estimates physical movement.
• Admin Dashboard: React + Vite + Tailwind deployed to GitHub Pages; 7-day heatmap, muster report, energy recommendations.
• Mobile App: React Native via Expo with Tailwind/NativeWind; background geofencing task sends heartbeat within 100 m radius.
• Features: Ghost Mode, guest alerts, real-time headcount, 7-day day×hour occupancy heatmap.
• CI/CD: GitHub Actions builds and deploys admin dashboard to GitHub Pages on every push to main.