flowchart LR
    classDef mongo fill:#dcfce7,stroke:#16a34a,color:#14532d
    classDef redis fill:#fee2e2,stroke:#dc2626,color:#7f1d1d
    classDef mem fill:#fef3c7,stroke:#d97706,color:#78350f
    classDef api fill:#e0e7ff,stroke:#4f46e5,color:#312e81

    API["Backend (API)"]:::api

    subgraph MONGO["MongoDB: datos de negocio"]
        U["Usuarios y acceso: users, magiclinktokens, auditlogs"]:::mongo
        D["Demos: democatalogitems, demorequests, demogrants"]:::mongo
        L["Contacto y leads: contacts"]:::mongo
        B["Chatbot: chatbot_bots, chatbot_bot_chunks, chatbot_turns"]:::mongo
        P["Proyectos y facturación: projects, orders, invoices, deliverables, conversations, messages, notifications"]:::mongo
        S["Salud: facturas, atenciones, glosas, cups, radicados y catálogos"]:::mongo
        C["Gestor de documentos: documents"]:::mongo
    end

    subgraph REDIS["Redis: temporal"]
        R1["Sesiones de refresco (7 días)"]:::redis
        R2["Cupos por IP o email"]:::redis
        R3["Gasto de IA del mes"]:::redis
    end

    subgraph PROC["Memoria y disco del servidor"]
        M1["Documentos de la demo RAG (1 hora)"]:::mem
        M3["Archivos subidos (carpeta uploads)"]:::mem
    end

    API --> MONGO
    API --> REDIS
    API --> PROC

erDiagram
    USER ||--o{ MAGIC_LINK_TOKEN : "recibe"
    USER ||--o{ AUDIT_LOG : "actor"
    USER ||--o{ DEMO_GRANT : "tiene"
    USER {
        ObjectId _id PK
        string email UK "minúsculas"
        string password "hash bcrypt, solo cuentas locales"
        string name
        string role "user admin manager developer sales prospect client"
        string accountStatus "invitado o activo"
        string provider "local o google"
        string google_id UK "opcional"
        date last_login
    }
    MAGIC_LINK_TOKEN {
        ObjectId _id PK
        string tokenHash UK "SHA-256 del token"
        ObjectId user FK
        string proposito "activacion, reset u oauth"
        date expiresAt "72 h o 1 h"
        date usedAt "null si no se ha usado"
        bool invalidado "true si lo reemplazó otro"
    }
    AUDIT_LOG {
        ObjectId _id PK
        ObjectId actor FK "null si no aplica"
        string actorEmail
        string accion "demo_request.approve, user.activate y otras"
        string entidad_tipo "DemoRequest, DemoGrant, User, DemoCatalogItem"
        string entidad_id
        mixed detalle
        string ipHash "IP en hash"
    }
    DEMO_GRANT {
        ObjectId _id PK
        ObjectId user FK
        string demoSlug
        string estado
        date expiresAt
    }

erDiagram
    DEMO_CATALOG_ITEM ||--o{ DEMO_GRANT : "demoSlug"
    DEMO_CATALOG_ITEM }o--o{ DEMO_REQUEST : "demos[]"
    DEMO_REQUEST ||--o{ DEMO_GRANT : "request"
    DEMO_REQUEST }o--o| USER : "user (al aprobar)"
    DEMO_REQUEST |o--o| CONTACT : "lead"
    DEMO_REQUEST ||--o{ MAGIC_LINK_TOKEN : "request"
    USER ||--o{ DEMO_GRANT : "user"
    DEMO_CATALOG_ITEM {
        string slug UK "erp, chatbot, cuentas-medicas"
        string nombre
        string accessMode "publico, solicitud o privado"
        bool activo
        number duracionDiasPorDefecto "14"
        number orden
    }
    DEMO_REQUEST {
        string codigo UK "DR-AAAA-XXXXXX"
        string email "normalizado"
        array demos "slugs"
        string estado "pendiente, en_revision, aprobada, rechazada"
        object consentimiento "fecha, versión, ipHash"
        object decision "demos, dias, grants"
        ObjectId user FK
        ObjectId lead FK
    }
    DEMO_GRANT {
        ObjectId user FK
        string demoSlug
        ObjectId request FK "null si es invitación directa"
        string estado "activo, expirado, revocado"
        date expiresAt
        number accesos "visitas"
        array extensiones
    }
    USER {
        string email UK
        string role
        string accountStatus
    }
    CONTACT {
        string email
        string source "demo-request"
    }
    MAGIC_LINK_TOKEN {
        string proposito "activacion"
        ObjectId request FK
    }

erDiagram
    CONTACT |o--o| DEMO_REQUEST : "lead de"
    CONTACT {
        ObjectId _id PK
        string name
        string email
        string phone
        string company
        string service
        string message
        string status "new, read, responded"
        string source "contact-form, demo-rag, demo-request"
        string plazo "now, 1m, 3m, open"
        object cotizacion "servicio, plan, nivel, modalidad"
        object consentimiento "aceptado, fecha, versionPolitica, ipHash"
        object notificaciones "email y whatsapp: estado, intentos, error"
        date anonimizadoEn
        date created_at
    }
    QUOTE {
        ObjectId _id PK
        string name
        string email
        string service
        string description
        string status "pending, contacted, completed"
    }
    DEMO_REQUEST {
        string codigo UK
        ObjectId lead FK
    }

erDiagram
    USER ||--o{ PROJECT : "client_id"
    USER ||--o{ PROJECT : "manager_id"
    PROJECT ||--o{ PROJECT_MEMBER : "project_id"
    USER ||--o{ PROJECT_MEMBER : "user_id"
    PROJECT ||--o{ TASK : "project_id"
    PROJECT ||--o{ ACTIVITY_LOG : "project_id"
    USER ||--o{ ORDER : "userId"
    PROJECT |o--o{ ORDER : "projectId"
    ORDER |o--o| CONVERSATION : "conversationId"
    ORDER |o--o{ INVOICE : "orderId"
    PROJECT ||--o{ INVOICE : "projectId"
    USER ||--o{ INVOICE : "userId"
    PROJECT ||--o{ DELIVERABLE : "projectId"
    USER ||--o{ DELIVERABLE : "userId"
    CONVERSATION ||--o{ MESSAGE : "conversationId"
    USER ||--o{ MESSAGE : "sender"
    USER ||--o{ NOTIFICATION : "userId (texto)"
    PROJECT {
        string name
        string status "planning, active, on_hold, completed, cancelled"
        string priority
        number progress "0 a 100"
    }
    ORDER {
        string orderId UK "ORD-0001"
        string status
        string approvalStatus
        number amount
        array items
    }
    INVOICE {
        string invoiceNumber UK "FAC-AAAA-0001"
        string status
        number total
        date dueDate
    }
    DELIVERABLE {
        string deliverableId UK "DEL-0001"
        string type
        string status
    }
    CONVERSATION {
        string conversationId UK "CONV-0001"
        array participants
        string status
    }
    MESSAGE {
        string messageId UK "MSG-000001"
        string content
        array readBy
    }
    NOTIFICATION {
        string userId "id de la cuenta como texto"
        string type
        bool isRead
    }

erDiagram
    USER ||--o{ DOCUMENT : "user_id"
    CHATBOT_BOT ||--o{ BOT_DOC : "docs"
    CHATBOT_BOT ||--o{ CHATBOT_BOT_CHUNKS : "botId"
    CHATBOT_BOT ||--o{ CHATBOT_TURN : "botId"
    DOCUMENT {
        string user_id "id de la cuenta como texto"
        string original_filename
        string folder
        array tags
        string ai_summary
        array embedding "vector"
        bool is_deleted "papelera"
    }
    CHATBOT_BOT {
        string botId UK "kbot_..."
        string ownerTokenHash "SHA-256"
        string systemPrompt
        string kind "builder, sample"
        date lastActivityAt
    }
    BOT_DOC {
        string name
        string hash
    }
    CHATBOT_BOT_CHUNKS {
        string botId
        string docId "un registro por documento"
        array chunks "id, docName, text"
    }
    CHATBOT_TURN {
        string botId
        string role
        string content
        array sources
        date expiresAt "índice TTL"
    }

erDiagram
    FACTURA ||--o{ ATENCION : "atenciones"
    ATENCION ||--o{ PROCEDIMIENTO : "procedimientos"
    PROCEDIMIENTO ||--o{ GLOSA : "glosas"
    FACTURA ||--o{ GLOSA : "facturaId"
    FACTURA }o--o| TARIFARIO : "tarifarioId"
    FACTURA ||--o{ SOPORTE_DOCUMENTAL : "facturaId"
    GLOSA |o--o| SOPORTE_DOCUMENTAL : "soporteId"
    FACTURA ||--o{ AUDITORIA_SESION : "facturaId"
    FACTURA {
        string numeroFactura
        object ips "nit, nombre"
        object eps "nit, nombre"
        string regimen
        number valorTotal
        string estado "Radicada a Pagada"
        number totalGlosas
        number valorAceptado
    }
    ATENCION {
        string numeroAtencion
        object paciente "datos mínimos"
        object diagnosticoPrincipal "CIE-10"
        number copago
    }
    PROCEDIMIENTO {
        string codigoCUPS
        number cantidad
        number valorTotalIPS
        number valorTotalContrato
        number valorAPagar
    }
    GLOSA {
        string codigo
        string tipo "Tarifa, Soporte, Pertinencia, Duplicidad"
        number valorGlosado
        string estado "Pendiente, Aceptada, Rechazada"
    }
    SOPORTE_DOCUMENTAL {
        string tipo
        string archivo
    }
    TARIFARIO {
        string nombre
        array tarifas
    }
    AUDITORIA_SESION {
        number pasoActual
        number totalPasos
        string estado "iniciada, en-progreso, completada, error"
    }

stateDiagram-v2
    [*] --> pendiente: POST /api/demo-requests
    pendiente --> en_revision: el equipo la toma
    en_revision --> pendiente: vuelve a la cola
    pendiente --> pendiente: el mismo email reenvía (suma demos)
    en_revision --> en_revision: el mismo email reenvía (suma demos)
    pendiente --> aprobada: approve
    en_revision --> aprobada: approve
    pendiente --> rechazada: reject con motivo
    en_revision --> rechazada: reject con motivo
    aprobada --> [*]
    rechazada --> [*]

stateDiagram-v2
    [*] --> activo: approve o invitación directa
    activo --> activo: extend o nueva aprobación (suma días)
    activo --> expirado: pasa expiresAt
    expirado --> activo: extend
    activo --> revocado: revoke
    expirado --> revocado: revoke
    revocado --> [*]
    note right of activo
        Por vencer no es un estado:
        es un filtro de activos
        que vencen en 3 días o menos.
    end note

stateDiagram-v2
    [*] --> planning: POST /api/projects
    planning --> active
    active --> on_hold
    on_hold --> active
    active --> completed
    planning --> cancelled
    active --> cancelled
    on_hold --> cancelled
    completed --> [*]
    cancelled --> [*]

stateDiagram-v2
    [*] --> pending: se emite
    pending --> paid: se registra el pago
    paid --> [*]
    note right of pending
        draft, overdue y cancelled existen
        en el modelo, pero ninguna ruta
        los asigna hoy.
    end note

stateDiagram-v2
    state Cuenta {
        [*] --> invitado: aprobación o invitación
        [*] --> activo: registro, Google o equipo
        invitado --> activo: activate o reset-password
    }
    state Enlace {
        state "pendiente" as enlace_pendiente
        [*] --> enlace_pendiente: se emite
        enlace_pendiente --> usado: se consume
        enlace_pendiente --> reemplazado: se emite otro
        enlace_pendiente --> vencido: pasa expiresAt
    }

flowchart LR
    classDef corto fill:#fee2e2,stroke:#dc2626,color:#7f1d1d
    classDef medio fill:#fef3c7,stroke:#d97706,color:#78350f
    classDef largo fill:#dcfce7,stroke:#16a34a,color:#14532d

    A["Documento de la demo RAG: 1 hora"]:::corto
    B["Cupos: de 10 min a 24 horas"]:::corto
    C["Sesión renovable: 7 días"]:::medio
    D["Enlace de activación o recuperación: 72 h o 1 h, se borra 7 días después"]:::medio
    E["Gasto de IA del mes: 62 días"]:::medio
    G["Preguntas al widget del chatbot: 30 días"]:::medio
    H["Prospectos sin actividad y solicitudes rechazadas: se anonimizan a los 24 meses"]:::largo
    F["Cuentas, accesos, bitácora y clientes: mientras exista la relación"]:::largo
    A --> B --> C --> D --> E --> G --> H --> F