# anantsharma4569/zenvora_education_frontend architecture

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

- Interactive diagram: https://gitdiagram.com/anantsharma4569/zenvora_education_frontend
- Repository: https://github.com/anantsharma4569/zenvora_education_frontend

## Overview

Zenvora Education is a Vue frontend for school administration, with Frappe providing its backend. The user workflow begins at login, passes through session-aware navigation, and reaches role-sensitive dashboard and operational screens. Those screens cover students, staff, attendance, courses, exams, fees and timetables; settings configure academic and scheduling resources. A reusable resource-page layer supports list, form and bulk operations, while shared API and list utilities mediate data access. The README documents the API boundary and route guard; some individual page-to-API calls are not evidenced in the excerpts, so those links are marked unverified.

Main entry points: [`src/lib/api.ts`](https://github.com/anantsharma4569/zenvora_education_frontend/blob/main/src/lib/api.ts) (Typed API client), [`src/stores/session.ts`](https://github.com/anantsharma4569/zenvora_education_frontend/blob/main/src/stores/session.ts) (Session and role), [`src/pages/settings/CourseScheduleSection.vue`](https://github.com/anantsharma4569/zenvora_education_frontend/blob/main/src/pages/settings/CourseScheduleSection.vue) (Course scheduling), [`src/router.ts`](https://github.com/anantsharma4569/zenvora_education_frontend/blob/main/src/router.ts) (Routes and guard)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_shell["App shell"]
  node_app["Vue app<br/>[main.ts]"]
  node_router["Routes and guard<br/>[router.ts]"]
  node_login["Sign-in<br/>[LoginPage.vue]"]
  node_layout["App layout<br/>[AppLayout.vue]"]
  node_sidebar["Role navigation<br/>[Sidebar.vue]"]
end

subgraph group_shared["Shared data layer"]
  node_session["Session and role<br/>[session.ts]"]
  node_api["Typed API client<br/>[api.ts]"]
  node_list["List loader<br/>[useList.ts]"]
  node_resource["Resource definitions<br/>[resource.ts]"]
  node_resourcepage["Resource CRUD UI<br/>[ResourcePage.vue]"]
  node_datatable["Searchable data table<br/>[DataTable.vue]"]
  node_period["Period helpers<br/>[period.ts]"]
end

subgraph group_operations["School operations"]
  node_dashboard["Dashboard<br/>[DashboardPage.vue]"]
  node_students["Students<br/>[StudentsPage.vue]"]
  node_studentdetail["Student detail"]
  node_staff["Staff directory<br/>[StaffPage.vue]"]
  node_staffdetail["Staff detail"]
  node_attendance["Attendance<br/>[AttendancePage.vue]"]
  node_courses["Courses<br/>[CoursesPage.vue]"]
  node_exams["Exams<br/>[ExamsPage.vue]"]
  node_fees["Fees<br/>[FeesPage.vue]"]
  node_timetable["Timetable<br/>[TimeTablePage.vue]"]
end

subgraph group_configuration["Configuration"]
  node_settings["Settings sections"]
  node_schedule["Course scheduling"]
end

node_user(("School user"))
node_backend["Frappe backend"]

node_user -->|"opens"| node_app
node_app -->|"installs"| node_router
node_router -.->|"routes to"| node_login
node_router -.->|"guards routes"| node_session
node_router -.->|"routes to"| node_layout
node_layout -->|"reads state"| node_session
node_layout -->|"renders"| node_sidebar
node_sidebar -->|"reads role"| node_session
node_sidebar -->|"calls"| node_api
node_login -.->|"uses session"| node_session
node_session -->|"checks session"| node_api
node_api -->|"sends requests"| node_backend
node_dashboard -->|"fetches dashboard"| node_api
node_dashboard -->|"reads role"| node_session
node_students -.->|"fetches records"| node_api
node_studentdetail -.->|"fetches detail"| node_api
node_staff -->|"fetches records"| node_api
node_staff -->|"loads lists"| node_list
node_staff -->|"uses CRUD UI"| node_resourcepage
node_staffdetail -.->|"fetches detail"| node_api
node_attendance -.->|"fetches attendance"| node_api
node_courses -.->|"fetches courses"| node_api
node_exams -.->|"fetches exams"| node_api
node_fees -.->|"fetches fees"| node_api
node_timetable -->|"fetches schedules"| node_api
node_timetable -->|"reads role"| node_session
node_settings -.->|"manages settings"| node_api
node_schedule -->|"manages schedules"| node_api
node_schedule -->|"loads rows"| node_list
node_schedule -->|"uses date ranges"| node_period
node_schedule -.->|"uses CRUD UI"| node_resourcepage
node_resourcepage -->|"renders"| node_datatable
node_resourcepage -->|"uses definitions"| node_resource
node_datatable -.->|"no direct access"| node_backend

click node_app "https://github.com/anantsharma4569/zenvora_education_frontend/blob/main/src/main.ts"
click node_router "https://github.com/anantsharma4569/zenvora_education_frontend/blob/main/src/router.ts"
click node_login "https://github.com/anantsharma4569/zenvora_education_frontend/blob/main/src/pages/LoginPage.vue"
click node_layout "https://github.com/anantsharma4569/zenvora_education_frontend/blob/main/src/layouts/AppLayout.vue"
click node_sidebar "https://github.com/anantsharma4569/zenvora_education_frontend/blob/main/src/components/Sidebar.vue"
click node_session "https://github.com/anantsharma4569/zenvora_education_frontend/blob/main/src/stores/session.ts"
click node_api "https://github.com/anantsharma4569/zenvora_education_frontend/blob/main/src/lib/api.ts"
click node_list "https://github.com/anantsharma4569/zenvora_education_frontend/blob/main/src/lib/useList.ts"
click node_resource "https://github.com/anantsharma4569/zenvora_education_frontend/blob/main/src/lib/resource.ts"
click node_resourcepage "https://github.com/anantsharma4569/zenvora_education_frontend/blob/main/src/components/ResourcePage.vue"
click node_datatable "https://github.com/anantsharma4569/zenvora_education_frontend/blob/main/src/components/DataTable.vue"
click node_dashboard "https://github.com/anantsharma4569/zenvora_education_frontend/blob/main/src/pages/DashboardPage.vue"
click node_students "https://github.com/anantsharma4569/zenvora_education_frontend/blob/main/src/pages/StudentsPage.vue"
click node_studentdetail "https://github.com/anantsharma4569/zenvora_education_frontend/blob/main/src/pages/StudentDetailPage.vue"
click node_staff "https://github.com/anantsharma4569/zenvora_education_frontend/blob/main/src/pages/StaffPage.vue"
click node_staffdetail "https://github.com/anantsharma4569/zenvora_education_frontend/blob/main/src/pages/StaffDetailPage.vue"
click node_attendance "https://github.com/anantsharma4569/zenvora_education_frontend/blob/main/src/pages/AttendancePage.vue"
click node_courses "https://github.com/anantsharma4569/zenvora_education_frontend/blob/main/src/pages/CoursesPage.vue"
click node_exams "https://github.com/anantsharma4569/zenvora_education_frontend/blob/main/src/pages/ExamsPage.vue"
click node_fees "https://github.com/anantsharma4569/zenvora_education_frontend/blob/main/src/pages/FeesPage.vue"
click node_timetable "https://github.com/anantsharma4569/zenvora_education_frontend/blob/main/src/pages/TimeTablePage.vue"
click node_settings "https://github.com/anantsharma4569/zenvora_education_frontend/tree/main/src/pages/settings"
click node_schedule "https://github.com/anantsharma4569/zenvora_education_frontend/blob/main/src/pages/settings/CourseScheduleSection.vue"
click node_period "https://github.com/anantsharma4569/zenvora_education_frontend/blob/main/src/lib/period.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_app,node_router,node_login,node_layout,node_sidebar,node_user toneBlue
class node_session,node_api,node_list,node_resource,node_resourcepage,node_datatable,node_period toneAmber
class node_dashboard,node_students,node_studentdetail,node_staff,node_staffdetail,node_attendance,node_courses,node_exams,node_fees,node_timetable toneMint
class node_settings,node_schedule toneRose
class node_backend toneIndigo
```

## Components

### App shell

- [Vue app](https://github.com/anantsharma4569/zenvora_education_frontend/blob/main/src/main.ts): `src/main.ts`
- [Routes and guard](https://github.com/anantsharma4569/zenvora_education_frontend/blob/main/src/router.ts): `src/router.ts`
- [Sign-in](https://github.com/anantsharma4569/zenvora_education_frontend/blob/main/src/pages/LoginPage.vue): `src/pages/LoginPage.vue`
- [App layout](https://github.com/anantsharma4569/zenvora_education_frontend/blob/main/src/layouts/AppLayout.vue): `src/layouts/AppLayout.vue`
- [Role navigation](https://github.com/anantsharma4569/zenvora_education_frontend/blob/main/src/components/Sidebar.vue): `src/components/Sidebar.vue`

### Shared data layer

- [Session and role](https://github.com/anantsharma4569/zenvora_education_frontend/blob/main/src/stores/session.ts): `src/stores/session.ts`
- [Typed API client](https://github.com/anantsharma4569/zenvora_education_frontend/blob/main/src/lib/api.ts): `src/lib/api.ts`
- [List loader](https://github.com/anantsharma4569/zenvora_education_frontend/blob/main/src/lib/useList.ts): `src/lib/useList.ts`
- [Resource definitions](https://github.com/anantsharma4569/zenvora_education_frontend/blob/main/src/lib/resource.ts): `src/lib/resource.ts`
- [Resource CRUD UI](https://github.com/anantsharma4569/zenvora_education_frontend/blob/main/src/components/ResourcePage.vue): `src/components/ResourcePage.vue`
- [Searchable data table](https://github.com/anantsharma4569/zenvora_education_frontend/blob/main/src/components/DataTable.vue): `src/components/DataTable.vue`
- [Period helpers](https://github.com/anantsharma4569/zenvora_education_frontend/blob/main/src/lib/period.ts): `src/lib/period.ts`

### School operations

- [Dashboard](https://github.com/anantsharma4569/zenvora_education_frontend/blob/main/src/pages/DashboardPage.vue): `src/pages/DashboardPage.vue`
- [Students](https://github.com/anantsharma4569/zenvora_education_frontend/blob/main/src/pages/StudentsPage.vue): `src/pages/StudentsPage.vue`
- [Student detail](https://github.com/anantsharma4569/zenvora_education_frontend/blob/main/src/pages/StudentDetailPage.vue): `src/pages/StudentDetailPage.vue`
- [Staff directory](https://github.com/anantsharma4569/zenvora_education_frontend/blob/main/src/pages/StaffPage.vue): `src/pages/StaffPage.vue`
- [Staff detail](https://github.com/anantsharma4569/zenvora_education_frontend/blob/main/src/pages/StaffDetailPage.vue): `src/pages/StaffDetailPage.vue`
- [Attendance](https://github.com/anantsharma4569/zenvora_education_frontend/blob/main/src/pages/AttendancePage.vue): `src/pages/AttendancePage.vue`
- [Courses](https://github.com/anantsharma4569/zenvora_education_frontend/blob/main/src/pages/CoursesPage.vue): `src/pages/CoursesPage.vue`
- [Exams](https://github.com/anantsharma4569/zenvora_education_frontend/blob/main/src/pages/ExamsPage.vue): `src/pages/ExamsPage.vue`
- [Fees](https://github.com/anantsharma4569/zenvora_education_frontend/blob/main/src/pages/FeesPage.vue): `src/pages/FeesPage.vue`
- [Timetable](https://github.com/anantsharma4569/zenvora_education_frontend/blob/main/src/pages/TimeTablePage.vue): `src/pages/TimeTablePage.vue`

### Configuration

- [Settings sections](https://github.com/anantsharma4569/zenvora_education_frontend/tree/main/src/pages/settings): `src/pages/settings`
- [Course scheduling](https://github.com/anantsharma4569/zenvora_education_frontend/blob/main/src/pages/settings/CourseScheduleSection.vue): `src/pages/settings/CourseScheduleSection.vue`

### Other components

- **School user**
- **Frappe backend**

## Connections

- School user → Vue app: opens (evidence: `README.md`)
- Vue app → Routes and guard: installs (evidence: `src/main.ts`)
- Routes and guard → Sign-in: routes to
- Routes and guard → Session and role: guards routes
- Routes and guard → App layout: routes to
- App layout → Session and role: reads state (evidence: `src/layouts/AppLayout.vue`)
- App layout → Role navigation: renders (evidence: `src/layouts/AppLayout.vue`)
- Role navigation → Session and role: reads role (evidence: `src/components/Sidebar.vue`)
- Role navigation → Typed API client: calls (evidence: `src/components/Sidebar.vue`)
- Sign-in → Session and role: uses session
- Session and role → Typed API client: checks session (evidence: `src/stores/session.ts`)
- Typed API client → Frappe backend: sends requests (evidence: `README.md`)
- Dashboard → Typed API client: fetches dashboard (evidence: `src/pages/DashboardPage.vue`)
- Dashboard → Session and role: reads role (evidence: `src/pages/DashboardPage.vue`)
- Students → Typed API client: fetches records
- Student detail → Typed API client: fetches detail
- Staff directory → Typed API client: fetches records (evidence: `src/pages/StaffPage.vue`)
- Staff directory → List loader: loads lists (evidence: `src/pages/StaffPage.vue`)
- Staff directory → Resource CRUD UI: uses CRUD UI (evidence: `src/pages/StaffPage.vue`)
- Staff detail → Typed API client: fetches detail
- Attendance → Typed API client: fetches attendance
- Courses → Typed API client: fetches courses
- Exams → Typed API client: fetches exams
- Fees → Typed API client: fetches fees
- Timetable → Typed API client: fetches schedules (evidence: `src/pages/TimeTablePage.vue`)
- Timetable → Session and role: reads role (evidence: `src/pages/TimeTablePage.vue`)
- Settings sections → Typed API client: manages settings (evidence: `src/pages/settings/CourseScheduleSection.vue`)
- Course scheduling → Typed API client: manages schedules (evidence: `src/pages/settings/CourseScheduleSection.vue`)
- Course scheduling → List loader: loads rows (evidence: `src/pages/settings/CourseScheduleSection.vue`)
- Course scheduling → Period helpers: uses date ranges (evidence: `src/pages/settings/CourseScheduleSection.vue`)
- Course scheduling → Resource CRUD UI: uses CRUD UI (evidence: `src/pages/settings/CourseScheduleSection.vue`)
- Resource CRUD UI → Searchable data table: renders (evidence: `src/components/ResourcePage.vue`)
- Resource CRUD UI → Resource definitions: uses definitions (evidence: `src/components/ResourcePage.vue`)
- Searchable data table → Frappe backend: no direct access
