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.

---

Diagrama general de casos de uso

Vista panorámica de los casos de uso del sistema IslaBox, agrupados por actor y módulo. Este diagrama se complementa con los casos de uso detallados (en esta misma carpeta).

Numeración consolidada — 2026-06-08

Los IDs CU-011 a CU-016 que aparecen en este diagrama como flujos menores ("Actualizar tracking", "Cancelar prealerta", "Conciliar", "Cambiar estado", "Consolidar manual", "Registrar pago") son flujos alternativos de otros CU, no CUs independientes con documento propio. La numeración de CUs con documento .md propio es la del catálogo.md oficial (CU-001 a CU-010 + CU-027 a CU-032).

Este diagrama se conserva tal cual por su valor como mapa visual, pero las referencias documentales deben usar los IDs del catálogo.

---

Diagrama UML (Mermaid)

flowchart LR
    subgraph Actores
        UF["👤 Usuario Final\n(EE.UU.)"]
        OP["👨‍💼 Operador\n(interno)"]
        AD["⚙️ Administrador\n(interno)"]
    end

    subgraph Autenticación
        UC1["CU-001\nRegistrarse"]
        UC2["CU-002\nLogin / Recuperar"]
        UC3["CU-003\nGestionar perfil"]
        UC4["CU-004\nDashboard"]
    end

    subgraph Prealerta
        UC5["CU-005\nReportar compra"]
        UC11["CU-011\nActualizar tracking"]
        UC12["CU-012\nCancelar prealerta"]
    end

    subgraph Paquetes
        UC6["CU-006\nConsultar paquete"]
        UC7["CU-007\nConsolidar"]
        UC8["CU-008\nPagar y despachar"]
    end

    subgraph Almacén
        UC9["CU-009\nRecibir paquete"]
        UC13["CU-013\nConciliar"]
        UC14["CU-014\nCambiar estado"]
        UC15["CU-015\nConsolidar manual"]
        UC16["CU-016\nRegistrar pago"]
        UC17["CU-017\nDespachar"]
    end

    subgraph KYC
        UC10["CU-010\nCompletar KYC"]
        UC18["CU-018\nAprobar / rechazar KYC"]
    end

    subgraph Servicios
        UC19["CU-019\nSolicitar inspección"]
        UC20["CU-020\nSolicitar reempaque"]
        UC21["CU-021\nSolicitar devolución"]
        UC22["CU-022\nCargar evidencia"]
    end

    subgraph Educación
        UC27["CU-027\nVer tutorial"]
        UC28["CU-028\nVer aduana"]
        UC29["CU-029\nVer tarifario"]
    end

    subgraph Notificaciones
        UC25["CU-025\nVer historial"]
    end

    subgraph Administración
        UC37["CU-037\nConfigurar tarifas"]
        UC38["CU-038\nEditar tutoriales"]
        UC39["CU-039\nEditar aduana"]
        UC40["CU-040\nGestionar categorías"]
        UC42["CU-042\nAuditar"]
    end

    %% Relaciones Usuario Final
    UF --> UC1
    UF --> UC2
    UF --> UC3
    UF --> UC4
    UF --> UC5
    UF --> UC11
    UF --> UC12
    UF --> UC6
    UF --> UC7
    UF --> UC8
    UF --> UC10
    UF --> UC19
    UF --> UC20
    UF --> UC21
    UF --> UC25
    UF --> UC27
    UF --> UC28
    UF --> UC29

    %% Relaciones Operador
    OP --> UC4
    OP --> UC9
    OP --> UC13
    OP --> UC14
    OP --> UC15
    OP --> UC16
    OP --> UC17
    OP --> UC18
    OP --> UC22

    %% Relaciones Administrador (hereda permisos de Operador)
    AD --> UC37
    AD --> UC38
    AD --> UC39
    AD --> UC40
    AD --> UC42

    %% Inclusiones (include)
    UC5 -.->|"<<include>>"| UC3
    UC7 -.->|"<<include>>"| UC6
    UC8 -.->|"<<include>>"| UC7
    UC10 -.->|"<<include>>"| UC3
    UC15 -.->|"<<include>>"| UC9
    UC17 -.->|"<<include>>"| UC15
    UC16 -.->|"<<include>>"| UC8

    %% Extensiones (extend)
    UC11 -.->|"<<extend>>"| UC5
    UC12 -.->|"<<extend>>"| UC5
    UC19 -.->|"<<extend>>"| UC6
    UC20 -.->|"<<extend>>"| UC6
    UC21 -.->|"<<extend>>"| UC6

---

Agrupación visual por paquete funcional

mindmap
  root((IslaBox))
    Autenticación
      Registrarse
      Login
      Gestionar perfil
      Dashboard
    Prealerta
      Reportar compra
      Actualizar tracking
      Cancelar
    Paquetes
      Consultar detalle
      Consolidar
      Pagar y despachar
    Operación de almacén
      Recibir
      Conciliar
      Cambiar estado
      Consolidar manual
      Registrar pago
      Despachar
    KYC
      Completar
      Aprobar/Rechazar
    Servicios
      Inspección
      Reempaque
      Devolución
      Cargar evidencia
    Educación
      Tutoriales
      Aduana
      Tarifario
    Notificaciones
      Historial
    Administración
      Tarifas
      Tutoriales
      Aduana
      Categorías
      Auditoría

---

Reglas del diagrama

• Cada CU está trazado al SRS (srs.md) y a un módulo funcional.
• Los operadores tienen acceso a CU del paquete "Operación de almacén" + lectura de CU de "Autenticación" (ver datos de usuarios).
• Los administradores heredan permisos de operador y agregan los CU del paquete "Administración".
• Los destinatarios y remitentes no son actores del sistema (no se registran).
• Los CU de Fase 2 (referidos, niveles, crédito) se incluyen en el catálogo (catalogo.md) pero se omiten del diagrama para mantener foco en el MVP.

---

Próximos pasos

1. Profundizar los 10 CU críticos para el MVP (los que tienen documentos detallados en esta carpeta).
2. Validar el diagrama con stakeholders (PM, equipo de operaciones).
3. Una vez aprobado, mantener la trazabilidad CU ↔ RF ↔ test cases.