================================================================================
                    FLUJO DE FUNCIONAMIENTO - SISTEMA CONDUSEF
                              Aser Sofom - Integración Completa
================================================================================

FECHA: 09 de Enero 2026
VERSIÓN: 1.0 - Sistema Completo
DESARROLLADO POR: Ing. José Tenatic Medina Piaña

================================================================================
                                FLUJO PRINCIPAL
================================================================================

                            ┌─────────────────┐
                            │   USUARIO       │
                            │   ACCEDE        │
                            └─────────┬───────┘
                                      │
                                      ↓
                            ┌─────────────────┐
                            │   LOGIN         │
                            │   SISTEMA       │
                            └─────────┬───────┘
                                      │
                                      ↓
                            ┌─────────────────┐
                            │   DASHBOARD     │
                            │   PRINCIPAL     │
                            └─────┬───────────┘
                                  │
                    ┌─────────────┼─────────────┐
                    │             │             │
                    ↓             ↓             ↓
            ┌───────────┐  ┌─────────────┐  ┌──────────┐
            │  REDECO   │  │    REUNE    │  │ PERFIL   │
            │  SISTEMA  │  │   SISTEMA   │  │ USUARIO  │
            └─────┬─────┘  └──────┬──────┘  └────┬─────┘
                  │               │              │
                  ↓               ↓              ↓
        ┌─────────────────┐ ┌─────────────┐ ┌─────────────┐
        │ GESTIÓN QUEJAS  │ │ MULTI-SECTOR│ │ CONFIGURAR  │
        │ DESPACHOS       │ │ FINANCIERO  │ │ ELIMINAR    │
        └─────────────────┘ └─────────────┘ └─────────────┘

================================================================================
                            FLUJO DETALLADO - REDECO
================================================================================

    INICIO REDECO
         │
         ↓
    ┌─────────────┐
    │ VERIFICAR   │ ──→ ❌ Sin Token ──→ ┌─────────────┐
    │ TOKEN       │                      │ GENERAR     │
    └─────┬───────┘                      │ TOKEN       │
          │                              └──────┬──────┘
          ↓ ✅ Token Válido                     │
    ┌─────────────┐                            │
    │ MENÚ        │ ←──────────────────────────┘
    │ PRINCIPAL   │
    └─────┬───────┘
          │
    ┌─────┼─────┬─────────┬─────────┐
    │     │     │         │         │
    ↓     ↓     ↓         ↓         ↓
┌────────┐ ┌────────┐ ┌────────┐ ┌────────┐
│GENERAR │ │LEVANTAR│ │CONSULTAR│ │VER     │
│TOKEN   │ │QUEJA   │ │QUEJAS   │ │HISTORIAL│
└────┬───┘ └───┬────┘ └───┬────┘ └───┬────┘
     │         │          │          │
     ↓         ↓          ↓          ↓
┌────────┐ ┌────────┐ ┌────────┐ ┌────────┐
│API     │ │FORMULARIO│ │BUSCAR  │ │MOSTRAR │
│CONDUSEF│ │COMPLETO │ │REGISTROS│ │LOGS    │
└────┬───┘ └───┬────┘ └───┬────┘ └───┬────┘
     │         │          │          │
     ↓         ↓          ↓          ↓
┌────────┐ ┌────────┐ ┌────────┐ ┌────────┐
│GUARDAR │ │ENVIAR  │ │MOSTRAR │ │EXPORTAR│
│SESIÓN  │ │A API   │ │LISTA   │ │DATOS   │
└────────┘ └────────┘ └────────┘ └────────┘

================================================================================
                            FLUJO DETALLADO - REUNE
================================================================================

    INICIO REUNE
         │
         ↓
    ┌─────────────┐
    │ SELECCIONAR │
    │ SECTOR      │ ──→ General / Seguros / SIC
    └─────┬───────┘
          │
          ↓
    ┌─────────────┐
    │ VERIFICAR   │ ──→ ❌ Sin Token ──→ ┌─────────────┐
    │ TOKEN       │                      │ GENERAR     │
    └─────┬───────┘                      │ TOKEN       │
          │                              └──────┬──────┘
          ↓ ✅ Token Válido                     │
    ┌─────────────┐                            │
    │ MENÚ        │ ←──────────────────────────┘
    │ OPCIONES    │
    └─────┬───────┘
          │
    ┌─────┼─────┬─────────┬─────────┬─────────┐
    │     │     │         │         │         │
    ↓     ↓     ↓         ↓         ↓         ↓
┌────────┐ ┌────────┐ ┌────────┐ ┌────────┐ ┌────────┐
│GENERAR │ │NUEVA   │ │LEVANTAR│ │BUSCAR  │ │CONSULTAR│
│TOKEN   │ │CONSULTA│ │QUEJA   │ │TOKEN   │ │REGISTROS│
└────┬───┘ └───┬────┘ └───┬────┘ └───┬────┘ └───┬────┘
     │         │          │          │          │
     ↓         ↓          ↓          ↓          ↓
┌────────┐ ┌────────┐ ┌────────┐ ┌────────┐ ┌────────┐
│API     │ │FORMULARIO│ │FORMULARIO│ │BUSCAR  │ │OBTENER │
│CONDUSEF│ │SECTOR   │ │COMPLETO │ │FOLIO   │ │LISTA   │
└────┬───┘ └───┬────┘ └───┬────┘ └───┬────┘ └───┬────┘
     │         │          │          │          │
     ↓         ↓          ↓          ↓          ↓
┌────────┐ ┌────────┐ ┌────────┐ ┌────────┐ ┌────────┐
│GUARDAR │ │ENVIAR  │ │ENVIAR  │ │MOSTRAR │ │PAGINAR │
│SESIÓN  │ │PAYLOAD │ │QUEJA   │ │RESULTADO│ │RESULTADOS│
└────────┘ └────────┘ └────────┘ └────────┘ └────────┘

================================================================================
                        FLUJO DE VALIDACIÓN CONDUSEF
================================================================================

                    ┌─────────────────┐
                    │ VENTANA CONDUSEF│
                    │ (10 DÍAS HÁBILES)│
                    └─────────┬───────┘
                              │
                    ┌─────────┼─────────┐
                    │         │         │
                    ↓         ↓         ↓
            ┌───────────┐ ┌───────────┐ ┌───────────┐
            │ DÍA 1-10  │ │ DÍA 11+   │ │ NUEVO MES │
            │ HÁBILES   │ │ HÁBILES   │ │ REINICIA  │
            └─────┬─────┘ └─────┬─────┘ └─────┬─────┘
                  │             │             │
                  ↓             ↓             ↓
            ┌───────────┐ ┌───────────┐ ┌───────────┐
            │ ✅ QUEJAS │ │ ❌ QUEJAS │ │ ✅ NUEVA  │
            │ PERMITIDAS│ │ BLOQUEADAS│ │ VENTANA   │
            └───────────┘ └───────────┘ └───────────┘
                  │             │             │
                  ↓             ↓             ↓
            ┌───────────┐ ┌───────────┐ ┌───────────┐
            │ PROCESAR  │ │ MOSTRAR   │ │ HABILITAR │
            │ NORMAL    │ │ "NO       │ │ FUNCIONES │
            │           │ │ DISPONIBLE"│ │           │
            └───────────┘ └───────────┘ └───────────┘

================================================================================
                            FLUJO DE AUTENTICACIÓN
================================================================================

    USUARIO INGRESA
         │
         ↓
    ┌─────────────┐
    │ CREDENCIALES│
    │ LARAVEL     │
    └─────┬───────┘
          │
          ↓
    ┌─────────────┐      ❌ Inválidas
    │ VALIDAR     │ ─────────────────→ ┌─────────────┐
    │ LOGIN       │                    │ ERROR       │
    └─────┬───────┘                    │ MENSAJE     │
          │                            └─────────────┘
          ↓ ✅ Válidas
    ┌─────────────┐
    │ CREAR       │
    │ SESIÓN      │
    └─────┬───────┘
          │
          ↓
    ┌─────────────┐
    │ DASHBOARD   │
    │ PRINCIPAL   │
    └─────┬───────┘
          │
          ↓
    ┌─────────────┐
    │ VERIFICAR   │
    │ TOKENS      │ ──→ Redeco Token ──→ ✅/❌
    │ CONDUSEF    │ ──→ Reune Token  ──→ ✅/❌
    └─────────────┘

================================================================================
                        FLUJO DE ELIMINACIÓN DE CUENTA
================================================================================

    USUARIO SOLICITA ELIMINAR
             │
             ↓
    ┌─────────────────┐
    │ MOSTRAR MODAL   │
    │ CONFIRMACIÓN    │
    └─────────┬───────┘
              │
              ↓
    ┌─────────────────┐
    │ SOLICITAR       │
    │ CONTRASEÑA      │ ──→ Su Contraseña
    │ USUARIO         │
    └─────────┬───────┘
              │
              ↓
    ┌─────────────────┐
    │ SOLICITAR       │
    │ CONTRASEÑA      │ ──→ 2026Aserconducef14#1@
    │ ADMINISTRADOR   │
    └─────────┬───────┘
              │
    ┌─────────┼─────────┐
    │         │         │
    ↓         ↓         ↓
┌─────────┐ ┌─────────┐ ┌─────────┐
│ VALIDAR │ │ VALIDAR │ │ AMBAS   │
│ USUARIO │ │ ADMIN   │ │ VÁLIDAS │
└────┬────┘ └────┬────┘ └────┬────┘
     │           │           │
     ↓ ❌        ↓ ❌        ↓ ✅
┌─────────┐ ┌─────────┐ ┌─────────┐
│ ERROR   │ │ ERROR   │ │ ELIMINAR│
│ USUARIO │ │ ADMIN   │ │ CUENTA  │
└─────────┘ └─────────┘ └────┬────┘
                             │
                             ↓
                    ┌─────────────┐
                    │ LOG         │
                    │ AUDITORÍA   │
                    └─────┬───────┘
                          │
                          ↓
                    ┌─────────────┐
                    │ LOGOUT      │
                    │ REDIRECT    │
                    └─────────────┘

================================================================================
                            FLUJO DE DATOS - API
================================================================================

    FORMULARIO USUARIO
           │
           ↓
    ┌─────────────┐
    │ VALIDACIÓN  │
    │ CLIENTE     │ ──→ JavaScript Real-time
    └─────┬───────┘
          │
          ↓
    ┌─────────────┐
    │ ENVÍO       │
    │ SERVIDOR    │
    └─────┬───────┘
          │
          ↓
    ┌─────────────┐
    │ VALIDACIÓN  │
    │ SERVIDOR    │ ──→ Laravel Validator
    └─────┬───────┘
          │
          ↓
    ┌─────────────┐
    │ PAYLOAD     │
    │ BUILDER     │ ──→ Formato CONDUSEF
    └─────┬───────┘
          │
          ↓
    ┌─────────────┐
    │ HTTP CLIENT │
    │ LARAVEL     │ ──→ API CONDUSEF
    └─────┬───────┘
          │
    ┌─────┼─────┐
    │     │     │
    ↓     ↓     ↓
┌────────┐ ┌────────┐ ┌────────┐
│ 200 OK │ │ 400    │ │ 500    │
│ ÉXITO  │ │ ERROR  │ │ ERROR  │
└───┬────┘ └───┬────┘ └───┬────┘
    │          │          │
    ↓          ↓          ↓
┌────────┐ ┌────────┐ ┌────────┐
│MOSTRAR │ │MOSTRAR │ │MOSTRAR │
│ÉXITO   │ │ERROR   │ │ERROR   │
│USUARIO │ │USUARIO │ │TÉCNICO │
└────────┘ └────────┘ └────────┘

================================================================================
                            ESTADOS DEL SISTEMA
================================================================================

                    ┌─────────────────┐
                    │ ESTADO GLOBAL   │
                    │ DEL SISTEMA     │
                    └─────────┬───────┘
                              │
                    ┌─────────┼─────────┐
                    │         │         │
                    ↓         ↓         ↓
            ┌───────────┐ ┌───────────┐ ┌───────────┐
            │ REDECO    │ │ REUNE     │ │ USUARIO   │
            │ TOKEN     │ │ TOKEN     │ │ SESIÓN    │
            └─────┬─────┘ └─────┬─────┘ └─────┬─────┘
                  │             │             │
            ┌─────┼─────┐ ┌─────┼─────┐ ┌─────┼─────┐
            │     │     │ │     │     │ │     │     │
            ↓     ↓     ↓ ↓     ↓     ↓ ↓     ↓     ↓
        ┌───────┐ ┌───────┐ ┌───────┐ ┌───────┐ ┌───────┐
        │ ACTIVO│ │EXPIRADO│ │ ACTIVO│ │EXPIRADO│ │ ACTIVO│
        └───┬───┘ └───┬───┘ └───┬───┘ └───┬───┘ └───┬───┘
            │         │         │         │         │
            ↓         ↓         ↓         ↓         ↓
        ┌───────┐ ┌───────┐ ┌───────┐ ┌───────┐ ┌───────┐
        │ ✅    │ │ ❌    │ │ ✅    │ │ ❌    │ │ ✅    │
        │FUNCIONA│ │RENOVAR│ │FUNCIONA│ │RENOVAR│ │ACCESO │
        └───────┘ └───────┘ └───────┘ └───────┘ └───────┘

================================================================================
                            FLUJO DE MONITOREO
================================================================================

    FOOTER SISTEMA
         │
         ↓
    ┌─────────────┐
    │ CALCULAR    │
    │ VENTANA     │ ──→ Primeros 10 días hábiles
    │ CONDUSEF    │
    └─────┬───────┘
          │
    ┌─────┼─────┐
    │     │     │
    ↓     ↓     ↓
┌────────┐ ┌────────┐ ┌────────┐
│ DENTRO │ │ FUERA  │ │ NUEVO  │
│VENTANA │ │VENTANA │ │ MES    │
└───┬────┘ └───┬────┘ └───┬────┘
    │          │          │
    ↓          ↓          ↓
┌────────┐ ┌────────┐ ┌────────┐
│ 🟢     │ │ 🔴     │ │ 🟢     │
│SERVICIO│ │ NO     │ │REINICIAR│
│ACTIVO  │ │DISPONIBLE│ │VENTANA │
└────────┘ └────────┘ └────────┘

================================================================================
                            RESUMEN DE COMPONENTES
================================================================================

FRONTEND (VISTAS):
├── Dashboard Principal ──→ Estadísticas + Navegación
├── Redeco Sistema ──────→ Tokens + Quejas + Consultas
├── Reune Sistema ───────→ Multi-sector + Tokens + Quejas
├── Footer Inteligente ──→ Estado + Soporte + Navegación
└── Perfil Usuario ─────→ Configuración + Eliminación Segura

BACKEND (LÓGICA):
├── Controllers ─────────→ Redeco + Reune + Profile
├── Services ───────────→ Token + HTTP Client + Payload
├── Helpers ────────────→ Utilidades + Validaciones
├── Middleware ─────────→ Autenticación + Autorización
└── Config ─────────────→ APIs + Endpoints + Credenciales

SEGURIDAD:
├── Autenticación ──────→ Laravel Breeze
├── Tokens CONDUSEF ────→ Gestión Automática
├── Validaciones ──────→ Cliente + Servidor
├── Logs Auditoría ────→ Operaciones Críticas
└── Eliminación Segura ─→ Doble Contraseña

INTEGRACIÓN:
├── API Redeco ─────────→ Quejas Despachos Cobranza
├── API Reune ──────────→ Multi-sector Financiero
├── Validación CONDUSEF ─→ Ventana 10 días hábiles
└── Monitoreo Tiempo Real → Estado Sistema

================================================================================
                            PRÓXIMOS PASOS
================================================================================

PARA USAR EL SISTEMA:

1. CONFIGURAR CREDENCIALES ──→ Obtener de CONDUSEF
   │
   ↓
2. ACTUALIZAR .ENV ─────────→ Variables de entorno
   │
   ↓
3. EJECUTAR MIGRACIONES ────→ php artisan migrate
   │
   ↓
4. PROBAR CONECTIVIDAD ─────→ Generar tokens
   │
   ↓
5. VALIDAR FUNCIONES ───────→ Enviar quejas de prueba
   │
   ↓
6. PRODUCCIÓN ──────────────→ Sistema listo

CONTACTO SOPORTE:
📧 tenaticmedina@gmail.com
📞 554680258
👨‍💼 Ing. José Tenatic Medina Piaña

================================================================================
                                    FIN
================================================================================