How watson-assists/watson works
Watson is a consultation-documentation product for integrative-care practitioners. Its main workflow is recording consultation audio, producing a transcript for practitioner review, and filling a structured form; the README notes that the engine is currently single-track. The wider product also includes patient booking and sign-in, documents, payments, Google Calendar, and WhatsApp. The graph includes those documented capabilities, but unsampled implementation links are omitted. Internal edges are limited to relationships visible in excerpts or the source index.
Main entry points: engine.py Job Engine · index.ts Patient OTP · server.mjs WhatsApp Gateway · server.ts Edge Function Server
Components 30
Practitioner and Patient Web
- Watson Web App
apps/web/src/app - Consultation Workspace
apps/web/src/app/consultation/page.tsx - Booking
apps/web/src/app/book/page.tsx - Form Review
apps/web/src/app/form/page.tsx - Patient Join
apps/web/src/app/join/page.tsx - Engine Status
apps/web/src/lib/engine.ts - Database Types
apps/web/src/lib/database.types.ts
Clinical Processing
- Worker CLI
apps/clinical-worker/src/clinical_worker/__main__.py - Job Engine
apps/clinical-worker/src/clinical_worker/engine.py - Audio Handling
apps/clinical-worker/src/clinical_worker/audio.py - Transcription
apps/clinical-worker/src/clinical_worker/transcribe.py - Transcript Merge
apps/clinical-worker/src/clinical_worker/merge.py - Form Filling
apps/clinical-worker/src/clinical_worker/form.py - Document Processing
apps/clinical-worker/src/clinical_worker/documents.py - Output Schema
apps/clinical-worker/src/clinical_worker/schema.py
Supabase Platform
- Supabase Database
apps/web/src/lib/supabase.ts - Edge Function Server
supabase/functions/_shared/server.ts - Patient OTP
supabase/functions/patient-otp/index.ts - Google Calendar Function
supabase/functions/google/index.ts - Payment Function
supabase/functions/payment/index.ts - Document Cleanup
supabase/functions/document-cleanup/index.ts
WhatsApp Messaging
- WhatsApp Function
supabase/functions/whatsapp/index.ts - Message Wording
supabase/functions/whatsapp/messages.ts - WhatsApp Gateway
apps/whatsapp-gateway/server.mjs - Pairing Encryption
apps/whatsapp-gateway/sealed.mjs
External Integrations
- Google Calendar
- Stripe
- Gmail
Other components
- Practitioner
- Patient
Connections 25
- Practitioner → Consultation Workspace: documents visit
README.md - Patient → Booking: books visit
README.md - Patient → Patient Join: signs in
README.md - Consultation Workspace → Form Review: reviews form
README.md - Watson Web App → Engine Status: checks status
apps/web/src/lib/engine.ts - Engine Status → Supabase Database: reads status
apps/web/src/lib/engine.ts - Watson Web App → Supabase Database: uses client
apps/web/src/lib/supabase.ts - Worker CLI → Job Engine: starts engine
apps/clinical-worker/src/clinical_worker/__main__.py - Job Engine → Supabase Database: claims jobs
apps/clinical-worker/src/clinical_worker/engine.py - Job Engine → Form Filling: fills fields
apps/clinical-worker/src/clinical_worker/engine.py - Job Engine → Document Processing: loads document lines
apps/clinical-worker/src/clinical_worker/engine.py - Patient OTP → Edge Function Server: uses server helpers
supabase/functions/patient-otp/index.ts - Patient OTP → Gmail: sends codes
README.md - Patient OTP → WhatsApp Gateway: sends phone codes
supabase/functions/patient-otp/index.ts - Booking → Google Calendar: calendar integration
README.md - Patient Join → Patient OTP: requests sign-in
README.md - Payment Function → Stripe: payment integration
README.md - Google Calendar Function → Google Calendar: calendar integration
README.md - WhatsApp Gateway → WhatsApp Function: forwards events
apps/whatsapp-gateway/server.mjs - WhatsApp Function → WhatsApp Gateway: requests delivery
supabase/functions/whatsapp/index.ts - WhatsApp Gateway → Pairing Encryption: seals pairing
apps/whatsapp-gateway/server.mjs - WhatsApp Function → Message Wording: uses wording
supabase/functions/whatsapp/messages.ts - Document Cleanup → Edge Function Server: uses server helpers
supabase/functions/document-cleanup/index.ts - Payment Function → Edge Function Server: uses server helpers
supabase/functions/payment/index.ts - Google Calendar Function → Edge Function Server: uses server helpers
supabase/functions/google/index.ts