# alwayswannaflywxy/hotel-aircon-cleaning-system architecture

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

- Interactive diagram: https://gitdiagram.com/alwayswannaflywxy/hotel-aircon-cleaning-system
- Repository: https://github.com/alwayswannaflywxy/hotel-aircon-cleaning-system

## Overview

AirCare is a Laravel hotel air-conditioning cleaning tracker. A logged-in staff member selects a floor, reviews room status, records a cleaning with their name, and can open a floor or all-floor printable report. The map separates authentication, room operations, presentation, and request infrastructure. Relationships are limited to controller calls and documented routes/views; database persistence is represented cautiously because the excerpts do not show schema or connection behavior.

Main entry points: [`app/Http/Controllers/RoomController.php`](https://github.com/alwayswannaflywxy/hotel-aircon-cleaning-system/blob/main/app/Http/Controllers/RoomController.php) (Room workflows), [`routes/web.php`](https://github.com/alwayswannaflywxy/hotel-aircon-cleaning-system/blob/main/routes/web.php) (Web routes), [`app/Http/Controllers/AuthController.php`](https://github.com/alwayswannaflywxy/hotel-aircon-cleaning-system/blob/main/app/Http/Controllers/AuthController.php) (Login and logout), [`app/Models/Room.php`](https://github.com/alwayswannaflywxy/hotel-aircon-cleaning-system/blob/main/app/Models/Room.php) (Room status)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_access["Authentication"]
  node_auth_controller["Login and logout<br/>[AuthController.php]"]
  node_user["User account<br/>[User.php]"]
end

subgraph group_operations["Room operations"]
  node_room_controller["Room workflows<br/>[RoomController.php]"]
  node_room["Room status<br/>[Room.php]"]
  node_cleaning_record["Cleaning history<br/>[CleaningRecord.php]"]
end

subgraph group_presentation["User interface"]
  node_login_view["Login screen<br/>[login.blade.php]"]
  node_room_list["Floor dashboard<br/>[index.blade.php]"]
  node_clean_form["Cleaning form<br/>[clean.blade.php]"]
  node_report_view["Printable report<br/>[report.blade.php]"]
end

subgraph group_runtime["Request runtime"]
  node_web_routes["Web routes<br/>[web.php]"]
  node_route_provider["Route registration"]
  node_http_kernel["HTTP middleware<br/>[Kernel.php]"]
end

node_staff(("Hotel staff"))
node_database[("Application database")]

node_staff -->|"uses"| node_web_routes
node_route_provider -->|"loads routes"| node_web_routes
node_web_routes -->|"dispatches"| node_auth_controller
node_web_routes -->|"dispatches"| node_room_controller
node_http_kernel -->|"applies web middleware"| node_web_routes
node_auth_controller -.->|"authenticates"| node_user
node_auth_controller -->|"redirects after login"| node_room_list
node_staff -->|"signs in"| node_login_view
node_staff -->|"requests rooms or reports"| node_room_controller
node_room_controller -->|"queries and updates"| node_room
node_room_controller -->|"creates history"| node_cleaning_record
node_room -->|"defines records relation"| node_cleaning_record
node_room_controller -->|"renders dashboard"| node_room_list
node_room_controller -->|"renders cleaning form"| node_clean_form
node_room_controller -->|"renders report"| node_report_view
node_room -.->|"persists room state"| node_database
node_cleaning_record -.->|"stores audit history"| node_database
node_staff -->|"prints floor report"| node_report_view

click node_web_routes "https://github.com/alwayswannaflywxy/hotel-aircon-cleaning-system/blob/main/routes/web.php"
click node_route_provider "https://github.com/alwayswannaflywxy/hotel-aircon-cleaning-system/blob/main/app/Providers/RouteServiceProvider.php"
click node_http_kernel "https://github.com/alwayswannaflywxy/hotel-aircon-cleaning-system/blob/main/app/Http/Kernel.php"
click node_auth_controller "https://github.com/alwayswannaflywxy/hotel-aircon-cleaning-system/blob/main/app/Http/Controllers/AuthController.php"
click node_user "https://github.com/alwayswannaflywxy/hotel-aircon-cleaning-system/blob/main/app/Models/User.php"
click node_room_controller "https://github.com/alwayswannaflywxy/hotel-aircon-cleaning-system/blob/main/app/Http/Controllers/RoomController.php"
click node_room "https://github.com/alwayswannaflywxy/hotel-aircon-cleaning-system/blob/main/app/Models/Room.php"
click node_cleaning_record "https://github.com/alwayswannaflywxy/hotel-aircon-cleaning-system/blob/main/app/Models/CleaningRecord.php"
click node_login_view "https://github.com/alwayswannaflywxy/hotel-aircon-cleaning-system/blob/main/resources/views/auth/login.blade.php"
click node_room_list "https://github.com/alwayswannaflywxy/hotel-aircon-cleaning-system/blob/main/resources/views/rooms/index.blade.php"
click node_clean_form "https://github.com/alwayswannaflywxy/hotel-aircon-cleaning-system/blob/main/resources/views/rooms/clean.blade.php"
click node_report_view "https://github.com/alwayswannaflywxy/hotel-aircon-cleaning-system/blob/main/resources/views/rooms/report.blade.php"

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_auth_controller,node_user toneBlue
class node_room_controller,node_room,node_cleaning_record,node_database toneAmber
class node_login_view,node_room_list,node_clean_form,node_report_view toneMint
class node_web_routes,node_route_provider,node_http_kernel toneRose
class node_staff toneIndigo
```

## Components

### Authentication

- [Login and logout](https://github.com/alwayswannaflywxy/hotel-aircon-cleaning-system/blob/main/app/Http/Controllers/AuthController.php): `app/Http/Controllers/AuthController.php`
- [User account](https://github.com/alwayswannaflywxy/hotel-aircon-cleaning-system/blob/main/app/Models/User.php): `app/Models/User.php`

### Room operations

- [Room workflows](https://github.com/alwayswannaflywxy/hotel-aircon-cleaning-system/blob/main/app/Http/Controllers/RoomController.php): `app/Http/Controllers/RoomController.php`
- [Room status](https://github.com/alwayswannaflywxy/hotel-aircon-cleaning-system/blob/main/app/Models/Room.php): `app/Models/Room.php`
- [Cleaning history](https://github.com/alwayswannaflywxy/hotel-aircon-cleaning-system/blob/main/app/Models/CleaningRecord.php): `app/Models/CleaningRecord.php`

### User interface

- [Login screen](https://github.com/alwayswannaflywxy/hotel-aircon-cleaning-system/blob/main/resources/views/auth/login.blade.php): `resources/views/auth/login.blade.php`
- [Floor dashboard](https://github.com/alwayswannaflywxy/hotel-aircon-cleaning-system/blob/main/resources/views/rooms/index.blade.php): `resources/views/rooms/index.blade.php`
- [Cleaning form](https://github.com/alwayswannaflywxy/hotel-aircon-cleaning-system/blob/main/resources/views/rooms/clean.blade.php): `resources/views/rooms/clean.blade.php`
- [Printable report](https://github.com/alwayswannaflywxy/hotel-aircon-cleaning-system/blob/main/resources/views/rooms/report.blade.php): `resources/views/rooms/report.blade.php`

### Request runtime

- [Web routes](https://github.com/alwayswannaflywxy/hotel-aircon-cleaning-system/blob/main/routes/web.php): `routes/web.php`
- [Route registration](https://github.com/alwayswannaflywxy/hotel-aircon-cleaning-system/blob/main/app/Providers/RouteServiceProvider.php): `app/Providers/RouteServiceProvider.php`
- [HTTP middleware](https://github.com/alwayswannaflywxy/hotel-aircon-cleaning-system/blob/main/app/Http/Kernel.php): `app/Http/Kernel.php`

### Other components

- **Hotel staff**
- **Application database**

## Connections

- Hotel staff → Web routes: uses (evidence: `README.md`)
- Route registration → Web routes: loads routes (evidence: `app/Providers/RouteServiceProvider.php`)
- Web routes → Login and logout: dispatches (evidence: `routes/web.php`)
- Web routes → Room workflows: dispatches (evidence: `routes/web.php`)
- HTTP middleware → Web routes: applies web middleware (evidence: `app/Http/Kernel.php`)
- Login and logout → User account: authenticates
- Login and logout → Floor dashboard: redirects after login (evidence: `app/Http/Controllers/AuthController.php`)
- Hotel staff → Login screen: signs in (evidence: `README.md`)
- Hotel staff → Room workflows: requests rooms or reports (evidence: `README.md`)
- Room workflows → Room status: queries and updates (evidence: `app/Http/Controllers/RoomController.php`)
- Room workflows → Cleaning history: creates history (evidence: `app/Http/Controllers/RoomController.php`)
- Room status → Cleaning history: defines records relation (evidence: `app/Models/Room.php`)
- Room workflows → Floor dashboard: renders dashboard (evidence: `app/Http/Controllers/RoomController.php`)
- Room workflows → Cleaning form: renders cleaning form (evidence: `app/Http/Controllers/RoomController.php`)
- Room workflows → Printable report: renders report (evidence: `app/Http/Controllers/RoomController.php`)
- Room status → Application database: persists room state
- Cleaning history → Application database: stores audit history
- Hotel staff → Printable report: prints floor report (evidence: `README.md`)
