mirror of
https://github.com/marcogll/AnchorOS.git
synced 2026-03-15 11:24:26 +00:00
Compare commits
4 Commits
28e4a73cdf
...
24e5af3860
| Author | SHA1 | Date | |
|---|---|---|---|
|
|
24e5af3860 | ||
|
|
bff1edf04f | ||
|
|
ef3d5f421a | ||
|
|
68dfe54fd2 |
3
.gitignore
vendored
3
.gitignore
vendored
@@ -35,3 +35,6 @@ next-env.d.ts
|
||||
|
||||
# supabase
|
||||
.supabase/
|
||||
|
||||
# ralphy
|
||||
ralphy.sh
|
||||
|
||||
2
.ralphy/progress.txt
Normal file
2
.ralphy/progress.txt
Normal file
@@ -0,0 +1,2 @@
|
||||
# Ralphy Progress Log
|
||||
|
||||
238
Brand_Kit.md
Normal file
238
Brand_Kit.md
Normal file
@@ -0,0 +1,238 @@
|
||||
# ANCHOR:23
|
||||
|
||||
---
|
||||
|
||||
## 1. Origen de la Marca
|
||||
|
||||
Anchor:23 nace de la unión de **dos creativos** con trayectorias distintas y un criterio común: el lujo no es promesa, es estándar.
|
||||
|
||||
La marca surge como respuesta a una ausencia clara en la ciudad: un salón que opere bajo reglas de ultra lujo real, con ejecución constante, acceso limitado y una experiencia coherente en cada detalle.
|
||||
|
||||
No es una extensión de otra marca. No es una evolución emocional. Es un concepto paralelo, deliberadamente selectivo.
|
||||
|
||||
---
|
||||
|
||||
## 2. Significado del Nombre
|
||||
|
||||
### Anchor
|
||||
|
||||
Anchor representa el punto fijo. La base que sostiene y da estabilidad.
|
||||
|
||||
En la marca simboliza el estándar bajo el cual se ejecuta cada servicio, decisión y experiencia. No como rigidez, sino como referencia clara.
|
||||
|
||||
Es estructura. No ornamento.
|
||||
|
||||
### El signo (:)
|
||||
|
||||
El signo funciona como una **articulación**.
|
||||
|
||||
Ordena el nombre y permite la convivencia de dos criterios creativos dentro de un mismo sistema. No busca significado simbólico ni lectura emocional.
|
||||
|
||||
No se explica. No se enfatiza.
|
||||
|
||||
Comunica estructura.
|
||||
|
||||
### El número 23
|
||||
|
||||
El 23 es un **código interno**.
|
||||
|
||||
Remite a una idea de dirección, cuidado y constancia entendida de forma cultural y personal, no declarativa. No se presenta como mensaje ni como símbolo explícito.
|
||||
|
||||
No se comunica hacia afuera. Opera como fundamento silencioso del concepto.
|
||||
|
||||
El cliente no debe entenderlo.
|
||||
|
||||
Debe percibirlo en la experiencia: continuidad, calma y seguridad.
|
||||
|
||||
---
|
||||
|
||||
## 3. Categoría
|
||||
|
||||
Belleza de ultra lujo.
|
||||
|
||||
Anchor:23 opera como un **concepto exclusivo**, no masivo, con un estándar de servicio que no existe en el mercado local.
|
||||
|
||||
---
|
||||
|
||||
## 4. Propósito
|
||||
|
||||
Ofrecer una experiencia estética exclusiva basada en precisión técnica, coherencia visual y ejecución constante.
|
||||
|
||||
---
|
||||
|
||||
## 5. Visión
|
||||
|
||||
Ser el referente local de belleza ultra exclusiva, reconocido por su nivel de servicio, selección rigurosa y consistencia impecable.
|
||||
|
||||
---
|
||||
|
||||
## 6. Misión
|
||||
|
||||
Operar un concepto de salón de ultra lujo con **una sola sucursal por ciudad**, ajustada al tamaño del mercado, para preservar exclusividad, estándar y coherencia de experiencia.
|
||||
|
||||
Anchor:23 no escala por volumen. Escala por selección.
|
||||
|
||||
---
|
||||
|
||||
## 7. Valores
|
||||
|
||||
* Exclusividad — El acceso es limitado por diseño.
|
||||
* Excelencia — El estándar es alto y sostenido.
|
||||
* Selección — Clientes y equipo cumplen criterios claros.
|
||||
* Sobriedad — El lujo se expresa con medida.
|
||||
* Consistencia — La experiencia es siempre la misma.
|
||||
|
||||
---
|
||||
|
||||
## 8. Personalidad de Marca
|
||||
|
||||
* Sobria
|
||||
* Precisa
|
||||
* Selectiva
|
||||
* Elegante
|
||||
* Reservada
|
||||
|
||||
Anchor:23 no busca agradar a todos.
|
||||
|
||||
---
|
||||
|
||||
## 9. Arquetipo
|
||||
|
||||
**El Curador**
|
||||
|
||||
Selecciona, eleva estándares y protege la experiencia.
|
||||
|
||||
---
|
||||
|
||||
## 10. Voz y Tono
|
||||
|
||||
### Voz
|
||||
|
||||
* Clara
|
||||
* Breve
|
||||
* Profesional
|
||||
|
||||
### Tono
|
||||
|
||||
* Seguro
|
||||
* Reservado
|
||||
* Elegante
|
||||
|
||||
Sin adornos. Sin exageraciones.
|
||||
|
||||
---
|
||||
|
||||
## 11. Identidad Visual
|
||||
|
||||
### Principios
|
||||
|
||||
* Geometría clara
|
||||
* Centro de gravedad estable
|
||||
* Amplio espacio negativo
|
||||
* Composición silenciosa
|
||||
|
||||
Nunca gestual. Nunca decorativa.
|
||||
|
||||
---
|
||||
|
||||
## 12. Paleta de Color (GitHub Compatible)
|
||||
|
||||
| Swatch | Nombre | Hex |
|
||||
| ------------------------------------------------------------ | -------------- | --------- |
|
||||
|  | Bone White | `#F6F1EC` |
|
||||
|  | Soft Cream | `#EFE7DE` |
|
||||
|  | Mocha Taupe | `#B8A89A` |
|
||||
|  | Deep Earth | `#6F5E4F` |
|
||||
|  | Charcoal Brown | `#3F362E` |
|
||||
|
||||
Uso contenido. Sin saturación. Sin gradientes.
|
||||
|
||||
---
|
||||
|
||||
## 13. Tipografía
|
||||
|
||||
### Headings
|
||||
|
||||
Serif editorial sobria.
|
||||
|
||||
### Texto y UI
|
||||
|
||||
Sans neutral.
|
||||
|
||||
Mucho aire. Jerarquía estricta.
|
||||
|
||||
---
|
||||
|
||||
## 14. Experiencia de Marca
|
||||
|
||||
Anchor:23 se vive como:
|
||||
|
||||
* Acceso limitado
|
||||
* Atención altamente profesional
|
||||
* Protocolos definidos
|
||||
* Ambiente sobrio y refinado
|
||||
|
||||
La experiencia no se negocia.
|
||||
|
||||
---
|
||||
|
||||
## 15. Presencia Digital
|
||||
|
||||
### anchor23.mx
|
||||
|
||||
Sitio institucional. Marca, narrativa y conversión inicial.
|
||||
|
||||
### booking.anchor23.mx
|
||||
|
||||
Sistema de reservas (The Boutique).
|
||||
|
||||
### kiosk.anchor23.mx
|
||||
|
||||
Sistema táctil en sucursal (The Kiosk).
|
||||
|
||||
---
|
||||
|
||||
## 16. Principio Rector
|
||||
|
||||
La exclusividad no se declara.
|
||||
|
||||
Se demuestra en cada detalle.
|
||||
|
||||
---
|
||||
|
||||
## 17. Links de Prueba
|
||||
|
||||
### Frontend Institucional (anchor23.mx)
|
||||
- https://anchoros.soul23.cloud/ - Landing page con hero, fundamento, servicios y testimoniales.
|
||||
- https://anchoros.soul23.cloud/servicios - Página de servicios con descripciones.
|
||||
- https://anchoros.soul23.cloud/historia - Historia y filosofía de la marca.
|
||||
- https://anchoros.soul23.cloud/contacto - Formulario de contacto.
|
||||
- https://anchoros.soul23.cloud/franchises - Información de franquicias.
|
||||
- https://anchoros.soul23.cloud/membresias - Membresías (Gold, Black, VIP).
|
||||
|
||||
### The Boutique (booking.anchor23.mx)
|
||||
- https://anchoros.soul23.cloud/booking/servicios - Selección de servicios y calendario de disponibilidad.
|
||||
- https://anchoros.soul23.cloud/booking/cita - Flujo de reserva en pasos (búsqueda cliente, confirmación, pago).
|
||||
- https://anchoros.soul23.cloud/booking/confirmacion - Confirmación de reserva por código.
|
||||
- https://anchoros.soul23.cloud/booking/registro - Registro de nuevos clientes.
|
||||
- https://anchoros.soul23.cloud/booking/login - Login con magic links.
|
||||
- https://anchoros.soul23.cloud/booking/perfil - Perfil de cliente con historial.
|
||||
- https://anchoros.soul23.cloud/booking/mis-citas - Gestión de citas del cliente.
|
||||
|
||||
### The HQ (aperture.anchor23.mx)
|
||||
- https://anchoros.soul23.cloud/aperture - Dashboard home con KPIs, top performers y feed de actividad.
|
||||
- https://anchoros.soul23.cloud/aperture/calendar - Calendario maestro con drag & drop y filtros.
|
||||
- https://anchoros.soul23.cloud/aperture/staff - Gestión de staff (CRUD, comisiones, nómina).
|
||||
- https://anchoros.soul23.cloud/aperture/clients - CRM de clientes con fidelización.
|
||||
- https://anchoros.soul23.cloud/aperture/pos - Punto de venta y cierre de caja.
|
||||
- https://anchoros.soul23.cloud/aperture/finance - Finanzas y reportes.
|
||||
|
||||
### The Kiosk (kiosk.anchor23.mx)
|
||||
- https://anchoros.soul23.cloud/kiosk/[locationId] - Sistema táctil para confirmación de citas y walk-ins.
|
||||
|
||||
### Página Centralizada de Test Links
|
||||
- https://anchoros.soul23.cloud/testlinks - Directorio completo de todas las páginas y APIs del proyecto.
|
||||
|
||||
---
|
||||
|
||||
Fin del manual de marca Anchor:23.
|
||||
203
PRD.md
203
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,4 +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. 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] 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)
|
||||
|
||||
|
||||
Reference in New Issue
Block a user