Files
AnchorOS/docs/00_FULL_MIGRATION_FINAL_README.md
Marco Gallegos 4707ddbd5a feat(salonos): implementar Fase 1.1 y 1.2 - Infraestructura y Esquema de Base de Datos
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)
2026-01-15 14:58:28 -06:00

3.9 KiB

🎉 MIGRACIÓN FINAL - SalonOS

Estado: Listo para Ejecutar

Este archivo contiene la versión final corregida de todas las migraciones de base de datos de SalonOS.

🐛 Correcciones Aplicadas

1. Constraint Reemplazado por Trigger

  • Problema: PostgreSQL no permite subqueries en constraints CHECK
  • Solución: Reemplazado por trigger de validación validate_secondary_artist_role()

2. Variable de Loop Declarada

  • Problema: Variable customer_record no declarada en función reset_all_weekly_invitations()
  • Solución: Declarada como customer_record RECORD; en bloque DECLARE

📋 Contenido del Archivo

Este archivo incluye:

  • Migración 001: Esquema inicial (8 tablas, 6 tipos ENUM, índices, constraints, triggers)
  • Migración 002: Políticas RLS (20+ políticas, 4 funciones auxiliares)
  • Migración 003: Triggers de auditoría (13 funciones, triggers automáticos)
  • Corrección 1: Trigger de validación en lugar de constraint con subquery
  • Corrección 2: Variable de loop declarada correctamente

🚀 Cómo Ejecutar

Paso 1: Abrir Supabase SQL Editor

https://supabase.com/dashboard/project/pvvwbnybkadhreuqijsl/sql

Paso 2: Copiar el Archivo

Copia TODO el contenido de:

db/migrations/00_FULL_MIGRATION_FINAL.sql

Paso 3: Ejecutar

  1. Pega el contenido en el SQL Editor
  2. Haz clic en "Run"
  3. Espera 10-30 segundos

📊 Resultado Esperado

Al completar la ejecución, deberías ver:

===========================================
SALONOS - DATABASE MIGRATION COMPLETED
===========================================
✅ Tables created: 8
✅ Functions created: 14
✅ Triggers active: 17+
✅ RLS policies configured: 20+
✅ ENUM types created: 6
===========================================

🔍 Verificación

Verificar Tablas

SELECT table_name
FROM information_schema.tables
WHERE table_schema = 'public'
ORDER BY table_name;

Esperado: 8 tablas

Verificar Funciones

SELECT routine_name
FROM information_schema.routines
WHERE routine_schema = 'public'
ORDER BY routine_name;

Esperado: 14 funciones

Verificar Triggers

SELECT trigger_name, event_object_table
FROM information_schema.triggers
WHERE trigger_schema = 'public'
ORDER BY event_object_table, trigger_name;

Esperado: 17+ triggers

Verificar Políticas RLS

SELECT schemaname, tablename, policyname
FROM pg_policies
WHERE schemaname = 'public'
ORDER BY tablename, policyname;

Esperado: 20+ políticas

Probar Short ID

SELECT generate_short_id();

Esperado: String de 6 caracteres alfanuméricos (ej: "A3F7X2")

Probar Código de Invitación

SELECT generate_invitation_code();

Esperado: String de 10 caracteres alfanuméricos (ej: "X9J4K2M5N8")

🎯 Próximos Pasos

Después de ejecutar exitosamente la migración:

  1. Configurar Auth en Supabase Dashboard
  2. Crear usuarios de prueba con roles específicos
  3. Probar el sistema con consultas de verificación
  4. Ejecutar seed de datos (opcional): npm run db:seed
  5. Continuar desarrollo de Tarea 1.3 y 1.4

📚 Documentación Adicional

  • docs/MIGRATION_CORRECTION.md - Detalle de las correcciones aplicadas
  • docs/SUPABASE_DASHBOARD_MIGRATION.md - Guía completa de ejecución
  • docs/MIGRATION_GUIDE.md - Guía técnica de migraciones
  • db/migrations/README.md - Documentación técnica de migraciones
  • scripts/README.md - Documentación de scripts de utilidad

🆘 Soporte

Si encuentras problemas:

  1. Revisa los logs de Supabase Dashboard
  2. Ejecuta las consultas de verificación arriba
  3. Consulta docs/MIGRATION_CORRECTION.md para detalles de las correcciones
  4. Consulta docs/SUPABASE_DASHBOARD_MIGRATION.md para guía paso a paso

Última actualización: 2026-01-15 Versión: FINAL (Correcciones aplicadas) Estado: Listo para producción