How xxbubziexx/scanscribe works
ScanScribe is a public-safety radio transcription and incident-intelligence station. Its principal workflow captures scanner audio, transcribes it, extracts entities, routes transmissions into incident threads, and presents live incidents and analytics in a browser console. The graph also preserves the documented conversational intelligence, dataset review/export, mapping, and authentication capabilities. Some frontend and ingestion connections are documented in the README but their implementation was not sampled; those links are dashed where the code-level relationship is unverified.
Main entry points: pipeline.py Transcript Routing · App.tsx Web Console · main.py HTTP API · incidents.py Incident Lifecycle
Components 29
Audio Ingestion
- Audio Watcher
app/services/watcher.py - Processing Queue
app/services/queue_processor.py - Speech Recognition
app/services/transcription_engine.py - Transcript Records
app/models/log_entry.py
Incident Intelligence
- Event Worker
app/services/events_worker.py - Transcript Routing
app/services/events/pipeline.py - Entity Recognition
app/services/ner_service.py - LLM Router
app/services/events_router_engine.py - Incident Context
app/services/events/context.py - Incident Lifecycle
app/services/events/incidents.py - Incident Records
app/models/event.py - Geocoding
app/services/geocoder_service.py
Platform Services
- Live Updates
app/services/websocket.py - Analytics Engine
app/services/insights_engine.py - Unified Database
app/database.py - Configuration
app/config.py - Logging Setup
app/logging_config.py - HTTP API
app/main.py - Chat API
app/routes/chat.py
Operator Console
- Web Console
app/frontend/src/App.tsx - Command Center
app/frontend/src/pages/CommandCenter/CommandCenterPage.tsx - Incident Hub
app/frontend/src/pages/Events/Incidents/index.tsx - Intelligence Console
app/frontend/src/pages/Intel/IntelPage.tsx - Dataset Studio
app/frontend/src/pages/DataExplorer/DatasetPage.tsx - Live Dashboard
app/frontend/src/pages/Dashboard/DashboardPage.tsx
Accounts
- Authentication
app/routes/auth.py - User Accounts
app/models/user.py
Other components
- Radio Source
- Operator
Connections 31
- Radio Source → Audio Watcher: supplies audio
- Audio Watcher → Processing Queue: enqueues audio
- Processing Queue → Speech Recognition: processes audio
- Speech Recognition → Transcript Records: stores transcript
- Event Worker → Transcript Routing: delegates to
app/services/events_worker.py - Transcript Routing → Entity Recognition: extracts entities
app/services/events/pipeline.py - Transcript Routing → LLM Router: routes transcript
app/services/events/pipeline.py - Transcript Routing → Incident Context: uses context
app/services/events/pipeline.py - Transcript Routing → Incident Lifecycle: applies decision
app/services/events/pipeline.py - Incident Lifecycle → Incident Records: creates incidents
- Incident Lifecycle → Geocoding: dispatches geocoding
- Transcript Routing → Live Updates: broadcasts updates
app/services/events/pipeline.py - HTTP API → Processing Queue: starts worker
app/main.py - HTTP API → Event Worker: starts worker
app/main.py - HTTP API → Unified Database: initializes storage
app/main.py - Unified Database → Configuration: loads settings
app/database.py - Analytics Engine → Incident Records: queries events
app/services/insights_engine.py - Analytics Engine → Transcript Records: queries transcripts
app/services/insights_engine.py - Operator → Web Console: opens console
- Web Console → Command Center: presents map
- Web Console → Incident Hub: presents incidents
- Web Console → Intelligence Console: opens conversations
- Web Console → Dataset Studio: reviews datasets
- Web Console → Live Dashboard: shows live feed
- Operator → Authentication: authenticates
- Authentication → User Accounts: reads and writes
app/routes/auth.py - Intelligence Console → Chat API: queries traffic
- Chat API → Unified Database: queries history
- Command Center → Geocoding: maps locations
- Live Updates → Live Dashboard: pushes updates
- Logging Setup → Live Updates: supports logging
app/services/websocket.py