How reem927/recoveryos works
RecoveryOS is a physical-therapy management platform for practitioners and their clients. Practitioners onboard clinics and manage patient records, then run movement assessments whose scan data is scored into structured findings; session guidance and recovery insights support follow-up care. Clients can join through invitations and use a patient portal. The README documents AI summaries, voice guidance, computer vision, 3D anatomy, and email/Telegram follow-ups. Some subsystem links are based on README statements or the source index; unsampled route internals are not inferred.
Main entry points: LegAssessmentScan.tsx Movement scan · admin.ts Supabase records · invites/route.ts Patient invitations · followup/route.ts Follow-up engine
Components 24
Clinical workflow
- Movement scan
components/hydrawav3/LegAssessmentScan.tsx - Vision fusion
lib/vision-fusion.ts - Assessment scoring
lib/leg-assessment-engine.ts - Exercise validation
lib/exercise-validators.ts - 3D anatomy model
components/hydrawav3/HumanModel3D.tsx - Session setup
app/session-setup/page.tsx - Session protocol
lib/hydrawav3-protocol.ts - Session device client
lib/hydrawav3-client.ts - Recovery insights
app/insights/page.tsx - Assessment summaries
app/api/assessments/[id]/summarize/route.ts - Recovery assistant
app/api/chat/route.ts
Patient experience
- Patient invitations
app/api/invites/route.ts - Client portal
app/client/page.tsx - Follow-up engine
app/api/followup/route.ts
Practitioner platform
- Clinic onboarding
app/onboarding/actions.ts - Patient management
lib/patients.ts - Add client
components/hydrawav3/add-client-modal.tsx - Supabase records
lib/supabase/admin.ts - Practitioner interface
components/hydrawav3/app-shell.tsx
AI and integrations
- Sona voice assistant
lib/sonaVoice.ts - Anthropic Claude
- Email delivery
- Telegram notifications
app/api/telegram/send/route.ts
Other components
- Practitioner
Connections 33
- Practitioner → Clinic onboarding: registers clinic
- Practitioner → Add client: adds patient
components/hydrawav3/add-client-modal.tsx - Add client → Patient management: creates record
- Add client → Supabase records: submits patient data
- Practitioner → Patient invitations: invites client
app/api/invites/route.ts - Patient invitations → Supabase records: updates invite records
app/api/invites/route.ts - Patient invitations → Email delivery: sends invite
app/api/invites/route.ts - Practitioner → Movement scan: runs assessment
- Movement scan → Assessment scoring: scores movement
components/hydrawav3/LegAssessmentScan.tsx - Movement scan → Vision fusion: uses vision pipeline
components/hydrawav3/LegAssessmentScan.tsx - Movement scan → Exercise validation: validates exercise
components/hydrawav3/LegAssessmentScan.tsx - Movement scan → Sona voice assistant: uses voice guidance
components/hydrawav3/LegAssessmentScan.tsx - Movement scan → 3D anatomy model: renders anatomy
components/hydrawav3/LegAssessmentScan.tsx - Practitioner → Session setup: prepares session
- Session setup → Session protocol: loads protocol
app/session-setup/page.tsx - Session setup → Session device client: configures device
app/session-setup/page.tsx - Session device client → Session protocol: uses protocol types
lib/hydrawav3-client.ts - Practitioner → Recovery insights: reviews recovery
- Recovery insights → Assessment scoring: uses assessment engine
app/insights/page.tsx - Assessment summaries → Supabase records: reads assessment
- Assessment summaries → Anthropic Claude: generates summary
- Practitioner → Recovery assistant: asks assistant
- Recovery assistant → Supabase records: reads and stores messages
app/api/chat/route.ts - Recovery assistant → Anthropic Claude: generates reply
app/api/chat/route.ts - Practitioner → Follow-up engine: triggers follow-up
- Follow-up engine → Supabase records: reads and logs follow-up
app/api/followup/route.ts - Follow-up engine → Anthropic Claude: writes message
app/api/followup/route.ts - Follow-up engine → Email delivery: sends follow-up
app/api/followup/route.ts - Practitioner → Telegram notifications: notifies practitioner
- Practitioner → Practitioner interface: uses workspace
components/hydrawav3/app-shell.tsx - Practitioner interface → Patient management: supports caseload views
- Patient invitations → Client portal: provides join flow
- Client portal → Patient management: views recovery trends
app/client/page.tsx