# kaninpan/forum-thread-system architecture

> Architecture diagram of the GitHub repository kaninpan/forum-thread-system, 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/kaninpan/forum-thread-system
- Repository: https://github.com/kaninpan/forum-thread-system

## Overview

Forum Thread System is a Next.js discussion forum with account access, thread discovery and authoring, comments, profiles, and administrative oversight. The main path is a visitor or member entering the forum, finding or creating a thread, and participating through comments; administrators manage categories, users, reports, and dashboard data. Route handlers implement the sampled API behavior, with PostgreSQL accessed through both direct queries and Prisma. Several page-to-API links and unsampled capabilities are inferred from the repository layout, so those links are marked unverified rather than asserted as observed calls.

Main entry points: [`src/lib/prisma.ts`](https://github.com/kaninpan/forum-thread-system/blob/main/src/lib/prisma.ts) (Prisma client), [`src/app/api/threads/route.ts`](https://github.com/kaninpan/forum-thread-system/blob/main/src/app/api/threads/route.ts) (Thread operations), [`prisma/schema.prisma`](https://github.com/kaninpan/forum-thread-system/blob/main/prisma/schema.prisma) (Forum database), [`src/app/admin`](https://github.com/kaninpan/forum-thread-system/tree/main/src/app/admin) (Admin console)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["Forum experience"]
  node_forum["Forum home<br/>[page.tsx]"]
  node_categories["Category browsing<br/>[page.tsx]"]
  node_search["Thread search<br/>[page.tsx]"]
  node_dashboard["Member dashboard<br/>[page.tsx]"]
  node_threadauthor["Thread authoring<br/>[page.tsx]"]
  node_threadapi["Thread operations<br/>[route.ts]"]
  node_commentsapi["Comment operations<br/>[route.ts]"]
  node_reportapi["Thread reporting<br/>[route.ts]"]
end

subgraph group_identity["Identity and profile"]
  node_login["Login and registration<br/>[page.tsx]"]
  node_register["Registration page<br/>[page.tsx]"]
  node_authapi["Authentication endpoints"]
  node_authlib["Password and tokens<br/>[auth.ts]"]
  node_profileapi["Profile management<br/>[route.ts]"]
  node_avatarapi["Avatar upload<br/>[route.ts]"]
end

subgraph group_moderation["Administration"]
  node_adminpages["Admin console"]
  node_adminreports["Report review<br/>[route.ts]"]
  node_admindashboard["Admin metrics<br/>[route.ts]"]
  node_adminusers["User administration<br/>[route.ts]"]
  node_admincategories["Category administration<br/>[route.ts]"]
end

subgraph group_data["Persistence"]
  node_prisma["Prisma client<br/>[prisma.ts]"]
  node_postgres[("Forum database<br/>[schema.prisma]")]
  node_avatarfiles["Avatar files<br/>[route.ts]"]
end

node_visitor(("Visitor / member"))

node_visitor -.->|"opens"| node_forum
node_visitor -.->|"browses"| node_categories
node_visitor -.->|"searches"| node_search
node_visitor -.->|"authors"| node_threadauthor
node_visitor -.->|"authenticates"| node_login
node_forum -.->|"loads threads"| node_threadapi
node_categories -.->|"loads threads"| node_threadapi
node_search -.->|"searches threads"| node_threadapi
node_dashboard -.->|"loads threads"| node_threadapi
node_threadauthor -.->|"submits threads"| node_threadapi
node_threadapi -->|"queries threads"| node_postgres
node_threadapi -->|"loads author"| node_prisma
node_commentsapi -->|"queries comments"| node_postgres
node_commentsapi -->|"loads commenter"| node_prisma
node_reportapi -->|"accesses records"| node_prisma
node_login -.->|"submits credentials"| node_authapi
node_register -.->|"submits registration"| node_authapi
node_authapi -->|"reads users"| node_prisma
node_authapi -->|"uses password and tokens"| node_authlib
node_authlib -.->|"via Prisma"| node_postgres
node_profileapi -->|"reads and updates"| node_prisma
node_avatarapi -->|"updates profile"| node_prisma
node_avatarapi -->|"writes files"| node_avatarfiles
node_adminpages -.->|"reviews reports"| node_adminreports
node_adminpages -.->|"loads metrics"| node_admindashboard
node_adminpages -.->|"manages users"| node_adminusers
node_adminpages -.->|"manages categories"| node_admincategories
node_adminreports -->|"queries reports"| node_postgres
node_adminreports -->|"loads related data"| node_prisma
node_admindashboard -->|"queries metrics"| node_postgres
node_admindashboard -->|"loads related data"| node_prisma
node_adminusers -->|"manages accounts"| node_prisma
node_adminusers -->|"hashes passwords"| node_authlib
node_admincategories -->|"manages categories"| node_prisma
node_prisma -->|"queries database"| node_postgres

click node_forum "https://github.com/kaninpan/forum-thread-system/blob/main/src/app/page.tsx"
click node_categories "https://github.com/kaninpan/forum-thread-system/blob/main/src/app/categories/page.tsx"
click node_search "https://github.com/kaninpan/forum-thread-system/blob/main/src/app/search/page.tsx"
click node_dashboard "https://github.com/kaninpan/forum-thread-system/blob/main/src/app/dashboard/page.tsx"
click node_threadauthor "https://github.com/kaninpan/forum-thread-system/blob/main/src/app/threads/new/page.tsx"
click node_threadapi "https://github.com/kaninpan/forum-thread-system/blob/main/src/app/api/threads/route.ts"
click node_commentsapi "https://github.com/kaninpan/forum-thread-system/blob/main/src/app/api/threads/comments/route.ts"
click node_reportapi "https://github.com/kaninpan/forum-thread-system/blob/main/src/app/api/threads/report/route.ts"
click node_login "https://github.com/kaninpan/forum-thread-system/blob/main/src/app/login/page.tsx"
click node_register "https://github.com/kaninpan/forum-thread-system/blob/main/src/app/register/page.tsx"
click node_authapi "https://github.com/kaninpan/forum-thread-system/tree/main/src/app/api/auth"
click node_authlib "https://github.com/kaninpan/forum-thread-system/blob/main/src/lib/auth.ts"
click node_profileapi "https://github.com/kaninpan/forum-thread-system/blob/main/src/app/api/profile/route.ts"
click node_avatarapi "https://github.com/kaninpan/forum-thread-system/blob/main/src/app/api/profile/avatar/route.ts"
click node_adminpages "https://github.com/kaninpan/forum-thread-system/tree/main/src/app/admin"
click node_adminreports "https://github.com/kaninpan/forum-thread-system/blob/main/src/app/api/admin/reports/route.ts"
click node_admindashboard "https://github.com/kaninpan/forum-thread-system/blob/main/src/app/api/admin/dashboard/route.ts"
click node_adminusers "https://github.com/kaninpan/forum-thread-system/blob/main/src/app/api/admin/users/route.ts"
click node_admincategories "https://github.com/kaninpan/forum-thread-system/blob/main/src/app/api/admin/categories/route.ts"
click node_prisma "https://github.com/kaninpan/forum-thread-system/blob/main/src/lib/prisma.ts"
click node_postgres "https://github.com/kaninpan/forum-thread-system/blob/main/prisma/schema.prisma"
click node_avatarfiles "https://github.com/kaninpan/forum-thread-system/blob/main/src/app/api/profile/avatar/route.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_forum,node_categories,node_search,node_dashboard,node_threadauthor,node_threadapi,node_commentsapi,node_reportapi toneBlue
class node_login,node_register,node_authapi,node_authlib,node_profileapi,node_avatarapi toneAmber
class node_adminpages,node_adminreports,node_admindashboard,node_adminusers,node_admincategories toneMint
class node_prisma,node_postgres,node_avatarfiles toneRose
class node_visitor toneIndigo
```

## Components

### Forum experience

- [Forum home](https://github.com/kaninpan/forum-thread-system/blob/main/src/app/page.tsx): `src/app/page.tsx`
- [Category browsing](https://github.com/kaninpan/forum-thread-system/blob/main/src/app/categories/page.tsx): `src/app/categories/page.tsx`
- [Thread search](https://github.com/kaninpan/forum-thread-system/blob/main/src/app/search/page.tsx): `src/app/search/page.tsx`
- [Member dashboard](https://github.com/kaninpan/forum-thread-system/blob/main/src/app/dashboard/page.tsx): `src/app/dashboard/page.tsx`
- [Thread authoring](https://github.com/kaninpan/forum-thread-system/blob/main/src/app/threads/new/page.tsx): `src/app/threads/new/page.tsx`
- [Thread operations](https://github.com/kaninpan/forum-thread-system/blob/main/src/app/api/threads/route.ts): `src/app/api/threads/route.ts`
- [Comment operations](https://github.com/kaninpan/forum-thread-system/blob/main/src/app/api/threads/comments/route.ts): `src/app/api/threads/comments/route.ts`
- [Thread reporting](https://github.com/kaninpan/forum-thread-system/blob/main/src/app/api/threads/report/route.ts): `src/app/api/threads/report/route.ts`

### Identity and profile

- [Login and registration](https://github.com/kaninpan/forum-thread-system/blob/main/src/app/login/page.tsx): `src/app/login/page.tsx`
- [Registration page](https://github.com/kaninpan/forum-thread-system/blob/main/src/app/register/page.tsx): `src/app/register/page.tsx`
- [Authentication endpoints](https://github.com/kaninpan/forum-thread-system/tree/main/src/app/api/auth): `src/app/api/auth`
- [Password and tokens](https://github.com/kaninpan/forum-thread-system/blob/main/src/lib/auth.ts): `src/lib/auth.ts`
- [Profile management](https://github.com/kaninpan/forum-thread-system/blob/main/src/app/api/profile/route.ts): `src/app/api/profile/route.ts`
- [Avatar upload](https://github.com/kaninpan/forum-thread-system/blob/main/src/app/api/profile/avatar/route.ts): `src/app/api/profile/avatar/route.ts`

### Administration

- [Admin console](https://github.com/kaninpan/forum-thread-system/tree/main/src/app/admin): `src/app/admin`
- [Report review](https://github.com/kaninpan/forum-thread-system/blob/main/src/app/api/admin/reports/route.ts): `src/app/api/admin/reports/route.ts`
- [Admin metrics](https://github.com/kaninpan/forum-thread-system/blob/main/src/app/api/admin/dashboard/route.ts): `src/app/api/admin/dashboard/route.ts`
- [User administration](https://github.com/kaninpan/forum-thread-system/blob/main/src/app/api/admin/users/route.ts): `src/app/api/admin/users/route.ts`
- [Category administration](https://github.com/kaninpan/forum-thread-system/blob/main/src/app/api/admin/categories/route.ts): `src/app/api/admin/categories/route.ts`

### Persistence

- [Prisma client](https://github.com/kaninpan/forum-thread-system/blob/main/src/lib/prisma.ts): `src/lib/prisma.ts`
- [Forum database](https://github.com/kaninpan/forum-thread-system/blob/main/prisma/schema.prisma): `prisma/schema.prisma`
- [Avatar files](https://github.com/kaninpan/forum-thread-system/blob/main/src/app/api/profile/avatar/route.ts): `src/app/api/profile/avatar/route.ts`

### Other components

- **Visitor / member**

## Connections

- Visitor / member → Forum home: opens
- Visitor / member → Category browsing: browses
- Visitor / member → Thread search: searches
- Visitor / member → Thread authoring: authors
- Visitor / member → Login and registration: authenticates
- Forum home → Thread operations: loads threads
- Category browsing → Thread operations: loads threads
- Thread search → Thread operations: searches threads
- Member dashboard → Thread operations: loads threads
- Thread authoring → Thread operations: submits threads
- Thread operations → Forum database: queries threads (evidence: `src/app/api/threads/route.ts`)
- Thread operations → Prisma client: loads author (evidence: `src/app/api/threads/route.ts`)
- Comment operations → Forum database: queries comments (evidence: `src/app/api/threads/comments/route.ts`)
- Comment operations → Prisma client: loads commenter (evidence: `src/app/api/threads/comments/route.ts`)
- Thread reporting → Prisma client: accesses records (evidence: `src/app/api/threads/report/route.ts`)
- Login and registration → Authentication endpoints: submits credentials
- Registration page → Authentication endpoints: submits registration
- Authentication endpoints → Prisma client: reads users (evidence: `src/app/api/auth/login/route.ts`)
- Authentication endpoints → Password and tokens: uses password and tokens (evidence: `src/app/api/auth/login/route.ts`)
- Password and tokens → Forum database: via Prisma
- Profile management → Prisma client: reads and updates (evidence: `src/app/api/profile/route.ts`)
- Avatar upload → Prisma client: updates profile (evidence: `src/app/api/profile/avatar/route.ts`)
- Avatar upload → Avatar files: writes files (evidence: `src/app/api/profile/avatar/route.ts`)
- Admin console → Report review: reviews reports
- Admin console → Admin metrics: loads metrics
- Admin console → User administration: manages users
- Admin console → Category administration: manages categories
- Report review → Forum database: queries reports (evidence: `src/app/api/admin/reports/route.ts`)
- Report review → Prisma client: loads related data (evidence: `src/app/api/admin/reports/route.ts`)
- Admin metrics → Forum database: queries metrics (evidence: `src/app/api/admin/dashboard/route.ts`)
- Admin metrics → Prisma client: loads related data (evidence: `src/app/api/admin/dashboard/route.ts`)
- User administration → Prisma client: manages accounts (evidence: `src/app/api/admin/users/route.ts`)
- User administration → Password and tokens: hashes passwords (evidence: `src/app/api/admin/users/route.ts`)
- Category administration → Prisma client: manages categories (evidence: `src/app/api/admin/categories/route.ts`)
- Prisma client → Forum database: queries database (evidence: `src/lib/prisma.ts`)
