mirror of https://github.com/marcogll/AnchorOS.git synced 2026-03-15 15:24:29 +00:00

Files

Marco Gallegos e3c4f30648 feat: implement customer registration flow and business hours system

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

2026-01-17 00:48:49 -06:00

2.7 KiB

Raw Blame History

PRD — AnchorOS

Codename: Adela

1. Objetivo

AnchorOS es un sistema operativo para salones de belleza orientado a agenda, pagos, membresías e invitados, con reglas estrictas de tiempo, seguridad y automatización.

2. Principios del Sistema

UTC-first en todo el backend.
UUID como identificador primario interno.
Short ID solo para referencia humana.
Automatismos auditables.
PRD como única fuente de verdad.

3. Roles y Membresías

3.1 Tiers

Free
Gold

3.2 Tier Gold — Beneficios

Acceso prioritario a agenda.
Beneficios financieros definidos en pricing.
Invitaciones semanales.

3.3 Ecosistema de Exclusividad (Invitaciones)

Cada cuenta Tier Gold tiene 5 invitaciones semanales.
Las invitaciones se resetean cada semana (Lunes 00:00 UTC).
El reseteo es automático mediante:
- Supabase Edge Function o
- Cron Job externo.
El proceso debe ser:
- Idempotente.
- Auditado en audit_logs.

3.4 Jerarquía de Roles

Admin: Acceso total. Puede ver PII de clientes y hacer ajustes.
Manager: Acceso operacional. Puede ver PII de clientes y hacer ajustes.
Staff: Nivel de coordinación. Puede ver PII de clientes y hacer ajustes.
Artist: Nivel de ejecución. Solo puede ver nombre y notas del cliente. No ve email ni phone.
Customer: Nivel más bajo. Solo puede ver sus propios datos.

4. Gestión de Tiempo y Zonas Horarias

Todos los timestamps se almacenan en UTC.
locations.timezone define la zona local del salón.
Conversión a hora local:
- Solo en frontend.
- Solo en notificaciones (WhatsApp / Email).
Backend, reglas de negocio y validaciones operan exclusivamente en UTC.

5. Agenda y Bookings

5.1 Identificadores

Cada booking tiene:
- id (UUID, primario).
- short_id (6 caracteres alfanuméricos).

5.2 Short ID — Reglas

Se genera antes de persistir el booking.
Debe verificarse unicidad.
Si existe colisión:
- Reintentar generación hasta ser único.
El Short ID:
- Es referencia de pago.
- Es identificador operativo.
- No sustituye el UUID.

6. Pagos

Stripe como proveedor principal.
El Short ID se utiliza como referencia visible.
UUID se mantiene interno.

7. Auditoría

Toda acción automática o crítica debe registrarse en audit_logs.
Incluye:
- Reseteo de invitaciones.
- Cambios de estado de bookings.
- Eventos de pago.

8. Límites de los Agentes de IA

Ningún agente puede modificar reglas aquí descritas.
Toda implementación debe alinearse estrictamente a este PRD.

9. Estado del Documento

Este PRD es la fuente única de verdad funcional del sistema AnchorOS.

2.7 KiB Raw Blame History