659 lines
20 KiB
Markdown
659 lines
20 KiB
Markdown
# Base de datos — `usite_whatsapp_bot`
|
||
|
||
Documentación de las 34 tablas del sistema WhatsApp Bot + Panel Laboratorio Ximena.
|
||
Motor: **MariaDB / MySQL 8.x** — Charset: `utf8mb4` — Collation: `utf8mb4_unicode_ci`
|
||
|
||
---
|
||
|
||
## Índice rápido
|
||
|
||
| # | Tabla | Filas (prod) | Dominio |
|
||
|---|-------|-------------|---------|
|
||
| 1 | [admin\_users](#1-admin_users) | 4 | Autenticación |
|
||
| 2 | [autoresponses](#2-autoresponses) | 6 | Bot WhatsApp |
|
||
| 3 | [conversations](#3-conversations) | 3 490 | Bot WhatsApp |
|
||
| 4 | [file\_request\_uploads](#4-file_request_uploads) | 0 | Solicitud archivos |
|
||
| 5 | [file\_requests](#5-file_requests) | 0 | Solicitud archivos |
|
||
| 6 | [lab\_actividad\_admin](#6-lab_actividad_admin) | 43 | Auditoría |
|
||
| 7 | [lab\_asignaciones](#7-lab_asignaciones) | 4 | Laboratorio |
|
||
| 8 | [lab\_autorizaciones](#8-lab_autorizaciones) | 0 | Laboratorio |
|
||
| 9 | [lab\_config](#9-lab_config) | 9 | Laboratorio |
|
||
| 10 | [lab\_domicilios](#10-lab_domicilios) | 9 | Laboratorio |
|
||
| 11 | [lab\_enfermeras](#11-lab_enfermeras) | 1 | Laboratorio |
|
||
| 12 | [lab\_form\_envios](#12-lab_form_envios) | 15 | Formularios |
|
||
| 13 | [lab\_formularios](#13-lab_formularios) | 3 | Formularios |
|
||
| 14 | [lab\_ordenes\_medicas](#14-lab_ordenes_medicas) | 0 | Laboratorio |
|
||
| 15 | [lab\_pacientes](#15-lab_pacientes) | 3 | Laboratorio |
|
||
| 16 | [lab\_servicios\_extra](#16-lab_servicios_extra) | 0 | Laboratorio |
|
||
| 17 | [media\_files](#17-media_files) | 231 | Multimedia |
|
||
| 18 | [media\_queue](#18-media_queue) | 7 | Multimedia |
|
||
| 19 | [menu\_options](#19-menu_options) | 13 | Bot WhatsApp |
|
||
| 20 | [menus](#20-menus) | 2 | Bot WhatsApp |
|
||
| 21 | [message\_templates](#21-message_templates) | 2 | Bot WhatsApp |
|
||
| 22 | [migrations](#22-migrations) | 4 | Sistema |
|
||
| 23 | [notifications](#23-notifications) | 2 073 | Sistema |
|
||
| 24 | [operator\_activity](#24-operator_activity) | 227 | Operadores |
|
||
| 25 | [role\_modules](#25-role_modules) | 12 | Control de acceso |
|
||
| 26 | [roles](#26-roles) | 2 | Control de acceso |
|
||
| 27 | [scheduled\_messages](#27-scheduled_messages) | — | Mensajes prog. |
|
||
| 28 | [scheduled\_messages\_view](#28-scheduled_messages_view-vista) | — | Vista |
|
||
| 29 | [survey\_responses](#29-survey_responses) | 10 | Bot WhatsApp |
|
||
| 30 | [system\_config](#30-system_config) | 16 | Configuración |
|
||
| 31 | [system\_logs](#31-system_logs) | 0 | Sistema |
|
||
| 32 | [terms\_acceptance](#32-terms_acceptance) | 0 | T&C |
|
||
| 33 | [terms\_versions](#33-terms_versions) | 2 | T&C |
|
||
| 34 | [user\_states](#34-user_states) | 108 | Bot WhatsApp |
|
||
| 35 | [users](#35-users) | 3 090 | Usuarios |
|
||
| 36 | [webhook\_logs](#36-webhook_logs) | 9 850 | Sistema |
|
||
|
||
---
|
||
|
||
## Autenticación
|
||
|
||
### 1. `admin_users`
|
||
Administradores del panel web.
|
||
|
||
| Columna | Tipo | Notas |
|
||
|---------|------|-------|
|
||
| `id` | INT PK | |
|
||
| `username` | VARCHAR(50) UNIQUE | Login |
|
||
| `password` | VARCHAR(255) | bcrypt |
|
||
| `role_id` | INT FK→roles | Rol asignado (NULL = admin clásico) |
|
||
| `email` | VARCHAR(100) | |
|
||
| `nombre` | VARCHAR(100) | Nombre completo |
|
||
| `is_active` | TINYINT(1) | 1 = activo |
|
||
| `last_login` | DATETIME | |
|
||
| `created_at` | TIMESTAMP | |
|
||
|
||
**Relaciones:** `role_id` → `roles.id`
|
||
|
||
---
|
||
|
||
## Bot WhatsApp
|
||
|
||
### 2. `autoresponses`
|
||
Respuestas automáticas del bot ante palabras clave.
|
||
|
||
| Columna | Tipo | Notas |
|
||
|---------|------|-------|
|
||
| `id` | INT PK | |
|
||
| `keyword` | VARCHAR(100) | Palabra/frase que activa la respuesta |
|
||
| `response` | TEXT | Texto de respuesta |
|
||
| `is_active` | TINYINT(1) | |
|
||
| `created_at` / `updated_at` | TIMESTAMP | |
|
||
|
||
---
|
||
|
||
### 3. `conversations`
|
||
Hilo de mensajes WhatsApp por número de teléfono.
|
||
|
||
| Columna | Tipo | Notas |
|
||
|---------|------|-------|
|
||
| `id` | INT PK | |
|
||
| `phone_number` | VARCHAR(20) | Número del usuario |
|
||
| `contact_name` | VARCHAR(100) | Nombre de WhatsApp |
|
||
| `messages` | LONGTEXT (JSON) | Array de mensajes |
|
||
| `last_message` | TEXT | Extracto del último mensaje |
|
||
| `last_message_at` | DATETIME | |
|
||
| `unread_count` | INT | Mensajes no leídos por operador |
|
||
| `status` | ENUM | `active`, `archived`, `blocked` |
|
||
| `assigned_to` | INT FK→admin_users | Operador asignado |
|
||
| `created_at` / `updated_at` | TIMESTAMP | |
|
||
|
||
---
|
||
|
||
### 4. `file_request_uploads`
|
||
Archivos subidos en respuesta a solicitudes.
|
||
|
||
| Columna | Tipo | Notas |
|
||
|---------|------|-------|
|
||
| `id` | INT PK | |
|
||
| `request_id` | INT FK→file_requests | |
|
||
| `file_path` | VARCHAR(500) | Ruta en servidor |
|
||
| `file_type` | VARCHAR(50) | MIME |
|
||
| `uploaded_at` | DATETIME | |
|
||
|
||
---
|
||
|
||
### 5. `file_requests`
|
||
Solicitudes de documentos enviadas por WhatsApp.
|
||
|
||
| Columna | Tipo | Notas |
|
||
|---------|------|-------|
|
||
| `id` | INT PK | |
|
||
| `phone_number` | VARCHAR(20) | |
|
||
| `request_type` | VARCHAR(50) | Tipo de documento solicitado |
|
||
| `status` | ENUM | `pending`, `fulfilled`, `expired` |
|
||
| `expires_at` | DATETIME | |
|
||
| `created_at` | TIMESTAMP | |
|
||
|
||
---
|
||
|
||
### 19. `menu_options`
|
||
Opciones de submenú del bot (hijos de `menus`).
|
||
|
||
| Columna | Tipo | Notas |
|
||
|---------|------|-------|
|
||
| `id` | INT PK | |
|
||
| `menu_id` | INT FK→menus | |
|
||
| `option_number` | INT | Tecla que selecciona el usuario |
|
||
| `option_text` | VARCHAR(200) | Texto visible |
|
||
| `action_type` | VARCHAR(50) | `submenu`, `message`, `url`, `form_link` |
|
||
| `action_value` | TEXT | Valor de la acción |
|
||
| `is_active` | TINYINT(1) | |
|
||
| `sort_order` | INT | |
|
||
|
||
---
|
||
|
||
### 20. `menus`
|
||
Menús raíz del bot por número de teléfono de negocio.
|
||
|
||
| Columna | Tipo | Notas |
|
||
|---------|------|-------|
|
||
| `id` | INT PK | |
|
||
| `phone_number_id` | VARCHAR(50) | ID de WhatsApp Business |
|
||
| `menu_text` | TEXT | Texto del menú principal |
|
||
| `is_active` | TINYINT(1) | |
|
||
| `created_at` / `updated_at` | TIMESTAMP | |
|
||
|
||
---
|
||
|
||
### 21. `message_templates`
|
||
Plantillas de mensajes aprobadas por Meta.
|
||
|
||
| Columna | Tipo | Notas |
|
||
|---------|------|-------|
|
||
| `id` | INT PK | |
|
||
| `name` | VARCHAR(100) | Nombre interno |
|
||
| `display_name` | VARCHAR(150) | Nombre legible |
|
||
| `category` | VARCHAR(50) | `MARKETING`, `UTILITY`, `AUTHENTICATION` |
|
||
| `language` | VARCHAR(10) | `es`, `en`, etc. |
|
||
| `status` | VARCHAR(30) | `APPROVED`, `PENDING`, `REJECTED` |
|
||
| `header_type` | VARCHAR(20) | `TEXT`, `IMAGE`, `DOCUMENT`, `NONE` |
|
||
| `header_text` | VARCHAR(500) | |
|
||
| `body_text` | TEXT | Cuerpo de la plantilla |
|
||
| `footer_text` | VARCHAR(300) | |
|
||
| `buttons` | LONGTEXT (JSON) | Botones quick-reply / CTA |
|
||
| `variables_count` | INT | Número de `{{n}}` en body |
|
||
| `meta_template_id` | VARCHAR(50) | ID en Meta Graph API |
|
||
| `created_at` / `updated_at` | TIMESTAMP | |
|
||
|
||
---
|
||
|
||
### 29. `survey_responses`
|
||
Respuestas a encuestas del bot.
|
||
|
||
| Columna | Tipo | Notas |
|
||
|---------|------|-------|
|
||
| `id` | INT PK | |
|
||
| `phone_number` | VARCHAR(20) | |
|
||
| `survey_id` | INT | Identificador de encuesta |
|
||
| `question_key` | VARCHAR(100) | |
|
||
| `answer` | TEXT | |
|
||
| `created_at` | TIMESTAMP | |
|
||
|
||
---
|
||
|
||
### 34. `user_states`
|
||
Estado de conversación del bot por usuario (máquina de estados).
|
||
|
||
| Columna | Tipo | Notas |
|
||
|---------|------|-------|
|
||
| `id` | INT PK | |
|
||
| `phone_number` | VARCHAR(20) UNIQUE | |
|
||
| `state` | VARCHAR(100) | Estado actual del flujo del bot |
|
||
| `context` | LONGTEXT (JSON) | Datos contextuales del estado |
|
||
| `updated_at` | DATETIME | |
|
||
|
||
---
|
||
|
||
## Laboratorio
|
||
|
||
### 6. `lab_actividad_admin`
|
||
Log de acciones de administradores en el laboratorio.
|
||
|
||
| Columna | Tipo | Notas |
|
||
|---------|------|-------|
|
||
| `id` | INT PK | |
|
||
| `admin_id` | INT FK→admin_users | |
|
||
| `accion` | VARCHAR(100) | Descripción de la acción |
|
||
| `entidad` | VARCHAR(50) | Tabla/módulo afectado |
|
||
| `entidad_id` | INT | ID del registro afectado |
|
||
| `datos_extra` | TEXT (JSON) | Detalles adicionales |
|
||
| `ip` | VARCHAR(45) | |
|
||
| `created_at` | TIMESTAMP | |
|
||
|
||
---
|
||
|
||
### 7. `lab_asignaciones`
|
||
Asignaciones de servicios domiciliarios a enfermeras.
|
||
|
||
| Columna | Tipo | Notas |
|
||
|---------|------|-------|
|
||
| `id` | INT PK | |
|
||
| `domicilio_id` | INT FK→lab_domicilios | |
|
||
| `enfermera_id` | INT FK→lab_enfermeras | |
|
||
| `estado` | ENUM | `pendiente`, `aceptado`, `rechazado`, `completado` |
|
||
| `fecha_asignacion` | DATETIME | |
|
||
| `fecha_respuesta` | DATETIME | |
|
||
| `notas` | TEXT | |
|
||
|
||
---
|
||
|
||
### 8. `lab_autorizaciones`
|
||
Autorizaciones médicas/seguros para servicios del laboratorio.
|
||
|
||
| Columna | Tipo | Notas |
|
||
|---------|------|-------|
|
||
| `id` | INT PK | |
|
||
| `paciente_id` | INT FK→lab_pacientes | |
|
||
| `tipo` | VARCHAR(50) | Tipo de autorización |
|
||
| `numero_autorizacion` | VARCHAR(100) | |
|
||
| `aseguradora` | VARCHAR(100) | |
|
||
| `fecha_vencimiento` | DATE | |
|
||
| `estado` | ENUM | `vigente`, `vencida` |
|
||
| `created_at` | TIMESTAMP | |
|
||
|
||
---
|
||
|
||
### 9. `lab_config`
|
||
Configuración específica del módulo de laboratorio (clave–valor).
|
||
|
||
| Columna | Tipo | Notas |
|
||
|---------|------|-------|
|
||
| `clave` | VARCHAR(80) PK | Nombre de la configuración |
|
||
| `valor` | LONGTEXT | Valor |
|
||
| `updated_at` | TIMESTAMP | |
|
||
|
||
Ejemplos de claves: `empresa_nombre`, `empresa_nit`, `empresa_direccion`, `empresa_telefono`, `empresa_email`, `empresa_ciudad`, etc.
|
||
|
||
---
|
||
|
||
### 10. `lab_domicilios`
|
||
Solicitudes de servicio domiciliario de laboratorio.
|
||
|
||
| Columna | Tipo | Notas |
|
||
|---------|------|-------|
|
||
| `id` | INT PK | |
|
||
| `paciente_id` | INT FK→lab_pacientes | |
|
||
| `fecha_solicitud` | DATE | |
|
||
| `hora_solicitud` | TIME | |
|
||
| `direccion` | VARCHAR(300) | |
|
||
| `ciudad` | VARCHAR(100) | |
|
||
| `estado` | ENUM | `pendiente`, `asignado`, `en_camino`, `completado`, `cancelado` |
|
||
| `observaciones` | TEXT | |
|
||
| `examen_solicitado` | TEXT | |
|
||
| `creado_por` | INT FK→admin_users | |
|
||
| `created_at` / `updated_at` | TIMESTAMP | |
|
||
|
||
---
|
||
|
||
### 11. `lab_enfermeras`
|
||
Enfermeras/profesionales de campo del laboratorio.
|
||
|
||
| Columna | Tipo | Notas |
|
||
|---------|------|-------|
|
||
| `id` | INT PK | |
|
||
| `nombre` | VARCHAR(150) | |
|
||
| `telefono` | VARCHAR(20) | |
|
||
| `email` | VARCHAR(100) | |
|
||
| `phone_number_wa` | VARCHAR(20) | Número WhatsApp para notificaciones |
|
||
| `is_active` | TINYINT(1) | |
|
||
| `created_at` / `updated_at` | TIMESTAMP | |
|
||
|
||
---
|
||
|
||
### 12. `lab_form_envios`
|
||
Instancias de formularios enviados/completados por pacientes.
|
||
|
||
| Columna | Tipo | Notas |
|
||
|---------|------|-------|
|
||
| `id` | INT PK | |
|
||
| `formulario_id` | INT FK→lab_formularios | |
|
||
| `paciente_id` | INT FK→lab_pacientes | |
|
||
| `phone_number` | VARCHAR(20) | |
|
||
| `datos_json` | LONGTEXT (JSON) | Respuestas del formulario |
|
||
| `firma_base64` | LONGTEXT | Firma digital en Base64 |
|
||
| `pdf_path` | VARCHAR(500) | Ruta del PDF generado |
|
||
| `hash_verificacion` | CHAR(64) | SHA-256 del PDF para integridad |
|
||
| `estado` | ENUM | `borrador`, `enviado`, `procesado` |
|
||
| `created_at` / `updated_at` | TIMESTAMP | |
|
||
|
||
---
|
||
|
||
### 13. `lab_formularios`
|
||
Definición de formularios médicos configurables.
|
||
|
||
| Columna | Tipo | Notas |
|
||
|---------|------|-------|
|
||
| `id` | INT PK | |
|
||
| `nombre` | VARCHAR(150) | |
|
||
| `descripcion` | TEXT | |
|
||
| `categoria` | ENUM | `consentimiento`, `historia_clinica`, `autorizacion`, `encuesta`, `otro` |
|
||
| `esquema` | LONGTEXT (JSON) | Definición de campos del formulario |
|
||
| `permite_firma` | TINYINT(1) | |
|
||
| `requiere_firma` | TINYINT(1) | |
|
||
| `version` | SMALLINT | |
|
||
| `is_active` | TINYINT(1) | |
|
||
| `doc_encabezado` | VARCHAR(200) | Título en PDF |
|
||
| `doc_subtitulo` | VARCHAR(200) | Subtítulo en PDF |
|
||
| `doc_logo_base64` | LONGTEXT | Logo en Base64 para PDF |
|
||
| `doc_color` | VARCHAR(20) | Color principal HEX para PDF |
|
||
| `doc_pie_pagina` | VARCHAR(500) | Pie de página del PDF |
|
||
| `creado_por` | INT FK→admin_users | |
|
||
| `created_at` / `updated_at` | TIMESTAMP | |
|
||
|
||
---
|
||
|
||
### 14. `lab_ordenes_medicas`
|
||
Órdenes médicas digitalizadas vinculadas a pacientes.
|
||
|
||
| Columna | Tipo | Notas |
|
||
|---------|------|-------|
|
||
| `id` | INT PK | |
|
||
| `paciente_id` | INT FK→lab_pacientes | |
|
||
| `medico` | VARCHAR(150) | |
|
||
| `especialidad` | VARCHAR(100) | |
|
||
| `fecha_orden` | DATE | |
|
||
| `examenes` | TEXT | Exámenes ordenados |
|
||
| `archivo_path` | VARCHAR(500) | Imagen/PDF de la orden |
|
||
| `estado` | ENUM | `pendiente`, `procesada`, `vigente`, `vencida` |
|
||
| `created_at` / `updated_at` | TIMESTAMP | |
|
||
|
||
---
|
||
|
||
### 15. `lab_pacientes`
|
||
Pacientes registrados en el laboratorio.
|
||
|
||
| Columna | Tipo | Notas |
|
||
|---------|------|-------|
|
||
| `id` | INT PK | |
|
||
| `nombre` | VARCHAR(150) | |
|
||
| `documento` | VARCHAR(30) | Cédula / NIT |
|
||
| `tipo_documento` | VARCHAR(20) | CC, TI, CE, PA, NIT |
|
||
| `fecha_nacimiento` | DATE | |
|
||
| `telefono` | VARCHAR(20) | |
|
||
| `email` | VARCHAR(100) | |
|
||
| `direccion` | VARCHAR(300) | |
|
||
| `eps` | VARCHAR(100) | Aseguradora de salud |
|
||
| `phone_number_wa` | VARCHAR(20) | Número WhatsApp → `users.phone_number` |
|
||
| `created_at` / `updated_at` | TIMESTAMP | |
|
||
|
||
---
|
||
|
||
### 16. `lab_servicios_extra`
|
||
Servicios adicionales configurables del laboratorio (transporte, procesamiento especial, etc.).
|
||
|
||
| Columna | Tipo | Notas |
|
||
|---------|------|-------|
|
||
| `id` | INT PK | |
|
||
| `nombre` | VARCHAR(100) | |
|
||
| `descripcion` | TEXT | |
|
||
| `precio` | DECIMAL(10,2) | |
|
||
| `is_active` | TINYINT(1) | |
|
||
| `created_at` | TIMESTAMP | |
|
||
|
||
---
|
||
|
||
## Multimedia
|
||
|
||
### 17. `media_files`
|
||
Archivos multimedia subidos o recibidos por WhatsApp.
|
||
|
||
| Columna | Tipo | Notas |
|
||
|---------|------|-------|
|
||
| `id` | INT PK | |
|
||
| `media_id` | VARCHAR(100) | ID en la API de WhatsApp |
|
||
| `file_name` | VARCHAR(255) | |
|
||
| `file_path` | VARCHAR(500) | Ruta local |
|
||
| `file_size` | BIGINT | Bytes |
|
||
| `mime_type` | VARCHAR(100) | |
|
||
| `phone_number` | VARCHAR(20) | Remitente o destinatario |
|
||
| `direction` | ENUM | `incoming`, `outgoing` |
|
||
| `created_at` | TIMESTAMP | |
|
||
|
||
---
|
||
|
||
### 18. `media_queue`
|
||
Cola de transmisión de archivos multimedia grandes.
|
||
|
||
| Columna | Tipo | Notas |
|
||
|---------|------|-------|
|
||
| `id` | INT PK | |
|
||
| `media_file_id` | INT FK→media_files | |
|
||
| `status` | ENUM | `pending`, `processing`, `done`, `failed` |
|
||
| `attempts` | INT | Reintentos |
|
||
| `error_message` | TEXT | |
|
||
| `created_at` / `updated_at` | TIMESTAMP | |
|
||
|
||
---
|
||
|
||
## Mensajes Programados
|
||
|
||
### 27. `scheduled_messages`
|
||
Mensajes de WhatsApp programados para envío futuro.
|
||
|
||
| Columna | Tipo | Notas |
|
||
|---------|------|-------|
|
||
| `id` | INT PK | |
|
||
| `user_id` | INT FK→users | Destinatario |
|
||
| `template_id` | INT FK→message_templates | Plantilla a usar |
|
||
| `template_name` | VARCHAR(100) | Nombre snapshot de la plantilla |
|
||
| `template_language` | VARCHAR(10) | `es`, `en` |
|
||
| `template_parameters` | LONGTEXT (JSON) | Variables `{{n}}` |
|
||
| `message_type` | ENUM | `template`, `text` |
|
||
| `message_content` | TEXT | Mensaje libre (si type=text) |
|
||
| `scheduled_date` | DATE | Fecha de envío |
|
||
| `scheduled_time` | TIME | Hora de envío |
|
||
| `status` | ENUM | `pending`, `sent`, `failed`, `cancelled` |
|
||
| `sent_at` | DATETIME | |
|
||
| `error_message` | TEXT | |
|
||
| `created_by` | INT FK→admin_users | Admin que creó el recordatorio |
|
||
| `created_at` / `updated_at` | DATETIME | |
|
||
|
||
---
|
||
|
||
### 28. `scheduled_messages_view` (VISTA)
|
||
Enriquece `scheduled_messages` con datos del usuario, plantilla y nombre del admin.
|
||
|
||
Columnas adicionales: `user_name`, `phone_number`, `template_display_name`, `template_body`, `template_status`.
|
||
|
||
---
|
||
|
||
## Control de Acceso
|
||
|
||
### 25. `role_modules`
|
||
Asociación entre roles y módulos del sistema (permisos).
|
||
|
||
| Columna | Tipo | Notas |
|
||
|---------|------|-------|
|
||
| `id` | INT PK | |
|
||
| `role_id` | INT FK→roles | |
|
||
| `module_slug` | VARCHAR(100) | Clave del módulo (ej. `lab`, `bot`, `config`) |
|
||
|
||
---
|
||
|
||
### 26. `roles`
|
||
Roles del sistema para control de acceso basado en roles (RBAC).
|
||
|
||
| Columna | Tipo | Notas |
|
||
|---------|------|-------|
|
||
| `id` | INT PK | |
|
||
| `name` | VARCHAR(100) | Nombre legible |
|
||
| `slug` | VARCHAR(50) UNIQUE | Clave interna (`admin`, `enfermero`) |
|
||
| `description` | TEXT | |
|
||
| `color` | VARCHAR(20) | Color HEX para UI |
|
||
| `is_system` | TINYINT(1) | 1 = no eliminable |
|
||
| `created_at` / `updated_at` | TIMESTAMP | |
|
||
|
||
Roles de sistema predefinidos: `admin` (id=1), `enfermero` (id=2).
|
||
|
||
---
|
||
|
||
## Términos y Condiciones (T&C)
|
||
|
||
### 32. `terms_acceptance`
|
||
Registro de aceptaciones/rechazos de T&C por usuario.
|
||
|
||
| Columna | Tipo | Notas |
|
||
|---------|------|-------|
|
||
| `id` | INT PK | |
|
||
| `phone_number` | VARCHAR(20) | |
|
||
| `version_id` | INT FK→terms_versions | Versión enviada |
|
||
| `estado` | ENUM | `pendiente`, `aceptado`, `rechazado` |
|
||
| `fecha_envio` | DATETIME | Cuándo se enviaron los T&C |
|
||
| `fecha_respuesta` | DATETIME | Cuándo respondió el usuario |
|
||
| `ip_origem` | VARCHAR(45) | IP de origen (si aplica) |
|
||
|
||
---
|
||
|
||
### 33. `terms_versions`
|
||
Versiones publicadas de los Términos y Condiciones.
|
||
|
||
| Columna | Tipo | Notas |
|
||
|---------|------|-------|
|
||
| `id` | INT PK | |
|
||
| `version` | VARCHAR(20) | Ej. `v1.0` |
|
||
| `titulo` | VARCHAR(200) | |
|
||
| `mensaje_bot` | TEXT | Texto enviado por WhatsApp |
|
||
| `mensaje_rechazo` | TEXT | Texto si el usuario rechaza |
|
||
| `pdf_url` | VARCHAR(500) | URL pública del PDF |
|
||
| `pdf_path` | VARCHAR(500) | Ruta local del archivo |
|
||
| `es_activa` | TINYINT(1) | Solo una activa a la vez |
|
||
| `forzar_reenvio` | TINYINT(1) | 1 = todos deben re-aceptar |
|
||
| `created_at` | TIMESTAMP | |
|
||
| `created_by` | INT FK→admin_users | |
|
||
|
||
---
|
||
|
||
## Configuración y Sistema
|
||
|
||
### 22. `migrations`
|
||
Registro de migraciones de BD aplicadas.
|
||
|
||
| Columna | Tipo | Notas |
|
||
|---------|------|-------|
|
||
| `id` | INT PK | |
|
||
| `name` | VARCHAR(255) | Nombre del archivo de migración |
|
||
| `applied_at` | TIMESTAMP | |
|
||
|
||
Migraciones aplicadas: `01_initial.sql`, `02_…`, `03_…`, `05_terms_acceptance.sql`, `06_master_sync.sql`.
|
||
|
||
---
|
||
|
||
### 23. `notifications`
|
||
Notificaciones del sistema enviadas a admins.
|
||
|
||
| Columna | Tipo | Notas |
|
||
|---------|------|-------|
|
||
| `id` | INT PK | |
|
||
| `admin_id` | INT FK→admin_users | NULL = broadcast |
|
||
| `type` | VARCHAR(50) | `new_message`, `assignment`, `system` |
|
||
| `title` | VARCHAR(200) | |
|
||
| `body` | TEXT | |
|
||
| `is_read` | TINYINT(1) | |
|
||
| `created_at` | TIMESTAMP | |
|
||
|
||
---
|
||
|
||
### 24. `operator_activity`
|
||
Actividad reciente de operadores (mensajes enviados, conversaciones gestionadas).
|
||
|
||
| Columna | Tipo | Notas |
|
||
|---------|------|-------|
|
||
| `id` | INT PK | |
|
||
| `admin_id` | INT FK→admin_users | |
|
||
| `action` | VARCHAR(100) | `send_message`, `view_conversation`, etc. |
|
||
| `phone_number` | VARCHAR(20) | Número implicado |
|
||
| `details` | TEXT (JSON) | |
|
||
| `created_at` | TIMESTAMP | |
|
||
|
||
---
|
||
|
||
### 30. `system_config`
|
||
Configuración global del sistema (clave–valor).
|
||
|
||
| Columna | Tipo | Notas |
|
||
|---------|------|-------|
|
||
| `id` | INT PK | |
|
||
| `config_key` | VARCHAR(100) UNIQUE | |
|
||
| `config_value` | TEXT | |
|
||
| `description` | VARCHAR(255) | |
|
||
| `updated_at` | TIMESTAMP | |
|
||
|
||
Claves principales: `whatsapp_token`, `whatsapp_phone_number_id`, `whatsapp_verify_token`, `bot_enabled`, `welcome_message`, `terms_message`, `terms_rejection_message`, `terms_pdf_url`, `terms_version`, `terms_force_resend`.
|
||
|
||
---
|
||
|
||
### 31. `system_logs`
|
||
Logs de errores y eventos del sistema.
|
||
|
||
| Columna | Tipo | Notas |
|
||
|---------|------|-------|
|
||
| `id` | INT PK | |
|
||
| `level` | ENUM | `info`, `warning`, `error`, `critical` |
|
||
| `message` | TEXT | |
|
||
| `context` | LONGTEXT (JSON) | Stack trace, datos extra |
|
||
| `created_at` | TIMESTAMP | |
|
||
|
||
---
|
||
|
||
### 36. `webhook_logs`
|
||
Log de todos los webhooks entrantes de WhatsApp.
|
||
|
||
| Columna | Tipo | Notas |
|
||
|---------|------|-------|
|
||
| `id` | INT PK | |
|
||
| `payload` | LONGTEXT (JSON) | Payload completo recibido |
|
||
| `event_type` | VARCHAR(50) | `message`, `status`, `read` |
|
||
| `phone_number` | VARCHAR(20) | |
|
||
| `processed` | TINYINT(1) | |
|
||
| `error` | TEXT | Error si falló el procesamiento |
|
||
| `created_at` | TIMESTAMP | |
|
||
|
||
---
|
||
|
||
## Usuarios
|
||
|
||
### 35. `users`
|
||
Usuarios de WhatsApp que han interactuado con el bot.
|
||
|
||
| Columna | Tipo | Notas |
|
||
|---------|------|-------|
|
||
| `id` | INT PK | |
|
||
| `phone_number` | VARCHAR(20) UNIQUE | Número de WhatsApp |
|
||
| `name` | VARCHAR(100) | Nombre de contacto en WhatsApp |
|
||
| `is_blocked` | TINYINT(1) | 1 = bloqueado |
|
||
| `bot_enabled` | TINYINT(1) | 1 = bot activo para este usuario |
|
||
| `last_interaction` | DATETIME | |
|
||
| `terms_pending` | TINYINT(1) | 1 = aún no aceptó T&C |
|
||
| `terms_accepted_at` | DATETIME | Fecha de aceptación |
|
||
| `terms_version_id` | INT FK→terms_versions | Versión aceptada |
|
||
| `created_at` / `updated_at` | TIMESTAMP | |
|
||
|
||
---
|
||
|
||
## Diagrama ER simplificado
|
||
|
||
```
|
||
users ──────────────────────────────────┐
|
||
│ 1:N terms_acceptance │
|
||
│ 1:N scheduled_messages │
|
||
│ 1:N conversations │ user_states (1:1 phone_number)
|
||
│ │
|
||
admin_users ─────── roles ──── role_modules
|
||
│ 1:N lab_actividad_admin
|
||
│ 1:N lab_domicilios ──── lab_asignaciones ── lab_enfermeras
|
||
│ 1:N lab_form_envios ── lab_formularios
|
||
│ 1:N lab_ordenes_medicas ── lab_pacientes ── lab_autorizaciones
|
||
│ 1:N terms_versions (created_by)
|
||
│
|
||
menus ─── menu_options
|
||
message_templates ─── scheduled_messages
|
||
media_files ─── media_queue
|
||
```
|
||
|
||
---
|
||
|
||
*Última actualización: generado automáticamente desde comparación local/prod — ver `database/06_master_sync.sql`*
|