# tkapat/feedback_management architecture

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

- Interactive diagram: https://gitdiagram.com/tkapat/feedback_management
- Repository: https://github.com/tkapat/feedback_management

## Overview

The product is a college feedback management system. Students register or log in, choose academic context, submit feedback, and track its status and replies; administrators review and respond, analyse feedback, and manage college data and settings. The graph combines documented API capabilities with sampled routes, controllers, and frontend references. Several frontend pages and backend modules were not sampled, so their connections are shown only where the README or source index supports them.

Main entry points: [`src/lib/api.ts`](https://github.com/tkapat/feedback_management/blob/main/src/lib/api.ts) (Axios API client), [`server/src/models`](https://github.com/tkapat/feedback_management/tree/main/server/src/models) (Mongo data models), [`server/src/routes.ts`](https://github.com/tkapat/feedback_management/blob/main/server/src/routes.ts) (REST API routing), [`server/src/modules/student/feedback.controller.ts`](https://github.com/tkapat/feedback_management/blob/main/server/src/modules/student/feedback.controller.ts) (Student feedback)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_student["Student experience"]
  node_student_portal["Student portal<br/>[page.tsx]"]
  node_feedback_submit["Submit feedback<br/>[page.tsx]"]
  node_feedback_history["Feedback history<br/>[page.tsx]"]
  node_feedback_detail["Feedback status and replies<br/>[page.tsx]"]
  node_notifications_ui["Notifications view<br/>[page.tsx]"]
  node_auth_ui["Login and registration<br/>[page.tsx]"]
  node_auth_context["Session context<br/>[AuthContext.tsx]"]
  node_api_client["Axios API client<br/>[api.ts]"]
end

subgraph group_admin["Administration"]
  node_admin_dashboard["Admin dashboard<br/>[page.tsx]"]
  node_admin_feedback_ui["Feedback management<br/>[page.tsx]"]
  node_admin_analytics["Analytics views<br/>[page.tsx]"]
  node_admin_master_ui["Departments, subjects and faculty<br/>[page.tsx]"]
  node_admin_students_ui["Student accounts<br/>[page.tsx]"]
  node_admin_settings_ui["Feedback settings<br/>[page.tsx]"]
end

subgraph group_backend["API services"]
  node_api_router["REST API routing<br/>[routes.ts]"]
  node_auth_service["Authentication<br/>[auth.controller.ts]"]
  node_lookup_service["Academic lookups"]
  node_student_feedback_service["Student feedback"]
  node_admin_feedback_service["Admin feedback"]
  node_stats_service["Feedback statistics"]
  node_admin_data_service["Admin data and settings"]
  node_notification_service["Notifications"]
end

subgraph group_data["Persistence and integrations"]
  node_models["Mongo data models"]
  node_mongodb[("MongoDB Atlas")]
  node_image_uploads["Image uploads"]
end

node_student_actor(("Student"))
node_admin_actor(("Administrator"))

node_student_actor -->|"signs in"| node_auth_ui
node_student_actor -->|"submits feedback"| node_feedback_submit
node_student_actor -->|"views history"| node_feedback_history
node_student_actor -->|"views notices"| node_notifications_ui
node_admin_actor -->|"reviews overview"| node_admin_dashboard
node_admin_actor -->|"manages feedback"| node_admin_feedback_ui
node_admin_actor -->|"analyses trends"| node_admin_analytics
node_admin_actor -->|"manages academic data"| node_admin_master_ui
node_admin_actor -->|"manages accounts"| node_admin_students_ui
node_admin_actor -->|"configures settings"| node_admin_settings_ui
node_auth_ui -->|"uses session"| node_auth_context
node_auth_context -->|"calls"| node_api_client
node_student_portal -->|"fetches data"| node_api_client
node_feedback_submit -.->|"submits data"| node_api_client
node_feedback_history -->|"fetches history"| node_api_client
node_feedback_detail -->|"fetches detail"| node_api_client
node_notifications_ui -->|"fetches notices"| node_api_client
node_admin_dashboard -->|"fetches statistics"| node_api_client
node_admin_feedback_ui -->|"fetches and updates"| node_api_client
node_admin_analytics -->|"fetches statistics"| node_api_client
node_admin_students_ui -->|"fetches and updates"| node_api_client
node_admin_settings_ui -->|"fetches and updates"| node_api_client
node_api_client -->|"sends API requests"| node_api_router
node_api_router -->|"routes auth"| node_auth_service
node_api_router -->|"routes lookups"| node_lookup_service
node_api_router -->|"routes feedback"| node_student_feedback_service
node_api_router -->|"routes admin"| node_admin_feedback_service
node_api_router -->|"routes notifications"| node_notification_service
node_auth_service -->|"reads and creates users"| node_models
node_lookup_service -->|"reads academic data"| node_models
node_student_feedback_service -->|"creates and reads feedback"| node_models
node_admin_feedback_service -->|"reads feedback"| node_models
node_stats_service -->|"aggregates feedback"| node_models
node_admin_data_service -.->|"manages records"| node_models
node_notification_service -->|"reads notifications"| node_models
node_models -->|"persists data"| node_mongodb
node_student_feedback_service -->|"handles image upload"| node_image_uploads
node_feedback_detail -.->|"displays admin replies"| node_admin_feedback_ui

click node_student_portal "https://github.com/tkapat/feedback_management/blob/main/app/student/dashboard/page.tsx"
click node_feedback_submit "https://github.com/tkapat/feedback_management/blob/main/app/student/feedback/new/page.tsx"
click node_feedback_history "https://github.com/tkapat/feedback_management/blob/main/app/student/feedback/history/page.tsx"
click node_feedback_detail "https://github.com/tkapat/feedback_management/blob/main/app/student/feedback/%5Bid%5D/page.tsx"
click node_notifications_ui "https://github.com/tkapat/feedback_management/blob/main/app/student/notifications/page.tsx"
click node_auth_ui "https://github.com/tkapat/feedback_management/blob/main/app/(auth)/login/page.tsx"
click node_auth_context "https://github.com/tkapat/feedback_management/blob/main/src/context/AuthContext.tsx"
click node_admin_dashboard "https://github.com/tkapat/feedback_management/blob/main/app/admin/dashboard/page.tsx"
click node_admin_feedback_ui "https://github.com/tkapat/feedback_management/blob/main/app/admin/feedback/page.tsx"
click node_admin_analytics "https://github.com/tkapat/feedback_management/blob/main/app/admin/analytics/page.tsx"
click node_admin_master_ui "https://github.com/tkapat/feedback_management/blob/main/app/admin/departments/page.tsx"
click node_admin_students_ui "https://github.com/tkapat/feedback_management/blob/main/app/admin/students/page.tsx"
click node_admin_settings_ui "https://github.com/tkapat/feedback_management/blob/main/app/admin/settings/page.tsx"
click node_api_client "https://github.com/tkapat/feedback_management/blob/main/src/lib/api.ts"
click node_api_router "https://github.com/tkapat/feedback_management/blob/main/server/src/routes.ts"
click node_auth_service "https://github.com/tkapat/feedback_management/blob/main/server/src/modules/auth/auth.controller.ts"
click node_lookup_service "https://github.com/tkapat/feedback_management/blob/main/server/src/modules/lookup/lookup.controller.ts"
click node_student_feedback_service "https://github.com/tkapat/feedback_management/blob/main/server/src/modules/student/feedback.controller.ts"
click node_admin_feedback_service "https://github.com/tkapat/feedback_management/blob/main/server/src/modules/admin/feedback.controller.ts"
click node_stats_service "https://github.com/tkapat/feedback_management/blob/main/server/src/modules/admin/stats.controller.ts"
click node_admin_data_service "https://github.com/tkapat/feedback_management/tree/main/server/src/modules/admin"
click node_notification_service "https://github.com/tkapat/feedback_management/blob/main/server/src/modules/notification/notification.controller.ts"
click node_models "https://github.com/tkapat/feedback_management/tree/main/server/src/models"
click node_image_uploads "https://github.com/tkapat/feedback_management/blob/main/server/src/modules/student/feedback.controller.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_student_portal,node_feedback_submit,node_feedback_history,node_feedback_detail,node_notifications_ui,node_auth_ui,node_auth_context,node_api_client toneBlue
class node_admin_dashboard,node_admin_feedback_ui,node_admin_analytics,node_admin_master_ui,node_admin_students_ui,node_admin_settings_ui toneAmber
class node_api_router,node_auth_service,node_lookup_service,node_student_feedback_service,node_admin_feedback_service,node_stats_service,node_admin_data_service,node_notification_service toneMint
class node_models,node_mongodb,node_image_uploads toneRose
class node_student_actor,node_admin_actor toneIndigo
```

## Components

### Student experience

- [Student portal](https://github.com/tkapat/feedback_management/blob/main/app/student/dashboard/page.tsx): `app/student/dashboard/page.tsx`
- [Submit feedback](https://github.com/tkapat/feedback_management/blob/main/app/student/feedback/new/page.tsx): `app/student/feedback/new/page.tsx`
- [Feedback history](https://github.com/tkapat/feedback_management/blob/main/app/student/feedback/history/page.tsx): `app/student/feedback/history/page.tsx`
- [Feedback status and replies](https://github.com/tkapat/feedback_management/blob/main/app/student/feedback/%5Bid%5D/page.tsx): `app/student/feedback/[id]/page.tsx`
- [Notifications view](https://github.com/tkapat/feedback_management/blob/main/app/student/notifications/page.tsx): `app/student/notifications/page.tsx`
- [Login and registration](https://github.com/tkapat/feedback_management/blob/main/app/(auth)/login/page.tsx): `app/(auth)/login/page.tsx`
- [Session context](https://github.com/tkapat/feedback_management/blob/main/src/context/AuthContext.tsx): `src/context/AuthContext.tsx`
- [Axios API client](https://github.com/tkapat/feedback_management/blob/main/src/lib/api.ts): `src/lib/api.ts`

### Administration

- [Admin dashboard](https://github.com/tkapat/feedback_management/blob/main/app/admin/dashboard/page.tsx): `app/admin/dashboard/page.tsx`
- [Feedback management](https://github.com/tkapat/feedback_management/blob/main/app/admin/feedback/page.tsx): `app/admin/feedback/page.tsx`
- [Analytics views](https://github.com/tkapat/feedback_management/blob/main/app/admin/analytics/page.tsx): `app/admin/analytics/page.tsx`
- [Departments, subjects and faculty](https://github.com/tkapat/feedback_management/blob/main/app/admin/departments/page.tsx): `app/admin/departments/page.tsx`
- [Student accounts](https://github.com/tkapat/feedback_management/blob/main/app/admin/students/page.tsx): `app/admin/students/page.tsx`
- [Feedback settings](https://github.com/tkapat/feedback_management/blob/main/app/admin/settings/page.tsx): `app/admin/settings/page.tsx`

### API services

- [REST API routing](https://github.com/tkapat/feedback_management/blob/main/server/src/routes.ts): `server/src/routes.ts`
- [Authentication](https://github.com/tkapat/feedback_management/blob/main/server/src/modules/auth/auth.controller.ts): `server/src/modules/auth/auth.controller.ts`
- [Academic lookups](https://github.com/tkapat/feedback_management/blob/main/server/src/modules/lookup/lookup.controller.ts): `server/src/modules/lookup/lookup.controller.ts`
- [Student feedback](https://github.com/tkapat/feedback_management/blob/main/server/src/modules/student/feedback.controller.ts): `server/src/modules/student/feedback.controller.ts`
- [Admin feedback](https://github.com/tkapat/feedback_management/blob/main/server/src/modules/admin/feedback.controller.ts): `server/src/modules/admin/feedback.controller.ts`
- [Feedback statistics](https://github.com/tkapat/feedback_management/blob/main/server/src/modules/admin/stats.controller.ts): `server/src/modules/admin/stats.controller.ts`
- [Admin data and settings](https://github.com/tkapat/feedback_management/tree/main/server/src/modules/admin): `server/src/modules/admin`
- [Notifications](https://github.com/tkapat/feedback_management/blob/main/server/src/modules/notification/notification.controller.ts): `server/src/modules/notification/notification.controller.ts`

### Persistence and integrations

- [Mongo data models](https://github.com/tkapat/feedback_management/tree/main/server/src/models): `server/src/models`
- **MongoDB Atlas**
- [Image uploads](https://github.com/tkapat/feedback_management/blob/main/server/src/modules/student/feedback.controller.ts): `server/src/modules/student/feedback.controller.ts`

### Other components

- **Student**
- **Administrator**

## Connections

- Student → Login and registration: signs in (evidence: `README.md`)
- Student → Submit feedback: submits feedback (evidence: `README.md`)
- Student → Feedback history: views history (evidence: `README.md`)
- Student → Notifications view: views notices (evidence: `README.md`)
- Administrator → Admin dashboard: reviews overview (evidence: `README.md`)
- Administrator → Feedback management: manages feedback (evidence: `README.md`)
- Administrator → Analytics views: analyses trends (evidence: `README.md`)
- Administrator → Departments, subjects and faculty: manages academic data (evidence: `README.md`)
- Administrator → Student accounts: manages accounts (evidence: `README.md`)
- Administrator → Feedback settings: configures settings (evidence: `README.md`)
- Login and registration → Session context: uses session (evidence: `src/context/AuthContext.tsx`)
- Session context → Axios API client: calls (evidence: `src/context/AuthContext.tsx`)
- Student portal → Axios API client: fetches data (evidence: `app/student/dashboard/page.tsx`)
- Submit feedback → Axios API client: submits data (evidence: `README.md`)
- Feedback history → Axios API client: fetches history (evidence: `app/student/feedback/history/page.tsx`)
- Feedback status and replies → Axios API client: fetches detail (evidence: `app/student/feedback/[id]/page.tsx`)
- Notifications view → Axios API client: fetches notices (evidence: `app/student/notifications/page.tsx`)
- Admin dashboard → Axios API client: fetches statistics (evidence: `app/admin/dashboard/page.tsx`)
- Feedback management → Axios API client: fetches and updates (evidence: `app/admin/feedback/page.tsx`)
- Analytics views → Axios API client: fetches statistics (evidence: `app/admin/analytics/page.tsx`)
- Student accounts → Axios API client: fetches and updates (evidence: `app/admin/students/page.tsx`)
- Feedback settings → Axios API client: fetches and updates (evidence: `app/admin/settings/page.tsx`)
- Axios API client → REST API routing: sends API requests (evidence: `README.md`)
- REST API routing → Authentication: routes auth (evidence: `server/src/routes.ts`)
- REST API routing → Academic lookups: routes lookups (evidence: `server/src/routes.ts`)
- REST API routing → Student feedback: routes feedback (evidence: `server/src/routes.ts`)
- REST API routing → Admin feedback: routes admin (evidence: `server/src/routes.ts`)
- REST API routing → Notifications: routes notifications (evidence: `server/src/routes.ts`)
- Authentication → Mongo data models: reads and creates users (evidence: `server/src/modules/auth/auth.controller.ts`)
- Academic lookups → Mongo data models: reads academic data (evidence: `server/src/modules/lookup/lookup.controller.ts`)
- Student feedback → Mongo data models: creates and reads feedback (evidence: `server/src/modules/student/feedback.controller.ts`)
- Admin feedback → Mongo data models: reads feedback (evidence: `server/src/modules/admin/feedback.controller.ts`)
- Feedback statistics → Mongo data models: aggregates feedback (evidence: `server/src/modules/admin/stats.controller.ts`)
- Admin data and settings → Mongo data models: manages records (evidence: `server/src/modules/admin/feedback.controller.ts`)
- Notifications → Mongo data models: reads notifications (evidence: `server/src/modules/notification/notification.controller.ts`)
- Mongo data models → MongoDB Atlas: persists data (evidence: `README.md`)
- Student feedback → Image uploads: handles image upload (evidence: `server/src/modules/student/feedback.controller.ts`)
- Feedback status and replies → Feedback management: displays admin replies (evidence: `README.md`)
