# rod-devv/school-dashboard architecture

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

- Interactive diagram: https://gitdiagram.com/rod-devv/school-dashboard
- Repository: https://github.com/rod-devv/school-dashboard

## Overview

This is a Next.js school-management dashboard for administrators, teachers, students, and parents. Users sign in, receive role-scoped access, and use dashboards or entity lists to review school records; list pages query Prisma-backed data and provide search, pagination, and available record actions. Separate UI branches cover schedules, announcements, and visual summaries. The README documents broader school entities and chart capabilities; unsampled implementations are represented at their existing directories. Edges reflect excerpted imports/calls or README statements; unsampled wiring is not inferred.

Main entry points: [`src/app/(dashboard)/list`](https://github.com/rod-devv/school-dashboard/tree/main/src/app/(dashboard)/list) (School record lists), [`src/app/(dashboard)`](https://github.com/rod-devv/school-dashboard/tree/main/src/app/(dashboard)) (Role dashboards), [`src/components/BigCalender.tsx`](https://github.com/rod-devv/school-dashboard/blob/main/src/components/BigCalender.tsx) (Calendar views), [`src/lib/settings.ts`](https://github.com/rod-devv/school-dashboard/blob/main/src/lib/settings.ts) (Access and paging settings)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_access["Access and roles"]
  node_signin["Sign-in page<br/>[page.tsx]"]
  node_middleware["Role access checks<br/>[middleware.ts]"]
  node_settings["Access and paging settings<br/>[settings.ts]"]
end

subgraph group_school["School operations"]
  node_dashboards["Role dashboards"]
  node_lists["School record lists"]
  node_details["Student and teacher details<br/>[page.tsx]"]
  node_forms["Record forms"]
end

subgraph group_ui["Shared interface"]
  node_formmodal["Form modal<br/>[FormModal.tsx]"]
  node_table["Record table<br/>[Table.tsx]"]
  node_search["Table search<br/>[TableSearch.tsx]"]
  node_pagination["Pagination<br/>[Pagination.tsx]"]
end

subgraph group_insights["Dashboards and schedules"]
  node_admin["Admin overview<br/>[page.tsx]"]
  node_charts["Dashboard charts"]
  node_calendar["Calendar views<br/>[BigCalender.tsx]"]
  node_announcements["Announcements display<br/>[Announcements.tsx]"]
end

subgraph group_storage["Data access"]
  node_fixtures["Sample school data<br/>[data.ts]"]
  node_prisma["Prisma client<br/>[prisma.ts]"]
  node_database[("PostgreSQL database")]
end

node_user(("School user"))
node_clerk["Clerk authentication"]

node_user -->|"signs in"| node_signin
node_signin -.->|"authenticates with"| node_clerk
node_user -->|"uses role views"| node_dashboards
node_middleware -->|"checks route roles"| node_settings
node_dashboards -.->|"includes"| node_admin
node_admin -->|"renders"| node_charts
node_dashboards -->|"renders"| node_calendar
node_dashboards -->|"renders"| node_announcements
node_details -->|"renders"| node_calendar
node_details -->|"renders"| node_announcements
node_calendar -->|"reads schedule data"| node_fixtures
node_lists -->|"queries records"| node_prisma
node_prisma -.->|"reads and writes"| node_database
node_lists -->|"renders rows"| node_table
node_lists -->|"renders search"| node_search
node_lists -->|"renders paging"| node_pagination
node_lists -->|"opens record actions"| node_formmodal
node_formmodal -->|"loads student and teacher forms"| node_forms
node_pagination -->|"uses page size"| node_settings
node_lists -->|"uses page size"| node_settings

click node_signin "https://github.com/rod-devv/school-dashboard/blob/main/src/app/%5B%5B...sign-in%5D%5D/page.tsx"
click node_middleware "https://github.com/rod-devv/school-dashboard/blob/main/src/middleware.ts"
click node_settings "https://github.com/rod-devv/school-dashboard/blob/main/src/lib/settings.ts"
click node_dashboards "https://github.com/rod-devv/school-dashboard/tree/main/src/app/(dashboard)"
click node_admin "https://github.com/rod-devv/school-dashboard/blob/main/src/app/(dashboard)/admin/page.tsx"
click node_lists "https://github.com/rod-devv/school-dashboard/tree/main/src/app/(dashboard)/list"
click node_details "https://github.com/rod-devv/school-dashboard/blob/main/src/app/(dashboard)/list/students/%5Bid%5D/page.tsx"
click node_forms "https://github.com/rod-devv/school-dashboard/tree/main/src/components/forms"
click node_formmodal "https://github.com/rod-devv/school-dashboard/blob/main/src/components/FormModal.tsx"
click node_table "https://github.com/rod-devv/school-dashboard/blob/main/src/components/Table.tsx"
click node_search "https://github.com/rod-devv/school-dashboard/blob/main/src/components/TableSearch.tsx"
click node_pagination "https://github.com/rod-devv/school-dashboard/blob/main/src/components/Pagination.tsx"
click node_charts "https://github.com/rod-devv/school-dashboard/blob/main/src/components/AttendanceChart.tsx"
click node_calendar "https://github.com/rod-devv/school-dashboard/blob/main/src/components/BigCalender.tsx"
click node_announcements "https://github.com/rod-devv/school-dashboard/blob/main/src/components/Announcements.tsx"
click node_fixtures "https://github.com/rod-devv/school-dashboard/blob/main/src/lib/data.ts"
click node_prisma "https://github.com/rod-devv/school-dashboard/blob/main/src/lib/prisma.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_signin,node_middleware,node_settings,node_user toneBlue
class node_dashboards,node_lists,node_details,node_forms toneAmber
class node_formmodal,node_table,node_search,node_pagination toneMint
class node_admin,node_charts,node_calendar,node_announcements toneRose
class node_fixtures,node_prisma,node_database,node_clerk toneIndigo
```

## Components

### Access and roles

- [Sign-in page](https://github.com/rod-devv/school-dashboard/blob/main/src/app/%5B%5B...sign-in%5D%5D/page.tsx): `src/app/[[...sign-in]]/page.tsx`
- [Role access checks](https://github.com/rod-devv/school-dashboard/blob/main/src/middleware.ts): `src/middleware.ts`
- [Access and paging settings](https://github.com/rod-devv/school-dashboard/blob/main/src/lib/settings.ts): `src/lib/settings.ts`

### School operations

- [Role dashboards](https://github.com/rod-devv/school-dashboard/tree/main/src/app/(dashboard)): `src/app/(dashboard)`
- [School record lists](https://github.com/rod-devv/school-dashboard/tree/main/src/app/(dashboard)/list): `src/app/(dashboard)/list`
- [Student and teacher details](https://github.com/rod-devv/school-dashboard/blob/main/src/app/(dashboard)/list/students/%5Bid%5D/page.tsx): `src/app/(dashboard)/list/students/[id]/page.tsx`
- [Record forms](https://github.com/rod-devv/school-dashboard/tree/main/src/components/forms): `src/components/forms`

### Shared interface

- [Form modal](https://github.com/rod-devv/school-dashboard/blob/main/src/components/FormModal.tsx): `src/components/FormModal.tsx`
- [Record table](https://github.com/rod-devv/school-dashboard/blob/main/src/components/Table.tsx): `src/components/Table.tsx`
- [Table search](https://github.com/rod-devv/school-dashboard/blob/main/src/components/TableSearch.tsx): `src/components/TableSearch.tsx`
- [Pagination](https://github.com/rod-devv/school-dashboard/blob/main/src/components/Pagination.tsx): `src/components/Pagination.tsx`

### Dashboards and schedules

- [Admin overview](https://github.com/rod-devv/school-dashboard/blob/main/src/app/(dashboard)/admin/page.tsx): `src/app/(dashboard)/admin/page.tsx`
- [Dashboard charts](https://github.com/rod-devv/school-dashboard/blob/main/src/components/AttendanceChart.tsx): `src/components/AttendanceChart.tsx`
- [Calendar views](https://github.com/rod-devv/school-dashboard/blob/main/src/components/BigCalender.tsx): `src/components/BigCalender.tsx`
- [Announcements display](https://github.com/rod-devv/school-dashboard/blob/main/src/components/Announcements.tsx): `src/components/Announcements.tsx`

### Data access

- [Sample school data](https://github.com/rod-devv/school-dashboard/blob/main/src/lib/data.ts): `src/lib/data.ts`
- [Prisma client](https://github.com/rod-devv/school-dashboard/blob/main/src/lib/prisma.ts): `src/lib/prisma.ts`
- **PostgreSQL database**

### Other components

- **School user**
- **Clerk authentication**

## Connections

- School user → Sign-in page: signs in
- Sign-in page → Clerk authentication: authenticates with
- School user → Role dashboards: uses role views
- Role access checks → Access and paging settings: checks route roles (evidence: `src/middleware.ts`)
- Role dashboards → Admin overview: includes
- Admin overview → Dashboard charts: renders (evidence: `src/app/(dashboard)/admin/page.tsx`)
- Role dashboards → Calendar views: renders (evidence: `src/app/(dashboard)/student/page.tsx`)
- Role dashboards → Announcements display: renders (evidence: `src/app/(dashboard)/parent/page.tsx`)
- Student and teacher details → Calendar views: renders (evidence: `src/app/(dashboard)/list/students/[id]/page.tsx`)
- Student and teacher details → Announcements display: renders (evidence: `src/app/(dashboard)/list/students/[id]/page.tsx`)
- Calendar views → Sample school data: reads schedule data (evidence: `src/components/BigCalender.tsx`)
- School record lists → Prisma client: queries records (evidence: `src/app/(dashboard)/list/assignments/page.tsx`)
- Prisma client → PostgreSQL database: reads and writes
- School record lists → Record table: renders rows (evidence: `src/app/(dashboard)/list/assignments/page.tsx`)
- School record lists → Table search: renders search (evidence: `src/app/(dashboard)/list/assignments/page.tsx`)
- School record lists → Pagination: renders paging (evidence: `src/app/(dashboard)/list/assignments/page.tsx`)
- School record lists → Form modal: opens record actions (evidence: `src/app/(dashboard)/list/assignments/page.tsx`)
- Form modal → Record forms: loads student and teacher forms (evidence: `src/components/FormModal.tsx`)
- Pagination → Access and paging settings: uses page size (evidence: `src/components/Pagination.tsx`)
- School record lists → Access and paging settings: uses page size (evidence: `src/app/(dashboard)/list/assignments/page.tsx`)
