Documento histórico

Este documento se conserva solo para trazabilidad. Consulte el índice maestro para la fuente vigente.

Documento histórico — no usar como fuente de decisiones actuales

Reemplazado por la versión canónica del 2026-07-11. Conservar solo como trazabilidad histórica.

CU-004: Consultar dashboard principal¶

Caso de uso detallado para la pantalla principal (Dashboard/Inicio) del usuario.

Metadatos¶

Campo	Valor
ID	CU-004
Nombre	Consultar dashboard principal
Actor primario	Usuario Final
Módulo	Autenticación y registro
Prioridad	Alta (MVP)
Frecuencia esperada	Muy alta (cada apertura de la app)
Trazabilidad SRS	RF-008, RF-009, RF-010, RF-011, RF-012

Descripción¶

Al abrir la app (o tocar el tab Inicio), el usuario ve su dashboard: saludo personalizado, identificador de casillero, dirección copiable, accesos rápidos a tutoriales, resumen de paquetes, sección "Requiere tu atención" (si aplica) y banner de reporte.

Precondiciones¶

El usuario tiene una sesión activa y está autenticado.
El usuario se encuentra en la pantalla Dashboard (accedida desde la bottom nav o como destino post-login).

Postcondiciones¶

El usuario visualiza la información consolidada de su cuenta.
Si copia la dirección, queda en el portapapeles del dispositivo.
Si toca una acción, navega a la pantalla correspondiente.

Flujo principal¶

El usuario abre la app o toca el tab Inicio en la bottom nav.
El sistema carga el dashboard con la siguiente información:
Saludo: "Hola, {nombre}" (con avatar o iniciales)
Identificador del casillero: CP-NNNNNN-D con badge "Activo" y botón para copiar
Sección "Tu dirección en Miami":
- Línea 1: "1940 NW 70th Ave"
- Línea 2: "{CP-NNNNNN-D}"
- Ciudad/Estado/ZIP: "Miami, FL 33126"
- Teléfono: "+1 (786) 651-0451"
- Botón Copiar todo (con icono de portapapeles)
- Cada campo con su propio botón Copiar
Selector de plataforma: pestañas Amazon / SHEIN / Temu (alterna qué campo es Line 2)
Tarjetas de resumen (4):
- Compras en camino al almacén: {n}
- Paquetes en almacén: {n}
- Envíos hacia Cuba: {n}
- Entregados: {n}
Banner "¿Compraste algo nuevo?" con CTA Reportar compra (FAB visible también)
Accesos rápidos a tutoriales (Amazon, SHEIN, Temu) con icono
Sección "Requiere tu atención" (solo si hay elementos)
Icono de notificaciones (campana) con badge rojo si hay no leídas
El usuario puede:
Tocar el identificador → copia
Tocar Copiar todo → copia dirección completa
Tocar cualquier campo individualmente → copia
Cambiar de pestaña (Amazon/SHEIN/Temu) → ajusta el campo Line 2
Tocar Reportar compra → navega a ReporteForm (CU-005)
Tocar una tarjeta de resumen → navega al listado filtrado
Tocar un tutorial → navega a la pantalla del tutorial
Tocar un ítem de "Requiere tu atención" → navega al detalle correspondiente
Tocar la campana → navega al historial de notificaciones (CU-025)
Tocar la FAB (+) → navega a ReporteForm

Flujos alternativos¶

FA-1: KYC no aprobado¶

Si el usuario tiene KYC en estado sin_iniciar, rechazado, requiere_mas_informacion o vencido:
Se muestra un banner amarillo en la parte superior: "Verificación pendiente — completa tu identidad para despachar."
Con CTA Iniciar verificación / Corregir y reenviar / Renuevar

FA-2: Sin paquetes¶

Si el contador total de paquetes es 0:
Las tarjetas muestran "0" pero siguen visibles
El banner "¿Compraste algo nuevo?" se muestra con CTA más prominente

FA-3: Notificaciones no leídas¶

Si hay notificaciones no leídas:
Badge rojo sobre la campana con el número
Al tocar la campana, navega a la pantalla de notificaciones

FA-4: Almacenaje por vencer¶

Si hay algún paquete próximo a vencer el período gratuito (≤ 3 días):
Aparece un ítem en "Requiere tu atención": "Tu paquete {tracking} vence en {n} días. Confirma qué hacer."

FA-5: Pago pendiente¶

Si hay una consolidación o envío en estado pendiente_pago:
Aparece un ítem en "Requiere tu atención": "Tienes un pago pendiente de ${monto}."

FA-6: KYC rechazado¶

Si el KYC está rechazado:
Aparece un ítem en "Requiere tu atención": "Tu verificación fue rechazada. Corrige y reenvía."

FA-7: Aduana con información requerida¶

Si el operador marcó un envío como incidencia y necesita info del usuario:
Aparece un ítem en "Requiere tu atención": "Aduana necesita información sobre tu envío {guía}."

Estructura visual del dashboard¶

┌────────────────────────────────────────┐
│  Hola, {nombre}                    🔔  │  ← Top bar con campana
├────────────────────────────────────────┤
│  CP-001042-8  [Activo]   📋 Copiar    │  ← Identificador
├────────────────────────────────────────┤
│  Tu dirección en Miami                 │
│  ┌──────────────────────────────────┐  │
│  │ [Amazon] [SHEIN] [Temu]         │  │  ← Selector
│  ├──────────────────────────────────┤  │
│  │ 1940 NW 70th Ave        📋      │  │
│  │ CP-001042-8              📋      │  │  ← Line 2 (cambia con selector)
│  │ Miami, FL 33126          📋      │  │
│  │ +1 (786) 651-0451        📋      │  │
│  │ [📋 Copiar todo]                 │  │
│  └──────────────────────────────────┘  │
├────────────────────────────────────────┤
│  📦 Compras en camino      →          │  ← Tarjeta 1
│  🏭 En almacén             →          │  ← Tarjeta 2
│  ✈️ En tránsito a Cuba     →          │  ← Tarjeta 3
│  ✅ Entregados             →          │  ← Tarjeta 4
├────────────────────────────────────────┤
│  [+ Reportar compra] (banner)         │
├────────────────────────────────────────┤
│  Tutoriales                            │
│  [Amazon] [SHEIN] [Temu]              │
├────────────────────────────────────────┤
│  Requiere tu atención (condicional)   │
│  • KYC rechazado                       │
│  • Almacenaje por vencer               │
│  • Pago pendiente                      │
└────────────────────────────────────────┘
                              [+] FAB

Excepciones¶

Excepción	Causa	Manejo
`LOAD_PACKAGE_SUMMARY_FAILED`	Error al calcular contadores	Mostrar skeletons + retry
`LOAD_NOTIFICATIONS_COUNT_FAILED`	Error al contar notificaciones	Badge oculto, no afecta funcionalidad

Reglas de negocio aplicables¶

RN-9 (Resumen paquetes): 4 contadores fijos: en camino, en almacén, en tránsito, entregados. Ver pantallas-mvp.md.
RN-10 (Requiere tu atención): solo visible si hay elementos. Ver pantallas-mvp.md.

Criterios de aceptación¶

El dashboard carga en < 2 segundos en condiciones normales.
El identificador se muestra siempre con badge "Activo".
El botón Copiar todo copia la dirección completa al portapapeles.
El selector de plataforma alterna correctamente el campo Line 2.
La sección "Requiere tu atención" solo aparece si hay elementos.
El badge de notificaciones refleja el número correcto de no leídas.
Las tarjetas de resumen muestran el conteo actualizado en tiempo real (al volver de una pantalla de detalle).

Diagrama de actividad¶

flowchart TD
    A["Abre la app / Tab Inicio"] --> B["Carga datos del usuario"]
    B --> C["Carga resumen de paquetes"]
    C --> D["Carga contadores de notificaciones"]
    D --> E["Renderiza Dashboard"]
    E --> F{"¿Acción del usuario?"}
    F -- "Toca campana" --> G["Pantalla Notificaciones"]
    F -- "Toca Reportar" --> H["ReporteForm CU-005"]
    F -- "Toca tarjeta" --> I["Listado filtrado"]
    F -- "Toca tutorial" --> J["Pantalla Tutorial"]
    F -- "Toca atención" --> K["Detalle correspondiente"]
    F -- "Copia dirección" --> L["Toast 'Copiado'"]

Pruebas asociadas¶

PT-040: Carga del dashboard
PT-041: Copia de dirección completa
PT-042: Copia de campo individual
PT-043: Cambio de pestaña Amazon/SHEIN/Temu
PT-044: Visibilidad de "Requiere tu atención" condicional
PT-045: Badge de notificaciones correcto
PT-046: Navegación desde tarjetas de resumen
PT-047: Visibilidad de banner KYC
PT-048: FAB navega a ReporteForm