# yannickeudes/edupaie architecture

> Architecture diagram of the GitHub repository yannickeudes/edupaie, 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/yannickeudes/edupaie
- Repository: https://github.com/yannickeudes/edupaie

## Overview

EduPaie is a desktop application for managing school fees. A user navigates from the main window to student, payment, history, receipt, or dashboard screens; payment services validate and record payments, while repositories persist student and payment data in SQLite. Receipt generation and dashboard statistics are separate product stages. The graph includes the documented demo-data capability, though its runtime wiring is not established by the excerpts. UI-to-service details and several screens’ internal calls were not sampled, so those links are omitted.

Main entry points: [`ui/main_window.py`](https://github.com/yannickeudes/edupaie/blob/main/ui/main_window.py) (Main window), [`main.py`](https://github.com/yannickeudes/edupaie/blob/main/main.py) (Application setup), [`services/paiement_service.py`](https://github.com/yannickeudes/edupaie/blob/main/services/paiement_service.py) (Payment rules), [`repositories/eleve_repository.py`](https://github.com/yannickeudes/edupaie/blob/main/repositories/eleve_repository.py) (Student repository)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["Desktop interface"]
  node_window["Main window<br/>[main_window.py]"]
  node_students_ui["Student management<br/>[eleves_page.py]"]
  node_payments_ui["Payment entry<br/>[paiements_page.py]"]
  node_history_ui["Payment history<br/>[historique_page.py]"]
  node_receipts_ui["Receipt lookup<br/>[recus_page.py]"]
  node_dashboard_ui["Dashboard screen<br/>[dashboard_page.py]"]
end

subgraph group_services["Domain services"]
  node_student_service["Student rules<br/>[eleve_service.py]"]
  node_payment_service["Payment rules"]
  node_dashboard_service["Dashboard statistics"]
end

subgraph group_data["Persistence"]
  node_student_repo["Student repository"]
  node_payment_repo["Payment repository"]
  node_db_init["Database initialization<br/>[database.py]"]
  node_sqlite[("EduPaie database<br/>[edupaie.db]")]
  node_demo_data["Demo data<br/>[seed.py]"]
end

subgraph group_receipt["Receipt generation"]
  node_receipt_service["PDF receipt generator<br/>[recu_service.py]"]
end

node_user(("School staff"))
node_app["Application setup<br/>[main.py]"]
node_pdf_viewer(("PDF viewer"))

node_user -->|"uses"| node_window
node_app -->|"initializes"| node_db_init
node_app -->|"creates"| node_student_repo
node_app -->|"creates"| node_payment_repo
node_app -->|"creates"| node_payment_service
node_app -->|"creates"| node_student_service
node_app -->|"creates"| node_dashboard_service
node_app -->|"creates"| node_receipt_service
node_app -->|"opens"| node_window
node_window -->|"creates"| node_dashboard_ui
node_window -->|"creates"| node_students_ui
node_window -->|"creates"| node_payments_ui
node_window -->|"creates"| node_history_ui
node_window -->|"creates"| node_receipts_ui
node_window -->|"passes service"| node_dashboard_service
node_window -->|"passes service"| node_student_service
node_window -->|"passes service"| node_payment_service
node_window -->|"passes service"| node_receipt_service
node_student_service -->|"validates through"| node_student_repo
node_student_service -->|"checks totals"| node_payment_service
node_payment_service -->|"reads student"| node_student_repo
node_payment_service -->|"reads and records"| node_payment_repo
node_dashboard_service -->|"lists students"| node_student_repo
node_dashboard_service -->|"calculates balances"| node_payment_service
node_receipts_ui -->|"generates PDF"| node_receipt_service
node_receipts_ui -->|"opens PDF"| node_pdf_viewer
node_db_init -->|"opens database"| node_sqlite
node_student_repo -->|"reads and writes"| node_sqlite
node_payment_repo -->|"reads and writes"| node_sqlite

click node_app "https://github.com/yannickeudes/edupaie/blob/main/main.py"
click node_window "https://github.com/yannickeudes/edupaie/blob/main/ui/main_window.py"
click node_students_ui "https://github.com/yannickeudes/edupaie/blob/main/ui/eleves_page.py"
click node_payments_ui "https://github.com/yannickeudes/edupaie/blob/main/ui/paiements_page.py"
click node_history_ui "https://github.com/yannickeudes/edupaie/blob/main/ui/historique_page.py"
click node_receipts_ui "https://github.com/yannickeudes/edupaie/blob/main/ui/recus_page.py"
click node_dashboard_ui "https://github.com/yannickeudes/edupaie/blob/main/ui/dashboard_page.py"
click node_student_service "https://github.com/yannickeudes/edupaie/blob/main/services/eleve_service.py"
click node_payment_service "https://github.com/yannickeudes/edupaie/blob/main/services/paiement_service.py"
click node_dashboard_service "https://github.com/yannickeudes/edupaie/blob/main/services/dashboard_service.py"
click node_receipt_service "https://github.com/yannickeudes/edupaie/blob/main/services/recu_service.py"
click node_student_repo "https://github.com/yannickeudes/edupaie/blob/main/repositories/eleve_repository.py"
click node_payment_repo "https://github.com/yannickeudes/edupaie/blob/main/repositories/paiement_repository.py"
click node_db_init "https://github.com/yannickeudes/edupaie/blob/main/database/database.py"
click node_sqlite "https://github.com/yannickeudes/edupaie/blob/main/database/edupaie.db"
click node_demo_data "https://github.com/yannickeudes/edupaie/blob/main/database/seed.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_window,node_students_ui,node_payments_ui,node_history_ui,node_receipts_ui,node_dashboard_ui,node_pdf_viewer toneBlue
class node_student_service,node_payment_service,node_dashboard_service toneAmber
class node_student_repo,node_payment_repo,node_db_init,node_sqlite,node_demo_data toneMint
class node_receipt_service toneRose
class node_user toneIndigo
class node_app toneTeal
```

## Components

### Desktop interface

- [Main window](https://github.com/yannickeudes/edupaie/blob/main/ui/main_window.py): `ui/main_window.py`
- [Student management](https://github.com/yannickeudes/edupaie/blob/main/ui/eleves_page.py): `ui/eleves_page.py`
- [Payment entry](https://github.com/yannickeudes/edupaie/blob/main/ui/paiements_page.py): `ui/paiements_page.py`
- [Payment history](https://github.com/yannickeudes/edupaie/blob/main/ui/historique_page.py): `ui/historique_page.py`
- [Receipt lookup](https://github.com/yannickeudes/edupaie/blob/main/ui/recus_page.py): `ui/recus_page.py`
- [Dashboard screen](https://github.com/yannickeudes/edupaie/blob/main/ui/dashboard_page.py): `ui/dashboard_page.py`

### Domain services

- [Student rules](https://github.com/yannickeudes/edupaie/blob/main/services/eleve_service.py): `services/eleve_service.py`
- [Payment rules](https://github.com/yannickeudes/edupaie/blob/main/services/paiement_service.py): `services/paiement_service.py`
- [Dashboard statistics](https://github.com/yannickeudes/edupaie/blob/main/services/dashboard_service.py): `services/dashboard_service.py`

### Persistence

- [Student repository](https://github.com/yannickeudes/edupaie/blob/main/repositories/eleve_repository.py): `repositories/eleve_repository.py`
- [Payment repository](https://github.com/yannickeudes/edupaie/blob/main/repositories/paiement_repository.py): `repositories/paiement_repository.py`
- [Database initialization](https://github.com/yannickeudes/edupaie/blob/main/database/database.py): `database/database.py`
- [EduPaie database](https://github.com/yannickeudes/edupaie/blob/main/database/edupaie.db): `database/edupaie.db`
- [Demo data](https://github.com/yannickeudes/edupaie/blob/main/database/seed.py): `database/seed.py`

### Receipt generation

- [PDF receipt generator](https://github.com/yannickeudes/edupaie/blob/main/services/recu_service.py): `services/recu_service.py`

### Other components

- **School staff**
- [Application setup](https://github.com/yannickeudes/edupaie/blob/main/main.py): `main.py`
- **PDF viewer**

## Connections

- School staff → Main window: uses (evidence: `README.md`)
- Application setup → Database initialization: initializes (evidence: `main.py`)
- Application setup → Student repository: creates (evidence: `main.py`)
- Application setup → Payment repository: creates (evidence: `main.py`)
- Application setup → Payment rules: creates (evidence: `main.py`)
- Application setup → Student rules: creates (evidence: `main.py`)
- Application setup → Dashboard statistics: creates (evidence: `main.py`)
- Application setup → PDF receipt generator: creates (evidence: `main.py`)
- Application setup → Main window: opens (evidence: `main.py`)
- Main window → Dashboard screen: creates (evidence: `ui/main_window.py`)
- Main window → Student management: creates (evidence: `ui/main_window.py`)
- Main window → Payment entry: creates (evidence: `ui/main_window.py`)
- Main window → Payment history: creates (evidence: `ui/main_window.py`)
- Main window → Receipt lookup: creates (evidence: `ui/main_window.py`)
- Main window → Dashboard statistics: passes service (evidence: `ui/main_window.py`)
- Main window → Student rules: passes service (evidence: `ui/main_window.py`)
- Main window → Payment rules: passes service (evidence: `ui/main_window.py`)
- Main window → PDF receipt generator: passes service (evidence: `ui/main_window.py`)
- Student rules → Student repository: validates through (evidence: `services/eleve_service.py`)
- Student rules → Payment rules: checks totals (evidence: `services/eleve_service.py`)
- Payment rules → Student repository: reads student (evidence: `services/paiement_service.py`)
- Payment rules → Payment repository: reads and records (evidence: `services/paiement_service.py`)
- Dashboard statistics → Student repository: lists students (evidence: `services/dashboard_service.py`)
- Dashboard statistics → Payment rules: calculates balances (evidence: `services/dashboard_service.py`)
- Receipt lookup → PDF receipt generator: generates PDF (evidence: `ui/recus_page.py`)
- Receipt lookup → PDF viewer: opens PDF (evidence: `ui/recus_page.py`)
- Database initialization → EduPaie database: opens database (evidence: `database/database.py`)
- Student repository → EduPaie database: reads and writes (evidence: `repositories/eleve_repository.py`)
- Payment repository → EduPaie database: reads and writes (evidence: `repositories/paiement_repository.py`)
