# brunoaguinaga0/incatrack-showcase architecture

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

- Interactive diagram: https://gitdiagram.com/brunoaguinaga0/incatrack-showcase
- Repository: https://github.com/brunoaguinaga0/incatrack-showcase

## Overview

INCA TRACK is a web system for managing Inca Trail excursions. Customers browse packages, book, add companions, pay, and can request rescheduling or review trips; staff, guides, and providers use management workflows. The README documents a React client calling a Laravel REST API, backed by MySQL and integrated with payment and email services, plus scheduled automation. Domain capabilities are shown as API responsibilities, not as an inferred internal call chain. Only the README and image directory are present in the supplied tree, so implementation paths and finer-grained relationships cannot be verified.

Main entry points: [`README.md`](https://github.com/brunoaguinaga0/incatrack-showcase/blob/main/README.md) (Laravel REST API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Web client"]
  node_browser["Browser<br/>[README.md]"]
  node_spa["React SPA<br/>[README.md]"]
end

subgraph group_backend["Backend"]
  node_api["Laravel REST API<br/>[README.md]"]
  node_database[("MySQL<br/>[README.md]")]
end

subgraph group_domain["Excursion management"]
  node_routes["Routes and stages<br/>[README.md]"]
  node_packages["Packages and catalog<br/>[README.md]"]
  node_bookings["Bookings and customers<br/>[README.md]"]
  node_payments["Payments and expiry<br/>[README.md]"]
  node_services["Providers and services<br/>[README.md]"]
  node_guiding["Guide assignments<br/>[README.md]"]
  node_rescheduling["Rescheduling and reviews<br/>[README.md]"]
  node_reports["Reports<br/>[README.md]"]
end

node_customers(("Customers"))
node_staff(("Administrators / employees"))
node_guides(("Guides"))
node_providers(("Providers"))
node_mercadopago["Mercado Pago"]
node_email["Email service"]
node_scheduled["Scheduled tasks"]

node_customers -->|"uses"| node_browser
node_staff -->|"uses"| node_browser
node_guides -->|"uses"| node_browser
node_providers -->|"uses"| node_browser
node_browser -->|"runs"| node_spa
node_spa -->|"JSON / HTTPS"| node_api
node_api -->|"reads / writes"| node_database
node_api -->|"processes payments"| node_mercadopago
node_api -->|"sends email"| node_email
node_scheduled -->|"triggers"| node_api
node_api -->|"manages"| node_routes
node_api -->|"manages"| node_packages
node_api -->|"manages"| node_bookings
node_api -->|"manages"| node_payments
node_api -->|"manages"| node_services
node_api -->|"supports"| node_guiding
node_api -->|"supports"| node_rescheduling
node_api -->|"provides"| node_reports

click node_browser "https://github.com/brunoaguinaga0/incatrack-showcase/blob/main/README.md"
click node_spa "https://github.com/brunoaguinaga0/incatrack-showcase/blob/main/README.md"
click node_api "https://github.com/brunoaguinaga0/incatrack-showcase/blob/main/README.md"
click node_database "https://github.com/brunoaguinaga0/incatrack-showcase/blob/main/README.md"
click node_routes "https://github.com/brunoaguinaga0/incatrack-showcase/blob/main/README.md"
click node_packages "https://github.com/brunoaguinaga0/incatrack-showcase/blob/main/README.md"
click node_bookings "https://github.com/brunoaguinaga0/incatrack-showcase/blob/main/README.md"
click node_payments "https://github.com/brunoaguinaga0/incatrack-showcase/blob/main/README.md"
click node_services "https://github.com/brunoaguinaga0/incatrack-showcase/blob/main/README.md"
click node_guiding "https://github.com/brunoaguinaga0/incatrack-showcase/blob/main/README.md"
click node_rescheduling "https://github.com/brunoaguinaga0/incatrack-showcase/blob/main/README.md"
click node_reports "https://github.com/brunoaguinaga0/incatrack-showcase/blob/main/README.md"

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_browser,node_spa toneBlue
class node_api,node_database toneAmber
class node_routes,node_packages,node_bookings,node_payments,node_services,node_guiding,node_rescheduling,node_reports toneMint
class node_customers,node_staff,node_guides,node_providers,node_mercadopago,node_email toneIndigo
class node_scheduled toneRose
```

## Components

### Web client

- [Browser](https://github.com/brunoaguinaga0/incatrack-showcase/blob/main/README.md): `README.md`
- [React SPA](https://github.com/brunoaguinaga0/incatrack-showcase/blob/main/README.md): `README.md`

### Backend

- [Laravel REST API](https://github.com/brunoaguinaga0/incatrack-showcase/blob/main/README.md): `README.md`
- [MySQL](https://github.com/brunoaguinaga0/incatrack-showcase/blob/main/README.md): `README.md`

### Excursion management

- [Routes and stages](https://github.com/brunoaguinaga0/incatrack-showcase/blob/main/README.md): `README.md`
- [Packages and catalog](https://github.com/brunoaguinaga0/incatrack-showcase/blob/main/README.md): `README.md`
- [Bookings and customers](https://github.com/brunoaguinaga0/incatrack-showcase/blob/main/README.md): `README.md`
- [Payments and expiry](https://github.com/brunoaguinaga0/incatrack-showcase/blob/main/README.md): `README.md`
- [Providers and services](https://github.com/brunoaguinaga0/incatrack-showcase/blob/main/README.md): `README.md`
- [Guide assignments](https://github.com/brunoaguinaga0/incatrack-showcase/blob/main/README.md): `README.md`
- [Rescheduling and reviews](https://github.com/brunoaguinaga0/incatrack-showcase/blob/main/README.md): `README.md`
- [Reports](https://github.com/brunoaguinaga0/incatrack-showcase/blob/main/README.md): `README.md`

### Other components

- **Customers**
- **Administrators / employees**
- **Guides**
- **Providers**
- **Mercado Pago**
- **Email service**
- **Scheduled tasks**

## Connections

- Customers → Browser: uses (evidence: `README.md`)
- Administrators / employees → Browser: uses (evidence: `README.md`)
- Guides → Browser: uses (evidence: `README.md`)
- Providers → Browser: uses (evidence: `README.md`)
- Browser → React SPA: runs (evidence: `README.md`)
- React SPA → Laravel REST API: JSON / HTTPS (evidence: `README.md`)
- Laravel REST API → MySQL: reads / writes (evidence: `README.md`)
- Laravel REST API → Mercado Pago: processes payments (evidence: `README.md`)
- Laravel REST API → Email service: sends email (evidence: `README.md`)
- Scheduled tasks → Laravel REST API: triggers (evidence: `README.md`)
- Laravel REST API → Routes and stages: manages (evidence: `README.md`)
- Laravel REST API → Packages and catalog: manages (evidence: `README.md`)
- Laravel REST API → Bookings and customers: manages (evidence: `README.md`)
- Laravel REST API → Payments and expiry: manages (evidence: `README.md`)
- Laravel REST API → Providers and services: manages (evidence: `README.md`)
- Laravel REST API → Guide assignments: supports (evidence: `README.md`)
- Laravel REST API → Rescheduling and reviews: supports (evidence: `README.md`)
- Laravel REST API → Reports: provides (evidence: `README.md`)
