# Análisis Profundo de Base de Datos y Arquitectura de Seguridad — Santías Salud (`santias`)

## 1. Visión General del Ecosistema de Datos
La base de datos unificada **`santias`** en MariaDB/MySQL (`utf8mb4_spanish_ci`) consolida tres bases de datos Firebird 2.5 (`ODS 11.2`) procedentes del sistema clínico anterior (*DoctorGest*), sumando **52 objetos** (**51 tablas base** y **1 vista**) y **132.297 registros** (~1,20 GB):

| Subsistema | Prefijo | Origen | Tablas / Vistas | Filas Totales | Volumen | Propósito Clínico y Legal |
| :--- | :---: | :--- | :---: | ---: | ---: | :--- |
| **Gestión Clínica y ERP Médico** | `gm_` | `GESTMED.DB` | 49 tablas + 1 vista | 69.981 | ~55,3 MB | Filiación de pacientes, facultativos, agendas, citas, visitas, historia clínica por secciones, facturación y aseguradoras. |
| **Gestión Documental Médica** | `gd_` | `GESTMEDDOC.DB` | 1 tabla (`gd_documentos`) | 7.999 | ~1,14 GB | Repositorio binario (`LONGBLOB`) de documentos escaneados, consentimientos LOPD/RGPD firmados, analíticas e informes externos. |
| **Auditoría e Inmutabilidad RGPD** | `gl_` | `LOGS.DB` | 1 tabla (`gl_tabla`) | 54.317 | ~8,3 MB | Registro histórico de accesos por usuario, IP, equipo (`PC`), fecha/hora y entidad clínica consultada o modificada. |

---

## 2. Diagrama Entidad-Relación del Núcleo Clínico

```mermaid
erDiagram
    GM_PACIENTES ||--o{ GM_VISITAS : "HISTORIA"
    GM_PACIENTES ||--o{ GM_APUNTES : "HISTORIA"
    GM_PACIENTES ||--o{ GD_DOCUMENTOS : "IDTIPO1 (HISTORIA)"
    GM_MEDICOS ||--o{ GM_VISITAS : "MEDICO (ID)"
    GM_MEDICOS ||--o{ GM_RESULTADOS : "MEDICO (ID)"
    GM_VISITAS ||--o{ GM_RESULTADOS : "VISITA (ID)"
    GM_PARRAFOS ||--o{ GM_RESULTADOS : "PARRAFO (ID)"
    GM_PARRAFOS ||--o{ GM_PLANTILLAS : "IDPARRAFO"
    GM_AGENDAS ||--o{ GM_APUNTES : "IDAGENDA"
    GM_AGENDAS ||--o{ GM_HORARIOSA : "AGENDA"
    GM_AGENDAS ||--o{ GM_ACCESOS : "IDAGENDA"
    GM_MEDICOS ||--o{ GM_ACCESOS : "IDUSUARIO"
    GM_MEDICOS ||--o{ GM_MENUSU : "IDUSU"
    GM_EMPRESAS ||--o{ GM_FRACAB : "IDEMPRESA"
    GM_VISITAS ||--o{ GM_FRACAB : "IDVISITA"
    GM_FRACAB ||--o{ GM_FRALIN : "IDFRA"
    GM_FRACAB ||--o| GM_DATOSFACTURA : "IDFRA"
    GM_SEGUROS ||--o{ GM_SERVICIOCIA : "CIA"
    GM_SERVICIOS ||--o{ GM_SERVICIOCIA : "CODIGO"
    GM_MEDICOS ||--o{ GL_TABLA : "USUARIO"

    GM_PACIENTES {
        int HISTORIA PK
        varchar APPNOM
        date FNACI
        varchar DNI
        varchar TELEFONO
        varchar MOVIL
        int SEGURO FK
        char LOPD
        longtext ALER
        longtext OBS
        longblob FOTO
    }
    GM_VISITAS {
        int ID PK
        int HISTORIA FK
        datetime FECHA
        int MEDICO FK
        varchar MOTIVOC
        longtext OBS
        int USRINS
        datetime FECINS
    }
    GM_RESULTADOS {
        int ID PK
        int VISITA FK
        int MEDICO FK
        int PARRAFO FK
        datetime FECHA
        longtext MEMO "RTF / Texto"
    }
    GD_DOCUMENTOS {
        int ID PK
        longblob DOCUMENTO "JPG / PDF / BMP"
        varchar ORIGEN
        varchar ARCHIVO
        varchar DESCRIPCION
        datetime FECHA
        varchar TIPO "VIS / PAC"
        int IDTIPO1 "HISTORIA"
    }
    GL_TABLA {
        datetime FECHA
        varchar IP4
        int USUARIO
        int ACCION
        varchar PC
        varchar COMENTARIO "HIST=x VISITA=y"
    }
```

---

## 3. Análisis Profundo de los Módulos y Hallazgos Técnicos

### 3.1. Filiación y Datos de Salud (`gm_pacientes` — 5.840 pacientes)
- Clave primaria `HISTORIA` (`1` a `5876`).
- Contiene campos precalculados de búsqueda (`APELLIDOS` y `APPNOM` con formato `APELLIDO1 APELLIDO2, NOMBRE`).
- Almacena **datos de categoría especial (Art. 9 RGPD)**:
  - `ALER` (`LONGTEXT`): Alergias e intolerancias medicamentosas.
  - `OBS` (`LONGTEXT`): Anotaciones administrativas y clínicas.
  - `GS1` / `GS2`: Grupo sanguíneo y factor Rh.
  - `FOTO` (`LONGBLOB`): Fotografía en formato JPEG (`JFIF`).
  - `LOPD` / `LOPDNO`: Estado de firma del consentimiento de protección de datos.

### 3.2. Historia Clínica Estructurada (`gm_visitas` y `gm_resultados`)
- **`gm_visitas` (17.081 visitas)**: Registra cada acto asistencial vinculado a `HISTORIA` y `MEDICO` (`gm_medicos.ID`), con motivo (`MOTIVOC`), observaciones libres (`OBS`) y campos de trazabilidad (`USRINS`, `FECINS`, `USRMOD`, `FECMOD`).
- **`gm_resultados` (38.982 registros clínicos)**: Divide cada visita en secciones dinámicas parametrizadas por `gm_parrafos` (`19 secciones`):
  - `5`: Motivo de consulta
  - `6`: Antecedentes personales (`RECUPERA = 'S'` -> se arrastra entre visitas)
  - `7`: Antecedentes obstétrico-ginecológicos (`RECUPERA = 'S'`)
  - `8`: Exploración
  - `9` / `20`: Contenido de la sesión: objetivos y técnicas (Psicología)
  - `10`: Diagnóstico
  - `11`: Tratamiento
  - `12`: Recomendaciones
  - `13` / `14`: Próxima visita
  - `15`: Embarazo actual
  - `19`: Dieta (`RECUPERA = 'S'`, Nutrición)
  - `21` / `22` / `23`: Tareas, Observaciones e Información relevante.
- **Formato interno**: El campo `MEMO` en `gm_resultados` almacena cadenas en formato **Rich Text Format (`{\rtf1\ansi\ansicpg1252...}`)**. La aplicación Delphi debe decodificar y presentar limpiamente tanto RTF como texto plano.

### 3.3. Especialidades y Facultativos (`gm_medicos` — 38 registros)
- Especialidades activas en el centro: **Ginecología y Obstetricia, Nutrición, Psicología, Pediatría, Dermatología, Medicina de Familia, Podología, Enfermería y Fisioterapia**.
- El campo `ACTIVO` utiliza `'S'` para facultativos en activo y `'.'` para históricos/inactivos.

### 3.4. Repositorio Documental (`gd_documentos` — 7.999 documentos, 1,14 GB)
- Vinculado a los pacientes mediante `TIPO = 'VIS'` e `IDTIPO1 = HISTORIA`.
- Contiene mayoritariamente imágenes JPEG escaneadas (`ORIGEN = 'Escaner'`, ej. `lopd.jpg`) y documentos PDF (`ARCHIVO = '*.pdf'`), con tamaños de hasta `5,1 MB` por documento.

---

## 4. Auditoría de Seguridad y Vulnerabilidades Detectadas

> [!CAUTION]
> **Vulnerabilidad Crítica Detectada en el Sistema Heredado**:
> Durante la inspección forense de `gm_medicos.CONTRAS` y `gm_config.PWDADM`, se descubrió que las contraseñas de los facultativos y del administrador no estaban protegidas mediante hash criptográfico unidireccional, sino ofuscadas con un **XOR estático de 15 bytes** usando la clave fija `634F5059524947485400655A455155` (`"cOPYRIGHT\x00eZEQU"`).

### Medidas de Seguridad Implementadas en la Nueva Aplicación Delphi (`SantiasSalud`)
1. **Configuración de Conexión a Base de Datos Encriptada (`santias_db.enc`)**:
   - Las credenciales de conexión al servidor MySQL/MariaDB (`Servidor`, `Puerto`, `BaseDatos`, `Usuario`, `Password`, `RutaLibMySQL`, `TimeoutInactividad`) se almacenan en el archivo binario `santias_db.enc`.
   - **Doble capa criptográfica** en [`uSecurityCrypto.pas`](file:///c:/fuentes/proyectos%20delphi/SANTIAS%20SALUD/src/Common/uSecurityCrypto.pas):
     1. Deriva una clave de 256 bits mediante **PBKDF2 / SHA-256 iterado** con Salt aleatorio de 16 bytes por cada guardado y firma de integridad **HMAC-SHA256** (previniendo manipulación del archivo).
     2. Envuelve el bloque cifrado mediante **Windows DPAPI (`CryptProtectData` de `Crypt32.dll`)**, vinculando el descifrado a la máquina/cuenta de sistema autorizada.
2. **Autenticación Médica con Hash SHA-256 + Salt y Compatibilidad Transparente**:
   - Soporta validación de contraseñas heredadas para no interrumpir el acceso de los 38 facultativos, permitiendo actualizar y almacenar nuevas contraseñas con formato seguro `SHA256$<salt>$<hash>`.
3. **Trazabilidad Automática e Inmutable en `gl_tabla` (Cumplimiento RGPD / LOPDGDD)**:
   - Cada inicio de sesión, consulta de historia clínica (`HIST=...`), apertura/creación de visita (`VISITA=...`), previsualización o exportación de documento (`DOC=...`) y cambio de configuración queda registrado automáticamente en `gl_tabla` con fecha/hora exacta, IP local (`IP4`), nombre de equipo (`PC`) e ID de facultativo (`USUARIO`).
4. **Modo Privacidad en Consulta y Bloqueo Automático por Inactividad**:
   - **Modo Confidencialidad (Sala de espera / Pantalla compartida)**: Conmutador instantáneo que enmascara DNIs (`***4567*`) y teléfonos (`***456`) en las rejillas para evitar exposición visual accidental.
   - **Auto-Bloqueo por Inactividad**: Si el facultativo se ausenta de la consulta durante el tiempo configurado (por defecto 10 minutos), la aplicación bloquea la sesión y oculta los datos clínicos hasta reintroducir la credencial.
