Duletia Ops — Master Hub & AI Observability

Duletia Ops Master

Gateway Online (n8n & Postgres)
M
Master Admin
LEADS ATENDIDOS POR IA
--
Kommo / WhatsApp / Web
CALIFICADOS POR DULETIA
--
Intención Detectada
ATRIBUCIÓN A LÍDERES
--
Red y Patrocinio
CONVERTIDOS A COMPRA
--
$0.00 en PostgreSQL
1. Contacto IA 0
2. Calificado 0
3. Asignado 0
4. Operación 0
5. Ganado / Socio 0
SQL Query Studio & Explorador de Tablas
Consulta datos de forma visual o escribe SQL con límite de seguridad (Solo Lectura / SELECT).
Consultas Rápidas:
Columnas a Mostrar:
SELECT * FROM cliente LIMIT 50;
Listo para ejecutar consulta.
ColumnaTipoDescripción
Selecciona una tabla y haz clic en Ejecutar Consulta para visualizar los datos.
Bóveda de Respaldos Modular & Selector Inteligente
Genera y descarga copias de seguridad de tablas específicas, módulos completos o centros de apoyo en Excel (.xlsx) o JSON.
1. Socios, Red & Líderes
2. Ventas & Facturación
3. Centros de Apoyo
4. Inventarios & Producción
5. Finanzas & Costos
6. IA & Auditoría Master
10 Tablas Seleccionadas para Respaldo
El paquete se procesará directamente desde PostgreSQL de forma cifrada.
Historial de Backups en esta Sesión
Nombre del ArchivoTipo / FormatoTablasFechaDescargar
Genera un respaldo arriba para verlo en la lista y volver a descargarlo.
Eventos IA Registrados
--
Últimas 24h
Errores de Nodos
--
Detectados en flujos
Tasa de Éxito de Flujos
--
Automatización n8n
Monitor de Interacciones IA y Errores de Nodos
Canal Contacto Intención Mensaje / Detalle Estado Tiempo (ms) Fecha
Cargando eventos de observabilidad...
Bitácora Forense de Accesos y Acciones Master
ID Usuario Master Acción Ejecutada Detalle Payload IP Pública Navegador / Dispositivo Fecha / Hora
Cargando bitácora de auditoría...
Contenido

📘 Manual de Usuario Definitivo & Enciclopedia Operativa — Dulet Back Office & Duletia Ops

Versión: 5.0 (Manual Maestro Completo — Todos los Módulos)

Fecha de Publicación: Septiembre 2026

Audiencia: Administradores Master, Dirección General, Administradores, Operadores de Centros de Apoyo (CEDIS), Contabilidad, Almacén, Producción, Líderes y Socios Empresarios

Ecosistema: Dulet International Group (México) & Dulet Group LLC (USA)

Clasificación: Confidencial — Guía Oficial de Operación del Sistema

📑 Directorio General de Zonas y Módulos

  1. [Arquitectura del Sistema & Matriz de Seguridad de 7 Roles](#1-arquitectura-del-sistema--matriz-de-seguridad-de-7-roles)
  2. [Módulo 1: Dashboard Master — Panorama General](#2-módulo-1-dashboard-master--panorama-general)
  3. [Módulo 2: Mi Visión Empresario — Dashboard del Socio](#3-módulo-2-mi-visión-empresario--dashboard-del-socio)
  4. [Módulo 3: Mi Perfil y Seguridad](#4-módulo-3-mi-perfil-y-seguridad)
  5. [Módulo 4: Directorio de Líderes y Socios](#5-módulo-4-directorio-de-líderes-y-socios)
  6. [Módulo 5: Árbol de Red & Genealogía Dinámica](#6-módulo-5-árbol-de-red--genealogía-dinámica)
  7. [Módulo 6: Radiografía 360° & Análisis de Líder](#7-módulo-6-radiografía-360--análisis-de-líder)
  8. [Módulo 7: Módulo de Rescate y Alertas de Seguimiento](#8-módulo-7-módulo-de-rescate-y-alertas-de-seguimiento)
  9. [Módulo 8: Ventas, Caja y Registro de Pedidos](#9-módulo-8-ventas-caja-y-registro-de-pedidos)
  10. [Módulo 9: Calificaciones Mensuales y Pagos Adquiridos](#10-módulo-9-calificaciones-mensuales-y-pagos-adquiridos)
  11. [Módulo 10: Catálogo Maestro de Productos y Precios](#11-módulo-10-catálogo-maestro-de-productos-y-precios)
  12. [Módulo 11: Inventario General de Producto Terminado](#12-módulo-11-inventario-general-de-producto-terminado)
  13. [Módulo 12: Reportes de Movimientos y Kárdex](#13-módulo-12-reportes-de-movimientos-y-kárdex)
  14. [Módulo 13: Red de Centros de Apoyo Físicos (CEDIS 1 al 15)](#14-módulo-13-red-de-centros-de-apoyo-físicos-cedis-1-al-15)
  15. [Módulo 14: Centro Especial Virtual "Por Asignar" (#230) & Cola Multi-Caja](#15-módulo-14-centro-especial-virtual-por-asignar-230--cola-multi-caja)
  16. [Módulo 15: Facturación SAT CFDI 4.0 & Facturama](#16-módulo-15-facturación-sat-cfdi-40--facturama)
  17. [Módulo 16: Asistente de Sustitución en 2 Pasos & Cancelación Fiscal](#17-módulo-16-asistente-de-sustitución-en-2-pasos--cancelación-fiscal)
  18. [Módulo 17: Control de Activos & Monedero FIFO](#18-módulo-17-control-de-activos--monedero-fifo)
  19. [Módulo 18: Producción Industrial & Fabricación de Lotes](#19-módulo-18-producción-industrial--fabricación-de-lotes)
  20. [Módulo 19: Materias Primas, Insumos y Empaque](#20-módulo-19-materias-primas-insumos-y-empaque)
  21. [Módulo 20: Estructura de Costos Industriales & Rendimientos](#21-módulo-20-estructura-de-costos-industriales--rendimientos)
  22. [Módulo 21: Directorio de Proveedores](#22-módulo-21-directorio-de-proveedores)
  23. [Módulo 22: Módulo Intercompañía (México - USA)](#23-módulo-22-módulo-intercompañía-méxico---usa)
  24. [Módulo 23: Facturación y Pedidos USA (Dulet Group LLC)](#24-módulo-23-facturación-y-pedidos-usa-dulet-group-llc)
  25. [Módulo 24: Conciliador Bancario Automatizado 9-en-1](#25-módulo-24-conciliador-bancario-automatizado-9-en-1)
  26. [Módulo 25: Academia Dulet & Cuadernos de Trabajo (1 al 4)](#26-módulo-25-academia-dulet--cuadernos-de-trabajo-1-al-4)
  27. [Módulo 26: Academia Admin & Seguimiento Formativo](#27-módulo-26-academia-admin--seguimiento-formativo)
  28. [Módulo 27: Auditoría de Premios & Galardones LED](#28-módulo-27-auditoría-de-premios--galardones-led)
  29. [Módulo 28: Acelerador de Metas Empresariales](#29-módulo-28-acelerador-de-metas-empresariales)
  30. [Módulo 29: Centro de Notificaciones, Noticias y Calendario](#30-módulo-29-centro-de-notificaciones-noticias-y-calendario)
  31. [Módulo 30: Bitácora de Auditoría del Sistema & Seguridad](#31-módulo-30-bitácora-de-auditoría-del-sistema--seguridad)
  32. [Módulo 31: Configuración Global del Sistema](#32-módulo-31-configuración-global-del-sistema)
  33. [Portal Duletia Master Ops (/pages/ops)](#33-portal-duletia-master-ops-pagesops)
  34. [Compendio de Preguntas Frecuentes & Solución de Casos Extremos](#34-compendio-de-preguntas-frecuentes--solución-de-casos-extremos)

1. Arquitectura del Sistema & Matriz de Seguridad de 7 Roles

El ecosistema de Duletia opera como una Single Page Application (SPA) modular de alto rendimiento conectada a una base de datos centralizada PostgreSQL y orquestada por flujos de n8n.

Matriz de Seguridad y Privilegios por Rol

Módulo / Zona Master Admin Operativo Almacén Contabilidad Empresario Prospecto
Dashboard Master ✅ ✅ — — — — —
Mi Visión Empresario — — — — — ✅ ✅
Líderes & Árbol de Red ✅ ✅ — — — ✅ (Red Propia) —
Análisis de Líder ✅ ✅ — — — ✅ (Personal) —
Módulo de Rescate ✅ ✅ — — — — —
Ventas & Pedidos ✅ ✅ ✅ — ✅ ✅ (Compras) —
CEDIS 1 al 15 ✅ ✅ ✅ — ✅ — —
Cola de Activaciones (#230) ✅ ✅ ✅ — — — —
Facturación SAT CFDI 4.0 ✅ ✅ — — ✅ ✅ (Descarga) —
Monedero de Activos FIFO ✅ ✅ — — ✅ ✅ (Saldo) —
Inventario & Kárdex ✅ ✅ ✅ ✅ ✅ — —
Producción Industrial ✅ ✅ — ✅ — — —
Materias Primas & Costos ✅ ✅ — ✅ ✅ — —
Conciliador Bancario 9-en-1 ✅ ✅ — — ✅ — —
Intercompañía & USA ✅ ✅ — — ✅ — —
Academia & Premios LED ✅ ✅ — — — ✅ ✅
Bitácora & Configuración ✅ — — — — — —
Portal Master Ops (/pages/ops) ✅ ✅ — — — — —

2. Módulo 1: Dashboard Master — Panorama General

Ruta en Menú: #view-dashboard

Roles Autorizados: Master, Admin.

Propósito: Proporcionar la radiografía macroeconómica y operativa de toda la empresa en tiempo real para cualquier período fiscal.

📊 Componentes y KPIs

  • Ventas Totales del Período: Suma monetaria de todas las notas de venta con approved = 1.
  • Cajas Pendientes en Cola (#230): Inventario de cajas pagadas en tránsito sin asignar a líder final.
  • Activos en Circulación: Monto total acumulado en las billeteras de los socios pendiente de consumo.
  • Saldo Deudor CEDIS: Capital total de producto entregado en consignación a los 15 Centros de Apoyo.
  • Gráfica de Ingresos Diarios: Tendencia de facturación día a día del mes seleccionado.
  • Top 10 Centros de Apoyo: Ranking de CEDIS por volumen de desplazamiento.
  • Top 10 Líderes Productores: Ranking de líderes por volumen personal y grupal de red.

🔘 Fichas de Botones y Modales

  • Selector de Período (Mes/Año): Recalcula dinámicamente todos los KPIs y tablas en memoria.
  • ↻ Actualizar: Invalida la caché local y vuelve a consultar la base de datos PostgreSQL.
  • 📥 Exportar Resumen (CSV): Descarga un archivo con el desglose contable del mes.

3. Módulo 2: Mi Visión Empresario — Dashboard del Socio

Ruta en Menú: #view-dashboard-lider

Roles Autorizados: Empresario, Prospecto.

Propósito: Panel personalizado para que cada socio distribuidor supervise su negocio, comisiones, avance de rango y calificación.

📊 Componentes y Métricas

  • Semáforo de Calificación: 🟢 Calificado (Compró $\ge 1$ caja este mes) / 🔴 Inactivo (Sin calificación mensual).
  • Billetera de Activos: Saldo disponible para pagar compras futuras o solicitar liquidación.
  • Rango LED Actual: Distintivo del rango alcanzado (Bronce, Plata, Oro, Zafiro, Esmeralda, Rubí, Diamante, etc.).
  • Termómetro de Progreso de Rango: Muestra las cajas que faltan en el mes para subir al siguiente nivel.
  • Volumen Personal: Cajas compradas directamente con su número de registro.
  • Volumen de Grupo (4 Niveles): Cajas producidas por su organización por nivel de profundidad.

4. Módulo 3: Mi Perfil y Seguridad

Ruta en Menú: #view-mi-perfil

Roles Autorizados: Todos los usuarios autenticados.

Propósito: Administración de información personal, datos de contacto, domicilio de envío y credenciales.

🔘 Fichas de Botones

  • 💾 Guardar Cambios: Actualiza teléfono, WhatsApp, correo electrónico y dirección en la tabla cliente.
  • 🔑 Cambiar Contraseña: Solicita contraseña actual y nueva contraseña, cifrándola mediante bcrypt.
  • 📄 Ver Constancia Fiscal: Permite al socio verificar su RFC, Razón Social y Régimen Fiscal registrado para facturación.

5. Módulo 4: Directorio de Líderes y Socios

Ruta en Menú: #view-lideres

Roles Autorizados: Master, Admin, Empresario (solo descendencia).

Propósito: Base de datos centralizada de distribuidores, prospectos y clientes con herramientas de prospección y gestión.

🔘 Fichas de Botones y Modales

  • ➕ Nuevo Socio: Abre el modal de alta de distribuidores:
  • Solicita: Nombre, Apellidos, Registro, Teléfono, Email, Patrocinador y Dirección.
  • Valida que el número de registro no esté duplicado en PostgreSQL.
  • Buscador en Tiempo Real: Filtra por Registro (ej. 80000), Nombre, Teléfono o Estado.
  • 👁️ Ver Detalle / Radiografía: Abre el perfil 360° del líder seleccionado.
  • ✏️ Editar Socio: Permite actualizar datos fiscales (RFC, CP, Régimen) y datos de contacto.
  • ⚡ Acreditar Bono Manual: Modal para inyectar activos al socio con captura de concepto y folio de soporte.
  • 🌳 Ver en Árbol: Salta directamente a la vista de genealogía centrada en ese socio.

6. Módulo 5: Árbol de Red & Genealogía Dinámica

Ruta en Menú: #view-arbol

Roles Autorizados: Master, Admin, Empresario (solo su propia red).

Propósito: Visualizador gráfico interactivo de la estructura multinivel de patrocinio.

🎮 Controles y Navegación

  • Navegación Interactiva: Arrastrar para mover el lienzo, rueda del ratón para zoom (+ / -).
  • Código Visual de Nodos:
  • 🟢 Verde: Socio calificado en el mes actual ($\ge 1$ caja).
  • 🟡 Amarillo: Nuevo distribuidor inscrito en los últimos 30 días.
  • 🔴 Rojo: Socio inactivo (sin compra este mes).
  • Clic en Nodo:
  • Despliega la tarjeta flotante con: Total de frontales, Cajas en N1, N2, N3, N4, Volumen Grupal y Teléfono.
  • Botón Expandir Hijos / Colapsar Línea.

7. Módulo 6: Radiografía 360° & Análisis de Líder

Ruta en Menú: #view-analisis-lider

Roles Autorizados: Master, Admin.

Propósito: Diagnóstico profundo del rendimiento de un socio en particular para sesiones de coaching empresarial.

📊 Datos Analizados

  • Historial de Calificación (12 Meses): Registro mes a mes de cumplimiento de compras.
  • Balance de Piernas (Frontales Fuertes vs Débiles): Detecta qué líneas de la red aportan el mayor volumen y cuáles requieren soporte.
  • Cumplimiento de Galardones LED: Auditoría de requisitos de frontales calificados y volumen de puntos para el próximo pin.

8. Módulo 7: Módulo de Rescate y Alertas de Seguimiento

Ruta en Menú: #view-rescate

Roles Autorizados: Master, Admin.

Propósito: Algoritmo predictivo de retención que identifica líderes con riesgo de inactividad antes del cierre de mes.

🔘 Fichas de Botones

  • Filtro de Días Restantes de Mes: Muestra quiénes calificaron los meses anteriores pero aún no compran este mes.
  • 📲 Enviar WhatsApp de Rescate: Abre WhatsApp Web con mensaje personalizado indicando las comisiones que perdería si no califica su caja.

9. Módulo 8: Ventas, Caja y Registro de Pedidos

Ruta en Menú: #view-ventas

Roles Autorizados: Master, Admin, Operativo, Contabilidad.

Propósito: Punto de venta, registro de notas de compra, validación de pagos y control de pedidos.

🔘 Fichas de Botones y Modales

  • ➕ Registrar Nueva Venta: Abre el modal de captura de nota de venta:
  • Selección de Cliente / Socio (o Público en General).
  • Selección de CEDIS / Almacén de despacho.
  • Partidas: Dulet (Natural, Chocolate, Fresa, Vainilla) y Eucament con cálculo de precio unitario automático.
  • Método de Pago Mixto: Permite capturar monto en Efectivo/Transferencia y monto deducido de Monedero de Activos.
  • Subida de comprobante de pago bancario (JPG/PNG/PDF).
  • ✓ Aprobar Venta (approved=1): Valida el ingreso bancario, genera el volumen en red, acredita comisiones y descuenta inventario.
  • 🚫 Cancelar Venta: Revierte el volumen, regresa el inventario y reintegra los activos consumidos.
  • 🧾 Solicitar Factura: Envía la nota a la cola de timbrado fiscal.

10. Módulo 9: Calificaciones Mensuales y Pagos Adquiridos

Ruta en Menú: Integrado en #view-ventas y #view-centros-apoyo.

Propósito: Gestión de las calificaciones de 1 caja requeridas para el cobro del plan Evolution Link.

⚙️ Reglas Operativas

  • Toda compra de 1 caja de Dulet por un socio registrado genera una calificación automática.
  • Las compras pagadas por depósito bancario con concepto "Por Asignar" se transfieren a la Cola de Activaciones (#230) para su asignación manual.

11. Módulo 10: Catálogo Maestro de Productos y Precios

Ruta en Menú: #view-productos

Roles Autorizados: Master, Admin.

Propósito: Definición de SKUs, precios de lista por país (MXN/USD), puntos comisionables y costos base.

🔘 Fichas de Botones

  • ➕ Nuevo Producto: Agrega un SKU al catálogo con nombre, código de barras, precio público, precio mayoreo y puntos de red.
  • ✏️ Editar Precios: Permite ajustar precios de lista por inflación o promociones.
  • Interruptor Activo/Inactivo: Habilita o deshabilita la venta del producto en el punto de venta y tienda online.

12. Módulo 11: Inventario General de Producto Terminado

Ruta en Menú: #view-inventario

Roles Autorizados: Master, Admin, Almacén, Operativo.

Propósito: Control de existencias físicas en el Almacén Central de Matriz.

🔘 Fichas de Botones y Modales

  • ➕ Entrada de Almacén: Ingresa producto terminado proveniente de la planta de producción.
  • ➖ Salida por Merma / Daño: Da de baja producto dañado con justificación.
  • 📦 Traspaso a Centro de Apoyo: Descuenta producto de Matriz y lo envía a un CEDIS en consignación.
  • 📊 Auditoría de Existencias: Formulario de conteo físico vs existencias en sistema.

13. Módulo 12: Reportes de Movimientos y Kárdex

Ruta en Menú: #view-reportes-inventario

Roles Autorizados: Master, Admin, Almacén, Contabilidad.

Propósito: Trazabilidad histórica inmutable de cada entrada, salida, venta, traspaso y devolución de producto con fecha y responsable.

14. Módulo 13: Red de Centros de Apoyo Físicos (CEDIS 1 al 15)

Ruta en Menú: #view-centros-apoyo

Roles Autorizados: Master, Admin, Contabilidad, Operativo.

Propósito: Gestión integral de los 15 Centros de Apoyo físicos en la República Mexicana.

🏢 Sub-Pestañas del Detalle de CEDIS

  1. Notas Vinculadas: Ventas despachadas por este centro.
  2. Pagos y Liquidaciones: Registro de depósitos bancarios del operador a Matriz para abonar a su saldo deudor.
  3. Activaciones: Calificaciones procesadas en este CEDIS.
  4. Inventario Local: Existencias actuales de cajas y piezas en poder del operador.
  5. Movimientos y Kárdex: Historial de traspasos recibidos y ventas entregadas.
  6. Facturación del Centro: CFDIs emitidos con el RFC del operador del CEDIS.
  7. Notas Activadas: Calificaciones derivadas de producto de este centro.
  8. Rendimiento & Comisiones: Porcentaje de utilidad del operador acumulado en el período.

🔘 Fichas de Botones en Centros de Apoyo

  • ➕ Crear Nuevo Centro: Da de alta un nuevo CEDIS asignándole nombre, operador, líder responsable, dirección y límite de crédito.
  • 📦 Traspaso de Producto: Envía mercancía desde Matriz al CEDIS.
  • 💵 Registrar Pago / Abono: Disminuye el saldo deudor del centro al recibir el depósito bancario.
  • 🔒 Bloquear Centro: Suspende temporalmente la entrega de producto a un CEDIS por mora en pagos.

15. Módulo 14: Centro Especial Virtual "Por Asignar" (#230) & Cola Multi-Caja

Ruta en Menú: #view-centros-apoyo $\rightarrow$ Botón 📦 Cola de Activaciones (#230).

Roles Autorizados: Master, Admin, Operativo.

Propósito: Administrar notas pagadas en tránsito a cuentas bancarias de la empresa y asignar sus activaciones a líderes finales.


┌─────────────────────────────────────────────────────────────────────────┐
│                    COLA DE ACTIVACIONES (#230)                          │
├─────────────────────────────────────────────────────────────────────────┤
│ [ 197 Notas en Tránsito ]   [ 200 Cajas Disponibles ]   [ 45 Asignadas] │
├─────────────────────────────────────────────────────────────────────────┤
│ Nota        Fecha      Destino Detectado     Total      Cajas   Acción  │
│ ─────────────────────────────────────────────────────────────────────── │
│ a6cff756…   30/08/26   Ruth Hernández M.    $9,500.00   0/2 🟢  [⚡Activar (2)] │
│ 4fa0b60a…   30/08/26   Martín Juárez J.    $19,000.00   0/4 🟢  [⚡Activar (4)] │
│ f5d01445…   23/08/26   Eduardo Luquín P.   $45,000.00  0/10 🟢  [⚡Activar (10)]│
└─────────────────────────────────────────────────────────────────────────┘

🔘 Fichas de Botones y Modales en Cola de Activaciones

  • ⚡ Activar (1): Abre el modal de asignación para notas de 1 sola caja.
  • ⚡ Activar (N) (Asistente Multi-Caja):
  • Genera N slots individuales de asignación (Caja 1 de N, Caja 2 de N...).
  • Cada slot cuenta con su propio buscador de líder y selector de fecha.
  • Permite asignar cajas a diferentes personas o al mismo socio en meses distintos.
  • Permite confirmación parcial (ej. asignar 2 de 4 cajas hoy y dejar 2 pendientes).
  • Botón dinámico: ⚡ Confirmar N Activaciones.
  • ✕ Cancelar Activación (En pestaña *Asignadas*):
  • Elimina la calificación calificacion-mes del líder.
  • Devuelve automáticamente 1 cupo disponible a la nota de respaldo original.

16. Módulo 15: Facturación SAT CFDI 4.0 & Facturama

Ruta en Menú: #view-facturacion

Roles Autorizados: Master, Admin, Contabilidad.

Propósito: Emisión, timbrado, consulta y descarga de comprobantes fiscales digitales por internet bajo el Anexo 20 CFDI 4.0.

📑 Pestañas del Módulo Fiscal

  1. ⏳ Facturas Pendientes: Solicitudes de clientes pendientes de timbrado con validación de RFC, Régimen, CP y Uso de CFDI.
  2. ✅ Facturas del Mes: Comprobantes timbrados exitosamente (Individuales, Globales y de Centro).
  3. 🌐 Factura Global del Mes: Agrupación automática de notas de Público en General por CEDIS y forma de pago con complemento GlobalInformation.
  4. ❌ Facturas Canceladas: Historial de cancelaciones con motivo SAT y UUID de sustitución.

🔘 Fichas de Botones

  • ⚡ Facturar: Envía el documento a Facturama y timbra ante el SAT.
  • 📄 PDF: Descarga el formato gráfico con sellos digitales y código bidimensional QR.
  • 📥 XML: Descarga el archivo XML sellado por el PAC.
  • 📋 Ver Notas: Desglosa cada nota de venta incluida en una factura global o de centro con exportación a PDF y CSV.
  • ⚡ Generar Factura Global: Timbra el CFDI 4.0 global del mes con las notas seleccionadas mediante casillas (✓).

17. Módulo 16: Asistente de Sustitución en 2 Pasos & Cancelación Fiscal

Ruta en Menú: #view-facturacion $\rightarrow$ Botones 🔄 Sustituir y ❌ Cancelar.

Propósito: Cumplir estrictamente con las reglas de cancelación del SAT evitando multas y discrepancias fiscales.


graph TD
    A["Factura Original con Error (UUID-1)"] --> B["Clic en 🔄 Sustituir"]
    B --> C["Modal: Corregir Datos Fiscales (RFC, CP, Régimen, Forma Pago)"]
    C --> D["Paso 1 SAT: Emitir Nueva Factura con Tipo de Relación 04 apuntando a UUID-1"]
    D --> E["PAC / SAT Timbra Nueva Factura (UUID-2)"]
    E --> F["Paso 2 SAT: Cancelar UUID-1 enviando Motivo 01 y Folio Sustituto UUID-2"]
    F --> G["BD Actualizada: UUID-1 pasa a Canceladas / UUID-2 queda Activa en el Mes"]

🔘 Motivos de Cancelación SAT Soportados

  • Motivo 01 (Con relación): Ejecutado automáticamente por el Asistente de Sustitución en 2 pasos.
  • Motivo 02 (Sin relación): Cancela la factura y libera automáticamente las notas de venta asociadas (factura_emitida = false) para permitir su re-facturación.
  • Motivo 03 (Operación no realizada): Anulación por cancelación de compra.
  • Motivo 04 (Operación nominativa en global): Desglose de una venta de la global a factura particular.

18. Módulo 17: Control de Activos & Monedero FIFO

Ruta en Menú: #view-activos

Roles Autorizados: Master, Admin, Contabilidad.

Propósito: Gestión del monedero electrónico de comisiones y bonos de red bajo el principio contable FIFO (First In, First Out).

🔘 Fichas de Botones y Modales

  • ➕ Acreditar Activos: Modal para abono manual a un líder (Monto MXN, Concepto, Referencia).
  • ➖ Deducir Activos: Modal para cargo o ajuste justificado.
  • 📋 Bitácora FIFO: Auditoría centavo a centavo del consumo de activos antiguos primero.
  • 📥 Exportar Saldos: Reporte en Excel de todos los monederos activos.

19. Módulo 18: Producción Industrial & Fabricación de Lotes

Ruta en Menú: #view-produccion

Roles Autorizados: Master, Admin, Almacén, Producción.

Propósito: Control de manufactura de producto terminado en planta.

🔘 Fichas de Botones y Modales

  • ➕ Nuevo Lote de Producción:
  • Selección de producto a fabricar (Dulet Natural, Sabores, Eucament).
  • Captura de Materia Prima ingresada (Kilos de suero, saborizante, aceite).
  • Asignación de Número de Lote Industrial y Fecha de Caducidad.
  • Calculadora de Rendimiento y Merma: Compara unidades teóricas vs reales producidas.
  • 🔒 Cerrar Lote: Bloquea el lote y traspasa las unidades al inventario disponible para venta.

20. Módulo 19: Materias Primas, Insumos y Empaque

Ruta en Menú: #view-materias

Roles Autorizados: Master, Admin, Almacén, Producción.

Propósito: Stock de ingredientes e insumos de empaque (Suero suizo, potes de 500g, tapas, sellos, etiquetas y cajas).

🔘 Fichas de Botones

  • ➕ Registrar Entrada de Materia Prima: Captura compras a proveedores con lote y certificado de calidad.
  • ⚠️ Alertas de Reorden: Notificación automática cuando un insumo cae por debajo del stock mínimo.

21. Módulo 20: Estructura de Costos Industriales & Rendimientos

Ruta en Menú: #view-costos

Roles Autorizados: Master, Admin, Contabilidad.

Propósito: Análisis del Costo de Ventas (COGS), costo unitario por pote y margen de contribución.

22. Módulo 21: Directorio de Proveedores

Ruta en Menú: #view-proveedores

Roles Autorizados: Master, Admin, Contabilidad.

Propósito: Padrón de proveedores de materias primas, fletes, empaque y servicios corporativos con historial de pagos.

23. Módulo 22: Módulo Intercompañía (México - USA)

Ruta en Menú: #view-intercompania

Roles Autorizados: Master, Admin, Contabilidad.

Propósito: Registro y conciliación de operaciones comerciales entre Dulet International Group (México) y Dulet Group LLC (Estados Unidos).

24. Módulo 23: Facturación y Pedidos USA (Dulet Group LLC)

Ruta en Menú: #view-facturacion-usa

Roles Autorizados: Master, Admin, Contabilidad.

Propósito: Gestión de ventas en Estados Unidos, facturación en Dólares (USD), cálculo de Sales Tax y reportes corporativos para IRS.

25. Módulo 24: Conciliador Bancario Automatizado 9-en-1

Ruta en Menú: #view-conciliacion

Roles Autorizados: Master, Admin, Contabilidad.

Propósito: Motor de inteligencia contable que cruza extractos bancarios vs notas de venta del sistema.

🏦 Fuentes Integradas

  1. BBVA Bancomer (Depósitos, Transferencias SPEI, Cie)
  2. Santander México
  3. MercadoPago México
  4. PayPal México & USA
  5. Stripe E-commerce
  6. Terminales Clip
  7. Shopify Payments
  8. Efectivo en Centros de Apoyo (CEDIS)
  9. Resumen de Conciliación y Comisiones de Pasarela

26. Módulo 25: Academia Dulet & Cuadernos de Trabajo (1 al 4)

Ruta en Menú: #view-academia

Roles Autorizados: Todos los usuarios.

Propósito: Plataforma de educación empresarial "30 Líderes en 30 Días".

  • Cuaderno 1 (/pages/cuaderno1): Mentalidad, Visión y Lista de Contactos.
  • Cuaderno 2 (/pages/cuaderno2): Presentación del Plan Evolution Link y Objeciones.
  • Cuaderno 3 (/pages/cuaderno3): Cierre, Duplicación y Frontales.
  • Cuaderno 4 (/pages/cuaderno4): Liderazgo Avanzado y Rangos LED.
  • Versiones Imprimibles: Disponibles en alta resolución para talleres presenciales.

27. Módulo 26: Academia Admin & Seguimiento Formativo

Ruta en Menú: #view-academia-admin

Roles Autorizados: Master, Admin.

Propósito: Panel para que los instructores supervisen el avance de los socios en sus cuadernos de trabajo.

28. Módulo 27: Auditoría de Premios & Galardones LED

Ruta en Menú: #view-premios

Roles Autorizados: Master, Admin.

Propósito: Control de entrega de reconocimientos: Pines LED, Bonos de Auto, Viajes Nacionales e Internacionales.

29. Módulo 28: Acelerador de Metas Empresariales

Ruta en Menú: #view-acelerador

Roles Autorizados: Master, Admin, Empresario.

Propósito: Tablero de retos mensuales y seguimiento de metas de prospección y ventas.

30. Módulo 29: Centro de Notificaciones, Noticias y Calendario

Rutas en Menú: #view-notificaciones, #view-noticias, #view-calendario.

Propósito: Comunicación oficial, avisos de promociones, fechas de corte y agenda corporativa.

31. Módulo 30: Bitácora de Auditoría del Sistema & Seguridad

Ruta en Menú: #view-bitacora

Roles Autorizados: Master.

Propósito: Registro forense inmutable de todas las acciones del sistema:

  • Inicios de sesión con IP y dispositivo.
  • Creación, edición o cancelación de ventas.
  • Movimientos de monedero de activos.
  • Emisiones y cancelaciones de CFDI.

32. Módulo 31: Configuración Global del Sistema

Ruta en Menú: #view-config

Roles Autorizados: Master.

Propósito: Parámetros de negocio, porcentajes de comisión de la red, credenciales de Facturama y llaves de integración.

33. Portal Duletia Master Ops (/pages/ops)

Ruta de Acceso: /pages/ops (Shopify) y ops.html (Cloudflare).

Roles Autorizados: Master, Admin.

Propósito: Centro de comando técnico y observabilidad con Inteligencia Artificial.


┌─────────────────────────────────────────────────────────────────────────┐
│                    DULETIA OPS — MASTER HUB (v3.2)                      │
├─────────────────────────────────────────────────────────────────────────┤
│ [🎯 Leads AI]  [🤖 Agentes]  [⚡ Observabilidad]  [💻 SQL Runner]  [📚 Docs]│
└─────────────────────────────────────────────────────────────────────────┘

🔘 Zonas del Portal Ops

  1. Lead Intelligence (#view-leads): Captura, perfilado y calificación automática de prospectos con IA.
  2. Agentes de IA (#view-agents): Estado y métricas de los chatbots y asistentes virtuales.
  3. Salud del Sistema (#view-health): Monitor en vivo de PostgreSQL, n8n y Facturama API.
  4. SQL Runner (#view-sql): Consola protegida de consultas de diagnóstico para soporte técnico.
  5. Documentación Sincronizada (#view-docs): Manual de usuario integrado en vivo.

34. Compendio de Preguntas Frecuentes & Solución de Casos Extremos

❓ P: ¿Qué ocurre si cancelo una Factura Global porque integré notas de más por error?

R: Al cancelar la global con Motivo 02, el sistema libera automáticamente todas las notas de venta asociadas en la base de datos (factura_emitida = false). Ninguna nota se bloquea. Luego vas a la pestaña *Factura Global*, desmarcas las notas que no correspondían y timbras el nuevo CFDI únicamente con las correctas.

❓ P: ¿Cómo asigno una nota que ampara 4 cajas entre 2 líderes distintos?

R: En la Cola de Activaciones (#230), haz clic en ⚡ Activar (4). Se abrirán los 4 slots: asignas Líder A en las Cajas 1 y 2, y Líder B en las Cajas 3 y 4. Al dar clic en ⚡ Confirmar 4 Activaciones, el sistema genera las calificaciones correspondientes de inmediato.

❓ P: ¿Qué pasa si asigné por error una caja a un socio que no correspondía?

R: Ve a la pestaña Asignadas en la Cola de Activaciones, busca la activación errónea y haz clic en ✕ Cancelar. El sistema eliminará la calificación y devolverá 1 cupo disponible a la nota de respaldo original.

❓ P: ¿Cómo se maneja una compra con pago mixto (efectivo + activos)?

R: En el modal de venta se capturan ambos importes. El sistema deduce los activos aplicando la regla FIFO de la billetera del socio y timbra la factura fiscal únicamente por el importe efectivamente facturable.