# admin-mcua/ydutsnu architecture

> Architecture diagram of the GitHub repository admin-mcua/ydutsnu, 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/admin-mcua/ydutsnu
- Repository: https://github.com/admin-mcua/ydutsnu

## Overview

Unstudy is an AI-assisted study web app: students upload notes or PDFs, generate editable flashcards and quizzes, then study and share them; accounts retain sets and quizzes. The map also preserves its documented profiles, administration, social features, and multiplayer quiz rooms. Server routes in src/index.tsx orchestrate learning operations, while browser modules provide their interfaces. Source excerpts confirm selected calls; README capabilities and the source index identify important unsampled areas, whose internal links are omitted where evidence is unavailable.

Main entry points: [`src/index.tsx`](https://github.com/admin-mcua/ydutsnu/blob/main/src/index.tsx) (API routes), [`public/static/common.js`](https://github.com/admin-mcua/ydutsnu/blob/main/public/static/common.js) (Browser helpers), [`public/static/app.js`](https://github.com/admin-mcua/ydutsnu/blob/main/public/static/app.js) (Study workspace), [`src/social.ts`](https://github.com/admin-mcua/ydutsnu/blob/main/src/social.ts) (Social services)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Student experience"]
  node_authui["Sign-in UI<br/>[auth.js]"]
  node_shared["Browser helpers<br/>[common.js]"]
  node_workspace["Study workspace<br/>[app.js]"]
  node_quizui["Quiz player<br/>[quiz.js]"]
  node_shareui["Shared cards UI"]
  node_gameui["Game interface<br/>[game.js]"]
  node_adminui["Admin dashboard<br/>[admin.js]"]
end

subgraph group_server["Application services"]
  node_api["API routes<br/>[index.tsx]"]
  node_sessions["Session helpers<br/>[auth.ts]"]
  node_device["Device capture<br/>[device.ts]"]
  node_pages["Page shells<br/>[pages.tsx]"]
end

subgraph group_study["Study content"]
  node_gemini["AI generation<br/>[gemini.ts]"]
  node_studydata[("Sets and quizzes")]
end

subgraph group_community["Social and play"]
  node_socialui["Social workspace<br/>[app.js]"]
  node_social["Social services<br/>[social.ts]"]
  node_push["Web push<br/>[push.ts]"]
  node_rooms["Game rooms<br/>[game.ts]"]
  node_roomdata[("Room and player data")]
end

node_student(("Student"))
node_geminisvc{{"Google Gemini"}}
node_mail{{"Email delivery"}}
node_pushsvc{{"Push endpoints"}}

node_student -->|"signs in"| node_authui
node_student -->|"studies"| node_workspace
node_authui -->|"uses helpers"| node_shared
node_workspace -->|"uses helpers"| node_shared
node_quizui -->|"uses helpers"| node_shared
node_shareui -->|"uses helpers"| node_shared
node_gameui -->|"uses helpers"| node_shared
node_adminui -->|"uses helpers"| node_shared
node_authui -->|"calls API"| node_api
node_workspace -->|"calls API"| node_api
node_api -->|"uses sessions"| node_sessions
node_api -->|"renders shells"| node_pages
node_api -->|"generates content"| node_gemini
node_gemini -->|"requests generation"| node_geminisvc
node_api -->|"saves sets"| node_studydata
node_workspace -->|"calls API"| node_social
node_socialui -->|"calls API"| node_social
node_api -.->|"captures signup device"| node_device
node_api -->|"sends reset codes"| node_mail
node_api -.->|"registers social routes"| node_social
node_social -->|"checks sessions"| node_sessions
node_social -->|"queues notifications"| node_push
node_push -->|"sends pushes"| node_pushsvc
node_workspace -->|"calls room API"| node_rooms
node_gameui -.->|"calls room API"| node_rooms
node_rooms -->|"checks sessions"| node_sessions
node_rooms -->|"reads and writes"| node_roomdata
node_student -->|"takes quizzes"| node_quizui
node_student -->|"reviews shared cards"| node_shareui
node_student -.->|"plays room quiz"| node_gameui
node_adminui -.->|"calls API"| node_api

click node_authui "https://github.com/admin-mcua/ydutsnu/blob/main/public/static/auth.js"
click node_shared "https://github.com/admin-mcua/ydutsnu/blob/main/public/static/common.js"
click node_workspace "https://github.com/admin-mcua/ydutsnu/blob/main/public/static/app.js"
click node_quizui "https://github.com/admin-mcua/ydutsnu/blob/main/public/static/quiz.js"
click node_shareui "https://github.com/admin-mcua/ydutsnu/blob/main/public/static/share-flashcards.js"
click node_gameui "https://github.com/admin-mcua/ydutsnu/blob/main/public/static/game.js"
click node_adminui "https://github.com/admin-mcua/ydutsnu/blob/main/public/static/admin.js"
click node_api "https://github.com/admin-mcua/ydutsnu/blob/main/src/index.tsx"
click node_sessions "https://github.com/admin-mcua/ydutsnu/blob/main/src/lib/auth.ts"
click node_device "https://github.com/admin-mcua/ydutsnu/blob/main/src/lib/device.ts"
click node_pages "https://github.com/admin-mcua/ydutsnu/blob/main/src/pages.tsx"
click node_gemini "https://github.com/admin-mcua/ydutsnu/blob/main/src/lib/gemini.ts"
click node_studydata "https://github.com/admin-mcua/ydutsnu/blob/main/migrations/0001_initial_schema.sql"
click node_socialui "https://github.com/admin-mcua/ydutsnu/blob/main/public/static/app.js"
click node_social "https://github.com/admin-mcua/ydutsnu/blob/main/src/social.ts"
click node_push "https://github.com/admin-mcua/ydutsnu/blob/main/src/lib/push.ts"
click node_rooms "https://github.com/admin-mcua/ydutsnu/blob/main/src/game.ts"
click node_roomdata "https://github.com/admin-mcua/ydutsnu/blob/main/migrations/0006_game_rooms.sql"

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_authui,node_shared,node_workspace,node_quizui,node_shareui,node_gameui,node_adminui toneBlue
class node_api,node_sessions,node_device,node_pages toneAmber
class node_gemini,node_studydata toneMint
class node_socialui,node_social,node_push,node_rooms,node_roomdata toneRose
class node_student,node_geminisvc,node_mail,node_pushsvc toneIndigo
```

## Components

### Student experience

- [Sign-in UI](https://github.com/admin-mcua/ydutsnu/blob/main/public/static/auth.js): `public/static/auth.js`
- [Browser helpers](https://github.com/admin-mcua/ydutsnu/blob/main/public/static/common.js): `public/static/common.js`
- [Study workspace](https://github.com/admin-mcua/ydutsnu/blob/main/public/static/app.js): `public/static/app.js`
- [Quiz player](https://github.com/admin-mcua/ydutsnu/blob/main/public/static/quiz.js): `public/static/quiz.js`
- [Shared cards UI](https://github.com/admin-mcua/ydutsnu/blob/main/public/static/share-flashcards.js): `public/static/share-flashcards.js`
- [Game interface](https://github.com/admin-mcua/ydutsnu/blob/main/public/static/game.js): `public/static/game.js`
- [Admin dashboard](https://github.com/admin-mcua/ydutsnu/blob/main/public/static/admin.js): `public/static/admin.js`

### Application services

- [API routes](https://github.com/admin-mcua/ydutsnu/blob/main/src/index.tsx): `src/index.tsx`
- [Session helpers](https://github.com/admin-mcua/ydutsnu/blob/main/src/lib/auth.ts): `src/lib/auth.ts`
- [Device capture](https://github.com/admin-mcua/ydutsnu/blob/main/src/lib/device.ts): `src/lib/device.ts`
- [Page shells](https://github.com/admin-mcua/ydutsnu/blob/main/src/pages.tsx): `src/pages.tsx`

### Study content

- [AI generation](https://github.com/admin-mcua/ydutsnu/blob/main/src/lib/gemini.ts): `src/lib/gemini.ts`
- [Sets and quizzes](https://github.com/admin-mcua/ydutsnu/blob/main/migrations/0001_initial_schema.sql): `migrations/0001_initial_schema.sql`

### Social and play

- [Social workspace](https://github.com/admin-mcua/ydutsnu/blob/main/public/static/app.js): `public/static/app.js`
- [Social services](https://github.com/admin-mcua/ydutsnu/blob/main/src/social.ts): `src/social.ts`
- [Web push](https://github.com/admin-mcua/ydutsnu/blob/main/src/lib/push.ts): `src/lib/push.ts`
- [Game rooms](https://github.com/admin-mcua/ydutsnu/blob/main/src/game.ts): `src/game.ts`
- [Room and player data](https://github.com/admin-mcua/ydutsnu/blob/main/migrations/0006_game_rooms.sql): `migrations/0006_game_rooms.sql`

### Other components

- **Student**
- **Google Gemini**
- **Email delivery**
- **Push endpoints**

## Connections

- Student → Sign-in UI: signs in (evidence: `README.md`)
- Student → Study workspace: studies (evidence: `README.md`)
- Sign-in UI → Browser helpers: uses helpers (evidence: `public/static/auth.js`)
- Study workspace → Browser helpers: uses helpers (evidence: `public/static/app.js`)
- Quiz player → Browser helpers: uses helpers (evidence: `public/static/quiz.js`)
- Shared cards UI → Browser helpers: uses helpers (evidence: `public/static/share-flashcards.js`)
- Game interface → Browser helpers: uses helpers (evidence: `public/static/game.js`)
- Admin dashboard → Browser helpers: uses helpers (evidence: `public/static/admin.js`)
- Sign-in UI → API routes: calls API (evidence: `public/static/auth.js`)
- Study workspace → API routes: calls API (evidence: `public/static/app.js`)
- API routes → Session helpers: uses sessions (evidence: `src/index.tsx`)
- API routes → Page shells: renders shells (evidence: `src/index.tsx`)
- API routes → AI generation: generates content (evidence: `src/index.tsx`)
- AI generation → Google Gemini: requests generation (evidence: `src/lib/gemini.ts`)
- API routes → Sets and quizzes: saves sets (evidence: `src/index.tsx`)
- Study workspace → Social services: calls API (evidence: `public/static/app.js`)
- Social workspace → Social services: calls API (evidence: `public/static/app.js`)
- API routes → Device capture: captures signup device (evidence: `src/index.tsx`)
- API routes → Email delivery: sends reset codes (evidence: `src/index.tsx`)
- API routes → Social services: registers social routes (evidence: `src/index.tsx`)
- Social services → Session helpers: checks sessions (evidence: `src/social.ts`)
- Social services → Web push: queues notifications (evidence: `src/social.ts`)
- Web push → Push endpoints: sends pushes (evidence: `src/lib/push.ts`)
- Study workspace → Game rooms: calls room API (evidence: `public/static/app.js`)
- Game interface → Game rooms: calls room API
- Game rooms → Session helpers: checks sessions (evidence: `src/game.ts`)
- Game rooms → Room and player data: reads and writes (evidence: `src/game.ts`)
- Student → Quiz player: takes quizzes (evidence: `README.md`)
- Student → Shared cards UI: reviews shared cards (evidence: `README.md`)
- Student → Game interface: plays room quiz
- Admin dashboard → API routes: calls API
