Speckit.Plan

# DocAssist Practice Manager - Technical Implementation Plan

## Architecture Overview

┌─────────────────────────────────────────────────────────────────────────────────┐ │ DocAssist Practice Manager │ ├─────────────────────────────────────────────────────────────────────────────────┤ │ ┌──────────────┐ ┌──────────────┐ ┌──────────────┐ ┌──────────────────────┐ │ │ │ Dashboard │ │ Calendar │ │ Patients │ │ Analytics │ │ │ └──────────────┘ └──────────────┘ └──────────────┘ └──────────────────────┘ │ │ FLET UI LAYER │ ├─────────────────────────────────────────────────────────────────────────────────┤ │ ┌──────────────────────────────────────────────────────────────────────────┐ │ │ │ FASTAPI SERVICE LAYER │ │ │ │ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ ┌─────────────────┐ │ │ │ │ │ Appointment │ │ Patient │ │ Billing │ │ Analytics │ │ │ │ │ │ Service │ │ Service │ │ Service │ │ Service │ │ │ │ │ └─────────────┘ └─────────────┘ └─────────────┘ └─────────────────┘ │ │ │ │ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ ┌─────────────────┐ │ │ │ │ │ Sync │ │ Voice │ │Notification │ │ Auth │ │ │ │ │ │ Service │ │ Service │ │ Service │ │ Service │ │ │ │ │ └─────────────┘ └─────────────┘ └─────────────┘ └─────────────────┘ │ │ │ └──────────────────────────────────────────────────────────────────────────┘ │ ├─────────────────────────────────────────────────────────────────────────────────┤ │ ┌──────────────────────────────────────────────────────────────────────────┐ │ │ │ DATA ACCESS LAYER │ │ │ │ ┌──────────────────────┐ ┌──────────────────────┐ │ │ │ │ │ SQLite + SQLAlchemy │ │ ChromaDB Vectors │ │ │ │ │ │ (Practice Data) │ │ (Smart Search) │ │ │ │ │ └──────────────────────┘ └──────────────────────┘ │ │ │ └──────────────────────────────────────────────────────────────────────────┘ │ ├─────────────────────────────────────────────────────────────────────────────────┤ │ ┌──────────────────────────────────────────────────────────────────────────┐ │ │ │ VOICE AI LAYER │ │ │ │ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ ┌─────────────────┐ │ │ │ │ │ Whisper │ │ Ollama │ │ Intent │ │ Piper │ │ │ │ │ │ STT │ │ + Qwen │ │ Parser │ │ TTS │ │ │ │ │ └─────────────┘ └─────────────┘ └─────────────┘ └─────────────────┘ │ │ │ └──────────────────────────────────────────────────────────────────────────┘ │ ├─────────────────────────────────────────────────────────────────────────────────┤ │ ┌──────────────────────────────────────────────────────────────────────────┐ │ │ │ INTEGRATION LAYER │ │ │ │ ┌──────────────────────┐ ┌──────────────────────┐ │ │ │ │ │ EMR Sync Bridge │ │ External APIs │ │ │ │ │ │ (Shared SQLite) │ │ (SMS, WhatsApp) │ │ │ │ │ └──────────────────────┘ └──────────────────────┘ │ │ │ └──────────────────────────────────────────────────────────────────────────┘ │ └─────────────────────────────────────────────────────────────────────────────────┘

---

## Project Structure

docassist-practice-manager/ ├── .claude/ │ └── commands/ │ ├── speckit.constitution.md │ ├── speckit.specify.md │ ├── speckit.plan.md │ ├── speckit.tasks.md │ ├── ralph-loop.md │ └── cancel-ralph.md ├── src/ │ ├── init.py │ ├── models/ │ │ ├── init.py │ │ ├── base.py │ │ ├── patient.py │ │ ├── appointment.py │ │ ├── doctor.py │ │ ├── staff.py │ │ ├── service.py │ │ ├── invoice.py │ │ ├── payment.py │ │ └── audit.py │ ├── services/ │ │ ├── init.py │ │ ├── appointment_service.py │ │ ├── patient_service.py │ │ ├── billing_service.py │ │ ├── analytics_service.py │ │ ├── notification_service.py │ │ ├── voice_service.py │ │ ├── sync_service.py │ │ └── auth_service.py │ ├── ui/ │ │ ├── init.py │ │ ├── app.py │ │ ├── theme.py │ │ ├── components/ │ │ │ ├── init.py │ │ │ ├── sidebar.py │ │ │ ├── calendar.py │ │ │ ├── patient_card.py │ │ │ ├── appointment_card.py │ │ │ ├── metric_card.py │ │ │ └── voice_indicator.py │ │ └── pages/ │ │ ├── init.py │ │ ├── dashboard.py │ │ ├── calendar_view.py │ │ ├── patient_list.py │ │ ├── patient_profile.py │ │ ├── billing.py │ │ ├── analytics.py │ │ └── settings.py │ ├── voice/ │ │ ├── init.py │ │ ├── wake_word.py │ │ ├── speech_to_text.py │ │ ├── intent_parser.py │ │ ├── action_handler.py │ │ └── text_to_speech.py │ ├── integrations/ │ │ ├── init.py │ │ ├── emr_bridge.py │ │ ├── sms_gateway.py │ │ └── whatsapp_api.py │ └── utils/ │ ├── init.py │ ├── config.py │ ├── logging.py │ └── helpers.py ├── tests/ │ ├── init.py │ ├── conftest.py │ ├── test_models/ │ ├── test_services/ │ ├── test_ui/ │ └── test_voice/ ├── prompts/ │ ├── voice_intent.txt │ ├── appointment_nlp.txt │ └── analytics_insight.txt ├── data/ │ ├── .gitkeep │ └── (runtime: practice.db, chroma/) ├── docs/ │ ├── API.md │ ├── INTEGRATION.md │ └── USER_GUIDE.md ├── main.py ├─ ```