# rajsanjel/ideaboard architecture

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

- Interactive diagram: https://gitdiagram.com/rajsanjel/ideaboard
- Repository: https://github.com/rajsanjel/ideaboard

## Overview

IdeaBoard is a web-based college feedback and suggestion board. Students register or sign in, browse and submit suggestions, and view suggestion details and status; administrators manage users and update suggestion status. The frontend talks to an Express API backed by PostgreSQL. The README and source index establish the broad frontend/API and route/service/database structure, while the sampled backend excerpts confirm authentication, validation, and service behavior. Several feature implementations were not excerpted, so their internal links are omitted or marked unverified.

Main entry points: [`frontend/js/config/api.js`](https://github.com/rajsanjel/ideaboard/blob/main/frontend/js/config/api.js) (API configuration), [`backend/src/db.ts`](https://github.com/rajsanjel/ideaboard/blob/main/backend/src/db.ts) (PostgreSQL), [`backend/src/routes/api.ts`](https://github.com/rajsanjel/ideaboard/blob/main/backend/src/routes/api.ts) (API router), [`backend/src/routes/api/suggestions.ts`](https://github.com/rajsanjel/ideaboard/blob/main/backend/src/routes/api/suggestions.ts) (Suggestion routes)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web experience"]
  node_webpages["Suggestion pages<br/>[suggestions.js]"]
  node_detail["Suggestion detail<br/>[suggestion.js]"]
  node_submission["Submission modal<br/>[modal.js]"]
  node_authui["Login and signup<br/>[login.js]"]
  node_authstate["Browser auth state<br/>[auth.js]"]
  node_adminui["Admin console<br/>[index.js]"]
  node_peopleui["User management<br/>[people.js]"]
  node_apiconfig["API configuration<br/>[api.js]"]
  node_authhelpers["Auth form helpers<br/>[auth-ui.js]"]
  node_toasts["Toast feedback<br/>[toast.js]"]
end

subgraph group_api["API surface"]
  node_server["HTTP server<br/>[index.ts]"]
  node_apiroot["API router<br/>[api.ts]"]
  node_authroutes["Auth routes<br/>[auth.ts]"]
  node_suggestionroutes["Suggestion routes<br/>[suggestions.ts]"]
  node_adminroutes["Admin routes<br/>[admin.ts]"]
  node_validators["Request validation"]
  node_authcontroller["Auth controller<br/>[authController.ts]"]
  node_suggestioncontroller["Suggestion controller"]
  node_admincontroller["Admin controller<br/>[adminController.ts]"]
  node_authmiddleware["Auth middleware<br/>[authMiddleware.ts]"]
  node_adminmiddleware["Admin middleware<br/>[adminMiddleware.ts]"]
  node_authvalidation["Auth validation<br/>[authValidator.ts]"]
  node_suggestionvalidation["Suggestion validation"]
end

subgraph group_domain["Domain services"]
  node_authservice["Account service<br/>[auth.ts]"]
  node_suggestionservice["Suggestion service<br/>[suggestions.ts]"]
  node_adminservice["Administration service<br/>[admin.ts]"]
  node_categories["Suggestion categories<br/>[categories.json]"]
end

subgraph group_storage["Identity and storage"]
  node_tokens["JWT and cookies<br/>[token.ts]"]
  node_database[("PostgreSQL<br/>[db.ts]")]
end

node_students(("Students"))
node_staff(("Staff and admins"))

node_students -->|"browse"| node_webpages
node_students -->|"sign in"| node_authui
node_students -->|"submit idea"| node_submission
node_staff -->|"manage board"| node_adminui
node_webpages -->|"uses API config"| node_apiconfig
node_detail -->|"uses API config"| node_apiconfig
node_submission -->|"uses API config"| node_apiconfig
node_authui -->|"uses auth state"| node_authstate
node_authui -->|"uses form helpers"| node_authhelpers
node_authstate -->|"requests auth API"| node_apiconfig
node_adminui -->|"uses API config"| node_apiconfig
node_peopleui -->|"uses API config"| node_apiconfig
node_apiconfig -.->|"sends API requests"| node_server
node_server -->|"mounts routes"| node_apiroot
node_apiroot -->|"registers routes"| node_authroutes
node_apiroot -->|"registers routes"| node_suggestionroutes
node_apiroot -->|"registers routes"| node_adminroutes
node_authroutes -->|"routes requests"| node_authcontroller
node_authroutes -->|"validates input"| node_authvalidation
node_suggestionroutes -->|"routes requests"| node_suggestioncontroller
node_suggestionroutes -->|"validates input"| node_suggestionvalidation
node_suggestionroutes -->|"protects routes"| node_authmiddleware
node_adminroutes -->|"routes requests"| node_admincontroller
node_adminroutes -->|"checks identity"| node_authmiddleware
node_adminroutes -->|"checks admin role"| node_adminmiddleware
node_authcontroller -->|"delegates account work"| node_authservice
node_authcontroller -->|"sets auth cookie"| node_tokens
node_suggestioncontroller -->|"delegates suggestions"| node_suggestionservice
node_admincontroller -->|"delegates admin work"| node_adminservice
node_authservice -->|"queries users"| node_database
node_authservice -->|"verifies session token"| node_tokens
node_suggestionservice -->|"queries suggestions"| node_database
node_adminservice -->|"queries admin data"| node_database
node_authmiddleware -->|"verifies JWT"| node_tokens
node_authmiddleware -->|"checks user"| node_database
node_adminmiddleware -->|"checks role"| node_database
node_authvalidation -.-> node_categories
node_suggestionvalidation -->|"checks categories"| node_categories

click node_webpages "https://github.com/rajsanjel/ideaboard/blob/main/frontend/js/suggestions.js"
click node_detail "https://github.com/rajsanjel/ideaboard/blob/main/frontend/js/suggestion.js"
click node_submission "https://github.com/rajsanjel/ideaboard/blob/main/frontend/js/modal.js"
click node_authui "https://github.com/rajsanjel/ideaboard/blob/main/frontend/js/login.js"
click node_authstate "https://github.com/rajsanjel/ideaboard/blob/main/frontend/js/global/auth.js"
click node_adminui "https://github.com/rajsanjel/ideaboard/blob/main/frontend/admin/js/index.js"
click node_peopleui "https://github.com/rajsanjel/ideaboard/blob/main/frontend/admin/js/people.js"
click node_apiconfig "https://github.com/rajsanjel/ideaboard/blob/main/frontend/js/config/api.js"
click node_server "https://github.com/rajsanjel/ideaboard/blob/main/backend/src/index.ts"
click node_apiroot "https://github.com/rajsanjel/ideaboard/blob/main/backend/src/routes/api.ts"
click node_authroutes "https://github.com/rajsanjel/ideaboard/blob/main/backend/src/routes/api/auth.ts"
click node_suggestionroutes "https://github.com/rajsanjel/ideaboard/blob/main/backend/src/routes/api/suggestions.ts"
click node_adminroutes "https://github.com/rajsanjel/ideaboard/blob/main/backend/src/routes/api/admin.ts"
click node_validators "https://github.com/rajsanjel/ideaboard/tree/main/backend/src/validators"
click node_authcontroller "https://github.com/rajsanjel/ideaboard/blob/main/backend/src/app/Http/Controllers/authController.ts"
click node_suggestioncontroller "https://github.com/rajsanjel/ideaboard/blob/main/backend/src/app/Http/Controllers/suggestionsController.ts"
click node_admincontroller "https://github.com/rajsanjel/ideaboard/blob/main/backend/src/app/Http/Controllers/adminController.ts"
click node_authmiddleware "https://github.com/rajsanjel/ideaboard/blob/main/backend/src/app/Http/Middleware/authMiddleware.ts"
click node_adminmiddleware "https://github.com/rajsanjel/ideaboard/blob/main/backend/src/app/Http/Middleware/adminMiddleware.ts"
click node_authservice "https://github.com/rajsanjel/ideaboard/blob/main/backend/src/app/Services/auth.ts"
click node_suggestionservice "https://github.com/rajsanjel/ideaboard/blob/main/backend/src/app/Services/suggestions.ts"
click node_adminservice "https://github.com/rajsanjel/ideaboard/blob/main/backend/src/app/Services/admin.ts"
click node_authvalidation "https://github.com/rajsanjel/ideaboard/blob/main/backend/src/validators/authValidator.ts"
click node_suggestionvalidation "https://github.com/rajsanjel/ideaboard/blob/main/backend/src/validators/suggestionValidator.ts"
click node_tokens "https://github.com/rajsanjel/ideaboard/blob/main/backend/src/helper/token.ts"
click node_database "https://github.com/rajsanjel/ideaboard/blob/main/backend/src/db.ts"
click node_categories "https://github.com/rajsanjel/ideaboard/blob/main/shared/categories.json"
click node_authhelpers "https://github.com/rajsanjel/ideaboard/blob/main/frontend/js/util/auth-ui.js"
click node_toasts "https://github.com/rajsanjel/ideaboard/blob/main/frontend/js/util/toast.js"

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_webpages,node_detail,node_submission,node_authui,node_authstate,node_adminui,node_peopleui,node_apiconfig,node_authhelpers,node_toasts toneBlue
class node_server,node_apiroot,node_authroutes,node_suggestionroutes,node_adminroutes,node_validators,node_authcontroller,node_suggestioncontroller,node_admincontroller,node_authmiddleware,node_adminmiddleware,node_authvalidation,node_suggestionvalidation toneAmber
class node_authservice,node_suggestionservice,node_adminservice,node_categories toneMint
class node_tokens,node_database toneRose
class node_students,node_staff toneIndigo
```

## Components

### Web experience

- [Suggestion pages](https://github.com/rajsanjel/ideaboard/blob/main/frontend/js/suggestions.js): `frontend/js/suggestions.js`
- [Suggestion detail](https://github.com/rajsanjel/ideaboard/blob/main/frontend/js/suggestion.js): `frontend/js/suggestion.js`
- [Submission modal](https://github.com/rajsanjel/ideaboard/blob/main/frontend/js/modal.js): `frontend/js/modal.js`
- [Login and signup](https://github.com/rajsanjel/ideaboard/blob/main/frontend/js/login.js): `frontend/js/login.js`
- [Browser auth state](https://github.com/rajsanjel/ideaboard/blob/main/frontend/js/global/auth.js): `frontend/js/global/auth.js`
- [Admin console](https://github.com/rajsanjel/ideaboard/blob/main/frontend/admin/js/index.js): `frontend/admin/js/index.js`
- [User management](https://github.com/rajsanjel/ideaboard/blob/main/frontend/admin/js/people.js): `frontend/admin/js/people.js`
- [API configuration](https://github.com/rajsanjel/ideaboard/blob/main/frontend/js/config/api.js): `frontend/js/config/api.js`
- [Auth form helpers](https://github.com/rajsanjel/ideaboard/blob/main/frontend/js/util/auth-ui.js): `frontend/js/util/auth-ui.js`
- [Toast feedback](https://github.com/rajsanjel/ideaboard/blob/main/frontend/js/util/toast.js): `frontend/js/util/toast.js`

### API surface

- [HTTP server](https://github.com/rajsanjel/ideaboard/blob/main/backend/src/index.ts): `backend/src/index.ts`
- [API router](https://github.com/rajsanjel/ideaboard/blob/main/backend/src/routes/api.ts): `backend/src/routes/api.ts`
- [Auth routes](https://github.com/rajsanjel/ideaboard/blob/main/backend/src/routes/api/auth.ts): `backend/src/routes/api/auth.ts`
- [Suggestion routes](https://github.com/rajsanjel/ideaboard/blob/main/backend/src/routes/api/suggestions.ts): `backend/src/routes/api/suggestions.ts`
- [Admin routes](https://github.com/rajsanjel/ideaboard/blob/main/backend/src/routes/api/admin.ts): `backend/src/routes/api/admin.ts`
- [Request validation](https://github.com/rajsanjel/ideaboard/tree/main/backend/src/validators): `backend/src/validators`
- [Auth controller](https://github.com/rajsanjel/ideaboard/blob/main/backend/src/app/Http/Controllers/authController.ts): `backend/src/app/Http/Controllers/authController.ts`
- [Suggestion controller](https://github.com/rajsanjel/ideaboard/blob/main/backend/src/app/Http/Controllers/suggestionsController.ts): `backend/src/app/Http/Controllers/suggestionsController.ts`
- [Admin controller](https://github.com/rajsanjel/ideaboard/blob/main/backend/src/app/Http/Controllers/adminController.ts): `backend/src/app/Http/Controllers/adminController.ts`
- [Auth middleware](https://github.com/rajsanjel/ideaboard/blob/main/backend/src/app/Http/Middleware/authMiddleware.ts): `backend/src/app/Http/Middleware/authMiddleware.ts`
- [Admin middleware](https://github.com/rajsanjel/ideaboard/blob/main/backend/src/app/Http/Middleware/adminMiddleware.ts): `backend/src/app/Http/Middleware/adminMiddleware.ts`
- [Auth validation](https://github.com/rajsanjel/ideaboard/blob/main/backend/src/validators/authValidator.ts): `backend/src/validators/authValidator.ts`
- [Suggestion validation](https://github.com/rajsanjel/ideaboard/blob/main/backend/src/validators/suggestionValidator.ts): `backend/src/validators/suggestionValidator.ts`

### Domain services

- [Account service](https://github.com/rajsanjel/ideaboard/blob/main/backend/src/app/Services/auth.ts): `backend/src/app/Services/auth.ts`
- [Suggestion service](https://github.com/rajsanjel/ideaboard/blob/main/backend/src/app/Services/suggestions.ts): `backend/src/app/Services/suggestions.ts`
- [Administration service](https://github.com/rajsanjel/ideaboard/blob/main/backend/src/app/Services/admin.ts): `backend/src/app/Services/admin.ts`
- [Suggestion categories](https://github.com/rajsanjel/ideaboard/blob/main/shared/categories.json): `shared/categories.json`

### Identity and storage

- [JWT and cookies](https://github.com/rajsanjel/ideaboard/blob/main/backend/src/helper/token.ts): `backend/src/helper/token.ts`
- [PostgreSQL](https://github.com/rajsanjel/ideaboard/blob/main/backend/src/db.ts): `backend/src/db.ts`

### Other components

- **Students**
- **Staff and admins**

## Connections

- Students → Suggestion pages: browse (evidence: `README.md`)
- Students → Login and signup: sign in (evidence: `README.md`)
- Students → Submission modal: submit idea (evidence: `README.md`)
- Staff and admins → Admin console: manage board (evidence: `README.md`)
- Suggestion pages → API configuration: uses API config (evidence: `frontend/js/suggestions.js`)
- Suggestion detail → API configuration: uses API config (evidence: `frontend/js/suggestion.js`)
- Submission modal → API configuration: uses API config (evidence: `frontend/js/modal.js`)
- Login and signup → Browser auth state: uses auth state (evidence: `frontend/js/login.js`)
- Login and signup → Auth form helpers: uses form helpers (evidence: `frontend/js/login.js`)
- Browser auth state → API configuration: requests auth API (evidence: `frontend/js/global/auth.js`)
- Admin console → API configuration: uses API config (evidence: `frontend/admin/js/index.js`)
- User management → API configuration: uses API config (evidence: `frontend/admin/js/people.js`)
- API configuration → HTTP server: sends API requests (evidence: `README.md`)
- HTTP server → API router: mounts routes (evidence: `backend/src/index.ts`)
- API router → Auth routes: registers routes (evidence: `backend/src/routes/api.ts`)
- API router → Suggestion routes: registers routes (evidence: `backend/src/routes/api.ts`)
- API router → Admin routes: registers routes (evidence: `backend/src/routes/api.ts`)
- Auth routes → Auth controller: routes requests (evidence: `backend/src/routes/api/auth.ts`)
- Auth routes → Auth validation: validates input (evidence: `backend/src/routes/api/auth.ts`)
- Suggestion routes → Suggestion controller: routes requests (evidence: `backend/src/routes/api/suggestions.ts`)
- Suggestion routes → Suggestion validation: validates input (evidence: `backend/src/routes/api/suggestions.ts`)
- Suggestion routes → Auth middleware: protects routes (evidence: `backend/src/routes/api/suggestions.ts`)
- Admin routes → Admin controller: routes requests (evidence: `backend/src/routes/api/admin.ts`)
- Admin routes → Auth middleware: checks identity (evidence: `backend/src/routes/api/admin.ts`)
- Admin routes → Admin middleware: checks admin role (evidence: `backend/src/routes/api/admin.ts`)
- Auth controller → Account service: delegates account work (evidence: `backend/src/app/Http/Controllers/authController.ts`)
- Auth controller → JWT and cookies: sets auth cookie (evidence: `backend/src/app/Http/Controllers/authController.ts`)
- Suggestion controller → Suggestion service: delegates suggestions (evidence: `backend/src/app/Http/Controllers/suggestionsController.ts`)
- Admin controller → Administration service: delegates admin work (evidence: `backend/src/app/Http/Controllers/adminController.ts`)
- Account service → PostgreSQL: queries users (evidence: `backend/src/app/Services/auth.ts`)
- Account service → JWT and cookies: verifies session token (evidence: `backend/src/app/Services/auth.ts`)
- Suggestion service → PostgreSQL: queries suggestions (evidence: `backend/src/app/Services/suggestions.ts`)
- Administration service → PostgreSQL: queries admin data (evidence: `backend/src/app/Services/admin.ts`)
- Auth middleware → JWT and cookies: verifies JWT (evidence: `backend/src/app/Http/Middleware/authMiddleware.ts`)
- Auth middleware → PostgreSQL: checks user (evidence: `backend/src/app/Http/Middleware/authMiddleware.ts`)
- Admin middleware → PostgreSQL: checks role (evidence: `backend/src/app/Http/Middleware/adminMiddleware.ts`)
- Auth validation → Suggestion categories
- Suggestion validation → Suggestion categories: checks categories (evidence: `backend/src/validators/suggestionValidator.ts`)
