Portfolio note: This project was originally developed as a team assignment at the University of Rzeszów (UR-INF, academic year 2024/2025). I am mirroring it on my personal GitHub to showcase my contributions. The original repository is hosted at UR-INF/24-25-pz-inf-l3_g1_km.
A full-stack desktop application for managing tasks and operations in a hotel environment. The system enables role-based task delegation, reservation management, invoice generation, and real-time status tracking for all hotel staff.
This was a 4-person team project. My main responsibilities included:
- Reports module (full-stack) – Designed and implemented the entire reports feature from scratch: REST controller, 6 domain-specific service classes (financial, housekeeping efficiency, maintenance issues, reservation management, room status, staff performance), matching DTOs, a 1 100-line PDF generation service (
PdfReportGeneratorService), report storage service, and all frontend views and components. Later refactored all report views to modal dialogs for better UX. - Frontend module: Invoices – Added invoice browsing for the Manager role and fixed invoice deletion. Integrated with the Ministry of Finance (MF) public API to auto-fill company data on invoices.
- Frontend module: Reception panel – Built the receptionist dashboard and the core views for managing reservations, cleaning orders, and repair requests, along with all required forms.
- User account settings – Implemented the full account settings panel, including email address change (with JWT token refresh and protection against overwriting another employee's email), password change, and avatar upload.
- Theme / appearance system – Added light/dark/system theme switching using React Context instead of a local hook, and fixed the profile picture icon in the employee column.
- Unit tests (backend) – Wrote JUnit tests for the rooms controller (
/api/rooms). - Unit tests (frontend) – Wrote Jest unit tests covering reports, cleaning orders, and incident reports.
- Database schema & UML diagrams – Maintained the ERD diagram (DBML source + exported PNG) and produced all sequence diagrams for the project documentation.
- Bug fixes & maintenance – Fixed password reset flow, added loading indicator for password reset, repaired Electron configuration resets, fixed email update bugs, and various other smaller fixes.
| Layer | Technology |
|---|---|
| Backend | Java 22, Spring Boot, Spring Security (JWT), JPA / Hibernate |
| Database | MariaDB |
| Frontend | React 18, TypeScript, Vite, Electron |
| UI library | Tabler UI (React components) |
| HTTP client | Axios |
| Charts | ApexCharts |
| Installer | Rust, egui / eframe |
| Testing | JUnit 5 (backend), Jest (frontend) |
The application follows a classic three-tier architecture:
┌─────────────────────┐
│ Electron Desktop │ ← wraps the React SPA into a native Windows app
│ (React + Vite) │
└─────────┬───────────┘
│ REST API (HTTP/JSON)
┌─────────▼───────────┐
│ Spring Boot API │ ← JWT-secured REST endpoints, business logic
└─────────┬───────────┘
│ JPA / Hibernate
┌─────────▼───────────┐
│ MariaDB │ ← relational database, auto-migrated via Hibernate
└─────────────────────┘
The frontend communicates with the backend exclusively via REST API. Configuration (backend host, port) is stored in a local config.json file and can be modified through the built-in admin panel.
| Role | Capabilities |
|---|---|
| Employee (base role) | Login, password reset, own account management, task execution |
| Receptionist | Reservation CRUD, guest incident management |
| Maintenance | View and update repair orders |
| Housekeeper | View and update cleaning orders, report room issues |
| Manager | Employee management, room management, reports, invoice browsing |
- Reservation system – full create / edit / delete flow with automatic cleaning order creation on checkout
- Incident & cleaning orders – separate workflows for housekeeping and maintenance with status tracking
- Reports – filterable reports (daily / weekly / monthly) with CSV and PDF export
- Invoices – VAT invoice generation in PDF format, auto-filled with company data from the Polish MF public API
- Desktop notifications – Electron push notifications for new unassigned orders
- Installer – standalone GUI installer written in Rust (egui) covering MariaDB setup, Java environment detection, and frontend/backend deployment
- Data seeding – optional seed command to populate the database with example employees, rooms, and reservations
The database schema is managed automatically by Hibernate on first run. The ERD source is defined in schema/erd.dbml.
Activity diagrams
| Scenario | Diagram |
|---|---|
| Login | ![]() |
| Create reservation | ![]() |
| Update reservation | ![]() |
| Password reset | ![]() |
| Remove employee | ![]() |
| Worker statistics | ![]() |
| View reports | ![]() |
Sequence diagrams
| Scenario | Diagram |
|---|---|
| Login | ![]() |
| Add employee | ![]() |
| Edit employee | ![]() |
| Remove employee | ![]() |
| Add note to task | ![]() |
| Delete report | ![]() |
| Team statistics | ![]() |
.
├── backend/ # Spring Boot REST API (Java 22)
│ ├── src/ # Application source code
│ └── javadoc/ # Generated JavaDoc
├── frontend/ # Electron + React + TypeScript desktop app
│ ├── src/ # React components, pages, services
│ └── electron/ # Electron main process
├── installer/ # Rust-based GUI installer (egui/eframe)
├── installer-images/ # Installer screenshot assets
├── schema/ # Database ERD (DBML + PNG)
└── uml/ # UML diagram images
- Java 22+
- Node.js 20+
- MariaDB (running locally)
cd backend
# Configure src/main/resources/application.properties (DB credentials)
./mvnw spring-boot:runcd frontend
npm install
npm run dev # Vite dev server
# or
npm run electron:dev # Electron + Vite| Name | Role |
|---|---|
| Krzysztof Motas | Team Lead, installer (Rust), frontend core |
| Konrad Pluta | Reports module, invoices, reception panel, account settings, tests, ERD & UML |
| Patryk Jarosiewicz | Cleaning & repair order workflows, backend seeders |
| Jakub Orczyk | Reservation management, room management, invoice backend |

















