# aaroondaniel/sishotelsanantonio architecture

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

- Interactive diagram: https://gitdiagram.com/aaroondaniel/sishotelsanantonio
- Repository: https://github.com/aaroondaniel/sishotelsanantonio

## Overview

This is a hotel operations and lodging-management application, with Laravel handling business workflows and React/Inertia providing its staff interface. The main operational journey is reservation management, room assignment and check-in, then stay charges, payments, checkout, and invoicing; cash registers support shift-level accounting. Separate capabilities cover group accounts, reporting, administration, and SIAT electronic invoicing, including offline contingency. The tree and source index support the components and cited relationships below; unsampled routes and UI-to-controller wiring are not asserted.

Main entry points: [`app/Http/Controllers/CheckinController.php`](https://github.com/aaroondaniel/sishotelsanantonio/blob/main/app/Http/Controllers/CheckinController.php) (Check-in and checkout), [`app/Models/Checkin.php`](https://github.com/aaroondaniel/sishotelsanantonio/blob/main/app/Models/Checkin.php) (Stay records), [`app/Http/Controllers/ReservationController.php`](https://github.com/aaroondaniel/sishotelsanantonio/blob/main/app/Http/Controllers/ReservationController.php) (Reservations), [`app/Models/Payment.php`](https://github.com/aaroondaniel/sishotelsanantonio/blob/main/app/Models/Payment.php) (Payments)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_lodging["Reservations and stays"]
  node_reservations["Reservations"]
  node_reservation_data[("Reservation records<br/>[Reservation.php]")]
  node_checkin["Check-in and checkout"]
  node_checkin_data[("Stay records<br/>[Checkin.php]")]
  node_guests[("Guest records<br/>[Guest.php]")]
end

subgraph group_finance["Payments and accounting"]
  node_payments[("Payments<br/>[Payment.php]")]
  node_cash[("Cash registers<br/>[CashRegister.php]")]
  node_expenses[("Expenses<br/>[Expense.php]")]
  node_group_accounts[("Group accounts")]
end

subgraph group_billing["Invoicing and SIAT"]
  node_invoices[("Invoices<br/>[Invoice.php]")]
  node_invoice_ops["Invoice operations"]
  node_siat_xml["SIAT XML builder<br/>[SiatXmlBuilder.php]"]
  node_siat["SIAT integration<br/>[SiatService.php]"]
  node_events[("Significant events")]
end

subgraph group_operations["Hotel operations"]
  node_rooms[("Room inventory<br/>[Room.php]")]
  node_reports["Reports"]
  node_cocina["Operations dashboard"]
  node_users[("User accounts<br/>[User.php]")]
end

subgraph group_interface["Staff interface"]
  node_web_ui["Staff screens"]
end

node_staff(("Hotel staff"))

node_staff -.->|"uses"| node_web_ui
node_web_ui -.->|"submits requests"| node_reservations
node_web_ui -.->|"submits requests"| node_checkin
node_reservations -->|"manages"| node_reservation_data
node_reservations -->|"uses"| node_guests
node_reservations -->|"uses"| node_rooms
node_reservations -->|"records"| node_payments
node_reservations -->|"creates"| node_checkin_data
node_checkin -->|"manages"| node_checkin_data
node_checkin -->|"uses"| node_guests
node_checkin -->|"updates"| node_rooms
node_checkin -->|"records"| node_payments
node_checkin -->|"issues"| node_invoices
node_checkin -->|"builds XML"| node_siat_xml
node_checkin -->|"submits invoices"| node_siat
node_invoice_ops -->|"manages"| node_invoices
node_invoice_ops -->|"builds XML"| node_siat_xml
node_invoice_ops -->|"calls SIAT"| node_siat
node_invoices -->|"references"| node_events
node_siat_xml -->|"reads invoice data"| node_invoices
node_siat_xml -->|"reads guest data"| node_guests
node_checkin_data -->|"references"| node_rooms
node_checkin_data -->|"references"| node_guests
node_checkin_data -->|"references"| node_payments
node_cash -->|"tracks"| node_payments
node_cash -->|"tracks"| node_expenses
node_group_accounts -->|"aggregates"| node_payments
node_group_accounts -->|"groups stays"| node_checkin_data
node_reports -->|"queries"| node_checkin_data
node_reports -->|"queries"| node_payments
node_reports -->|"queries"| node_cash
node_reports -->|"queries"| node_expenses
node_cocina -.->|"uses"| node_checkin_data

click node_web_ui "https://github.com/aaroondaniel/sishotelsanantonio/tree/main/resources/js/pages"
click node_reservations "https://github.com/aaroondaniel/sishotelsanantonio/blob/main/app/Http/Controllers/ReservationController.php"
click node_reservation_data "https://github.com/aaroondaniel/sishotelsanantonio/blob/main/app/Models/Reservation.php"
click node_checkin "https://github.com/aaroondaniel/sishotelsanantonio/blob/main/app/Http/Controllers/CheckinController.php"
click node_checkin_data "https://github.com/aaroondaniel/sishotelsanantonio/blob/main/app/Models/Checkin.php"
click node_guests "https://github.com/aaroondaniel/sishotelsanantonio/blob/main/app/Models/Guest.php"
click node_rooms "https://github.com/aaroondaniel/sishotelsanantonio/blob/main/app/Models/Room.php"
click node_payments "https://github.com/aaroondaniel/sishotelsanantonio/blob/main/app/Models/Payment.php"
click node_cash "https://github.com/aaroondaniel/sishotelsanantonio/blob/main/app/Models/CashRegister.php"
click node_expenses "https://github.com/aaroondaniel/sishotelsanantonio/blob/main/app/Models/Expense.php"
click node_group_accounts "https://github.com/aaroondaniel/sishotelsanantonio/blob/main/app/Models/SpecialAgreement.php"
click node_invoices "https://github.com/aaroondaniel/sishotelsanantonio/blob/main/app/Models/Invoice.php"
click node_invoice_ops "https://github.com/aaroondaniel/sishotelsanantonio/blob/main/app/Http/Controllers/InvoiceController.php"
click node_siat_xml "https://github.com/aaroondaniel/sishotelsanantonio/blob/main/app/Services/SiatXmlBuilder.php"
click node_siat "https://github.com/aaroondaniel/sishotelsanantonio/blob/main/app/Services/SiatService.php"
click node_events "https://github.com/aaroondaniel/sishotelsanantonio/blob/main/app/Models/SignificantEvent.php"
click node_reports "https://github.com/aaroondaniel/sishotelsanantonio/blob/main/app/Http/Controllers/ReportController.php"
click node_cocina "https://github.com/aaroondaniel/sishotelsanantonio/blob/main/app/Http/Controllers/CocinaController.php"
click node_users "https://github.com/aaroondaniel/sishotelsanantonio/blob/main/app/Models/User.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_reservations,node_reservation_data,node_checkin,node_checkin_data,node_guests toneBlue
class node_payments,node_cash,node_expenses,node_group_accounts toneAmber
class node_invoices,node_invoice_ops,node_siat_xml,node_siat,node_events toneMint
class node_rooms,node_reports,node_cocina,node_users toneRose
class node_web_ui,node_staff toneIndigo
```

## Components

### Reservations and stays

- [Reservations](https://github.com/aaroondaniel/sishotelsanantonio/blob/main/app/Http/Controllers/ReservationController.php): `app/Http/Controllers/ReservationController.php`
- [Reservation records](https://github.com/aaroondaniel/sishotelsanantonio/blob/main/app/Models/Reservation.php): `app/Models/Reservation.php`
- [Check-in and checkout](https://github.com/aaroondaniel/sishotelsanantonio/blob/main/app/Http/Controllers/CheckinController.php): `app/Http/Controllers/CheckinController.php`
- [Stay records](https://github.com/aaroondaniel/sishotelsanantonio/blob/main/app/Models/Checkin.php): `app/Models/Checkin.php`
- [Guest records](https://github.com/aaroondaniel/sishotelsanantonio/blob/main/app/Models/Guest.php): `app/Models/Guest.php`

### Payments and accounting

- [Payments](https://github.com/aaroondaniel/sishotelsanantonio/blob/main/app/Models/Payment.php): `app/Models/Payment.php`
- [Cash registers](https://github.com/aaroondaniel/sishotelsanantonio/blob/main/app/Models/CashRegister.php): `app/Models/CashRegister.php`
- [Expenses](https://github.com/aaroondaniel/sishotelsanantonio/blob/main/app/Models/Expense.php): `app/Models/Expense.php`
- [Group accounts](https://github.com/aaroondaniel/sishotelsanantonio/blob/main/app/Models/SpecialAgreement.php): `app/Models/SpecialAgreement.php`

### Invoicing and SIAT

- [Invoices](https://github.com/aaroondaniel/sishotelsanantonio/blob/main/app/Models/Invoice.php): `app/Models/Invoice.php`
- [Invoice operations](https://github.com/aaroondaniel/sishotelsanantonio/blob/main/app/Http/Controllers/InvoiceController.php): `app/Http/Controllers/InvoiceController.php`
- [SIAT XML builder](https://github.com/aaroondaniel/sishotelsanantonio/blob/main/app/Services/SiatXmlBuilder.php): `app/Services/SiatXmlBuilder.php`
- [SIAT integration](https://github.com/aaroondaniel/sishotelsanantonio/blob/main/app/Services/SiatService.php): `app/Services/SiatService.php`
- [Significant events](https://github.com/aaroondaniel/sishotelsanantonio/blob/main/app/Models/SignificantEvent.php): `app/Models/SignificantEvent.php`

### Hotel operations

- [Room inventory](https://github.com/aaroondaniel/sishotelsanantonio/blob/main/app/Models/Room.php): `app/Models/Room.php`
- [Reports](https://github.com/aaroondaniel/sishotelsanantonio/blob/main/app/Http/Controllers/ReportController.php): `app/Http/Controllers/ReportController.php`
- [Operations dashboard](https://github.com/aaroondaniel/sishotelsanantonio/blob/main/app/Http/Controllers/CocinaController.php): `app/Http/Controllers/CocinaController.php`
- [User accounts](https://github.com/aaroondaniel/sishotelsanantonio/blob/main/app/Models/User.php): `app/Models/User.php`

### Staff interface

- [Staff screens](https://github.com/aaroondaniel/sishotelsanantonio/tree/main/resources/js/pages): `resources/js/pages`

### Other components

- **Hotel staff**

## Connections

- Hotel staff → Staff screens: uses
- Staff screens → Reservations: submits requests
- Staff screens → Check-in and checkout: submits requests
- Reservations → Reservation records: manages (evidence: `app/Http/Controllers/ReservationController.php`)
- Reservations → Guest records: uses (evidence: `app/Http/Controllers/ReservationController.php`)
- Reservations → Room inventory: uses (evidence: `app/Http/Controllers/ReservationController.php`)
- Reservations → Payments: records (evidence: `app/Http/Controllers/ReservationController.php`)
- Reservations → Stay records: creates (evidence: `app/Http/Controllers/ReservationController.php`)
- Check-in and checkout → Stay records: manages (evidence: `app/Http/Controllers/CheckinController.php`)
- Check-in and checkout → Guest records: uses (evidence: `app/Http/Controllers/CheckinController.php`)
- Check-in and checkout → Room inventory: updates (evidence: `app/Http/Controllers/CheckinController.php`)
- Check-in and checkout → Payments: records (evidence: `app/Http/Controllers/CheckinController.php`)
- Check-in and checkout → Invoices: issues (evidence: `app/Http/Controllers/CheckinController.php`)
- Check-in and checkout → SIAT XML builder: builds XML (evidence: `app/Http/Controllers/CheckinController.php`)
- Check-in and checkout → SIAT integration: submits invoices (evidence: `app/Http/Controllers/CheckinController.php`)
- Invoice operations → Invoices: manages (evidence: `app/Http/Controllers/InvoiceController.php`)
- Invoice operations → SIAT XML builder: builds XML (evidence: `app/Http/Controllers/InvoiceController.php`)
- Invoice operations → SIAT integration: calls SIAT (evidence: `app/Http/Controllers/InvoiceController.php`)
- Invoices → Significant events: references (evidence: `app/Models/Invoice.php`)
- SIAT XML builder → Invoices: reads invoice data (evidence: `app/Services/SiatXmlBuilder.php`)
- SIAT XML builder → Guest records: reads guest data (evidence: `app/Services/SiatXmlBuilder.php`)
- Stay records → Room inventory: references (evidence: `app/Models/Checkin.php`)
- Stay records → Guest records: references (evidence: `app/Models/Checkin.php`)
- Stay records → Payments: references (evidence: `app/Models/Checkin.php`)
- Cash registers → Payments: tracks (evidence: `app/Models/CashRegister.php`)
- Cash registers → Expenses: tracks (evidence: `app/Models/CashRegister.php`)
- Group accounts → Payments: aggregates (evidence: `app/Models/SpecialAgreement.php`)
- Group accounts → Stay records: groups stays (evidence: `app/Models/SpecialAgreement.php`)
- Reports → Stay records: queries (evidence: `app/Http/Controllers/ReportController.php`)
- Reports → Payments: queries (evidence: `app/Http/Controllers/ReportController.php`)
- Reports → Cash registers: queries (evidence: `app/Http/Controllers/ReportController.php`)
- Reports → Expenses: queries (evidence: `app/Http/Controllers/ReportController.php`)
- Operations dashboard → Stay records: uses
