# rith-1437/educore architecture

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

- Interactive diagram: https://gitdiagram.com/rith-1437/educore
- Repository: https://github.com/rith-1437/educore

## Overview

EduCore is a university administration platform for Cambodian universities, with Laravel backend services and a Vue interface. A representative workflow is student or staff enrollment: a web/API request reaches an enrollment controller, the service checks academic and capacity rules, and the resulting registration is persisted. The README also documents broad capabilities spanning academic setup, coursework, grading, student services, documents, billing, communications, and internships. The enrollment links are supported by excerpts and the source index; other feature links reflect README-level documentation, not inspection of their implementations.

Main entry points: [`backend/routes/web.php`](https://github.com/rith-1437/educore/blob/main/backend/routes/web.php) (Web routes), [`backend/routes/api.php`](https://github.com/rith-1437/educore/blob/main/backend/routes/api.php) (API routes), [`backend/app/Services/EnrollmentService.php`](https://github.com/rith-1437/educore/blob/main/backend/app/Services/EnrollmentService.php) (Enrollment rules), [`backend/app/Http/Controllers/EnrollmentController.php`](https://github.com/rith-1437/educore/blob/main/backend/app/Http/Controllers/EnrollmentController.php) (Enrollment endpoints)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Access and identity"]
  node_web["Web routes<br/>[web.php]"]
  node_api["API routes<br/>[api.php]"]
  node_login["Sign-in"]
  node_identity["Role access<br/>[Role.php]"]
  node_ui["Vue interface"]
end

subgraph group_academics["Academic operations"]
  node_structure["Academic structure"]
  node_offerings["Offerings and sections"]
  node_enrollment["Enrollment endpoints"]
  node_enrollment_rules["Enrollment rules"]
  node_registration[("Student registration<br/>[Enrollment.php]")]
  node_timetable["Scheduling"]
end

subgraph group_learning["Learning and outcomes"]
  node_attendance["Attendance"]
  node_coursework["Assignments and exams"]
  node_grades["Grades and GPA<br/>[GradingService.php]"]
  node_dashboard["Student dashboard"]
end

subgraph group_services["Student services"]
  node_documents["Documents"]
  node_billing["Invoices and payments<br/>[InvoiceService.php]"]
  node_internships["Internships"]
  node_announcements["Announcements"]
  node_notifications["Notifications"]
end

subgraph group_platform["Application foundation"]
  node_database[("PostgreSQL")]
  node_openapi["API reference<br/>[OpenApi.php]"]
end

node_users(("University users"))

node_users -->|"use portal"| node_web
node_users -->|"use API"| node_api
node_web -->|"routes sign-in"| node_login
node_login -->|"checks role"| node_identity
node_web -->|"serves pages"| node_ui
node_web -.->|"supports administration"| node_structure
node_web -->|"manages offerings"| node_offerings
node_web -->|"manages enrollment"| node_enrollment
node_api -->|"exposes enrollment"| node_enrollment
node_enrollment -->|"calls rules"| node_enrollment_rules
node_enrollment_rules -->|"writes registration"| node_registration
node_enrollment_rules -->|"checks availability"| node_timetable
node_registration -.->|"persists records"| node_database
node_web -->|"records attendance"| node_attendance
node_web -->|"manages coursework"| node_coursework
node_web -->|"reviews grades"| node_grades
node_web -->|"shows progress"| node_dashboard
node_web -->|"handles requests"| node_documents
node_web -->|"manages billing"| node_billing
node_web -->|"manages internships"| node_internships
node_web -->|"publishes updates"| node_announcements
node_announcements -.->|"notifies audiences"| node_notifications
node_api -->|"documents endpoints"| node_openapi

click node_web "https://github.com/rith-1437/educore/blob/main/backend/routes/web.php"
click node_api "https://github.com/rith-1437/educore/blob/main/backend/routes/api.php"
click node_login "https://github.com/rith-1437/educore/blob/main/backend/app/Http/Controllers/Auth/AuthenticatedSessionController.php"
click node_identity "https://github.com/rith-1437/educore/blob/main/backend/app/Enums/Role.php"
click node_ui "https://github.com/rith-1437/educore/tree/main/frontend/src/pages"
click node_structure "https://github.com/rith-1437/educore/tree/main/backend/app/Services"
click node_offerings "https://github.com/rith-1437/educore/blob/main/backend/app/Http/Controllers/CourseOfferingController.php"
click node_enrollment "https://github.com/rith-1437/educore/blob/main/backend/app/Http/Controllers/EnrollmentController.php"
click node_enrollment_rules "https://github.com/rith-1437/educore/blob/main/backend/app/Services/EnrollmentService.php"
click node_registration "https://github.com/rith-1437/educore/blob/main/backend/app/Models/Enrollment.php"
click node_timetable "https://github.com/rith-1437/educore/blob/main/backend/app/Services/TimetableService.php"
click node_attendance "https://github.com/rith-1437/educore/blob/main/backend/app/Services/AttendanceService.php"
click node_coursework "https://github.com/rith-1437/educore/tree/main/backend/app/Services"
click node_grades "https://github.com/rith-1437/educore/blob/main/backend/app/Services/GradingService.php"
click node_dashboard "https://github.com/rith-1437/educore/blob/main/backend/app/Services/StudentDashboardService.php"
click node_documents "https://github.com/rith-1437/educore/blob/main/backend/app/Services/DocumentService.php"
click node_billing "https://github.com/rith-1437/educore/blob/main/backend/app/Services/InvoiceService.php"
click node_internships "https://github.com/rith-1437/educore/blob/main/backend/app/Services/InternshipService.php"
click node_announcements "https://github.com/rith-1437/educore/blob/main/backend/app/Services/AnnouncementService.php"
click node_notifications "https://github.com/rith-1437/educore/tree/main/backend/app/Notifications"
click node_openapi "https://github.com/rith-1437/educore/blob/main/backend/app/OpenApi/OpenApi.php"

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_web,node_api,node_login,node_identity,node_ui,node_users toneBlue
class node_structure,node_offerings,node_enrollment,node_enrollment_rules,node_registration,node_timetable toneAmber
class node_attendance,node_coursework,node_grades,node_dashboard toneMint
class node_documents,node_billing,node_internships,node_announcements,node_notifications toneRose
class node_database,node_openapi toneIndigo
```

## Components

### Access and identity

- [Web routes](https://github.com/rith-1437/educore/blob/main/backend/routes/web.php): `backend/routes/web.php`
- [API routes](https://github.com/rith-1437/educore/blob/main/backend/routes/api.php): `backend/routes/api.php`
- [Sign-in](https://github.com/rith-1437/educore/blob/main/backend/app/Http/Controllers/Auth/AuthenticatedSessionController.php): `backend/app/Http/Controllers/Auth/AuthenticatedSessionController.php`
- [Role access](https://github.com/rith-1437/educore/blob/main/backend/app/Enums/Role.php): `backend/app/Enums/Role.php`
- [Vue interface](https://github.com/rith-1437/educore/tree/main/frontend/src/pages): `frontend/src/pages`

### Academic operations

- [Academic structure](https://github.com/rith-1437/educore/tree/main/backend/app/Services): `backend/app/Services`
- [Offerings and sections](https://github.com/rith-1437/educore/blob/main/backend/app/Http/Controllers/CourseOfferingController.php): `backend/app/Http/Controllers/CourseOfferingController.php`
- [Enrollment endpoints](https://github.com/rith-1437/educore/blob/main/backend/app/Http/Controllers/EnrollmentController.php): `backend/app/Http/Controllers/EnrollmentController.php`
- [Enrollment rules](https://github.com/rith-1437/educore/blob/main/backend/app/Services/EnrollmentService.php): `backend/app/Services/EnrollmentService.php`
- [Student registration](https://github.com/rith-1437/educore/blob/main/backend/app/Models/Enrollment.php): `backend/app/Models/Enrollment.php`
- [Scheduling](https://github.com/rith-1437/educore/blob/main/backend/app/Services/TimetableService.php): `backend/app/Services/TimetableService.php`

### Learning and outcomes

- [Attendance](https://github.com/rith-1437/educore/blob/main/backend/app/Services/AttendanceService.php): `backend/app/Services/AttendanceService.php`
- [Assignments and exams](https://github.com/rith-1437/educore/tree/main/backend/app/Services): `backend/app/Services`
- [Grades and GPA](https://github.com/rith-1437/educore/blob/main/backend/app/Services/GradingService.php): `backend/app/Services/GradingService.php`
- [Student dashboard](https://github.com/rith-1437/educore/blob/main/backend/app/Services/StudentDashboardService.php): `backend/app/Services/StudentDashboardService.php`

### Student services

- [Documents](https://github.com/rith-1437/educore/blob/main/backend/app/Services/DocumentService.php): `backend/app/Services/DocumentService.php`
- [Invoices and payments](https://github.com/rith-1437/educore/blob/main/backend/app/Services/InvoiceService.php): `backend/app/Services/InvoiceService.php`
- [Internships](https://github.com/rith-1437/educore/blob/main/backend/app/Services/InternshipService.php): `backend/app/Services/InternshipService.php`
- [Announcements](https://github.com/rith-1437/educore/blob/main/backend/app/Services/AnnouncementService.php): `backend/app/Services/AnnouncementService.php`
- [Notifications](https://github.com/rith-1437/educore/tree/main/backend/app/Notifications): `backend/app/Notifications`

### Application foundation

- **PostgreSQL**
- [API reference](https://github.com/rith-1437/educore/blob/main/backend/app/OpenApi/OpenApi.php): `backend/app/OpenApi/OpenApi.php`

### Other components

- **University users**

## Connections

- University users → Web routes: use portal
- University users → API routes: use API
- Web routes → Sign-in: routes sign-in (evidence: `backend/routes/web.php`)
- Sign-in → Role access: checks role (evidence: `backend/app/Http/Controllers/Auth/AuthenticatedSessionController.php`)
- Web routes → Vue interface: serves pages
- Web routes → Academic structure: supports administration
- Web routes → Offerings and sections: manages offerings (evidence: `backend/routes/web.php`)
- Web routes → Enrollment endpoints: manages enrollment (evidence: `backend/routes/web.php`)
- API routes → Enrollment endpoints: exposes enrollment
- Enrollment endpoints → Enrollment rules: calls rules (evidence: `backend/app/Http/Controllers/EnrollmentController.php`)
- Enrollment rules → Student registration: writes registration (evidence: `backend/app/Services/EnrollmentService.php`)
- Enrollment rules → Scheduling: checks availability (evidence: `backend/app/Services/EnrollmentService.php`)
- Student registration → PostgreSQL: persists records
- Web routes → Attendance: records attendance
- Web routes → Assignments and exams: manages coursework
- Web routes → Grades and GPA: reviews grades
- Web routes → Student dashboard: shows progress
- Web routes → Documents: handles requests
- Web routes → Invoices and payments: manages billing
- Web routes → Internships: manages internships
- Web routes → Announcements: publishes updates
- Announcements → Notifications: notifies audiences
- API routes → API reference: documents endpoints (evidence: `backend/app/OpenApi/OpenApi.php`)
