High Priority
Modular Architecture Refactor
In Progress
Split app.py into route blueprints and service modules. Extract speech, detection, and avatar subsystems into dedicated service classes with clean interfaces. This refactor improves maintainability and enables independent testing of each subsystem.
High Priority
Documentation Unification
Planned
Align all route documentation with current endpoint names. The frontend already calls /chat and other modern endpoints, but some architectural diagrams still reference legacy /api/chat style labels. Update all diagrams to reflect the latest API surface.
Medium Priority
System Health Dashboard
Planned
Add health check endpoints for all external services: OpenRouter, TTS providers, ffmpeg, VTube Studio, Web Avatar, and camera detection. Operators need quick status visibility before reception use to ensure all subsystems are online.
Medium Priority
Persistent Configuration
Planned
Move detection and avatar settings from browser localStorage to a server-side config file. Add an admin UI for configuration management. Prevents configuration drift between sessions and enables centralized deployment management.
Medium Priority
Automated Testing Suite
Planned
Implement Cypress/Playwright-based frontend smoke tests covering chat flow, voice input, TTS, avatar sync, detection, and remote mode. The UI has many interaction paths that are expensive to verify manually across updates.
Low Priority
Operator Console
Planned
Build a dedicated staff interface for manual greeting triggers, info card display, avatar gesture control, and queue management without using the chatbot. Useful for staff who want direct operational control during peak hours.