How kaninpan/forum-thread-system works
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: prisma.ts Prisma client · route.ts Thread operations · schema.prisma Forum database · admin Admin console
Components 23
Forum experience
- Forum home
src/app/page.tsx - Category browsing
src/app/categories/page.tsx - Thread search
src/app/search/page.tsx - Member dashboard
src/app/dashboard/page.tsx - Thread authoring
src/app/threads/new/page.tsx - Thread operations
src/app/api/threads/route.ts - Comment operations
src/app/api/threads/comments/route.ts - Thread reporting
src/app/api/threads/report/route.ts
Identity and profile
- Login and registration
src/app/login/page.tsx - Registration page
src/app/register/page.tsx - Authentication endpoints
src/app/api/auth - Password and tokens
src/lib/auth.ts - Profile management
src/app/api/profile/route.ts - Avatar upload
src/app/api/profile/avatar/route.ts
Administration
- Admin console
src/app/admin - Report review
src/app/api/admin/reports/route.ts - Admin metrics
src/app/api/admin/dashboard/route.ts - User administration
src/app/api/admin/users/route.ts - Category administration
src/app/api/admin/categories/route.ts
Persistence
- Prisma client
src/lib/prisma.ts - Forum database
prisma/schema.prisma - Avatar files
src/app/api/profile/avatar/route.ts
Other components
- Visitor / member
Connections 35
- 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
src/app/api/threads/route.ts - Thread operations → Prisma client: loads author
src/app/api/threads/route.ts - Comment operations → Forum database: queries comments
src/app/api/threads/comments/route.ts - Comment operations → Prisma client: loads commenter
src/app/api/threads/comments/route.ts - Thread reporting → Prisma client: accesses records
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
src/app/api/auth/login/route.ts - Authentication endpoints → Password and tokens: uses password and tokens
src/app/api/auth/login/route.ts - Password and tokens → Forum database: via Prisma
- Profile management → Prisma client: reads and updates
src/app/api/profile/route.ts - Avatar upload → Prisma client: updates profile
src/app/api/profile/avatar/route.ts - Avatar upload → Avatar files: writes files
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
src/app/api/admin/reports/route.ts - Report review → Prisma client: loads related data
src/app/api/admin/reports/route.ts - Admin metrics → Forum database: queries metrics
src/app/api/admin/dashboard/route.ts - Admin metrics → Prisma client: loads related data
src/app/api/admin/dashboard/route.ts - User administration → Prisma client: manages accounts
src/app/api/admin/users/route.ts - User administration → Password and tokens: hashes passwords
src/app/api/admin/users/route.ts - Category administration → Prisma client: manages categories
src/app/api/admin/categories/route.ts - Prisma client → Forum database: queries database
src/lib/prisma.ts