mirror of
https://github.com/marcogll/AnchorOS.git
synced 2026-03-15 11:24:26 +00:00
feat: Implementar sistema de kiosko, enrollment e integración Telegram
## Sistema de Kiosko ✅ - Nuevo rol 'kiosk' en enum user_role - Tabla kiosks con autenticación por API key (64 caracteres) - Funciones SQL: generate_kiosk_api_key(), is_kiosk(), get_available_resources_with_priority() - API Routes: authenticate, bookings (GET/POST), confirm, resources/available, walkin - Componentes UI: BookingConfirmation, WalkInFlow, ResourceAssignment - Página kiosko: /kiosk/[locationId]/page.tsx ## Sistema de Enrollment ✅ - API routes para administración: /api/admin/users, /api/admin/kiosks, /api/admin/locations - Frontend enrollment: /admin/enrollment con autenticación por ADMIN_KEY - Creación de staff (admin, manager, staff, artist) con Supabase Auth - Creación de kiosks con generación automática de API key - Componentes UI: card, button, input, label, select, tabs ## Actualización de Recursos ✅ - Reemplazo de recursos con códigos estándarizados - Estructura por location: 3 mkup, 1 lshs, 4 pedi, 4 mani - Migración de limpieza: elimina duplicados - Total: 12 recursos por location ## Integración Telegram y Scoring ✅ - Campos agregados a staff: telegram_id, email, gmail, google_account, telegram_chat_id - Sistema de scoring: performance_score, total_bookings_completed, total_guarantees_count - Tablas: telegram_notifications, telegram_groups, telegram_bots - Funciones: update_staff_performance_score(), get_top_performers(), get_performance_summary() - Triggers automáticos: notificaciones al crear/confirmar/completar booking - Cálculo de score: base 50 +10 por booking +5 por garantía +1 por $100 ## Actualización de Tipos ✅ - UserRole: agregado 'kiosk' - CustomerTier: agregado 'black', 'VIP' - Nuevas interfaces: Kiosk ## Documentación ✅ - KIOSK_SYSTEM.md: Documentación completa del sistema - KIOSK_IMPLEMENTATION.md: Guía rápida - ENROLLMENT_SYSTEM.md: Sistema de enrollment - RESOURCES_UPDATE.md: Actualización de recursos - PROJECT_UPDATE_JAN_2026.md: Resumen de proyecto ## Componentes UI (7) - button.tsx, card.tsx, input.tsx, label.tsx, select.tsx, tabs.tsx ## Migraciones SQL (4) - 20260116000000_add_kiosk_system.sql - 20260116010000_update_resources.sql - 20260116020000_cleanup_and_fix_resources.sql - 20260116030000_telegram_integration.sql ## Métricas - ~7,500 líneas de código - 32 archivos creados/modificados - 7 componentes UI - 10 API routes - 4 migraciones SQL
This commit is contained in:
Marco Gallegos
251
docs/RESOURCES_UPDATE.md
Normal file
251
docs/RESOURCES_UPDATE.md
Normal file
@@ -0,0 +1,251 @@
|
||||
# Actualización de Recursos - SalonOS
|
||||
|
||||
## Cambios Realizados
|
||||
|
||||
### Recursos Anteriores (Eliminados)
|
||||
Los recursos tenían nombres descriptivos como:
|
||||
- "Sillón Pedicure 1", "Sillón Pedicure 2", "Sillón Pedicure 3"
|
||||
- "Estación Manicure 1", "Estación Manicure 2", "Estación Manicure 3", "Estación Manicure 4"
|
||||
- "Estación Maquillaje"
|
||||
- "Cama Pestañas"
|
||||
|
||||
### Nuevos Recursos (Implementados)
|
||||
Los recursos ahora usan códigos alfanuméricos estandarizados:
|
||||
|
||||
| Tipo | Código | Cantidad | Descripción |
|
||||
|------|--------|----------|-------------|
|
||||
| Maquillaje | `mkup` | 3 | Estaciones de maquillaje |
|
||||
| Pestañas | `lshs` | 1 | Cama de pestañas |
|
||||
| Pedicure | `pedi` | 4 | Estaciones de pedicure |
|
||||
| Manicure | `mani` | 4 | Estaciones de manicure |
|
||||
|
||||
### Formato de Nombres
|
||||
Los recursos siguen el patrón: `{código}-{número}`
|
||||
|
||||
Ejemplos:
|
||||
- `mkup-01`, `mkup-02`, `mkup-03`
|
||||
- `lshs-01`
|
||||
- `pedi-01`, `pedi-02`, `pedi-03`, `pedi-04`
|
||||
- `mani-01`, `mani-02`, `mani-03`, `mani-04`
|
||||
|
||||
## Detalles por Tipo
|
||||
|
||||
### Maquillaje (`mkup`)
|
||||
- **Total:** 3 estaciones por location
|
||||
- **Tipo:** station
|
||||
- **Capacidad:** 1 persona por estación
|
||||
- **Uso:** Servicios de maquillaje profesional
|
||||
|
||||
### Pestañas (`lshs`)
|
||||
- **Total:** 1 cama por location
|
||||
- **Tipo:** station
|
||||
- **Capacidad:** 1 persona
|
||||
- **Uso:** Extensiones de pestañas
|
||||
|
||||
### Pedicure (`pedi`)
|
||||
- **Total:** 4 estaciones por location
|
||||
- **Tipo:** station
|
||||
- **Capacidad:** 1 persona por estación
|
||||
- **Uso:** Servicios de pedicure
|
||||
|
||||
### Manicure (`mani`)
|
||||
- **Total:** 4 estaciones por location
|
||||
- **Tipo:** station
|
||||
- **Capacidad:** 1 persona por estación
|
||||
- **Uso:** Servicios de manicure
|
||||
|
||||
## Impacto en el Sistema
|
||||
|
||||
### Bookings Eliminados
|
||||
⚠️ **IMPORTANTE:** Debido a la restricción `CASCADE DELETE` en la tabla `resources`, todos los bookings que referenciaban los recursos anteriores han sido eliminados.
|
||||
|
||||
Esto significa que:
|
||||
- No hay bookings activos en el sistema
|
||||
- Los clientes deberán reprogramar sus citas
|
||||
- Se debe informar a los usuarios del cambio
|
||||
|
||||
### Cómo Afecta al Kiosko
|
||||
El kiosko ahora asignará recursos usando los nuevos códigos:
|
||||
- Cuando un cliente solicita maquillaje → asigna `mkup-XX`
|
||||
- Cuando un cliente solicita pestañas → asigna `lshs-01`
|
||||
- Cuando un cliente solicita pedicure → asigna `pedi-XX`
|
||||
- Cuando un cliente solicita manicure → asigna `mani-XX`
|
||||
|
||||
### Mapeo de Servicios a Recursos
|
||||
|
||||
Para mantener la consistencia, los servicios deberían asignarse a los recursos correctos:
|
||||
|
||||
| Servicio | Recurso Recomendado | Notas |
|
||||
|----------|---------------------|-------|
|
||||
| Maquillaje Profesional | `mkup-XX` | Cualquiera de las 3 estaciones |
|
||||
| Extensión de Pestañas | `lshs-01` | Único recurso disponible |
|
||||
| Pedicure Spa | `pedi-XX` | Cualquiera de las 4 estaciones |
|
||||
| Manicure Gel | `mani-XX` | Cualquiera de las 4 estaciones |
|
||||
| Uñas Acrílicas | `mani-XX` | Cualquiera de las 4 estaciones |
|
||||
|
||||
## Ejecutar la Migración
|
||||
|
||||
### Opción 1: Via Supabase Dashboard
|
||||
|
||||
1. Ve a: https://supabase.com/dashboard/project/pvvwbnybkadhreuqijsl/sql
|
||||
2. Copia el contenido de `supabase/migrations/20260116010000_update_resources.sql`
|
||||
3. Pega en el SQL Editor
|
||||
4. Haz clic en "Run"
|
||||
5. Verifica el output en la consola
|
||||
|
||||
### Opción 2: Via CLI (si está configurado)
|
||||
|
||||
```bash
|
||||
supabase db push
|
||||
```
|
||||
|
||||
## Verificar la Migración
|
||||
|
||||
### Consulta SQL para Ver Recursos
|
||||
|
||||
```sql
|
||||
SELECT
|
||||
l.name AS location,
|
||||
r.name AS resource_code,
|
||||
r.type AS resource_type,
|
||||
r.capacity,
|
||||
r.is_active
|
||||
FROM resources r
|
||||
JOIN locations l ON l.id = r.location_id
|
||||
WHERE l.is_active = true
|
||||
ORDER BY l.name, r.name;
|
||||
```
|
||||
|
||||
### Resultado Esperado
|
||||
|
||||
```
|
||||
location | resource_code | resource_type | capacity | is_active
|
||||
------------------|---------------|---------------|----------|----------
|
||||
ANCHOR:23 - Via KLAVA | lshs-01 | station | 1 | true
|
||||
ANCHOR:23 - Via KLAVA | mani-01 | station | 1 | true
|
||||
ANCHOR:23 - Via KLAVA | mani-02 | station | 1 | true
|
||||
ANCHOR:23 - Via KLAVA | mani-03 | station | 1 | true
|
||||
ANCHOR:23 - Via KLAVA | mani-04 | station | 1 | true
|
||||
ANCHOR:23 - Via KLAVA | mkup-01 | station | 1 | true
|
||||
ANCHOR:23 - Via KLAVA | mkup-02 | station | 1 | true
|
||||
ANCHOR:23 - Via KLAVA | mkup-03 | station | 1 | true
|
||||
ANCHOR:23 - Via KLAVA | pedi-01 | station | 1 | true
|
||||
ANCHOR:23 - Via KLAVA | pedi-02 | station | 1 | true
|
||||
ANCHOR:23 - Via KLAVA | pedi-03 | station | 1 | true
|
||||
ANCHOR:23 - Via KLAVA | pedi-04 | station | 1 | true
|
||||
TEST - Salón Principal | lshs-01 | station | 1 | true
|
||||
TEST - Salón Principal | mani-01 | station | 1 | true
|
||||
TEST - Salón Principal | mani-02 | station | 1 | true
|
||||
TEST - Salón Principal | mani-03 | station | 1 | true
|
||||
TEST - Salón Principal | mani-04 | station | 1 | true
|
||||
TEST - Salón Principal | mkup-01 | station | 1 | true
|
||||
TEST - Salón Principal | mkup-02 | station | 1 | true
|
||||
TEST - Salón Principal | mkup-03 | station | 1 | true
|
||||
TEST - Salón Principal | pedi-01 | station | 1 | true
|
||||
TEST - Salón Principal | pedi-02 | station | 1 | true
|
||||
TEST - Salón Principal | pedi-03 | station | 1 | true
|
||||
TEST - Salón Principal | pedi-04 | station | 1 | true
|
||||
```
|
||||
|
||||
## Actualizar el Seed Data (Opcional)
|
||||
|
||||
Si deseas mantener el archivo de seed consistente, actualiza la sección de recursos en `20260115235900_seed_data.sql`:
|
||||
|
||||
```sql
|
||||
-- REEMPLAZAR ESTA SECCIÓN EN EL SEED
|
||||
-- 2. Crear Resources (solo si no existen)
|
||||
DO $$
|
||||
BEGIN
|
||||
-- Para ANCHOR:23 - Via KLAVA
|
||||
FOR i IN 1..3 LOOP
|
||||
IF NOT EXISTS (
|
||||
SELECT 1 FROM resources r
|
||||
JOIN locations l ON l.id = r.location_id
|
||||
WHERE l.name = 'ANCHOR:23 - Via KLAVA' AND r.name = 'mkup-' || LPAD(i::TEXT, 2, '0')
|
||||
) THEN
|
||||
INSERT INTO resources (location_id, name, type, capacity, is_active)
|
||||
SELECT id, 'mkup-' || LPAD(i::TEXT, 2, '0'), 'station', 1, true
|
||||
FROM locations WHERE name = 'ANCHOR:23 - Via KLAVA';
|
||||
END IF;
|
||||
END LOOP;
|
||||
|
||||
INSERT INTO resources (location_id, name, type, capacity, is_active)
|
||||
SELECT id, 'lshs-01', 'station', 1, true
|
||||
FROM locations l
|
||||
WHERE l.name = 'ANCHOR:23 - Via KLAVA'
|
||||
AND NOT EXISTS (
|
||||
SELECT 1 FROM resources r
|
||||
WHERE r.location_id = l.id AND r.name = 'lshs-01'
|
||||
);
|
||||
|
||||
FOR i IN 1..4 LOOP
|
||||
IF NOT EXISTS (
|
||||
SELECT 1 FROM resources r
|
||||
JOIN locations l ON l.id = r.location_id
|
||||
WHERE l.name = 'ANCHOR:23 - Via KLAVA' AND r.name = 'pedi-' || LPAD(i::TEXT, 2, '0')
|
||||
) THEN
|
||||
INSERT INTO resources (location_id, name, type, capacity, is_active)
|
||||
SELECT id, 'pedi-' || LPAD(i::TEXT, 2, '0'), 'station', 1, true
|
||||
FROM locations WHERE name = 'ANCHOR:23 - Via KLAVA';
|
||||
END IF;
|
||||
END LOOP;
|
||||
|
||||
FOR i IN 1..4 LOOP
|
||||
IF NOT EXISTS (
|
||||
SELECT 1 FROM resources r
|
||||
JOIN locations l ON l.id = r.location_id
|
||||
WHERE l.name = 'ANCHOR:23 - Via KLAVA' AND r.name = 'mani-' || LPAD(i::TEXT, 2, '0')
|
||||
) THEN
|
||||
INSERT INTO resources (location_id, name, type, capacity, is_active)
|
||||
SELECT id, 'mani-' || LPAD(i::TEXT, 2, '0'), 'station', 1, true
|
||||
FROM locations WHERE name = 'ANCHOR:23 - Via KLAVA';
|
||||
END IF;
|
||||
END LOOP;
|
||||
|
||||
-- Repetir mismo patrón para otras locations...
|
||||
END $$;
|
||||
```
|
||||
|
||||
## Notas Importantes
|
||||
|
||||
### IDs de Resources
|
||||
Cada location tendrá sus propios recursos con IDs únicos. Por ejemplo:
|
||||
- ANCHOR:23 - Via KLAVA → `mkup-01` tiene un ID específico
|
||||
- TEST - Salón Principal → `mkup-01` tiene un ID diferente
|
||||
|
||||
### Agregar Nuevas Locations
|
||||
Cuando agregues una nueva location, la migración de actualización de recursos (`20260116010000_update_resources.sql`) creará automáticamente los 12 recursos para ella:
|
||||
- 3 mkup
|
||||
- 1 lshs
|
||||
- 4 pedi
|
||||
- 4 mani
|
||||
|
||||
### Modificar Cantidades
|
||||
Si necesitas cambiar las cantidades en el futuro, modifica la migración:
|
||||
|
||||
```sql
|
||||
-- Ejemplo: cambiar a 5 estaciones de maquillaje
|
||||
FOR i IN 1..5 LOOP
|
||||
INSERT INTO resources ...
|
||||
END LOOP;
|
||||
```
|
||||
|
||||
## Soporte y Troubleshooting
|
||||
|
||||
### Error: "Resources table is empty"
|
||||
- Ejecuta la migración de actualización de recursos
|
||||
- Verifica que las locations estén activas
|
||||
|
||||
### Error: "Booking references non-existent resource"
|
||||
- Esto es normal después de la migración
|
||||
- Los bookings anteriores fueron eliminados por CASCADE DELETE
|
||||
- Crea nuevos bookings con el sistema actualizado
|
||||
|
||||
### Consulta para Ver Locations sin Recursos
|
||||
```sql
|
||||
SELECT l.id, l.name
|
||||
FROM locations l
|
||||
LEFT JOIN resources r ON r.location_id = l.id
|
||||
WHERE l.is_active = true
|
||||
AND r.id IS NULL;
|
||||
```
|
||||
Reference in New Issue
Block a user