mirror of
https://github.com/marcogll/AnchorOS.git
synced 2026-03-15 13:24:27 +00:00
Definicion de proyecto
This commit is contained in:
Marco Gallegos
345
PRD.md
345
PRD.md
@@ -1,316 +1,111 @@
|
||||
🥂 SalonOS — Product Requirements Document (PRD)
|
||||
# PRD — SalonOS
|
||||
|
||||
Exclusive Studio Management & CRM EngineVersión: 1.0Estado: Documento Maestro de Planificación
|
||||
## 1. Objetivo
|
||||
|
||||
Este documento constituye la especificación definitiva del producto SalonOS. Consolida la visión de negocio, las reglas operativas, la experiencia de usuario y la arquitectura técnica. Funciona como contrato de alineación entre la dueña del negocio y el equipo de diseño y desarrollo.
|
||||
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.
|
||||
|
||||
1. Visión y Propósito del Proyecto
|
||||
---
|
||||
|
||||
SalonOS no es una agenda digital. Es un sistema de gestión de activos, exclusividad y control operativo diseñado para estudios de belleza premium.
|
||||
## 2. Principios del Sistema
|
||||
|
||||
1.1 Propósito Dual
|
||||
* 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.
|
||||
|
||||
Para la Clienta
|
||||
---
|
||||
|
||||
Experiencia de reserva privada, rápida y sin fricción.
|
||||
## 3. Roles y Membresías
|
||||
|
||||
Sensación de pertenencia a un círculo exclusivo.
|
||||
### 3.1 Tiers
|
||||
|
||||
Interfaz minimalista estilo Townhouse Beauty.
|
||||
* Free
|
||||
* Gold
|
||||
|
||||
Para el Negocio
|
||||
### 3.2 Tier Gold — Beneficios
|
||||
|
||||
Maximizar la rentabilidad por metro cuadrado.
|
||||
* Acceso prioritario a agenda.
|
||||
* Beneficios financieros definidos en pricing.
|
||||
* Invitaciones mensuales.
|
||||
|
||||
Optimizar el uso de recursos físicos y humanos.
|
||||
### 3.3 Ecosistema de Exclusividad (Invitaciones)
|
||||
|
||||
Proteger la base de datos de clientes ante rotación de personal.
|
||||
* 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:
|
||||
|
||||
2. Experiencia de Usuario (UX) y Filosofía de Diseño
|
||||
* Supabase Edge Function **o**
|
||||
* Cron Job externo.
|
||||
* El proceso debe ser:
|
||||
|
||||
2.1 The Boutique — Interfaz de Clienta
|
||||
* Idempotente.
|
||||
* Auditado en `audit_logs`.
|
||||
|
||||
Principios
|
||||
---
|
||||
|
||||
Minimalismo extremo.
|
||||
## 4. Gestión de Tiempo y Zonas Horarias
|
||||
|
||||
Eliminación total de fricción.
|
||||
* **Todos los timestamps se almacenan en UTC**.
|
||||
* `locations.timezone` define la zona local del salón.
|
||||
* Conversión a hora local:
|
||||
|
||||
Diseño aspiracional, no comercial.
|
||||
* Solo en frontend.
|
||||
* Solo en notificaciones (WhatsApp / Email).
|
||||
* Backend, reglas de negocio y validaciones **operan exclusivamente en UTC**.
|
||||
|
||||
Características Clave
|
||||
---
|
||||
|
||||
Tipografía serif premium.
|
||||
## 5. Agenda y Bookings
|
||||
|
||||
Espacios amplios y navegación guiada.
|
||||
### 5.1 Identificadores
|
||||
|
||||
Sin contraseñas: autenticación vía Magic Links (Email / SMS).
|
||||
* Cada booking tiene:
|
||||
|
||||
Flujo Lineal de Reserva
|
||||
* `id` (UUID, primario).
|
||||
* `short_id` (6 caracteres alfanuméricos).
|
||||
|
||||
Selección de sucursal.
|
||||
### 5.2 Short ID — Reglas
|
||||
|
||||
Selección de servicio(s).
|
||||
* Se genera antes de persistir el booking.
|
||||
* Debe verificarse unicidad.
|
||||
* Si existe colisión:
|
||||
|
||||
Asignación de staff.
|
||||
* Reintentar generación hasta ser único.
|
||||
* El Short ID:
|
||||
|
||||
Selección de horario.
|
||||
* Es referencia de pago.
|
||||
* Es identificador operativo.
|
||||
* **No sustituye** el UUID.
|
||||
|
||||
Pago de depósito.
|
||||
---
|
||||
|
||||
Confirmación.
|
||||
## 6. Pagos
|
||||
|
||||
No existen bifurcaciones innecesarias.
|
||||
* Stripe como proveedor principal.
|
||||
* El Short ID se utiliza como referencia visible.
|
||||
* UUID se mantiene interno.
|
||||
|
||||
2.2 The HQ — Dashboard Administrativo
|
||||
---
|
||||
|
||||
Principios
|
||||
## 7. Auditoría
|
||||
|
||||
Claridad operativa.
|
||||
* Toda acción automática o crítica debe registrarse en `audit_logs`.
|
||||
* Incluye:
|
||||
|
||||
Control visual inmediato.
|
||||
* Reseteo de invitaciones.
|
||||
* Cambios de estado de bookings.
|
||||
* Eventos de pago.
|
||||
|
||||
Optimizado para escritorio y tablet.
|
||||
---
|
||||
|
||||
Características
|
||||
## 8. Límites de los Agentes de IA
|
||||
|
||||
Estética SquareUI.
|
||||
* Ningún agente puede modificar reglas aquí descritas.
|
||||
* Toda implementación debe alinearse estrictamente a este PRD.
|
||||
|
||||
Calendario multi-columna:
|
||||
|
||||
Columnas: profesionales.
|
||||
|
||||
Filas: bloques de 15 minutos.
|
||||
|
||||
Vista tipo Fresha, sin sobrecarga visual.
|
||||
|
||||
3. Módulos y Lógica de Negocio
|
||||
|
||||
3.1 Motor de Disponibilidad "Double-Lock"
|
||||
|
||||
Una cita solo puede existir si se validan simultáneamente dos capas:
|
||||
|
||||
Capa Humana
|
||||
|
||||
Colaboradora activa.
|
||||
|
||||
Dentro de horario laboral.
|
||||
|
||||
Sin conflicto en Google Calendar personal.
|
||||
|
||||
Capa Física
|
||||
|
||||
Recurso físico requerido disponible.
|
||||
|
||||
Sin colisión con otra reserva.
|
||||
|
||||
Regla de Prioridad Dinámica
|
||||
Si existen más colaboradoras que estaciones físicas, el sistema limita la agenda según el recurso disponible.
|
||||
|
||||
3.2 Servicios Express (Dual Staff)
|
||||
|
||||
Servicios simultáneos diseñados para optimizar el tiempo de la clienta.
|
||||
|
||||
Reglas
|
||||
|
||||
Requiere dos colaboradoras disponibles en el mismo rango.
|
||||
|
||||
Uso obligatorio del Sillón de Pedicura para Mani + Pedi.
|
||||
|
||||
La mesa de manicura queda liberada para otra venta.
|
||||
|
||||
Se aplica automáticamente un Premium Fee.
|
||||
|
||||
El sistema trata el servicio dual como una sola entidad lógica.
|
||||
|
||||
3.3 Ecosistema de Exclusividad (Invite-Only)
|
||||
|
||||
No existe registro abierto.
|
||||
|
||||
Reglas de Acceso
|
||||
|
||||
Agenda solo disponible con código de invitación válido.
|
||||
|
||||
Cuotas por Tier
|
||||
|
||||
Regular: 2 invitaciones (lifetime).
|
||||
|
||||
Gold: 5 invitaciones nuevas por mes.
|
||||
|
||||
VIP: Ilimitadas.
|
||||
|
||||
Tier Especial
|
||||
|
||||
Believer: Clientas fundadoras.
|
||||
|
||||
Ascienden a Gold con solo 2 citas completadas.
|
||||
|
||||
3.4 Blindaje y Privacidad de Datos
|
||||
|
||||
Vista del Staff
|
||||
|
||||
Nombre de la clienta.
|
||||
|
||||
Tier.
|
||||
|
||||
Historial técnico.
|
||||
|
||||
Información Oculta al Staff
|
||||
|
||||
Teléfono.
|
||||
|
||||
Email.
|
||||
|
||||
Historial financiero.
|
||||
|
||||
Audit Trail
|
||||
|
||||
Toda acción queda registrada:
|
||||
|
||||
Usuario.
|
||||
|
||||
Timestamp.
|
||||
|
||||
Motivo del cambio.
|
||||
|
||||
4. Gestión Financiera y Depósitos Dinámicos
|
||||
|
||||
4.1 Booking Fees
|
||||
|
||||
Días Valle (Dom–Mié)
|
||||
|
||||
Depósito fijo: $200 MXN.
|
||||
|
||||
Días Premium (Jue–Sáb)
|
||||
|
||||
Anticipo: 50% del total.
|
||||
|
||||
Cada cita genera un Short ID de 6 caracteres, que funciona como:
|
||||
|
||||
Referencia de pago.
|
||||
|
||||
Identificador operativo.
|
||||
|
||||
4.2 Política No-Show
|
||||
|
||||
Captura de tarjeta vía Stripe.
|
||||
|
||||
Ventana de cancelación: 12 horas.
|
||||
|
||||
Penalización automática si no cumple.
|
||||
|
||||
Condonación manual solo por Admin.
|
||||
|
||||
5. Operación de Staff — The Vault
|
||||
|
||||
Al cerrar una cita, la documentación es obligatoria.
|
||||
|
||||
Contenido
|
||||
|
||||
Fórmulas técnicas.
|
||||
|
||||
Productos utilizados.
|
||||
|
||||
Fotos Antes / Después.
|
||||
|
||||
Traspaso de Personal
|
||||
|
||||
Módulo para mover colaboradoras entre sucursales.
|
||||
|
||||
Reasignación automática de citas.
|
||||
|
||||
La información pertenece al negocio, no al staff.
|
||||
|
||||
6. Arquitectura Técnica
|
||||
|
||||
6.1 Stack
|
||||
|
||||
Frontend: Next.js 14 + Tailwind CSS + Framer Motion.
|
||||
|
||||
Backend: Supabase (PostgreSQL + Auth + RLS).
|
||||
|
||||
Pagos: Stripe SDK.
|
||||
|
||||
Calendario: Google Calendar API v3 (Service Account).
|
||||
|
||||
Notificaciones: WhatsApp API (Twilio / Meta).
|
||||
|
||||
Storage: Supabase Storage (Buckets privados).
|
||||
|
||||
7. Esquema de Base de Datos (Sugerido)
|
||||
|
||||
locations
|
||||
|
||||
resources
|
||||
|
||||
staff
|
||||
|
||||
services
|
||||
|
||||
customers
|
||||
|
||||
invitations
|
||||
|
||||
bookings
|
||||
|
||||
audit_logs
|
||||
|
||||
Todas las tablas protegidas mediante Row Level Security.
|
||||
|
||||
8. Roadmap de Desarrollo
|
||||
|
||||
Fase 1 — Cimientos (Semanas 1–2)
|
||||
|
||||
DB y Auth.
|
||||
|
||||
Invitaciones.
|
||||
|
||||
Tiers.
|
||||
|
||||
Short IDs.
|
||||
|
||||
Fase 2 — Motor de Agenda (Semanas 3–5)
|
||||
|
||||
Doble Capa.
|
||||
|
||||
Servicios Express.
|
||||
|
||||
Google Calendar Sync.
|
||||
|
||||
Fase 3 — Pagos (Semanas 6–7)
|
||||
|
||||
Depósitos dinámicos.
|
||||
|
||||
No-show logic.
|
||||
|
||||
Fase 4 — HQ Dashboard (Semanas 8–9)
|
||||
|
||||
Calendario multi-columna.
|
||||
|
||||
Gestión de recursos.
|
||||
|
||||
The Vault.
|
||||
|
||||
Fase 5 — Lanzamiento (Semana 10)
|
||||
|
||||
WhatsApp.
|
||||
|
||||
Landing Believers.
|
||||
|
||||
9. Resumen de Valor para la Dueña
|
||||
|
||||
SalonOS entrega:
|
||||
|
||||
Blindaje total del negocio.
|
||||
|
||||
Optimización real del espacio físico.
|
||||
|
||||
Crecimiento orgánico controlado.
|
||||
|
||||
Protección financiera ante cancelaciones.
|
||||
|
||||
Este documento define la visión técnica oficial de SalonOS. Cualquier modificación posterior al inicio de la Fase 1 impacta alcance, tiempos y costos.
|
||||
|
||||
Proyecto: soul23
|
||||
---
|
||||
|
||||
## 9. Estado del Documento
|
||||
|
||||
Este PRD es la fuente única de verdad funcional del sistema SalonOS.
|
||||
|
||||
Reference in New Issue
Block a user