Especificacion UI Consolidada - MTS-FHIR-001¶
Identificador: UI-MTS-FHIR-001 Modulo Funcional: MTS-FHIR-001 - Mapeo FHIR R4B Version: 1.0.0 Fecha: 2025-12-05 Autor: MobileUxUiDrone (Eight of Eight) Estado: Completado
1. Resumen Ejecutivo¶
1.1. Alcance¶
Este documento consolida la especificacion completa de interfaz de usuario para el modulo de Mapeo FHIR (MTS-FHIR-001). Define las pantallas para exportar datos en formato HL7 FHIR R4B, visualizar mapeo de recursos y revisar historial de transferencias.
NOTA CRITICA V1.0: MedTime V1.0 implementa SOLO EXPORTACION FHIR. La importacion de datos usa formatos internos (OCR de recetas). Importacion FHIR completa planificada para V2.0.
1.2. Metricas del Modulo¶
| Metrica | Valor |
|---|---|
| Total de pantallas | 4 |
| Componentes unicos | 8 |
| User journeys documentados | 2 |
| Nivel WCAG | AA |
| Cobertura de accesibilidad | 100% |
1.3. Pantallas Incluidas¶
| ID | Nombre | Prioridad | Estado |
|---|---|---|---|
| SCR-FHIR-001 | Exportar FHIR | Critica | Especificado |
| SCR-FHIR-002 | Importar FHIR (V2.0) | Baja | Placeholder |
| SCR-FHIR-003 | Mapeo de Recursos | Media | Especificado |
| SCR-FHIR-004 | Historial de Transferencias | Media | Especificado |
2. User Journeys¶
2.1. Paciente - Exportar Datos para Hospital¶
Persona: Roberto, 55 anos, necesita compartir su historial con hospital.
Objetivo: Exportar datos de medicamentos en formato FHIR para sistema del hospital.
Flujo principal:
- Abrir Configuracion > Exportar Datos
- Seleccionar formato FHIR R4B
- Seleccionar contenido a exportar
- Ver preview del Bundle
- Confirmar exportacion
- Descargar archivo JSON
- Compartir via email o app del hospital
Tiempo objetivo: < 60 segundos
Puntos de friccion mitigados:
- Seleccion simple de contenido
- Preview antes de confirmar
- Multiples opciones de compartir
2.2. Profesional TI - Verificar Mapeo¶
Persona: Ana, ingeniera de integraciones en hospital.
Objetivo: Verificar que el archivo FHIR es valido y tiene todos los recursos.
Flujo principal:
- Recibir archivo FHIR del paciente
- Ver mapeo de recursos en la app
- Validar que Patient, Medication, MedicationStatement estan presentes
- Confirmar estructura FHIR R4B
- Importar al sistema del hospital
Consideraciones:
- Validacion contra perfiles FHIR
- Documentacion de terminologias usadas
3. Especificacion de Pantallas¶
3.1. SCR-FHIR-001: Exportar FHIR¶
3.1.1. Descripcion¶
Pantalla para exportar datos del paciente en formato HL7 FHIR R4B.
3.1.2. Layout¶
+-------------------------------------+
| < Exportar en Formato FHIR |
+-------------------------------------+
| |
| FORMATO |
| +-------------------------------+ |
| | [v] FHIR R4B Bundle (JSON) | |
| | Estandar HL7 actual | |
| +-------------------------------+ |
| | [ ] FHIR R4B Bundle (XML) | |
| | Para sistemas legacy | |
| +-------------------------------+ |
| | [ ] FHIR NDJSON | |
| | Un recurso por linea | |
| +-------------------------------+ |
| |
| RECURSOS A INCLUIR |
| +-------------------------------+ |
| | [check] Patient | |
| | Datos del paciente | |
| +-------------------------------+ |
| | [check] Medication (5) | |
| | Lista de medicamentos | |
| +-------------------------------+ |
| | [check] MedicationStatement | |
| | Historial de tomas | |
| +-------------------------------+ |
| | [check] MedicationRequest (3) | |
| | Prescripciones | |
| +-------------------------------+ |
| | [ ] Practitioner | |
| | Medicos referenciados | |
| +-------------------------------+ |
| |
| PERIODO |
| +-------------------------------+ |
| | Desde: [01/06/2025] [calendar]| |
| | Hasta: [05/12/2025] [calendar]| |
| +-------------------------------+ |
| |
| CIFRADO |
| +-------------------------------+ |
| | [ ] Cifrar archivo (AES-256) | |
| +-------------------------------+ |
| |
| [ Ver Preview ] |
| [ Exportar ] |
| |
+-------------------------------------+
3.1.3. Componentes¶
| Componente | Especificacion |
|---|---|
| Format Selector | Radio group con descripcion |
| Resource Checkbox | Checkbox con badge de cantidad |
| Date Picker | Calendario nativo |
| Preview Button | Secondary button |
| Export Button | Primary button |
3.1.4. Validaciones¶
| Validacion | Mensaje |
|---|---|
| Sin recursos | "Selecciona al menos un recurso" |
| Periodo invalido | "La fecha inicial debe ser anterior" |
| Exportacion vacia | "No hay datos en el periodo" |
3.2. SCR-FHIR-002: Importar FHIR (Placeholder V2.0)¶
3.2.1. Descripcion¶
Funcionalidad futura para importar datos desde archivos FHIR.
3.2.2. Layout Placeholder¶
+-------------------------------------+
| < Importar FHIR |
+-------------------------------------+
| |
| +-------------------------------+ |
| | | |
| | [fhir-icon] | |
| | | |
| | PROXIMAMENTE EN V2.0 | |
| | | |
| | La importacion de archivos | |
| | FHIR estara disponible en | |
| | la proxima version. | |
| | | |
| | Actualmente puedes: | |
| | - Agregar medicamentos | |
| | manualmente | |
| | - Escanear recetas con OCR | |
| | | |
| | [Agregar medicamento] | |
| | [Escanear receta] | |
| | | |
| +-------------------------------+ |
| |
+-------------------------------------+
3.3. SCR-FHIR-003: Mapeo de Recursos¶
3.3.1. Descripcion¶
Vista tecnica del mapeo entre datos MedTime y recursos FHIR.
3.3.2. Layout¶
+-------------------------------------+
| < Mapeo de Recursos FHIR |
+-------------------------------------+
| |
| RECURSOS SOPORTADOS |
| |
| +-------------------------------+ |
| | [v] Patient | |
| | | |
| | Campo MedTime -> FHIR | |
| | nombre -> name.given | |
| | apellidos -> name.family | |
| | fecha_nac -> birthDate | |
| | email -> telecom | |
| | genero -> gender | |
| +-------------------------------+ |
| |
| +-------------------------------+ |
| | [>] Medication | |
| +-------------------------------+ |
| |
| +-------------------------------+ |
| | [>] MedicationRequest | |
| +-------------------------------+ |
| |
| +-------------------------------+ |
| | [>] MedicationStatement | |
| +-------------------------------+ |
| |
| TERMINOLOGIAS UTILIZADAS |
| +-------------------------------+ |
| | SNOMED CT Diagnosticos | |
| | RxNorm Medicamentos US | |
| | LOINC Laboratorios | |
| | UCUM Unidades | |
| +-------------------------------+ |
| |
| [Ver documentacion completa] |
| |
+-------------------------------------+
3.3.3. Accordion de Mapeo¶
| Recurso | Campos Mapeados |
|---|---|
| Patient | nombre, apellidos, fecha_nac, email, telefono, genero, direccion |
| Medication | nombre_comercial, principio_activo, forma, concentracion |
| MedicationRequest | fecha_prescripcion, dosis, frecuencia, via, duracion |
| MedicationStatement | fecha_toma, estado, dosis_real, notas |
3.4. SCR-FHIR-004: Historial de Transferencias¶
3.4.1. Descripcion¶
Registro de todas las exportaciones FHIR realizadas.
3.4.2. Layout¶
+-------------------------------------+
| < Historial de Exportaciones |
+-------------------------------------+
| |
| EXPORTACIONES RECIENTES |
| |
| +-------------------------------+ |
| | 5 Dic 2025 14:30 | |
| | FHIR R4B Bundle (JSON) | |
| | | |
| | Recursos: Patient, Medication,| |
| | MedicationStatement | |
| | Tamano: 125 KB | |
| | | |
| | [Descargar] [Ver detalles] | |
| +-------------------------------+ |
| |
| +-------------------------------+ |
| | 1 Dic 2025 10:15 | |
| | FHIR R4B Bundle (JSON) | |
| | | |
| | Recursos: Patient, Medication | |
| | Tamano: 45 KB | |
| | | |
| | [Descargar] [Ver detalles] | |
| +-------------------------------+ |
| |
| +-------------------------------+ |
| | 15 Nov 2025 09:00 | |
| | FHIR NDJSON | |
| | | |
| | Recursos: MedicationStatement | |
| | Tamano: 89 KB | |
| | | |
| | [Descargar] [Ver detalles] | |
| +-------------------------------+ |
| |
| Mostrando 3 de 7 exportaciones |
| [Cargar mas] |
| |
+-------------------------------------+3.4.3. Informacion por Exportacion¶
| Campo | Descripcion |
|---|---|
| Fecha/hora | Timestamp de exportacion |
| Formato | JSON, XML, NDJSON |
| Recursos | Lista de recursos incluidos |
| Tamano | Tamano del archivo |
| Hash | SHA-256 para verificacion |
| Destino | Donde se compartio (si aplica) |
4. Preview de Exportacion¶
4.1. Layout Preview¶
+-------------------------------------+
| < Preview del Bundle FHIR |
+-------------------------------------+
| |
| RESUMEN |
| +-------------------------------+ |
| | Formato: FHIR R4B Bundle | |
| | Recursos: 12 | |
| | Tamano estimado: 125 KB | |
| +-------------------------------+ |
| |
| RECURSOS INCLUIDOS |
| +-------------------------------+ |
| | 1 x Patient | |
| | 5 x Medication | |
| | 3 x MedicationRequest | |
| | 156 x MedicationStatement | |
| +-------------------------------+ |
| |
| VISTA PREVIA JSON |
| +-------------------------------+ |
| | { | |
| | "resourceType": "Bundle", | |
| | "id": "export-001", | |
| | "type": "document", | |
| | "timestamp": "2025-12...", | |
| | "entry": [ | |
| | { | |
| | "fullUrl": "urn:uuid.. | |
| | ... | |
| +-------------------------------+ |
| [Copiar JSON] |
| |
| [Cancelar] [Confirmar y Exportar] |
| |
+-------------------------------------+5. Componentes Utilizados¶
5.1. Componentes del Design System¶
| Componente | ID | Uso en Modulo |
|---|---|---|
| Top App Bar | CMP-NAV-002 | Headers |
| Radio Group | CMP-INP-004 | Seleccion formato |
| Checkbox | CMP-INP-005 | Seleccion recursos |
| Date Picker | CMP-INP-006 | Periodo |
| Accordion | CMP-DAT-002 | Mapeo de recursos |
| Code Block | CMP-DAT-010 | Preview JSON |
5.2. Componentes Personalizados¶
| Componente | Descripcion |
|---|---|
| ResourceSelector | Checkbox con badge de cantidad |
| FHIRPreview | Visualizador de JSON |
| ExportHistoryCard | Card con info de exportacion |
| MappingAccordion | Accordion con tabla de mapeo |
6. Accesibilidad¶
6.1. Screen Reader Labels¶
| Elemento | Label |
|---|---|
| Selector formato | "Formato de exportacion: [formato]" |
| Checkbox recurso | "[recurso], X elementos" |
| Preview JSON | "Vista previa del archivo FHIR" |
| Boton exportar | "Exportar archivo FHIR" |
6.2. Consideraciones Tecnicas¶
- Codigo JSON con syntax highlighting accesible
- Tablas de mapeo con headers correctos
- Skip links para navegacion rapida
7. Estados de Error¶
7.1. Errores de Exportacion¶
| Error | Mensaje | Accion |
|---|---|---|
| Sin datos | "No hay datos para exportar" | Sugerir ajustar periodo |
| Error generacion | "Error al generar archivo" | Reintentar |
| Sin espacio | "Espacio insuficiente" | Liberar espacio |
8. Metricas de UX¶
8.1. KPIs del Modulo¶
| Metrica | Objetivo |
|---|---|
| Exportaciones exitosas | > 98% |
| Tiempo exportacion | < 10s |
| Uso mensual | Tracking |
8.2. Eventos de Analytics¶
| Evento | Parametros |
|---|---|
| fhir_export_started | format, resources |
| fhir_export_completed | size_kb, duration |
| fhir_export_shared | destination |
| fhir_preview_viewed | - |
| fhir_mapping_viewed | resource |
9. Historial de Cambios¶
| Version | Fecha | Cambios |
|---|---|---|
| 1.0.0 | 2025-12-05 | Version inicial - FASE 4 Platform |
10. Aprobaciones¶
| Rol | Nombre | Estado | Fecha |
|---|---|---|---|
| UX Lead | MobileUxUiDrone | Completado | 2025-12-05 |
| FHIR Specialist | Pendiente | - | - |
| Product Owner | Pendiente | - | - |
Documento generado por MobileUxUiDrone (Eight of Eight) "La interoperabilidad es el futuro de la salud digital. Esta especificacion abre las puertas."