first commit

TASKS.md

@@ -0,0 +1,194 @@
+# TASKS.md — Plan de Ejecución por Agentes
+
+Este documento define las tareas ejecutables del proyecto SalonOS, descompuestas para trabajo asistido por modelos (Claude, Codex, OpenCode, Gemini) y desarrollo humano.
+
+Las tareas están alineadas estrictamente con el PRD. No se permite introducir lógica no documentada.
+
+---
+
+## Convenciones
+
+* Cada tarea debe producir artefactos verificables (código, migraciones, tests, docs).
+* Las reglas de negocio viven en backend.
+* Ningún agente redefine alcance.
+
+---
+
+## FASE 1 — Cimientos y CRM
+
+### 1.1 Infraestructura Base
+
+* Crear proyecto Supabase.
+* Configurar Auth (Magic Links Email/SMS).
+* Definir RLS global por rol (Admin / Manager / Staff / Customer).
+
+**Output:**
+
+* Supabase project configurado.
+* Policies iniciales documentadas.
+
+---
+
+### 1.2 Esquema de Base de Datos Inicial
+
+Tablas:
+
+* locations
+* resources
+* staff
+* services
+* customers
+* invitations
+* bookings
+* audit_logs
+
+Tareas:
+
+* Definir migraciones SQL.
+* Claves foráneas y constraints.
+* Campos de auditoría (`created_at`, `updated_at`).
+
+**Output:**
+
+* Migraciones versionadas.
+* Diagrama lógico.
+
+---
+
+### 1.3 Short ID & Invitaciones
+
+* Generador de Short ID (6 chars, collision-safe).
+* Generador y validación de códigos de invitación.
+* Lógica de cuotas por Tier.
+
+**Output:**
+
+* Funciones backend.
+* Tests unitarios.
+
+---
+
+### 1.4 CRM Base (Customers)
+
+* Cálculo automático de Tier.
+* Tracking de referidos.
+* Perfil privado de cliente.
+
+**Output:**
+
+* Endpoints CRUD.
+* Policies RLS por rol.
+
+---
+
+## FASE 2 — Motor de Agendamiento
+
+### 2.1 Disponibilidad Doble Capa
+
+* Validación Staff:
+
+  * Horario laboral.
+  * Eventos en Google Calendar.
+
+* Validación Recurso:
+
+  * Disponibilidad de estación física.
+
+* Regla de prioridad dinámica.
+
+**Output:**
+
+* Algoritmo de disponibilidad.
+* Tests de colisión.
+
+---
+
+### 2.2 Servicios Express (Dual Staff)
+
+* Búsqueda de dos colaboradoras simultáneas.
+* Bloqueo de Sillón de Pedicura.
+* Liberación de mesa secundaria.
+* Aplicación automática de Premium Fee.
+
+**Output:**
+
+* Lógica de booking dual.
+* Casos de prueba.
+
+---
+
+### 2.3 Google Calendar Sync
+
+* Integración vía Service Account.
+* Sync bidireccional.
+* Manejo de conflictos.
+
+**Output:**
+
+* Servicio de sincronización.
+* Logs de errores.
+
+---
+
+## FASE 3 — Pagos y Protección
+
+### 3.1 Stripe — Depósitos Dinámicos
+
+* Regla $200 vs 50%.
+* Asociación pago ↔ booking.
+
+**Output:**
+
+* Webhooks Stripe.
+* Validación de pagos.
+
+---
+
+### 3.2 No-Show Logic
+
+* Ventana 12h.
+* Penalización automática.
+* Override Admin.
+
+**Output:**
+
+* Función de penalización.
+* Auditoría en `audit_logs`.
+
+---
+
+## FASE 4 — HQ Dashboard
+
+### 4.1 Calendario Multi-Columna
+
+* Vista por staff.
+* Bloques de 15 min.
+
+---
+
+### 4.2 Gestión Operativa
+
+* Recursos.
+* Staff.
+* Traspaso entre sucursales.
+
+---
+
+### 4.3 The Vault
+
+* Upload fotos privadas.
+* Formularios técnicos.
+
+---
+
+## FASE 5 — Automatización y Lanzamiento
+
+* WhatsApp confirmaciones.
+* Recibos digitales.
+* Landing Believers.
+
+---
+
+## Regla Final
+
+Si una tarea no está aquí, no existe.