# spireza/project-oop architecture

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

## Overview

This is a Java desktop student-fund manager. Users maintain student rosters, record monthly contributions and mission expenses, and review fund summaries; student CSV import/export is another documented-in-code workflow. Services enforce payment and expense rules over a repository abstraction, with CSV, serialized-file, and in-memory implementations. The source index confirms the principal UI-to-service references and MainFrame’s repository/report references; some unsampled wiring and persistence details are therefore left out.

Main entry points: [`project_oop/src/project_oop/ui/MainFrame.java`](https://github.com/spireza/project-oop/blob/main/project_oop/src/project_oop/ui/MainFrame.java) (Main window), [`project_oop/src/project_oop/FundRepository.java`](https://github.com/spireza/project-oop/blob/main/project_oop/src/project_oop/FundRepository.java) (Repository contract), [`project_oop/src/project_oop/ReportService.java`](https://github.com/spireza/project-oop/blob/main/project_oop/src/project_oop/ReportService.java) (Report service), [`project_oop/src/project_oop/ui/PaymentPanel.java`](https://github.com/spireza/project-oop/blob/main/project_oop/src/project_oop/ui/PaymentPanel.java) (Payment screen)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_desktop["Desktop UI"]
  node_main["Main window<br/>[MainFrame.java]"]
  node_payments_ui["Payment screen<br/>[PaymentPanel.java]"]
  node_missions_ui["Mission screen<br/>[MissionPanel.java]"]
  node_overview["Fund overview<br/>[OverviewPanel.java]"]
  node_student_csv["Student CSV"]
end

subgraph group_workflows["Fund workflows"]
  node_payment_service["Payment service"]
  node_mission_service["Mission service"]
  node_student_service["Student service"]
  node_report_service["Report service<br/>[ReportService.java]"]
end

subgraph group_domain["Domain records"]
  node_student["Student record<br/>[Student.java]"]
  node_monthly_payment["Monthly payment"]
  node_mission_expense["Mission expense"]
end

subgraph group_storage["Repository storage"]
  node_repository["Repository contract"]
  node_csv_repository[("CSV repository")]
  node_file_repository[("File repository")]
  node_memory_repository[("Memory repository")]
end

node_operator(("Fund operator"))

node_operator -->|"opens"| node_main
node_main -->|"selects repository"| node_csv_repository
node_main -->|"selects repository"| node_file_repository
node_main -->|"selects repository"| node_memory_repository
node_main -->|"uses"| node_report_service
node_main -->|"opens"| node_student_csv
node_payments_ui -->|"invokes"| node_payment_service
node_payments_ui -->|"reads and writes"| node_repository
node_missions_ui -->|"invokes"| node_mission_service
node_missions_ui -->|"reads and writes"| node_repository
node_overview -->|"requests summaries"| node_report_service
node_overview -->|"reads"| node_repository
node_student_csv -->|"imports and exports"| node_repository
node_payment_service -->|"validates and records"| node_repository
node_mission_service -->|"records expenses"| node_repository
node_report_service -->|"reads totals"| node_repository

click node_main "https://github.com/spireza/project-oop/blob/main/project_oop/src/project_oop/ui/MainFrame.java"
click node_payments_ui "https://github.com/spireza/project-oop/blob/main/project_oop/src/project_oop/ui/PaymentPanel.java"
click node_missions_ui "https://github.com/spireza/project-oop/blob/main/project_oop/src/project_oop/ui/MissionPanel.java"
click node_overview "https://github.com/spireza/project-oop/blob/main/project_oop/src/project_oop/ui/OverviewPanel.java"
click node_student_csv "https://github.com/spireza/project-oop/blob/main/project_oop/src/project_oop/ui/StudentCsvPanel.java"
click node_payment_service "https://github.com/spireza/project-oop/blob/main/project_oop/src/project_oop/PaymentService.java"
click node_mission_service "https://github.com/spireza/project-oop/blob/main/project_oop/src/project_oop/MissionService.java"
click node_student_service "https://github.com/spireza/project-oop/blob/main/project_oop/src/project_oop/StudentService.java"
click node_report_service "https://github.com/spireza/project-oop/blob/main/project_oop/src/project_oop/ReportService.java"
click node_student "https://github.com/spireza/project-oop/blob/main/project_oop/src/project_oop/Student.java"
click node_monthly_payment "https://github.com/spireza/project-oop/blob/main/project_oop/src/project_oop/MonthlyPayment.java"
click node_mission_expense "https://github.com/spireza/project-oop/blob/main/project_oop/src/project_oop/MissionExpense.java"
click node_repository "https://github.com/spireza/project-oop/blob/main/project_oop/src/project_oop/FundRepository.java"
click node_csv_repository "https://github.com/spireza/project-oop/blob/main/project_oop/src/project_oop/CsvFundRepository.java"
click node_file_repository "https://github.com/spireza/project-oop/blob/main/project_oop/src/project_oop/FileFundRepository.java"
click node_memory_repository "https://github.com/spireza/project-oop/blob/main/project_oop/src/project_oop/InMemoryFundRepository.java"

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_main,node_payments_ui,node_missions_ui,node_overview,node_student_csv toneBlue
class node_payment_service,node_mission_service,node_student_service,node_report_service toneAmber
class node_student,node_monthly_payment,node_mission_expense toneMint
class node_repository,node_csv_repository,node_file_repository,node_memory_repository toneRose
class node_operator toneIndigo
```

## Components

### Desktop UI

- [Main window](https://github.com/spireza/project-oop/blob/main/project_oop/src/project_oop/ui/MainFrame.java): `project_oop/src/project_oop/ui/MainFrame.java`
- [Payment screen](https://github.com/spireza/project-oop/blob/main/project_oop/src/project_oop/ui/PaymentPanel.java): `project_oop/src/project_oop/ui/PaymentPanel.java`
- [Mission screen](https://github.com/spireza/project-oop/blob/main/project_oop/src/project_oop/ui/MissionPanel.java): `project_oop/src/project_oop/ui/MissionPanel.java`
- [Fund overview](https://github.com/spireza/project-oop/blob/main/project_oop/src/project_oop/ui/OverviewPanel.java): `project_oop/src/project_oop/ui/OverviewPanel.java`
- [Student CSV](https://github.com/spireza/project-oop/blob/main/project_oop/src/project_oop/ui/StudentCsvPanel.java): `project_oop/src/project_oop/ui/StudentCsvPanel.java`

### Fund workflows

- [Payment service](https://github.com/spireza/project-oop/blob/main/project_oop/src/project_oop/PaymentService.java): `project_oop/src/project_oop/PaymentService.java`
- [Mission service](https://github.com/spireza/project-oop/blob/main/project_oop/src/project_oop/MissionService.java): `project_oop/src/project_oop/MissionService.java`
- [Student service](https://github.com/spireza/project-oop/blob/main/project_oop/src/project_oop/StudentService.java): `project_oop/src/project_oop/StudentService.java`
- [Report service](https://github.com/spireza/project-oop/blob/main/project_oop/src/project_oop/ReportService.java): `project_oop/src/project_oop/ReportService.java`

### Domain records

- [Student record](https://github.com/spireza/project-oop/blob/main/project_oop/src/project_oop/Student.java): `project_oop/src/project_oop/Student.java`
- [Monthly payment](https://github.com/spireza/project-oop/blob/main/project_oop/src/project_oop/MonthlyPayment.java): `project_oop/src/project_oop/MonthlyPayment.java`
- [Mission expense](https://github.com/spireza/project-oop/blob/main/project_oop/src/project_oop/MissionExpense.java): `project_oop/src/project_oop/MissionExpense.java`

### Repository storage

- [Repository contract](https://github.com/spireza/project-oop/blob/main/project_oop/src/project_oop/FundRepository.java): `project_oop/src/project_oop/FundRepository.java`
- [CSV repository](https://github.com/spireza/project-oop/blob/main/project_oop/src/project_oop/CsvFundRepository.java): `project_oop/src/project_oop/CsvFundRepository.java`
- [File repository](https://github.com/spireza/project-oop/blob/main/project_oop/src/project_oop/FileFundRepository.java): `project_oop/src/project_oop/FileFundRepository.java`
- [Memory repository](https://github.com/spireza/project-oop/blob/main/project_oop/src/project_oop/InMemoryFundRepository.java): `project_oop/src/project_oop/InMemoryFundRepository.java`

### Other components

- **Fund operator**

## Connections

- Fund operator → Main window: opens
- Main window → CSV repository: selects repository (evidence: `project_oop/src/project_oop/ui/MainFrame.java`)
- Main window → File repository: selects repository (evidence: `project_oop/src/project_oop/ui/MainFrame.java`)
- Main window → Memory repository: selects repository (evidence: `project_oop/src/project_oop/ui/MainFrame.java`)
- Main window → Report service: uses (evidence: `project_oop/src/project_oop/ui/MainFrame.java`)
- Main window → Student CSV: opens (evidence: `project_oop/src/project_oop/ui/MainFrame.java`)
- Payment screen → Payment service: invokes (evidence: `project_oop/src/project_oop/ui/PaymentPanel.java`)
- Payment screen → Repository contract: reads and writes (evidence: `project_oop/src/project_oop/ui/PaymentPanel.java`)
- Mission screen → Mission service: invokes (evidence: `project_oop/src/project_oop/ui/MissionPanel.java`)
- Mission screen → Repository contract: reads and writes (evidence: `project_oop/src/project_oop/ui/MissionPanel.java`)
- Fund overview → Report service: requests summaries (evidence: `project_oop/src/project_oop/ui/OverviewPanel.java`)
- Fund overview → Repository contract: reads (evidence: `project_oop/src/project_oop/ui/OverviewPanel.java`)
- Student CSV → Repository contract: imports and exports (evidence: `project_oop/src/project_oop/ui/StudentCsvPanel.java`)
- Payment service → Repository contract: validates and records (evidence: `project_oop/src/project_oop/PaymentService.java`)
- Mission service → Repository contract: records expenses (evidence: `project_oop/src/project_oop/MissionService.java`)
- Report service → Repository contract: reads totals (evidence: `project_oop/src/project_oop/ReportService.java`)
