How rajsanjel/ideaboard works
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: api.js API configuration · db.ts PostgreSQL · api.ts API router · suggestions.ts Suggestion routes
Components 31
Web experience
- Suggestion pages
frontend/js/suggestions.js - Suggestion detail
frontend/js/suggestion.js - Submission modal
frontend/js/modal.js - Login and signup
frontend/js/login.js - Browser auth state
frontend/js/global/auth.js - Admin console
frontend/admin/js/index.js - User management
frontend/admin/js/people.js - API configuration
frontend/js/config/api.js - Auth form helpers
frontend/js/util/auth-ui.js - Toast feedback
frontend/js/util/toast.js
API surface
- HTTP server
backend/src/index.ts - API router
backend/src/routes/api.ts - Auth routes
backend/src/routes/api/auth.ts - Suggestion routes
backend/src/routes/api/suggestions.ts - Admin routes
backend/src/routes/api/admin.ts - Request validation
backend/src/validators - Auth controller
backend/src/app/Http/Controllers/authController.ts - Suggestion controller
backend/src/app/Http/Controllers/suggestionsController.ts - Admin controller
backend/src/app/Http/Controllers/adminController.ts - Auth middleware
backend/src/app/Http/Middleware/authMiddleware.ts - Admin middleware
backend/src/app/Http/Middleware/adminMiddleware.ts - Auth validation
backend/src/validators/authValidator.ts - Suggestion validation
backend/src/validators/suggestionValidator.ts
Domain services
- Account service
backend/src/app/Services/auth.ts - Suggestion service
backend/src/app/Services/suggestions.ts - Administration service
backend/src/app/Services/admin.ts - Suggestion categories
shared/categories.json
Identity and storage
- JWT and cookies
backend/src/helper/token.ts - PostgreSQL
backend/src/db.ts
Other components
- Students
- Staff and admins
Connections 38
- Students → Suggestion pages: browse
README.md - Students → Login and signup: sign in
README.md - Students → Submission modal: submit idea
README.md - Staff and admins → Admin console: manage board
README.md - Suggestion pages → API configuration: uses API config
frontend/js/suggestions.js - Suggestion detail → API configuration: uses API config
frontend/js/suggestion.js - Submission modal → API configuration: uses API config
frontend/js/modal.js - Login and signup → Browser auth state: uses auth state
frontend/js/login.js - Login and signup → Auth form helpers: uses form helpers
frontend/js/login.js - Browser auth state → API configuration: requests auth API
frontend/js/global/auth.js - Admin console → API configuration: uses API config
frontend/admin/js/index.js - User management → API configuration: uses API config
frontend/admin/js/people.js - API configuration → HTTP server: sends API requests
README.md - HTTP server → API router: mounts routes
backend/src/index.ts - API router → Auth routes: registers routes
backend/src/routes/api.ts - API router → Suggestion routes: registers routes
backend/src/routes/api.ts - API router → Admin routes: registers routes
backend/src/routes/api.ts - Auth routes → Auth controller: routes requests
backend/src/routes/api/auth.ts - Auth routes → Auth validation: validates input
backend/src/routes/api/auth.ts - Suggestion routes → Suggestion controller: routes requests
backend/src/routes/api/suggestions.ts - Suggestion routes → Suggestion validation: validates input
backend/src/routes/api/suggestions.ts - Suggestion routes → Auth middleware: protects routes
backend/src/routes/api/suggestions.ts - Admin routes → Admin controller: routes requests
backend/src/routes/api/admin.ts - Admin routes → Auth middleware: checks identity
backend/src/routes/api/admin.ts - Admin routes → Admin middleware: checks admin role
backend/src/routes/api/admin.ts - Auth controller → Account service: delegates account work
backend/src/app/Http/Controllers/authController.ts - Auth controller → JWT and cookies: sets auth cookie
backend/src/app/Http/Controllers/authController.ts - Suggestion controller → Suggestion service: delegates suggestions
backend/src/app/Http/Controllers/suggestionsController.ts - Admin controller → Administration service: delegates admin work
backend/src/app/Http/Controllers/adminController.ts - Account service → PostgreSQL: queries users
backend/src/app/Services/auth.ts - Account service → JWT and cookies: verifies session token
backend/src/app/Services/auth.ts - Suggestion service → PostgreSQL: queries suggestions
backend/src/app/Services/suggestions.ts - Administration service → PostgreSQL: queries admin data
backend/src/app/Services/admin.ts - Auth middleware → JWT and cookies: verifies JWT
backend/src/app/Http/Middleware/authMiddleware.ts - Auth middleware → PostgreSQL: checks user
backend/src/app/Http/Middleware/authMiddleware.ts - Admin middleware → PostgreSQL: checks role
backend/src/app/Http/Middleware/adminMiddleware.ts - Auth validation → Suggestion categories
- Suggestion validation → Suggestion categories: checks categories
backend/src/validators/suggestionValidator.ts