# jancarliux24/hotel-lumbre architecture

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

- Interactive diagram: https://gitdiagram.com/jancarliux24/hotel-lumbre
- Repository: https://github.com/jancarliux24/hotel-lumbre

## Overview

Lumbre is a cross-platform hotel guest and operations app, with a separate static JavaScript hotel website also documented in the repository. The KMP user journey enters through a platform host, reaches shared navigation and guest screens, then uses booking rules and the repository for reservation/account operations; staff and superuser screens provide distinct operational branches. Firebase-backed persistence and location-based locale selection are meaningful integrations. README capability claims guide unsampled feature nodes; their internal connections are omitted where source excerpts do not establish them.

Main entry points: [`app/shared/src/commonMain/kotlin/com/lumbre/hotel/App.kt`](https://github.com/jancarliux24/hotel-lumbre/blob/main/app/shared/src/commonMain/kotlin/com/lumbre/hotel/App.kt) (Shared app and navigation), [`app/shared/src/commonMain/kotlin/com/lumbre/hotel/data/HotelRepository.kt`](https://github.com/jancarliux24/hotel-lumbre/blob/main/app/shared/src/commonMain/kotlin/com/lumbre/hotel/data/HotelRepository.kt) (Hotel repository), [`app/shared/src/commonMain/kotlin/com/lumbre/hotel/ui/screens/BookingScreen.kt`](https://github.com/jancarliux24/hotel-lumbre/blob/main/app/shared/src/commonMain/kotlin/com/lumbre/hotel/ui/screens/BookingScreen.kt) (Booking flow), [`app/shared/src/commonMain/kotlin/com/lumbre/hotel/ui/components/Catalog.kt`](https://github.com/jancarliux24/hotel-lumbre/blob/main/app/shared/src/commonMain/kotlin/com/lumbre/hotel/ui/components/Catalog.kt) (Hotel catalog data)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["App entry"]
  node_android["Android host<br/>[MainActivity.kt]"]
  node_ios["iOS host"]
  node_web["Web host<br/>[main.kt]"]
  node_app["Shared app and navigation<br/>[App.kt]"]
end

subgraph group_guest["Guest experience"]
  node_home["Home and discovery<br/>[HomeScreen.kt]"]
  node_rooms["Room catalog<br/>[RoomsScreen.kt]"]
  node_roomdetail["Room details"]
  node_offers["Offers<br/>[OffersScreen.kt]"]
  node_booking["Booking flow<br/>[BookingScreen.kt]"]
  node_trips["Trips<br/>[TripsScreen.kt]"]
  node_profile["Profile and account<br/>[ProfileScreen.kt]"]
  node_privacy["Privacy preferences<br/>[PrivacyScreen.kt]"]
  node_key["Digital key<br/>[KeyScreen.kt]"]
end

subgraph group_operations["Hotel operations"]
  node_admin["Admin panel<br/>[AdminScreen.kt]"]
  node_reception["Reception desk<br/>[ReceptionScreen.kt]"]
  node_superadmin["Superuser panel"]
end

subgraph group_shared["Shared services"]
  node_repo["Hotel repository<br/>[HotelRepository.kt]"]
  node_pricing["Pricing rules<br/>[Pricing.kt]"]
  node_validation["Input validation<br/>[Validation.kt]"]
  node_format["Currency and dates<br/>[Format.kt]"]
  node_catalog["Hotel catalog data<br/>[Catalog.kt]"]
  node_strings["Translations<br/>[Strings.kt]"]
  node_lumi["Lumi mascot<br/>[Lumi.kt]"]
end

subgraph group_integrations["External services"]
  node_firebase["Firebase APIs<br/>[FirebaseApi.kt]"]
  node_firestore[("Cloud data")]
  node_location["Location lookup<br/>[Location.kt]"]
  node_geocoder["Reverse geocoder"]
end

node_guest(("Guest"))
node_static["Static hotel website<br/>[app.js]"]

node_guest -.->|"opens"| node_android
node_guest -.->|"opens"| node_ios
node_guest -.->|"opens"| node_web
node_android -->|"launches"| node_app
node_ios -->|"embeds"| node_app
node_web -->|"launches"| node_app
node_app -->|"routes to"| node_home
node_app -->|"routes to"| node_rooms
node_app -->|"routes to"| node_roomdetail
node_app -->|"routes to"| node_offers
node_app -->|"routes to"| node_booking
node_app -->|"routes to"| node_trips
node_app -->|"routes to"| node_profile
node_app -->|"routes to"| node_privacy
node_app -->|"routes to"| node_key
node_app -->|"routes to"| node_admin
node_app -->|"routes to"| node_reception
node_app -->|"routes to"| node_superadmin
node_booking -->|"calculates quote"| node_pricing
node_booking -->|"validates input"| node_validation
node_booking -->|"reads promos"| node_repo
node_booking -.->|"records booking"| node_repo
node_repo -->|"calls APIs"| node_firebase
node_firebase -.->|"reads and writes"| node_firestore
node_repo -.->|"uses formatting"| node_format
node_home -->|"reads catalog"| node_catalog
node_rooms -.->|"reads catalog"| node_catalog
node_roomdetail -.->|"reads catalog"| node_catalog
node_trips -.->|"reads reservations"| node_repo
node_profile -.->|"manages account"| node_repo
node_admin -.->|"manages hotel data"| node_repo
node_reception -.->|"reads arrivals"| node_repo
node_superadmin -.->|"manages roles"| node_repo
node_app -->|"uses translations"| node_strings
node_app -->|"renders mascot"| node_lumi
node_location -->|"queries country"| node_geocoder
node_guest -.->|"visits"| node_static

click node_android "https://github.com/jancarliux24/hotel-lumbre/blob/main/app/androidApp/src/main/kotlin/com/lumbre/hotel/MainActivity.kt"
click node_ios "https://github.com/jancarliux24/hotel-lumbre/blob/main/app/shared/src/iosMain/kotlin/com/lumbre/hotel/MainViewController.kt"
click node_web "https://github.com/jancarliux24/hotel-lumbre/blob/main/app/webApp/src/wasmJsMain/kotlin/com/lumbre/hotel/main.kt"
click node_app "https://github.com/jancarliux24/hotel-lumbre/blob/main/app/shared/src/commonMain/kotlin/com/lumbre/hotel/App.kt"
click node_home "https://github.com/jancarliux24/hotel-lumbre/blob/main/app/shared/src/commonMain/kotlin/com/lumbre/hotel/ui/screens/HomeScreen.kt"
click node_rooms "https://github.com/jancarliux24/hotel-lumbre/blob/main/app/shared/src/commonMain/kotlin/com/lumbre/hotel/ui/screens/RoomsScreen.kt"
click node_roomdetail "https://github.com/jancarliux24/hotel-lumbre/blob/main/app/shared/src/commonMain/kotlin/com/lumbre/hotel/ui/screens/RoomDetailScreen.kt"
click node_offers "https://github.com/jancarliux24/hotel-lumbre/blob/main/app/shared/src/commonMain/kotlin/com/lumbre/hotel/ui/screens/OffersScreen.kt"
click node_booking "https://github.com/jancarliux24/hotel-lumbre/blob/main/app/shared/src/commonMain/kotlin/com/lumbre/hotel/ui/screens/BookingScreen.kt"
click node_trips "https://github.com/jancarliux24/hotel-lumbre/blob/main/app/shared/src/commonMain/kotlin/com/lumbre/hotel/ui/screens/TripsScreen.kt"
click node_profile "https://github.com/jancarliux24/hotel-lumbre/blob/main/app/shared/src/commonMain/kotlin/com/lumbre/hotel/ui/screens/ProfileScreen.kt"
click node_privacy "https://github.com/jancarliux24/hotel-lumbre/blob/main/app/shared/src/commonMain/kotlin/com/lumbre/hotel/ui/screens/PrivacyScreen.kt"
click node_key "https://github.com/jancarliux24/hotel-lumbre/blob/main/app/shared/src/commonMain/kotlin/com/lumbre/hotel/ui/screens/KeyScreen.kt"
click node_admin "https://github.com/jancarliux24/hotel-lumbre/blob/main/app/shared/src/commonMain/kotlin/com/lumbre/hotel/ui/screens/AdminScreen.kt"
click node_reception "https://github.com/jancarliux24/hotel-lumbre/blob/main/app/shared/src/commonMain/kotlin/com/lumbre/hotel/ui/screens/ReceptionScreen.kt"
click node_superadmin "https://github.com/jancarliux24/hotel-lumbre/blob/main/app/shared/src/commonMain/kotlin/com/lumbre/hotel/ui/screens/SuperAdminScreen.kt"
click node_repo "https://github.com/jancarliux24/hotel-lumbre/blob/main/app/shared/src/commonMain/kotlin/com/lumbre/hotel/data/HotelRepository.kt"
click node_pricing "https://github.com/jancarliux24/hotel-lumbre/blob/main/app/shared/src/commonMain/kotlin/com/lumbre/hotel/domain/Pricing.kt"
click node_validation "https://github.com/jancarliux24/hotel-lumbre/blob/main/app/shared/src/commonMain/kotlin/com/lumbre/hotel/domain/Validation.kt"
click node_format "https://github.com/jancarliux24/hotel-lumbre/blob/main/app/shared/src/commonMain/kotlin/com/lumbre/hotel/domain/Format.kt"
click node_catalog "https://github.com/jancarliux24/hotel-lumbre/blob/main/app/shared/src/commonMain/kotlin/com/lumbre/hotel/ui/components/Catalog.kt"
click node_strings "https://github.com/jancarliux24/hotel-lumbre/blob/main/app/shared/src/commonMain/kotlin/com/lumbre/hotel/i18n/Strings.kt"
click node_lumi "https://github.com/jancarliux24/hotel-lumbre/blob/main/app/shared/src/commonMain/kotlin/com/lumbre/hotel/ui/components/Lumi.kt"
click node_firebase "https://github.com/jancarliux24/hotel-lumbre/blob/main/app/shared/src/commonMain/kotlin/com/lumbre/hotel/data/firebase/FirebaseApi.kt"
click node_location "https://github.com/jancarliux24/hotel-lumbre/blob/main/app/shared/src/commonMain/kotlin/com/lumbre/hotel/platform/Location.kt"
click node_static "https://github.com/jancarliux24/hotel-lumbre/blob/main/js/app.js"

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_ios,node_web,node_app toneBlue
class node_home,node_rooms,node_roomdetail,node_offers,node_booking,node_trips,node_profile,node_privacy,node_key toneAmber
class node_admin,node_reception,node_superadmin toneMint
class node_repo,node_pricing,node_validation,node_format,node_catalog,node_strings,node_lumi toneRose
class node_firebase,node_firestore,node_location,node_geocoder,node_guest toneIndigo
class node_static toneTeal
```

## Components

### App entry

- [Android host](https://github.com/jancarliux24/hotel-lumbre/blob/main/app/androidApp/src/main/kotlin/com/lumbre/hotel/MainActivity.kt): `app/androidApp/src/main/kotlin/com/lumbre/hotel/MainActivity.kt`
- [iOS host](https://github.com/jancarliux24/hotel-lumbre/blob/main/app/shared/src/iosMain/kotlin/com/lumbre/hotel/MainViewController.kt): `app/shared/src/iosMain/kotlin/com/lumbre/hotel/MainViewController.kt`
- [Web host](https://github.com/jancarliux24/hotel-lumbre/blob/main/app/webApp/src/wasmJsMain/kotlin/com/lumbre/hotel/main.kt): `app/webApp/src/wasmJsMain/kotlin/com/lumbre/hotel/main.kt`
- [Shared app and navigation](https://github.com/jancarliux24/hotel-lumbre/blob/main/app/shared/src/commonMain/kotlin/com/lumbre/hotel/App.kt): `app/shared/src/commonMain/kotlin/com/lumbre/hotel/App.kt`

### Guest experience

- [Home and discovery](https://github.com/jancarliux24/hotel-lumbre/blob/main/app/shared/src/commonMain/kotlin/com/lumbre/hotel/ui/screens/HomeScreen.kt): `app/shared/src/commonMain/kotlin/com/lumbre/hotel/ui/screens/HomeScreen.kt`
- [Room catalog](https://github.com/jancarliux24/hotel-lumbre/blob/main/app/shared/src/commonMain/kotlin/com/lumbre/hotel/ui/screens/RoomsScreen.kt): `app/shared/src/commonMain/kotlin/com/lumbre/hotel/ui/screens/RoomsScreen.kt`
- [Room details](https://github.com/jancarliux24/hotel-lumbre/blob/main/app/shared/src/commonMain/kotlin/com/lumbre/hotel/ui/screens/RoomDetailScreen.kt): `app/shared/src/commonMain/kotlin/com/lumbre/hotel/ui/screens/RoomDetailScreen.kt`
- [Offers](https://github.com/jancarliux24/hotel-lumbre/blob/main/app/shared/src/commonMain/kotlin/com/lumbre/hotel/ui/screens/OffersScreen.kt): `app/shared/src/commonMain/kotlin/com/lumbre/hotel/ui/screens/OffersScreen.kt`
- [Booking flow](https://github.com/jancarliux24/hotel-lumbre/blob/main/app/shared/src/commonMain/kotlin/com/lumbre/hotel/ui/screens/BookingScreen.kt): `app/shared/src/commonMain/kotlin/com/lumbre/hotel/ui/screens/BookingScreen.kt`
- [Trips](https://github.com/jancarliux24/hotel-lumbre/blob/main/app/shared/src/commonMain/kotlin/com/lumbre/hotel/ui/screens/TripsScreen.kt): `app/shared/src/commonMain/kotlin/com/lumbre/hotel/ui/screens/TripsScreen.kt`
- [Profile and account](https://github.com/jancarliux24/hotel-lumbre/blob/main/app/shared/src/commonMain/kotlin/com/lumbre/hotel/ui/screens/ProfileScreen.kt): `app/shared/src/commonMain/kotlin/com/lumbre/hotel/ui/screens/ProfileScreen.kt`
- [Privacy preferences](https://github.com/jancarliux24/hotel-lumbre/blob/main/app/shared/src/commonMain/kotlin/com/lumbre/hotel/ui/screens/PrivacyScreen.kt): `app/shared/src/commonMain/kotlin/com/lumbre/hotel/ui/screens/PrivacyScreen.kt`
- [Digital key](https://github.com/jancarliux24/hotel-lumbre/blob/main/app/shared/src/commonMain/kotlin/com/lumbre/hotel/ui/screens/KeyScreen.kt): `app/shared/src/commonMain/kotlin/com/lumbre/hotel/ui/screens/KeyScreen.kt`

### Hotel operations

- [Admin panel](https://github.com/jancarliux24/hotel-lumbre/blob/main/app/shared/src/commonMain/kotlin/com/lumbre/hotel/ui/screens/AdminScreen.kt): `app/shared/src/commonMain/kotlin/com/lumbre/hotel/ui/screens/AdminScreen.kt`
- [Reception desk](https://github.com/jancarliux24/hotel-lumbre/blob/main/app/shared/src/commonMain/kotlin/com/lumbre/hotel/ui/screens/ReceptionScreen.kt): `app/shared/src/commonMain/kotlin/com/lumbre/hotel/ui/screens/ReceptionScreen.kt`
- [Superuser panel](https://github.com/jancarliux24/hotel-lumbre/blob/main/app/shared/src/commonMain/kotlin/com/lumbre/hotel/ui/screens/SuperAdminScreen.kt): `app/shared/src/commonMain/kotlin/com/lumbre/hotel/ui/screens/SuperAdminScreen.kt`

### Shared services

- [Hotel repository](https://github.com/jancarliux24/hotel-lumbre/blob/main/app/shared/src/commonMain/kotlin/com/lumbre/hotel/data/HotelRepository.kt): `app/shared/src/commonMain/kotlin/com/lumbre/hotel/data/HotelRepository.kt`
- [Pricing rules](https://github.com/jancarliux24/hotel-lumbre/blob/main/app/shared/src/commonMain/kotlin/com/lumbre/hotel/domain/Pricing.kt): `app/shared/src/commonMain/kotlin/com/lumbre/hotel/domain/Pricing.kt`
- [Input validation](https://github.com/jancarliux24/hotel-lumbre/blob/main/app/shared/src/commonMain/kotlin/com/lumbre/hotel/domain/Validation.kt): `app/shared/src/commonMain/kotlin/com/lumbre/hotel/domain/Validation.kt`
- [Currency and dates](https://github.com/jancarliux24/hotel-lumbre/blob/main/app/shared/src/commonMain/kotlin/com/lumbre/hotel/domain/Format.kt): `app/shared/src/commonMain/kotlin/com/lumbre/hotel/domain/Format.kt`
- [Hotel catalog data](https://github.com/jancarliux24/hotel-lumbre/blob/main/app/shared/src/commonMain/kotlin/com/lumbre/hotel/ui/components/Catalog.kt): `app/shared/src/commonMain/kotlin/com/lumbre/hotel/ui/components/Catalog.kt`
- [Translations](https://github.com/jancarliux24/hotel-lumbre/blob/main/app/shared/src/commonMain/kotlin/com/lumbre/hotel/i18n/Strings.kt): `app/shared/src/commonMain/kotlin/com/lumbre/hotel/i18n/Strings.kt`
- [Lumi mascot](https://github.com/jancarliux24/hotel-lumbre/blob/main/app/shared/src/commonMain/kotlin/com/lumbre/hotel/ui/components/Lumi.kt): `app/shared/src/commonMain/kotlin/com/lumbre/hotel/ui/components/Lumi.kt`

### External services

- [Firebase APIs](https://github.com/jancarliux24/hotel-lumbre/blob/main/app/shared/src/commonMain/kotlin/com/lumbre/hotel/data/firebase/FirebaseApi.kt): `app/shared/src/commonMain/kotlin/com/lumbre/hotel/data/firebase/FirebaseApi.kt`
- **Cloud data**
- [Location lookup](https://github.com/jancarliux24/hotel-lumbre/blob/main/app/shared/src/commonMain/kotlin/com/lumbre/hotel/platform/Location.kt): `app/shared/src/commonMain/kotlin/com/lumbre/hotel/platform/Location.kt`
- **Reverse geocoder**

### Other components

- **Guest**
- [Static hotel website](https://github.com/jancarliux24/hotel-lumbre/blob/main/js/app.js): `js/app.js`

## Connections

- Guest → Android host: opens
- Guest → iOS host: opens
- Guest → Web host: opens
- Android host → Shared app and navigation: launches (evidence: `app/androidApp/src/main/kotlin/com/lumbre/hotel/MainActivity.kt`)
- iOS host → Shared app and navigation: embeds (evidence: `app/shared/src/iosMain/kotlin/com/lumbre/hotel/MainViewController.kt`)
- Web host → Shared app and navigation: launches (evidence: `app/webApp/src/wasmJsMain/kotlin/com/lumbre/hotel/main.kt`)
- Shared app and navigation → Home and discovery: routes to (evidence: `app/shared/src/commonMain/kotlin/com/lumbre/hotel/App.kt`)
- Shared app and navigation → Room catalog: routes to (evidence: `app/shared/src/commonMain/kotlin/com/lumbre/hotel/App.kt`)
- Shared app and navigation → Room details: routes to (evidence: `app/shared/src/commonMain/kotlin/com/lumbre/hotel/App.kt`)
- Shared app and navigation → Offers: routes to (evidence: `app/shared/src/commonMain/kotlin/com/lumbre/hotel/App.kt`)
- Shared app and navigation → Booking flow: routes to (evidence: `app/shared/src/commonMain/kotlin/com/lumbre/hotel/App.kt`)
- Shared app and navigation → Trips: routes to (evidence: `app/shared/src/commonMain/kotlin/com/lumbre/hotel/App.kt`)
- Shared app and navigation → Profile and account: routes to (evidence: `app/shared/src/commonMain/kotlin/com/lumbre/hotel/App.kt`)
- Shared app and navigation → Privacy preferences: routes to (evidence: `app/shared/src/commonMain/kotlin/com/lumbre/hotel/App.kt`)
- Shared app and navigation → Digital key: routes to (evidence: `app/shared/src/commonMain/kotlin/com/lumbre/hotel/App.kt`)
- Shared app and navigation → Admin panel: routes to (evidence: `app/shared/src/commonMain/kotlin/com/lumbre/hotel/App.kt`)
- Shared app and navigation → Reception desk: routes to (evidence: `app/shared/src/commonMain/kotlin/com/lumbre/hotel/App.kt`)
- Shared app and navigation → Superuser panel: routes to (evidence: `app/shared/src/commonMain/kotlin/com/lumbre/hotel/App.kt`)
- Booking flow → Pricing rules: calculates quote (evidence: `app/shared/src/commonMain/kotlin/com/lumbre/hotel/ui/screens/BookingScreen.kt`)
- Booking flow → Input validation: validates input (evidence: `app/shared/src/commonMain/kotlin/com/lumbre/hotel/ui/screens/BookingScreen.kt`)
- Booking flow → Hotel repository: reads promos (evidence: `app/shared/src/commonMain/kotlin/com/lumbre/hotel/ui/screens/BookingScreen.kt`)
- Booking flow → Hotel repository: records booking
- Hotel repository → Firebase APIs: calls APIs (evidence: `app/shared/src/commonMain/kotlin/com/lumbre/hotel/data/HotelRepository.kt`)
- Firebase APIs → Cloud data: reads and writes
- Hotel repository → Currency and dates: uses formatting
- Home and discovery → Hotel catalog data: reads catalog (evidence: `app/shared/src/commonMain/kotlin/com/lumbre/hotel/ui/screens/HomeScreen.kt`)
- Room catalog → Hotel catalog data: reads catalog (evidence: `app/shared/src/commonMain/kotlin/com/lumbre/hotel/ui/screens/RoomsScreen.kt`)
- Room details → Hotel catalog data: reads catalog (evidence: `app/shared/src/commonMain/kotlin/com/lumbre/hotel/ui/screens/RoomDetailScreen.kt`)
- Trips → Hotel repository: reads reservations
- Profile and account → Hotel repository: manages account
- Admin panel → Hotel repository: manages hotel data
- Reception desk → Hotel repository: reads arrivals
- Superuser panel → Hotel repository: manages roles
- Shared app and navigation → Translations: uses translations (evidence: `app/shared/src/commonMain/kotlin/com/lumbre/hotel/App.kt`)
- Shared app and navigation → Lumi mascot: renders mascot (evidence: `app/shared/src/commonMain/kotlin/com/lumbre/hotel/App.kt`)
- Location lookup → Reverse geocoder: queries country (evidence: `app/shared/src/commonMain/kotlin/com/lumbre/hotel/platform/Location.kt`)
- Guest → Static hotel website: visits
