# deltawebmaroc/ipaf-gestion architecture

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

- Interactive diagram: https://gitdiagram.com/deltawebmaroc/ipaf-gestion
- Repository: https://github.com/deltawebmaroc/ipaf-gestion

## Overview

IPAF Gestion is a school-administration application for managing student records, training and schedules, payments, institutional documents, reporting, and supervised system operations. The main workflow is staff managing student enrollment and related financial obligations, then reviewing reports or producing documents. The graph preserves those domain areas and the documented backup/update and security capabilities. Evidence is limited to the README and the supplied source index and excerpts; unsampled subsystem links are therefore omitted rather than inferred.

Main entry points: [`app/Models/Schedule.php`](https://github.com/deltawebmaroc/ipaf-gestion/blob/main/app/Models/Schedule.php) (Timetables), [`app/Http/Controllers/StudentDocumentController.php`](https://github.com/deltawebmaroc/ipaf-gestion/blob/main/app/Http/Controllers/StudentDocumentController.php) (Student documents), [`app/Models/TrainingModule.php`](https://github.com/deltawebmaroc/ipaf-gestion/blob/main/app/Models/TrainingModule.php) (Training modules), [`app/Models/Formation.php`](https://github.com/deltawebmaroc/ipaf-gestion/blob/main/app/Models/Formation.php) (Training programs)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_school["School records"]
  node_students["Student records<br/>[Student.php]"]
  node_groups["Student groups<br/>[Group.php]"]
end

subgraph group_planning["Training planning"]
  node_formations["Training programs<br/>[Formation.php]"]
  node_modules["Training modules<br/>[TrainingModule.php]"]
  node_sequences["Training sequences"]
  node_schedules["Timetables<br/>[Schedule.php]"]
  node_classrooms["Classrooms<br/>[Classroom.php]"]
  node_teachers["Teachers<br/>[Teacher.php]"]
  node_scheduleweeks["Schedule weeks<br/>[ScheduleWeek.php]"]
  node_conflictvalidator["Schedule conflict validator"]
end

subgraph group_finance["Finance and reports"]
  node_payments["Payment obligations<br/>[Payment.php]"]
  node_installments["Payment installments"]
  node_expenses["Expenses<br/>[Expense.php]"]
  node_reports["Reports and exports<br/>[Rapports.php]"]
end

subgraph group_documents["Documents"]
  node_templates["Document templates"]
  node_settings["School settings<br/>[SchoolSetting.php]"]
  node_studentdocs["Student documents"]
  node_batchdocs["Batch documents"]
  node_docrenderer["Template renderer"]
  node_docpdf["PDF rendering"]
end

subgraph group_platform["Security and operations"]
  node_security["Access controls"]
  node_audit["Security audit<br/>[Audit.php]"]
  node_operations["Backups and updates"]
end

node_staff(("School staff"))

node_students -->|"creates obligations"| node_payments
node_schedules -->|"checks conflicts"| node_conflictvalidator
node_studentdocs -->|"renders template"| node_docrenderer
node_studentdocs -->|"renders PDF"| node_docpdf
node_batchdocs -->|"checks batch capacity"| node_docpdf
node_staff -.->|"manages records"| node_students
node_staff -.->|"plans classes"| node_schedules
node_staff -.->|"tracks payments"| node_payments
node_staff -.->|"reviews reports"| node_reports
node_staff -.->|"requests documents"| node_studentdocs
node_formations -->|"has groups"| node_groups
node_formations -->|"has modules"| node_modules
node_modules -->|"has sequences"| node_sequences
node_schedules -->|"references"| node_classrooms
node_schedules -->|"references"| node_teachers
node_schedules -->|"references"| node_groups
node_schedules -->|"references"| node_scheduleweeks
node_schedules -->|"references"| node_modules
node_schedules -->|"references"| node_sequences
node_security -.->|"registers policy"| node_audit
node_operations -.->|"supports operator"| node_staff

click node_students "https://github.com/deltawebmaroc/ipaf-gestion/blob/main/app/Models/Student.php"
click node_groups "https://github.com/deltawebmaroc/ipaf-gestion/blob/main/app/Models/Group.php"
click node_formations "https://github.com/deltawebmaroc/ipaf-gestion/blob/main/app/Models/Formation.php"
click node_modules "https://github.com/deltawebmaroc/ipaf-gestion/blob/main/app/Models/TrainingModule.php"
click node_sequences "https://github.com/deltawebmaroc/ipaf-gestion/blob/main/app/Models/TrainingSequence.php"
click node_schedules "https://github.com/deltawebmaroc/ipaf-gestion/blob/main/app/Models/Schedule.php"
click node_classrooms "https://github.com/deltawebmaroc/ipaf-gestion/blob/main/app/Models/Classroom.php"
click node_teachers "https://github.com/deltawebmaroc/ipaf-gestion/blob/main/app/Models/Teacher.php"
click node_scheduleweeks "https://github.com/deltawebmaroc/ipaf-gestion/blob/main/app/Models/ScheduleWeek.php"
click node_payments "https://github.com/deltawebmaroc/ipaf-gestion/blob/main/app/Models/Payment.php"
click node_installments "https://github.com/deltawebmaroc/ipaf-gestion/blob/main/app/Models/PaymentInstallment.php"
click node_expenses "https://github.com/deltawebmaroc/ipaf-gestion/blob/main/app/Models/Expense.php"
click node_reports "https://github.com/deltawebmaroc/ipaf-gestion/blob/main/app/Filament/Pages/Rapports.php"
click node_templates "https://github.com/deltawebmaroc/ipaf-gestion/blob/main/app/Models/DocumentTemplate.php"
click node_settings "https://github.com/deltawebmaroc/ipaf-gestion/blob/main/app/Models/SchoolSetting.php"
click node_studentdocs "https://github.com/deltawebmaroc/ipaf-gestion/blob/main/app/Http/Controllers/StudentDocumentController.php"
click node_batchdocs "https://github.com/deltawebmaroc/ipaf-gestion/blob/main/app/Http/Controllers/StudentDocumentBatchController.php"
click node_docrenderer "https://github.com/deltawebmaroc/ipaf-gestion/blob/main/app/Services/DocumentTemplateRenderer.php"
click node_docpdf "https://github.com/deltawebmaroc/ipaf-gestion/blob/main/app/Services/StudentDocumentPdf.php"
click node_security "https://github.com/deltawebmaroc/ipaf-gestion/blob/main/app/Providers/AppServiceProvider.php"
click node_audit "https://github.com/deltawebmaroc/ipaf-gestion/blob/main/app/Services/Security/Audit.php"
click node_operations "https://github.com/deltawebmaroc/ipaf-gestion/blob/main/app/Http/Controllers/SystemController.php"
click node_conflictvalidator "https://github.com/deltawebmaroc/ipaf-gestion/blob/main/app/Services/ScheduleConflictValidator.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_students,node_groups toneBlue
class node_formations,node_modules,node_sequences,node_schedules,node_classrooms,node_teachers,node_scheduleweeks,node_conflictvalidator toneAmber
class node_payments,node_installments,node_expenses,node_reports toneMint
class node_templates,node_settings,node_studentdocs,node_batchdocs,node_docrenderer,node_docpdf toneRose
class node_security,node_audit,node_operations,node_staff toneIndigo
```

## Components

### School records

- [Student records](https://github.com/deltawebmaroc/ipaf-gestion/blob/main/app/Models/Student.php): `app/Models/Student.php`
- [Student groups](https://github.com/deltawebmaroc/ipaf-gestion/blob/main/app/Models/Group.php): `app/Models/Group.php`

### Training planning

- [Training programs](https://github.com/deltawebmaroc/ipaf-gestion/blob/main/app/Models/Formation.php): `app/Models/Formation.php`
- [Training modules](https://github.com/deltawebmaroc/ipaf-gestion/blob/main/app/Models/TrainingModule.php): `app/Models/TrainingModule.php`
- [Training sequences](https://github.com/deltawebmaroc/ipaf-gestion/blob/main/app/Models/TrainingSequence.php): `app/Models/TrainingSequence.php`
- [Timetables](https://github.com/deltawebmaroc/ipaf-gestion/blob/main/app/Models/Schedule.php): `app/Models/Schedule.php`
- [Classrooms](https://github.com/deltawebmaroc/ipaf-gestion/blob/main/app/Models/Classroom.php): `app/Models/Classroom.php`
- [Teachers](https://github.com/deltawebmaroc/ipaf-gestion/blob/main/app/Models/Teacher.php): `app/Models/Teacher.php`
- [Schedule weeks](https://github.com/deltawebmaroc/ipaf-gestion/blob/main/app/Models/ScheduleWeek.php): `app/Models/ScheduleWeek.php`
- [Schedule conflict validator](https://github.com/deltawebmaroc/ipaf-gestion/blob/main/app/Services/ScheduleConflictValidator.php): `app/Services/ScheduleConflictValidator.php`

### Finance and reports

- [Payment obligations](https://github.com/deltawebmaroc/ipaf-gestion/blob/main/app/Models/Payment.php): `app/Models/Payment.php`
- [Payment installments](https://github.com/deltawebmaroc/ipaf-gestion/blob/main/app/Models/PaymentInstallment.php): `app/Models/PaymentInstallment.php`
- [Expenses](https://github.com/deltawebmaroc/ipaf-gestion/blob/main/app/Models/Expense.php): `app/Models/Expense.php`
- [Reports and exports](https://github.com/deltawebmaroc/ipaf-gestion/blob/main/app/Filament/Pages/Rapports.php): `app/Filament/Pages/Rapports.php`

### Documents

- [Document templates](https://github.com/deltawebmaroc/ipaf-gestion/blob/main/app/Models/DocumentTemplate.php): `app/Models/DocumentTemplate.php`
- [School settings](https://github.com/deltawebmaroc/ipaf-gestion/blob/main/app/Models/SchoolSetting.php): `app/Models/SchoolSetting.php`
- [Student documents](https://github.com/deltawebmaroc/ipaf-gestion/blob/main/app/Http/Controllers/StudentDocumentController.php): `app/Http/Controllers/StudentDocumentController.php`
- [Batch documents](https://github.com/deltawebmaroc/ipaf-gestion/blob/main/app/Http/Controllers/StudentDocumentBatchController.php): `app/Http/Controllers/StudentDocumentBatchController.php`
- [Template renderer](https://github.com/deltawebmaroc/ipaf-gestion/blob/main/app/Services/DocumentTemplateRenderer.php): `app/Services/DocumentTemplateRenderer.php`
- [PDF rendering](https://github.com/deltawebmaroc/ipaf-gestion/blob/main/app/Services/StudentDocumentPdf.php): `app/Services/StudentDocumentPdf.php`

### Security and operations

- [Access controls](https://github.com/deltawebmaroc/ipaf-gestion/blob/main/app/Providers/AppServiceProvider.php): `app/Providers/AppServiceProvider.php`
- [Security audit](https://github.com/deltawebmaroc/ipaf-gestion/blob/main/app/Services/Security/Audit.php): `app/Services/Security/Audit.php`
- [Backups and updates](https://github.com/deltawebmaroc/ipaf-gestion/blob/main/app/Http/Controllers/SystemController.php): `app/Http/Controllers/SystemController.php`

### Other components

- **School staff**

## Connections

- Student records → Payment obligations: creates obligations (evidence: `app/Models/Student.php`)
- Timetables → Schedule conflict validator: checks conflicts (evidence: `app/Models/Schedule.php`)
- Student documents → Template renderer: renders template (evidence: `app/Http/Controllers/StudentDocumentController.php`)
- Student documents → PDF rendering: renders PDF (evidence: `app/Http/Controllers/StudentDocumentController.php`)
- Batch documents → PDF rendering: checks batch capacity (evidence: `app/Http/Controllers/StudentDocumentBatchController.php`)
- School staff → Student records: manages records
- School staff → Timetables: plans classes
- School staff → Payment obligations: tracks payments
- School staff → Reports and exports: reviews reports
- School staff → Student documents: requests documents
- Training programs → Student groups: has groups (evidence: `app/Models/Formation.php`)
- Training programs → Training modules: has modules (evidence: `app/Models/Formation.php`)
- Training modules → Training sequences: has sequences (evidence: `app/Models/TrainingModule.php`)
- Timetables → Classrooms: references (evidence: `app/Models/Schedule.php`)
- Timetables → Teachers: references (evidence: `app/Models/Schedule.php`)
- Timetables → Student groups: references (evidence: `app/Models/Schedule.php`)
- Timetables → Schedule weeks: references (evidence: `app/Models/Schedule.php`)
- Timetables → Training modules: references (evidence: `app/Models/Schedule.php`)
- Timetables → Training sequences: references (evidence: `app/Models/Schedule.php`)
- Access controls → Security audit: registers policy
- Backups and updates → School staff: supports operator
