# whitemirrortechnologies/v4-production architecture

> Architecture diagram of the GitHub repository whitemirrortechnologies/v4-production, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-21). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/whitemirrortechnologies/v4-production
- Repository: https://github.com/whitemirrortechnologies/v4-production

## Overview

V4 is a CAT-preparation platform: learners discover exams and courses, create accounts, purchase access, then study lessons and practise or take tests; staff build and manage the learning catalogue and question bank. Its Next.js App Router pages and server actions form the product surface, with shared authentication and catalogue logic backed by Supabase. The README documents several major capabilities whose detailed implementations were not sampled, so those appear as subsystem nodes; links without direct source evidence are left out. Optional future Razorpay payments are not represented as live integration.

Main entry points: [`src/lib/supabase/server.ts`](https://github.com/whitemirrortechnologies/v4-production/blob/claude/inspiring-archimedes-6mvsu0/src/lib/supabase/server.ts) (User-scoped client), [`src/lib/catalog.ts`](https://github.com/whitemirrortechnologies/v4-production/blob/claude/inspiring-archimedes-6mvsu0/src/lib/catalog.ts) (Catalogue data), [`src/lib/auth.ts`](https://github.com/whitemirrortechnologies/v4-production/blob/claude/inspiring-archimedes-6mvsu0/src/lib/auth.ts) (Viewer and roles), [`src/app/app/page.tsx`](https://github.com/whitemirrortechnologies/v4-production/blob/claude/inspiring-archimedes-6mvsu0/src/app/app/page.tsx) (Learner dashboard)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_discovery["Public discovery"]
  node_public_catalog["Public catalogue"]
  node_course_cards["Course cards<br/>[course-card.tsx]"]
end

subgraph group_identity["Accounts and access"]
  node_auth_pages["Sign-in and signup"]
  node_auth_actions["Account actions<br/>[actions.ts]"]
  node_checkout["Demo checkout<br/>[actions.ts]"]
end

subgraph group_learning["Student learning"]
  node_dashboard["Learner dashboard<br/>[page.tsx]"]
  node_course_player["Course learning<br/>[page.tsx]"]
  node_practice["Practice sessions<br/>[page.tsx]"]
  node_practice_session["Practice interaction"]
  node_practice_actions["Practice answers<br/>[actions.ts]"]
  node_tests["Timed exams and results<br/>[exam-screen.tsx]"]
end

subgraph group_authoring["Staff content management"]
  node_admin_console["Admin overview<br/>[page.tsx]"]
  node_course_authoring["Course and curriculum editor<br/>[actions.ts]"]
  node_syllabus["Syllabus management"]
  node_question_bank["Question bank"]
  node_tests_series["Test builder and series"]
  node_admin_operations["Users and orders"]
end

subgraph group_platform["Shared services"]
  node_catalog_logic["Catalogue data<br/>[catalog.ts]"]
  node_auth_logic["Viewer and roles<br/>[auth.ts]"]
  node_supabase_server["User-scoped client<br/>[server.ts]"]
  node_shared_ui["Shared UI primitives<br/>[ui.tsx]"]
  node_forms["Form interactions<br/>[forms.tsx]"]
  node_course_art["Course artwork<br/>[course-art.tsx]"]
  node_site_header["Site navigation<br/>[site-header.tsx]"]
  node_formatting["Formatting helpers<br/>[format.ts]"]
  node_result_types["Action result types<br/>[result.ts]"]
  node_tree_loader["Curriculum tree loader<br/>[tree.ts]"]
end

node_visitor(("Learner or visitor"))
node_supabase[("Supabase services")]

node_visitor -->|"browses"| node_public_catalog
node_public_catalog -->|"loads listings"| node_catalog_logic
node_public_catalog -->|"renders"| node_course_cards
node_course_cards -->|"renders"| node_course_art
node_visitor -->|"creates account"| node_auth_pages
node_auth_pages -->|"submits"| node_auth_actions
node_auth_actions -->|"uses"| node_supabase_server
node_auth_logic -->|"creates client"| node_supabase_server
node_supabase_server -->|"queries with user session"| node_supabase
node_dashboard -->|"requires viewer"| node_auth_logic
node_dashboard -->|"loads learner data"| node_catalog_logic
node_dashboard -->|"reads progress"| node_supabase_server
node_course_player -->|"loads curriculum"| node_catalog_logic
node_catalog_logic -->|"builds curriculum"| node_tree_loader
node_catalog_logic -->|"reads catalogue"| node_supabase
node_practice -->|"starts practice"| node_practice_actions
node_practice_session -->|"submits answers"| node_practice_actions
node_practice_actions -->|"uses"| node_supabase_server
node_tests -.->|"presents exam"| node_visitor
node_visitor -->|"purchases access"| node_checkout
node_checkout -.->|"records demo purchase"| node_supabase
node_admin_console -->|"checks staff access"| node_auth_logic
node_course_authoring -->|"checks staff access"| node_auth_logic
node_course_authoring -->|"writes course data"| node_supabase_server
node_admin_console -->|"loads overview"| node_supabase_server
node_syllabus -.->|"manages syllabus"| node_supabase_server
node_question_bank -.->|"manages questions"| node_supabase_server
node_tests_series -.->|"manages tests"| node_supabase_server
node_admin_operations -.->|"manages accounts and orders"| node_supabase_server
node_site_header -->|"loads viewer"| node_auth_logic
node_site_header -->|"loads exam info"| node_catalog_logic
node_forms -->|"styles controls"| node_shared_ui
node_course_cards -->|"formats course data"| node_formatting
node_practice_session -->|"handles action result"| node_result_types

click node_public_catalog "https://github.com/whitemirrortechnologies/v4-production/tree/claude/inspiring-archimedes-6mvsu0/src/app/(public)"
click node_catalog_logic "https://github.com/whitemirrortechnologies/v4-production/blob/claude/inspiring-archimedes-6mvsu0/src/lib/catalog.ts"
click node_course_cards "https://github.com/whitemirrortechnologies/v4-production/blob/claude/inspiring-archimedes-6mvsu0/src/components/course-card.tsx"
click node_auth_pages "https://github.com/whitemirrortechnologies/v4-production/tree/claude/inspiring-archimedes-6mvsu0/src/app/(auth)"
click node_auth_actions "https://github.com/whitemirrortechnologies/v4-production/blob/claude/inspiring-archimedes-6mvsu0/src/app/(auth)/actions.ts"
click node_auth_logic "https://github.com/whitemirrortechnologies/v4-production/blob/claude/inspiring-archimedes-6mvsu0/src/lib/auth.ts"
click node_dashboard "https://github.com/whitemirrortechnologies/v4-production/blob/claude/inspiring-archimedes-6mvsu0/src/app/app/page.tsx"
click node_course_player "https://github.com/whitemirrortechnologies/v4-production/blob/claude/inspiring-archimedes-6mvsu0/src/app/app/learn/%5Bslug%5D/%5B%5B...lectureId%5D%5D/page.tsx"
click node_practice "https://github.com/whitemirrortechnologies/v4-production/blob/claude/inspiring-archimedes-6mvsu0/src/app/app/practice/page.tsx"
click node_practice_session "https://github.com/whitemirrortechnologies/v4-production/blob/claude/inspiring-archimedes-6mvsu0/src/components/practice-session.tsx"
click node_practice_actions "https://github.com/whitemirrortechnologies/v4-production/blob/claude/inspiring-archimedes-6mvsu0/src/app/app/practice/actions.ts"
click node_tests "https://github.com/whitemirrortechnologies/v4-production/blob/claude/inspiring-archimedes-6mvsu0/src/components/exam-screen.tsx"
click node_checkout "https://github.com/whitemirrortechnologies/v4-production/blob/claude/inspiring-archimedes-6mvsu0/src/app/checkout/actions.ts"
click node_admin_console "https://github.com/whitemirrortechnologies/v4-production/blob/claude/inspiring-archimedes-6mvsu0/src/app/admin/page.tsx"
click node_course_authoring "https://github.com/whitemirrortechnologies/v4-production/blob/claude/inspiring-archimedes-6mvsu0/src/app/admin/courses/actions.ts"
click node_syllabus "https://github.com/whitemirrortechnologies/v4-production/tree/claude/inspiring-archimedes-6mvsu0/src/app/admin/syllabus"
click node_question_bank "https://github.com/whitemirrortechnologies/v4-production/tree/claude/inspiring-archimedes-6mvsu0/src/app/admin/questions"
click node_tests_series "https://github.com/whitemirrortechnologies/v4-production/tree/claude/inspiring-archimedes-6mvsu0/src/app/admin/series"
click node_admin_operations "https://github.com/whitemirrortechnologies/v4-production/tree/claude/inspiring-archimedes-6mvsu0/src/app/admin"
click node_supabase_server "https://github.com/whitemirrortechnologies/v4-production/blob/claude/inspiring-archimedes-6mvsu0/src/lib/supabase/server.ts"
click node_shared_ui "https://github.com/whitemirrortechnologies/v4-production/blob/claude/inspiring-archimedes-6mvsu0/src/components/ui.tsx"
click node_forms "https://github.com/whitemirrortechnologies/v4-production/blob/claude/inspiring-archimedes-6mvsu0/src/components/forms.tsx"
click node_course_art "https://github.com/whitemirrortechnologies/v4-production/blob/claude/inspiring-archimedes-6mvsu0/src/components/course-art.tsx"
click node_site_header "https://github.com/whitemirrortechnologies/v4-production/blob/claude/inspiring-archimedes-6mvsu0/src/components/site-header.tsx"
click node_formatting "https://github.com/whitemirrortechnologies/v4-production/blob/claude/inspiring-archimedes-6mvsu0/src/lib/format.ts"
click node_result_types "https://github.com/whitemirrortechnologies/v4-production/blob/claude/inspiring-archimedes-6mvsu0/src/lib/result.ts"
click node_tree_loader "https://github.com/whitemirrortechnologies/v4-production/blob/claude/inspiring-archimedes-6mvsu0/src/lib/tree.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_public_catalog,node_course_cards toneBlue
class node_auth_pages,node_auth_actions,node_checkout,node_supabase toneAmber
class node_dashboard,node_course_player,node_practice,node_practice_session,node_practice_actions,node_tests toneMint
class node_admin_console,node_course_authoring,node_syllabus,node_question_bank,node_tests_series,node_admin_operations toneRose
class node_catalog_logic,node_auth_logic,node_supabase_server,node_shared_ui,node_forms,node_course_art,node_site_header,node_formatting,node_result_types,node_tree_loader,node_visitor toneIndigo
```

## Components

### Public discovery

- [Public catalogue](https://github.com/whitemirrortechnologies/v4-production/tree/claude/inspiring-archimedes-6mvsu0/src/app/(public)): `src/app/(public)`
- [Course cards](https://github.com/whitemirrortechnologies/v4-production/blob/claude/inspiring-archimedes-6mvsu0/src/components/course-card.tsx): `src/components/course-card.tsx`

### Accounts and access

- [Sign-in and signup](https://github.com/whitemirrortechnologies/v4-production/tree/claude/inspiring-archimedes-6mvsu0/src/app/(auth)): `src/app/(auth)`
- [Account actions](https://github.com/whitemirrortechnologies/v4-production/blob/claude/inspiring-archimedes-6mvsu0/src/app/(auth)/actions.ts): `src/app/(auth)/actions.ts`
- [Demo checkout](https://github.com/whitemirrortechnologies/v4-production/blob/claude/inspiring-archimedes-6mvsu0/src/app/checkout/actions.ts): `src/app/checkout/actions.ts`

### Student learning

- [Learner dashboard](https://github.com/whitemirrortechnologies/v4-production/blob/claude/inspiring-archimedes-6mvsu0/src/app/app/page.tsx): `src/app/app/page.tsx`
- [Course learning](https://github.com/whitemirrortechnologies/v4-production/blob/claude/inspiring-archimedes-6mvsu0/src/app/app/learn/%5Bslug%5D/%5B%5B...lectureId%5D%5D/page.tsx): `src/app/app/learn/[slug]/[[...lectureId]]/page.tsx`
- [Practice sessions](https://github.com/whitemirrortechnologies/v4-production/blob/claude/inspiring-archimedes-6mvsu0/src/app/app/practice/page.tsx): `src/app/app/practice/page.tsx`
- [Practice interaction](https://github.com/whitemirrortechnologies/v4-production/blob/claude/inspiring-archimedes-6mvsu0/src/components/practice-session.tsx): `src/components/practice-session.tsx`
- [Practice answers](https://github.com/whitemirrortechnologies/v4-production/blob/claude/inspiring-archimedes-6mvsu0/src/app/app/practice/actions.ts): `src/app/app/practice/actions.ts`
- [Timed exams and results](https://github.com/whitemirrortechnologies/v4-production/blob/claude/inspiring-archimedes-6mvsu0/src/components/exam-screen.tsx): `src/components/exam-screen.tsx`

### Staff content management

- [Admin overview](https://github.com/whitemirrortechnologies/v4-production/blob/claude/inspiring-archimedes-6mvsu0/src/app/admin/page.tsx): `src/app/admin/page.tsx`
- [Course and curriculum editor](https://github.com/whitemirrortechnologies/v4-production/blob/claude/inspiring-archimedes-6mvsu0/src/app/admin/courses/actions.ts): `src/app/admin/courses/actions.ts`
- [Syllabus management](https://github.com/whitemirrortechnologies/v4-production/tree/claude/inspiring-archimedes-6mvsu0/src/app/admin/syllabus): `src/app/admin/syllabus`
- [Question bank](https://github.com/whitemirrortechnologies/v4-production/tree/claude/inspiring-archimedes-6mvsu0/src/app/admin/questions): `src/app/admin/questions`
- [Test builder and series](https://github.com/whitemirrortechnologies/v4-production/tree/claude/inspiring-archimedes-6mvsu0/src/app/admin/series): `src/app/admin/series`
- [Users and orders](https://github.com/whitemirrortechnologies/v4-production/tree/claude/inspiring-archimedes-6mvsu0/src/app/admin): `src/app/admin`

### Shared services

- [Catalogue data](https://github.com/whitemirrortechnologies/v4-production/blob/claude/inspiring-archimedes-6mvsu0/src/lib/catalog.ts): `src/lib/catalog.ts`
- [Viewer and roles](https://github.com/whitemirrortechnologies/v4-production/blob/claude/inspiring-archimedes-6mvsu0/src/lib/auth.ts): `src/lib/auth.ts`
- [User-scoped client](https://github.com/whitemirrortechnologies/v4-production/blob/claude/inspiring-archimedes-6mvsu0/src/lib/supabase/server.ts): `src/lib/supabase/server.ts`
- [Shared UI primitives](https://github.com/whitemirrortechnologies/v4-production/blob/claude/inspiring-archimedes-6mvsu0/src/components/ui.tsx): `src/components/ui.tsx`
- [Form interactions](https://github.com/whitemirrortechnologies/v4-production/blob/claude/inspiring-archimedes-6mvsu0/src/components/forms.tsx): `src/components/forms.tsx`
- [Course artwork](https://github.com/whitemirrortechnologies/v4-production/blob/claude/inspiring-archimedes-6mvsu0/src/components/course-art.tsx): `src/components/course-art.tsx`
- [Site navigation](https://github.com/whitemirrortechnologies/v4-production/blob/claude/inspiring-archimedes-6mvsu0/src/components/site-header.tsx): `src/components/site-header.tsx`
- [Formatting helpers](https://github.com/whitemirrortechnologies/v4-production/blob/claude/inspiring-archimedes-6mvsu0/src/lib/format.ts): `src/lib/format.ts`
- [Action result types](https://github.com/whitemirrortechnologies/v4-production/blob/claude/inspiring-archimedes-6mvsu0/src/lib/result.ts): `src/lib/result.ts`
- [Curriculum tree loader](https://github.com/whitemirrortechnologies/v4-production/blob/claude/inspiring-archimedes-6mvsu0/src/lib/tree.ts): `src/lib/tree.ts`

### Other components

- **Learner or visitor**
- **Supabase services**

## Connections

- Learner or visitor → Public catalogue: browses (evidence: `README.md`)
- Public catalogue → Catalogue data: loads listings (evidence: `src/app/(public)/courses/page.tsx`)
- Public catalogue → Course cards: renders (evidence: `src/app/(public)/courses/page.tsx`)
- Course cards → Course artwork: renders (evidence: `src/components/course-card.tsx`)
- Learner or visitor → Sign-in and signup: creates account (evidence: `README.md`)
- Sign-in and signup → Account actions: submits (evidence: `src/components/auth-form.tsx`)
- Account actions → User-scoped client: uses (evidence: `src/app/(auth)/actions.ts`)
- Viewer and roles → User-scoped client: creates client (evidence: `src/lib/auth.ts`)
- User-scoped client → Supabase services: queries with user session (evidence: `src/lib/supabase/server.ts`)
- Learner dashboard → Viewer and roles: requires viewer (evidence: `src/app/app/page.tsx`)
- Learner dashboard → Catalogue data: loads learner data (evidence: `src/app/app/page.tsx`)
- Learner dashboard → User-scoped client: reads progress (evidence: `src/app/app/page.tsx`)
- Course learning → Catalogue data: loads curriculum (evidence: `src/lib/catalog.ts`)
- Catalogue data → Curriculum tree loader: builds curriculum (evidence: `src/lib/catalog.ts`)
- Catalogue data → Supabase services: reads catalogue (evidence: `src/lib/catalog.ts`)
- Practice sessions → Practice answers: starts practice (evidence: `src/app/app/practice/page.tsx`)
- Practice interaction → Practice answers: submits answers (evidence: `src/components/practice-session.tsx`)
- Practice answers → User-scoped client: uses (evidence: `src/app/app/practice/actions.ts`)
- Timed exams and results → Learner or visitor: presents exam
- Learner or visitor → Demo checkout: purchases access (evidence: `README.md`)
- Demo checkout → Supabase services: records demo purchase
- Admin overview → Viewer and roles: checks staff access (evidence: `src/app/admin/page.tsx`)
- Course and curriculum editor → Viewer and roles: checks staff access (evidence: `src/app/admin/courses/actions.ts`)
- Course and curriculum editor → User-scoped client: writes course data (evidence: `src/app/admin/courses/actions.ts`)
- Admin overview → User-scoped client: loads overview (evidence: `src/app/admin/page.tsx`)
- Syllabus management → User-scoped client: manages syllabus (evidence: `src/app/admin/syllabus/page.tsx`)
- Question bank → User-scoped client: manages questions (evidence: `src/app/admin/questions/page.tsx`)
- Test builder and series → User-scoped client: manages tests
- Users and orders → User-scoped client: manages accounts and orders (evidence: `src/app/admin/page.tsx`)
- Site navigation → Viewer and roles: loads viewer (evidence: `src/components/site-header.tsx`)
- Site navigation → Catalogue data: loads exam info (evidence: `src/components/site-header.tsx`)
- Form interactions → Shared UI primitives: styles controls (evidence: `src/components/forms.tsx`)
- Course cards → Formatting helpers: formats course data (evidence: `src/components/course-card.tsx`)
- Practice interaction → Action result types: handles action result (evidence: `src/components/practice-session.tsx`)
