AnchorOS/TASKS.md

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.