flowchart LR
    classDef visitante fill:#dbeafe,stroke:#2563eb,color:#1e3a8a
    classDef sistema fill:#e0e7ff,stroke:#4f46e5,color:#312e81
    classDef datos fill:#fef3c7,stroke:#d97706,color:#78350f
    classDef externo fill:#f1f5f9,stroke:#64748b,color:#334155

    subgraph NAV["Navegador"]
        UI["Páginas y demos en React"]:::visitante
        LS["localStorage y cookies: sesión, idioma, consentimiento y datos de las demos"]:::visitante
    end

    subgraph VERCEL["Vercel: web Next.js 14"]
        MW["Middleware: /admin, /dashboard, /liquidacion y /demo/slug"]:::sistema
        SSR["Render en el servidor: App Router, metadatos SEO, sitemap"]:::sistema
        NAPI["Rutas API de Next: /api/linkedin-ads/generate y proxies /api/chatbot"]:::sistema
        PUB["Archivos públicos: robots.txt, widget.js, llms.txt, manifest"]:::sistema
    end

    subgraph RAILWAY["Railway: API Express"]
        API["Rutas /api: auth, demos, contacto, chatbot, demo-rag, admin y más"]:::sistema
        JOB["Job de accesos a demos: cada hora"]:::sistema
        MEM["Memoria: documentos de Prueba con tu documento, 1 hora"]:::sistema
        DISK["Disco efímero: estado del chatbot y archivos subidos"]:::sistema
    end

    subgraph DATOS["Datos"]
        DB[("MongoDB")]:::datos
        RD[("Redis")]:::datos
    end

    subgraph EXT["Servicios externos de la API"]
        OAI["OpenAI"]:::externo
        SMTP["Correo: Resend (SMTP solo de respaldo)"]:::externo
        WA["WhatsApp: Cloud API de Meta, plantilla koptup_aviso"]:::externo
        ANT["Anthropic: solo reglas de /liquidacion"]:::externo
        S3["AWS S3: solo /api/documents"]:::externo
        GOO["Google OAuth: opcional"]:::externo
    end

    TAGS["Google tag y LinkedIn Insight: solo con consentimiento"]:::externo
    GH["GitHub: código, CI y wiki"]:::externo

    UI --> SSR
    UI --> MW
    UI --> NAPI
    UI -->|"fetch o axios con Bearer"| API
    UI -.-> TAGS
    MW -->|"verifica sesión y acceso"| API
    NAPI --> API
    API --- MEM
    API --- DISK
    API --> DATOS
    JOB --> DATOS
    API --> EXT
    JOB -->|"recordatorios"| SMTP
    GH -->|"despliegue desde main"| VERCEL
    GH -->|"despliegue desde main"| RAILWAY

sequenceDiagram
    autonumber
    actor V as Visitante
    participant N as Navegador
    participant W as Vercel Next.js
    participant A as API Railway
    participant D as MongoDB
    participant T as Google tag o LinkedIn

    V->>N: Abre www.koptup.com/rag
    N->>W: GET /rag con la cookie locale
    Note over W: La ruta no está en el matcher del middleware, no se verifica sesión
    W->>W: El layout raíz lee la cookie locale (es por defecto) y carga los mensajes
    W-->>N: HTML con título, descripción, canonical y JSON-LD
    N->>N: React hidrata la página y muestra el aviso de cookies si no hay elección
    N->>A: GET /api/demo-catalog
    A->>D: Lee el catálogo editable de las 28 demos
    A-->>N: slug, nombre, modo de acceso y si está activa
    N->>N: Ajusta las etiquetas Abierta, Requiere acceso o Solo por invitación
    opt Solo si el visitante aceptó analítica o marketing
        N->>T: Carga la etiqueta correspondiente
    end

sequenceDiagram
    autonumber
    actor P as Prospecto
    participant N as Navegador
    participant M as Middleware Next
    participant A as API Railway
    participant D as MongoDB

    P->>N: Abre /demo/erp
    N->>M: GET /demo/erp con las cookies accessToken y refreshToken
    M->>M: Comprueba que erp es una demo conocida
    alt Su copia del catálogo tiene más de 60 s
        M->>A: GET /api/demo-catalog
        A-->>M: Modo de acceso y estado de cada demo
    end
    Note over M: Modo publico y activa: deja pasar sin más consultas
    M->>A: GET /api/demo-access/erp con Authorization Bearer
    alt El token de 15 min venció (401)
        M->>A: POST /api/auth/refresh con el refreshToken
        A-->>M: accessToken nuevo
        M->>A: Repite GET /api/demo-access/erp
    end
    A->>D: Rol vigente, catálogo y DemoGrant de la persona
    A->>D: Si hay acceso vigente, registra la visita (accesos y último ingreso)
    alt Acceso vigente o rol del equipo
        A-->>M: allowed true, reason grant o staff, vencimiento
        M-->>N: La demo, con no-store y noindex, y la cookie renovada si hizo falta
    else Sin acceso, vencido, retirado o sin sesión
        A-->>M: allowed false y el motivo
        M-->>N: Reescribe a /demo-acceso/erp con el motivo (la URL no cambia)
    else La API no responde
        M-->>N: Pantalla de acceso con motivo no_disponible
    end
    opt Si la demo usa una API protegida (cuentas médicas, sistema experto, gestor de contenido, LinkedIn Ads)
        N->>A: Llamada a su API con Bearer
        A->>A: requireStaffOrDemoAccess vuelve a decidir en cada petición
    end

sequenceDiagram
    autonumber
    actor V as Visitante
    participant N as Navegador en /contact
    participant A as API Railway
    participant D as MongoDB
    participant W as WhatsApp de Meta
    participant S as Correo por Resend

    V->>N: Llena nombre, email, servicio y mensaje (teléfono, empresa y presupuesto opcionales)
    N->>A: POST /api/contact
    A->>A: Cupo estricto de 5 envíos por minuto por IP y validación de campos
    A->>D: Guarda un Contact con origen contact-form, estado new y los avisos pendientes
    A-->>N: success true
    N-->>V: Mensaje de confirmación
    par Avisos al dueño, sin bloquear la respuesta
        A->>W: Plantilla koptup_aviso al número del dueño, si está configurado
    and
        A->>S: Correo al dueño con Responder a la persona, si está configurado
    end
    A->>D: Guarda el resultado de cada canal en notificaciones
    Note over D: El equipo lo ve en Admin, sección Contactos

sequenceDiagram
    autonumber
    actor V as Visitante
    participant N as Navegador en /demo/chatbot
    participant A as API Railway
    participant R as Redis
    participant O as OpenAI
    participant F as MongoDB

    V->>N: Elige una empresa de ejemplo
    alt Primera vez o el bot ya no existe
        N->>A: POST /api/chatbot/bots y POST /api/chatbot/bots/id/docs
        A->>F: Guarda el bot, sus documentos y sus fragmentos
    end
    V->>N: Escribe una pregunta
    N->>A: POST /api/chatbot/bots/id/chat con el mensaje, el historial y el modelo
    A->>A: Busca los 5 fragmentos más parecidos (BM25)
    A->>R: Consulta el gasto del mes (chatbot:spend)
    alt Hay clave de OpenAI y queda presupuesto
        A->>O: Chat Completions con las reglas de citado y los fragmentos
        O-->>A: Respuesta y tokens usados
        A->>R: Suma el costo al gasto del mes
    else Sin clave, sin presupuesto o error del proveedor
        A->>A: Modo extractivo: devuelve los fragmentos citados tal cual
    end
    A->>F: Guarda la conversación (últimos 200 turnos por bot)
    A-->>N: Respuesta, fuentes, confianza, latencia, modelo y tokens
    N-->>V: Respuesta con citas numeradas y panel de fuentes

sequenceDiagram
    autonumber
    actor V as Visitante
    participant N as Navegador
    participant A as API Railway
    participant R as Redis
    participant M as Memoria del backend
    participant D as MongoDB
    participant O as OpenAI

    N->>A: GET /api/demo-rag/status
    A->>R: Redis listo y gasto del mes (demo-rag:spend)
    A-->>N: Habilitada o no, y los límites
    alt Apagada, sin Redis, sin clave o sin presupuesto
        N-->>V: Muestra Agenda una demo con nosotros
    end
    V->>N: Elige un PDF, DOCX o TXT, escribe su email y autoriza el tratamiento de datos
    N->>A: POST /api/demo-rag/documents (archivo, email y consentimiento)
    A->>A: Máximo 10 intentos por IP cada 10 min, formato y 5 MB, todo en memoria
    A->>R: Reserva 1 de los 3 documentos del día para esa IP
    A->>M: Extrae el texto (máx. 30 páginas), lo parte en fragmentos y arma el índice BM25
    A->>D: Registra el lead en Contact con origen demo-rag (y avisa al equipo)
    A-->>N: 201 con el id del documento, páginas y vencimiento en 1 hora
    loop Hasta 10 preguntas por documento
        V->>N: Escribe una pregunta
        N->>A: POST /api/demo-rag/documents/id/questions
        A->>R: Verifica de nuevo el presupuesto del mes
        A->>M: Recupera los 5 fragmentos más parecidos
        A->>O: gpt-4o-mini con las reglas de citado
        A->>R: Suma el gasto del mes
        A-->>N: Respuesta con citas por página o fragmento y preguntas restantes
    end
    Note over M: A la hora, o al pulsar borrar, el documento se elimina de la memoria

flowchart LR
    classDef archivo fill:#fef3c7,stroke:#d97706,color:#78350f
    classDef sistema fill:#e0e7ff,stroke:#4f46e5,color:#312e81
    classDef visitante fill:#dbeafe,stroke:#2563eb,color:#1e3a8a

    BASE["messages/es.json y en.json: menú, páginas, panel, portal"]:::archivo
    DEMOS["messages/demos: 56 archivos, uno por demo e idioma"]:::archivo
    OFF["messages/offerings: 64 archivos, ofertas y páginas RAG"]:::archivo
    MERGE["scripts/merge-messages.mjs: corre en predev, prebuild y pretest"]:::sistema
    AGG["_demos.es/en.json y _offerings.es/en.json"]:::archivo
    LAYOUT["Layout raíz: lee la cookie locale y une los tres grupos"]:::sistema
    REQ["i18n/request.ts: lo mismo para componentes de servidor y metadatos"]:::sistema
    CLIENT["NextIntlClientProvider: useTranslations en componentes de cliente"]:::sistema
    BTN["Botón ES / EN del menú: cambia la cookie y recarga"]:::visitante

    DEMOS --> MERGE
    OFF --> MERGE
    MERGE --> AGG
    BASE --> LAYOUT
    AGG --> LAYOUT
    BASE --> REQ
    AGG --> REQ
    LAYOUT --> CLIENT
    BTN --> LAYOUT

flowchart TD
    classDef sistema fill:#e0e7ff,stroke:#4f46e5,color:#312e81
    classDef decision fill:#fff,stroke:#64748b,color:#334155
    classDef error fill:#fee2e2,stroke:#dc2626,color:#7f1d1d

    A["1. Valida las variables de entorno con zod"]:::sistema
    B{"¿Producción y falta MONGODB_URI o JWT_SECRET?"}:::decision
    X["No arranca"]:::error
    C["2. Crea las carpetas de uploads"]:::sistema
    D["3. Conecta MongoDB (si falla, sigue y /health responde 503)"]:::sistema
    E["4. ADMIN_EMAIL: rol admin solo si no hay ningún otro admin"]:::sistema
    F["5. Siembra las demos que falten en el catálogo (no pisa cambios del panel)"]:::sistema
    G["6. Inicializa Google OAuth si está configurado"]:::sistema
    H["7. Monta la app Express y abre el puerto"]:::sistema
    J["8. Programa los jobs: accesos a demos, conservación<br/>y reintentos y prueba mensual de los avisos"]:::sistema

    A --> B
    B -->|"Sí"| X
    B -->|"No"| C --> D --> E --> F --> G --> H --> J