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.

Documentación RUP del proyecto IslaBox¶

Esta sección contiene los artefactos formales del Rational Unified Process (RUP) que complementan la documentación funcional, técnica y operativa del proyecto. El objetivo es ofrecer una base metodológica sólida para la toma de decisiones, la comunicación con stakeholders y la trazabilidad del desarrollo.

¿Por qué RUP?¶

RUP es una metodología de ingeniería de software iterativa e incremental, basada en UML, que organiza el trabajo en cuatro fases:

Inicio (Inception) — ¿Qué sistema vamos a hacer y por qué?
Elaboración (Elaboration) — ¿Cómo va a funcionar y cómo se va a construir?
Construcción (Construction) — Construir el sistema.
Transición (Transition) — Llevar el sistema a producción.

IslaBox ya tiene la documentación funcional, técnica y operativa completa (en el resto del repositorio). Esta sección agrega los artefactos formales que un proceso RUP exige y que faltaban: glosario, modelo de negocio AS-IS/TO-BE, factibilidad, plan de proyecto, SRS consolidado, casos de uso, diagramas UML y plan de pruebas.

Estructura de esta sección¶

Fase 1 — Inicio¶

Artefacto	Documento	Estado
Glosario del proyecto	glosario.md	✅
Modelo de negocio (AS-IS / TO-BE)	modelo-negocio.md	✅
Estudio de factibilidad	factibilidad.md	✅
Plan del proyecto	plan-proyecto.md	✅

Fase 2 — Elaboración¶

Artefacto	Documento	Estado
Especificación de requisitos (SRS)	srs.md	✅
Catálogo de casos de uso	casos-de-uso/catalogo.md	✅
Diagrama general de casos de uso	casos-de-uso/diagrama-general.md	✅
Casos de uso detallados (10)	casos-de-uso/catalogo.md	✅
Diagrama de clases	diagramas-uml/clases.md	✅
Diagramas de secuencia	diagramas-uml/secuencia/seq-pago.md	✅
Diagramas de actividad	diagramas-uml/actividad/act-flujo-paquete.md	✅
Diagramas de estados	diagramas-uml/estados/estado-paquete.md	✅
Plan de pruebas	plan-pruebas.md	✅

Fase 3 — Construcción (referencias)¶

Los artefactos de Construcción (código, tests, builds, releases) se generan en los repositorios de las apps y del backend. Esta sección no los duplica.

Fase 4 — Transición (referencias)¶

La documentación de despliegue, manuales de usuario y de operación se vincula desde aquí cuando se generen.

Cómo se conecta con el resto del proyecto¶

flowchart LR
    A["Visión\n(qué + por qué)"] --> B["RUP Inicio\n(glosario, AS-IS, factibilidad, plan)"]
    B --> C["RUP Elaboración\n(SRS, CU, UML, plan de pruebas)"]
    C --> D["RUP Construcción\n(código, tests, builds)"]
    D --> E["RUP Transición\n(despliegue, manuales)"]
    E --> F["Operación + Mejora continua"]

    G["Datos y Reglas"] --> C
    H["Stack Técnico"] --> C
    I["Flujos y Pantallas"] --> C
    J["Módulos"] --> C
    K["Operaciones"] --> D
    L["Roadmap"] --> B
    M["APK IslaBox (Android)"] --> D

Regla: los artefactos RUP no duplican la información funcional existente; la referencian y la estructuran según el formalismo UML/RUP.

Convenciones¶

Los diagramas están en Mermaid cuando es posible (versionables, editables, sin binarios).
Los casos de uso siguen la plantilla estándar RUP: nombre, actor, precondiciones, flujo principal, flujos alternativos, postcondiciones, excepciones.
Los requisitos tienen identificador único (RF-001, RNF-001) para facilitar la trazabilidad.
El glosario es una referencia histórica; cualquier inconsistencia se resuelve a favor de los documentos canónicos del índice maestro.

Estado de avance¶

Fase	Progreso	Notas
Inicio	🟢 100%	Completa
Elaboración documental	🟡 85–90%	Documentación de referencia consolidada, pendiente resolver inconsistencias residuales entre SRS, CU, matriz, estados y reglas
Construcción MVP	🟠 18–25%	Cobertura medida por la matriz de trazabilidad (RF cubiertos vs RF totales)
Transición	⚪ Pendiente	Prevista post-MVP-beta

Lectura del porcentaje de Elaboración

El 85–90% refleja que la documentación de referencia (SRS, CU, modelo de datos, reglas de negocio, estados, contratos, arquitectura) está consolidada y se considera suficiente para iniciar Construcción. El 10–15% restante corresponde a: detalles de implementación que se ajustan durante Construcción, ajustes por descubrimiento de inconsistencias en auditorías, y la incorporación de las decisiones tomadas en preguntas.md que aún están pendientes.

La diferencia entre Elaboración documental (85–90%) y Construcción MVP (18–25%) es deliberada y saludable: significa que sabemos qué construir aunque todavía no hemos construido todo.