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/STAFF_TRAINING.md

@@ -0,0 +1,147 @@
+# Guía de Entrenamiento para Staff — SalonOS
+
+Esta guía está diseñada para capacitar al personal del salón en el uso del sistema SalonOS.
+
+## Introducción al Sistema
+
+SalonOS es una plataforma integral de gestión que incluye:
+- Sistema de reservas (The Boutique)
+- Dashboard administrativo (Aperture)
+- Sistema de kiosko para autoservicio
+- Integraciones con pagos y calendario
+
+## Roles y Permisos
+
+### Tipos de Usuario
+- **Admin**: Acceso completo a configuración y gestión
+- **Manager**: Gestión de staff, recursos y reportes
+- **Staff/Artist**: Acceso limitado a sus horarios y asignaciones
+
+### Políticas de Seguridad
+- Nunca compartir credenciales
+- Usar autenticación de dos factores cuando disponible
+- Reportar cualquier acceso sospechoso
+
+## Uso Diario del Sistema
+
+### Acceso al Dashboard (Aperture)
+
+1. Ir a `aperture.anchor23.mx`
+2. Iniciar sesión con credenciales asignadas
+3. Navegar por las pestañas: Dashboard, Staff, Resources, Reports
+
+### Gestión de Horarios
+
+#### Ver Disponibilidad
+- Usar calendario para ver bookings asignados
+- Filtrar por fecha y staff member
+- Colores indican status: confirmado (verde), pendiente (amarillo), cancelado (rojo)
+
+#### Agregar Bloqueos
+- Click derecho en slot vacío
+- Seleccionar "Bloquear tiempo"
+- Elegir motivo: descanso, capacitación, mantenimiento
+
+### Gestión de Clientes
+
+#### Buscar Cliente
+- Usar search por nombre, email o teléfono
+- Ver historial completo de visitas
+- Acceder a notas privadas del cliente
+
+#### Modificar Reserva
+- Buscar booking por short ID o cliente
+- Cambiar horario si hay disponibilidad
+- Notificar cambios al cliente automáticamente
+
+## Sistema de Kiosko
+
+### Configuración Inicial
+- Cada kiosko tiene API key única
+- Configurar en pantalla táctil con enrollment code
+- Probar conexión antes de uso público
+
+### Monitoreo de Actividad
+- Revisar logs de kiosk en admin dashboard
+- Verificar reservas walk-in creadas correctamente
+- Monitorear uso de recursos en tiempo real
+
+## Manejo de Pagos y Depósitos
+
+### Depósitos Dinámicos
+- Automático: 50% del servicio o $200 máximo
+- Verificar pago antes de confirmar servicio
+- Manejar reembolsos según política
+
+### Penalizaciones por No-Show
+- Sistema automático marca después de ventana de 12h
+- Retención de depósito según reglas
+- Comunicación automática al cliente
+
+## Reportes y Analytics
+
+### Reportes Diarios
+- Ingresos por día/servicio
+- Utilización de recursos
+- No-shows y cancelaciones
+
+### Métricas de Rendimiento
+- Por staff member: bookings completados, ingresos generados
+- Por servicio: popularidad, tiempo promedio
+- Por location: ocupación, rentabilidad
+
+## Procedimientos de Emergencia
+
+### Sistema Caído
+- Contactar soporte técnico inmediatamente
+- Usar backup manual para reservas críticas
+- Comunicar a clientes vía teléfono/email
+
+### Reserva Duplicada
+- Verificar con cliente antes de cancelar
+- Mantener la más reciente
+- Documentar en notas del cliente
+
+### Conflicto de Recursos
+- Revisar asignaciones automáticamente
+- Reasignar manualmente si necesario
+- Notificar a staff afectado
+
+## Mejores Prácticas
+
+### Comunicación con Clientes
+- Confirmar cambios inmediatamente
+- Ofrecer alternativas cuando no hay disponibilidad
+- Mantener tono profesional y empático
+
+### Mantenimiento de Datos
+- Actualizar información de contacto regularmente
+- Limpiar bookings cancelados mensualmente
+- Backup semanal de datos críticos
+
+### Optimización de Agenda
+- Maximizar ocupación de recursos premium
+- Balancear carga entre staff members
+- Anticipar demanda por día de la semana
+
+## Capacitación Continua
+
+### Actualizaciones del Sistema
+- Revisar changelog mensual
+- Participar en sesiones de training
+- Reportar bugs o sugerencias
+
+### Certificación
+- Completar módulo básico de onboarding
+- Recertificación anual requerida
+- Bonos por perfect attendance
+
+## Contacto y Soporte
+
+- **Soporte Técnico**: soporte@anchor23.mx
+- **Manager de Location**: [Nombre del manager]
+- **Documentación**: docs/ en repositorio
+
+---
+
+*Última actualización: Enero 2026*