docs: Update Aperture plan and design system documentation

- Update TASKS.md with complete Aperture implementation plan (7 phases)
  - Define critical, high, medium, and low priority tasks
  - Add timeline estimates: ~136-171 hours total (~17-21 business days)
  - Add sprint structure (6 sprints)

- Create APERTURE_SQUARE_UI.md: Complete Square UI style guide
  - Color palette, typography, borders, shadows
  - Layout patterns, component states
  - Accessibility guidelines
  - Responsive adaptations

- Create DESIGN_SYSTEM.md: Comprehensive design system for AnchorOS
  - Resolve color inconsistency between site_requirements.md and globals.css
  - Document both systems (anchor23.mx and Aperture)
  - Component documentation checklist
  - Implementation guidelines

- Update API.md with undocumented implemented routes:
  - GET /api/availability/blocks
  - GET /api/public/availability
  - POST /api/availability/staff
  - POST /api/kiosk/walkin
  - PATCH /api/bookings/[id]

- Update README.md with current project state:
  - Fase 1-3: 100% completed
  - Fase 4: 0% completed (redefined with full specifications)
  - Add missing feature details (POS, multiple cashiers, etc.)

Based on technical specifications received, Aperture now includes:
- Dashboard Home (KPI cards, performance charts, top performers, activity feed)
- Master Calendar (drag & drop, resize blocks, dynamic filters, visual indicators)
- Team & Payroll (staff CRUD, commissions, payroll calculation, shift management)
- Clients & Loyalty (CRM, VIP gallery, memberships, points system)
- Sales, Payments & Invoicing (POS, daily cash close, finance)
- Marketing & Configuration (campaigns, dynamic pricing, integration placeholders)

Tech stack: Radix UI + Tailwind CSS + Square UI custom styling
This commit is contained in:
Marco Gallegos
2026-01-17 10:16:28 -06:00
parent 393efa73c2
commit a160a93d8c
5 changed files with 1299 additions and 55 deletions

View File

@@ -240,17 +240,8 @@ El sitio estará disponible en **http://localhost:2311**
- ✅ Sistema de disponibilidad (staff, recursos, bloques)
- ✅ API routes de disponibilidad
- ✅ API de reservas para clientes (POST/GET)
- ✅ HQ Dashboard (Aperture) con gestión de staff y recursos
-Reportes de ventas, pagos y nómina
- ✅ Gestión de permisos por roles
- ✅ Integración con Stripe para pagos y depósitos
- ✅ Autenticación completa (clientes con magic links, staff/admin)
- ✅ The Boutique - Frontend de reservas completo
- Página de selección de servicios (/booking/servicios)
- Página de confirmación de reserva (/booking/cita)
- API para obtener servicios (/api/services)
- API para obtener ubicaciones (/api/locations)
- Configuración de dominios wildcard en producción
- ✅ HQ Dashboard básico (Aperture) - EXISTE pero incompleto
-API routes básicos para Aperture (dashboard, staff, resources, reports, permissions)
- ✅ Frontend institucional anchor23.mx completo
- Landing page con hero, fundamento, servicios, testimoniales
- Página de servicios
@@ -262,15 +253,46 @@ El sitio estará disponible en **http://localhost:2311**
- Header y footer globales
### En Progreso 🚧
- 🚧 The Boutique - Frontend de reservas (booking.anchor23.mx) - 90%
- ✅ Página de selección de servicios (/booking/servicios)
- ✅ Página de búsqueda de clientes (/booking/cita - paso 1)
- ✅ Página de registro de clientes (/booking/registro)
- ✅ Página de confirmación de reserva (/booking/cita - pasos 2-3)
- ✅ Página de confirmación por código (/booking/confirmacion)
- ✅ Layout específico con navbar personalizado
- ✅ API para obtener servicios (/api/services)
- ✅ API para obtener ubicaciones (/api/locations)
- ✅ API para buscar clientes (/api/customers - GET)
- ✅ API para registrar clientes (/api/customers - POST)
- ✅ Sistema de horarios de negocio por ubicación
- ✅ Componente de pagos mock para pruebas
- ⏳ Configuración de dominios wildcard en producción
- ⏳ Integración con Stripe real (webhooks)
- 🚧 Aperture - Backend para staff/manager/admin (aperture.anchor23.mx) - 40%
- ✅ API para obtener staff disponible (/api/aperture/staff)
- ✅ API para gestión de horarios (/api/aperture/staff/schedule)
- ✅ API para recursos (/api/aperture/resources)
- ✅ API para dashboard (/api/aperture/dashboard)
- ✅ Página principal de admin (/aperture)
- ❌ API para estadísticas (/api/aperture/stats) - FALTA IMPLEMENTAR
- ❌ Reseteo semanal de invitaciones (documentado, NO implementado)
- ⏳ Autenticación de admin/staff/manager (login existe, needs Supabase Auth)
- ⏳ Gestión completa de staff (CRUD, horarios)
- ⏳ Gestión de recursos y asignación
- ⏳ Rediseño con estilo Square UI
- 🚧 Lógica de no-show y penalizaciones automáticas
- 🚧 Integración con Google Calendar
- 🚧 Integración con Google Calendar (20% - en progreso)
### Pendiente ⏳
- ⏳ Implementar API pública (api.anchor23.mx)
- ⏳ Completar Aperture con estilo Square UI (calendario multi-columna, páginas individuales, The Vault)
- ⏳ Notificaciones por WhatsApp
- ⏳ Recibos digitales por email
- ⏳ Landing page para believers (booking público)
- ⏳ The Vault (storage de fotos privadas)
- ⏳ Tests unitarios
- ⏳ Archivos SEO (robots.txt, sitemap.xml)
### Fase Actual
**Fase 1 — Cimientos y CRM**: 100% completado
@@ -295,6 +317,18 @@ El sitio estará disponible en **http://localhost:2311**
- Stripe depósitos dinámicos: 100%
- No-show logic: 40% (lógica implementada, automatización pendiente)
**Fase 4 — HQ Dashboard**: 10% completado
- Aperture dashboard básico: 100% (existe pero incompleto)
- Autenticación staff/admin: 40% (página login existe, needs Supabase Auth integration)
- Calendario Multi-Columna: 0% (pendiente)
- Gestión Operativa: 20% (APIs existentes, UI incompleta)
- The Vault: 0% (pendiente)
**Fase 5 — Automatización y Lanzamiento**: 5% completado
- Notificaciones WhatsApp: 0% (variables configuradas, no implementado)
- Recibos digitales: 0% (pendiente)
- Landing page Believers: 0% (pendiente)
**Advertencia:** No apto para producción. Migraciones y seeds en evolución.
---