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.
Catálogo de casos de uso¶
Índice maestro de todos los casos de uso del sistema IslaBox, agrupados por actor y módulo. Cada entrada referencia el documento detallado del caso de uso.
Numeración consolidada — 2026-06-08
Esta es la numeración oficial única de casos de uso. Cualquier referencia en otros documentos (SRS, matriz de trazabilidad, plan de pruebas, API contract, código) debe coincidir con estos IDs.
Regla: un caso de uso tiene su ID cuando tiene un documento detallado .md propio. Los sub-flujos que son parte de otro CU (ej. "actualizar tracking" como parte de CU-005) no ocupan un ID separado: se referencian como flujos alternativos del CU padre y aparecen en este catálogo con un ID del rango CU-022+.
Convenciones¶
- CU-XXX: identificador único del caso de uso
- Actor: usuario o sistema externo que interactúa con el sistema
- Módulo: agrupación funcional
- Prioridad: Alta (MVP), Media (Fase 2), Baja (Fase 3+)
Actores¶
| Actor | Tipo | Descripción |
|---|---|---|
| Usuario Final (UF) | Primario | Persona radicada en EE.UU. que se registra y opera la app |
| Destinatario (DE) | Secundario | Persona en Cuba que recibe el paquete (no interactúa con el sistema) |
| Remitente (RE) | Secundario | Persona en EE.UU. que entrega el paquete al casillero (no se registra) |
| Operador (OP) | Primario | Personal interno de IslaBox que opera el backoffice |
| Administrador (AD) | Primario | Personal interno con permisos de configuración |
| Sistema de Agencia (SA) | Externo | API confirmada (webhook/consulta) para actualizar el estado del envío. Contrato pendiente de firma (ver preguntas.md). |
| Transportista (TR) | Externo | APIs de UPS/USPS/FedEx/DHL (Fase 2) |
| Stripe (ST) | Externo | Pasarela de pago elegida. Integración vía Stripe Checkout + Webhooks (Fase 2) |
| Servicio de Notificaciones (SN) | Externo | FCM, APNS, SMTP (MVP solo push básico) |
Módulo 1: Autenticación y registro¶
| CU | Nombre | Actor(es) | Prioridad | Documento |
|---|---|---|---|---|
| CU-001 | Registrarse en la app | UF | Alta | cu-001-registro.md |
| CU-002 | Iniciar sesión / Recuperar contraseña | UF | Alta | cu-002-login.md |
| CU-003 | Gestionar perfil personal | UF | Alta | cu-003-gestionar-perfil.md |
| CU-004 | Consultar dashboard principal | UF | Alta | cu-004-dashboard.md |
Módulo 2: Prealerta (reporte de compra)¶
| CU | Nombre | Actor(es) | Prioridad | Documento |
|---|---|---|---|---|
| CU-005 | Reportar una compra (prealerta) | UF | Alta | cu-005-reportar-compra.md |
| CU-022 | Actualizar tracking de prealerta (sub-flujo) | UF | Alta | Parte de CU-005 |
| CU-023 | Cancelar prealerta (sub-flujo) | UF | Alta | Parte de CU-005 |
Módulo 3: Paquetes y envíos¶
| CU | Nombre | Actor(es) | Prioridad | Documento |
|---|---|---|---|---|
| CU-006 | Consultar detalle de un paquete | UF | Alta | cu-006-consultar-paquete.md |
| CU-007 | Consolidar paquetes para envío | UF | Alta | cu-007-consolidar.md |
| CU-008 | Pagar y despachar envío | UF, OP | Alta | cu-008-pagar-envio.md |
Módulo 4: Operación de almacén (backoffice)¶
| CU | Nombre | Actor(es) | Prioridad | Documento |
|---|---|---|---|---|
| CU-009 | Recibir paquete físico en almacén | OP | Alta | cu-009-recibir-paquete.md |
| CU-013 | Escanear código de barras/QR de un paquete | OP | Alta | cu-013-scanner-almacen.md |
| CU-024 | Conciliar paquete sin identificar (sub-flujo) | OP | Alta | Parte de CU-009 |
| CU-025 | Cambiar estado logístico manualmente (sub-flujo) | OP | Alta | Parte de CU-009 |
Módulo 5: Verificación de identidad (KYC)¶
| CU | Nombre | Actor(es) | Prioridad | Documento |
|---|---|---|---|---|
| CU-010 | Completar KYC | UF, OP | Alta | cu-010-completar-kyc.md |
| CU-026 | Aprobar / rechazar KYC (operador, sub-flujo) | OP | Alta | Parte de CU-010 (parte B) |
Módulo 6: Servicios adicionales¶
| CU | Nombre | Actor(es) | Prioridad | Documento |
|---|---|---|---|---|
| CU-011 | Solicitar servicio adicional (inspección / reempaque / devolución) | UF | Alta | cu-011-servicio-adicional.md |
Nota: cargar evidencia de servicio y cambiar estado del servicio son flujos alternativos de CU-011.
Módulo 7: Incidencias y reclamos¶
| CU | Nombre | Actor(es) | Prioridad | Documento |
|---|---|---|---|---|
| CU-012 | Abrir y gestionar una incidencia | UF, OP | Alta | cu-012-incidencia.md |
Cubre el ciclo completo: apertura, mensajes, evidencia, cambio de estado, resolución, cierre, escalación y reembolso. Para los 11 tipos y 8 estados de incidencia, ver flujos/incidencias-reclamos.md.
Módulo 8: Notificaciones¶
| CU | Nombre | Actor(es) | Prioridad | Documento |
|---|---|---|---|---|
| CU-016 | Gestionar notificaciones (push, email, SMS, in-app) | UF | Alta | cu-016-gestion-notificaciones.md |
Nota: configurar preferencias de notificación está previsto para Fase 2 (cuando se expongan más canales configurables).
Módulo 9: Gestión de contactos¶
| Funcionalidad | Actor | Prioridad | Documento |
|---|---|---|---|
| Gestionar destinatarios en Cuba | UF | Alta | Parte de CU-003 y CU-005 (sin documento propio) |
| Gestionar remitentes en EE.UU. | UF | Alta | Parte de CU-003 y CU-005 (sin documento propio) |
Módulo 10: Educación y soporte¶
| Funcionalidad | Actor | Prioridad | Documento |
|---|---|---|---|
| Ver tutorial de tienda (Amazon/SHEIN/Temu) | UF | Alta | Parte de CU-004 |
| Ver módulo informativo de aduana | UF | Alta | Parte de CU-004 |
| Ver tarifario | UF | Alta | Parte de CU-004 |
| Contactar soporte | UF | Media | Fase 2 |
Módulo 11: Programa de referidos (Fase 2)¶
| Funcionalidad | Actor | Fase | Documento |
|---|---|---|---|
| Compartir código de referido | UF | F2 | — (Fase 2) |
| Ver mi red de referidos | UF | F2 | — (Fase 2) |
| Ver mi nivel y progreso | UF | F2 | — (Fase 2) |
| Ver mi saldo de crédito y movimientos | UF | F2 | — (Fase 2) |
| Convertir crédito en tarjeta promocional | UF | F2 | — (Fase 2) |
| Aplicar crédito/tarjeta en un pago | UF | F2 | — (Fase 2) |
Los CU del programa de referidos no están numerados todavía porque su diseño detallado se completa en Fase 2. El modelo de datos ya tiene los campos necesarios.
Módulo 12: Administración (backoffice)¶
| Funcionalidad | Actor | Prioridad | Documento |
|---|---|---|---|
| Configurar tarifas | AD | Alta | (cubierto por RF-039, RF-046) |
| Editar tutoriales | AD | Alta | (cubierto por RF-039) |
| Editar contenido de aduana | AD | Alta | (cubierto por RF-039) |
| Gestionar categorías de producto | AD | Alta | (cubierto por RF-039) |
| Configurar pool promocional | AD | Media | Fase 2 |
| Auditar cambios | AD | Alta | (cubierto por RF-040) |
| Exportar reportes | AD | Media | (cubierto por RF-040) |
Las acciones de administración se realizan desde Django Admin y vistas personalizadas del backoffice. No requieren CU detallados en MVP porque el modelo es estándar.
Módulo 13: Integraciones externas y webhooks¶
| CU | Nombre | Actor(es) | Prioridad | Documento |
|---|---|---|---|---|
| CU-014 | Procesar webhook de pago (Stripe) | ST | Media (Fase 2) | cu-014-pago-webhook.md |
| CU-015 | Integración con agencia aliada (webhook + polling) | SA | Alta (MVP) | cu-015-agencia-aliada.md |
MVP: la integración con la agencia es manual (el operador actualiza el estado desde el backoffice usando el número de guía). La automatización con webhooks es priorizada para Fase 2 si el contrato con la agencia lo permite.
Resumen por prioridad¶
| Prioridad | Cantidad | Porcentaje |
|---|---|---|
| Alta (MVP) | 15 | ~58% |
| Media (Fase 2) | 11 | ~42% |
| Baja (Fase 3+) | 0 | 0% |
| Total documentados | ~26 | 100% |
Casos de uso sin documento .md
Los sub-flujos listados como "Parte de CU-XXX" no tienen documento individual porque su comportamiento está descrito en el flujo principal del CU padre. Esto evita proliferación de documentos redundantes.
Si en el futuro alguno de estos sub-flujos crece en complejidad (ej. el programa de referidos, que tiene su propio modelo), se le asigna un ID nuevo y se crea su documento.
Trazabilidad a requisitos del SRS¶
Todos los CU están trazados a los requisitos funcionales del SRS y a la Matriz de trazabilidad. Ver la sección "Trazabilidad SRS" en cada caso de uso detallado.