mirror of
https://github.com/marcogll/AnchorOS.git
synced 2026-03-15 11:24:26 +00:00
feat: Implement FASE 5 (Clients & Loyalty) and FASE 6 (Payments & Financial)
FASE 5 - Clientes y Fidelización: - Client Management (CRM) con búsqueda fonética - Galería de fotos restringida por tier (VIP/Black/Gold) - Sistema de Lealtad con puntos y expiración (6 meses) - Membresías (Gold, Black, VIP) con beneficios configurables - Notas técnicas con timestamp APIs Implementadas: - GET/POST /api/aperture/clients - CRUD completo de clientes - GET /api/aperture/clients/[id] - Detalles con historial de reservas - POST /api/aperture/clients/[id]/notes - Notas técnicas - GET/POST /api/aperture/clients/[id]/photos - Galería de fotos - GET /api/aperture/loyalty - Resumen de lealtad - GET/POST /api/aperture/loyalty/[customerId] - Historial y puntos FASE 6 - Pagos y Protección: - Stripe Webhooks (payment_intent.succeeded, payment_failed, charge.refunded) - No-Show Logic con detección automática (ventana 12h) - Check-in de clientes para prevenir no-shows - Override Admin para waivar penalizaciones - Finanzas y Reportes (expenses, daily closing, staff performance) APIs Implementadas: - POST /api/webhooks/stripe - Handler de webhooks Stripe - GET /api/cron/detect-no-shows - Detectar no-shows (cron job) - POST /api/aperture/bookings/no-show - Aplicar penalización - POST /api/aperture/bookings/check-in - Registrar check-in - GET /api/aperture/finance - Resumen financiero - POST/GET /api/aperture/finance/daily-closing - Reportes diarios - GET/POST /api/aperture/finance/expenses - Gestión de gastos - GET /api/aperture/finance/staff-performance - Performance de staff Documentación: - docs/APERATURE_SPECS.md - Especificaciones técnicas completas - docs/APERTURE_SQUARE_UI.md - Ejemplos de Radix UI con Square UI - docs/API.md - Actualizado con nuevas rutas Migraciones SQL: - 20260118050000_clients_loyalty_system.sql - Clientes, fotos, lealtad, membresías - 20260118060000_stripe_webhooks_noshow_logic.sql - Webhooks, no-shows, check-ins - 20260118070000_financial_reporting_expenses.sql - Gastos, reportes financieros
This commit is contained in:
29
docs/API.md
29
docs/API.md
@@ -69,6 +69,14 @@ AnchorOS is a comprehensive salon management system built with Next.js, Supabase
|
||||
- `GET /api/aperture/reports/payments` - Payment reports
|
||||
- `GET /api/aperture/reports/payroll` - Payroll reports
|
||||
|
||||
#### POS (Point of Sale)
|
||||
- `POST /api/aperture/pos` - Create sale transaction (cart, payments, receipt)
|
||||
- `POST /api/aperture/pos/close-day` - Close day and generate daily report with PDF
|
||||
|
||||
#### Payroll
|
||||
- `GET /api/aperture/payroll` - Calculate payroll for staff (base salary + commission + tips)
|
||||
- `GET /api/aperture/payroll/[staffId]` - Get payroll details for specific staff
|
||||
|
||||
#### Permissions
|
||||
- `GET /api/aperture/permissions` - Get role permissions
|
||||
- `POST /api/aperture/permissions` - Update permissions
|
||||
@@ -81,13 +89,32 @@ AnchorOS is a comprehensive salon management system built with Next.js, Supabase
|
||||
- `PUT /api/kiosk/bookings/[shortId]/confirm` - Confirm booking
|
||||
|
||||
### Payment APIs
|
||||
- `POST /api/create-payment-intent` - Create Stripe payment intent
|
||||
- `POST /api/create-payment-intent` - Create Stripe payment intent for booking deposit
|
||||
- `POST /api/webhooks/stripe` - Stripe webhook handler (payment_intent.succeeded, payment_intent.payment_failed, charge.refunded)
|
||||
|
||||
### Admin APIs
|
||||
- `GET /api/admin/locations` - List locations (Admin key required)
|
||||
- `POST /api/admin/users` - Create staff/user
|
||||
- `POST /api/admin/kiosks` - Create kiosk
|
||||
|
||||
### Cron Jobs
|
||||
- `GET /api/cron/reset-invitations` - Reset weekly invitation quotas for Gold tier (Monday 00:00 UTC)
|
||||
- `GET /api/cron/detect-no-shows` - Detect and mark no-show bookings (every 2 hours)
|
||||
|
||||
### Client Management (FASE 5 - Pending Implementation)
|
||||
- `GET /api/aperture/clients` - List and search clients (phonetic search, history, technical notes)
|
||||
- `POST /api/aperture/clients` - Create new client
|
||||
- `GET /api/aperture/clients/[id]` - Get client details
|
||||
- `PUT /api/aperture/clients/[id]` - Update client information
|
||||
- `POST /api/aperture/clients/[id]/notes` - Add technical note to client
|
||||
- `GET /api/aperture/clients/[id]/photos` - Get client photo gallery (VIP/Black/Gold only)
|
||||
|
||||
### Loyalty System (FASE 5 - Pending Implementation)
|
||||
- `GET /api/aperture/loyalty` - Get loyalty points and rewards
|
||||
- `POST /api/aperture/loyalty/redeem` - Redeem loyalty points
|
||||
- `GET /api/aperture/loyalty/[customerId]` - Get customer loyalty history
|
||||
- `POST /api/aperture/loyalty/[customerId]/points` - Add/remove loyalty points
|
||||
|
||||
## Data Models
|
||||
|
||||
### User Roles
|
||||
|
||||
Reference in New Issue
Block a user