How crosstalk-solutions/unifi-toolkit works
UI Toolkit is a UniFi network management and monitoring web application: users open the unified dashboard or a focused tool, which exposes status, analytics, tracking, security monitoring, and firewall lockdown workflows. The four tool applications are mounted by the shared FastAPI app; they use common UniFi, persistence, caching, and realtime facilities. README capabilities are retained, but unsampled router and scheduler internals limit confidence about their precise calls, so those links are omitted where not evidenced.
Main entry points: app/main.py Unified web app · house_arrest/main.py House Arrest app · network_pulse/main.py Pulse app · threat_watch/main.py Threat Watch app
Components 24
Application Core
- Unified web app
app/main.py - UniFi API client
shared/unifi_client.py - Shared UniFi session
shared/unifi_session.py - Application database
shared/database.py - Status cache
shared/cache.py - Webhook delivery
shared/webhooks.py - WebSocket broadcasts
shared/websocket_manager.py
Network Pulse
- Pulse app
tools/network_pulse/main.py - Live dashboard
tools/network_pulse/static/js/app.js - Stats API
tools/network_pulse/routers/stats.py - Refresh scheduler
tools/network_pulse/scheduler.py
Wi-Fi Stalker
- Stalker app
tools/wifi_stalker/main.py - Tracking dashboard
tools/wifi_stalker/static/js/app.js - Device tracking API
tools/wifi_stalker/routers/devices.py - Tracking scheduler
tools/wifi_stalker/scheduler.py
Threat Watch
- Threat Watch app
tools/threat_watch/main.py - Threat dashboard
tools/threat_watch/static/js/app.js - Event monitoring
tools/threat_watch/routers/events.py - Threat event store
tools/threat_watch/database.py
House Arrest
- House Arrest app
tools/house_arrest/main.py - Lockdown dashboard
tools/house_arrest/static/js/app.js - Lockdown API
tools/house_arrest/routers/arrest.py - Firewall policies
tools/house_arrest/policies.py
Other components
- Network operator
Connections 25
- Network operator → Unified web app: uses
- Unified web app → Pulse app: mounts
- Unified web app → Stalker app: mounts
- Unified web app → Threat Watch app: mounts
- Unified web app → House Arrest app: mounts
- Pulse app → Stats API: includes
- Live dashboard → Stats API: fetches stats
- Live dashboard → Pulse app: opens WebSocket
- Pulse app → WebSocket broadcasts: manages connections
- Refresh scheduler → WebSocket broadcasts: broadcasts
- Refresh scheduler → UniFi API client: reads network
- Stalker app → Device tracking API: includes
- Tracking dashboard → Device tracking API: requests devices
- Tracking scheduler → UniFi API client: reads clients
- Tracking scheduler → Application database: updates tracking
- Threat dashboard → Event monitoring: loads events
- Threat Watch app → Threat event store: queries events
- Event monitoring → Threat event store: reads events
- Threat Watch app → Status cache: checks status
- House Arrest app → Lockdown API: includes
- Lockdown dashboard → Lockdown API: requests lockdown
- House Arrest app → Firewall policies: builds status
- House Arrest app → Shared UniFi session: gets client
- Shared UniFi session → UniFi API client: provides client
- Device tracking API → Webhook delivery: alerts