# hei-school/tsinjo architecture

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

- Interactive diagram: https://gitdiagram.com/hei-school/tsinjo
- Repository: https://github.com/hei-school/tsinjo

## Overview

Tsinjo is a web application for recording donations and assistance events and displaying their history. The main user flow is authenticated donation-form submission, event creation, and later history retrieval with pending payment resolution through Vola. The tree and excerpts support the controller/service/repository path and the Vola client boundary; README provides no capability details, and unsampled implementation links are omitted where they cannot be verified.

Main entry points: [`src/main/java/school/hei/tsinjo/endpoint/http/TsinjoController.java`](https://github.com/hei-school/tsinjo/blob/preprod/src/main/java/school/hei/tsinjo/endpoint/http/TsinjoController.java) (Web controller), [`src/main/java/school/hei/tsinjo/service/DonationFormService.java`](https://github.com/hei-school/tsinjo/blob/preprod/src/main/java/school/hei/tsinjo/service/DonationFormService.java) (Form prefill), [`src/main/java/school/hei/tsinjo/repository/EventRepository.java`](https://github.com/hei-school/tsinjo/blob/preprod/src/main/java/school/hei/tsinjo/repository/EventRepository.java) (Event repository), [`src/main/java/school/hei/tsinjo/service/EventService.java`](https://github.com/hei-school/tsinjo/blob/preprod/src/main/java/school/hei/tsinjo/service/EventService.java) (Event service)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web interface"]
  node_controller["Web controller"]
  node_donation_form["Donation form"]
  node_event_view["Event view model<br/>[ThEvent.java]"]
  node_fund_view["Fund summary<br/>[ThFund.java]"]
end

subgraph group_services["Event services"]
  node_form_service["Form prefill"]
  node_form_consumer["Donation submission"]
  node_event_service["Event service<br/>[EventService.java]"]
end

subgraph group_domain["Domain and persistence"]
  node_event_domain["Event domain<br/>[Event.java]"]
  node_payment_domain["Payment domain<br/>[Payment.java]"]
  node_event_repo["Event repository"]
  node_payment_repo["Payment repository"]
  node_user_repo["User repository"]
  node_event_jpa[("Event JPA store")]
  node_payment_jpa[("Payment JPA store")]
  node_user_jpa[("User JPA store")]
end

subgraph group_payments["Payment integration"]
  node_vola_psp["Vola PSP adapter<br/>[VolaPsp.java]"]
  node_vola_client["Vola client<br/>[VolaClient.java]"]
  node_payment_api["Payment API client"]
end

node_visitor(("Visitor"))
node_vola_service{{"Vola service"}}

node_visitor -->|"uses"| node_controller
node_controller -->|"prefills via"| node_form_service
node_controller -->|"submits to"| node_form_consumer
node_controller -->|"loads events"| node_event_service
node_controller -->|"renders as"| node_event_view
node_controller -->|"summarizes as"| node_fund_view
node_form_service -->|"loads events"| node_event_service
node_form_service -->|"maps to"| node_event_view
node_form_service -->|"creates"| node_donation_form
node_event_service -->|"reads and saves"| node_event_repo
node_event_service -->|"resolves payments"| node_vola_psp
node_event_repo -->|"persists events"| node_event_jpa
node_event_repo -->|"saves payment"| node_payment_repo
node_event_repo -->|"saves user"| node_user_repo
node_payment_repo -->|"stores payments"| node_payment_jpa
node_user_repo -->|"stores users"| node_user_jpa
node_vola_client -->|"calls"| node_payment_api
node_payment_api -.->|"sends HTTP requests"| node_vola_service

click node_controller "https://github.com/hei-school/tsinjo/blob/preprod/src/main/java/school/hei/tsinjo/endpoint/http/TsinjoController.java"
click node_donation_form "https://github.com/hei-school/tsinjo/blob/preprod/src/main/java/school/hei/tsinjo/endpoint/http/model/DonationCreationForm.java"
click node_event_view "https://github.com/hei-school/tsinjo/blob/preprod/src/main/java/school/hei/tsinjo/endpoint/http/model/ThEvent.java"
click node_fund_view "https://github.com/hei-school/tsinjo/blob/preprod/src/main/java/school/hei/tsinjo/endpoint/http/model/ThFund.java"
click node_form_service "https://github.com/hei-school/tsinjo/blob/preprod/src/main/java/school/hei/tsinjo/service/DonationFormService.java"
click node_form_consumer "https://github.com/hei-school/tsinjo/blob/preprod/src/main/java/school/hei/tsinjo/service/DonationCreationFormConsumer.java"
click node_event_service "https://github.com/hei-school/tsinjo/blob/preprod/src/main/java/school/hei/tsinjo/service/EventService.java"
click node_event_domain "https://github.com/hei-school/tsinjo/blob/preprod/src/main/java/school/hei/tsinjo/model/Event.java"
click node_payment_domain "https://github.com/hei-school/tsinjo/blob/preprod/src/main/java/school/hei/tsinjo/model/Payment.java"
click node_event_repo "https://github.com/hei-school/tsinjo/blob/preprod/src/main/java/school/hei/tsinjo/repository/EventRepository.java"
click node_payment_repo "https://github.com/hei-school/tsinjo/blob/preprod/src/main/java/school/hei/tsinjo/repository/PaymentRepository.java"
click node_user_repo "https://github.com/hei-school/tsinjo/blob/preprod/src/main/java/school/hei/tsinjo/repository/UserRepository.java"
click node_event_jpa "https://github.com/hei-school/tsinjo/blob/preprod/src/main/java/school/hei/tsinjo/repository/jpa/JEventRepository.java"
click node_payment_jpa "https://github.com/hei-school/tsinjo/blob/preprod/src/main/java/school/hei/tsinjo/repository/jpa/JPaymentRepository.java"
click node_user_jpa "https://github.com/hei-school/tsinjo/blob/preprod/src/main/java/school/hei/tsinjo/repository/jpa/JUserRepository.java"
click node_vola_psp "https://github.com/hei-school/tsinjo/blob/preprod/src/main/java/school/hei/tsinjo/model/psp/vola/VolaPsp.java"
click node_vola_client "https://github.com/hei-school/tsinjo/blob/preprod/src/main/java/school/hei/tsinjo/model/psp/vola/api/VolaClient.java"
click node_payment_api "https://github.com/hei-school/tsinjo/blob/preprod/src/main/java/school/hei/tsinjo/model/psp/vola/api/gen/volaClient/api/PaymentControllerApi.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_controller,node_donation_form,node_event_view,node_fund_view toneBlue
class node_form_service,node_form_consumer,node_event_service toneAmber
class node_event_domain,node_payment_domain,node_event_repo,node_payment_repo,node_user_repo,node_event_jpa,node_payment_jpa,node_user_jpa toneMint
class node_vola_psp,node_vola_client,node_payment_api toneRose
class node_visitor,node_vola_service toneIndigo
```

## Components

### Web interface

- [Web controller](https://github.com/hei-school/tsinjo/blob/preprod/src/main/java/school/hei/tsinjo/endpoint/http/TsinjoController.java): `src/main/java/school/hei/tsinjo/endpoint/http/TsinjoController.java`
- [Donation form](https://github.com/hei-school/tsinjo/blob/preprod/src/main/java/school/hei/tsinjo/endpoint/http/model/DonationCreationForm.java): `src/main/java/school/hei/tsinjo/endpoint/http/model/DonationCreationForm.java`
- [Event view model](https://github.com/hei-school/tsinjo/blob/preprod/src/main/java/school/hei/tsinjo/endpoint/http/model/ThEvent.java): `src/main/java/school/hei/tsinjo/endpoint/http/model/ThEvent.java`
- [Fund summary](https://github.com/hei-school/tsinjo/blob/preprod/src/main/java/school/hei/tsinjo/endpoint/http/model/ThFund.java): `src/main/java/school/hei/tsinjo/endpoint/http/model/ThFund.java`

### Event services

- [Form prefill](https://github.com/hei-school/tsinjo/blob/preprod/src/main/java/school/hei/tsinjo/service/DonationFormService.java): `src/main/java/school/hei/tsinjo/service/DonationFormService.java`
- [Donation submission](https://github.com/hei-school/tsinjo/blob/preprod/src/main/java/school/hei/tsinjo/service/DonationCreationFormConsumer.java): `src/main/java/school/hei/tsinjo/service/DonationCreationFormConsumer.java`
- [Event service](https://github.com/hei-school/tsinjo/blob/preprod/src/main/java/school/hei/tsinjo/service/EventService.java): `src/main/java/school/hei/tsinjo/service/EventService.java`

### Domain and persistence

- [Event domain](https://github.com/hei-school/tsinjo/blob/preprod/src/main/java/school/hei/tsinjo/model/Event.java): `src/main/java/school/hei/tsinjo/model/Event.java`
- [Payment domain](https://github.com/hei-school/tsinjo/blob/preprod/src/main/java/school/hei/tsinjo/model/Payment.java): `src/main/java/school/hei/tsinjo/model/Payment.java`
- [Event repository](https://github.com/hei-school/tsinjo/blob/preprod/src/main/java/school/hei/tsinjo/repository/EventRepository.java): `src/main/java/school/hei/tsinjo/repository/EventRepository.java`
- [Payment repository](https://github.com/hei-school/tsinjo/blob/preprod/src/main/java/school/hei/tsinjo/repository/PaymentRepository.java): `src/main/java/school/hei/tsinjo/repository/PaymentRepository.java`
- [User repository](https://github.com/hei-school/tsinjo/blob/preprod/src/main/java/school/hei/tsinjo/repository/UserRepository.java): `src/main/java/school/hei/tsinjo/repository/UserRepository.java`
- [Event JPA store](https://github.com/hei-school/tsinjo/blob/preprod/src/main/java/school/hei/tsinjo/repository/jpa/JEventRepository.java): `src/main/java/school/hei/tsinjo/repository/jpa/JEventRepository.java`
- [Payment JPA store](https://github.com/hei-school/tsinjo/blob/preprod/src/main/java/school/hei/tsinjo/repository/jpa/JPaymentRepository.java): `src/main/java/school/hei/tsinjo/repository/jpa/JPaymentRepository.java`
- [User JPA store](https://github.com/hei-school/tsinjo/blob/preprod/src/main/java/school/hei/tsinjo/repository/jpa/JUserRepository.java): `src/main/java/school/hei/tsinjo/repository/jpa/JUserRepository.java`

### Payment integration

- [Vola PSP adapter](https://github.com/hei-school/tsinjo/blob/preprod/src/main/java/school/hei/tsinjo/model/psp/vola/VolaPsp.java): `src/main/java/school/hei/tsinjo/model/psp/vola/VolaPsp.java`
- [Vola client](https://github.com/hei-school/tsinjo/blob/preprod/src/main/java/school/hei/tsinjo/model/psp/vola/api/VolaClient.java): `src/main/java/school/hei/tsinjo/model/psp/vola/api/VolaClient.java`
- [Payment API client](https://github.com/hei-school/tsinjo/blob/preprod/src/main/java/school/hei/tsinjo/model/psp/vola/api/gen/volaClient/api/PaymentControllerApi.java): `src/main/java/school/hei/tsinjo/model/psp/vola/api/gen/volaClient/api/PaymentControllerApi.java`

### Other components

- **Visitor**
- **Vola service**

## Connections

- Visitor → Web controller: uses (evidence: `src/main/java/school/hei/tsinjo/endpoint/http/TsinjoController.java`)
- Web controller → Form prefill: prefills via (evidence: `src/main/java/school/hei/tsinjo/endpoint/http/TsinjoController.java`)
- Web controller → Donation submission: submits to (evidence: `src/main/java/school/hei/tsinjo/endpoint/http/TsinjoController.java`)
- Web controller → Event service: loads events (evidence: `src/main/java/school/hei/tsinjo/endpoint/http/TsinjoController.java`)
- Web controller → Event view model: renders as (evidence: `src/main/java/school/hei/tsinjo/endpoint/http/TsinjoController.java`)
- Web controller → Fund summary: summarizes as (evidence: `src/main/java/school/hei/tsinjo/endpoint/http/TsinjoController.java`)
- Form prefill → Event service: loads events (evidence: `src/main/java/school/hei/tsinjo/service/DonationFormService.java`)
- Form prefill → Event view model: maps to (evidence: `src/main/java/school/hei/tsinjo/service/DonationFormService.java`)
- Form prefill → Donation form: creates (evidence: `src/main/java/school/hei/tsinjo/service/DonationFormService.java`)
- Event service → Event repository: reads and saves (evidence: `src/main/java/school/hei/tsinjo/service/EventService.java`)
- Event service → Vola PSP adapter: resolves payments (evidence: `src/main/java/school/hei/tsinjo/service/EventService.java`)
- Event repository → Event JPA store: persists events (evidence: `src/main/java/school/hei/tsinjo/repository/EventRepository.java`)
- Event repository → Payment repository: saves payment (evidence: `src/main/java/school/hei/tsinjo/repository/EventRepository.java`)
- Event repository → User repository: saves user (evidence: `src/main/java/school/hei/tsinjo/repository/EventRepository.java`)
- Payment repository → Payment JPA store: stores payments (evidence: `src/main/java/school/hei/tsinjo/repository/PaymentRepository.java`)
- User repository → User JPA store: stores users (evidence: `src/main/java/school/hei/tsinjo/repository/UserRepository.java`)
- Vola client → Payment API client: calls (evidence: `src/main/java/school/hei/tsinjo/model/psp/vola/api/VolaClient.java`)
- Payment API client → Vola service: sends HTTP requests
