# crisurbina0404/hotelica architecture

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

- Interactive diagram: https://gitdiagram.com/crisurbina0404/hotelica
- Repository: https://github.com/crisurbina0404/hotelica

## Overview

Hotelica is a hotel discovery and reservation platform for Nicaragua, with separate tourist, hotelier, and administrator workflows. Visitors search and compare hotels, inspect rooms and availability, then create a reservation; hoteliers manage property listings and reservation operations, while administrators moderate hotels and users and review statistics. The graph follows the documented screens and the sampled app entry, store, and reservation code. Several feature modules are represented by their exact paths, but their internal calls are not asserted where excerpts do not show them.

Main entry points: [`src/App.tsx`](https://github.com/crisurbina0404/hotelica/blob/main/src/App.tsx) (App Router), [`src/store.tsx`](https://github.com/crisurbina0404/hotelica/blob/main/src/store.tsx) (App State), [`src/pages/BookingModal.tsx`](https://github.com/crisurbina0404/hotelica/blob/main/src/pages/BookingModal.tsx) (Booking Wizard), [`src/pages/HotelPanel.tsx`](https://github.com/crisurbina0404/hotelica/blob/main/src/pages/HotelPanel.tsx) (Hotel Dashboard)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Application Shell"]
  node_app["App Router<br/>[App.tsx]"]
  node_routes["URL Routes<br/>[rutas.ts]"]
end

subgraph group_tourist["Tourist Experience"]
  node_home["Hotel Search<br/>[Home.tsx]"]
  node_results["Search Results<br/>[Results.tsx]"]
  node_detail["Hotel Details<br/>[HotelDetail.tsx]"]
  node_destinations["Destinations<br/>[Destinos.tsx]"]
  node_booking["Booking Wizard<br/>[BookingModal.tsx]"]
  node_myreservations["My Reservations<br/>[MyReservations.tsx]"]
  node_profile["Account Profile<br/>[Profile.tsx]"]
  node_auth["Password Access<br/>[ForgotPassword.tsx]"]
  node_reset["Password Reset<br/>[ResetPassword.tsx]"]
end

subgraph group_hotel["Hotel Operations"]
  node_hotelpanel["Hotel Dashboard<br/>[HotelPanel.tsx]"]
  node_hotelregistration["Hotel Registration<br/>[InscribeHotel.tsx]"]
  node_calendar["Availability Calendar"]
end

subgraph group_admin["Administration"]
  node_adminpanel["Hotel Moderation<br/>[AdminPanel.tsx]"]
  node_globalstats["Global Statistics"]
  node_stats["Statistics Logic<br/>[estadisticas.ts]"]
  node_exportstats["Statistics Export"]
end

subgraph group_platform["Shared Platform"]
  node_store["App State<br/>[store.tsx]"]
  node_catalog[("Hotel Catalog Data<br/>[data.ts]")]
  node_supabase["Supabase Client<br/>[supabase.ts]"]
  node_sync["Data Synchronization<br/>[sync.ts]"]
  node_email["Email Templates<br/>[correo.ts]"]
end

node_visitor(("Tourist"))
node_hotelier(("Hotelier"))
node_administrator(("Administrator"))

node_visitor -->|"opens"| node_app
node_hotelier -.->|"opens"| node_app
node_administrator -.->|"opens"| node_app
node_app -->|"provides state"| node_store
node_app -->|"resolves URL"| node_routes
node_app -->|"renders"| node_home
node_app -->|"renders"| node_results
node_app -->|"renders"| node_detail
node_app -->|"renders"| node_destinations
node_app -->|"renders"| node_myreservations
node_app -->|"renders"| node_hotelpanel
node_app -->|"renders"| node_adminpanel
node_app -->|"renders"| node_profile
node_app -->|"renders"| node_auth
node_app -->|"renders"| node_reset
node_home -.->|"navigates"| node_results
node_results -.->|"opens hotel"| node_detail
node_detail -->|"opens booking"| node_booking
node_booking -->|"creates reservation"| node_store
node_booking -->|"calculates totals"| node_catalog
node_hotelier -.->|"registers property"| node_hotelregistration
node_hotelpanel -.->|"manages bookings"| node_store
node_hotelpanel -.->|"manages availability"| node_calendar
node_administrator -.->|"moderates hotels"| node_adminpanel
node_adminpanel -->|"opens statistics"| node_globalstats
node_globalstats -->|"computes metrics"| node_stats
node_globalstats -->|"exports reports"| node_exportstats
node_store -->|"loads domain data"| node_catalog
node_store -->|"uses client"| node_supabase
node_store -->|"uploads reviews"| node_sync
node_sync -->|"syncs data"| node_supabase
node_supabase -.->|"triggers email"| node_email

click node_app "https://github.com/crisurbina0404/hotelica/blob/main/src/App.tsx"
click node_routes "https://github.com/crisurbina0404/hotelica/blob/main/src/rutas.ts"
click node_home "https://github.com/crisurbina0404/hotelica/blob/main/src/pages/Home.tsx"
click node_results "https://github.com/crisurbina0404/hotelica/blob/main/src/pages/Results.tsx"
click node_detail "https://github.com/crisurbina0404/hotelica/blob/main/src/pages/HotelDetail.tsx"
click node_destinations "https://github.com/crisurbina0404/hotelica/blob/main/src/pages/Destinos.tsx"
click node_booking "https://github.com/crisurbina0404/hotelica/blob/main/src/pages/BookingModal.tsx"
click node_myreservations "https://github.com/crisurbina0404/hotelica/blob/main/src/pages/MyReservations.tsx"
click node_profile "https://github.com/crisurbina0404/hotelica/blob/main/src/pages/Profile.tsx"
click node_auth "https://github.com/crisurbina0404/hotelica/blob/main/src/pages/ForgotPassword.tsx"
click node_reset "https://github.com/crisurbina0404/hotelica/blob/main/src/pages/ResetPassword.tsx"
click node_hotelpanel "https://github.com/crisurbina0404/hotelica/blob/main/src/pages/HotelPanel.tsx"
click node_hotelregistration "https://github.com/crisurbina0404/hotelica/blob/main/src/pages/InscribeHotel.tsx"
click node_calendar "https://github.com/crisurbina0404/hotelica/blob/main/src/pages/CalendarioDisponibilidad.tsx"
click node_adminpanel "https://github.com/crisurbina0404/hotelica/blob/main/src/pages/AdminPanel.tsx"
click node_globalstats "https://github.com/crisurbina0404/hotelica/blob/main/src/pages/EstadisticasGlobales.tsx"
click node_stats "https://github.com/crisurbina0404/hotelica/blob/main/src/estadisticas.ts"
click node_store "https://github.com/crisurbina0404/hotelica/blob/main/src/store.tsx"
click node_catalog "https://github.com/crisurbina0404/hotelica/blob/main/src/data.ts"
click node_supabase "https://github.com/crisurbina0404/hotelica/blob/main/src/lib/supabase.ts"
click node_sync "https://github.com/crisurbina0404/hotelica/blob/main/src/sync.ts"
click node_email "https://github.com/crisurbina0404/hotelica/blob/main/supabase/functions/_shared/correo.ts"
click node_exportstats "https://github.com/crisurbina0404/hotelica/blob/main/src/exportarEstadisticas.ts"

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_app,node_routes toneBlue
class node_home,node_results,node_detail,node_destinations,node_booking,node_myreservations,node_profile,node_auth,node_reset toneAmber
class node_hotelpanel,node_hotelregistration,node_calendar toneMint
class node_adminpanel,node_globalstats,node_stats,node_exportstats toneRose
class node_store,node_catalog,node_supabase,node_sync,node_email,node_visitor,node_hotelier,node_administrator toneIndigo
```

## Components

### Application Shell

- [App Router](https://github.com/crisurbina0404/hotelica/blob/main/src/App.tsx): `src/App.tsx`
- [URL Routes](https://github.com/crisurbina0404/hotelica/blob/main/src/rutas.ts): `src/rutas.ts`

### Tourist Experience

- [Hotel Search](https://github.com/crisurbina0404/hotelica/blob/main/src/pages/Home.tsx): `src/pages/Home.tsx`
- [Search Results](https://github.com/crisurbina0404/hotelica/blob/main/src/pages/Results.tsx): `src/pages/Results.tsx`
- [Hotel Details](https://github.com/crisurbina0404/hotelica/blob/main/src/pages/HotelDetail.tsx): `src/pages/HotelDetail.tsx`
- [Destinations](https://github.com/crisurbina0404/hotelica/blob/main/src/pages/Destinos.tsx): `src/pages/Destinos.tsx`
- [Booking Wizard](https://github.com/crisurbina0404/hotelica/blob/main/src/pages/BookingModal.tsx): `src/pages/BookingModal.tsx`
- [My Reservations](https://github.com/crisurbina0404/hotelica/blob/main/src/pages/MyReservations.tsx): `src/pages/MyReservations.tsx`
- [Account Profile](https://github.com/crisurbina0404/hotelica/blob/main/src/pages/Profile.tsx): `src/pages/Profile.tsx`
- [Password Access](https://github.com/crisurbina0404/hotelica/blob/main/src/pages/ForgotPassword.tsx): `src/pages/ForgotPassword.tsx`
- [Password Reset](https://github.com/crisurbina0404/hotelica/blob/main/src/pages/ResetPassword.tsx): `src/pages/ResetPassword.tsx`

### Hotel Operations

- [Hotel Dashboard](https://github.com/crisurbina0404/hotelica/blob/main/src/pages/HotelPanel.tsx): `src/pages/HotelPanel.tsx`
- [Hotel Registration](https://github.com/crisurbina0404/hotelica/blob/main/src/pages/InscribeHotel.tsx): `src/pages/InscribeHotel.tsx`
- [Availability Calendar](https://github.com/crisurbina0404/hotelica/blob/main/src/pages/CalendarioDisponibilidad.tsx): `src/pages/CalendarioDisponibilidad.tsx`

### Administration

- [Hotel Moderation](https://github.com/crisurbina0404/hotelica/blob/main/src/pages/AdminPanel.tsx): `src/pages/AdminPanel.tsx`
- [Global Statistics](https://github.com/crisurbina0404/hotelica/blob/main/src/pages/EstadisticasGlobales.tsx): `src/pages/EstadisticasGlobales.tsx`
- [Statistics Logic](https://github.com/crisurbina0404/hotelica/blob/main/src/estadisticas.ts): `src/estadisticas.ts`
- [Statistics Export](https://github.com/crisurbina0404/hotelica/blob/main/src/exportarEstadisticas.ts): `src/exportarEstadisticas.ts`

### Shared Platform

- [App State](https://github.com/crisurbina0404/hotelica/blob/main/src/store.tsx): `src/store.tsx`
- [Hotel Catalog Data](https://github.com/crisurbina0404/hotelica/blob/main/src/data.ts): `src/data.ts`
- [Supabase Client](https://github.com/crisurbina0404/hotelica/blob/main/src/lib/supabase.ts): `src/lib/supabase.ts`
- [Data Synchronization](https://github.com/crisurbina0404/hotelica/blob/main/src/sync.ts): `src/sync.ts`
- [Email Templates](https://github.com/crisurbina0404/hotelica/blob/main/supabase/functions/_shared/correo.ts): `supabase/functions/_shared/correo.ts`

### Other components

- **Tourist**
- **Hotelier**
- **Administrator**

## Connections

- Tourist → App Router: opens (evidence: `src/App.tsx`)
- Hotelier → App Router: opens
- Administrator → App Router: opens
- App Router → App State: provides state (evidence: `src/App.tsx`)
- App Router → URL Routes: resolves URL (evidence: `src/App.tsx`)
- App Router → Hotel Search: renders (evidence: `src/App.tsx`)
- App Router → Search Results: renders (evidence: `src/App.tsx`)
- App Router → Hotel Details: renders (evidence: `src/App.tsx`)
- App Router → Destinations: renders (evidence: `src/App.tsx`)
- App Router → My Reservations: renders (evidence: `src/App.tsx`)
- App Router → Hotel Dashboard: renders (evidence: `src/App.tsx`)
- App Router → Hotel Moderation: renders (evidence: `src/App.tsx`)
- App Router → Account Profile: renders (evidence: `src/App.tsx`)
- App Router → Password Access: renders (evidence: `src/App.tsx`)
- App Router → Password Reset: renders (evidence: `src/App.tsx`)
- Hotel Search → Search Results: navigates
- Search Results → Hotel Details: opens hotel
- Hotel Details → Booking Wizard: opens booking (evidence: `src/pages/HotelDetail.tsx`)
- Booking Wizard → App State: creates reservation (evidence: `src/pages/BookingModal.tsx`)
- Booking Wizard → Hotel Catalog Data: calculates totals (evidence: `src/pages/BookingModal.tsx`)
- Hotelier → Hotel Registration: registers property
- Hotel Dashboard → App State: manages bookings (evidence: `src/pages/HotelPanel.tsx`)
- Hotel Dashboard → Availability Calendar: manages availability
- Administrator → Hotel Moderation: moderates hotels
- Hotel Moderation → Global Statistics: opens statistics (evidence: `src/pages/AdminPanel.tsx`)
- Global Statistics → Statistics Logic: computes metrics (evidence: `src/pages/EstadisticasGlobales.tsx`)
- Global Statistics → Statistics Export: exports reports (evidence: `src/pages/EstadisticasGlobales.tsx`)
- App State → Hotel Catalog Data: loads domain data (evidence: `src/store.tsx`)
- App State → Supabase Client: uses client (evidence: `src/store.tsx`)
- App State → Data Synchronization: uploads reviews (evidence: `src/store.tsx`)
- Data Synchronization → Supabase Client: syncs data (evidence: `src/sync.ts`)
- Supabase Client → Email Templates: triggers email
