How yashn555/hotel-mitraya-pos-java works
Hotel Mitraya is a restaurant billing and POS system: staff authenticate, take waiter or counter orders, send them to kitchen, settle bills, and print receipts; administrators manage menus, users, and reports. The tree contains a Flask application, a Spring Boot backend, and an Android client, so the graph shows these as distinct interfaces/implementations rather than assuming they share runtime wiring. The README also documents a customer-facing PDF bill workflow. Some links are supported only by the source index or README; unsampled subsystem details are not inferred.
Main entry points: app.py Flask entry · controller Spring REST API · models.py Flask data model · routes.py Counter billing
Components 21
Staff clients
- Android POS
android-app/app/src/main/java/com/hotelmitraya/pos/ui - Android API client
android-app/app/src/main/java/com/hotelmitraya/pos/api/ApiClient.java - POS web client
backend-spring-boot/src/main/resources/static/app.js
Flask services
- Flask entry
app.py - Authentication
auth/routes.py - Order lifecycle
orders/routes.py - Waiter workflow
waiter/routes.py - Counter billing
pos/routes.py - Admin and reports
admin/routes.py
Spring services
- Spring REST API
backend-spring-boot/src/main/java/com/hotelmitraya/controller - Order service
backend-spring-boot/src/main/java/com/hotelmitraya/service/OrderService.java - POS service
backend-spring-boot/src/main/java/com/hotelmitraya/service/PosService.java - Admin management
backend-spring-boot/src/main/java/com/hotelmitraya/controller/AdminController.java - Printer service
backend-spring-boot/src/main/java/com/hotelmitraya/service/PrinterService.java
Data and printing
- Flask data model
database/models.py - Order repository
backend-spring-boot/src/main/java/com/hotelmitraya/repository/OrderRepository.java - Bill repository
backend-spring-boot/src/main/java/com/hotelmitraya/repository/PosBillRepository.java - Thermal printing
printer/manager.py
PDF billing
- PDF bill generation
generate_bill_docx.py - Saved PDF bills
Other components
- Restaurant staff
Connections 23
- Restaurant staff → Android POS: uses
- Restaurant staff → POS web client: uses
- Android POS → Android API client: requests
android-app/app/src/main/java/com/hotelmitraya/pos/ui/pos/PosCounterActivity.java - Android API client → Spring REST API: calls API
- POS web client → Spring REST API: calls API
- Flask entry → Authentication: registers
app.py - Flask entry → Order lifecycle: registers
app.py - Flask entry → Waiter workflow: registers
app.py - Flask entry → Counter billing: registers
app.py - Flask entry → Admin and reports: registers
app.py - Order lifecycle → Flask data model: reads and writes
orders/routes.py - Waiter workflow → Flask data model: reads and writes
waiter/routes.py - Counter billing → Flask data model: reads and writes
pos/routes.py - Counter billing → Thermal printing: dispatches prints
pos/routes.py - Admin and reports → Flask data model: reads and writes
admin/routes.py - Spring REST API → Order service: delegates orders
backend-spring-boot/src/main/java/com/hotelmitraya/controller/OrderController.java - Spring REST API → POS service: delegates POS
- Spring REST API → Admin management: serves admin
backend-spring-boot/src/main/java/com/hotelmitraya/controller/AdminController.java - POS service → Bill repository: persists bills
backend-spring-boot/src/main/java/com/hotelmitraya/service/PosService.java - Order service → Order repository: persists orders
backend-spring-boot/src/main/java/com/hotelmitraya/service/OrderService.java - POS service → Printer service: requests printing
backend-spring-boot/src/main/java/com/hotelmitraya/service/PosService.java - Flask entry → PDF bill generation: calls generator
app.py - PDF bill generation → Saved PDF bills: saves PDFs
README.md