# kartik192008/okschool.webstie architecture

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

- Interactive diagram: https://gitdiagram.com/kartik192008/okschool.webstie
- Repository: https://github.com/kartik192008/okschool.webstie

## Overview

OK School is a study-material and mock-exam platform, with administration, search, purchase history, and an Amazon product area. The main user flow is entering the routed web app, choosing a mock test, reviewing instructions, taking a timed exam, and viewing results; exam submissions are sent to the API. The server mounts separate route modules for the broader product capabilities. Source excerpts establish the app routing and exam behavior, but most page and route implementations were not sampled, so their internal dependencies are not inferred.

Main entry points: [`artifacts/api-server/src/routes/index.ts`](https://github.com/kartik192008/okschool.webstie/blob/main/artifacts/api-server/src/routes/index.ts) (Route registry), [`artifacts/api-server/src/routes/mock-tests.ts`](https://github.com/kartik192008/okschool.webstie/blob/main/artifacts/api-server/src/routes/mock-tests.ts) (Mock tests API), [`artifacts/api-server/src/app.ts`](https://github.com/kartik192008/okschool.webstie/blob/main/artifacts/api-server/src/app.ts) (HTTP app), [`artifacts/api-server/src/routes/documents.ts`](https://github.com/kartik192008/okschool.webstie/blob/main/artifacts/api-server/src/routes/documents.ts) (Documents API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web application"]
  node_webapp["App router"]
  node_navbar["Navigation"]
  node_protected["Route protection"]
end

subgraph group_exam["Mock exams"]
  node_generator["Mock generator"]
  node_mocklist["Mock test list"]
  node_examrun["Exam session"]
  node_instructions["Exam instructions"]
  node_timer["Exam timer"]
  node_results["Exam results"]
  node_mymocks["My mocks"]
  node_history["Test history"]
end

subgraph group_content["Content and commerce"]
  node_home["Home"]
  node_material["Study materials"]
  node_search["Search results"]
  node_store["Amazon store"]
  node_purchase["Purchase history"]
end

subgraph group_admin["Administration"]
  node_adminui["Admin dashboard"]
end

subgraph group_server["API server"]
  node_apiapp["HTTP app<br/>[app.ts]"]
  node_apiroutes["Route registry<br/>[index.ts]"]
  node_documents["Documents API<br/>[documents.ts]"]
  node_mockapi["Mock tests API<br/>[mock-tests.ts]"]
  node_payments["Payments API"]
  node_productapi["Products API<br/>[amazon-products.ts]"]
  node_adminapi["Admin API<br/>[admin.ts]"]
  node_searchapi["Search API<br/>[search.ts]"]
  node_visitsapi["Visits API"]
  node_healthapi["Health API<br/>[health.ts]"]
  node_historyapi["History API"]
  node_schema["Mock-test schema<br/>[mock_tests.ts]"]
end

node_student(("Student"))

node_student -->|"uses"| node_webapp
node_webapp -->|"renders"| node_navbar
node_webapp -->|"guards routes"| node_protected
node_webapp -->|"routes to"| node_home
node_webapp -->|"routes to"| node_material
node_webapp -->|"routes to"| node_mocklist
node_webapp -->|"routes to"| node_examrun
node_webapp -->|"routes to"| node_history
node_webapp -->|"routes to"| node_purchase
node_webapp -->|"routes to"| node_store
node_webapp -->|"routes to"| node_search
node_webapp -->|"routes to"| node_generator
node_webapp -->|"routes to"| node_mymocks
node_webapp -->|"routes to"| node_adminui
node_examrun -->|"uses"| node_timer
node_examrun -->|"renders"| node_instructions
node_examrun -->|"renders"| node_results
node_examrun -->|"posts results"| node_mockapi
node_apiapp -->|"mounts"| node_apiroutes
node_apiroutes -->|"registers"| node_healthapi
node_apiroutes -->|"registers"| node_documents
node_apiroutes -->|"registers"| node_productapi
node_apiroutes -->|"registers"| node_mockapi
node_apiroutes -->|"registers"| node_adminapi
node_apiroutes -->|"registers"| node_searchapi
node_apiroutes -->|"registers"| node_visitsapi
node_apiroutes -->|"registers"| node_payments
node_apiroutes -->|"registers"| node_historyapi

click node_apiapp "https://github.com/kartik192008/okschool.webstie/blob/main/artifacts/api-server/src/app.ts"
click node_apiroutes "https://github.com/kartik192008/okschool.webstie/blob/main/artifacts/api-server/src/routes/index.ts"
click node_documents "https://github.com/kartik192008/okschool.webstie/blob/main/artifacts/api-server/src/routes/documents.ts"
click node_mockapi "https://github.com/kartik192008/okschool.webstie/blob/main/artifacts/api-server/src/routes/mock-tests.ts"
click node_productapi "https://github.com/kartik192008/okschool.webstie/blob/main/artifacts/api-server/src/routes/amazon-products.ts"
click node_adminapi "https://github.com/kartik192008/okschool.webstie/blob/main/artifacts/api-server/src/routes/admin.ts"
click node_searchapi "https://github.com/kartik192008/okschool.webstie/blob/main/artifacts/api-server/src/routes/search.ts"
click node_healthapi "https://github.com/kartik192008/okschool.webstie/blob/main/artifacts/api-server/src/routes/health.ts"
click node_schema "https://github.com/kartik192008/okschool.webstie/blob/main/lib/db/src/schema/mock_tests.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_webapp,node_navbar,node_protected toneBlue
class node_generator,node_mocklist,node_examrun,node_instructions,node_timer,node_results,node_mymocks,node_history toneAmber
class node_home,node_material,node_search,node_store,node_purchase toneMint
class node_adminui toneRose
class node_apiapp,node_apiroutes,node_documents,node_mockapi,node_payments,node_productapi,node_adminapi,node_searchapi,node_visitsapi,node_healthapi,node_historyapi,node_schema,node_student toneIndigo
```

## Components

### Web application

- **App router**
- **Navigation**
- **Route protection**

### Mock exams

- **Mock generator**
- **Mock test list**
- **Exam session**
- **Exam instructions**
- **Exam timer**
- **Exam results**
- **My mocks**
- **Test history**

### Content and commerce

- **Home**
- **Study materials**
- **Search results**
- **Amazon store**
- **Purchase history**

### Administration

- **Admin dashboard**

### API server

- [HTTP app](https://github.com/kartik192008/okschool.webstie/blob/main/artifacts/api-server/src/app.ts): `artifacts/api-server/src/app.ts`
- [Route registry](https://github.com/kartik192008/okschool.webstie/blob/main/artifacts/api-server/src/routes/index.ts): `artifacts/api-server/src/routes/index.ts`
- [Documents API](https://github.com/kartik192008/okschool.webstie/blob/main/artifacts/api-server/src/routes/documents.ts): `artifacts/api-server/src/routes/documents.ts`
- [Mock tests API](https://github.com/kartik192008/okschool.webstie/blob/main/artifacts/api-server/src/routes/mock-tests.ts): `artifacts/api-server/src/routes/mock-tests.ts`
- **Payments API**
- [Products API](https://github.com/kartik192008/okschool.webstie/blob/main/artifacts/api-server/src/routes/amazon-products.ts): `artifacts/api-server/src/routes/amazon-products.ts`
- [Admin API](https://github.com/kartik192008/okschool.webstie/blob/main/artifacts/api-server/src/routes/admin.ts): `artifacts/api-server/src/routes/admin.ts`
- [Search API](https://github.com/kartik192008/okschool.webstie/blob/main/artifacts/api-server/src/routes/search.ts): `artifacts/api-server/src/routes/search.ts`
- **Visits API**
- [Health API](https://github.com/kartik192008/okschool.webstie/blob/main/artifacts/api-server/src/routes/health.ts): `artifacts/api-server/src/routes/health.ts`
- **History API**
- [Mock-test schema](https://github.com/kartik192008/okschool.webstie/blob/main/lib/db/src/schema/mock_tests.ts): `lib/db/src/schema/mock_tests.ts`

### Other components

- **Student**

## Connections

- Student → App router: uses
- App router → Navigation: renders
- App router → Route protection: guards routes
- App router → Home: routes to
- App router → Study materials: routes to
- App router → Mock test list: routes to
- App router → Exam session: routes to
- App router → Test history: routes to
- App router → Purchase history: routes to
- App router → Amazon store: routes to
- App router → Search results: routes to
- App router → Mock generator: routes to
- App router → My mocks: routes to
- App router → Admin dashboard: routes to
- Exam session → Exam timer: uses
- Exam session → Exam instructions: renders
- Exam session → Exam results: renders
- Exam session → Mock tests API: posts results
- HTTP app → Route registry: mounts (evidence: `artifacts/api-server/src/app.ts`)
- Route registry → Health API: registers
- Route registry → Documents API: registers
- Route registry → Products API: registers
- Route registry → Mock tests API: registers
- Route registry → Admin API: registers
- Route registry → Search API: registers
- Route registry → Visits API: registers
- Route registry → Payments API: registers
- Route registry → History API: registers
