AppSalon - Sistema de Gestión de Citas para Salón de Belleza

Aplicación web para gestionar citas, servicios y clientes de un salón de belleza. Permite a clientes reservar citas y a administradores gestionar todo el negocio.

Tecnologías utilizadas

Requisitos previos

Antes de empezar necesitas tener instalado:

• PHP 8.2+ (verificar con php -v)
• Composer — gestor de paquetes PHP
• Node.js 20+ — para el frontend (verificar con node -v)
• Docker Desktop — para la base de datos
• Laravel Herd — servidor local

Instalación paso a paso

Paso 1 — Clonar el repositorio

git clone https://github.com/tu-usuario/app-salon.git
cd app-salon

Paso 2 — Instalar dependencias de PHP

composer install

Esto descarga todas las librerías de Laravel necesarias. Puede tardar unos minutos.

Paso 3 — Instalar dependencias de JavaScript

npm install

Esto descarga React, Tailwind y demás librerías del frontend.

Paso 4 — Configurar variables de entorno

cp .env.example .env
php artisan key:generate

Abre el archivo .env y verifica que la configuración de base de datos sea:

DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=appsalon
DB_USERNAME=root
DB_PASSWORD=

El archivo .env contiene las credenciales y configuración del proyecto. Nunca subas este archivo a GitHub.

Paso 5 — Iniciar la base de datos con Docker

docker compose up -d

Esto inicia MySQL en un contenedor Docker. La bandera -d lo ejecuta en segundo plano. Espera unos segundos antes de continuar.

Puedes verificar que está corriendo con:

docker compose ps

Paso 6 — Crear las tablas y datos de prueba

php artisan migrate --seed

migrate crea todas las tablas en la base de datos. --seed inserta datos de prueba (usuarios y servicios).

Paso 7 — Compilar el frontend

Para desarrollo (se recarga automáticamente al guardar cambios):

npm run dev

Para producción (compilación optimizada):

npm run build

Paso 8 — Abrir la aplicación

Si usas Laravel Herd, la aplicación estará disponible en:

http://app-salon.test

Para ver y gestionar la base de datos visualmente:

http://localhost:8080  (phpMyAdmin)

Credenciales de prueba

Estructura del proyecto

app-salon/
├── app/
│   ├── Http/
│   │   ├── Controllers/       # Lógica de cada sección (Auth, Servicios, Citas, Admin)
│   │   └── Middleware/        # Filtros de acceso (ej: solo admins)
│   ├── Models/
│   │   ├── User.php           # Modelo de usuario (tabla: usuarios)
│   │   ├── Servicio.php       # Modelo de servicio (tabla: servicios)
│   │   ├── Cita.php           # Modelo de cita (tabla: citas)
│   │   └── CitaServicio.php   # Relación cita-servicio (tabla: citasServicios)
│   └── Actions/Fortify/
│       └── CreateNewUser.php  # Lógica de registro de usuarios
├── resources/
│   └── js/
│       └── pages/
│           ├── welcome.tsx    # Página principal pública
│           ├── dashboard.tsx  # Panel del cliente
│           ├── auth/          # Login, registro, recuperar contraseña
│           └── settings/      # Configuración de perfil
├── routes/
│   ├── web.php                # Rutas de la aplicación web
│   └── api.php                # Rutas de la API REST
├── database/
│   ├── migrations/            # Definición de tablas
│   └── seeders/               # Datos de prueba
└── docker-compose.yml         # Configuración de Docker (MySQL + phpMyAdmin)

Base de datos

El sistema usa 4 tablas principales:

Funcionalidades

Para clientes

• Registro y login con confirmación por email
• Ver catálogo de servicios disponibles
• Reservar citas eligiendo fecha, hora y servicios
• Ver y cancelar sus propias citas

Para administradores

• Gestionar servicios (crear, editar, eliminar)
• Ver todas las citas del día
• Gestionar usuarios y roles
• Dashboard con estadísticas
• Reportes y exportación de datos (semana 16)

Rutas principales

Comandos útiles

# Ver logs de la aplicación
php artisan pail
 
# Limpiar caché
php artisan cache:clear
php artisan config:clear
 
# Ejecutar pruebas
php artisan test
 
# Ejecutar una prueba específica
php artisan test --filter=NombreDeLaPrueba
 
# Detener Docker
docker compose down
 
# Ver estado de migraciones
php artisan migrate:status

Solución de problemas comunes

Error: "No application encryption key"

php artisan key:generate

Error de conexión a base de datos

• Verifica que Docker esté corriendo: docker compose ps
• Verifica las credenciales en .env

La página no carga en app-salon.test

• Asegúrate de que Laravel Herd esté corriendo y el sitio esté registrado

Cambios en el frontend no se ven

• Asegúrate de tener npm run dev corriendo en otra terminal

Cronograma del proyecto