# yashn555/hotel-mitraya-pos-java architecture

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

- Interactive diagram: https://gitdiagram.com/yashn555/hotel-mitraya-pos-java
- Repository: https://github.com/yashn555/hotel-mitraya-pos-java

## Overview

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`](https://github.com/yashn555/hotel-mitraya-pos-java/blob/main/app.py) (Flask entry), [`backend-spring-boot/src/main/java/com/hotelmitraya/controller`](https://github.com/yashn555/hotel-mitraya-pos-java/tree/main/backend-spring-boot/src/main/java/com/hotelmitraya/controller) (Spring REST API), [`database/models.py`](https://github.com/yashn555/hotel-mitraya-pos-java/blob/main/database/models.py) (Flask data model), [`pos/routes.py`](https://github.com/yashn555/hotel-mitraya-pos-java/blob/main/pos/routes.py) (Counter billing)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_clients["Staff clients"]
  node_android["Android POS"]
  node_android_api["Android API client<br/>[ApiClient.java]"]
  node_web["POS web client<br/>[app.js]"]
end

subgraph group_flask["Flask services"]
  node_flask_app["Flask entry<br/>[app.py]"]
  node_auth["Authentication<br/>[routes.py]"]
  node_orders["Order lifecycle<br/>[routes.py]"]
  node_waiter["Waiter workflow<br/>[routes.py]"]
  node_counter["Counter billing<br/>[routes.py]"]
  node_admin["Admin and reports<br/>[routes.py]"]
end

subgraph group_spring["Spring services"]
  node_spring_api["Spring REST API"]
  node_spring_orders["Order service<br/>[OrderService.java]"]
  node_spring_pos["POS service<br/>[PosService.java]"]
  node_spring_admin["Admin management"]
  node_spring_printer["Printer service"]
end

subgraph group_persistence["Data and printing"]
  node_flask_db[("Flask data model<br/>[models.py]")]
  node_spring_orders_repo[("Order repository")]
  node_spring_bills_repo[("Bill repository")]
  node_printer["Thermal printing<br/>[manager.py]"]
end

subgraph group_pdf["PDF billing"]
  node_pdf_generator["PDF bill generation"]
  node_pdf_storage[("Saved PDF bills")]
end

node_staff(("Restaurant staff"))

node_staff -->|"uses"| node_android
node_staff -->|"uses"| node_web
node_android -->|"requests"| node_android_api
node_android_api -.->|"calls API"| node_spring_api
node_web -.->|"calls API"| node_spring_api
node_flask_app -->|"registers"| node_auth
node_flask_app -->|"registers"| node_orders
node_flask_app -->|"registers"| node_waiter
node_flask_app -->|"registers"| node_counter
node_flask_app -->|"registers"| node_admin
node_orders -->|"reads and writes"| node_flask_db
node_waiter -->|"reads and writes"| node_flask_db
node_counter -->|"reads and writes"| node_flask_db
node_counter -->|"dispatches prints"| node_printer
node_admin -->|"reads and writes"| node_flask_db
node_spring_api -.->|"delegates orders"| node_spring_orders
node_spring_api -.->|"delegates POS"| node_spring_pos
node_spring_api -->|"serves admin"| node_spring_admin
node_spring_pos -->|"persists bills"| node_spring_bills_repo
node_spring_orders -->|"persists orders"| node_spring_orders_repo
node_spring_pos -->|"requests printing"| node_spring_printer
node_flask_app -->|"calls generator"| node_pdf_generator
node_pdf_generator -->|"saves PDFs"| node_pdf_storage

click node_android "https://github.com/yashn555/hotel-mitraya-pos-java/tree/main/android-app/app/src/main/java/com/hotelmitraya/pos/ui"
click node_android_api "https://github.com/yashn555/hotel-mitraya-pos-java/blob/main/android-app/app/src/main/java/com/hotelmitraya/pos/api/ApiClient.java"
click node_web "https://github.com/yashn555/hotel-mitraya-pos-java/blob/main/backend-spring-boot/src/main/resources/static/app.js"
click node_flask_app "https://github.com/yashn555/hotel-mitraya-pos-java/blob/main/app.py"
click node_auth "https://github.com/yashn555/hotel-mitraya-pos-java/blob/main/auth/routes.py"
click node_orders "https://github.com/yashn555/hotel-mitraya-pos-java/blob/main/orders/routes.py"
click node_waiter "https://github.com/yashn555/hotel-mitraya-pos-java/blob/main/waiter/routes.py"
click node_counter "https://github.com/yashn555/hotel-mitraya-pos-java/blob/main/pos/routes.py"
click node_admin "https://github.com/yashn555/hotel-mitraya-pos-java/blob/main/admin/routes.py"
click node_spring_api "https://github.com/yashn555/hotel-mitraya-pos-java/tree/main/backend-spring-boot/src/main/java/com/hotelmitraya/controller"
click node_spring_orders "https://github.com/yashn555/hotel-mitraya-pos-java/blob/main/backend-spring-boot/src/main/java/com/hotelmitraya/service/OrderService.java"
click node_spring_pos "https://github.com/yashn555/hotel-mitraya-pos-java/blob/main/backend-spring-boot/src/main/java/com/hotelmitraya/service/PosService.java"
click node_spring_admin "https://github.com/yashn555/hotel-mitraya-pos-java/blob/main/backend-spring-boot/src/main/java/com/hotelmitraya/controller/AdminController.java"
click node_spring_printer "https://github.com/yashn555/hotel-mitraya-pos-java/blob/main/backend-spring-boot/src/main/java/com/hotelmitraya/service/PrinterService.java"
click node_flask_db "https://github.com/yashn555/hotel-mitraya-pos-java/blob/main/database/models.py"
click node_spring_orders_repo "https://github.com/yashn555/hotel-mitraya-pos-java/blob/main/backend-spring-boot/src/main/java/com/hotelmitraya/repository/OrderRepository.java"
click node_spring_bills_repo "https://github.com/yashn555/hotel-mitraya-pos-java/blob/main/backend-spring-boot/src/main/java/com/hotelmitraya/repository/PosBillRepository.java"
click node_printer "https://github.com/yashn555/hotel-mitraya-pos-java/blob/main/printer/manager.py"
click node_pdf_generator "https://github.com/yashn555/hotel-mitraya-pos-java/blob/main/generate_bill_docx.py"

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_android,node_android_api,node_web toneBlue
class node_flask_app,node_auth,node_orders,node_waiter,node_counter,node_admin toneAmber
class node_spring_api,node_spring_orders,node_spring_pos,node_spring_admin,node_spring_printer toneMint
class node_flask_db,node_spring_orders_repo,node_spring_bills_repo,node_printer toneRose
class node_pdf_generator,node_pdf_storage,node_staff toneIndigo
```

## Components

### Staff clients

- [Android POS](https://github.com/yashn555/hotel-mitraya-pos-java/tree/main/android-app/app/src/main/java/com/hotelmitraya/pos/ui): `android-app/app/src/main/java/com/hotelmitraya/pos/ui`
- [Android API client](https://github.com/yashn555/hotel-mitraya-pos-java/blob/main/android-app/app/src/main/java/com/hotelmitraya/pos/api/ApiClient.java): `android-app/app/src/main/java/com/hotelmitraya/pos/api/ApiClient.java`
- [POS web client](https://github.com/yashn555/hotel-mitraya-pos-java/blob/main/backend-spring-boot/src/main/resources/static/app.js): `backend-spring-boot/src/main/resources/static/app.js`

### Flask services

- [Flask entry](https://github.com/yashn555/hotel-mitraya-pos-java/blob/main/app.py): `app.py`
- [Authentication](https://github.com/yashn555/hotel-mitraya-pos-java/blob/main/auth/routes.py): `auth/routes.py`
- [Order lifecycle](https://github.com/yashn555/hotel-mitraya-pos-java/blob/main/orders/routes.py): `orders/routes.py`
- [Waiter workflow](https://github.com/yashn555/hotel-mitraya-pos-java/blob/main/waiter/routes.py): `waiter/routes.py`
- [Counter billing](https://github.com/yashn555/hotel-mitraya-pos-java/blob/main/pos/routes.py): `pos/routes.py`
- [Admin and reports](https://github.com/yashn555/hotel-mitraya-pos-java/blob/main/admin/routes.py): `admin/routes.py`

### Spring services

- [Spring REST API](https://github.com/yashn555/hotel-mitraya-pos-java/tree/main/backend-spring-boot/src/main/java/com/hotelmitraya/controller): `backend-spring-boot/src/main/java/com/hotelmitraya/controller`
- [Order service](https://github.com/yashn555/hotel-mitraya-pos-java/blob/main/backend-spring-boot/src/main/java/com/hotelmitraya/service/OrderService.java): `backend-spring-boot/src/main/java/com/hotelmitraya/service/OrderService.java`
- [POS service](https://github.com/yashn555/hotel-mitraya-pos-java/blob/main/backend-spring-boot/src/main/java/com/hotelmitraya/service/PosService.java): `backend-spring-boot/src/main/java/com/hotelmitraya/service/PosService.java`
- [Admin management](https://github.com/yashn555/hotel-mitraya-pos-java/blob/main/backend-spring-boot/src/main/java/com/hotelmitraya/controller/AdminController.java): `backend-spring-boot/src/main/java/com/hotelmitraya/controller/AdminController.java`
- [Printer service](https://github.com/yashn555/hotel-mitraya-pos-java/blob/main/backend-spring-boot/src/main/java/com/hotelmitraya/service/PrinterService.java): `backend-spring-boot/src/main/java/com/hotelmitraya/service/PrinterService.java`

### Data and printing

- [Flask data model](https://github.com/yashn555/hotel-mitraya-pos-java/blob/main/database/models.py): `database/models.py`
- [Order repository](https://github.com/yashn555/hotel-mitraya-pos-java/blob/main/backend-spring-boot/src/main/java/com/hotelmitraya/repository/OrderRepository.java): `backend-spring-boot/src/main/java/com/hotelmitraya/repository/OrderRepository.java`
- [Bill repository](https://github.com/yashn555/hotel-mitraya-pos-java/blob/main/backend-spring-boot/src/main/java/com/hotelmitraya/repository/PosBillRepository.java): `backend-spring-boot/src/main/java/com/hotelmitraya/repository/PosBillRepository.java`
- [Thermal printing](https://github.com/yashn555/hotel-mitraya-pos-java/blob/main/printer/manager.py): `printer/manager.py`

### PDF billing

- [PDF bill generation](https://github.com/yashn555/hotel-mitraya-pos-java/blob/main/generate_bill_docx.py): `generate_bill_docx.py`
- **Saved PDF bills**

### Other components

- **Restaurant staff**

## Connections

- Restaurant staff → Android POS: uses
- Restaurant staff → POS web client: uses
- Android POS → Android API client: requests (evidence: `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 (evidence: `app.py`)
- Flask entry → Order lifecycle: registers (evidence: `app.py`)
- Flask entry → Waiter workflow: registers (evidence: `app.py`)
- Flask entry → Counter billing: registers (evidence: `app.py`)
- Flask entry → Admin and reports: registers (evidence: `app.py`)
- Order lifecycle → Flask data model: reads and writes (evidence: `orders/routes.py`)
- Waiter workflow → Flask data model: reads and writes (evidence: `waiter/routes.py`)
- Counter billing → Flask data model: reads and writes (evidence: `pos/routes.py`)
- Counter billing → Thermal printing: dispatches prints (evidence: `pos/routes.py`)
- Admin and reports → Flask data model: reads and writes (evidence: `admin/routes.py`)
- Spring REST API → Order service: delegates orders (evidence: `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 (evidence: `backend-spring-boot/src/main/java/com/hotelmitraya/controller/AdminController.java`)
- POS service → Bill repository: persists bills (evidence: `backend-spring-boot/src/main/java/com/hotelmitraya/service/PosService.java`)
- Order service → Order repository: persists orders (evidence: `backend-spring-boot/src/main/java/com/hotelmitraya/service/OrderService.java`)
- POS service → Printer service: requests printing (evidence: `backend-spring-boot/src/main/java/com/hotelmitraya/service/PosService.java`)
- Flask entry → PDF bill generation: calls generator (evidence: `app.py`)
- PDF bill generation → Saved PDF bills: saves PDFs (evidence: `README.md`)
