Files
SKEEN-Proyecto/docs/ROADMAP_SKEEN_MEJORA.md
Consultoría Alcaraz Salazar a718592291 Initial commit: SKEEN Derma Experts - Sistema Integral de Gestión Clínica
- Frontend React (SKEEN Brand) con Vite, TypeScript, Tailwind
- Frontend Homenest (versión alternativa)
- Módulos Odoo 17 custom (citas, pacientes, monedero, pagos, ventas, inventario, whatsapp)
- WACRM fork (Next.js 16 + Supabase)
- Hermes + Bridge + Skills (Qwen3.6 via Nan Builders)
- Scripts de migración y operación
- Documentación extensiva en docs/
2026-07-20 07:44:23 +00:00

7.6 KiB

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.