mirror of
https://github.com/marcogll/AnchorOS.git
synced 2026-03-15 13:24:27 +00:00
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
This commit is contained in:
210
PRD.md
210
PRD.md
@@ -24,6 +24,8 @@ AnchorOS es un sistema operativo para salones de belleza orientado a agenda, pag
|
|||||||
|
|
||||||
* Free
|
* Free
|
||||||
* Gold
|
* Gold
|
||||||
|
* Black
|
||||||
|
* VIP
|
||||||
|
|
||||||
### 3.2 Tier Gold — Beneficios
|
### 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.
|
* **Manager**: Acceso operacional. Puede ver PII de clientes y hacer ajustes.
|
||||||
* **Staff**: Nivel de coordinación. 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.
|
* **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.
|
* **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
|
## 6. Pagos
|
||||||
|
|
||||||
* Stripe como proveedor principal.
|
* Stripe como proveedor principal con webhooks para eventos de pago.
|
||||||
* El Short ID se utiliza como referencia visible.
|
* El Short ID se utiliza como referencia visible para clientes.
|
||||||
* UUID se mantiene interno.
|
* 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
|
## 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
|
- [x] Configurar estructura del proyecto con timestamps UTC en backend
|
||||||
- [ ] Implementar UUID como claves primarias para todas las entidades
|
- [x] Implementar UUID como claves primarias para todas las entidades
|
||||||
- [ ] Agregar generación de Short ID con verificación de unicidad
|
- [x] Agregar generación de Short ID con verificación de unicidad
|
||||||
- [ ] Crear control de acceso basado en roles (Admin, Manager, Staff, Artist, Customer)
|
- [x] Crear control de acceso basado en roles (Admin, Manager, Staff, Artist, Customer, Kiosk)
|
||||||
- [ ] Implementar manejo de zonas horarias (UTC en backend, local en frontend)
|
- [x] Implementar manejo de zonas horarias (UTC en backend, local en frontend)
|
||||||
- [ ] Construir sistema de bookings con funcionalidad de agenda
|
- [x] Agregar logging de auditoría para acciones automáticas
|
||||||
- [ ] Integrar pagos con Stripe usando short ID como referencia
|
|
||||||
- [ ] Agregar logging de auditoría para acciones automáticas
|
### Fase 2: Sistema de Bookings y Agenda ✅
|
||||||
- [ ] Crear niveles de membresía (Free, Gold) con beneficios
|
- [x] Construir sistema de bookings con funcionalidad de agenda
|
||||||
- [ ] Implementar sistema de invitaciones para tier Gold (5 semanales, reseteables)
|
- [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)
|
||||||
|
|
||||||
|
|||||||
Reference in New Issue
Block a user