WIP: Complete Refactor - Modern Stack

[Dadud]

Scanner Map Refactor - Draft PR

Overview

This is a complete refactor of the Scanner-map project with a modern microservices architecture.

New Architecture

┌─────────────────────────────────────────┐
│         React UI (Port 5173)            │
└─────────────────────────────────────────┘
                     │
                     ▼
┌─────────────────────────────────────────┐
│         Redis Pub/Sub (Event Bus)       │
└─────────────────────────────────────────┘
        │               │               │
        ▼               ▼               ▼
┌───────────┐  ┌─────────────┐  ┌──────────────┐
│  Fastify  │  │  Discord    │  │ Transcription│
│    API    │  │    Bot      │  │   (Python)   │
│ (Port 3000)│  │             │  │  (Port 8001) │
└───────────┘  └─────────────┘  └──────────────┘
        │
        ▼
┌─────────────────────────────────────────┐
│          PostgreSQL (Port 5432)         │
└─────────────────────────────────────────┘

Services

1. scanner-api - Fastify + TypeScript + Prisma

   • REST API endpoints
   • WebSocket (Socket.IO) for real-time
   • Redis pub/sub integration

2. scanner-transcribe - Python + faster-whisper

   • Local transcription
   • REST API interface

3. scanner-discord - Node.js Discord bot

   • Separate service
   • Subscribes to Redis

4. scanner-ui - React + Vite + TailwindCSS

   • Leaflet map
   • Real-time updates

Key Changes

• Replaced SQLite with PostgreSQL
• Added Redis for pub/sub messaging
• Separated Discord bot into its own service
• React frontend with proper state management (Zustand)
• TypeScript throughout
• Docker Compose for orchestration

TODO

• Add environment variable validation
• Implement proper authentication middleware
• Add unit tests
• Complete WebSocket reconnection logic
• Add tone detection integration

Status

Draft - This refactor is not yet production ready.