- Integrate @formbricks/js for future surveys (FormbricksProvider)
- Add WebhookForm component for unified form submission (contact/franchise/membership)
- Update contact form with reason dropdown field
- Update franchise form with new fields: estado, ciudad, socios checkbox
- Update franchise benefits: manuals, training platform, RH system, investment $100k
- Add Contacto link to desktop/mobile nav and footer
- Update membership form to use WebhookForm with membership_id select
- Update hero buttons to use #3E352E color consistently
- Refactor contact/franchise pages to use new hero layout and components
- Add webhook utility (lib/webhook.ts) for parallel submission to test+prod
- Add email receipt hooks to booking endpoints
- Update globals.css with new color variables and navigation styles
- Docker configuration for deployment
✅ SISTEMA DE NÓMINA COMPLETO:
- API con cálculos automáticos por período
- Cálculo de comisiones (10% de revenue de servicios completados)
- Cálculo de propinas (5% estimado basado en revenue)
- Cálculo de horas trabajadas desde bookings completados
- Sueldo base configurable por staff
- Exportación a CSV con detalles completos
✅ PUNTO DE VENTA (POS) COMPLETO:
- API para procesamiento de ventas
- Múltiples métodos de pago: efectivo, tarjeta, transferencias, giftcards, membresías
- Carrito interactivo con servicios y productos
- Cálculo automático de subtotales y totales
- Validación de pagos completos antes de procesar
- Recibos digitales con impresión
- Interface táctil optimizada para diferentes dispositivos
✅ CIERRE DE CAJA AUTOMÁTICO:
- API para reconciliación financiera
- Comparación automática entre ventas reales y efectivo contado
- Detección de discrepancias con reportes detallados
- Auditoría completa de cierres de caja
- Reportes diarios exportables
✅ COMPONENTES DE GESTIÓN AVANZADOS:
- : Cálculo y exportación de nóminas
- : Interface completa de punto de venta
- Integración completa con dashboard Aperture
- Manejo de errores y estados de carga
✅ MIGRACIÓN PAYROLL COMPLETA:
- Tablas: staff_salaries, commission_rates, tip_records, payroll_records
- Funciones PostgreSQL para cálculos complejos (preparadas)
- RLS policies para seguridad de datos financieros
- Índices optimizados para consultas rápidas
Próximo: Integración con Stripe real y automatización de WhatsApp
✅ SISTEMA DE NÓMINA COMPLETO:
- API con cálculos automáticos de sueldo
- Cálculo de comisiones (10% de revenue de servicios completados)
- Cálculo de propinas (5% estimado de revenue)
- Cálculo de horas trabajadas desde bookings completados
- Sueldo base configurable por staff
✅ COMPONENTE PayrollManagement:
- Interfaz completa para gestión de nóminas
- Cálculo por períodos mensuales
- Tabla de resultados con exportación CSV
- Diálogo de cálculo detallado
✅ APIs CRUD STAFF FUNCIONALES:
- GET/POST/PUT/DELETE y
- Gestión de roles y ubicaciones
- Auditoría completa de cambios
✅ APIs CRUD RESOURCES FUNCIONALES:
- GET/POST con disponibilidad en tiempo real
- Estado de ocupación por recurso
- Capacidades y tipos de recursos
✅ MIGRACIÓN PAYROLL PREPARADA:
- Tablas: staff_salaries, commission_rates, tip_records, payroll_records
- Funciones PostgreSQL para cálculos complejos
- RLS policies configuradas
Próximo: POS completo con múltiples métodos de pago
✅ COMENTARIOS AUDITABLES IMPLEMENTADOS:
- 80+ archivos con JSDoc completo para auditoría manual
- APIs críticas con validaciones business/security/performance
- Componentes con reglas de negocio documentadas
- Funciones core con edge cases y validaciones
✅ CALENDARIO MULTI-COLUMNA FUNCIONAL (95%):
- Drag & drop con reprogramación automática
- Filtros por sucursal/staff, tiempo real
- Indicadores de conflictos y disponibilidad
- APIs completas con validaciones de colisión
✅ GESTIÓN OPERATIVA COMPLETA:
- CRUD staff: APIs + componente con validaciones
- CRUD recursos: APIs + componente con disponibilidad
- Autenticación completa con middleware seguro
- Auditoría completa en todas las operaciones
✅ DOCUMENTACIÓN ACTUALIZADA:
- TASKS.md: FASE 4 95% completado
- README.md: Estado actual y funcionalidades
- API.md: 40+ endpoints documentados
✅ SEGURIDAD Y VALIDACIONES:
- RLS policies documentadas en comentarios
- Business rules validadas manualmente
- Performance optimizations anotadas
- Error handling completo
Próximos: Nómina/POS/CRM avanzado (FASE 4 final)
TASK 1: Implement GET /api/aperture/stats
- Create endpoint at app/api/aperture/stats/route.ts
- Returns dashboard statistics: { totalBookings, totalRevenue, completedToday, upcomingToday }
- Calculates stats from bookings table by month and today
- Dashboard now has functional statistics display
TASK 2: Implement authentication for Aperture
- Create middleware.ts for protecting Aperture routes
- Only allows access to users with admin, manager, or staff roles
- Redirects unauthorized users to /aperture/login
- Uses Supabase Auth with session verification
- Integrates with existing AuthProvider in lib/auth/context.tsx
Stack Updates:
- Update @supabase/auth-helpers-nextjs to latest version (0.15.0)
- Note: Package marked as deprecated but still functional
Files Created:
- app/api/aperture/stats/route.ts
- middleware.ts
Files Modified:
- TASKS.md (marked tasks 1 and 2 as completed)
- package.json (updated dependency)
Impact:
- Aperture dashboard now has working statistics
- Aperture routes are now protected by authentication
- Only authorized staff/admin/manager can access dashboard
Next: Task 3 - Implement weekly invitation reset
- Update README.md with markdown links to all documentation files in docs/
- Add comprehensive documentation structure section in TASKS.md
- Document code comment conventions for:
* PostgreSQL functions with JSDoc-style comments
* TypeScript/JavaScript functions with JSDoc
* API routes with request/response documentation
* Naming conventions (camelCase, UPPER_SNAKE_CASE, PascalCase, kebab-case)
* SQL migration documentation standards
* Audit logging patterns
- Link all documentation files with relative paths for easy navigation
- Maintain README.md and TASKS.md in root, all other docs in docs/ folder
Major changes:
- Add customer registration with email/phone lookup (app/booking/registro)
- Add customers API endpoint (app/api/customers/route)
- Implement business hours for locations (mon-fri 10-7, sat 10-6, sun closed)
- Fix availability function type casting issues
- Add business hours utilities (lib/utils/business-hours.ts)
- Update Location type to include business_hours JSONB
- Add mock payment component for testing
- Remove Supabase auth from booking flow
- Fix /cita redirect path in booking flow
Database migrations:
- Add category column to services table
- Add business_hours JSONB column to locations table
- Fix availability functions with proper type casting
- Update get_detailed_availability to use business_hours
Features:
- Customer lookup by email or phone
- Auto-redirect to registration if customer not found
- Pre-fill customer data if exists
- Business hours per day of week
- Location-specific opening/closing times
Major changes:
- Add customer registration with email/phone lookup (app/booking/registro)
- Add customers API endpoint (app/api/customers/route)
- Implement business hours for locations (mon-fri 10-7, sat 10-6, sun closed)
- Fix availability function type casting issues
- Add business hours utilities (lib/utils/business-hours.ts)
- Update Location type to include business_hours JSONB
- Add mock payment component for testing
- Remove Supabase auth from booking flow
- Fix /cita redirect path in booking flow
Database migrations:
- Add category column to services table
- Add business_hours JSONB column to locations table
- Fix availability functions with proper type casting
- Update get_detailed_availability to use business_hours
Features:
- Customer lookup by email or phone
- Auto-redirect to registration if customer not found
- Pre-fill customer data if exists
- Business hours per day of week
- Location-specific opening/closing times
- Add public API endpoints for locations, services, and availability
- Implement staff login system with password authentication
- Update auth context to support password sign-in
- Protect aperture dashboard with authentication
- Update project documentation with new domains
- 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
- Implement client authentication with Supabase magic links
- Add Stripe payment integration for deposits
- Complete The Boutique booking flow with payment processing
- Implement Aperture backend with staff/resources management
- Add comprehensive reports: sales, payments, payroll
- Create permissions management system by roles
- Configure kiosk system with enrollment
- Add no-show logic and penalization system
- Update project documentation and API docs
- Enhance README with current project status
**The Boutique - Frontend completo para clientes:**
- Página de login/signup (/booking/login)
- Autenticación con email/password
- Registro de nuevos clientes
- Validación de formularios
- Diseño responsive y accesible
- Página de perfil (/booking/perfil)
- Información personal del cliente
- Edición de datos (modal)
- Estadísticas de actividad
- Historial de citas recientes
- Información de membresía (tier)
- Página Mis Citas (/booking/mis-citas)
- Lista completa de citas
- Filtros: todas, próximas, pasadas
- Detalles completos de cada cita
- Opción de cancelar citas pendientes
- Estados visuales por estatus
- Información de códigos de reserva
- Layout mejorado (/booking/layout)
- Navbar completo con todas las opciones
- Navegación entre secciones
- Estilos consistentes con anchor23.mx
**Funcionalidades implementadas:**
- Gestión completa del perfil de cliente
- Historial y gestión de citas
- Sistema de autenticación básico
- Navegación fluida entre secciones
- Estados de carga y manejo de errores
- Diseño responsive para móviles
**Datos mock/simulados:**
- Perfiles de cliente con tiers
- Historial de citas con diferentes estados
- Información de staff y servicios
- Validación de formularios
**Próximos pasos:**
- Integración con APIs reales de autenticación
- Conexión con Stripe para pagos
- Sincronización con base de datos real
- Notificaciones por email/WhatsApp
**Aperture - Backend para staff/manager/admin:**
- Crear página principal de admin (/aperture)
- Dashboard con estadísticas del día (citas, ingresos, pendientes)
- Navegación por tabs (Dashboard, Staff, Recursos, Reportes)
- Diseño limpio con métricas y cards
- Crear APIs administrativas:
- /api/aperture/staff - Staff disponible por ubicación
- /api/aperture/staff/schedule - CRUD de horarios de staff
- GET: Listar horarios con filtros
- POST: Crear bloqueo de horario
- DELETE: Eliminar horario
- /api/aperture/resources - Recursos por ubicación
- /api/aperture/dashboard - Bookings por fecha y staff
**The Boutique - Mejoras:**
- Página de confirmación por código (/booking/confirmacion)
- Verificación por short_id
- Detalles completos de cita
- Información sobre políticas
- Layout personalizado con navbar específico
**TASKS.md - Actualización:**
- Aperture marcado como 'En Progreso' con APIs implementadas
- The Boutique actualizado con página de confirmación
- Reorganización de tareas prioritarias
- Estado del proyecto actualizado (Fase 2: 30%)
**Arquitectura:**
- Separación clara: anchor23.mx (marketing), booking (cliente), aperture (operaciones)
- APIs RESTful para gestión administrativa
- Dashboard responsive con métricas operativas
**Navbar Principal (anchor23.mx):**
- Reemplazar botón único "Solicitar Membresía" por dos botones:
- "Book Now" → /booking/servicios (The Boutique)
- "Memberships" → /membresias
- Mantener estructura limpia con 2 botones en nav-actions
**The Boutique (booking.anchor23.mx):**
- Crear layout específico con navbar personalizada
- Navbar incluye: logo, "Book Now", "Memberships", "Mis Citas", "Perfil"
- Estilos .booking-header y .booking-nav para header personalizado
- Compartir estilos base con anchor23.mx
**Páginas The Boutique:**
- /booking/servicios - Selección de servicios con calendario interactivo
- /booking/cita - Confirmación de reserva con formulario de cliente
- /booking/confirmacion - Página de confirmación por código (short_id)
- API endpoints para servicios y ubicaciones
**Estilos:**
- Mantener paleta de colores de anchor23.mx (Bone White, Soft Cream, Membresías)
- Consistencia visual entre anchor23.mx y The Boutique
- Responsive para móviles
**Frontend (booking.anchor23.mx):**
- Crear página de selección de servicios (/booking/servicios)
- Catálogo de servicios con precios y duración
- Selección de ubicación
- Calendario interactivo para selección de fecha y hora
- Validación de disponibilidad en tiempo real
- Resumen de reserva con precio
- Crear página de confirmación de reserva (/booking/cita)
- Resumen detallado de la cita (servicio, fecha, hora, ubicación)
- Formulario para datos del cliente (nombre, email, teléfono, notas)
- Confirmación visual de la reserva
- Redirección a página de confirmación exitosa
**Backend APIs:**
- Crear /api/services para obtener servicios activos
- Filtrar por ubicación si se especifica
- Retornar precio y duración de cada servicio
- Crear /api/locations para obtener ubicaciones activas
- Retornar lista de locations con timezone
**Documentación:**
- Actualizar TASKS.md con progreso de The Boutique (20%)
- Agregar nuevas tareas pendientes (aperture, api pública)
- Actualizar README.md con:
- Nueva estructura de rutas (/booking/*)
- Nuevas APIs (/api/services, /api/locations)
- Estado actualizado de The Boutique
- Actualizar Fase 2 al 20% completado
**Estilos:**
- Mantener paleta de colores de anchor23.mx
- Diseño consistente con el resto del sitio
- Responsive para móviles
- Configurar puerto 2311 por defecto en package.json
- Actualizar README.md con puerto local 2311
- Actualizar DOMAIN_CONFIGURATION.md con puerto 2311
- Actualizar comandos ngrok para usar puerto correcto
- Actualizar URLs de acceso local
- Actualizar README.md con estado actual del proyecto
- Agregar sección de anchor23.mx frontend institucional
- Actualizar estructura de rutas y carpetas
- Actualizar fase actual (95% Fase 1, 60% Fase 2)
- Crear documento DOMAIN_CONFIGURATION.md con guía de dominios
- Crear documento ANCHOR23_FRONTEND.md con detalles técnicos
- Agregar referencias cruzadas en README
Completados recientes:
✅ Frontend institucional anchor23.mx (todas las páginas)
✅ Sistema de disponibilidad completo
✅ API de reservas para clientes
✅ HQ Dashboard con calendario multi-columna
- Crear landing page con hero, fundamento, servicios y testimoniales
- Crear página de servicios con grid y descripciones
- Crear página de historia con filosofía de la marca
- Crear página de contacto con formulario
- Crear página de franchises con solicitud
- Crear página de membresías con 3 tiers (Gold, Black, VIP)
- Crear páginas de Privacy Policy y Legal
- Implementar header y footer global
- Estilos con Tailwind CSS según especificaciones
- HTML semántico y estructura clara
- Conversión silenciosa hacia booking.anchor23.mx
- Crear página principal de HQ Dashboard
- Mostrar calendario diario con reservas
- Listado de reservas con información detallada
- Vista de disponibilidad de staff
- PATCH endpoint para actualizar estado de reservas
- Integrar con API de disponibilidad y reservas
- Crear route /api/bookings con POST y GET
- Validar disponibilidad de staff y recursos
- Crear cliente si no existe
- Generar short_id para reservas
- Utilizar RPC functions de disponibilidad
- Agregar utilidad generateShortId
- Corregir uso de INTO en SELECT con múltiples columnas
- La migración de Telegram se ejecutó correctamente
- Campos de scoring agregados: performance_score, total_bookings_completed, etc.
- Funciones de scoring implementadas: update_staff_performance_score(), get_top_performers()
- Triggers automáticos para notificaciones de Telegram
- Migrated database schema from db/migrations to supabase/migrations
- Added Supabase CLI configuration (config.toml, .gitignore)
- Added kiosk role and amenities tables for touch kiosks
- Added notification system for artist alerts
- Added seed data with test locations and staff
- Removed old migration scripts and documentation
- Updated tasks_mg.md with current setup
Features:
- 2 locations: ANCHOR:23 - Via KLAVA and TEST
- Kiosk role for touch screen check-in/booking
- Amenities: coffee, cocktails, mocktails for clients
- Notifications when client arrives
- 1 staff + 4 artists + 1 kiosk per location
- Services: hair, nails, makeup, lashes
Implementación completa de la Fase 1.1 y 1.2 del proyecto SalonOS:
## Cambios en Reglas de Negocio (PRD.md, AGENTS.md, TASKS.md)
- Actualizado reset de invitaciones de mensual a semanal (Lunes 00:00 UTC)
- Jerarquía de roles actualizada: Admin > Manager > Staff > Artist > Customer
- Artistas (antes colaboradoras) ahora tienen rol 'artist'
- Staff/Manager/Admin pueden ver PII de customers
- Artist solo ve nombre y notas de customers (restricción de privacidad)
## Estructura del Proyecto (Next.js 14)
- app/boutique/: Frontend de cliente
- app/hq/: Dashboard administrativo
- app/api/: API routes
- components/: Componentes UI reutilizables (boutique, hq, shared)
- lib/: Lógica de negocio (supabase, db, utils)
- db/: Esquemas, migraciones y seeds
- integrations/: Stripe, Google Calendar, WhatsApp
- scripts/: Scripts de utilidad y automatización
- docs/: Documentación del proyecto
## Esquema de Base de Datos (Supabase PostgreSQL)
8 tablas creadas:
- locations: Ubicaciones con timezone
- resources: Recursos físicos (estaciones, habitaciones, equipos)
- staff: Personal con roles jerárquicos
- services: Catálogo de servicios
- customers: Información de clientes con tier (free/gold)
- invitations: Sistema de invitaciones semanales
- bookings: Sistema de reservas con short_id (6 caracteres)
- audit_logs: Registro de auditoría automática
14 funciones creadas:
- generate_short_id(): Generador de Short ID (6 chars, collision-safe)
- generate_invitation_code(): Generador de códigos de invitación (10 chars)
- reset_weekly_invitations_for_customer(): Reset individual de invitaciones
- reset_all_weekly_invitations(): Reset masivo de invitaciones
- validate_secondary_artist_role(): Validación de secondary_artist
- log_audit(): Trigger de auditoría automática
- get_current_user_role(): Obtener rol del usuario actual
- is_staff_or_higher(): Verificar si es admin/manager/staff
- is_artist(): Verificar si es artist
- is_customer(): Verificar si es customer
- is_admin(): Verificar si es admin
- update_updated_at(): Actualizar timestamps
- generate_booking_short_id(): Generar Short ID automáticamente
- get_week_start(): Obtener inicio de semana
17+ triggers activos:
- Auditores automáticos en tablas críticas
- Timestamps updated_at en todas las tablas
- Validación de secondary_artist (trigger en lugar de constraint)
20+ políticas RLS configuradas:
- Restricción crítica: Artist no ve email/phone de customers
- Jerarquía de roles: Admin > Manager > Staff > Artist > Customer
- Políticas granulares por tipo de operación y rol
6 tipos ENUM:
- user_role: admin, manager, staff, artist, customer
- customer_tier: free, gold
- booking_status: pending, confirmed, cancelled, completed, no_show
- invitation_status: pending, used, expired
- resource_type: station, room, equipment
- audit_action: create, update, delete, reset_invitations, payment, status_change
## Scripts de Utilidad
- check-connection.sh: Verificar conexión a Supabase
- simple-verify.sh: Verificar migraciones instaladas
- simple-seed.sh: Crear datos de prueba
- create-auth-users.js: Crear usuarios de Auth en Supabase
- verify-migration.sql: Script de verificación SQL completo
- seed-data.sql: Script de seed de datos SQL completo
## Documentación
- docs/STEP_BY_STEP_VERIFICATION.md: Guía paso a paso de verificación
- docs/STEP_BY_STEP_AUTH_CONFIG.md: Guía paso a paso de configuración Auth
- docs/POST_MIGRATION_SUCCESS.md: Guía post-migración
- docs/MIGRATION_CORRECTION.md: Detalle de correcciones aplicadas
- docs/QUICK_START_POST_MIGRATION.md: Guía rápida de referencia
- docs/SUPABASE_DASHBOARD_MIGRATION.md: Guía de ejecución en Dashboard
- docs/00_FULL_MIGRATION_FINAL_README.md: Guía de migración final
- SIMPLE_GUIDE.md: Guía simple de inicio
- FASE_1_STATUS.md: Estado de la Fase 1
## Configuración
- package.json: Dependencias y scripts de npm
- tsconfig.json: Configuración TypeScript con paths aliases
- next.config.js: Configuración Next.js
- tailwind.config.ts: Tema personalizado con colores primary, secondary, gold
- postcss.config.js: Configuración PostCSS
- .gitignore: Archivos excluidos de git
- .env.example: Template de variables de entorno
## Correcciones Aplicadas
1. Constraint de subquery en CHECK reemplazado por trigger de validación
- PostgreSQL no permite subqueries en CHECK constraints
- validate_secondary_artist_role() ahora es un trigger
2. Variable no declarada en loop
- customer_record RECORD; añadido en bloque DECLARE
## Principios Implementados
- UTC-first: Todos los timestamps se almacenan en UTC
- Sistema Doble Capa: Validación Staff/Artist + Recurso físico
- Reset semanal: Invitaciones se resetean cada Lunes 00:00 UTC
- Idempotencia: Procesos de reset son idempotentes y auditados
- Privacidad: Artist solo ve nombre y notas de customers
- Auditoría: Todas las acciones críticas se registran automáticamente
- Short ID: 6 caracteres alfanuméricos como referencia humana
- UUID: Identificador primario interno
## Próximos Pasos
- Ejecutar scripts de verificación y seed
- Configurar Auth en Supabase Dashboard
- Implementar Tarea 1.3: Short ID & Invitaciones (backend)
- Implementar Tarea 1.4: CRM Base (endpoints CRUD)
