# dr-g2/zyntrahealthcareintelligence-com architecture

> Architecture diagram of the GitHub repository dr-g2/zyntrahealthcareintelligence-com, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-05). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/dr-g2/zyntrahealthcareintelligence-com
- Repository: https://github.com/dr-g2/zyntrahealthcareintelligence-com

## Overview

Zyntra is a Supabase-backed medical exam preparation platform with MCQ practice, OSCE training, adaptive assessment and study planning, analytics, AI features, and administration. The main user journey runs from authentication and onboarding into assessment and practice, with attempts informing review, performance insights, and planning. The graph includes documented capabilities whose source files were not sampled; those relationships are omitted where runtime wiring is not evidenced.

Main entry points: [`src/integrations/supabase/client.ts`](https://github.com/dr-g2/zyntrahealthcareintelligence-com/blob/main/src/integrations/supabase/client.ts) (Supabase client), [`src/App.tsx`](https://github.com/dr-g2/zyntrahealthcareintelligence-com/blob/main/src/App.tsx) (Route application), [`src/pages/Practice.tsx`](https://github.com/dr-g2/zyntrahealthcareintelligence-com/blob/main/src/pages/Practice.tsx) (MCQ practice), [`src/contexts/AuthContext.tsx`](https://github.com/dr-g2/zyntrahealthcareintelligence-com/blob/main/src/contexts/AuthContext.tsx) (Authentication)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_access["Access and app shell"]
  node_app["Route application<br/>[App.tsx]"]
  node_auth["Authentication<br/>[AuthContext.tsx]"]
  node_onboarding["Onboarding<br/>[Onboarding.tsx]"]
  node_supabase["Supabase client<br/>[client.ts]"]
end

subgraph group_learning["Exam preparation"]
  node_practice["MCQ practice<br/>[Practice.tsx]"]
  node_questions["Question bank<br/>[Questions.tsx]"]
  node_assessment["Diagnostic assessment<br/>[Assess.tsx]"]
  node_review["MCQ review queue<br/>[MCQReviewQueue.tsx]"]
  node_osce["OSCE practice<br/>[PracticeOsce.tsx]"]
  node_station_results["Station results<br/>[StationResults.tsx]"]
end

subgraph group_intelligence["Adaptive intelligence"]
  node_behavior["Behavior analysis<br/>[index.ts]"]
  node_readiness["Readiness insights"]
  node_ai_lab["AI lab<br/>[index.ts]"]
end

subgraph group_engagement["Planning and engagement"]
  node_plan["Study planner<br/>[Plan.tsx]"]
  node_notifications["Training notifications"]
  node_push["Push notifications"]
end

subgraph group_operations["Platform operations"]
  node_admin["Admin dashboard<br/>[AdminDashboard.tsx]"]
  node_question_admin["Question management<br/>[index.ts]"]
  node_subscription["Feature access<br/>[useFeatureGate.ts]"]
  node_database[("Supabase data service<br/>[client.ts]")]
end

node_learner(("Learner"))

node_learner -->|"opens"| node_app
node_app -->|"provides auth"| node_auth
node_app -->|"routes to"| node_assessment
node_app -->|"routes to"| node_practice
node_app -->|"routes to"| node_questions
node_app -->|"routes to"| node_admin
node_auth -->|"reads identity"| node_supabase
node_onboarding -.->|"stores profile"| node_supabase
node_practice -->|"renders queue"| node_review
node_review -->|"reads attempts"| node_supabase
node_practice -->|"uses data client"| node_supabase
node_questions -.->|"loads questions"| node_supabase
node_assessment -.->|"submits metrics"| node_behavior
node_behavior -.->|"informs insights"| node_readiness
node_plan -.->|"uses data client"| node_supabase
node_notifications -->|"reads settings"| node_supabase
node_push -->|"uses data client"| node_supabase
node_admin -.->|"manages questions"| node_question_admin
node_question_admin -.->|"updates questions"| node_database
node_subscription -->|"reads subscription"| node_auth
node_subscription -->|"tracks usage"| node_supabase
node_osce -.->|"shows results"| node_station_results
node_ai_lab -.->|"uses data service"| node_database

click node_app "https://github.com/dr-g2/zyntrahealthcareintelligence-com/blob/main/src/App.tsx"
click node_auth "https://github.com/dr-g2/zyntrahealthcareintelligence-com/blob/main/src/contexts/AuthContext.tsx"
click node_onboarding "https://github.com/dr-g2/zyntrahealthcareintelligence-com/blob/main/src/pages/Onboarding.tsx"
click node_supabase "https://github.com/dr-g2/zyntrahealthcareintelligence-com/blob/main/src/integrations/supabase/client.ts"
click node_practice "https://github.com/dr-g2/zyntrahealthcareintelligence-com/blob/main/src/pages/Practice.tsx"
click node_questions "https://github.com/dr-g2/zyntrahealthcareintelligence-com/blob/main/src/pages/Questions.tsx"
click node_assessment "https://github.com/dr-g2/zyntrahealthcareintelligence-com/blob/main/src/pages/Assess.tsx"
click node_review "https://github.com/dr-g2/zyntrahealthcareintelligence-com/blob/main/src/components/history/MCQReviewQueue.tsx"
click node_osce "https://github.com/dr-g2/zyntrahealthcareintelligence-com/blob/main/src/pages/PracticeOsce.tsx"
click node_station_results "https://github.com/dr-g2/zyntrahealthcareintelligence-com/blob/main/src/components/stations/StationResults.tsx"
click node_behavior "https://github.com/dr-g2/zyntrahealthcareintelligence-com/blob/main/supabase/functions/analyze-behavior/index.ts"
click node_readiness "https://github.com/dr-g2/zyntrahealthcareintelligence-com/blob/main/src/pages/PerformanceIntelligence.tsx"
click node_ai_lab "https://github.com/dr-g2/zyntrahealthcareintelligence-com/blob/main/supabase/functions/ai-lab/index.ts"
click node_plan "https://github.com/dr-g2/zyntrahealthcareintelligence-com/blob/main/src/pages/Plan.tsx"
click node_notifications "https://github.com/dr-g2/zyntrahealthcareintelligence-com/blob/main/src/hooks/useTrainingNotifications.ts"
click node_push "https://github.com/dr-g2/zyntrahealthcareintelligence-com/blob/main/src/hooks/usePushNotifications.ts"
click node_admin "https://github.com/dr-g2/zyntrahealthcareintelligence-com/blob/main/src/pages/AdminDashboard.tsx"
click node_question_admin "https://github.com/dr-g2/zyntrahealthcareintelligence-com/blob/main/supabase/functions/admin-manage-questions/index.ts"
click node_subscription "https://github.com/dr-g2/zyntrahealthcareintelligence-com/blob/main/src/hooks/useFeatureGate.ts"
click node_database "https://github.com/dr-g2/zyntrahealthcareintelligence-com/blob/main/src/integrations/supabase/client.ts"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_app,node_auth,node_onboarding,node_supabase toneBlue
class node_practice,node_questions,node_assessment,node_review,node_osce,node_station_results toneAmber
class node_behavior,node_readiness,node_ai_lab toneMint
class node_plan,node_notifications,node_push toneRose
class node_admin,node_question_admin,node_subscription,node_database,node_learner toneIndigo
```

## Components

### Access and app shell

- [Route application](https://github.com/dr-g2/zyntrahealthcareintelligence-com/blob/main/src/App.tsx): `src/App.tsx`
- [Authentication](https://github.com/dr-g2/zyntrahealthcareintelligence-com/blob/main/src/contexts/AuthContext.tsx): `src/contexts/AuthContext.tsx`
- [Onboarding](https://github.com/dr-g2/zyntrahealthcareintelligence-com/blob/main/src/pages/Onboarding.tsx): `src/pages/Onboarding.tsx`
- [Supabase client](https://github.com/dr-g2/zyntrahealthcareintelligence-com/blob/main/src/integrations/supabase/client.ts): `src/integrations/supabase/client.ts`

### Exam preparation

- [MCQ practice](https://github.com/dr-g2/zyntrahealthcareintelligence-com/blob/main/src/pages/Practice.tsx): `src/pages/Practice.tsx`
- [Question bank](https://github.com/dr-g2/zyntrahealthcareintelligence-com/blob/main/src/pages/Questions.tsx): `src/pages/Questions.tsx`
- [Diagnostic assessment](https://github.com/dr-g2/zyntrahealthcareintelligence-com/blob/main/src/pages/Assess.tsx): `src/pages/Assess.tsx`
- [MCQ review queue](https://github.com/dr-g2/zyntrahealthcareintelligence-com/blob/main/src/components/history/MCQReviewQueue.tsx): `src/components/history/MCQReviewQueue.tsx`
- [OSCE practice](https://github.com/dr-g2/zyntrahealthcareintelligence-com/blob/main/src/pages/PracticeOsce.tsx): `src/pages/PracticeOsce.tsx`
- [Station results](https://github.com/dr-g2/zyntrahealthcareintelligence-com/blob/main/src/components/stations/StationResults.tsx): `src/components/stations/StationResults.tsx`

### Adaptive intelligence

- [Behavior analysis](https://github.com/dr-g2/zyntrahealthcareintelligence-com/blob/main/supabase/functions/analyze-behavior/index.ts): `supabase/functions/analyze-behavior/index.ts`
- [Readiness insights](https://github.com/dr-g2/zyntrahealthcareintelligence-com/blob/main/src/pages/PerformanceIntelligence.tsx): `src/pages/PerformanceIntelligence.tsx`
- [AI lab](https://github.com/dr-g2/zyntrahealthcareintelligence-com/blob/main/supabase/functions/ai-lab/index.ts): `supabase/functions/ai-lab/index.ts`

### Planning and engagement

- [Study planner](https://github.com/dr-g2/zyntrahealthcareintelligence-com/blob/main/src/pages/Plan.tsx): `src/pages/Plan.tsx`
- [Training notifications](https://github.com/dr-g2/zyntrahealthcareintelligence-com/blob/main/src/hooks/useTrainingNotifications.ts): `src/hooks/useTrainingNotifications.ts`
- [Push notifications](https://github.com/dr-g2/zyntrahealthcareintelligence-com/blob/main/src/hooks/usePushNotifications.ts): `src/hooks/usePushNotifications.ts`

### Platform operations

- [Admin dashboard](https://github.com/dr-g2/zyntrahealthcareintelligence-com/blob/main/src/pages/AdminDashboard.tsx): `src/pages/AdminDashboard.tsx`
- [Question management](https://github.com/dr-g2/zyntrahealthcareintelligence-com/blob/main/supabase/functions/admin-manage-questions/index.ts): `supabase/functions/admin-manage-questions/index.ts`
- [Feature access](https://github.com/dr-g2/zyntrahealthcareintelligence-com/blob/main/src/hooks/useFeatureGate.ts): `src/hooks/useFeatureGate.ts`
- [Supabase data service](https://github.com/dr-g2/zyntrahealthcareintelligence-com/blob/main/src/integrations/supabase/client.ts): `src/integrations/supabase/client.ts`

### Other components

- **Learner**

## Connections

- Learner → Route application: opens (evidence: `src/App.tsx`)
- Route application → Authentication: provides auth (evidence: `src/App.tsx`)
- Route application → Diagnostic assessment: routes to (evidence: `src/App.tsx`)
- Route application → MCQ practice: routes to (evidence: `src/App.tsx`)
- Route application → Question bank: routes to (evidence: `src/App.tsx`)
- Route application → Admin dashboard: routes to (evidence: `src/App.tsx`)
- Authentication → Supabase client: reads identity (evidence: `src/contexts/AuthContext.tsx`)
- Onboarding → Supabase client: stores profile
- MCQ practice → MCQ review queue: renders queue (evidence: `src/pages/Practice.tsx`)
- MCQ review queue → Supabase client: reads attempts (evidence: `src/components/history/MCQReviewQueue.tsx`)
- MCQ practice → Supabase client: uses data client (evidence: `src/pages/Practice.tsx`)
- Question bank → Supabase client: loads questions
- Diagnostic assessment → Behavior analysis: submits metrics
- Behavior analysis → Readiness insights: informs insights
- Study planner → Supabase client: uses data client
- Training notifications → Supabase client: reads settings (evidence: `src/hooks/useTrainingNotifications.ts`)
- Push notifications → Supabase client: uses data client (evidence: `src/hooks/usePushNotifications.ts`)
- Admin dashboard → Question management: manages questions
- Question management → Supabase data service: updates questions
- Feature access → Authentication: reads subscription (evidence: `src/hooks/useFeatureGate.ts`)
- Feature access → Supabase client: tracks usage (evidence: `src/hooks/useFeatureGate.ts`)
- OSCE practice → Station results: shows results
- AI lab → Supabase data service: uses data service
