Sistema de Gestión Hotelera

API REST en Laravel 13 con arquitectura hexagonal (Domain, Application, Infrastructure) y frontend React desacoplado.

Requisitos

• PHP 8.3+
• Composer
• Node.js 20+
• PostgreSQL 15+

Instalación local

composer install
cp .env.example .env
php artisan key:generate
# Configurar DB_* en .env para PostgreSQL
php artisan migrate --seed
npm install
npm run build
php artisan serve

La aplicación estará en http://localhost:8000 y la API en http://localhost:8000/api/v1.

Desarrollo con hot-reload:

composer dev

Tests y cobertura

php artisan test --coverage

Arquitectura

src/
├── Domain/           # Entidades, interfaces de repositorio, reglas de negocio
├── Application/      # Casos de uso (un handler por operación)
└── Infrastructure/   # Implementaciones Eloquent

app/Http/
├── Controllers/Api/  # Un controlador por endpoint (SRP)
├── Requests/         # Validación de entrada
└── Resources/        # Transformación de respuesta JSON

Documentación

• API REST (OpenAPI manual)
• Documentación interactiva (Scramble) — generada automáticamente en /docs/api y /docs/api.json
• Diagramas UML
• Despliegue en la nube

Criterios de negocio implementados

Endpoints principales