# Roadmap de Mejora — SKEEN Derma Experts
## Unificación: Odoo 17 + WACRM + Frontend React + Hermes

**Fecha:** 6 de julio de 2026  
**Base del análisis:** Sistema actual https://sistema.skeenmx.app/ (Laravel + AdminLTE)

---

## Objetivo general

Replicar y mejorar toda la funcionalidad del sistema actual de SKEEN en una nueva arquitectura unificada:

- **Odoo 17** como ERP/ backend maestro (pacientes, expedientes, citas, ventas, pagos, inventarios, contabilidad).
- **WACRM** como CRM WhatsApp + shared inbox + automatizaciones.
- **Hermes** como agente IA (Sofía) para atención automática, agendamiento, pagos, recordatorios.
- **Frontend React 19 + Tailwind CSS** como interfaz moderna, replicando la identidad visual y los flujos del sistema actual.

---

## Fases del roadmap

### FASE 0: Fundamentos y migración de datos (1 semana)

| # | Tarea | Entregable |
|---|-------|------------|
| 0.1 | Exportar datos maestros del sistema Laravel | CSV/Excel de pacientes, servicios, productos, médicos, usuarios, citas, ventas, adeudos, monederos |
| 0.2 | Definir mapeo de datos Laravel → Odoo | Documento de migración |
| 0.3 | Cargar pacientes en Odoo (`res.partner`) | Pacientes en Odoo con teléfono, email, etiquetas, médico principal |
| 0.4 | Cargar servicios y productos | `skeen.servicio` + `product.template` |
| 0.5 | Cargar médicos, cosmetólogos y usuarios | `hr.employee` / `res.users` |
| 0.6 | Cargar saldos de monedero | `skeen.monedero` |
| 0.7 | Cargar adeudos históricos | `account.move` en estado posted |

---

### FASE 1: Frontend fiel al sistema actual (2 semanas)

| # | Tarea | Entregable |
|---|-------|------------|
| 1.1 | Crear tema "SKEEN Classic" en el frontend | Layout con sidebar + header superior + contenido central, colores `#1abc9c`, `#BED4AD`, `#34495e` |
| 1.2 | Implementar login con logo SKEEN | Pantalla de login estilo sistema actual |
| 1.3 | Replicar menú de navegación completo | Sidebar con grupos: principal, configuración, reportes, administrativo, monedero, comunicación, consumibles, CRM, ventas |
| 1.4 | Dashboard / Movimientos diarios | Totales por forma de pago, tabla de ventas del día, filtros por médico/sucursal |
| 1.5 | Agenda | Calendario/semana con citas, filtros, estados, acciones |
| 1.6 | Expedientes | Lista con filtros VIP/visitas, ficha del paciente |
| 1.7 | Catálogos (servicios, productos, diagnósticos, procedimientos, recetas, etiquetas) | CRUD completo |
| 1.8 | Médicos, cosmetólogos, usuarios | Directorio con roles y permisos |
| 1.9 | Inventarios | Productos + consumibles con niveles de stock |
| 1.10 | Monedero | Configuración de % y reporte de puntos |
| 1.11 | Reportes administrativos | Adeudos, pagos, visitas, devoluciones, comisiones, concentrado, top clientes, paquetes |
| 1.12 | Cortes de caja | Histórico diario, establecer corte |
| 1.13 | Tipo de cambio | Pantalla de configuración USD/MXN |
| 1.14 | Comunicación / Cumpleañeros | Lista de pacientes cumpleañeros |

---

### FASE 2: Conexión Odoo ↔ Frontend (1 semana)

| # | Tarea | Entregable |
| 2.1 | Extender controladores Odoo (`skeen_whatsapp/controllers/frontend.py`) | Endpoints REST para todas las secciones |
| 2.2 | Crear servicios en React (`services/skeenApi.ts`) | Cliente tipado para todos los endpoints |
| 2.3 | Conectar dashboard con datos reales | Stats y ventas del día desde Odoo |
| 2.4 | Conectar agenda, expedientes, catálogos | CRUD funcional end-to-end |
| 2.5 | Autenticación frontend ↔ Odoo | Login validado contra Odoo o token JWT |
| 2.6 | Manejo de permisos por rol | Ocultar/mostrar secciones según rol |

---

### FASE 3: WhatsApp + WACRM + Hermes (2 semanas)

| # | Tarea | Entregable |
|---|-------|------------|
| 3.1 | Conectar número de WhatsApp Business de SKEEN en WACRM | WACRM enviando/recibiendo mensajes reales |
| 3.2 | Configurar automatizaciones en WACRM | Nuevo mensaje → webhook → Hermes bridge |
| 3.3 | Entrenar a Sofía con el catálogo real | Skill `skeen-rag` con servicios/precios de SKEEN |
| 3.4 | Skill de agendamiento con Odoo | `skeen-agendar` consulta disponibilidad y crea citas |
| 3.5 | Skill de pagos | `skeen-pagos` genera links Stripe/MP |
| 3.6 | Skill de monedero | `skeen-monedero` consulta saldo y redime puntos |
| 3.7 | Skill de recordatorios | `skeen-recordatorios` vía cron cada 30 min |
| 3.8 | Templates de Meta aprobados | Bienvenida, confirmación cita, recordatorio, follow-up, re-engage |
| 3.9 | WACRM inbox para equipo SKEEN | Recepcionistas y médicos con acceso |
| 3.10 | Handoff a humano | Trigger "AGENTE"/"HUMANO" en WhatsApp |

---

### FASE 4: Reportes, analytics y mejoras UX (1 semana)

| # | Tarea | Entregable |
| 4.1 | Dashboards interactivos con Recharts | Ingresos, visitas, top servicios, conversiones |
| 4.2 | Meta de ventas en header | Progress bar igual al sistema actual |
| 4.3 | Filtros avanzados en tablas | DataTables-like con búsqueda, ordenamiento, exportación |
| 4.4 | Exportar a Excel/PDF | Botones de exportación en reportes |
| 4.5 | Chat interno | Mensajería entre usuarios (opcional, puede usarse WACRM) |
| 4.6 | Notas internas en pacientes | Igual al sistema actual |
| 4.7 | Modales rápidos | Valoración Express, cancelar venta, devolución, paquete terminado |

---

### FASE 5: Migración final, testing y go-live (1 semana)

| # | Tarea | Entregable |
| 5.1 | Migración completa de datos históricos | Odoo con datos reales de SKEEN |
| 5.2 | Testing de todos los flujos | Documento de pruebas firmado |
| 5.3 | Capacitación del equipo | Sesiones con recepción, médicos, administración |
| 5.4 | Configurar dominios y SSL | `crm.skeen.mx`, `erp.skeen.mx`, `app.skeen.mx` |
| 5.5 | Monitoreo y backups | Uptime Kuma + dumps diarios |
| 5.6 | Go-live gradual | Soft launch + soporte presencial/remoto |

---

## Arquitectura objetivo

```
Paciente → WhatsApp → Meta Cloud API → WACRM
                                          ↓ (webhook)
                                       Hermes Bridge
                                          ↓
                                  Hermes Gateway (Sofía)
                                          ↓
                              Odoo 17 (ERP maestro)
                              ↗         ↖
                    Frontend React    Supabase Auth/Storage
```

---

## Stack tecnológico final

| Capa | Tecnología |
|------|-----------|
| Backend ERP | Odoo 17 Community + módulos custom |
| CRM WhatsApp | WACRM (fork propio) |
| Agente IA | Hermes / Nan builders API |
| Frontend | React 19 + TypeScript + Tailwind CSS + Vite |
| Base de datos | PostgreSQL (Odoo) + Supabase PostgreSQL (WACRM) |
| Auth | Supabase Auth para WACRM; Odoo para backend |
| Charts | Recharts |
| Tablas | TanStack Table |
| Deploy | Docker Compose + Nginx + Let's Encrypt |

---

## Priorización MVP

Para el go-live mínimo viable, se deben tener listas estas 5 áreas:

1. **Pacientes + Expedientes** (Odoo + Frontend)
2. **Agenda + Citas** (Odoo + Frontend + recordatorios por WhatsApp)
3. **Ventas + Pagos + Monedero** (Odoo + Frontend + Hermes)
4. **WhatsApp con Sofía** (WACRM + Hermes)
5. **Dashboard de ingresos y cortes de caja**

Las demás secciones (consumibles, reportes avanzados, CRM pipelines, comisiones) pueden activarse en iteraciones posteriores.

---

## Métricas de éxito

- Todos los usuarios del sistema actual pueden realizar sus tareas diarias en el nuevo sistema.
- Reducción de no-shows ≥ 30% gracias a recordatorios automáticos.
- Tiempo de atención a prospectos por WhatsApp reducido con Sofía 24/7.
- Datos históricos accesibles y consultables en Odoo.
- Cero dependencia del sistema Laravel legacy para operaciones diarias.

---

*Roadmap basado en el análisis de https://sistema.skeenmx.app/ sin realizar modificaciones.*