Saltar a contenido

Pantallas del MVP

Catálogo de las pantallas que deben existir en el MVP objetivo, limitado a funciones vigentes. Para cada pantalla se describe el propósito, los elementos visibles y el resultado esperado; el detalle funcional vive en los documentos por flujo (prealerta.md, kyc.md, consolidacion-pago.md, servicios.md, incidencias-reclamos.md).

Las funciones de Fase 2 (referidos, crédito, tarjetas, WhatsApp, OCR, tracking automático) no se incluyen aquí. Se referencian únicamente en producto/matriz-funcionalidad-fase.md y roadmap/fase-2.md.

Convenciones

1. Registro / bienvenida

  • Ruta: Welcome, Login, Register.
  • Propósito: entrada a la app. Decidir entre login real y demo (D-200) y recordar al usuario que solo se registran personas radicadas en EE.UU. (D-101).
  • Resultado esperado: usuario autenticado y llevado al dashboard con tutorial mostrado una sola vez.

2. Dashboard / inicio

  • Ruta: Main → Dashboard.Inicio.
  • Propósito: resolver la tarea más frecuente en menos de 5 segundos (copiar dirección del casillero) y ofrecer el resumen de actividad.
  • Elementos MVP:
  • Saludo, identificador CP-XXXXXX-D.
  • Dirección del casillero y CTA "Copiar" (todo y por campos).
  • Acceso directo a tutoriales Amazon/SHEIN/Temu.
  • Resumen de paquetes en 4 categorías: en camino al almacén, en almacén, en tránsito, entregados.
  • Sección "Requiere tu atención" cuando aplique.
  • Resultado esperado: el usuario copió su dirección o consultó el siguiente paso.

3. Casillero virtual (dirección copiable)

  • Ruta: Dashboard.Inicio → sección dedicada.
  • Propósito: entregar la dirección física del casillero en Miami + identificador al usuario, con tutorial por plataforma.
  • Resultado esperado: dirección copiada al portapapeles y (opcional) lectura de un tutorial paso a paso.

4. Prealerta (reportar compra)

  • Documento principal: prealerta.md.
  • Ruta: Dashboard.Reportes → ReporteForm.
  • Resultado esperado: reporte canónico creado (reportada o reportada_sin_tracking), persistido en sesión, con ID demo y CTA "Añadir tracking después".

5. Paquetes / detalle

  • Ruta: Dashboard.Paquetes y ReporteDetalle.
  • Elementos MVP: foto, tienda, orden, tracking, fecha de recepción, peso, dimensiones, estado del embalaje, días en almacén, días gratis restantes, cargo acumulado, timeline.
  • Acciones MVP: "Añadir tracking", "Solicitar inspección", "Solicitar reempaque", "Solicitar devolución", "Reportar incidencia", "Agregar a consolidación".
  • Resultado esperado: el usuario ve el detalle o inicia la acción correspondiente con destino ejecutable.

6. KYC (verificación de identidad)

  • Documento principal: kyc.md.
  • Ruta: flujo KycWelcome → … → KycSubmitted (+ KycBlocked cuando aplique).
  • Resultado esperado: estado canónico SUBMITTED persistido en CurrentUser, dashboard refleja el estado y el gate central impide consolidar/pagar/despachar hasta APPROVED.

7. Consolidación

  • Documento principal: consolidacion-pago.md.
  • Ruta: ConsolidationList → ConsolidationCreate → ConsolidationSummary → ConsolidationDetail.
  • Resultado esperado: consolidación creada con desglose único, estado canónico cotizada, ID demo persistido y CTA hacia pago.

8. Pago (MVP manual)

  • Ruta: Payment(quoteId) → Invoice(invoiceId).
  • Resultado esperado: instrucciones del canal aprobado, comprobante opcional y estado canónico pago_enviado_para_validacion hasta que el operador confirme.
  • No MVP: tarjeta, crédito, saldo, pago dividido.

9. Envíos y tracking

  • Ruta: ShipmentDetail(shipmentId).
  • Elementos MVP: estado actual, timeline de eventos reales, fecha estimada, acceso a "Reportar incidencia".

10. Servicios adicionales

  • Documento principal: servicios.md.
  • Ruta: ReporteDetalle → RequestInspection / RequestRepack / RequestReturn; listado en ServiceRequestsList cuando esté enrutada.
  • Resultado esperado: solicitud creada con estado canónico solicitado y persistencia de sesión.

11. Incidencias y reclamos

  • Documento principal: incidencias-reclamos.md.
  • Resultado esperado: caso creado con estado abierta y notificación al operador.

12. Notificaciones

  • Ruta: Notifications.
  • Elementos MVP: push por eventos críticos (D-113), historial en app, indicador de no leídas, deep link a la entidad correspondiente.
  • No MVP: referidos / crédito / tarjetas / WhatsApp.

13. Tutoriales por plataforma

  • Ruta: Tutorials → TutorialDetail → TutorialWizard.
  • Elementos MVP: Amazon, SHEIN, Temu. Cada uno explica dónde colocar el identificador y cómo validar antes de pagar.

14. Perfil, contactos y ayuda

  • Ruta: Dashboard.Perfil → EditProfile / Contactos / AduanaInfo.
  • Elementos MVP: edición básica del perfil, gestión de destinatarios en Cuba (+53, 8 dígitos) y remitentes en EE.UU. (+1, 10 dígitos), ayuda de aduana (Res. 175/2022 administrable).

Cambios frente a la versión 2026-06-07

  • Se quitaron menciones a referidos, crédito, tarjetas, WhatsApp, OCR y tracking automático porque pertenecen a Fase 2.
  • Se añadió referencia explícita al gate KYC y al estado reportada_sin_tracking.
  • Se eliminó la promesa "revisión en 24 horas" como SLA contractual (D-114).
  • Se incorporaron los estados UI obligatorios y enlaces al microcopy canónico.