mirror of
https://github.com/marcogll/AnchorOS.git
synced 2026-03-15 13:24:27 +00:00
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)
149 lines
3.9 KiB
Markdown
149 lines
3.9 KiB
Markdown
# 🎉 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
|
|
```sql
|
|
SELECT table_name
|
|
FROM information_schema.tables
|
|
WHERE table_schema = 'public'
|
|
ORDER BY table_name;
|
|
```
|
|
|
|
**Esperado:** 8 tablas
|
|
|
|
### Verificar Funciones
|
|
```sql
|
|
SELECT routine_name
|
|
FROM information_schema.routines
|
|
WHERE routine_schema = 'public'
|
|
ORDER BY routine_name;
|
|
```
|
|
|
|
**Esperado:** 14 funciones
|
|
|
|
### Verificar Triggers
|
|
```sql
|
|
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
|
|
```sql
|
|
SELECT schemaname, tablename, policyname
|
|
FROM pg_policies
|
|
WHERE schemaname = 'public'
|
|
ORDER BY tablename, policyname;
|
|
```
|
|
|
|
**Esperado:** 20+ políticas
|
|
|
|
### Probar Short ID
|
|
```sql
|
|
SELECT generate_short_id();
|
|
```
|
|
|
|
**Esperado:** String de 6 caracteres alfanuméricos (ej: "A3F7X2")
|
|
|
|
### Probar Código de Invitación
|
|
```sql
|
|
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
|