# PRD — SalonOS

## 1. Objetivo

SalonOS 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 mensuales.

### 3.3 Ecosistema de Exclusividad (Invitaciones)

* Cada cuenta Tier Gold tiene **5 invitaciones mensuales**.
* Las invitaciones **se resetean el día 1 de cada mes**.
* El reseteo es automático mediante:

  * Supabase Edge Function **o**
  * Cron Job externo.
* El proceso debe ser:

  * Idempotente.
  * Auditado en `audit_logs`.

---

## 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 SalonOS.