87 lines
3.9 KiB
Markdown
87 lines
3.9 KiB
Markdown
# MAY Studio — Landing Page + EasyAppointments
|
|
|
|
Landing page bonita para MAY Studio (Horta, Barcelona) con reservas gestionadas por **EasyAppointments**.
|
|
|
|
El frontend (HTML/JS puro) sigue siendo el de la landing, pero **las reservas, clientes y servicios se gestionan completamente con EasyAppointments**.
|
|
|
|
## Stack actual
|
|
|
|
- **Web (estático)**: Go + proxy reverso a EasyAppointments API
|
|
- **Gestión de citas, clientes y servicios**: EasyAppointments (PHP + MySQL)
|
|
- **Base de datos**: MySQL (para EA)
|
|
- **Docker Compose**: todo junto (web + easyappointments + mysql)
|
|
|
|
## Cómo ejecutar (Desarrollo y Producción)
|
|
|
|
### 1. Levantar todo
|
|
|
|
```sh
|
|
docker compose up -d --build
|
|
```
|
|
|
|
- Landing + reservas: **http://localhost:8234**
|
|
- Panel de administración EasyAppointments: **http://localhost:8888**
|
|
|
|
### 2. Primer arranque (importante)
|
|
|
|
1. Abre http://localhost:8888
|
|
2. Completa el asistente de instalación de EasyAppointments.
|
|
3. Crea un **usuario administrador**.
|
|
4. Ve a **Providers** → crea al menos un proveedor (ej. "May").
|
|
5. Ve a **Services** → crea tus servicios (puedes usar la lista anterior de servicios como referencia).
|
|
6. Asigna los servicios al proveedor.
|
|
7. Configura el **Working Plan** del proveedor (horario).
|
|
8. **Anota el ID del Provider** (normalmente 1) y edita `static/index.html` → línea `const PROVIDER_ID = 1;`
|
|
|
|
### 3. Variables importantes en compose
|
|
|
|
Edita `docker-compose.yml` antes de levantar:
|
|
|
|
- `EA_API_USERNAME` + `EA_API_PASSWORD` (o mejor: configura **API Key** en Settings de EA y usa `EA_API_KEY`)
|
|
- `BASE_URL` del servicio `easyappointments`
|
|
- Contraseña de MySQL
|
|
|
|
### Actualizar
|
|
|
|
```sh
|
|
git pull
|
|
docker compose up -d --build
|
|
```
|
|
|
|
## Notas sobre la integración
|
|
|
|
- Los servicios y la disponibilidad los obtiene el frontend directamente de la API de EasyAppointments.
|
|
- Al reservar:
|
|
- Busca o crea automáticamente el cliente usando el **email**.
|
|
- Crea la cita en EasyAppointments (con todos los servicios seleccionados en las notas).
|
|
- La gestión completa (clientes, servicios, citas, proveedores, etc.) se hace desde http://localhost:8888
|
|
- La API antigua (carpeta `api/` + admin.html antigua + services.yml/mail.yml) ha sido eliminada completamente.
|
|
|
|
## Comportamiento multiservicio
|
|
|
|
El formulario permite seleccionar **varios servicios** (multi-checkbox).
|
|
|
|
Cómo funciona actualmente con EasyAppointments:
|
|
|
|
- **UI**: Puedes seleccionar múltiples servicios. Se muestra el resumen con nombres unidos por "+" y la duración total sumada.
|
|
- **Comprobación de disponibilidad**: Se consulta el endpoint de EA usando el servicio de **mayor duración** de los seleccionados. Luego se filtra client-side para exigir un bloque contiguo de la **duración total** (suma de todos).
|
|
- Ejemplo: servicios de 45min + 30min → total 75 min. Solo se ofrecen horas de inicio desde las que quepan 75 min seguidos sin solape.
|
|
- **Al crear la reserva**:
|
|
- Se crea **una sola cita** en EasyAppointments.
|
|
- Se usa como `serviceId` el servicio de mayor duración (para que coincida con la disponibilidad consultada).
|
|
- Se calcula la hora de fin sumando la **duración total** de todos los servicios seleccionados y se envía explícitamente el campo `end`. Así EA bloquea el tiempo completo en el calendario de la empleada.
|
|
- Solo una empleada (May) por ahora → el bloque queda reservado y no se puede reservar otra cosa en ese intervalo.
|
|
- En el campo `notes` se guarda el detalle completo:
|
|
```
|
|
Nombre: ...
|
|
Email: ...
|
|
Teléfono: ...
|
|
Servicios: Corte + Tinte + ...
|
|
Duración total: 120 min
|
|
Mensaje: ...
|
|
```
|
|
|
|
**Limitación**: EasyAppointments modela una cita = un servicio principal. Los servicios adicionales quedan documentados en las notas del cliente y de la cita. No se crean múltiples registros de cita.
|
|
|
|
Recomendación: Si usas combinaciones frecuentes, crea "servicios combinados" directamente en EasyAppointments (ej. "Corte + Tinte Señora - 120min").
|