docs: add comprehensive code comments, update README and TASKS, create training and troubleshooting guides

- Add JSDoc comments to API routes and business logic functions
- Update README.md with Phase 2 status and deployment/production notes
- Enhance TASKS.md with estimated timelines and dependencies
- Create docs/STAFF_TRAINING.md for team onboarding
- Create docs/CLIENT_ONBOARDING.md for customer experience
- Create docs/OPERATIONAL_PROCEDURES.md for daily operations
- Create docs/TROUBLESHOOTING.md for common setup issues
- Fix TypeScript errors in hq/page.tsx

docs/OPERATIONAL_PROCEDURES.md

@@ -0,0 +1,174 @@
+# Procedimientos Operativos — SalonOS
+
+Guía interna para operaciones diarias del salón usando el sistema SalonOS.
+
+## Apertura Diaria
+
+### Checklist Matutino
+- [ ] Verificar conexión a internet y sistemas
+- [ ] Revisar bookings del día en Aperture dashboard
+- [ ] Confirmar staff asignado y horarios
+- [ ] Verificar disponibilidad de recursos (estaciones, equipos)
+- [ ] Probar kioskos táctiles
+- [ ] Revisar inventario crítico
+
+### Monitoreo Continuo
+- Monitorear ocupación en tiempo real
+- Gestionar walk-ins según disponibilidad
+- Resolver conflictos de asignación inmediatamente
+
+## Gestión de Reservas
+
+### Flujo Estándar
+1. **Recepción**: Cliente confirmado vía kiosko o staff
+2. **Asignación**: Staff y recurso asignados automáticamente
+3. **Servicio**: Tracking de tiempo y progreso
+4. **Pago**: Procesamiento final si no pagado
+5. **Cierre**: Actualización de status y notas
+
+### Casos Especiales
+- **Sobreasignación**: Reasignar recursos premium
+- **Cancelación última hora**: Liberar slot, notificar siguiente cliente
+- **No-show**: Marcar automáticamente, aplicar penalización
+
+## Manejo de Recursos
+
+### Tipos de Recursos
+- **Stations**: Puestos de trabajo fijos
+- **Rooms**: Salas privadas para servicios premium
+- **Equipment**: Herramientas móviles (secadores, etc.)
+
+### Mantenimiento
+- Limpieza entre clientes
+- Reporte de equipos dañados
+- Programación de mantenimiento preventivo
+
+### Optimización
+- Maximizar uso de recursos premium
+- Balancear carga entre locations
+- Anticipar demanda por temporada
+
+## Gestión de Personal
+
+### Asignación Diaria
+- Revisar schedule semanal
+- Ajustar por ausencias o sobrecarga
+- Comunicar cambios inmediatamente
+
+### Rendimiento
+- Tracking de bookings completados
+- Medición de tiempo por servicio
+- Feedback de clientes por staff
+
+### Capacitación
+- Onboarding para nuevo personal
+- Actualizaciones de procedimientos
+- Certificación en uso de sistemas
+
+## Finanzas y Reportes
+
+### Cierre Diario
+- Verificar todos los pagos procesados
+- Generar reporte de ingresos
+- Revisar depósitos pendientes
+
+### Reportes Semanales
+- Utilización de recursos
+- Rendimiento por staff
+- Tendencias de demanda
+- Análisis de no-shows
+
+### Contabilidad
+- Reconciliación con Stripe
+- Seguimiento de depósitos retenidos
+- Cálculo de comisiones por staff
+
+## Manejo de Clientes VIP
+
+### Protocolo Especial
+- Confirmación personal por manager
+- Asignación de mejores recursos
+- Comunicación premium (WhatsApp, email personalizado)
+- The Vault para fotos privadas
+
+### Seguimiento
+- Historial detallado de preferencias
+- Notas privadas de staff
+- Programa de lealtad personalizado
+
+## Seguridad y Privacidad
+
+### Protección de Datos
+- RLS aplicado estrictamente
+- Acceso limitado por rol
+- Auditoría completa de cambios
+
+### Seguridad Física
+- Control de acceso a sistemas
+- Monitoreo de kioskos
+- Backup de datos crítico
+
+## Contingencias
+
+### Sistema Caído
+1. Comunicación inmediata a todos los staff
+2. Uso de backup manual (libreta, teléfono)
+3. Priorizar clientes VIP y bookings confirmados
+4. Notificar a soporte técnico
+
+### Sobrecarga de Agenda
+1. Evaluar capacidad real vs bookings
+2. Contactar clientes para reagendar
+3. Activar protocolo de espera
+4. Documentar para análisis posterior
+
+### Conflicto con Cliente
+1. Mantener calma y profesionalismo
+2. Escalar a manager si necesario
+3. Documentar incidente completo
+4. Aplicar compensación según política
+
+## Mejores Prácticas
+
+### Eficiencia
+- Minimizar tiempo entre servicios
+- Optimizar rutas de recursos
+- Automatizar tareas repetitivas
+
+### Calidad
+- Verificación de preparación de staff
+- Feedback continuo de clientes
+- Mantenimiento de estándares de servicio
+
+### Innovación
+- Probar nuevas funcionalidades del sistema
+- Recopilar feedback de staff y clientes
+- Implementar mejoras operativas
+
+## Métricas Clave
+
+### KPIs Diarios
+- Ocupación de recursos: >85%
+- Tasa de no-show: <5%
+- Satisfacción cliente: >4.8/5
+
+### KPIs Semanales
+- Ingresos vs presupuesto
+- Utilización por staff
+- Conversion de walk-ins
+
+### KPIs Mensuales
+- Retención de clientes
+- Crecimiento de membresías
+- ROI de inversiones
+
+## Contactos de Emergencia
+
+- **Soporte Técnico**: soporte@anchor23.mx | +52 [tel]
+- **Manager General**: [Nombre] | [tel]
+- **Contabilidad**: [Nombre] | [tel]
+- **Legal**: [Nombre] | [tel]
+
+---
+
+*Revisar y actualizar mensualmente. Última actualización: Enero 2026*