# tinsaetemesgen/student-portal architecture

> Architecture diagram of the GitHub repository tinsaetemesgen/student-portal, 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/tinsaetemesgen/student-portal
- Repository: https://github.com/tinsaetemesgen/student-portal

## Overview

This is a role-based school portal for administrators, registrars, finance staff, teachers, students, and parents. Users enter through routed web pages; the backend exposes APIs for school administration, academic records, finance, and other portal services. The graph preserves the principal management and learning domains, plus the API and data-model layers. Relationships are limited to routes and imports shown in excerpts or the source index; UI-to-API wiring and unsampled route behavior are not asserted.

Main entry points: [`frontend/src/App.tsx`](https://github.com/tinsaetemesgen/student-portal/blob/final/frontend/src/App.tsx) (Role-based routing), [`backend/routes/gradeRoutes.js`](https://github.com/tinsaetemesgen/student-portal/blob/final/backend/routes/gradeRoutes.js) (Grade services), [`backend/routes/financeRoutes.js`](https://github.com/tinsaetemesgen/student-portal/blob/final/backend/routes/financeRoutes.js) (Finance services), [`backend/server.js`](https://github.com/tinsaetemesgen/student-portal/blob/final/backend/server.js) (HTTP server)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web application"]
  node_app["Role-based routing<br/>[App.tsx]"]
  node_dashboard["Dashboard shell"]
end

subgraph group_admin["School administration"]
  node_registrar_ui["Registrar workflows"]
  node_admin_ui["Admin workflows<br/>[Announcements.tsx]"]
  node_class_api["Class management<br/>[classRoutes.js]"]
  node_registrar_api["Registrar management<br/>[registrarRoutes.js]"]
end

subgraph group_academic["Teaching and learning"]
  node_teacher_ui["Teacher workflows<br/>[Grades.tsx]"]
  node_student_ui["Student learning"]
  node_grades_api["Grade services<br/>[gradeRoutes.js]"]
end

subgraph group_finance["Finance"]
  node_finance_ui["Finance workflows<br/>[FinanceFees.tsx]"]
  node_admin_payments["Admin payments<br/>[Payments.tsx]"]
  node_finance_api["Finance services<br/>[financeRoutes.js]"]
  node_payment_api["Student payments<br/>[paymentsRoutes.js]"]
end

subgraph group_backend["API and data"]
  node_class_model[("Class records<br/>[Class.js]")]
  node_grade_model[("Grade records<br/>[Grade.js]")]
  node_user_model[("User records<br/>[User.js]")]
  node_fee_model[("Fee structures<br/>[FeeStructure.js]")]
  node_student_fee_model[("Student fees<br/>[StudentFee.js]")]
  node_payment_model[("Payment records<br/>[Payment.js]")]
  node_auth["Token authentication<br/>[auth.js]"]
  node_server["HTTP server<br/>[server.js]"]
end

node_users(("Portal users"))

node_users -->|"uses"| node_app
node_app -->|"routes to"| node_registrar_ui
node_app -->|"routes to"| node_admin_ui
node_app -->|"routes to"| node_teacher_ui
node_app -->|"routes to"| node_student_ui
node_app -->|"routes to"| node_admin_payments
node_registrar_ui -->|"uses"| node_dashboard
node_teacher_ui -->|"uses"| node_dashboard
node_student_ui -->|"uses"| node_dashboard
node_finance_ui -->|"uses"| node_dashboard
node_server -->|"mounts"| node_class_api
node_server -->|"mounts"| node_grades_api
node_server -->|"mounts"| node_finance_api
node_server -->|"mounts"| node_payment_api
node_class_api -->|"reads/writes"| node_class_model
node_class_api -->|"reads"| node_user_model
node_registrar_api -->|"reads/writes"| node_class_model
node_registrar_api -->|"reads/writes"| node_user_model
node_grades_api -->|"reads/writes"| node_grade_model
node_grades_api -->|"reads"| node_class_model
node_grades_api -->|"reads"| node_user_model
node_finance_api -->|"reads/writes"| node_fee_model
node_finance_api -->|"reads/writes"| node_student_fee_model
node_finance_api -->|"reads/writes"| node_payment_model
node_payment_api -->|"reads/writes"| node_student_fee_model
node_payment_api -->|"reads/writes"| node_payment_model
node_class_api -->|"authenticates"| node_auth
node_grades_api -->|"authenticates"| node_auth
node_finance_api -->|"authenticates"| node_auth
node_payment_api -->|"authenticates"| node_auth

click node_app "https://github.com/tinsaetemesgen/student-portal/blob/final/frontend/src/App.tsx"
click node_dashboard "https://github.com/tinsaetemesgen/student-portal/blob/final/frontend/src/layout/DashboardLayout.tsx"
click node_registrar_ui "https://github.com/tinsaetemesgen/student-portal/blob/final/frontend/src/pages/registrar/RegistrarStudents.tsx"
click node_admin_ui "https://github.com/tinsaetemesgen/student-portal/blob/final/frontend/src/pages/admin/Announcements.tsx"
click node_class_api "https://github.com/tinsaetemesgen/student-portal/blob/final/backend/routes/classRoutes.js"
click node_registrar_api "https://github.com/tinsaetemesgen/student-portal/blob/final/backend/routes/registrarRoutes.js"
click node_teacher_ui "https://github.com/tinsaetemesgen/student-portal/blob/final/frontend/src/pages/teacher/Grades.tsx"
click node_student_ui "https://github.com/tinsaetemesgen/student-portal/blob/final/frontend/src/pages/student/WorksheetReview.tsx"
click node_grades_api "https://github.com/tinsaetemesgen/student-portal/blob/final/backend/routes/gradeRoutes.js"
click node_class_model "https://github.com/tinsaetemesgen/student-portal/blob/final/backend/models/Class.js"
click node_grade_model "https://github.com/tinsaetemesgen/student-portal/blob/final/backend/models/Grade.js"
click node_user_model "https://github.com/tinsaetemesgen/student-portal/blob/final/backend/models/User.js"
click node_finance_ui "https://github.com/tinsaetemesgen/student-portal/blob/final/frontend/src/pages/finance/FinanceFees.tsx"
click node_admin_payments "https://github.com/tinsaetemesgen/student-portal/blob/final/frontend/src/pages/admin/Payments.tsx"
click node_finance_api "https://github.com/tinsaetemesgen/student-portal/blob/final/backend/routes/financeRoutes.js"
click node_payment_api "https://github.com/tinsaetemesgen/student-portal/blob/final/backend/routes/paymentsRoutes.js"
click node_fee_model "https://github.com/tinsaetemesgen/student-portal/blob/final/backend/models/FeeStructure.js"
click node_student_fee_model "https://github.com/tinsaetemesgen/student-portal/blob/final/backend/models/StudentFee.js"
click node_payment_model "https://github.com/tinsaetemesgen/student-portal/blob/final/backend/models/Payment.js"
click node_auth "https://github.com/tinsaetemesgen/student-portal/blob/final/backend/middleware/auth.js"
click node_server "https://github.com/tinsaetemesgen/student-portal/blob/final/backend/server.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_dashboard,node_users toneBlue
class node_registrar_ui,node_admin_ui,node_class_api,node_registrar_api toneAmber
class node_teacher_ui,node_student_ui,node_grades_api toneMint
class node_finance_ui,node_admin_payments,node_finance_api,node_payment_api toneRose
class node_class_model,node_grade_model,node_user_model,node_fee_model,node_student_fee_model,node_payment_model,node_auth,node_server toneIndigo
```

## Components

### Web application

- [Role-based routing](https://github.com/tinsaetemesgen/student-portal/blob/final/frontend/src/App.tsx): `frontend/src/App.tsx`
- [Dashboard shell](https://github.com/tinsaetemesgen/student-portal/blob/final/frontend/src/layout/DashboardLayout.tsx): `frontend/src/layout/DashboardLayout.tsx`

### School administration

- [Registrar workflows](https://github.com/tinsaetemesgen/student-portal/blob/final/frontend/src/pages/registrar/RegistrarStudents.tsx): `frontend/src/pages/registrar/RegistrarStudents.tsx`
- [Admin workflows](https://github.com/tinsaetemesgen/student-portal/blob/final/frontend/src/pages/admin/Announcements.tsx): `frontend/src/pages/admin/Announcements.tsx`
- [Class management](https://github.com/tinsaetemesgen/student-portal/blob/final/backend/routes/classRoutes.js): `backend/routes/classRoutes.js`
- [Registrar management](https://github.com/tinsaetemesgen/student-portal/blob/final/backend/routes/registrarRoutes.js): `backend/routes/registrarRoutes.js`

### Teaching and learning

- [Teacher workflows](https://github.com/tinsaetemesgen/student-portal/blob/final/frontend/src/pages/teacher/Grades.tsx): `frontend/src/pages/teacher/Grades.tsx`
- [Student learning](https://github.com/tinsaetemesgen/student-portal/blob/final/frontend/src/pages/student/WorksheetReview.tsx): `frontend/src/pages/student/WorksheetReview.tsx`
- [Grade services](https://github.com/tinsaetemesgen/student-portal/blob/final/backend/routes/gradeRoutes.js): `backend/routes/gradeRoutes.js`

### Finance

- [Finance workflows](https://github.com/tinsaetemesgen/student-portal/blob/final/frontend/src/pages/finance/FinanceFees.tsx): `frontend/src/pages/finance/FinanceFees.tsx`
- [Admin payments](https://github.com/tinsaetemesgen/student-portal/blob/final/frontend/src/pages/admin/Payments.tsx): `frontend/src/pages/admin/Payments.tsx`
- [Finance services](https://github.com/tinsaetemesgen/student-portal/blob/final/backend/routes/financeRoutes.js): `backend/routes/financeRoutes.js`
- [Student payments](https://github.com/tinsaetemesgen/student-portal/blob/final/backend/routes/paymentsRoutes.js): `backend/routes/paymentsRoutes.js`

### API and data

- [Class records](https://github.com/tinsaetemesgen/student-portal/blob/final/backend/models/Class.js): `backend/models/Class.js`
- [Grade records](https://github.com/tinsaetemesgen/student-portal/blob/final/backend/models/Grade.js): `backend/models/Grade.js`
- [User records](https://github.com/tinsaetemesgen/student-portal/blob/final/backend/models/User.js): `backend/models/User.js`
- [Fee structures](https://github.com/tinsaetemesgen/student-portal/blob/final/backend/models/FeeStructure.js): `backend/models/FeeStructure.js`
- [Student fees](https://github.com/tinsaetemesgen/student-portal/blob/final/backend/models/StudentFee.js): `backend/models/StudentFee.js`
- [Payment records](https://github.com/tinsaetemesgen/student-portal/blob/final/backend/models/Payment.js): `backend/models/Payment.js`
- [Token authentication](https://github.com/tinsaetemesgen/student-portal/blob/final/backend/middleware/auth.js): `backend/middleware/auth.js`
- [HTTP server](https://github.com/tinsaetemesgen/student-portal/blob/final/backend/server.js): `backend/server.js`

### Other components

- **Portal users**

## Connections

- Portal users → Role-based routing: uses
- Role-based routing → Registrar workflows: routes to (evidence: `frontend/src/App.tsx`)
- Role-based routing → Admin workflows: routes to (evidence: `frontend/src/App.tsx`)
- Role-based routing → Teacher workflows: routes to (evidence: `frontend/src/App.tsx`)
- Role-based routing → Student learning: routes to (evidence: `frontend/src/App.tsx`)
- Role-based routing → Admin payments: routes to (evidence: `frontend/src/App.tsx`)
- Registrar workflows → Dashboard shell: uses (evidence: `frontend/src/pages/registrar/RegistrarStudents.tsx`)
- Teacher workflows → Dashboard shell: uses (evidence: `frontend/src/pages/teacher/Grades.tsx`)
- Student learning → Dashboard shell: uses (evidence: `frontend/src/pages/student/WorksheetReview.tsx`)
- Finance workflows → Dashboard shell: uses (evidence: `frontend/src/pages/finance/FinanceFees.tsx`)
- HTTP server → Class management: mounts (evidence: `backend/server.js`)
- HTTP server → Grade services: mounts (evidence: `backend/server.js`)
- HTTP server → Finance services: mounts (evidence: `backend/server.js`)
- HTTP server → Student payments: mounts (evidence: `backend/server.js`)
- Class management → Class records: reads/writes (evidence: `backend/routes/classRoutes.js`)
- Class management → User records: reads (evidence: `backend/routes/classRoutes.js`)
- Registrar management → Class records: reads/writes (evidence: `backend/routes/registrarRoutes.js`)
- Registrar management → User records: reads/writes (evidence: `backend/routes/registrarRoutes.js`)
- Grade services → Grade records: reads/writes (evidence: `backend/routes/gradeRoutes.js`)
- Grade services → Class records: reads (evidence: `backend/routes/gradeRoutes.js`)
- Grade services → User records: reads (evidence: `backend/routes/gradeRoutes.js`)
- Finance services → Fee structures: reads/writes (evidence: `backend/routes/financeRoutes.js`)
- Finance services → Student fees: reads/writes (evidence: `backend/routes/financeRoutes.js`)
- Finance services → Payment records: reads/writes (evidence: `backend/routes/financeRoutes.js`)
- Student payments → Student fees: reads/writes (evidence: `backend/routes/paymentsRoutes.js`)
- Student payments → Payment records: reads/writes (evidence: `backend/routes/paymentsRoutes.js`)
- Class management → Token authentication: authenticates (evidence: `backend/routes/classRoutes.js`)
- Grade services → Token authentication: authenticates (evidence: `backend/routes/gradeRoutes.js`)
- Finance services → Token authentication: authenticates (evidence: `backend/routes/financeRoutes.js`)
- Student payments → Token authentication: authenticates (evidence: `backend/routes/paymentsRoutes.js`)
