Flujo de Navegacion - Catalogo de Medicamentos¶

Identificador: UIF-CAT-001 Modulo: MTS-CAT-001 - Catalogo de Medicamentos Version: 1.0.0 Fecha: 2025-12-05 Autor: MobileUxUiDrone (Eight of Eight) FASE: 2 - Value

1. Resumen del Flujo¶

Este documento especifica el flujo de navegacion para el modulo de Catalogo de Medicamentos, que proporciona busqueda y seleccion de medicamentos desde la base de datos central de MedTime.

PRINCIPIO FUNDAMENTAL - SIN CACHE LOCAL (RN-CAT-001): Las busquedas del catalogo requieren conexion a internet. Los medicamentos del usuario (MedicamentoPaciente) se almacenan localmente y funcionan 100% offline.

1.1. Pantallas del Modulo¶

ID	Nombre	Proposito	Prioridad
SCR-CAT-001	Busqueda con Autocomplete	Busqueda principal de medicamentos	Alta
SCR-CAT-002	Resultados de Busqueda	Lista de medicamentos encontrados	Alta
SCR-CAT-003	Detalle de Medicamento	Ficha tecnica completa	Alta
SCR-CAT-004	Filtros Avanzados	Refinamiento de busqueda	Media
SCR-CAT-005	Medicamentos Recientes	Historial de busquedas	Media
SCR-CAT-006	Escaneo Codigo de Barras	Busqueda por codigo EAN/UPC	Media

2. Diagrama de Flujo Principal¶

flowchart TD
    subgraph Entry["Puntos de Entrada"]
        ADDMED[Agregar Medicamento]
        RECETA[Wizard de Recetas]
        SEARCH[Tab Buscar]
        DEEPLINK[Deep Link]
    end

    subgraph MainFlow["Flujo Principal"]
        BUSQUEDA[SCR-CAT-001<br/>Busqueda]
        RESULTS[SCR-CAT-002<br/>Resultados]
        DETALLE[SCR-CAT-003<br/>Detalle]
    end

    subgraph FilterFlow["Flujo de Filtros"]
        FILTERS[SCR-CAT-004<br/>Filtros Avanzados]
    end

    subgraph HistoryFlow["Flujo de Historial"]
        RECIENTES[SCR-CAT-005<br/>Recientes]
    end

    subgraph ScanFlow["Flujo de Escaneo"]
        SCAN[SCR-CAT-006<br/>Escanear Codigo]
    end

    %% Entry Points
    ADDMED --> BUSQUEDA
    RECETA --> BUSQUEDA
    SEARCH --> BUSQUEDA
    DEEPLINK --> DETALLE

    %% Main Navigation
    BUSQUEDA -->|Escribir texto| RESULTS
    BUSQUEDA -->|Tap reciente| DETALLE
    BUSQUEDA -->|Tap escanear| SCAN

    RESULTS -->|Tap medicamento| DETALLE
    RESULTS -->|Tap filtrar| FILTERS

    DETALLE -->|Seleccionar| SELECT[Seleccion confirmada]
    DETALLE -->|Back| RESULTS

    FILTERS -->|Aplicar| RESULTS
    FILTERS -->|Limpiar| RESULTS

    BUSQUEDA -->|Ver recientes| RECIENTES
    RECIENTES -->|Tap item| DETALLE

    SCAN -->|Codigo detectado| DETALLE
    SCAN -->|No encontrado| CUSTOM[Agregar personalizado]

    SELECT --> EXIT[Retornar a origen]

    %% Styling
    classDef entry fill:#E3F2FD,stroke:#1976D2
    classDef main fill:#E8F5E9,stroke:#388E3C
    classDef filter fill:#FFF3E0,stroke:#F57C00
    classDef history fill:#F3E5F5,stroke:#7B1FA2
    classDef scan fill:#E0F7FA,stroke:#00ACC1

    class ADDMED,RECETA,SEARCH,DEEPLINK entry
    class BUSQUEDA,RESULTS,DETALLE main
    class FILTERS filter
    class RECIENTES history
    class SCAN scan

3. User Journey¶

3.1. Paciente Independiente (PI) - Buscar Medicamento en Catalogo¶

Persona: Maria, 45 anos, quiere agregar un nuevo medicamento a su tratamiento.

journey
    title Maria busca un medicamento
    section Inicio
      Abre agregar medicamento: 5: Maria
      Ve pantalla de busqueda: 5: Maria
    section Busqueda
      Escribe nombre del medicamento: 4: Maria
      Ve sugerencias en tiempo real: 5: Maria
      Selecciona medicamento correcto: 5: Maria
    section Detalle
      Revisa ficha tecnica: 4: Maria
      Confirma que es el correcto: 5: Maria
      Selecciona para agregar: 5: Maria
    section Resultado
      Ve medicamento en su lista: 5: Maria

3.1.1. Pasos Detallados¶

Paso	Pantalla	Accion	Siguiente	Notas UX
1	SCR-MED-001	Tap "Agregar medicamento"	SCR-CAT-001	FAB o boton
2	SCR-CAT-001	Ve pantalla de busqueda	-	Focus en input
3	SCR-CAT-001	Escribe >= 3 caracteres	-	Autocomplete activo
4	SCR-CAT-001	Ve sugerencias en tiempo real	-	Debounce 300ms
5	SCR-CAT-002	Lista de resultados	-	Ordenados por relevancia
6	SCR-CAT-002	Tap en medicamento	SCR-CAT-003	Card con info basica
7	SCR-CAT-003	Revisa ficha tecnica	-	Datos completos
8	SCR-CAT-003	Tap "Agregar"	SCR-MED-002	Flujo de agregar

3.2. Paciente Independiente (PI) - Medicamento No Encontrado¶

Persona: Carlos, 52 anos, busca un medicamento que no esta en el catalogo.

journey
    title Carlos agrega medicamento personalizado
    section Busqueda
      Busca medicamento regional: 3: Carlos
      No encuentra resultados: 2: Carlos
      Ve mensaje de no encontrado: 3: Carlos
    section Alternativas
      Revisa sugerencias fuzzy: 3: Carlos
      Ninguna es correcta: 2: Carlos
      Tap agregar personalizado: 4: Carlos
    section Creacion
      Ingresa datos manualmente: 4: Carlos
      Toma foto del empaque: 5: Carlos
      Guarda medicamento: 5: Carlos
    section Validacion
      Recibe notificacion de revision: 4: Carlos
      Medicamento aprobado al catalogo: 5: Carlos

4. Arquitectura de Navegacion¶

4.1. Acceso al Modulo¶

Punto de Entrada	Ruta	Contexto
Agregar Medicamento	MTS-MED-001 > Agregar	Flujo principal
Wizard de Recetas	MTS-REC-001 > Buscar	Digitalizacion OCR
Tab Buscar	Bottom nav	Acceso directo
Deep Link	medtime://catalog/{id}	Desde notificacion

4.2. Deep Links¶

Deep Link	Destino	Parametros
`medtime://catalog/search`	SCR-CAT-001	query?
`medtime://catalog/search?q={term}`	SCR-CAT-002	term
`medtime://catalog/medication/{id}`	SCR-CAT-003	medication_id
`medtime://catalog/scan`	SCR-CAT-006	-

5. Transiciones y Animaciones¶

5.1. Transiciones Entre Pantallas¶

De	A	Tipo	Duracion
BUSQUEDA	RESULTS	Fade in lista	200ms
RESULTS	DETALLE	Shared element (card)	300ms
BUSQUEDA	SCAN	Modal full screen	300ms
BUSQUEDA	FILTERS	Slide up	300ms
FILTERS	RESULTS	Slide down + refresh	300ms

5.2. Animaciones Especificas¶

Elemento	Animacion	Trigger
Autocomplete items	Stagger fade in	onResults
Skeleton loading	Shimmer	onLoading
No results	Scale in	onEmpty
Scan viewfinder	Pulse	onActive
Filter chips	Chip appear	onSelect

6. Estados del Sistema¶

6.1. Estados de Conectividad¶

Estado	Funcionalidades	Indicador UI
Online	Busqueda completa	Sin indicador
Offline	Solo recientes y personalizados	Banner "Sin conexion"
Lento	Busqueda con timeout extendido	Spinner prolongado

6.2. Estados de Busqueda¶

Estado	Condicion	Pantalla
Inicial	Sin texto	Recientes + sugerencias
Buscando	>= 3 caracteres	Skeleton loading
Resultados	Matches encontrados	Lista de resultados
Sin resultados	0 matches	Estado vacio + fuzzy
Error	Fallo de red	Retry + offline mode

7. Integracion con Otros Modulos¶

7.1. MTS-MED-001 (Medicamentos)¶

Seleccion de medicamento retorna a flujo de agregar
Datos del catalogo enriquecen MedicamentoPaciente
Referencia por ID de catalogo

7.2. MTS-REC-001 (Recetas)¶

Wizard de recetas invoca busqueda durante OCR
Busqueda automatica de medicamentos detectados
Seleccion rapida desde resultados

7.3. MTS-INT-001 (Interacciones)¶

Detalle muestra interacciones conocidas
Alerta si hay interacciones con medicamentos actuales
Link a detalle de interaccion

8. Metricas de UX¶

8.1. KPIs del Flujo¶

Metrica	Objetivo	Medicion
Tiempo busqueda a seleccion	< 30s	analytics
Tasa exito busqueda	> 85%	analytics
Uso de escaneo codigo	> 10%	analytics
Medicamentos personalizados creados	< 5%	analytics

9. Referencias¶

Documento generado por MobileUxUiDrone (Eight of Eight) "Encontrar el medicamento correcto debe ser tan simple como buscarlo."