Módulo de Análisis Clínicos¶

Identificador: MTS-ANA-001 Versión: 1.1.0 Fecha: 2025-12-01 Última Revisión: Decisiones del Director Round 3 - Exportación para segunda opinión Autor: SpecQueen

1. Propósito
2. Disponibilidad por Tier
3. Actores
4. Funcionalidades
4.1. Carga de Resultados (MTS-ANA-001-F01)
4.2. Historial de Resultados (MTS-ANA-001-F02)
4.3. Seguimiento de Parámetros (MTS-ANA-001-F03)
4.4. Alertas de Valores (MTS-ANA-001-F04)
4.5. Compartir con Médico (MTS-ANA-001-F05)
- 4.5.1. Descripción 3.5
- 4.5.2. Opciones de Compartir
4.6. Exportación para Segunda Opinión (MTS-ANA-001-F06)
5. Reglas de Negocio
6. Modelo de Datos
6.1. Entidad AnalisisClinico
6.2. Entidad ResultadoParametro
7. Criterios de Aceptación
8. Referencias

1. Propósito¶

Este módulo permite al paciente almacenar, organizar y visualizar resultados de análisis clínicos y estudios médicos, con capacidad de exportación para obtener segundas opiniones médicas.

2. Disponibilidad por Tier¶

Tier	Funcionalidad
Free	Almacenamiento local, visualización básica, sin sync
Pro	Sync cloud + gráficos de tendencia + compartir temporalmente
Perfect	Todo Pro + exportación completa para segunda opinión + OCR incluido

3. Actores¶

Actor	Descripción
Paciente	Sube y gestiona sus análisis
Cuidador	Visualiza análisis (con permiso)
Sistema	Procesa y organiza resultados

4. Funcionalidades¶

4.1. Carga de Resultados (MTS-ANA-001-F01)¶

4.1.1. Descripción 3.1¶

Permite subir resultados de análisis en diversos formatos.

4.1.2. Formatos Soportados¶

Formato	Descripción	Procesamiento
PDF	Documentos de laboratorio	OCR opcional
Imagen	Fotos de resultados	OCR opcional
Manual	Ingreso manual de valores	Formulario

4.1.3. Tipos de Análisis¶

Categoría	Ejemplos
Sangre	Biometría hemática, química sanguínea
Orina	Examen general de orina
Imagen	Rayos X, ultrasonido, MRI, TAC
Especializados	Hormonales, inmunológicos
Otros	Electrocardiograma, espirometría

4.1.4. Datos del Análisis¶

Campo	Tipo	Obligatorio	Descripción
tipo	enum	Sí	Categoría del análisis
nombre	string	Sí	Nombre del estudio
fecha_realizacion	date	Sí	Fecha del análisis
laboratorio	string	No	Laboratorio/Institución
medico_solicitante	string	No	Médico que lo solicitó
archivo	binary	No	Archivo del resultado
resultados	array	No	Valores extraídos/ingresados
notas	string	No	Observaciones

4.1.5. Flujo: Subir Análisis¶

flowchart TD
    A[Paciente selecciona 'Agregar Análisis'] --> B[Sistema muestra opciones]
    B --> C1[Tomar foto]
    B --> C2[Seleccionar de galería]
    B --> C3[Cargar PDF]
    B --> C4[Ingresar manualmente]
    C1 --> D{¿Es archivo?}
    C2 --> D
    C3 --> D
    C4 --> E
    D -->|Sí| F[Sistema procesa archivo]
    F --> G[Sistema ofrece OCR para extraer valores]
    G --> H[Paciente verifica/corrige valores extraídos]
    H --> E[Paciente completa metadatos]
    D -->|No| E
    E --> I[Sistema guarda análisis cifrado]
    I --> J[Sistema organiza en historial]

4.2. Historial de Resultados (MTS-ANA-001-F02)¶

4.2.1. Descripción 3.2¶

Visualización organizada de todos los análisis del paciente.

4.2.2. Organización¶

Vista	Descripción
Cronológica	Ordenados por fecha
Por tipo	Agrupados por categoría
Por parámetro	Historial de un valor específico

4.2.3. Filtros¶

Filtro	Opciones
Rango de fechas	Último mes, 3 meses, año, personalizado
Tipo de análisis	Sangre, orina, imagen, etc.
Laboratorio	Por institución

4.3. Seguimiento de Parámetros (MTS-ANA-001-F03)¶

4.3.1. Descripción 3.3¶

Graficado de valores a lo largo del tiempo para detectar tendencias.

4.3.2. Parámetros Rastreables¶

Parámetro	Unidad	Rango Normal
Glucosa	mg/dL	70-100
Hemoglobina	g/dL	12-16 (mujeres), 14-18 (hombres)
Colesterol Total	mg/dL	< 200
Triglicéridos	mg/dL	< 150
Creatinina	mg/dL	0.7-1.3
HbA1c	%	< 5.7

4.3.3. Visualización¶

%%{init: {'theme':'base'}}%%
graph TD
    subgraph "Glucosa en ayunas (mg/dL)"
        A["Ene: 110"] --> B["Feb: 125"]
        B --> C["Mar: 120"]
        C --> D["Abr: 115"]
        D --> E["May: 105"]
        E --> F["Jun: 100"]
    end

    style F fill:#90EE90
    style A fill:#FFB6C1
    style B fill:#FF6B6B

    G["Tendencia: ↘ Mejorando"]

    note1["Límite superior: 100 mg/dL"]

Nota: Los valores han mejorado de 110 mg/dL en enero a 100 mg/dL en junio, mostrando una tendencia descendente positiva.

4.4. Alertas de Valores (MTS-ANA-001-F04)¶

4.4.1. Descripción 3.4¶

Notificaciones cuando valores están fuera de rango.

4.4.2. Comportamiento¶

flowchart TD
    A[Sistema detecta valor fuera de rango normal] --> B[Sistema muestra indicador visual en resultado]
    B --> C[Sistema sugiere mostrar al médico]
    C --> D[No se realizan diagnósticos automáticos]

    style A fill:#FFE4B5
    style D fill:#90EE90

4.4.3. Disclaimer¶

"Los rangos de referencia son orientativos. Consulte siempre con su médico para la interpretación de sus resultados."

4.4.4. Detección de Patrones (Iteración 13)¶

Aspecto	Especificación
Umbral de anomalía	> 1.5 desviaciones estándar del promedio histórico
Período mínimo ML	14 días de datos para detección de patrones
Algoritmo	Detección de outliers + análisis de tendencia
Actualización	Recálculo con cada nuevo resultado

Ejemplo de detección:

Glucosa en ayunas:
- Promedio histórico: 95 mg/dL
- Desviación estándar: 8 mg/dL
- Umbral alto: 95 + (1.5 × 8) = 107 mg/dL
- Valor actual: 112 mg/dL → ALERTA: "Valor significativamente elevado"

Nota: La detección de patrones requiere al menos 14 días de datos históricos para generar alertas estadísticamente significativas.

4.5. Compartir con Médico (MTS-ANA-001-F05)¶

4.5.1. Descripción 3.5¶

Generación de reportes para compartir con profesionales de salud.

4.5.2. Opciones de Compartir¶

Método	Descripción
PDF compilado	Documento con análisis seleccionados
Enlace temporal	URL válida por 24 horas
QR	Código para acceso rápido
Email directo	Enviar al correo del médico

4.6. Exportación para Segunda Opinión (MTS-ANA-001-F06)¶

4.6.1. Descripción 3.6¶

Generación de paquete completo de información médica para obtener segunda opinión de otro profesional de salud.

4.6.2. Disponibilidad¶

Solo disponible para tier Perfect.

4.6.3. Contenido del Paquete¶

Sección	Contenido
Perfil del paciente	Edad, sexo, peso, altura (anonimizado si se desea)
Historial de análisis	Todos los análisis seleccionados con valores
Gráficos de tendencia	Visualización de evolución de parámetros clave
Medicamentos actuales	Lista de medicamentos activos con dosis
Diagnósticos previos	Condiciones médicas registradas
Tratamientos activos	Tratamientos en curso
Notas del paciente	Observaciones adicionales del paciente

4.6.4. Formatos de Exportación¶

Formato	Descripción	Uso
PDF	Documento formateado legible	Envío por email, impresión
JSON	Datos estructurados	Importación en otros sistemas
HL7 FHIR (futuro)	Estándar de interoperabilidad	Sistemas de salud

4.6.5. Opciones de Privacidad¶

Opción	Descripción
Datos completos	Incluye nombre y datos identificables
Anonimizado	Solo edad, sexo y datos clínicos
Selección de datos	Usuario elige qué incluir

4.6.6. Flujo: Exportar para Segunda Opinión¶

flowchart TD
    A[Paciente selecciona 'Exportar para Segunda Opinión'] --> B[Sistema muestra opciones de contenido]
    B --> C[Paciente selecciona contenido]
    C --> D[Análisis a incluir]
    C --> E[Rango de fechas]
    C --> F[Medicamentos actuales]
    C --> G[Nivel de anonimización]
    D --> H[Sistema genera vista previa]
    E --> H
    F --> H
    G --> H
    H --> I[Paciente revisa y confirma]
    I --> J[Sistema genera paquete en formato seleccionado]
    J --> K[Sistema ofrece opciones de descarga/envío]
    K --> L[Descargar archivo]
    K --> M[Enviar por email]
    K --> N[Generar enlace temporal 24h]
    L --> O[Sistema registra exportación en auditoría]
    M --> O
    N --> O

4.6.7. Vista de Exportación¶

+----------------------------------------+
| EXPORTAR PARA SEGUNDA OPINIÓN          |
+----------------------------------------+
| Selecciona qué incluir:                |
|                                        |
| [x] Análisis de sangre (últimos 6 meses)|
| [x] Perfil lipídico completo           |
| [x] Hemoglobina glicosilada            |
| [ ] Estudios de imagen                 |
| [x] Medicamentos actuales              |
| [ ] Historial de citas                 |
|                                        |
| Privacidad:                            |
| (o) Datos completos                    |
| ( ) Anonimizado                        |
|                                        |
| Formato: [PDF v]                       |
|                                        |
| [Vista previa]  [Exportar]             |
+----------------------------------------+

5. Reglas de Negocio¶

ID	Regla
RN-ANA-001	Archivos de análisis se cifran en reposo
RN-ANA-002	Análisis se mantienen indefinidamente
RN-ANA-003	Máximo 50MB por archivo
RN-ANA-004	Sistema NO realiza diagnósticos
RN-ANA-005	Valores fuera de rango solo son indicativos
RN-ANA-006	Enlaces de compartir expiran en 24 horas
RN-ANA-007	Exportación para segunda opinión solo disponible en Perfect
RN-ANA-008	Exportaciones se registran en log de auditoría
RN-ANA-009	Free: Solo almacenamiento local
RN-ANA-010	Pro: OCR con pago adicional, sync cloud
RN-ANA-011	Perfect: OCR incluido, exportación completa

6. Modelo de Datos¶

6.1. Entidad AnalisisClinico¶

erDiagram
    AnalisisClinico {
        UUID id PK
        UUID usuario_id FK
        enum tipo
        string nombre "encrypted"
        date fecha_realizacion
        string laboratorio "encrypted"
        string medico_solicitante "encrypted"
        string archivo_url "encrypted"
        text notas "encrypted"
        timestamp created_at
        timestamp updated_at
    }

6.2. Entidad ResultadoParametro¶

erDiagram
    ResultadoParametro {
        UUID id PK
        UUID analisis_id FK
        string parametro
        decimal valor
        string unidad
        decimal rango_min
        decimal rango_max
        boolean fuera_rango
        timestamp created_at
    }

    AnalisisClinico ||--o{ ResultadoParametro : "tiene"

7. Criterios de Aceptación¶

ID	Criterio
AC-001	Paciente puede subir análisis en PDF, imagen o manual
AC-002	Sistema organiza análisis cronológicamente
AC-003	Paciente puede ver gráficos de tendencia por parámetro (Pro/Perfect)
AC-004	Sistema indica valores fuera de rango sin diagnosticar
AC-005	Paciente puede compartir análisis con enlaces temporales (Pro/Perfect)
AC-006	Archivos se almacenan cifrados
AC-007	Cuidador puede ver análisis con permiso (Pro/Perfect)
AC-008	Perfect puede exportar paquete completo para segunda opinión
AC-009	Exportación permite elegir nivel de anonimización
AC-010	Free funciona 100% offline con almacenamiento local

8. Referencias¶

Documento generado por SpecQueen - La especificación funcional ES el sistema.