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

@@ -0,0 +1,152 @@
+# Guía de Onboarding para Clientes — SalonOS
+
+Bienvenido a Anchor23. Esta guía te ayudará a familiarizarte con nuestros sistemas de reserva y servicios.
+
+## Primeros Pasos
+
+### Registro Inicial
+1. Visita `anchor23.mx` para conocer nuestros servicios
+2. Elige membresía según tus necesidades:
+   - **Free**: Acceso básico, invitaciones requeridas
+   - **Gold**: Beneficios premium, descuentos en servicios
+   - **Black**: Servicios prioritarios, acceso VIP
+   - **VIP**: Experiencia exclusiva, concierge personal
+
+### Reserva de Primera Cita
+1. Ir a `booking.anchor23.mx`
+2. Seleccionar servicio deseado
+3. Elegir fecha y hora disponible
+4. Completar información personal
+5. Realizar depósito (50% o $200 máximo)
+
+## Uso de The Boutique (Sistema de Reservas)
+
+### Navegación
+- **Servicios**: Explora catálogo completo
+- **Mi Perfil**: Gestiona información personal
+- **Mis Citas**: Historial y gestión de reservas
+- **Membresías**: Actualiza o mejora tu tier
+
+### Hacer una Reserva
+1. Seleccionar servicio y duración
+2. Elegir location preferida
+3. Ver slots disponibles en calendario
+4. Confirmar datos personales
+5. Pagar depósito requerido
+
+### Modificar Reserva
+- Cambios permitidos hasta 12h antes
+- Penalización por no-show: retención de depósito
+- Contactar staff para cambios especiales
+
+## Sistema de Invitaciones
+
+### Cómo Funciona
+- Sistema de crecimiento controlado
+- Invitaciones semanales por tier
+- Código único por invitado
+- Seguimiento de referrals
+
+### Enviar Invitación
+1. Acceder a sección de invitaciones
+2. Generar código único
+3. Compartir con potencial cliente
+4. Recibir beneficios por conversiones
+
+## Membresías y Beneficios
+
+### Tiers Disponibles
+- **Free**: 1 invitación/semana, servicios estándar
+- **Gold**: 3 invitaciones/semana, 10% descuento
+- **Black**: 5 invitaciones/semana, prioridad en agenda, 20% descuento
+- **VIP**: Invitaciones ilimitadas, concierge, descuentos exclusivos
+
+### Upgrade de Membresía
+- Basado en gasto acumulado
+- Beneficios inmediatos al ascender
+- Renovación automática anual
+
+## Pagos y Depósitos
+
+### Método de Pago
+- Stripe integration segura
+- Tarjetas de crédito/débito
+- Depósito requerido para confirmar
+
+### Política de Depósitos
+- 50% del valor del servicio
+- Máximo $200 por reserva
+- Reembolsable según política de cancelación
+
+## Comunicación y Notificaciones
+
+### Canales
+- Email para confirmaciones
+- WhatsApp para recordatorios (próximamente)
+- SMS para urgencias
+
+### Recordatorios Automáticos
+- 24h antes de cita
+- 2h antes de cita
+- Confirmación de llegada vía kiosko
+
+## Uso del Kiosko
+
+### Llegada al Salón
+1. Acercarse a pantalla táctil en entrada
+2. Ingresar código de 6 dígitos (short ID)
+3. Confirmar llegada
+4. Recibir instrucciones de staff
+
+### Reservas Walk-in
+- Disponible para servicios express
+- Pago en efectivo o tarjeta en recepción
+- Asignación automática de staff y recursos
+
+## Políticas Importantes
+
+### Cancelación
+- Hasta 12h antes: reembolso completo
+- Menos de 12h: retención de depósito
+- No-show: penalización completa
+
+### Puntuación y Privacidad
+- Datos protegidos por RLS
+- Acceso limitado por rol
+- Auditoría completa de cambios
+
+## Soporte al Cliente
+
+### Contacto
+- **Email**: hello@anchor23.mx
+- **Teléfono**: [Número de contacto]
+- **WhatsApp**: [Número de WhatsApp]
+- **Horarios**: Lunes-Domingo, 9AM-8PM
+
+### Problemas Comunes
+- Reserva no aparece: verificar email de confirmación
+- Cambio de horario: contactar 24h antes
+- Problemas técnicos: soporte disponible 24/7
+
+## Consejos para Mejor Experiencia
+
+### Planificación
+- Reservar con anticipación para servicios populares
+- Considerar tiempos de viaje al salón
+- Traer identificación para primera visita
+
+### Preparación
+- Confirmar detalles 24h antes
+- Llegar 15 minutos temprano
+- Comunicar alergias o necesidades especiales
+
+### Post-Servicio
+- Feedback valorado para mejorar
+- Invitar amigos para beneficios adicionales
+- Mantener membresía activa
+
+---
+
+¡Gracias por elegir Anchor23! Tu satisfacción es nuestra prioridad.
+
+*Última actualización: Enero 2026*