Files
AnchorOS/app/admin/README.md
Marco Gallegos fed5cb6850 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
2026-01-16 10:51:12 -06:00

68 lines
1.6 KiB
Markdown

# Admin Enrollment System
Sistema de administración de usuarios y kiosks para SalonOS.
## Descripción
Este sistema permite a los administradores:
- Crear nuevos miembros de staff (admin, manager, staff, artist)
- Crear nuevos kiosks para cada location
- Ver listas de usuarios y kiosks existentes
- Gestionar locations activas
## Acceso
### URL
```
http://localhost:3000/admin/enrollment
```
### Autenticación
El sistema requiere una clave de administración para acceder. Configura esto en `.env.local`:
```env
ADMIN_ENROLLMENT_KEY=tu-clave-segura-aqui
```
## Seguridad
- Autenticación por Bearer token
- Validación de roles (admin, manager, staff, artist)
- API keys de kiosks generadas aleatoriamente (64 caracteres)
- Restricción opcional por IP address para kiosks
## Uso
### Crear Staff Member
1. Ingresa tu `ADMIN_ENROLLMENT_KEY`
2. Selecciona la tab "Staff Members"
3. Completa el formulario:
- Location
- Role (Admin, Manager, Staff, Artist)
- Display Name (público)
- First/Last Name (privado)
- Email (para autenticación)
- Password (contraseña inicial)
- Phone (opcional)
4. Haz clic en "Create Staff Member"
### Crear Kiosk
1. Ingresa tu `ADMIN_ENROLLMENT_KEY`
2. Selecciona la tab "Kiosks"
3. Completa el formulario:
- Location
- Device Name (identificador único)
- Display Name (nombre legible)
- IP Address (opcional, para restricción)
4. Haz clic en "Create Kiosk"
5. ⚠️ **IMPORTANTE**: Guarda el API Key generado de forma segura
## Documentación
- [Guía Completa](../docs/ENROLLMENT_SYSTEM.md)
- [Sistema de Kiosko](../docs/KIOSK_SYSTEM.md)
- [PRD](../PRD.md)