# ayman-al-refaee/drasty-backend architecture

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

- Interactive diagram: https://gitdiagram.com/ayman-al-refaee/drasty-backend
- Repository: https://github.com/ayman-al-refaee/drasty-backend

## Overview

This repository is an academic-portal API: clients request authentication or manage academic structure, course offerings, teaching assignments, staff, and course content; endpoints return JSON results. The main flow is API routing to a controller, then Eloquent-backed domain models. The route and controller excerpts establish several dispatch and model-use links; other model relationships are included only where the source index or excerpts name them. The README describes Laravel generally, not additional product capabilities, so framework features such as queues and broadcasting are not mapped as application subsystems.

Main entry points: [`routes/api.php`](https://github.com/ayman-al-refaee/drasty-backend/blob/main/routes/api.php) (API routes), [`app/Models/User.php`](https://github.com/ayman-al-refaee/drasty-backend/blob/main/app/Models/User.php) (User accounts), [`app/Models/Content.php`](https://github.com/ayman-al-refaee/drasty-backend/blob/main/app/Models/Content.php) (Content records), [`app/Factories/UserFactory.php`](https://github.com/ayman-al-refaee/drasty-backend/blob/main/app/Factories/UserFactory.php) (User factory)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["API entry"]
  node_api_routes["API routes<br/>[api.php]"]
end

subgraph group_identity["Identity and staff"]
  node_auth_controller["Authentication<br/>[AuthController.php]"]
  node_user_controller["User management<br/>[UserController.php]"]
  node_user_factory["User factory<br/>[UserFactory.php]"]
  node_user_model["User accounts<br/>[User.php]"]
  node_role_model["Roles<br/>[Role.php]"]
end

subgraph group_academics["Academic structure"]
  node_department_controller["Departments"]
  node_department_model["Department records<br/>[Department.php]"]
  node_level_controller["Study levels"]
  node_level_model["Level records<br/>[Level.php]"]
  node_semester_controller["Semesters"]
  node_semester_model["Semester records<br/>[Semester.php]"]
  node_course_controller["Courses"]
  node_course_model["Course records<br/>[Course.php]"]
end

subgraph group_delivery["Teaching and content"]
  node_doctor_controller["Doctor management"]
  node_doctor_model["Doctor records<br/>[Doctor.php]"]
  node_offering_controller["Course offerings"]
  node_offering_model["Offering records<br/>[CourseOffering.php]"]
  node_assignment_controller["Teaching assignments"]
  node_assignment_model["Course-doctor links<br/>[CourseDoctor.php]"]
  node_content_controller["Course content"]
  node_content_model["Content records<br/>[Content.php]"]
  node_content_type_controller["Content types"]
  node_content_type_model["Content type records<br/>[ContentType.php]"]
end

node_client(("API client"))

node_client -->|"sends requests"| node_api_routes
node_api_routes -->|"routes auth"| node_auth_controller
node_api_routes -->|"routes users"| node_user_controller
node_api_routes -->|"routes departments"| node_department_controller
node_api_routes -->|"routes levels"| node_level_controller
node_api_routes -->|"routes semesters"| node_semester_controller
node_api_routes -->|"routes courses"| node_course_controller
node_api_routes -->|"routes doctors"| node_doctor_controller
node_api_routes -->|"routes offerings"| node_offering_controller
node_api_routes -->|"routes assignments"| node_assignment_controller
node_api_routes -->|"routes content"| node_content_controller
node_api_routes -->|"routes types"| node_content_type_controller
node_auth_controller -->|"uses accounts"| node_user_model
node_user_controller -->|"manages accounts"| node_user_model
node_user_controller -->|"creates accounts"| node_user_factory
node_user_factory -->|"creates records"| node_user_model
node_user_factory -->|"looks up role"| node_role_model
node_department_controller -->|"uses records"| node_department_model
node_level_controller -->|"manages levels"| node_level_model
node_semester_controller -->|"uses records"| node_semester_model
node_course_controller -->|"manages courses"| node_course_model
node_doctor_controller -->|"manages doctors"| node_doctor_model
node_doctor_controller -->|"creates account"| node_user_factory
node_offering_controller -->|"manages offerings"| node_offering_model
node_assignment_controller -->|"manages assignments"| node_assignment_model
node_content_controller -->|"manages content"| node_content_model
node_content_type_controller -->|"uses types"| node_content_type_model
node_content_model -->|"belongs to assignment"| node_assignment_model
node_content_model -->|"belongs to type"| node_content_type_model
node_content_model -->|"references uploader"| node_user_model
node_assignment_model -->|"belongs to offering"| node_offering_model
node_assignment_model -->|"belongs to doctor"| node_doctor_model
node_doctor_model -->|"belongs to account"| node_user_model
node_doctor_model -->|"belongs to department"| node_department_model
node_level_model -->|"belongs to department"| node_department_model
node_level_model -->|"has semesters"| node_semester_model
node_offering_model -->|"belongs to course"| node_course_model
node_offering_model -->|"belongs to semester"| node_semester_model

click node_api_routes "https://github.com/ayman-al-refaee/drasty-backend/blob/main/routes/api.php"
click node_auth_controller "https://github.com/ayman-al-refaee/drasty-backend/blob/main/app/Http/Controllers/AuthController.php"
click node_user_controller "https://github.com/ayman-al-refaee/drasty-backend/blob/main/app/Http/Controllers/UserController.php"
click node_user_factory "https://github.com/ayman-al-refaee/drasty-backend/blob/main/app/Factories/UserFactory.php"
click node_user_model "https://github.com/ayman-al-refaee/drasty-backend/blob/main/app/Models/User.php"
click node_role_model "https://github.com/ayman-al-refaee/drasty-backend/blob/main/app/Models/Role.php"
click node_department_controller "https://github.com/ayman-al-refaee/drasty-backend/blob/main/app/Http/Controllers/DepartmentController.php"
click node_department_model "https://github.com/ayman-al-refaee/drasty-backend/blob/main/app/Models/Department.php"
click node_level_controller "https://github.com/ayman-al-refaee/drasty-backend/blob/main/app/Http/Controllers/LevelController.php"
click node_level_model "https://github.com/ayman-al-refaee/drasty-backend/blob/main/app/Models/Level.php"
click node_semester_controller "https://github.com/ayman-al-refaee/drasty-backend/blob/main/app/Http/Controllers/SemesterController.php"
click node_semester_model "https://github.com/ayman-al-refaee/drasty-backend/blob/main/app/Models/Semester.php"
click node_course_controller "https://github.com/ayman-al-refaee/drasty-backend/blob/main/app/Http/Controllers/CourseController.php"
click node_course_model "https://github.com/ayman-al-refaee/drasty-backend/blob/main/app/Models/Course.php"
click node_doctor_controller "https://github.com/ayman-al-refaee/drasty-backend/blob/main/app/Http/Controllers/DoctorController.php"
click node_doctor_model "https://github.com/ayman-al-refaee/drasty-backend/blob/main/app/Models/Doctor.php"
click node_offering_controller "https://github.com/ayman-al-refaee/drasty-backend/blob/main/app/Http/Controllers/CourseOfferingController.php"
click node_offering_model "https://github.com/ayman-al-refaee/drasty-backend/blob/main/app/Models/CourseOffering.php"
click node_assignment_controller "https://github.com/ayman-al-refaee/drasty-backend/blob/main/app/Http/Controllers/CourseDoctorController.php"
click node_assignment_model "https://github.com/ayman-al-refaee/drasty-backend/blob/main/app/Models/CourseDoctor.php"
click node_content_controller "https://github.com/ayman-al-refaee/drasty-backend/blob/main/app/Http/Controllers/ContentController.php"
click node_content_model "https://github.com/ayman-al-refaee/drasty-backend/blob/main/app/Models/Content.php"
click node_content_type_controller "https://github.com/ayman-al-refaee/drasty-backend/blob/main/app/Http/Controllers/ContentTypeController.php"
click node_content_type_model "https://github.com/ayman-al-refaee/drasty-backend/blob/main/app/Models/ContentType.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_api_routes,node_client toneBlue
class node_auth_controller,node_user_controller,node_user_factory,node_user_model,node_role_model toneAmber
class node_department_controller,node_department_model,node_level_controller,node_level_model,node_semester_controller,node_semester_model,node_course_controller,node_course_model toneMint
class node_doctor_controller,node_doctor_model,node_offering_controller,node_offering_model,node_assignment_controller,node_assignment_model,node_content_controller,node_content_model,node_content_type_controller,node_content_type_model toneRose
```

## Components

### API entry

- [API routes](https://github.com/ayman-al-refaee/drasty-backend/blob/main/routes/api.php): `routes/api.php`

### Identity and staff

- [Authentication](https://github.com/ayman-al-refaee/drasty-backend/blob/main/app/Http/Controllers/AuthController.php): `app/Http/Controllers/AuthController.php`
- [User management](https://github.com/ayman-al-refaee/drasty-backend/blob/main/app/Http/Controllers/UserController.php): `app/Http/Controllers/UserController.php`
- [User factory](https://github.com/ayman-al-refaee/drasty-backend/blob/main/app/Factories/UserFactory.php): `app/Factories/UserFactory.php`
- [User accounts](https://github.com/ayman-al-refaee/drasty-backend/blob/main/app/Models/User.php): `app/Models/User.php`
- [Roles](https://github.com/ayman-al-refaee/drasty-backend/blob/main/app/Models/Role.php): `app/Models/Role.php`

### Academic structure

- [Departments](https://github.com/ayman-al-refaee/drasty-backend/blob/main/app/Http/Controllers/DepartmentController.php): `app/Http/Controllers/DepartmentController.php`
- [Department records](https://github.com/ayman-al-refaee/drasty-backend/blob/main/app/Models/Department.php): `app/Models/Department.php`
- [Study levels](https://github.com/ayman-al-refaee/drasty-backend/blob/main/app/Http/Controllers/LevelController.php): `app/Http/Controllers/LevelController.php`
- [Level records](https://github.com/ayman-al-refaee/drasty-backend/blob/main/app/Models/Level.php): `app/Models/Level.php`
- [Semesters](https://github.com/ayman-al-refaee/drasty-backend/blob/main/app/Http/Controllers/SemesterController.php): `app/Http/Controllers/SemesterController.php`
- [Semester records](https://github.com/ayman-al-refaee/drasty-backend/blob/main/app/Models/Semester.php): `app/Models/Semester.php`
- [Courses](https://github.com/ayman-al-refaee/drasty-backend/blob/main/app/Http/Controllers/CourseController.php): `app/Http/Controllers/CourseController.php`
- [Course records](https://github.com/ayman-al-refaee/drasty-backend/blob/main/app/Models/Course.php): `app/Models/Course.php`

### Teaching and content

- [Doctor management](https://github.com/ayman-al-refaee/drasty-backend/blob/main/app/Http/Controllers/DoctorController.php): `app/Http/Controllers/DoctorController.php`
- [Doctor records](https://github.com/ayman-al-refaee/drasty-backend/blob/main/app/Models/Doctor.php): `app/Models/Doctor.php`
- [Course offerings](https://github.com/ayman-al-refaee/drasty-backend/blob/main/app/Http/Controllers/CourseOfferingController.php): `app/Http/Controllers/CourseOfferingController.php`
- [Offering records](https://github.com/ayman-al-refaee/drasty-backend/blob/main/app/Models/CourseOffering.php): `app/Models/CourseOffering.php`
- [Teaching assignments](https://github.com/ayman-al-refaee/drasty-backend/blob/main/app/Http/Controllers/CourseDoctorController.php): `app/Http/Controllers/CourseDoctorController.php`
- [Course-doctor links](https://github.com/ayman-al-refaee/drasty-backend/blob/main/app/Models/CourseDoctor.php): `app/Models/CourseDoctor.php`
- [Course content](https://github.com/ayman-al-refaee/drasty-backend/blob/main/app/Http/Controllers/ContentController.php): `app/Http/Controllers/ContentController.php`
- [Content records](https://github.com/ayman-al-refaee/drasty-backend/blob/main/app/Models/Content.php): `app/Models/Content.php`
- [Content types](https://github.com/ayman-al-refaee/drasty-backend/blob/main/app/Http/Controllers/ContentTypeController.php): `app/Http/Controllers/ContentTypeController.php`
- [Content type records](https://github.com/ayman-al-refaee/drasty-backend/blob/main/app/Models/ContentType.php): `app/Models/ContentType.php`

### Other components

- **API client**

## Connections

- API client → API routes: sends requests (evidence: `routes/api.php`)
- API routes → Authentication: routes auth (evidence: `routes/api.php`)
- API routes → User management: routes users (evidence: `routes/api.php`)
- API routes → Departments: routes departments (evidence: `routes/api.php`)
- API routes → Study levels: routes levels (evidence: `routes/api.php`)
- API routes → Semesters: routes semesters (evidence: `routes/api.php`)
- API routes → Courses: routes courses (evidence: `routes/api.php`)
- API routes → Doctor management: routes doctors (evidence: `routes/api.php`)
- API routes → Course offerings: routes offerings (evidence: `routes/api.php`)
- API routes → Teaching assignments: routes assignments (evidence: `routes/api.php`)
- API routes → Course content: routes content (evidence: `routes/api.php`)
- API routes → Content types: routes types (evidence: `routes/api.php`)
- Authentication → User accounts: uses accounts (evidence: `app/Http/Controllers/AuthController.php`)
- User management → User accounts: manages accounts (evidence: `app/Http/Controllers/UserController.php`)
- User management → User factory: creates accounts (evidence: `app/Http/Controllers/UserController.php`)
- User factory → User accounts: creates records (evidence: `app/Factories/UserFactory.php`)
- User factory → Roles: looks up role (evidence: `app/Factories/UserFactory.php`)
- Departments → Department records: uses records (evidence: `app/Http/Controllers/DepartmentController.php`)
- Study levels → Level records: manages levels (evidence: `app/Http/Controllers/LevelController.php`)
- Semesters → Semester records: uses records (evidence: `app/Http/Controllers/SemesterController.php`)
- Courses → Course records: manages courses (evidence: `app/Http/Controllers/CourseController.php`)
- Doctor management → Doctor records: manages doctors (evidence: `app/Http/Controllers/DoctorController.php`)
- Doctor management → User factory: creates account (evidence: `app/Http/Controllers/DoctorController.php`)
- Course offerings → Offering records: manages offerings (evidence: `app/Http/Controllers/CourseOfferingController.php`)
- Teaching assignments → Course-doctor links: manages assignments (evidence: `app/Http/Controllers/CourseDoctorController.php`)
- Course content → Content records: manages content (evidence: `app/Http/Controllers/ContentController.php`)
- Content types → Content type records: uses types (evidence: `app/Http/Controllers/ContentTypeController.php`)
- Content records → Course-doctor links: belongs to assignment (evidence: `app/Models/Content.php`)
- Content records → Content type records: belongs to type (evidence: `app/Models/Content.php`)
- Content records → User accounts: references uploader (evidence: `app/Models/Content.php`)
- Course-doctor links → Offering records: belongs to offering (evidence: `app/Models/CourseDoctor.php`)
- Course-doctor links → Doctor records: belongs to doctor (evidence: `app/Models/CourseDoctor.php`)
- Doctor records → User accounts: belongs to account (evidence: `app/Models/Doctor.php`)
- Doctor records → Department records: belongs to department (evidence: `app/Models/Doctor.php`)
- Level records → Department records: belongs to department (evidence: `app/Models/Level.php`)
- Level records → Semester records: has semesters (evidence: `app/Models/Level.php`)
- Offering records → Course records: belongs to course (evidence: `app/Models/CourseOffering.php`)
- Offering records → Semester records: belongs to semester (evidence: `app/Models/CourseOffering.php`)
