# tepitech-228/easyecole architecture

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

- Interactive diagram: https://gitdiagram.com/tepitech-228/easyecole
- Repository: https://github.com/tepitech-228/easyecole

## Overview

EasyEcole is a school-management platform with an Angular web client and a modular Express backend. The visible product workflow is role-based access to backend services for enrollment and academic operations, including course scheduling and grade-report generation; the tree also shows e-learning, finance, purchasing, HR, communications, records, and asset-management capabilities. Source evidence is uneven: route registration and several model/controller relationships are visible, but many modules were not sampled, so their internal flows are represented only at module level.

Main entry points: [`easy-ecole-backend/src/routes.ts`](https://github.com/tepitech-228/easyecole/blob/main/easy-ecole-backend/src/routes.ts) (API route registry), [`easy-ecole-backend/src/core/helpers/DatabaseConnection.ts`](https://github.com/tepitech-228/easyecole/blob/main/easy-ecole-backend/src/core/helpers/DatabaseConnection.ts) (SQL database), [`easy-ecole-backend/src/modules/inscription/InscriptionRoutes.ts`](https://github.com/tepitech-228/easyecole/blob/main/easy-ecole-backend/src/modules/inscription/InscriptionRoutes.ts) (Enrollment services), [`easy-ecole-backend/src/modules/auth/controllers/AuthController.ts`](https://github.com/tepitech-228/easyecole/blob/main/easy-ecole-backend/src/modules/auth/controllers/AuthController.ts) (Authentication)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Web client"]
  node_web["Angular application<br/>[app.module.ts]"]
end

subgraph group_platform["Backend platform"]
  node_api["API route registry<br/>[routes.ts]"]
  node_auth["Authentication<br/>[AuthController.ts]"]
  node_identity[("User identities<br/>[Utilisateur.ts]")]
  node_db[("SQL database")]
end

subgraph group_academics["Academic services"]
  node_enrollment["Enrollment services"]
  node_curriculum[("Courses and curricula<br/>[Cours.ts]")]
  node_student_record[("Learner records<br/>[CursusApprenant.ts]")]
  node_schedule["Class scheduling"]
  node_bulletins["Grade reports"]
  node_orientation["Student orientation"]
end

subgraph group_learning["Learning services"]
  node_elearning["Online courses"]
end

subgraph group_operations["Institution operations"]
  node_finance["Accounting and payments"]
  node_purchasing["Purchasing"]
  node_assets["Asset management"]
  node_communications["Communication"]
  node_documents["Document management"]
  node_hr["Human resources"]
  node_school_life["School life"]
end

node_user(("Platform user"))

node_user -.->|"uses"| node_web
node_web -.->|"requests services"| node_api
node_api -->|"routes auth"| node_auth
node_api -->|"routes enrollment"| node_enrollment
node_api -->|"routes orientation"| node_orientation
node_api -->|"routes learning"| node_elearning
node_api -->|"routes accounting"| node_finance
node_api -->|"routes purchasing"| node_purchasing
node_api -->|"routes assets"| node_assets
node_api -->|"routes communication"| node_communications
node_api -->|"routes documents"| node_documents
node_api -->|"routes HR"| node_hr
node_api -->|"routes school life"| node_school_life
node_enrollment -.->|"registers routes"| node_schedule
node_enrollment -->|"applies authentication"| node_auth
node_auth -->|"reads identity"| node_identity
node_identity -->|"uses connection"| node_db
node_curriculum -->|"uses connection"| node_db
node_student_record -->|"uses connection"| node_db
node_schedule -->|"queries courses"| node_curriculum
node_bulletins -->|"reads courses"| node_curriculum
node_bulletins -->|"reads learner records"| node_student_record
node_elearning -.->|"uses connection"| node_db

click node_web "https://github.com/tepitech-228/easyecole/blob/main/easy-ecole-web/src/app/app.module.ts"
click node_api "https://github.com/tepitech-228/easyecole/blob/main/easy-ecole-backend/src/routes.ts"
click node_auth "https://github.com/tepitech-228/easyecole/blob/main/easy-ecole-backend/src/modules/auth/controllers/AuthController.ts"
click node_identity "https://github.com/tepitech-228/easyecole/blob/main/easy-ecole-backend/src/modules/auth/models/Utilisateur.ts"
click node_db "https://github.com/tepitech-228/easyecole/blob/main/easy-ecole-backend/src/core/helpers/DatabaseConnection.ts"
click node_enrollment "https://github.com/tepitech-228/easyecole/blob/main/easy-ecole-backend/src/modules/inscription/InscriptionRoutes.ts"
click node_curriculum "https://github.com/tepitech-228/easyecole/blob/main/easy-ecole-backend/src/modules/inscription/models/Cours.ts"
click node_student_record "https://github.com/tepitech-228/easyecole/blob/main/easy-ecole-backend/src/modules/inscription/models/CursusApprenant.ts"
click node_schedule "https://github.com/tepitech-228/easyecole/blob/main/easy-ecole-backend/src/modules/inscription/controllers/SeanceController.ts"
click node_bulletins "https://github.com/tepitech-228/easyecole/blob/main/easy-ecole-backend/src/modules/bulletins/controllers/BulletinController.ts"
click node_elearning "https://github.com/tepitech-228/easyecole/blob/main/easy-ecole-backend/src/modules/elearning/controllers/CoursEnLigneController.ts"
click node_orientation "https://github.com/tepitech-228/easyecole/blob/main/easy-ecole-backend/src/modules/orientation/controllers/DemandeOrientationController.ts"
click node_finance "https://github.com/tepitech-228/easyecole/tree/main/easy-ecole-backend/src/modules/comptabilite"
click node_purchasing "https://github.com/tepitech-228/easyecole/tree/main/easy-ecole-backend/src/modules/achats"
click node_assets "https://github.com/tepitech-228/easyecole/tree/main/easy-ecole-backend/src/modules/immobilisation"
click node_communications "https://github.com/tepitech-228/easyecole/tree/main/easy-ecole-backend/src/modules/communication"
click node_documents "https://github.com/tepitech-228/easyecole/tree/main/easy-ecole-backend/src/modules/ged"
click node_hr "https://github.com/tepitech-228/easyecole/tree/main/easy-ecole-backend/src/modules/rh"
click node_school_life "https://github.com/tepitech-228/easyecole/tree/main/easy-ecole-backend/src/modules/scolarite"

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_user toneBlue
class node_api,node_auth,node_identity,node_db toneAmber
class node_enrollment,node_curriculum,node_student_record,node_schedule,node_bulletins,node_orientation toneMint
class node_elearning toneRose
class node_finance,node_purchasing,node_assets,node_communications,node_documents,node_hr,node_school_life toneIndigo
```

## Components

### Web client

- [Angular application](https://github.com/tepitech-228/easyecole/blob/main/easy-ecole-web/src/app/app.module.ts): `easy-ecole-web/src/app/app.module.ts`

### Backend platform

- [API route registry](https://github.com/tepitech-228/easyecole/blob/main/easy-ecole-backend/src/routes.ts): `easy-ecole-backend/src/routes.ts`
- [Authentication](https://github.com/tepitech-228/easyecole/blob/main/easy-ecole-backend/src/modules/auth/controllers/AuthController.ts): `easy-ecole-backend/src/modules/auth/controllers/AuthController.ts`
- [User identities](https://github.com/tepitech-228/easyecole/blob/main/easy-ecole-backend/src/modules/auth/models/Utilisateur.ts): `easy-ecole-backend/src/modules/auth/models/Utilisateur.ts`
- [SQL database](https://github.com/tepitech-228/easyecole/blob/main/easy-ecole-backend/src/core/helpers/DatabaseConnection.ts): `easy-ecole-backend/src/core/helpers/DatabaseConnection.ts`

### Academic services

- [Enrollment services](https://github.com/tepitech-228/easyecole/blob/main/easy-ecole-backend/src/modules/inscription/InscriptionRoutes.ts): `easy-ecole-backend/src/modules/inscription/InscriptionRoutes.ts`
- [Courses and curricula](https://github.com/tepitech-228/easyecole/blob/main/easy-ecole-backend/src/modules/inscription/models/Cours.ts): `easy-ecole-backend/src/modules/inscription/models/Cours.ts`
- [Learner records](https://github.com/tepitech-228/easyecole/blob/main/easy-ecole-backend/src/modules/inscription/models/CursusApprenant.ts): `easy-ecole-backend/src/modules/inscription/models/CursusApprenant.ts`
- [Class scheduling](https://github.com/tepitech-228/easyecole/blob/main/easy-ecole-backend/src/modules/inscription/controllers/SeanceController.ts): `easy-ecole-backend/src/modules/inscription/controllers/SeanceController.ts`
- [Grade reports](https://github.com/tepitech-228/easyecole/blob/main/easy-ecole-backend/src/modules/bulletins/controllers/BulletinController.ts): `easy-ecole-backend/src/modules/bulletins/controllers/BulletinController.ts`
- [Student orientation](https://github.com/tepitech-228/easyecole/blob/main/easy-ecole-backend/src/modules/orientation/controllers/DemandeOrientationController.ts): `easy-ecole-backend/src/modules/orientation/controllers/DemandeOrientationController.ts`

### Learning services

- [Online courses](https://github.com/tepitech-228/easyecole/blob/main/easy-ecole-backend/src/modules/elearning/controllers/CoursEnLigneController.ts): `easy-ecole-backend/src/modules/elearning/controllers/CoursEnLigneController.ts`

### Institution operations

- [Accounting and payments](https://github.com/tepitech-228/easyecole/tree/main/easy-ecole-backend/src/modules/comptabilite): `easy-ecole-backend/src/modules/comptabilite`
- [Purchasing](https://github.com/tepitech-228/easyecole/tree/main/easy-ecole-backend/src/modules/achats): `easy-ecole-backend/src/modules/achats`
- [Asset management](https://github.com/tepitech-228/easyecole/tree/main/easy-ecole-backend/src/modules/immobilisation): `easy-ecole-backend/src/modules/immobilisation`
- [Communication](https://github.com/tepitech-228/easyecole/tree/main/easy-ecole-backend/src/modules/communication): `easy-ecole-backend/src/modules/communication`
- [Document management](https://github.com/tepitech-228/easyecole/tree/main/easy-ecole-backend/src/modules/ged): `easy-ecole-backend/src/modules/ged`
- [Human resources](https://github.com/tepitech-228/easyecole/tree/main/easy-ecole-backend/src/modules/rh): `easy-ecole-backend/src/modules/rh`
- [School life](https://github.com/tepitech-228/easyecole/tree/main/easy-ecole-backend/src/modules/scolarite): `easy-ecole-backend/src/modules/scolarite`

### Other components

- **Platform user**

## Connections

- Platform user → Angular application: uses
- Angular application → API route registry: requests services
- API route registry → Authentication: routes auth (evidence: `easy-ecole-backend/src/routes.ts`)
- API route registry → Enrollment services: routes enrollment (evidence: `easy-ecole-backend/src/routes.ts`)
- API route registry → Student orientation: routes orientation (evidence: `easy-ecole-backend/src/routes.ts`)
- API route registry → Online courses: routes learning (evidence: `easy-ecole-backend/src/routes.ts`)
- API route registry → Accounting and payments: routes accounting (evidence: `easy-ecole-backend/src/routes.ts`)
- API route registry → Purchasing: routes purchasing (evidence: `easy-ecole-backend/src/routes.ts`)
- API route registry → Asset management: routes assets (evidence: `easy-ecole-backend/src/routes.ts`)
- API route registry → Communication: routes communication (evidence: `easy-ecole-backend/src/routes.ts`)
- API route registry → Document management: routes documents (evidence: `easy-ecole-backend/src/routes.ts`)
- API route registry → Human resources: routes HR (evidence: `easy-ecole-backend/src/routes.ts`)
- API route registry → School life: routes school life (evidence: `easy-ecole-backend/src/routes.ts`)
- Enrollment services → Class scheduling: registers routes
- Enrollment services → Authentication: applies authentication (evidence: `easy-ecole-backend/src/modules/inscription/InscriptionRoutes.ts`)
- Authentication → User identities: reads identity (evidence: `easy-ecole-backend/src/modules/auth/controllers/AuthController.ts`)
- User identities → SQL database: uses connection (evidence: `easy-ecole-backend/src/modules/auth/models/Utilisateur.ts`)
- Courses and curricula → SQL database: uses connection (evidence: `easy-ecole-backend/src/modules/inscription/models/Cours.ts`)
- Learner records → SQL database: uses connection (evidence: `easy-ecole-backend/src/modules/inscription/models/CursusApprenant.ts`)
- Class scheduling → Courses and curricula: queries courses (evidence: `easy-ecole-backend/src/modules/inscription/controllers/SeanceController.ts`)
- Grade reports → Courses and curricula: reads courses (evidence: `easy-ecole-backend/src/modules/bulletins/controllers/BulletinController.ts`)
- Grade reports → Learner records: reads learner records (evidence: `easy-ecole-backend/src/modules/bulletins/controllers/BulletinController.ts`)
- Online courses → SQL database: uses connection
