# pranathir73/student-feedback architecture

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

- Interactive diagram: https://gitdiagram.com/pranathir73/student-feedback
- Repository: https://github.com/pranathir73/student-feedback

## Overview

Student Feedback System is a React/Express/MySQL platform for anonymous course feedback and role-specific reporting. Students log in, select semester subjects, and submit feedback; faculty review course trends and export reports, while admins manage users/courses and inspect global feedback. The frontend routes by role and maintains local authentication state; the backend mounts role-specific login and dashboard APIs backed by MySQL. Some reporting and submission endpoints are documented but their frontend calls or route implementations were not sampled, so those links are omitted where unverified.

Main entry points: [`student_feedback/src/App.js`](https://github.com/pranathir73/student-feedback/blob/main/student_feedback/src/App.js) (Routes and pages), [`student_feedback/backend/server/db.js`](https://github.com/pranathir73/student-feedback/blob/main/student_feedback/backend/server/db.js) (MySQL connection), [`student_feedback/backend/server/server.js`](https://github.com/pranathir73/student-feedback/blob/main/student_feedback/backend/server/server.js) (Express API router), [`student_feedback/backend/server/dashboard_routes`](https://github.com/pranathir73/student-feedback/tree/main/student_feedback/backend/server/dashboard_routes) (Subjects and feedback APIs)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Role-based frontend"]
  node_app["Routes and pages<br/>[App.js]"]
  node_auth["Authentication state<br/>[AuthContext.js]"]
  node_protected["Role access guard<br/>[ProtectedRoute.js]"]
  node_student_login["Student login<br/>[Login.js]"]
  node_faculty_login["Faculty login<br/>[Login.js]"]
  node_admin_login["Admin login<br/>[Login.js]"]
end

subgraph group_student["Student feedback"]
  node_student_dashboard["Subject selection and history<br/>[Dashboard.js]"]
  node_feedback_form["Anonymous feedback form<br/>[FeedbackForm.js]"]
  node_subject_table["Subject listing<br/>[SubjectTable.js]"]
end

subgraph group_reporting["Faculty and admin reporting"]
  node_faculty_dashboard["Faculty insights and export<br/>[Dashboard.js]"]
  node_faculty_charts["Feedback charts"]
  node_admin_dashboard["Admin management and reports<br/>[Dashboard.js]"]
end

subgraph group_backend["API services"]
  node_api_server["Express API router<br/>[server.js]"]
  node_login_routes["Role login APIs"]
  node_student_api["Subjects and feedback APIs"]
  node_faculty_api["Faculty reporting API<br/>[faculty.js]"]
  node_admin_api["Admin reporting API<br/>[adminDashboard.js]"]
end

subgraph group_data["Persistence"]
  node_db_client["MySQL connection<br/>[db.js]"]
  node_mysql[("MySQL database")]
end

node_user(("Student, faculty, admin"))

node_user -->|"opens"| node_app
node_app -->|"routes to"| node_student_login
node_app -->|"routes to"| node_faculty_login
node_app -->|"routes to"| node_admin_login
node_app -->|"guards pages"| node_protected
node_protected -->|"checks role"| node_auth
node_student_login -->|"sets session"| node_auth
node_faculty_login -->|"sets session"| node_auth
node_admin_login -->|"sets session"| node_auth
node_app -->|"routes to"| node_student_dashboard
node_app -->|"routes to"| node_faculty_dashboard
node_app -->|"routes to"| node_admin_dashboard
node_student_dashboard -->|"renders subjects"| node_subject_table
node_student_dashboard -.->|"requests subjects/history"| node_student_api
node_feedback_form -.->|"submits feedback"| node_student_api
node_faculty_dashboard -->|"requests course data"| node_faculty_api
node_faculty_dashboard -->|"renders charts"| node_faculty_charts
node_admin_dashboard -.->|"requests reports"| node_admin_api
node_api_server -->|"mounts routes"| node_login_routes
node_api_server -->|"mounts routes"| node_student_api
node_api_server -->|"mounts routes"| node_faculty_api
node_api_server -->|"mounts routes"| node_admin_api
node_login_routes -->|"queries"| node_db_client
node_student_api -->|"queries"| node_db_client
node_faculty_api -.->|"queries"| node_db_client
node_admin_api -->|"queries"| node_db_client
node_db_client -->|"connects to"| node_mysql

click node_app "https://github.com/pranathir73/student-feedback/blob/main/student_feedback/src/App.js"
click node_auth "https://github.com/pranathir73/student-feedback/blob/main/student_feedback/src/context/AuthContext.js"
click node_protected "https://github.com/pranathir73/student-feedback/blob/main/student_feedback/src/routes/ProtectedRoute.js"
click node_student_login "https://github.com/pranathir73/student-feedback/blob/main/student_feedback/src/Pages/Student/Login.js"
click node_faculty_login "https://github.com/pranathir73/student-feedback/blob/main/student_feedback/src/Pages/Faculty/Login.js"
click node_admin_login "https://github.com/pranathir73/student-feedback/blob/main/student_feedback/src/Pages/Admin/Login.js"
click node_student_dashboard "https://github.com/pranathir73/student-feedback/blob/main/student_feedback/src/Pages/Student/Dashboard.js"
click node_feedback_form "https://github.com/pranathir73/student-feedback/blob/main/student_feedback/src/Pages/Student/FeedbackForm.js"
click node_subject_table "https://github.com/pranathir73/student-feedback/blob/main/student_feedback/src/components/student/SubjectTable.js"
click node_faculty_dashboard "https://github.com/pranathir73/student-feedback/blob/main/student_feedback/src/Pages/Faculty/Dashboard.js"
click node_faculty_charts "https://github.com/pranathir73/student-feedback/blob/main/student_feedback/src/components/faculty/FeedbackTrendsChart.js"
click node_admin_dashboard "https://github.com/pranathir73/student-feedback/blob/main/student_feedback/src/Pages/Admin/Dashboard.js"
click node_api_server "https://github.com/pranathir73/student-feedback/blob/main/student_feedback/backend/server/server.js"
click node_login_routes "https://github.com/pranathir73/student-feedback/tree/main/student_feedback/backend/server/login_routes"
click node_student_api "https://github.com/pranathir73/student-feedback/tree/main/student_feedback/backend/server/dashboard_routes"
click node_faculty_api "https://github.com/pranathir73/student-feedback/blob/main/student_feedback/backend/server/dashboard_routes/faculty.js"
click node_admin_api "https://github.com/pranathir73/student-feedback/blob/main/student_feedback/backend/server/dashboard_routes/adminDashboard.js"
click node_db_client "https://github.com/pranathir73/student-feedback/blob/main/student_feedback/backend/server/db.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_app,node_auth,node_protected,node_student_login,node_faculty_login,node_admin_login toneBlue
class node_student_dashboard,node_feedback_form,node_subject_table toneAmber
class node_faculty_dashboard,node_faculty_charts,node_admin_dashboard toneMint
class node_api_server,node_login_routes,node_student_api,node_faculty_api,node_admin_api toneRose
class node_db_client,node_mysql,node_user toneIndigo
```

## Components

### Role-based frontend

- [Routes and pages](https://github.com/pranathir73/student-feedback/blob/main/student_feedback/src/App.js): `student_feedback/src/App.js`
- [Authentication state](https://github.com/pranathir73/student-feedback/blob/main/student_feedback/src/context/AuthContext.js): `student_feedback/src/context/AuthContext.js`
- [Role access guard](https://github.com/pranathir73/student-feedback/blob/main/student_feedback/src/routes/ProtectedRoute.js): `student_feedback/src/routes/ProtectedRoute.js`
- [Student login](https://github.com/pranathir73/student-feedback/blob/main/student_feedback/src/Pages/Student/Login.js): `student_feedback/src/Pages/Student/Login.js`
- [Faculty login](https://github.com/pranathir73/student-feedback/blob/main/student_feedback/src/Pages/Faculty/Login.js): `student_feedback/src/Pages/Faculty/Login.js`
- [Admin login](https://github.com/pranathir73/student-feedback/blob/main/student_feedback/src/Pages/Admin/Login.js): `student_feedback/src/Pages/Admin/Login.js`

### Student feedback

- [Subject selection and history](https://github.com/pranathir73/student-feedback/blob/main/student_feedback/src/Pages/Student/Dashboard.js): `student_feedback/src/Pages/Student/Dashboard.js`
- [Anonymous feedback form](https://github.com/pranathir73/student-feedback/blob/main/student_feedback/src/Pages/Student/FeedbackForm.js): `student_feedback/src/Pages/Student/FeedbackForm.js`
- [Subject listing](https://github.com/pranathir73/student-feedback/blob/main/student_feedback/src/components/student/SubjectTable.js): `student_feedback/src/components/student/SubjectTable.js`

### Faculty and admin reporting

- [Faculty insights and export](https://github.com/pranathir73/student-feedback/blob/main/student_feedback/src/Pages/Faculty/Dashboard.js): `student_feedback/src/Pages/Faculty/Dashboard.js`
- [Feedback charts](https://github.com/pranathir73/student-feedback/blob/main/student_feedback/src/components/faculty/FeedbackTrendsChart.js): `student_feedback/src/components/faculty/FeedbackTrendsChart.js`
- [Admin management and reports](https://github.com/pranathir73/student-feedback/blob/main/student_feedback/src/Pages/Admin/Dashboard.js): `student_feedback/src/Pages/Admin/Dashboard.js`

### API services

- [Express API router](https://github.com/pranathir73/student-feedback/blob/main/student_feedback/backend/server/server.js): `student_feedback/backend/server/server.js`
- [Role login APIs](https://github.com/pranathir73/student-feedback/tree/main/student_feedback/backend/server/login_routes): `student_feedback/backend/server/login_routes`
- [Subjects and feedback APIs](https://github.com/pranathir73/student-feedback/tree/main/student_feedback/backend/server/dashboard_routes): `student_feedback/backend/server/dashboard_routes`
- [Faculty reporting API](https://github.com/pranathir73/student-feedback/blob/main/student_feedback/backend/server/dashboard_routes/faculty.js): `student_feedback/backend/server/dashboard_routes/faculty.js`
- [Admin reporting API](https://github.com/pranathir73/student-feedback/blob/main/student_feedback/backend/server/dashboard_routes/adminDashboard.js): `student_feedback/backend/server/dashboard_routes/adminDashboard.js`

### Persistence

- [MySQL connection](https://github.com/pranathir73/student-feedback/blob/main/student_feedback/backend/server/db.js): `student_feedback/backend/server/db.js`
- **MySQL database**

### Other components

- **Student, faculty, admin**

## Connections

- Student, faculty, admin → Routes and pages: opens (evidence: `student_feedback/src/App.js`)
- Routes and pages → Student login: routes to (evidence: `student_feedback/src/App.js`)
- Routes and pages → Faculty login: routes to (evidence: `student_feedback/src/App.js`)
- Routes and pages → Admin login: routes to (evidence: `student_feedback/src/App.js`)
- Routes and pages → Role access guard: guards pages (evidence: `student_feedback/src/App.js`)
- Role access guard → Authentication state: checks role (evidence: `student_feedback/src/routes/ProtectedRoute.js`)
- Student login → Authentication state: sets session
- Faculty login → Authentication state: sets session (evidence: `student_feedback/src/Pages/Faculty/Login.js`)
- Admin login → Authentication state: sets session (evidence: `student_feedback/src/Pages/Admin/Login.js`)
- Routes and pages → Subject selection and history: routes to (evidence: `student_feedback/src/App.js`)
- Routes and pages → Faculty insights and export: routes to (evidence: `student_feedback/src/App.js`)
- Routes and pages → Admin management and reports: routes to (evidence: `student_feedback/src/App.js`)
- Subject selection and history → Subject listing: renders subjects (evidence: `student_feedback/src/Pages/Student/Dashboard.js`)
- Subject selection and history → Subjects and feedback APIs: requests subjects/history (evidence: `student_feedback/src/Pages/Student/Dashboard.js`)
- Anonymous feedback form → Subjects and feedback APIs: submits feedback
- Faculty insights and export → Faculty reporting API: requests course data
- Faculty insights and export → Feedback charts: renders charts (evidence: `student_feedback/src/Pages/Faculty/Dashboard.js`)
- Admin management and reports → Admin reporting API: requests reports
- Express API router → Role login APIs: mounts routes (evidence: `student_feedback/backend/server/server.js`)
- Express API router → Subjects and feedback APIs: mounts routes (evidence: `student_feedback/backend/server/server.js`)
- Express API router → Faculty reporting API: mounts routes (evidence: `student_feedback/backend/server/server.js`)
- Express API router → Admin reporting API: mounts routes (evidence: `student_feedback/backend/server/server.js`)
- Role login APIs → MySQL connection: queries (evidence: `student_feedback/backend/server/login_routes/student.js`)
- Subjects and feedback APIs → MySQL connection: queries (evidence: `student_feedback/backend/server/dashboard_routes/feedbackSubmit.js`)
- Faculty reporting API → MySQL connection: queries
- Admin reporting API → MySQL connection: queries (evidence: `student_feedback/backend/server/dashboard_routes/adminDashboard.js`)
- MySQL connection → MySQL database: connects to (evidence: `student_feedback/backend/server/db.js`)
