Skip to content

About

Desktop application to manage hotel rooms, different tasks for special roles with documents generator. Built with Spring Boot, Electron, React and MariaDB.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

1 Commit

Folders and files

Repository files navigation

Hotel Task Manager

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.

Main application panel


My contributions

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.

Tech stack

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)

Architecture overview

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-based access control

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

Key features

  • 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

Database schema

The database schema is managed automatically by Hibernate on first run. The ERD source is defined in schema/erd.dbml.

ERD diagram


UML diagrams

Use case diagram

Use case diagram

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
Class diagram

Class diagram


Project structure

.
├── 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

Running locally (development)

Prerequisites

  • Java 22+
  • Node.js 20+
  • MariaDB (running locally)

Backend

cd backend
# Configure src/main/resources/application.properties (DB credentials)
./mvnw spring-boot:run

Frontend

cd frontend
npm install
npm run dev          # Vite dev server
# or
npm run electron:dev # Electron + Vite

Team

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

About

Desktop application to manage hotel rooms, different tasks for special roles with documents generator. Built with Spring Boot, Electron, React and MariaDB.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages