# jeremypanaiva/sae_manager architecture

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

- Interactive diagram: https://gitdiagram.com/jeremypanaiva/sae_manager
- Repository: https://github.com/jeremypanaiva/sae_manager

## Overview

SAE Manager is a PHP MVC web application for students, teachers/responsables, and clients to manage learning projects. The main workflow routes a browser request to a controller, which enforces access and coordinates account, SAE, attribution, evaluation, or dashboard operations before rendering a view or sending notifications. The map retains documented scheduling, deliverables, evaluations, and email-reminder capabilities. The README and source index support the routing and major subsystem links; unsampled feature wiring is not asserted beyond documented capabilities.

Main entry points: [`src/Models/User/User.php`](https://github.com/jeremypanaiva/sae_manager/blob/main/src/Models/User/User.php) (User accounts), [`src/Models/Sae/SaeAttribution.php`](https://github.com/jeremypanaiva/sae_manager/blob/main/src/Models/Sae/SaeAttribution.php) (Assignments and evaluations), [`index.php`](https://github.com/jeremypanaiva/sae_manager/blob/main/index.php) (HTTP routing), [`src/Controllers/Sae/SaeController.php`](https://github.com/jeremypanaiva/sae_manager/blob/main/src/Controllers/Sae/SaeController.php) (SAE workspace)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web entry and views"]
  node_router["HTTP routing<br/>[index.php]"]
  node_base_views["Shared page layout<br/>[BaseView.php]"]
  node_sae_views["SAE pages<br/>[SaeView.php]"]
  node_dashboard_views["Dashboard pages<br/>[DashboardView.php]"]
  node_home_controller["Home page<br/>[HomeController.php]"]
end

subgraph group_accounts["Accounts and access"]
  node_login["Login and registration<br/>[Login.php]"]
  node_profile["Profile management"]
  node_email_verify["Email verification"]
  node_session_guard["Session security<br/>[SessionGuard.php]"]
  node_user_model["User accounts<br/>[User.php]"]
end

subgraph group_saes["SAE management"]
  node_sae_controller["SAE workspace<br/>[SaeController.php]"]
  node_sae_lifecycle["SAE lifecycle"]
  node_assignment_controller["SAE assignment"]
  node_sae_model["SAE records<br/>[Sae.php]"]
  node_attribution_model["Assignments and evaluations<br/>[SaeAttribution.php]"]
  node_avis_controller["Evaluation feedback<br/>[AvisController.php]"]
  node_deadline_controller["Deadline reminders"]
end

subgraph group_dashboard["Progress and communication"]
  node_dashboard_controller["Dashboard coordination"]
  node_todo_controller["Deliverables and tasks<br/>[TodoController.php]"]
  node_message_controller["Student messaging"]
  node_todo_model["Task lists<br/>[TodoList.php]"]
end

subgraph group_services["Persistence and notifications"]
  node_database["Database access<br/>[Database.php]"]
  node_email_service["Email delivery<br/>[EmailService.php]"]
  node_email_views["Email templates<br/>[EmailView.php]"]
  node_smtp["SMTP configuration"]
end

node_browser(("Users"))
node_mysql[("MySQL")]
node_mail_provider["Mail transport"]

node_browser -->|"sends request"| node_router
node_router -->|"routes request"| node_home_controller
node_router -->|"routes request"| node_login
node_router -->|"routes request"| node_sae_controller
node_router -->|"routes request"| node_dashboard_controller
node_home_controller -->|"renders page"| node_base_views
node_sae_controller -->|"renders page"| node_sae_views
node_dashboard_controller -->|"renders page"| node_dashboard_views
node_base_views -->|"reads user"| node_user_model
node_sae_views -->|"uses layout"| node_base_views
node_dashboard_views -->|"uses layout"| node_base_views
node_login -->|"authenticates users"| node_user_model
node_profile -->|"updates account"| node_user_model
node_email_verify -->|"verifies account"| node_user_model
node_profile -->|"checks session"| node_session_guard
node_session_guard -->|"checks token"| node_user_model
node_sae_controller -->|"loads projects"| node_sae_model
node_sae_controller -->|"loads students"| node_user_model
node_sae_controller -->|"loads assignments"| node_attribution_model
node_assignment_controller -->|"assigns students"| node_attribution_model
node_assignment_controller -->|"checks projects"| node_sae_model
node_sae_lifecycle -.->|"creates projects"| node_sae_model
node_avis_controller -.->|"records feedback"| node_attribution_model
node_deadline_controller -->|"finds due work"| node_attribution_model
node_dashboard_controller -->|"loads progress"| node_attribution_model
node_dashboard_controller -->|"loads tasks"| node_todo_model
node_todo_controller -->|"updates tasks"| node_todo_model
node_message_controller -->|"groups recipients"| node_attribution_model
node_message_controller -.->|"sends message"| node_email_service
node_user_model -->|"queries data"| node_database
node_sae_model -->|"queries data"| node_database
node_attribution_model -->|"queries data"| node_database
node_todo_model -.->|"stores tasks"| node_database
node_database -->|"reads and writes"| node_mysql
node_email_service -->|"renders templates"| node_email_views
node_email_service -->|"uses settings"| node_smtp
node_email_service -.->|"sends email"| node_mail_provider
node_deadline_controller -->|"sends reminders"| node_email_service

click node_router "https://github.com/jeremypanaiva/sae_manager/blob/main/index.php"
click node_base_views "https://github.com/jeremypanaiva/sae_manager/blob/main/src/Views/Base/BaseView.php"
click node_sae_views "https://github.com/jeremypanaiva/sae_manager/blob/main/src/Views/Sae/SaeView.php"
click node_dashboard_views "https://github.com/jeremypanaiva/sae_manager/blob/main/src/Views/Dashboard/DashboardView.php"
click node_home_controller "https://github.com/jeremypanaiva/sae_manager/blob/main/src/Controllers/Home/HomeController.php"
click node_login "https://github.com/jeremypanaiva/sae_manager/blob/main/src/Controllers/User/Login.php"
click node_profile "https://github.com/jeremypanaiva/sae_manager/blob/main/src/Controllers/User/ProfileController.php"
click node_email_verify "https://github.com/jeremypanaiva/sae_manager/blob/main/src/Controllers/User/VerifyEmailController.php"
click node_session_guard "https://github.com/jeremypanaiva/sae_manager/blob/main/src/Shared/SessionGuard.php"
click node_user_model "https://github.com/jeremypanaiva/sae_manager/blob/main/src/Models/User/User.php"
click node_sae_controller "https://github.com/jeremypanaiva/sae_manager/blob/main/src/Controllers/Sae/SaeController.php"
click node_sae_lifecycle "https://github.com/jeremypanaiva/sae_manager/blob/main/src/Controllers/Sae/CreateSaeController.php"
click node_assignment_controller "https://github.com/jeremypanaiva/sae_manager/blob/main/src/Controllers/Sae/AttribuerSaeController.php"
click node_sae_model "https://github.com/jeremypanaiva/sae_manager/blob/main/src/Models/Sae/Sae.php"
click node_attribution_model "https://github.com/jeremypanaiva/sae_manager/blob/main/src/Models/Sae/SaeAttribution.php"
click node_avis_controller "https://github.com/jeremypanaiva/sae_manager/blob/main/src/Controllers/Sae/AvisController.php"
click node_deadline_controller "https://github.com/jeremypanaiva/sae_manager/blob/main/src/Controllers/Sae/DeadlineReminderController.php"
click node_dashboard_controller "https://github.com/jeremypanaiva/sae_manager/blob/main/src/Controllers/Dashboard/DashboardController.php"
click node_todo_controller "https://github.com/jeremypanaiva/sae_manager/blob/main/src/Controllers/Dashboard/TodoController.php"
click node_message_controller "https://github.com/jeremypanaiva/sae_manager/blob/main/src/Controllers/Dashboard/SendMessageController.php"
click node_todo_model "https://github.com/jeremypanaiva/sae_manager/blob/main/src/Models/Sae/TodoList.php"
click node_database "https://github.com/jeremypanaiva/sae_manager/blob/main/src/Models/Database.php"
click node_email_service "https://github.com/jeremypanaiva/sae_manager/blob/main/src/Models/User/EmailService.php"
click node_email_views "https://github.com/jeremypanaiva/sae_manager/blob/main/src/Views/Email/EmailView.php"
click node_smtp "https://github.com/jeremypanaiva/sae_manager/blob/main/src/Shared/Services/Email/SmtpConfiguration.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_router,node_base_views,node_sae_views,node_dashboard_views,node_home_controller,node_browser toneBlue
class node_login,node_profile,node_email_verify,node_session_guard,node_user_model,node_mysql toneAmber
class node_sae_controller,node_sae_lifecycle,node_assignment_controller,node_sae_model,node_attribution_model,node_avis_controller,node_deadline_controller toneMint
class node_dashboard_controller,node_todo_controller,node_message_controller,node_todo_model toneRose
class node_database,node_email_service,node_email_views,node_smtp,node_mail_provider toneIndigo
```

## Components

### Web entry and views

- [HTTP routing](https://github.com/jeremypanaiva/sae_manager/blob/main/index.php): `index.php`
- [Shared page layout](https://github.com/jeremypanaiva/sae_manager/blob/main/src/Views/Base/BaseView.php): `src/Views/Base/BaseView.php`
- [SAE pages](https://github.com/jeremypanaiva/sae_manager/blob/main/src/Views/Sae/SaeView.php): `src/Views/Sae/SaeView.php`
- [Dashboard pages](https://github.com/jeremypanaiva/sae_manager/blob/main/src/Views/Dashboard/DashboardView.php): `src/Views/Dashboard/DashboardView.php`
- [Home page](https://github.com/jeremypanaiva/sae_manager/blob/main/src/Controllers/Home/HomeController.php): `src/Controllers/Home/HomeController.php`

### Accounts and access

- [Login and registration](https://github.com/jeremypanaiva/sae_manager/blob/main/src/Controllers/User/Login.php): `src/Controllers/User/Login.php`
- [Profile management](https://github.com/jeremypanaiva/sae_manager/blob/main/src/Controllers/User/ProfileController.php): `src/Controllers/User/ProfileController.php`
- [Email verification](https://github.com/jeremypanaiva/sae_manager/blob/main/src/Controllers/User/VerifyEmailController.php): `src/Controllers/User/VerifyEmailController.php`
- [Session security](https://github.com/jeremypanaiva/sae_manager/blob/main/src/Shared/SessionGuard.php): `src/Shared/SessionGuard.php`
- [User accounts](https://github.com/jeremypanaiva/sae_manager/blob/main/src/Models/User/User.php): `src/Models/User/User.php`

### SAE management

- [SAE workspace](https://github.com/jeremypanaiva/sae_manager/blob/main/src/Controllers/Sae/SaeController.php): `src/Controllers/Sae/SaeController.php`
- [SAE lifecycle](https://github.com/jeremypanaiva/sae_manager/blob/main/src/Controllers/Sae/CreateSaeController.php): `src/Controllers/Sae/CreateSaeController.php`
- [SAE assignment](https://github.com/jeremypanaiva/sae_manager/blob/main/src/Controllers/Sae/AttribuerSaeController.php): `src/Controllers/Sae/AttribuerSaeController.php`
- [SAE records](https://github.com/jeremypanaiva/sae_manager/blob/main/src/Models/Sae/Sae.php): `src/Models/Sae/Sae.php`
- [Assignments and evaluations](https://github.com/jeremypanaiva/sae_manager/blob/main/src/Models/Sae/SaeAttribution.php): `src/Models/Sae/SaeAttribution.php`
- [Evaluation feedback](https://github.com/jeremypanaiva/sae_manager/blob/main/src/Controllers/Sae/AvisController.php): `src/Controllers/Sae/AvisController.php`
- [Deadline reminders](https://github.com/jeremypanaiva/sae_manager/blob/main/src/Controllers/Sae/DeadlineReminderController.php): `src/Controllers/Sae/DeadlineReminderController.php`

### Progress and communication

- [Dashboard coordination](https://github.com/jeremypanaiva/sae_manager/blob/main/src/Controllers/Dashboard/DashboardController.php): `src/Controllers/Dashboard/DashboardController.php`
- [Deliverables and tasks](https://github.com/jeremypanaiva/sae_manager/blob/main/src/Controllers/Dashboard/TodoController.php): `src/Controllers/Dashboard/TodoController.php`
- [Student messaging](https://github.com/jeremypanaiva/sae_manager/blob/main/src/Controllers/Dashboard/SendMessageController.php): `src/Controllers/Dashboard/SendMessageController.php`
- [Task lists](https://github.com/jeremypanaiva/sae_manager/blob/main/src/Models/Sae/TodoList.php): `src/Models/Sae/TodoList.php`

### Persistence and notifications

- [Database access](https://github.com/jeremypanaiva/sae_manager/blob/main/src/Models/Database.php): `src/Models/Database.php`
- [Email delivery](https://github.com/jeremypanaiva/sae_manager/blob/main/src/Models/User/EmailService.php): `src/Models/User/EmailService.php`
- [Email templates](https://github.com/jeremypanaiva/sae_manager/blob/main/src/Views/Email/EmailView.php): `src/Views/Email/EmailView.php`
- [SMTP configuration](https://github.com/jeremypanaiva/sae_manager/blob/main/src/Shared/Services/Email/SmtpConfiguration.php): `src/Shared/Services/Email/SmtpConfiguration.php`

### Other components

- **Users**
- **MySQL**
- **Mail transport**

## Connections

- Users → HTTP routing: sends request (evidence: `index.php`)
- HTTP routing → Home page: routes request (evidence: `index.php`)
- HTTP routing → Login and registration: routes request (evidence: `index.php`)
- HTTP routing → SAE workspace: routes request (evidence: `index.php`)
- HTTP routing → Dashboard coordination: routes request (evidence: `index.php`)
- Home page → Shared page layout: renders page (evidence: `src/Controllers/Home/HomeController.php`)
- SAE workspace → SAE pages: renders page (evidence: `src/Controllers/Sae/SaeController.php`)
- Dashboard coordination → Dashboard pages: renders page (evidence: `src/Controllers/Dashboard/DashboardController.php`)
- Shared page layout → User accounts: reads user (evidence: `src/Views/Base/BaseView.php`)
- SAE pages → Shared page layout: uses layout (evidence: `src/Views/Sae/SaeView.php`)
- Dashboard pages → Shared page layout: uses layout (evidence: `src/Views/Dashboard/DashboardView.php`)
- Login and registration → User accounts: authenticates users
- Profile management → User accounts: updates account (evidence: `src/Controllers/User/ProfileController.php`)
- Email verification → User accounts: verifies account (evidence: `src/Controllers/User/VerifyEmailController.php`)
- Profile management → Session security: checks session (evidence: `src/Controllers/User/ProfileController.php`)
- Session security → User accounts: checks token (evidence: `src/Shared/SessionGuard.php`)
- SAE workspace → SAE records: loads projects (evidence: `src/Controllers/Sae/SaeController.php`)
- SAE workspace → User accounts: loads students (evidence: `src/Controllers/Sae/SaeController.php`)
- SAE workspace → Assignments and evaluations: loads assignments (evidence: `src/Controllers/Sae/SaeController.php`)
- SAE assignment → Assignments and evaluations: assigns students (evidence: `src/Controllers/Sae/AttribuerSaeController.php`)
- SAE assignment → SAE records: checks projects (evidence: `src/Controllers/Sae/AttribuerSaeController.php`)
- SAE lifecycle → SAE records: creates projects
- Evaluation feedback → Assignments and evaluations: records feedback
- Deadline reminders → Assignments and evaluations: finds due work (evidence: `src/Controllers/Sae/DeadlineReminderController.php`)
- Dashboard coordination → Assignments and evaluations: loads progress (evidence: `src/Controllers/Dashboard/DashboardController.php`)
- Dashboard coordination → Task lists: loads tasks (evidence: `src/Controllers/Dashboard/DashboardController.php`)
- Deliverables and tasks → Task lists: updates tasks (evidence: `src/Controllers/Dashboard/TodoController.php`)
- Student messaging → Assignments and evaluations: groups recipients (evidence: `src/Controllers/Dashboard/SendMessageController.php`)
- Student messaging → Email delivery: sends message (evidence: `src/Controllers/Dashboard/SendMessageController.php`)
- User accounts → Database access: queries data (evidence: `src/Models/User/User.php`)
- SAE records → Database access: queries data (evidence: `src/Models/Sae/Sae.php`)
- Assignments and evaluations → Database access: queries data (evidence: `src/Models/Sae/SaeAttribution.php`)
- Task lists → Database access: stores tasks
- Database access → MySQL: reads and writes (evidence: `src/Models/Database.php`)
- Email delivery → Email templates: renders templates (evidence: `src/Models/User/EmailService.php`)
- Email delivery → SMTP configuration: uses settings (evidence: `src/Models/User/EmailService.php`)
- Email delivery → Mail transport: sends email
- Deadline reminders → Email delivery: sends reminders (evidence: `src/Controllers/Sae/DeadlineReminderController.php`)
