# makey06/summerscholar architecture

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

- Interactive diagram: https://gitdiagram.com/makey06/summerscholar
- Repository: https://github.com/makey06/summerscholar

## Overview

SummerScholar is a no-login learning app for a child: choose a subject or week, complete progressive activities, and track stars, progress, badges, and a child profile. The frontend routes learners through lessons and progress views; the Express API serves learning content and records progress against PostgreSQL. README capabilities are included, but several frontend pages and API modules were not excerpted, so their internal interactions are not asserted. The frontend-to-API link is documented at the architecture level, not verified from sampled client calls.

Main entry points: [`artifacts/learn-app/src/App.tsx`](https://github.com/makey06/summerscholar/blob/Appbranch/artifacts/learn-app/src/App.tsx) (App router), [`artifacts/api-server/src/routes/index.ts`](https://github.com/makey06/summerscholar/blob/Appbranch/artifacts/api-server/src/routes/index.ts) (Route registry), [`lib/db/src/index.ts`](https://github.com/makey06/summerscholar/blob/Appbranch/lib/db/src/index.ts) (PostgreSQL data), [`artifacts/learn-app/src/pages/lesson.tsx`](https://github.com/makey06/summerscholar/blob/Appbranch/artifacts/learn-app/src/pages/lesson.tsx) (Activity player)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_learner_app["Learning experience"]
  node_frontend["App router<br/>[App.tsx]"]
  node_home["Home overview<br/>[home.tsx]"]
  node_categories["Subject browser<br/>[categories.tsx]"]
  node_category["Subject lessons<br/>[category.tsx]"]
  node_lesson["Activity player<br/>[lesson.tsx]"]
  node_weekly["Weekly view<br/>[weekly-view.tsx]"]
  node_achievements["Badge collection<br/>[achievements.tsx]"]
  node_profile_page["Child profile<br/>[profile.tsx]"]
end

subgraph group_api["Learning API"]
  node_api_server["Express API<br/>[app.ts]"]
  node_route_mount["Route registry<br/>[index.ts]"]
  node_health["Health endpoint<br/>[health.ts]"]
  node_category_api["Category API<br/>[categories.ts]"]
  node_lesson_api["Lesson API<br/>[lessons.ts]"]
  node_progress_api["Progress API<br/>[progress.ts]"]
  node_profile_api["Profile API<br/>[profile.ts]"]
  node_stats_api["Stats API<br/>[stats.ts]"]
end

subgraph group_data["Learning data"]
  node_database[("PostgreSQL data<br/>[index.ts]")]
end

subgraph group_support["Shared interface"]
  node_navigation["Navigation<br/>[Navigation.tsx]"]
  node_lesson_feedback["Lesson feedback<br/>[Confetti.tsx]"]
end

node_learner(("Child learner"))

node_learner -->|"uses"| node_frontend
node_frontend -->|"routes to"| node_home
node_frontend -->|"routes to"| node_categories
node_frontend -->|"routes to"| node_category
node_frontend -->|"routes to"| node_lesson
node_frontend -->|"routes to"| node_achievements
node_frontend -->|"routes to"| node_profile_page
node_frontend -->|"renders"| node_navigation
node_frontend -.->|"uses API"| node_api_server
node_frontend -.->|"routes to"| node_weekly
node_lesson -.->|"uses"| node_lesson_feedback
node_api_server -->|"mounts"| node_route_mount
node_route_mount -->|"registers"| node_health
node_route_mount -->|"registers"| node_profile_api
node_route_mount -->|"registers"| node_category_api
node_route_mount -->|"registers"| node_lesson_api
node_route_mount -->|"registers"| node_progress_api
node_route_mount -->|"registers"| node_stats_api
node_category_api -->|"queries"| node_database
node_lesson_api -->|"queries"| node_database
node_progress_api -->|"reads/writes"| node_database
node_stats_api -->|"queries"| node_database
node_profile_api -.->|"accesses"| node_database

click node_frontend "https://github.com/makey06/summerscholar/blob/Appbranch/artifacts/learn-app/src/App.tsx"
click node_home "https://github.com/makey06/summerscholar/blob/Appbranch/artifacts/learn-app/src/pages/home.tsx"
click node_categories "https://github.com/makey06/summerscholar/blob/Appbranch/artifacts/learn-app/src/pages/categories.tsx"
click node_category "https://github.com/makey06/summerscholar/blob/Appbranch/artifacts/learn-app/src/pages/category.tsx"
click node_lesson "https://github.com/makey06/summerscholar/blob/Appbranch/artifacts/learn-app/src/pages/lesson.tsx"
click node_weekly "https://github.com/makey06/summerscholar/blob/Appbranch/artifacts/learn-app/src/pages/weekly-view.tsx"
click node_achievements "https://github.com/makey06/summerscholar/blob/Appbranch/artifacts/learn-app/src/pages/achievements.tsx"
click node_profile_page "https://github.com/makey06/summerscholar/blob/Appbranch/artifacts/learn-app/src/pages/profile.tsx"
click node_navigation "https://github.com/makey06/summerscholar/blob/Appbranch/artifacts/learn-app/src/components/Navigation.tsx"
click node_lesson_feedback "https://github.com/makey06/summerscholar/blob/Appbranch/artifacts/learn-app/src/components/Confetti.tsx"
click node_api_server "https://github.com/makey06/summerscholar/blob/Appbranch/artifacts/api-server/src/app.ts"
click node_route_mount "https://github.com/makey06/summerscholar/blob/Appbranch/artifacts/api-server/src/routes/index.ts"
click node_health "https://github.com/makey06/summerscholar/blob/Appbranch/artifacts/api-server/src/routes/health.ts"
click node_category_api "https://github.com/makey06/summerscholar/blob/Appbranch/artifacts/api-server/src/routes/categories.ts"
click node_lesson_api "https://github.com/makey06/summerscholar/blob/Appbranch/artifacts/api-server/src/routes/lessons.ts"
click node_progress_api "https://github.com/makey06/summerscholar/blob/Appbranch/artifacts/api-server/src/routes/progress.ts"
click node_profile_api "https://github.com/makey06/summerscholar/blob/Appbranch/artifacts/api-server/src/routes/profile.ts"
click node_stats_api "https://github.com/makey06/summerscholar/blob/Appbranch/artifacts/api-server/src/routes/stats.ts"
click node_database "https://github.com/makey06/summerscholar/blob/Appbranch/lib/db/src/index.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_frontend,node_home,node_categories,node_category,node_lesson,node_weekly,node_achievements,node_profile_page toneBlue
class node_api_server,node_route_mount,node_health,node_category_api,node_lesson_api,node_progress_api,node_profile_api,node_stats_api toneAmber
class node_database toneMint
class node_navigation,node_lesson_feedback toneRose
class node_learner toneIndigo
```

## Components

### Learning experience

- [App router](https://github.com/makey06/summerscholar/blob/Appbranch/artifacts/learn-app/src/App.tsx): `artifacts/learn-app/src/App.tsx`
- [Home overview](https://github.com/makey06/summerscholar/blob/Appbranch/artifacts/learn-app/src/pages/home.tsx): `artifacts/learn-app/src/pages/home.tsx`
- [Subject browser](https://github.com/makey06/summerscholar/blob/Appbranch/artifacts/learn-app/src/pages/categories.tsx): `artifacts/learn-app/src/pages/categories.tsx`
- [Subject lessons](https://github.com/makey06/summerscholar/blob/Appbranch/artifacts/learn-app/src/pages/category.tsx): `artifacts/learn-app/src/pages/category.tsx`
- [Activity player](https://github.com/makey06/summerscholar/blob/Appbranch/artifacts/learn-app/src/pages/lesson.tsx): `artifacts/learn-app/src/pages/lesson.tsx`
- [Weekly view](https://github.com/makey06/summerscholar/blob/Appbranch/artifacts/learn-app/src/pages/weekly-view.tsx): `artifacts/learn-app/src/pages/weekly-view.tsx`
- [Badge collection](https://github.com/makey06/summerscholar/blob/Appbranch/artifacts/learn-app/src/pages/achievements.tsx): `artifacts/learn-app/src/pages/achievements.tsx`
- [Child profile](https://github.com/makey06/summerscholar/blob/Appbranch/artifacts/learn-app/src/pages/profile.tsx): `artifacts/learn-app/src/pages/profile.tsx`

### Learning API

- [Express API](https://github.com/makey06/summerscholar/blob/Appbranch/artifacts/api-server/src/app.ts): `artifacts/api-server/src/app.ts`
- [Route registry](https://github.com/makey06/summerscholar/blob/Appbranch/artifacts/api-server/src/routes/index.ts): `artifacts/api-server/src/routes/index.ts`
- [Health endpoint](https://github.com/makey06/summerscholar/blob/Appbranch/artifacts/api-server/src/routes/health.ts): `artifacts/api-server/src/routes/health.ts`
- [Category API](https://github.com/makey06/summerscholar/blob/Appbranch/artifacts/api-server/src/routes/categories.ts): `artifacts/api-server/src/routes/categories.ts`
- [Lesson API](https://github.com/makey06/summerscholar/blob/Appbranch/artifacts/api-server/src/routes/lessons.ts): `artifacts/api-server/src/routes/lessons.ts`
- [Progress API](https://github.com/makey06/summerscholar/blob/Appbranch/artifacts/api-server/src/routes/progress.ts): `artifacts/api-server/src/routes/progress.ts`
- [Profile API](https://github.com/makey06/summerscholar/blob/Appbranch/artifacts/api-server/src/routes/profile.ts): `artifacts/api-server/src/routes/profile.ts`
- [Stats API](https://github.com/makey06/summerscholar/blob/Appbranch/artifacts/api-server/src/routes/stats.ts): `artifacts/api-server/src/routes/stats.ts`

### Learning data

- [PostgreSQL data](https://github.com/makey06/summerscholar/blob/Appbranch/lib/db/src/index.ts): `lib/db/src/index.ts`

### Shared interface

- [Navigation](https://github.com/makey06/summerscholar/blob/Appbranch/artifacts/learn-app/src/components/Navigation.tsx): `artifacts/learn-app/src/components/Navigation.tsx`
- [Lesson feedback](https://github.com/makey06/summerscholar/blob/Appbranch/artifacts/learn-app/src/components/Confetti.tsx): `artifacts/learn-app/src/components/Confetti.tsx`

### Other components

- **Child learner**

## Connections

- Child learner → App router: uses
- App router → Home overview: routes to (evidence: `artifacts/learn-app/src/App.tsx`)
- App router → Subject browser: routes to (evidence: `artifacts/learn-app/src/App.tsx`)
- App router → Subject lessons: routes to (evidence: `artifacts/learn-app/src/App.tsx`)
- App router → Activity player: routes to (evidence: `artifacts/learn-app/src/App.tsx`)
- App router → Badge collection: routes to (evidence: `artifacts/learn-app/src/App.tsx`)
- App router → Child profile: routes to (evidence: `artifacts/learn-app/src/App.tsx`)
- App router → Navigation: renders (evidence: `artifacts/learn-app/src/App.tsx`)
- App router → Express API: uses API
- App router → Weekly view: routes to
- Activity player → Lesson feedback: uses
- Express API → Route registry: mounts (evidence: `artifacts/api-server/src/app.ts`)
- Route registry → Health endpoint: registers (evidence: `artifacts/api-server/src/routes/index.ts`)
- Route registry → Profile API: registers (evidence: `artifacts/api-server/src/routes/index.ts`)
- Route registry → Category API: registers (evidence: `artifacts/api-server/src/routes/index.ts`)
- Route registry → Lesson API: registers (evidence: `artifacts/api-server/src/routes/index.ts`)
- Route registry → Progress API: registers (evidence: `artifacts/api-server/src/routes/index.ts`)
- Route registry → Stats API: registers (evidence: `artifacts/api-server/src/routes/index.ts`)
- Category API → PostgreSQL data: queries (evidence: `artifacts/api-server/src/routes/categories.ts`)
- Lesson API → PostgreSQL data: queries (evidence: `artifacts/api-server/src/routes/lessons.ts`)
- Progress API → PostgreSQL data: reads/writes (evidence: `artifacts/api-server/src/routes/progress.ts`)
- Stats API → PostgreSQL data: queries (evidence: `artifacts/api-server/src/routes/stats.ts`)
- Profile API → PostgreSQL data: accesses
