# hafizjamshed/urlaubsverwaltung architecture

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

- Interactive diagram: https://gitdiagram.com/hafizjamshed/urlaubsverwaltung
- Repository: https://github.com/hafizjamshed/urlaubsverwaltung

## Overview

Urlaubsverwaltung is a web application for managing employee absences. The principal workflow is that an employee submits a leave application, authorized managers approve or reject it, and the resulting absence is tracked for balances and calendars. Other major capabilities include sick-note and overtime management, employee and department administration, and calendar synchronization. The graph keeps those domains distinct; it uses README statements for documented workflows and the source index or excerpts for the few internal relationships shown. Unsampled subsystem connections are omitted rather than inferred.

Main entry points: [`src/main/java/org/synyx/urlaubsverwaltung/application/application/ApplicationService.java`](https://github.com/hafizjamshed/urlaubsverwaltung/blob/main/src/main/java/org/synyx/urlaubsverwaltung/application/application/ApplicationService.java) (Application workflow), [`src/main/java/org/synyx/urlaubsverwaltung/application/application/Application.java`](https://github.com/hafizjamshed/urlaubsverwaltung/blob/main/src/main/java/org/synyx/urlaubsverwaltung/application/application/Application.java) (Leave application), [`src/main/java/org/synyx/urlaubsverwaltung/application/application/ApplicationForLeaveViewController.java`](https://github.com/hafizjamshed/urlaubsverwaltung/blob/main/src/main/java/org/synyx/urlaubsverwaltung/application/application/ApplicationForLeaveViewController.java) (Leave requests), [`src/main/java/org/synyx/urlaubsverwaltung/application/application/ApplicationMailService.java`](https://github.com/hafizjamshed/urlaubsverwaltung/blob/main/src/main/java/org/synyx/urlaubsverwaltung/application/application/ApplicationMailService.java) (Application notifications)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_leave["Leave management"]
  node_application_ui["Leave requests"]
  node_application_service["Application workflow"]
  node_application_model["Leave application<br/>[Application.java]"]
  node_application_mail["Application notifications"]
end

subgraph group_workforce["People and balances"]
  node_person_admin["Employee administration<br/>[PersonService.java]"]
  node_department["Departments and access"]
  node_account["Vacation balances"]
  node_working_time["Workday calculation"]
end

subgraph group_absence["Other absences"]
  node_sick_note["Sick notes"]
  node_overtime["Overtime records"]
  node_absence_overview["Absence overview"]
end

subgraph group_calendar["Calendars and integrations"]
  node_calendar["Calendar feeds<br/>[ICalService.java]"]
  node_calendar_sync["Calendar synchronization"]
  node_google_calendar["Google Calendar"]
end

subgraph group_platform["Application services"]
  node_database[("PostgreSQL")]
  node_mail_server["Mail server"]
end

node_employee(("Employee"))
node_manager(("Authorized manager"))

node_employee -->|"submits request"| node_application_ui
node_application_ui -.->|"handles request"| node_application_service
node_manager -->|"approves or rejects"| node_application_service
node_application_service -.->|"manages lifecycle"| node_application_model
node_application_service -.->|"persists application"| node_database
node_application_service -.->|"triggers notices"| node_application_mail
node_application_mail -->|"sends email"| node_mail_server
node_person_admin -.->|"stores people"| node_database
node_department -.->|"stores departments"| node_database
node_application_model -->|"informs balances"| node_account
node_working_time -->|"supports calculations"| node_account
node_employee -->|"records illness"| node_sick_note
node_employee -->|"records overtime"| node_overtime
node_application_model -.->|"appears in overview"| node_absence_overview
node_application_model -->|"drives sync events"| node_calendar_sync
node_calendar_sync -.->|"dispatches sync"| node_google_calendar
node_employee -.->|"views calendar"| node_calendar

click node_application_ui "https://github.com/hafizjamshed/urlaubsverwaltung/blob/main/src/main/java/org/synyx/urlaubsverwaltung/application/application/ApplicationForLeaveViewController.java"
click node_application_service "https://github.com/hafizjamshed/urlaubsverwaltung/blob/main/src/main/java/org/synyx/urlaubsverwaltung/application/application/ApplicationService.java"
click node_application_model "https://github.com/hafizjamshed/urlaubsverwaltung/blob/main/src/main/java/org/synyx/urlaubsverwaltung/application/application/Application.java"
click node_application_mail "https://github.com/hafizjamshed/urlaubsverwaltung/blob/main/src/main/java/org/synyx/urlaubsverwaltung/application/application/ApplicationMailService.java"
click node_person_admin "https://github.com/hafizjamshed/urlaubsverwaltung/blob/main/src/main/java/org/synyx/urlaubsverwaltung/person/PersonService.java"
click node_department "https://github.com/hafizjamshed/urlaubsverwaltung/blob/main/src/main/java/org/synyx/urlaubsverwaltung/department/DepartmentService.java"
click node_account "https://github.com/hafizjamshed/urlaubsverwaltung/blob/main/src/main/java/org/synyx/urlaubsverwaltung/account/VacationDaysService.java"
click node_working_time "https://github.com/hafizjamshed/urlaubsverwaltung/blob/main/src/main/java/org/synyx/urlaubsverwaltung/workingtime/WorkDaysCountService.java"
click node_sick_note "https://github.com/hafizjamshed/urlaubsverwaltung/blob/main/src/main/java/org/synyx/urlaubsverwaltung/sicknote/sicknote/SickNoteService.java"
click node_overtime "https://github.com/hafizjamshed/urlaubsverwaltung/blob/main/src/main/java/org/synyx/urlaubsverwaltung/overtime/OvertimeService.java"
click node_absence_overview "https://github.com/hafizjamshed/urlaubsverwaltung/blob/main/src/main/java/org/synyx/urlaubsverwaltung/absence/web/AbsenceOverviewViewController.java"
click node_calendar "https://github.com/hafizjamshed/urlaubsverwaltung/blob/main/src/main/java/org/synyx/urlaubsverwaltung/calendar/ICalService.java"
click node_calendar_sync "https://github.com/hafizjamshed/urlaubsverwaltung/blob/main/src/main/java/org/synyx/urlaubsverwaltung/calendarintegration/CalendarSyncService.java"
click node_google_calendar "https://github.com/hafizjamshed/urlaubsverwaltung/blob/main/src/main/java/org/synyx/urlaubsverwaltung/calendarintegration/GoogleCalendarSyncProvider.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_application_ui,node_application_service,node_application_model,node_application_mail toneBlue
class node_person_admin,node_department,node_account,node_working_time toneAmber
class node_sick_note,node_overtime,node_absence_overview toneMint
class node_calendar,node_calendar_sync,node_google_calendar toneRose
class node_database,node_mail_server,node_employee,node_manager toneIndigo
```

## Components

### Leave management

- [Leave requests](https://github.com/hafizjamshed/urlaubsverwaltung/blob/main/src/main/java/org/synyx/urlaubsverwaltung/application/application/ApplicationForLeaveViewController.java): `src/main/java/org/synyx/urlaubsverwaltung/application/application/ApplicationForLeaveViewController.java`
- [Application workflow](https://github.com/hafizjamshed/urlaubsverwaltung/blob/main/src/main/java/org/synyx/urlaubsverwaltung/application/application/ApplicationService.java): `src/main/java/org/synyx/urlaubsverwaltung/application/application/ApplicationService.java`
- [Leave application](https://github.com/hafizjamshed/urlaubsverwaltung/blob/main/src/main/java/org/synyx/urlaubsverwaltung/application/application/Application.java): `src/main/java/org/synyx/urlaubsverwaltung/application/application/Application.java`
- [Application notifications](https://github.com/hafizjamshed/urlaubsverwaltung/blob/main/src/main/java/org/synyx/urlaubsverwaltung/application/application/ApplicationMailService.java): `src/main/java/org/synyx/urlaubsverwaltung/application/application/ApplicationMailService.java`

### People and balances

- [Employee administration](https://github.com/hafizjamshed/urlaubsverwaltung/blob/main/src/main/java/org/synyx/urlaubsverwaltung/person/PersonService.java): `src/main/java/org/synyx/urlaubsverwaltung/person/PersonService.java`
- [Departments and access](https://github.com/hafizjamshed/urlaubsverwaltung/blob/main/src/main/java/org/synyx/urlaubsverwaltung/department/DepartmentService.java): `src/main/java/org/synyx/urlaubsverwaltung/department/DepartmentService.java`
- [Vacation balances](https://github.com/hafizjamshed/urlaubsverwaltung/blob/main/src/main/java/org/synyx/urlaubsverwaltung/account/VacationDaysService.java): `src/main/java/org/synyx/urlaubsverwaltung/account/VacationDaysService.java`
- [Workday calculation](https://github.com/hafizjamshed/urlaubsverwaltung/blob/main/src/main/java/org/synyx/urlaubsverwaltung/workingtime/WorkDaysCountService.java): `src/main/java/org/synyx/urlaubsverwaltung/workingtime/WorkDaysCountService.java`

### Other absences

- [Sick notes](https://github.com/hafizjamshed/urlaubsverwaltung/blob/main/src/main/java/org/synyx/urlaubsverwaltung/sicknote/sicknote/SickNoteService.java): `src/main/java/org/synyx/urlaubsverwaltung/sicknote/sicknote/SickNoteService.java`
- [Overtime records](https://github.com/hafizjamshed/urlaubsverwaltung/blob/main/src/main/java/org/synyx/urlaubsverwaltung/overtime/OvertimeService.java): `src/main/java/org/synyx/urlaubsverwaltung/overtime/OvertimeService.java`
- [Absence overview](https://github.com/hafizjamshed/urlaubsverwaltung/blob/main/src/main/java/org/synyx/urlaubsverwaltung/absence/web/AbsenceOverviewViewController.java): `src/main/java/org/synyx/urlaubsverwaltung/absence/web/AbsenceOverviewViewController.java`

### Calendars and integrations

- [Calendar feeds](https://github.com/hafizjamshed/urlaubsverwaltung/blob/main/src/main/java/org/synyx/urlaubsverwaltung/calendar/ICalService.java): `src/main/java/org/synyx/urlaubsverwaltung/calendar/ICalService.java`
- [Calendar synchronization](https://github.com/hafizjamshed/urlaubsverwaltung/blob/main/src/main/java/org/synyx/urlaubsverwaltung/calendarintegration/CalendarSyncService.java): `src/main/java/org/synyx/urlaubsverwaltung/calendarintegration/CalendarSyncService.java`
- [Google Calendar](https://github.com/hafizjamshed/urlaubsverwaltung/blob/main/src/main/java/org/synyx/urlaubsverwaltung/calendarintegration/GoogleCalendarSyncProvider.java): `src/main/java/org/synyx/urlaubsverwaltung/calendarintegration/GoogleCalendarSyncProvider.java`

### Application services

- **PostgreSQL**
- **Mail server**

### Other components

- **Employee**
- **Authorized manager**

## Connections

- Employee → Leave requests: submits request
- Leave requests → Application workflow: handles request
- Authorized manager → Application workflow: approves or rejects
- Application workflow → Leave application: manages lifecycle (evidence: `src/main/java/org/synyx/urlaubsverwaltung/application/application/ApplicationService.java`)
- Application workflow → PostgreSQL: persists application
- Application workflow → Application notifications: triggers notices
- Application notifications → Mail server: sends email (evidence: `src/main/java/org/synyx/urlaubsverwaltung/application/application/ApplicationMailService.java`)
- Employee administration → PostgreSQL: stores people
- Departments and access → PostgreSQL: stores departments
- Leave application → Vacation balances: informs balances (evidence: `src/main/java/org/synyx/urlaubsverwaltung/account/VacationDaysService.java`)
- Workday calculation → Vacation balances: supports calculations (evidence: `src/main/java/org/synyx/urlaubsverwaltung/account/VacationDaysService.java`)
- Employee → Sick notes: records illness
- Employee → Overtime records: records overtime
- Leave application → Absence overview: appears in overview
- Leave application → Calendar synchronization: drives sync events (evidence: `src/main/java/org/synyx/urlaubsverwaltung/calendarintegration/CalendarSyncService.java`)
- Calendar synchronization → Google Calendar: dispatches sync
- Employee → Calendar feeds: views calendar
