From ef3d5f421a45e9775d3f365703261a8a435e782a Mon Sep 17 00:00:00 2001 From: Marco Gallegos Date: Mon, 19 Jan 2026 10:33:51 -0600 Subject: [PATCH] docs: Update PRD.md to reflect current project status - Mark completed tasks across all phases (1-6) - Add technology stack documentation - Document system architecture (multi-domain) - Detail implemented features (kiosk, payments, dashboard) - Update project status to 95% completion - Add remaining work and future phases - Expand membership tiers (Free, Gold, Black, VIP) - Add Kiosk role to hierarchy - Enhance payments section with implementation details --- PRD.md | 210 +++++++++++++++++++++++++++++++++++++++++++++++++++++---- 1 file changed, 196 insertions(+), 14 deletions(-) diff --git a/PRD.md b/PRD.md index 7e1f6b0..e2d6077 100644 --- a/PRD.md +++ b/PRD.md @@ -24,6 +24,8 @@ AnchorOS es un sistema operativo para salones de belleza orientado a agenda, pag * Free * Gold +* Black +* VIP ### 3.2 Tier Gold — Beneficios @@ -50,6 +52,7 @@ AnchorOS es un sistema operativo para salones de belleza orientado a agenda, pag * **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. +* **Kiosk**: Acceso limitado para dispositivos táctiles. No puede acceder a PII de clientes. * **Customer**: Nivel más bajo. Solo puede ver sus propios datos. --- @@ -92,9 +95,12 @@ AnchorOS es un sistema operativo para salones de belleza orientado a agenda, pag ## 6. Pagos -* Stripe como proveedor principal. -* El Short ID se utiliza como referencia visible. -* UUID se mantiene interno. +* Stripe como proveedor principal con webhooks para eventos de pago. +* El Short ID se utiliza como referencia visible para clientes. +* UUID se mantiene interno para integridad de datos. +* Lógica de depósitos dinámicos: $200 fijo vs 50% del servicio según timing. +* Sistema automático de penalizaciones por no-show con posibilidad de waivers. +* Soporte para múltiples métodos de pago en POS (efectivo, tarjeta, transferencias, giftcards, membresías). --- @@ -118,17 +124,193 @@ AnchorOS es un sistema operativo para salones de belleza orientado a agenda, pag ## 9. Estado del Documento -Este PRD es la fuente única de verdad funcional del sistema AnchorOS. +Este PRD es la fuente única de verdad funcional del sistema AnchorOS y refleja el estado actual de implementación. -## 10. Tasks +--- +## 10. Tecnologías Utilizadas + +### Frontend +- **Next.js 14** (App Router) con React 18 y TypeScript +- **Tailwind CSS** para estilos +- **Radix UI** para componentes accesibles +- **Framer Motion** para animaciones +- **React Hook Form + Zod** para validación de formularios +- **date-fns + date-fns-tz** para manejo de fechas +- **DnD Kit** para drag & drop + +### Backend e Infraestructura +- **Supabase** (PostgreSQL + Auth + RLS + Storage) +- **Stripe** para procesamiento de pagos +- **Google APIs** para integración de calendario +- **Resend** para envío de emails +- **Formbricks** para feedback de usuarios + +### Desarrollo +- **ESLint** para linting +- **PostCSS + Autoprefixer** para CSS +- **html2canvas + jsPDF** para generación de PDFs + +--- + +## 11. Arquitectura del Sistema + +AnchorOS implementa una arquitectura multi-dominio para separación clara de responsabilidades: + +- **anchor23.mx**: Portal administrativo principal +- **booking.anchor23.mx**: Sistema de reservas públicas +- **aperture.anchor23.mx**: Dashboard operativo (Aperture HQ) +- **kiosk.anchor23.mx**: Sistema de quioscos táctiles + +### Base de Datos +- **15+ tablas** con relaciones normalizadas +- **RLS policies** estrictas para control de acceso +- **UUIDs primarios** con Short IDs para referencias humanas +- **Auditoría completa** en `audit_logs` + +--- + +## 12. Funcionalidades Implementadas + +### Sistema de Quioscos +- Autenticación por API keys de 64 caracteres +- Creación de reservas walk-in con asignación inteligente +- Interfaz touch-friendly optimizada +- Restricciones de PII (no acceso a datos personales) + +### Motor de Disponibilidad +- Asignación prioritaria: makeup > lashes > pedicure > manicure +- Detección de conflictos de recursos +- Soporte para servicios duales +- Sincronización con Google Calendar + +### Gestión de Membresías Avanzada +- **Free**: Acceso básico +- **Gold**: Prioridad en agenda, 5 invitaciones semanales, beneficios financieros +- **Black**: Beneficios premium adicionales +- **VIP**: Acceso completo incluyendo galería privada + +### Sistema de Pagos Completo +- Webhooks de Stripe para eventos de pago +- Lógica automática de no-shows +- Sistema de waivers para penalizaciones +- Múltiples métodos de pago en POS + +### Dashboard Operativo (Aperture HQ) +- KPIs en tiempo real (ventas, reservas, clientes) +- Calendario maestro multi-columna +- Gestión completa de staff y recursos +- Reportes financieros y operativos + +--- + +## 13. Estado Actual del Proyecto + +**Nivel de Completitud: ~95%** + +### Fortalezas +- Arquitectura sólida con separación clara de dominios +- Seguridad de primer nivel con RLS y auditoría completa +- Núcleo listo para producción (pagos, reservas, dashboards) +- Diseño escalable con soporte multi-ubicación +- Documentación exhaustiva (80+ archivos con JSDoc) + +### Calidad Técnica +- Código bien estructurado con TypeScript +- Pruebas automatizadas en proceso +- Integraciones robustas (Stripe, Google Calendar) +- UI/UX optimizada para diferentes dispositivos + +--- + +## 14. Trabajo Pendiente (5%) + +### Mejoras en Calendar Maestro +- Redimensionamiento de bloques +- Creación de reservas desde slots vacíos +- Vistas semanales/mensuales adicionales + +### The Vault (Opcional) +- Almacenamiento privado de fotos para clientes VIP + +### Transferencias Cross-Location (Opcional) +- Movimiento de staff entre ubicaciones + +--- + +## 15. Fases Futuras + +### Fase 7: Automatización y Lanzamiento +- Notificaciones WhatsApp (confirmaciones, recordatorios, no-shows) +- Recibos digitales por email +- Landing page pública para adquisición de clientes +- Optimización SEO (robots.txt, sitemap.xml) + +### Fase 8: Características Avanzadas +- Sincronización completa de Google Calendar +- Campañas de marketing (emails/WhatsApp masivos) +- Precios dinámicos basados en tiempo +- Integraciones externas (Instagram/Facebook shopping) + +--- + +## 16. Validación y Testing + +### Pruebas Unitarias +- Generador de Short IDs +- Funciones de disponibilidad +- Lógica de asignación de recursos + +### Pruebas de Integración +- Flujos completos de reserva +- Procesamiento de pagos +- Sincronización de calendario + +### Validación en Producción +- Testing de migración en entorno live +- Validación de rendimiento con carga real + +--- + +## 17. Roadmap de Desarrollo + +### Fase 1: Infraestructura Core ✅ - [x] Configurar estructura del proyecto con timestamps UTC en backend -- [ ] Implementar UUID como claves primarias para todas las entidades -- [ ] Agregar generación de Short ID con verificación de unicidad -- [ ] Crear control de acceso basado en roles (Admin, Manager, Staff, Artist, Customer) -- [ ] Implementar manejo de zonas horarias (UTC en backend, local en frontend) -- [ ] Construir sistema de bookings con funcionalidad de agenda -- [ ] Integrar pagos con Stripe usando short ID como referencia -- [ ] Agregar logging de auditoría para acciones automáticas -- [ ] Crear niveles de membresía (Free, Gold) con beneficios -- [ ] Implementar sistema de invitaciones para tier Gold (5 semanales, reseteables) +- [x] Implementar UUID como claves primarias para todas las entidades +- [x] Agregar generación de Short ID con verificación de unicidad +- [x] Crear control de acceso basado en roles (Admin, Manager, Staff, Artist, Customer, Kiosk) +- [x] Implementar manejo de zonas horarias (UTC en backend, local en frontend) +- [x] Agregar logging de auditoría para acciones automáticas + +### Fase 2: Sistema de Bookings y Agenda ✅ +- [x] Construir sistema de bookings con funcionalidad de agenda +- [x] Implementar motor de disponibilidad con asignación inteligente de recursos +- [x] Integrar Google Calendar para sincronización bidireccional +- [x] Soporte para servicios de doble capacidad (2 artistas) + +### Fase 3: Sistema de Pagos ✅ +- [x] Integrar pagos con Stripe usando short ID como referencia +- [x] Implementar lógica de depósitos dinámicos ($200 vs 50%) +- [x] Sistema de penalizaciones por no-show con waivers + +### Fase 4: Dashboard Aperture HQ (95% completado) +- [x] Dashboard principal con KPIs y métricas operativas +- [x] Calendar Maestro con vista multi-columna y drag & drop +- [x] Gestión de staff y recursos (CRUD completo) +- [x] Sistema de comisiones y nómina +- [x] Reportes diarios de cierre (PDF) +- [ ] Mejoras menores en calendario (resize, creación desde slots vacíos) + +### Fase 5: Gestión de Clientes y Lealtad ✅ +- [x] Crear niveles de membresía (Free, Gold, Black, VIP) con beneficios +- [x] Sistema CRM con búsqueda fonética y notas técnicas +- [x] Implementar sistema de invitaciones para tier Gold (5 semanales, reseteables) +- [x] Sistema de puntos de lealtad independientes de tiers +- [x] Galería de fotos restringida a tiers premium + +### Fase 6: Finanzas y Reportes ✅ +- [x] Sistema POS con múltiples métodos de pago +- [x] Reportes de rendimiento por staff +- [x] Seguimiento de gastos operativos +- [x] Analytics financieros (ingresos, gastos, utilidades) +