# einstein1er/schoolsecure architecture

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

- Interactive diagram: https://gitdiagram.com/einstein1er/schoolsecure
- Repository: https://github.com/einstein1er/schoolsecure

## Overview

SchoolSecure is an offline, multi-role school-management desktop app. A user launches the PySide6 interface, signs in, and reaches a role-specific workspace; key flows include maintaining student records, recording validated payments and issuing verifiable receipts, and accessing role-specific course and student views. The graph includes the documented HR, permissions, dashboards, audit, and security capabilities. Edges rely on README statements or SOURCE INDEX references; unsampled modules are included where documented, but uncertain wiring is omitted.

Main entry points: [`app/ui/main_window.py`](https://github.com/einstein1er/schoolsecure/blob/main/app/ui/main_window.py) (Role workspace), [`app/repositories/paiements_repository.py`](https://github.com/einstein1er/schoolsecure/blob/main/app/repositories/paiements_repository.py) (Payment records), [`app/ui/eleve_fiche_dialog.py`](https://github.com/einstein1er/schoolsecure/blob/main/app/ui/eleve_fiche_dialog.py) (Student details), [`app/business/eleve_service.py`](https://github.com/einstein1er/schoolsecure/blob/main/app/business/eleve_service.py) (Student summaries)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interface["Desktop interface"]
  node_entry["Application entry<br/>[main.py]"]
  node_login["Role login<br/>[login_window.py]"]
  node_workspace["Role workspace<br/>[main_window.py]"]
  node_dashboards["Role dashboards"]
end

subgraph group_records["Student records"]
  node_student_list["Student list"]
  node_student_form["Student form"]
  node_student_detail["Student details"]
  node_student_service["Student summaries<br/>[eleve_service.py]"]
  node_student_data["Student records"]
  node_classes["Class records"]
end

subgraph group_finance["Payments and receipts"]
  node_payments_ui["Payment form"]
  node_payments["Payment records"]
  node_balances["Balance rules<br/>[soldes.py]"]
  node_receipts["Receipt PDF<br/>[recu_pdf.py]"]
  node_receipt_verification["Receipt verification"]
end

subgraph group_school["School operations"]
  node_courses["Course access"]
  node_teacher_courses["Teacher courses"]
  node_course_files["Course files"]
  node_hr["HR management"]
end

subgraph group_platform["Persistence and security"]
  node_permissions["Role permissions"]
  node_audit["Audit log"]
  node_users["User accounts"]
  node_crypto["Data encryption<br/>[crypto_utils.py]"]
  node_database[("SQLite connection<br/>[db_connection.py]")]
end

node_user(("School user"))

node_user -->|"launches"| node_entry
node_entry -->|"opens"| node_login
node_login -->|"verifies credentials"| node_users
node_entry -->|"opens"| node_workspace
node_workspace -->|"routes roles"| node_student_list
node_workspace -->|"routes roles"| node_dashboards
node_workspace -->|"routes roles"| node_courses
node_workspace -->|"routes roles"| node_teacher_courses
node_workspace -->|"checks access"| node_permissions
node_workspace -.->|"offers HR access"| node_hr
node_workspace -->|"offers audit view"| node_audit
node_student_list -->|"loads summaries"| node_student_service
node_student_list -->|"opens"| node_student_form
node_student_list -->|"opens"| node_student_detail
node_student_form -->|"writes records"| node_student_data
node_student_detail -->|"loads summary"| node_student_service
node_student_detail -->|"loads class"| node_classes
node_student_detail -->|"opens"| node_payments_ui
node_student_service -->|"reads students"| node_student_data
node_student_service -->|"reads payments"| node_payments
node_student_service -->|"calculates status"| node_balances
node_payments_ui -->|"records payment"| node_payments
node_payments -->|"validates amount"| node_balances
node_payments -->|"creates hash"| node_receipt_verification
node_payments -->|"logs payment"| node_audit
node_student_detail -->|"exports receipt"| node_receipts
node_courses -->|"accesses files"| node_course_files
node_teacher_courses -->|"stores files"| node_course_files
node_student_data -->|"encrypts fields"| node_crypto
node_users -->|"encrypts account data"| node_crypto
node_student_data -->|"reads and writes"| node_database
node_payments -->|"reads and writes"| node_database
node_permissions -->|"reads and writes"| node_database
node_audit -->|"reads and writes"| node_database
node_users -->|"reads and writes"| node_database

click node_entry "https://github.com/einstein1er/schoolsecure/blob/main/main.py"
click node_login "https://github.com/einstein1er/schoolsecure/blob/main/app/ui/login_window.py"
click node_workspace "https://github.com/einstein1er/schoolsecure/blob/main/app/ui/main_window.py"
click node_student_list "https://github.com/einstein1er/schoolsecure/blob/main/app/ui/eleves_liste_widget.py"
click node_student_form "https://github.com/einstein1er/schoolsecure/blob/main/app/ui/eleve_form_dialog.py"
click node_student_detail "https://github.com/einstein1er/schoolsecure/blob/main/app/ui/eleve_fiche_dialog.py"
click node_student_service "https://github.com/einstein1er/schoolsecure/blob/main/app/business/eleve_service.py"
click node_student_data "https://github.com/einstein1er/schoolsecure/blob/main/app/repositories/eleves_repository.py"
click node_classes "https://github.com/einstein1er/schoolsecure/blob/main/app/repositories/classes_repository.py"
click node_payments_ui "https://github.com/einstein1er/schoolsecure/blob/main/app/ui/paiement_form_dialog.py"
click node_payments "https://github.com/einstein1er/schoolsecure/blob/main/app/repositories/paiements_repository.py"
click node_balances "https://github.com/einstein1er/schoolsecure/blob/main/app/business/soldes.py"
click node_receipts "https://github.com/einstein1er/schoolsecure/blob/main/app/business/recu_pdf.py"
click node_receipt_verification "https://github.com/einstein1er/schoolsecure/blob/main/app/business/hash_verification.py"
click node_dashboards "https://github.com/einstein1er/schoolsecure/blob/main/app/ui/tableau_bord_widget.py"
click node_courses "https://github.com/einstein1er/schoolsecure/blob/main/app/ui/cours_eleve_widget.py"
click node_teacher_courses "https://github.com/einstein1er/schoolsecure/blob/main/app/ui/cours_prof_widget.py"
click node_course_files "https://github.com/einstein1er/schoolsecure/blob/main/app/business/stockage_fichiers.py"
click node_hr "https://github.com/einstein1er/schoolsecure/blob/main/app/repositories/employes_rh_repository.py"
click node_permissions "https://github.com/einstein1er/schoolsecure/blob/main/app/repositories/permissions_repository.py"
click node_audit "https://github.com/einstein1er/schoolsecure/blob/main/app/repositories/audit_log_repository.py"
click node_users "https://github.com/einstein1er/schoolsecure/blob/main/app/repositories/users_repository.py"
click node_crypto "https://github.com/einstein1er/schoolsecure/blob/main/app/security/crypto_utils.py"
click node_database "https://github.com/einstein1er/schoolsecure/blob/main/app/database/db_connection.py"

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_entry,node_login,node_workspace,node_dashboards,node_user toneBlue
class node_student_list,node_student_form,node_student_detail,node_student_service,node_student_data,node_classes toneAmber
class node_payments_ui,node_payments,node_balances,node_receipts,node_receipt_verification toneMint
class node_courses,node_teacher_courses,node_course_files,node_hr toneRose
class node_permissions,node_audit,node_users,node_crypto,node_database toneIndigo
```

## Components

### Desktop interface

- [Application entry](https://github.com/einstein1er/schoolsecure/blob/main/main.py): `main.py`
- [Role login](https://github.com/einstein1er/schoolsecure/blob/main/app/ui/login_window.py): `app/ui/login_window.py`
- [Role workspace](https://github.com/einstein1er/schoolsecure/blob/main/app/ui/main_window.py): `app/ui/main_window.py`
- [Role dashboards](https://github.com/einstein1er/schoolsecure/blob/main/app/ui/tableau_bord_widget.py): `app/ui/tableau_bord_widget.py`

### Student records

- [Student list](https://github.com/einstein1er/schoolsecure/blob/main/app/ui/eleves_liste_widget.py): `app/ui/eleves_liste_widget.py`
- [Student form](https://github.com/einstein1er/schoolsecure/blob/main/app/ui/eleve_form_dialog.py): `app/ui/eleve_form_dialog.py`
- [Student details](https://github.com/einstein1er/schoolsecure/blob/main/app/ui/eleve_fiche_dialog.py): `app/ui/eleve_fiche_dialog.py`
- [Student summaries](https://github.com/einstein1er/schoolsecure/blob/main/app/business/eleve_service.py): `app/business/eleve_service.py`
- [Student records](https://github.com/einstein1er/schoolsecure/blob/main/app/repositories/eleves_repository.py): `app/repositories/eleves_repository.py`
- [Class records](https://github.com/einstein1er/schoolsecure/blob/main/app/repositories/classes_repository.py): `app/repositories/classes_repository.py`

### Payments and receipts

- [Payment form](https://github.com/einstein1er/schoolsecure/blob/main/app/ui/paiement_form_dialog.py): `app/ui/paiement_form_dialog.py`
- [Payment records](https://github.com/einstein1er/schoolsecure/blob/main/app/repositories/paiements_repository.py): `app/repositories/paiements_repository.py`
- [Balance rules](https://github.com/einstein1er/schoolsecure/blob/main/app/business/soldes.py): `app/business/soldes.py`
- [Receipt PDF](https://github.com/einstein1er/schoolsecure/blob/main/app/business/recu_pdf.py): `app/business/recu_pdf.py`
- [Receipt verification](https://github.com/einstein1er/schoolsecure/blob/main/app/business/hash_verification.py): `app/business/hash_verification.py`

### School operations

- [Course access](https://github.com/einstein1er/schoolsecure/blob/main/app/ui/cours_eleve_widget.py): `app/ui/cours_eleve_widget.py`
- [Teacher courses](https://github.com/einstein1er/schoolsecure/blob/main/app/ui/cours_prof_widget.py): `app/ui/cours_prof_widget.py`
- [Course files](https://github.com/einstein1er/schoolsecure/blob/main/app/business/stockage_fichiers.py): `app/business/stockage_fichiers.py`
- [HR management](https://github.com/einstein1er/schoolsecure/blob/main/app/repositories/employes_rh_repository.py): `app/repositories/employes_rh_repository.py`

### Persistence and security

- [Role permissions](https://github.com/einstein1er/schoolsecure/blob/main/app/repositories/permissions_repository.py): `app/repositories/permissions_repository.py`
- [Audit log](https://github.com/einstein1er/schoolsecure/blob/main/app/repositories/audit_log_repository.py): `app/repositories/audit_log_repository.py`
- [User accounts](https://github.com/einstein1er/schoolsecure/blob/main/app/repositories/users_repository.py): `app/repositories/users_repository.py`
- [Data encryption](https://github.com/einstein1er/schoolsecure/blob/main/app/security/crypto_utils.py): `app/security/crypto_utils.py`
- [SQLite connection](https://github.com/einstein1er/schoolsecure/blob/main/app/database/db_connection.py): `app/database/db_connection.py`

### Other components

- **School user**

## Connections

- School user → Application entry: launches (evidence: `README.md`)
- Application entry → Role login: opens (evidence: `main.py`)
- Role login → User accounts: verifies credentials (evidence: `app/ui/login_window.py`)
- Application entry → Role workspace: opens (evidence: `main.py`)
- Role workspace → Student list: routes roles (evidence: `app/ui/main_window.py`)
- Role workspace → Role dashboards: routes roles (evidence: `app/ui/main_window.py`)
- Role workspace → Course access: routes roles (evidence: `app/ui/main_window.py`)
- Role workspace → Teacher courses: routes roles (evidence: `app/ui/main_window.py`)
- Role workspace → Role permissions: checks access (evidence: `app/ui/main_window.py`)
- Role workspace → HR management: offers HR access
- Role workspace → Audit log: offers audit view (evidence: `app/ui/main_window.py`)
- Student list → Student summaries: loads summaries (evidence: `app/ui/eleves_liste_widget.py`)
- Student list → Student form: opens (evidence: `app/ui/eleves_liste_widget.py`)
- Student list → Student details: opens (evidence: `app/ui/eleves_liste_widget.py`)
- Student form → Student records: writes records (evidence: `app/ui/eleve_form_dialog.py`)
- Student details → Student summaries: loads summary (evidence: `app/ui/eleve_fiche_dialog.py`)
- Student details → Class records: loads class (evidence: `app/ui/eleve_fiche_dialog.py`)
- Student details → Payment form: opens (evidence: `app/ui/eleve_fiche_dialog.py`)
- Student summaries → Student records: reads students (evidence: `app/business/eleve_service.py`)
- Student summaries → Payment records: reads payments (evidence: `app/business/eleve_service.py`)
- Student summaries → Balance rules: calculates status (evidence: `app/business/eleve_service.py`)
- Payment form → Payment records: records payment (evidence: `app/ui/paiement_form_dialog.py`)
- Payment records → Balance rules: validates amount (evidence: `app/repositories/paiements_repository.py`)
- Payment records → Receipt verification: creates hash (evidence: `app/repositories/paiements_repository.py`)
- Payment records → Audit log: logs payment (evidence: `app/repositories/paiements_repository.py`)
- Student details → Receipt PDF: exports receipt (evidence: `app/ui/eleve_fiche_dialog.py`)
- Course access → Course files: accesses files (evidence: `app/ui/cours_eleve_widget.py`)
- Teacher courses → Course files: stores files
- Student records → Data encryption: encrypts fields (evidence: `app/repositories/eleves_repository.py`)
- User accounts → Data encryption: encrypts account data (evidence: `app/repositories/users_repository.py`)
- Student records → SQLite connection: reads and writes (evidence: `app/repositories/eleves_repository.py`)
- Payment records → SQLite connection: reads and writes (evidence: `app/repositories/paiements_repository.py`)
- Role permissions → SQLite connection: reads and writes (evidence: `app/repositories/permissions_repository.py`)
- Audit log → SQLite connection: reads and writes (evidence: `app/repositories/audit_log_repository.py`)
- User accounts → SQLite connection: reads and writes (evidence: `app/repositories/users_repository.py`)
