# abdalla-sobhy/ace architecture

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

- Interactive diagram: https://gitdiagram.com/abdalla-sobhy/ace
- Repository: https://github.com/abdalla-sobhy/ace

## Overview

Edvance is a multi-role learning and career platform: students learn and attend live classes, while university students build profiles and pursue jobs; teachers, companies, parents, and administrators have their own workflows. The map preserves the documented AI, identity, payments, notifications, and external-job capabilities. Several frontend-to-backend connections and unsampled integrations are not shown because the excerpts do not establish their call paths.

Main entry points: [`backend/app/Models/Course.php`](https://github.com/abdalla-sobhy/ace/blob/main/backend/app/Models/Course.php) (Course Catalog), [`backend/app/Http/Controllers/Api/CompanyJobController.php`](https://github.com/abdalla-sobhy/ace/blob/main/backend/app/Http/Controllers/Api/CompanyJobController.php) (Company Job API), [`backend/app/Http/Controllers/Api/UniversityStudentController.php`](https://github.com/abdalla-sobhy/ace/blob/main/backend/app/Http/Controllers/Api/UniversityStudentController.php) (Profile Management), [`backend/app/Services/AdminService.php`](https://github.com/abdalla-sobhy/ace/blob/main/backend/app/Services/AdminService.php) (Administration)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_identity["Identity &amp; Profiles"]
  node_signup["Registration<br/>[page.tsx]"]
  node_auth["Authentication<br/>[AuthController.php]"]
  node_users[("User Accounts<br/>[User.php]")]
  node_university_profile["University Profile<br/>[page.tsx]"]
  node_university_profile_api["Profile Management"]
end

subgraph group_learning["Learning &amp; Live Classes"]
  node_courses[("Course Catalog<br/>[Course.php]")]
  node_enrollments[("Course Enrollments")]
  node_course_lessons[("Lessons<br/>[CourseLesson.php]")]
  node_live_sessions[("Live Sessions<br/>[LiveSession.php]")]
end

subgraph group_careers["Career Marketplace"]
  node_job_controller["Company Job API"]
  node_companies_data[("Company Profiles<br/>[Company.php]")]
  node_job_postings[("Job Postings<br/>[JobPosting.php]")]
  node_applications[("Applications<br/>[JobApplication.php]")]
  node_external_jobs["External Job Search<br/>[JSearchService.php]"]
end

subgraph group_integrations["External Services"]
  node_jsearch{{"JSearch API"}}
  node_ai_mentor["AI Career Mentor<br/>[GeminiService.php]"]
  node_identity_verification["Identity Verification<br/>[DiditService.php]"]
  node_didit{{"Didit"}}
  node_payments["Payments"]
  node_stripe{{"Stripe"}}
end

subgraph group_operations["Platform Operations"]
  node_notifications["Notifications<br/>[NewJobPosted.php]"]
  node_admin_service["Administration<br/>[AdminService.php]"]
end

node_students(("Students"))
node_university_students(("University Students"))
node_teachers(("Teachers"))
node_companies(("Companies"))
node_parents(("Parents"))
node_admins(("Administrators"))

node_students -->|"register"| node_signup
node_university_students -->|"register"| node_signup
node_signup -.-> node_auth
node_auth -->|"creates account"| node_users
node_university_students -->|"manage profile"| node_university_profile
node_university_profile -.-> node_university_profile_api
node_university_profile_api -->|"reads user"| node_users
node_university_profile_api -->|"queries courses"| node_courses
node_university_profile_api -->|"queries enrollments"| node_enrollments
node_students -->|"browse and enroll"| node_courses
node_teachers -->|"create courses"| node_courses
node_courses -->|"has lessons"| node_course_lessons
node_courses -->|"has sessions"| node_live_sessions
node_courses -->|"enrollments"| node_enrollments
node_students -->|"attend classes"| node_live_sessions
node_companies -->|"manage jobs"| node_job_controller
node_university_students -->|"seek jobs"| node_job_controller
node_job_controller -->|"queries postings"| node_job_postings
node_job_controller -->|"queries applications"| node_applications
node_job_controller -->|"uses company data"| node_companies_data
node_job_postings -->|"belongs to"| node_companies_data
node_job_postings -->|"has applications"| node_applications
node_applications -->|"notifies on status"| node_notifications
node_university_students -->|"search external jobs"| node_external_jobs
node_external_jobs -->|"searches"| node_jsearch
node_students -->|"get career guidance"| node_ai_mentor
node_university_students -->|"get career guidance"| node_ai_mentor
node_teachers -->|"verify identity"| node_identity_verification
node_parents -->|"verify identity"| node_identity_verification
node_identity_verification -->|"verifies identity"| node_didit
node_students -->|"pay for courses"| node_payments
node_payments -->|"processes payments"| node_stripe
node_admins -->|"manage platform"| node_admin_service
node_admin_service -->|"manages users"| node_users
node_admin_service -->|"manages courses"| node_courses
node_admin_service -->|"manages postings"| node_job_postings

click node_signup "https://github.com/abdalla-sobhy/ace/blob/main/frontend/app/signup/page.tsx"
click node_auth "https://github.com/abdalla-sobhy/ace/blob/main/backend/app/Http/Controllers/AuthController.php"
click node_users "https://github.com/abdalla-sobhy/ace/blob/main/backend/app/Models/User.php"
click node_university_profile "https://github.com/abdalla-sobhy/ace/blob/main/frontend/app/university_student/profile/page.tsx"
click node_university_profile_api "https://github.com/abdalla-sobhy/ace/blob/main/backend/app/Http/Controllers/Api/UniversityStudentController.php"
click node_courses "https://github.com/abdalla-sobhy/ace/blob/main/backend/app/Models/Course.php"
click node_enrollments "https://github.com/abdalla-sobhy/ace/blob/main/backend/app/Models/CourseEnrollment.php"
click node_course_lessons "https://github.com/abdalla-sobhy/ace/blob/main/backend/app/Models/CourseLesson.php"
click node_live_sessions "https://github.com/abdalla-sobhy/ace/blob/main/backend/app/Models/LiveSession.php"
click node_job_controller "https://github.com/abdalla-sobhy/ace/blob/main/backend/app/Http/Controllers/Api/CompanyJobController.php"
click node_companies_data "https://github.com/abdalla-sobhy/ace/blob/main/backend/app/Models/Company.php"
click node_job_postings "https://github.com/abdalla-sobhy/ace/blob/main/backend/app/Models/JobPosting.php"
click node_applications "https://github.com/abdalla-sobhy/ace/blob/main/backend/app/Models/JobApplication.php"
click node_external_jobs "https://github.com/abdalla-sobhy/ace/blob/main/backend/app/Services/JSearchService.php"
click node_ai_mentor "https://github.com/abdalla-sobhy/ace/blob/main/backend/app/Services/GeminiService.php"
click node_identity_verification "https://github.com/abdalla-sobhy/ace/blob/main/backend/app/Services/DiditService.php"
click node_payments "https://github.com/abdalla-sobhy/ace/blob/main/backend/app/Http/Controllers/Api/PaymentController.php"
click node_notifications "https://github.com/abdalla-sobhy/ace/blob/main/backend/app/Notifications/NewJobPosted.php"
click node_admin_service "https://github.com/abdalla-sobhy/ace/blob/main/backend/app/Services/AdminService.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_signup,node_auth,node_users,node_university_profile,node_university_profile_api toneBlue
class node_courses,node_enrollments,node_course_lessons,node_live_sessions toneAmber
class node_job_controller,node_companies_data,node_job_postings,node_applications,node_external_jobs toneMint
class node_jsearch,node_ai_mentor,node_identity_verification,node_didit,node_payments,node_stripe toneRose
class node_notifications,node_admin_service,node_students,node_university_students,node_teachers,node_companies,node_parents,node_admins toneIndigo
```

## Components

### Identity & Profiles

- [Registration](https://github.com/abdalla-sobhy/ace/blob/main/frontend/app/signup/page.tsx): `frontend/app/signup/page.tsx`
- [Authentication](https://github.com/abdalla-sobhy/ace/blob/main/backend/app/Http/Controllers/AuthController.php): `backend/app/Http/Controllers/AuthController.php`
- [User Accounts](https://github.com/abdalla-sobhy/ace/blob/main/backend/app/Models/User.php): `backend/app/Models/User.php`
- [University Profile](https://github.com/abdalla-sobhy/ace/blob/main/frontend/app/university_student/profile/page.tsx): `frontend/app/university_student/profile/page.tsx`
- [Profile Management](https://github.com/abdalla-sobhy/ace/blob/main/backend/app/Http/Controllers/Api/UniversityStudentController.php): `backend/app/Http/Controllers/Api/UniversityStudentController.php`

### Learning & Live Classes

- [Course Catalog](https://github.com/abdalla-sobhy/ace/blob/main/backend/app/Models/Course.php): `backend/app/Models/Course.php`
- [Course Enrollments](https://github.com/abdalla-sobhy/ace/blob/main/backend/app/Models/CourseEnrollment.php): `backend/app/Models/CourseEnrollment.php`
- [Lessons](https://github.com/abdalla-sobhy/ace/blob/main/backend/app/Models/CourseLesson.php): `backend/app/Models/CourseLesson.php`
- [Live Sessions](https://github.com/abdalla-sobhy/ace/blob/main/backend/app/Models/LiveSession.php): `backend/app/Models/LiveSession.php`

### Career Marketplace

- [Company Job API](https://github.com/abdalla-sobhy/ace/blob/main/backend/app/Http/Controllers/Api/CompanyJobController.php): `backend/app/Http/Controllers/Api/CompanyJobController.php`
- [Company Profiles](https://github.com/abdalla-sobhy/ace/blob/main/backend/app/Models/Company.php): `backend/app/Models/Company.php`
- [Job Postings](https://github.com/abdalla-sobhy/ace/blob/main/backend/app/Models/JobPosting.php): `backend/app/Models/JobPosting.php`
- [Applications](https://github.com/abdalla-sobhy/ace/blob/main/backend/app/Models/JobApplication.php): `backend/app/Models/JobApplication.php`
- [External Job Search](https://github.com/abdalla-sobhy/ace/blob/main/backend/app/Services/JSearchService.php): `backend/app/Services/JSearchService.php`

### External Services

- **JSearch API**
- [AI Career Mentor](https://github.com/abdalla-sobhy/ace/blob/main/backend/app/Services/GeminiService.php): `backend/app/Services/GeminiService.php`
- [Identity Verification](https://github.com/abdalla-sobhy/ace/blob/main/backend/app/Services/DiditService.php): `backend/app/Services/DiditService.php`
- **Didit**
- [Payments](https://github.com/abdalla-sobhy/ace/blob/main/backend/app/Http/Controllers/Api/PaymentController.php): `backend/app/Http/Controllers/Api/PaymentController.php`
- **Stripe**

### Platform Operations

- [Notifications](https://github.com/abdalla-sobhy/ace/blob/main/backend/app/Notifications/NewJobPosted.php): `backend/app/Notifications/NewJobPosted.php`
- [Administration](https://github.com/abdalla-sobhy/ace/blob/main/backend/app/Services/AdminService.php): `backend/app/Services/AdminService.php`

### Other components

- **Students**
- **University Students**
- **Teachers**
- **Companies**
- **Parents**
- **Administrators**

## Connections

- Students → Registration: register
- University Students → Registration: register
- Registration → Authentication
- Authentication → User Accounts: creates account (evidence: `backend/app/Http/Controllers/AuthController.php`)
- University Students → University Profile: manage profile
- University Profile → Profile Management
- Profile Management → User Accounts: reads user (evidence: `backend/app/Http/Controllers/Api/UniversityStudentController.php`)
- Profile Management → Course Catalog: queries courses (evidence: `backend/app/Http/Controllers/Api/UniversityStudentController.php`)
- Profile Management → Course Enrollments: queries enrollments (evidence: `backend/app/Http/Controllers/Api/UniversityStudentController.php`)
- Students → Course Catalog: browse and enroll
- Teachers → Course Catalog: create courses
- Course Catalog → Lessons: has lessons (evidence: `backend/app/Models/Course.php`)
- Course Catalog → Live Sessions: has sessions (evidence: `backend/app/Models/Course.php`)
- Course Catalog → Course Enrollments: enrollments (evidence: `backend/app/Models/Course.php`)
- Students → Live Sessions: attend classes
- Companies → Company Job API: manage jobs
- University Students → Company Job API: seek jobs
- Company Job API → Job Postings: queries postings (evidence: `backend/app/Http/Controllers/Api/CompanyJobController.php`)
- Company Job API → Applications: queries applications (evidence: `backend/app/Http/Controllers/Api/CompanyJobController.php`)
- Company Job API → Company Profiles: uses company data (evidence: `backend/app/Http/Controllers/Api/CompanyJobController.php`)
- Job Postings → Company Profiles: belongs to (evidence: `backend/app/Models/JobPosting.php`)
- Job Postings → Applications: has applications (evidence: `backend/app/Models/JobPosting.php`)
- Applications → Notifications: notifies on status (evidence: `backend/app/Models/JobApplication.php`)
- University Students → External Job Search: search external jobs
- External Job Search → JSearch API: searches (evidence: `backend/app/Services/JSearchService.php`)
- Students → AI Career Mentor: get career guidance
- University Students → AI Career Mentor: get career guidance
- Teachers → Identity Verification: verify identity
- Parents → Identity Verification: verify identity
- Identity Verification → Didit: verifies identity
- Students → Payments: pay for courses
- Payments → Stripe: processes payments
- Administrators → Administration: manage platform
- Administration → User Accounts: manages users (evidence: `backend/app/Services/AdminService.php`)
- Administration → Course Catalog: manages courses (evidence: `backend/app/Services/AdminService.php`)
- Administration → Job Postings: manages postings (evidence: `backend/app/Services/AdminService.php`)
