Especificacion UI Consolidada - MTS-PTL-001¶
Identificador: UI-MTS-PTL-001 Modulo Funcional: MTS-PTL-001 - Portal Basico para Medicos 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 Portal de Medicos (MTS-PTL-001). Define las pantallas para que profesionales de salud accedan a perfiles de pacientes mediante codigo temporal o cuenta permanente, incluyendo visualizacion de medicamentos, adherencia y notas clinicas.
NOTA CRITICA V1.0: El portal funciona via web responsivo. Medicos pueden acceder con codigo temporal (6 digitos) o crear cuenta para acceso permanente con aprobacion del paciente.
1.2. Metricas del Modulo¶
| Metrica | Valor |
|---|---|
| Total de pantallas | 10 |
| Componentes unicos | 18 |
| User journeys documentados | 3 |
| Nivel WCAG | AA |
| Cobertura de accesibilidad | 100% |
1.3. Pantallas Incluidas¶
| ID | Nombre | Prioridad | Estado |
|---|---|---|---|
| SCR-PTL-001 | Login Medico | Critica | Especificado |
| SCR-PTL-002 | Dashboard Pacientes | Critica | Especificado |
| SCR-PTL-003 | Detalle Paciente | Critica | Especificado |
| SCR-PTL-004 | Historial Medicamentos | Alta | Especificado |
| SCR-PTL-005 | Adherencia Paciente | Alta | Especificado |
| SCR-PTL-006 | Alertas | Media | Especificado |
| SCR-PTL-007 | Notas Clinicas | Alta | Especificado |
| SCR-PTL-008 | Prescribir (Futuro) | Baja | Especificado |
| SCR-PTL-009 | Configuracion | Media | Especificado |
| SCR-PTL-010 | Ayuda | Baja | Especificado |
2. User Journeys¶
2.1. Medico - Acceso Temporal con Codigo¶
Persona: Dr. Martinez, medico general, consulta presencial con paciente.
Objetivo: Ver medicamentos actuales del paciente durante la consulta.
Flujo principal:
- Paciente genera codigo de 6 digitos en su app
- Dr. Martinez abre portal.medtime.app
- Ingresa codigo de 6 digitos
- Sistema valida codigo (24h vigencia, max 5 usos)
- Ve perfil compartido del paciente
- Revisa medicamentos, dosis, adherencia
- Puede descargar PDF del resumen
- Opcionalmente solicita acceso permanente
Tiempo objetivo: < 30 segundos para ver perfil
Puntos de friccion mitigados:
- Solo 6 digitos, facil de dictar
- No requiere cuenta para acceso temporal
- QR como alternativa al codigo
2.2. Medico - Cuenta Permanente¶
Persona: Dra. Lopez, endocrinologa, seguimiento de pacientes diabeticos.
Objetivo: Monitorear adherencia de sus pacientes regularmente.
Flujo principal:
- Crear cuenta con email y cedula profesional
- Sistema verifica cedula via API CPDP (Mexico)
- Recibe badge de verificacion
- Paciente aprueba solicitud de acceso permanente
- Ve dashboard con todos sus pacientes
- Recibe alertas de baja adherencia
- Agrega notas clinicas por paciente
Tiempo objetivo: < 60 segundos para revisar un paciente
Restricciones:
- Paciente debe aprobar acceso
- Solo ve lo que paciente decidio compartir
- Paciente puede revocar en cualquier momento
2.3. Paciente - Generar Codigo para Medico¶
Persona: Juan, paciente, en consulta medica.
Objetivo: Compartir su informacion de medicamentos con el doctor.
Flujo principal:
- Abrir MedTime app
- Ir a "Compartir con Medico"
- Seleccionar que compartir (meds, adherencia, alergias)
- Generar codigo de 6 digitos
- Mostrar QR o dictar codigo
- Ver notificacion cuando medico accede
- Codigo expira automaticamente
3. Arquitectura de Pantallas¶
3.1. Diagrama de Navegacion (Portal Web)¶
flowchart TD
ENTRY[portal.medtime.app] --> LANDING[Landing Page]
LANDING --> CODE_INPUT[Ingresar Codigo]
LANDING --> LOGIN[SCR-PTL-001]
CODE_INPUT --> TEMP_VIEW[Vista Temporal]
TEMP_VIEW --> REQUEST_PERM[Solicitar Acceso Permanente]
LOGIN --> REGISTER[Registro Medico]
LOGIN --> DASHBOARD[SCR-PTL-002]
REGISTER --> VERIFY_CEDULA[Verificacion CPDP]
VERIFY_CEDULA --> DASHBOARD
DASHBOARD --> PATIENT[SCR-PTL-003]
DASHBOARD --> ALERTS[SCR-PTL-006]
DASHBOARD --> SETTINGS[SCR-PTL-009]
DASHBOARD --> HELP[SCR-PTL-010]
PATIENT --> MEDS[SCR-PTL-004]
PATIENT --> ADHERENCE[SCR-PTL-005]
PATIENT --> NOTES[SCR-PTL-007]
PATIENT --> PRESCRIBE[SCR-PTL-008]4. Especificacion de Pantallas¶
4.1. SCR-PTL-001: Login Medico¶
4.1.1. Descripcion¶
Pantalla de acceso para profesionales de salud con cuenta en el portal.
4.1.2. Layout¶
+------------------------------------------------+
| |
| [MedTime Logo] |
| |
| PORTAL PARA PROFESIONALES DE SALUD |
| |
| +------------------------------------------+ |
| | ACCESO RAPIDO (sin cuenta) | |
| | | |
| | Codigo de paciente | |
| | +------------------------------------+ | |
| | | [ ] [ ] [ ] - [ ] [ ] [ ] | | |
| | +------------------------------------+ | |
| | | |
| | [ Acceder con codigo ] | |
| +------------------------------------------+ |
| |
| ─────────────── o ─────────────── |
| |
| +------------------------------------------+ |
| | ACCESO CON CUENTA | |
| | | |
| | [ Continuar con Google ] | |
| | | |
| | [ Continuar con Apple ] | |
| | | |
| | [ Crear cuenta ] | |
| +------------------------------------------+ |
| |
+------------------------------------------------+
4.1.3. Input de Codigo¶
| Aspecto | Especificacion |
|---|---|
| Campos | 6 celdas individuales |
| Tipo | Numerico |
| Auto-advance | Al llenar, avanza a siguiente |
| Auto-submit | Al completar 6 digitos |
| Formato | XXX-XXX (visual, interno sin guion) |
4.1.4. Validaciones¶
| Validacion | Mensaje |
|---|---|
| Codigo vacio | "Ingresa el codigo de 6 digitos" |
| Codigo invalido | "Codigo no encontrado" |
| Codigo expirado | "Este codigo ha expirado" |
| Visualizaciones agotadas | "Este codigo ya no esta disponible" |
4.2. SCR-PTL-002: Dashboard Pacientes¶
4.2.1. Descripcion¶
Vista principal para medicos con cuenta, mostrando sus pacientes con acceso autorizado.
4.2.2. Layout¶
+------------------------------------------------+
| [Logo] MedTime Portal Dr. Martinez [Logout]|
+------------------------------------------------+
| |
| MIS PACIENTES (5) [Buscar...] |
| |
| +------------------------------------------+ |
| | [avatar] Maria Garcia Lopez | |
| | 45 anos - Diabetes T2, HTA | |
| | Adherencia: 94% | |
| | Ultimo acceso: Hoy 10:30 | |
| +------------------------------------------+ |
| |
| +------------------------------------------+ |
| | [avatar] Juan Perez Sanchez | |
| | 62 anos - Hipertension | |
| | Adherencia: 78% [!] | |
| | Ultimo acceso: Hace 3 dias | |
| +------------------------------------------+ |
| |
| +------------------------------------------+ |
| | [avatar] Ana Rodriguez | |
| | 38 anos - Tiroides | |
| | Adherencia: 100% | |
| | Ultimo acceso: Ayer | |
| +------------------------------------------+ |
| |
| SOLICITUDES PENDIENTES (1) |
| +------------------------------------------+ |
| | [avatar] Carlos Mendez | |
| | Solicito acceso: 5 Dic 2025 | |
| | Estado: Pendiente de aprobacion | |
| +------------------------------------------+ |
| |
+------------------------------------------------+
4.2.3. Componentes del Dashboard¶
| Componente | Descripcion |
|---|---|
| PatientCard | Card con info basica del paciente |
| AdherenceIndicator | Porcentaje con color segun nivel |
| AlertBadge | Indicador de alerta si adherencia baja |
| PendingRequestCard | Solicitud pendiente de aprobacion |
4.2.4. Indicadores de Adherencia¶
| Rango | Color | Indicador |
|---|---|---|
| 90-100% | Verde | Sin badge |
| 70-89% | Amarillo | [!] |
| < 70% | Rojo | [!!] |
4.3. SCR-PTL-003: Detalle Paciente¶
4.3.1. Descripcion¶
Vista completa del perfil compartido por el paciente.
4.3.2. Layout¶
+------------------------------------------------+
| < Volver Maria Garcia Lopez [Descargar]|
+------------------------------------------------+
| |
| +------------------+ +--------------------+ |
| | DATOS BASICOS | | ADHERENCIA 30 DIAS | |
| | | | | |
| | Edad: 45 anos | | 94% | |
| | Sangre: O+ | | [============= ] | |
| | Genero: Femenino | | | |
| +------------------+ +--------------------+ |
| |
| ALERGIAS |
| +------------------------------------------+ |
| | [!] Penicilina (severa) | |
| | [!] Sulfas (moderada) | |
| +------------------------------------------+ |
| |
| CONDICIONES |
| +------------------------------------------+ |
| | Diabetes Mellitus Tipo 2 | |
| | Hipertension Arterial | |
| +------------------------------------------+ |
| |
| MEDICAMENTOS ACTIVOS (4) [Ver historial] |
| +------------------------------------------+ |
| | Metformina 850mg | |
| | 1 tableta cada 12 horas | |
| | Adherencia: 96% | |
| +------------------------------------------+ |
| | Lisinopril 10mg | |
| | 1 tableta cada 24 horas | |
| | Adherencia: 92% | |
| +------------------------------------------+ |
| |
| [ Ver adherencia detallada ] |
| [ Agregar nota clinica ] |
| |
+------------------------------------------------+
4.3.3. Informacion Mostrada (Segun Paciente Autorizo)¶
| Seccion | Siempre Visible | Autorizable |
|---|---|---|
| Nombre y edad | Si | - |
| Tipo de sangre | - | Si |
| Alergias | - | Si |
| Condiciones | - | Si |
| Medicamentos | - | Si |
| Adherencia | - | Si |
| Historial | - | Si (adicional) |
4.4. SCR-PTL-004: Historial Medicamentos¶
4.4.1. Descripcion¶
Vista de todos los medicamentos del paciente, activos e historicos.
4.4.2. Layout¶
+------------------------------------------------+
| < Volver Historial de Medicamentos |
+------------------------------------------------+
| |
| MEDICAMENTOS ACTIVOS (4) |
| |
| +------------------------------------------+ |
| | Metformina 850mg | |
| | Desde: 15 Jun 2024 | |
| | Dosis: 1 tableta cada 12 horas | |
| | Instrucciones: Con alimentos | |
| | | |
| | Prescriptor: Dr. Gomez | |
| | [Ver adherencia] [Ver receta] | |
| +------------------------------------------+ |
| |
| +------------------------------------------+ |
| | Lisinopril 10mg | |
| | Desde: 01 Mar 2024 | |
| | Dosis: 1 tableta cada 24 horas | |
| | Instrucciones: En ayunas | |
| | | |
| | Prescriptor: Dra. Lopez | |
| | [Ver adherencia] [Ver receta] | |
| +------------------------------------------+ |
| |
| MEDICAMENTOS ANTERIORES (3) [v] |
| +------------------------------------------+ |
| | Omeprazol 20mg | |
| | Periodo: Ene - Mar 2024 | |
| | Motivo fin: Tratamiento completado | |
| +------------------------------------------+ |
| |
+------------------------------------------------+4.5. SCR-PTL-005: Adherencia Paciente¶
4.5.1. Descripcion¶
Dashboard de adherencia con graficas y estadisticas detalladas.
4.5.2. Layout¶
+------------------------------------------------+
| < Volver Adherencia - Maria Garcia |
+------------------------------------------------+
| |
| RESUMEN GENERAL |
| +------------------------------------------+ |
| | Ultimos 30 dias 94% | |
| | [================================ ] | |
| | | |
| | Semana actual 89% | |
| | [============================ ] | |
| +------------------------------------------+ |
| |
| CALENDARIO DEL MES |
| +------------------------------------------+ |
| | L M M J V S D | |
| | [G] [G] [G] [A] [G] [G] [G] | |
| | [G] [G] [G] [G] [R] [G] [G] | |
| | [G] [G] [A] [G] [G] [.] [.] | |
| | | |
| | G = 100% A = 50-99% R = <50% | |
| +------------------------------------------+ |
| |
| POR MEDICAMENTO |
| +------------------------------------------+ |
| | Metformina 850mg 96% | |
| | [================================== ] | |
| | | |
| | Lisinopril 10mg 92% | |
| | [================================ ] | |
| | | |
| | Atorvastatina 20mg 88% | |
| | [============================== ] | |
| +------------------------------------------+ |
| |
| TENDENCIA |
| +------------------------------------------+ |
| | [Grafica de linea ultimos 6 meses] | |
| +------------------------------------------+ |
| |
+------------------------------------------------+
4.6. SCR-PTL-006: Alertas¶
4.6.1. Descripcion¶
Centro de alertas para el medico sobre sus pacientes.
4.6.2. Layout¶
+------------------------------------------------+
| < Volver Alertas (3) |
+------------------------------------------------+
| |
| ALERTAS ACTIVAS |
| |
| +------------------------------------------+ |
| | [!] ADHERENCIA BAJA | |
| | | |
| | Juan Perez - 78% esta semana | |
| | Metformina: 3 tomas omitidas | |
| | | |
| | Hace 2 horas | |
| | [Ver paciente] [Descartar] | |
| +------------------------------------------+ |
| |
| +------------------------------------------+ |
| | [info] MEDICAMENTO VENCIDO | |
| | | |
| | Ana Rodriguez | |
| | Levotiroxina vence: 10 Dic 2025 | |
| | | |
| | Hace 1 dia | |
| | [Ver paciente] [Descartar] | |
| +------------------------------------------+ |
| |
| CONFIGURAR ALERTAS |
| +------------------------------------------+ |
| | Alerta si adherencia < [70%] | |
| | Alerta por medicamento vencido [on] | |
| | Notificaciones por email [on] | |
| +------------------------------------------+ |
| |
+------------------------------------------------+
4.7. SCR-PTL-007: Notas Clinicas¶
4.7.1. Descripcion¶
Seccion para que el medico agregue y revise notas sobre el paciente.
4.7.2. Layout¶
+------------------------------------------------+
| < Volver Notas Clinicas - Maria Garcia |
+------------------------------------------------+
| |
| [ + Agregar nota ] |
| |
| +------------------------------------------+ |
| | 5 Dic 2025 - Dr. Martinez | |
| | | |
| | Control de rutina. Glucosa en ayuno | |
| | 115 mg/dL. Buen control. Continuar | |
| | con tratamiento actual. | |
| | | |
| | [Editar] [Eliminar] | |
| +------------------------------------------+ |
| |
| +------------------------------------------+ |
| | 15 Nov 2025 - Dra. Lopez | |
| | | |
| | Ajuste de dosis de Metformina. | |
| | Incrementar a 850mg cada 12 horas. | |
| | Revision en 3 semanas. | |
| | | |
| | [Editar] [Eliminar] | |
| +------------------------------------------+ |
| |
| --- Nueva Nota --- |
| +------------------------------------------+ |
| | | |
| | [textarea] | |
| | | |
| | | |
| +------------------------------------------+ |
| [ ] Visible para el paciente | |
| [Guardar nota] | |
| |
+------------------------------------------------+
4.8. SCR-PTL-008: Prescribir (Futuro V2.0)¶
4.8.1. Descripcion¶
Funcionalidad futura para emitir prescripciones digitales.
4.8.2. Layout Placeholder¶
+------------------------------------------------+
| < Volver Prescribir |
+------------------------------------------------+
| |
| +------------------------------------------+ |
| | | |
| | [prescription-icon] | |
| | | |
| | PROXIMAMENTE EN V2.0 | |
| | | |
| | La funcionalidad de prescripcion | |
| | digital estara disponible en la | |
| | proxima version del portal. | |
| | | |
| | [Notificarme cuando este disponible] | |
| | | |
| +------------------------------------------+ |
| |
+------------------------------------------------+
4.9. SCR-PTL-009: Configuracion¶
4.9.1. Descripcion¶
Configuracion del perfil del medico y preferencias del portal.
4.9.2. Layout¶
+------------------------------------------------+
| < Volver Configuracion |
+------------------------------------------------+
| |
| MI PERFIL |
| +------------------------------------------+ |
| | Nombre: Dr. Juan Martinez | |
| | Email: martinez@email.com | |
| | Especialidad: Medicina General | |
| | Cedula: 12345678 | |
| | [check] CPDP Verificado | |
| | | |
| | [Editar perfil] | |
| +------------------------------------------+ |
| |
| NOTIFICACIONES |
| +------------------------------------------+ |
| | Email por alertas [on] | |
| | Resumen semanal [off] | |
| | Solicitudes de acceso [on] | |
| +------------------------------------------+ |
| |
| SEGURIDAD |
| +------------------------------------------+ |
| | Sesion activa: Este dispositivo | |
| | Inicio: 5 Dic 2025 09:00 | |
| | | |
| | [Cerrar todas las sesiones] | |
| +------------------------------------------+ |
| |
| CUENTA |
| +------------------------------------------+ |
| | [Eliminar cuenta] | |
| +------------------------------------------+ |
| |
+------------------------------------------------+4.10. SCR-PTL-010: Ayuda¶
4.10.1. Descripcion¶
Centro de ayuda con FAQs y contacto de soporte.
4.10.2. Layout¶
+------------------------------------------------+
| < Volver Ayuda |
+------------------------------------------------+
| |
| PREGUNTAS FRECUENTES |
| |
| +------------------------------------------+ |
| | [v] Como accedo a un perfil de paciente? | |
| | | |
| | El paciente debe generar un codigo de 6 | |
| | digitos desde su app MedTime y | |
| | compartirlo contigo... | |
| +------------------------------------------+ |
| |
| +------------------------------------------+ |
| | [>] Como solicito acceso permanente? | |
| +------------------------------------------+ |
| |
| +------------------------------------------+ |
| | [>] Que es la verificacion CPDP? | |
| +------------------------------------------+ |
| |
| +------------------------------------------+ |
| | [>] Como veo el historial de adherencia? | |
| +------------------------------------------+ |
| |
| CONTACTO |
| +------------------------------------------+ |
| | Email: soporte@medtime.app | |
| | Horario: Lun-Vie 9:00-18:00 | |
| | | |
| | [Enviar mensaje de soporte] | |
| +------------------------------------------+ |
| |
+------------------------------------------------+
5. Componentes del Portal Web¶
5.1. Header¶
| Elemento | Especificacion |
|---|---|
| Logo | MedTime logo, link a dashboard |
| Nombre medico | Nombre + badge de verificacion |
| Menu | Dropdown con settings, ayuda, logout |
5.2. Cards de Paciente¶
| Variante | Uso |
|---|---|
| PatientCard | Lista en dashboard |
| PatientDetailCard | Detalle expandido |
| MedicationCard | Info de medicamento |
| NoteCard | Nota clinica |
| AlertCard | Alerta con accion |
5.3. Indicadores¶
| Indicador | Visualizacion |
|---|---|
| AdherenceBar | Barra de progreso con color |
| CalendarGrid | Grid de dias con colores |
| TrendChart | Grafica de linea |
| VerificationBadge | Check azul para CPDP |
6. Responsive Design¶
6.1. Breakpoints¶
| Ancho | Layout |
|---|---|
| < 600px | Mobile: Stack vertical |
| 600-1024px | Tablet: Cards 2 columnas |
| > 1024px | Desktop: Sidebar + content |
6.2. Adaptaciones¶
| Pantalla | Mobile | Desktop |
|---|---|---|
| Dashboard | Cards stack | Cards grid |
| Detalle | Tabs | Side-by-side |
| Notas | Full width | Split view |
7. Seguridad UI¶
7.1. Protecciones¶
| Aspecto | Implementacion |
|---|---|
| Session timeout | 30 min inactividad |
| Rate limiting | 5 intentos codigo/IP/15min |
| HTTPS | Obligatorio |
| Content Security Policy | Configurado |
7.2. Indicadores de Verificacion¶
| Badge | Significado |
|---|---|
| Sin badge | Email verificado |
| Check azul | Cedula validada formato |
| Doble check azul | CPDP verificado via API |
8. Accesibilidad¶
8.1. WCAG AA Compliance¶
| Criterio | Estado |
|---|---|
| Contraste texto | 4.5:1 minimo |
| Focus visible | 2dp outline primary |
| Screen reader | Labels completos |
| Navegacion teclado | Completa |
8.2. Consideraciones Especiales¶
- Tablas con headers correctos
- Graficas con alt text descriptivo
- Colores nunca como unico indicador
9. Metricas de UX¶
9.1. KPIs del Modulo¶
| Metrica | Objetivo |
|---|---|
| Tiempo acceso temporal | < 30s |
| Conversion a cuenta | > 20% |
| Satisfaccion medicos | > 4.2/5 |
9.2. Eventos de Analytics¶
| Evento | Parametros |
|---|---|
| portal_code_entered | valid, expired |
| portal_profile_viewed | sections_viewed |
| portal_pdf_downloaded | patient_id |
| portal_note_added | word_count |
| portal_permanent_requested | approved |
10. Historial de Cambios¶
| Version | Fecha | Cambios |
|---|---|---|
| 1.0.0 | 2025-12-05 | Version inicial - FASE 4 Platform |
11. Aprobaciones¶
| Rol | Nombre | Estado | Fecha |
|---|---|---|---|
| UX Lead | MobileUxUiDrone | Completado | 2025-12-05 |
| Medical Advisor | Pendiente | - | - |
| Product Owner | Pendiente | - | - |
Documento generado por MobileUxUiDrone (Eight of Eight) "El puente entre paciente y medico debe ser transparente y seguro. Esta especificacion lo garantiza."