Saltar a contenido

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.

Plan del proyecto

Organización del trabajo, cronograma, recursos, responsabilidades, hitos y dependencias para llevar el proyecto IslaBox del concepto al MVP operativo.

1. Resumen del proyecto

Atributo Valor
Nombre IslaBox
Tipo Producto digital (app móvil + backend + backoffice)
Metodología RUP iterativo-incremental, con sprints de 2 semanas
Fase actual Elaboración → Construcción
Lanzamiento objetivo del MVP T+4 meses desde inicio de Construcción
Equipo total 7-9 personas

2. Fases del proyecto (adaptadas de RUP)

Fase Objetivo Estado Duración
Inicio (Inception) Definir alcance, viabilidad, actores ✅ Completa 4 semanas
Elaboración (Elaboration) Arquitectura, requisitos detallados, prototipos 🟡 85–90% documental 6 semanas (puede extenderse para ajustes finales)
Construcción (Construction) Implementar el sistema 🟠 En curso — 18–25% MVP 12-16 semanas
Transición (Transition) Beta, capacitación, lanzamiento ⏳ Pendiente 4 semanas

Reclasificación 2026-06-08

Anteriormente la fase de Elaboración se marcaba como "Completa (100%)". Se reclasifica a "85–90% documental" porque la auditoría de consistencia del 2026-06-08 encontró que:

  • Quedan inconsistencias residuales entre SRS, CU, matriz de trazabilidad, modelo de datos, estados y reglas de negocio.
  • Varias decisiones de preguntas.md están tomadas pero aún no propagadas a todos los documentos.
  • La cobertura real de construcción del MVP es del 18–25% según la matriz de trazabilidad.

Esto no bloquea la continuación de Construcción: se puede construir con la documentación actual e ir refinando.

3. Equipo de trabajo

3.1 Estructura del equipo (MVP)

Rol Cantidad Dedicación Responsabilidad
Product Manager 1 100% Visión, priorización, KPIs, stakeholders
Tech Lead (Backend) 1 100% Arquitectura backend, code review, DevOps
Tech Lead (Mobile) 1 100% Arquitectura app, code review, Android
Desarrollador Backend 1-2 100% Django, FastAPI, PostgreSQL
Desarrollador Android 1 100% Kotlin, Jetpack Compose
Desarrollador iOS (Fase 2) 1 100% Swift, SwiftUI (se contrata para Fase 2)
UX/UI Designer 1 50% Wireframes, design system, prototipos
QA / Tester 0.5 50% Pruebas manuales, automatización básica
Operador líder (backoffice) 1 100% Capacita al equipo, valida flujos operativos
Total 7-9 — —

3.2 Estructura de governance

Reunión Frecuencia Asistentes Propósito
Daily standup Diaria Equipo técnico Estado diario, blockers
Sprint planning Bisemanal Equipo completo Compromisos del sprint
Sprint review Bisemanal Equipo completo + PM Demo de incrementos
Sprint retrospective Bisemanal Equipo técnico Mejora continua
Refinement Semanal Tech leads + devs Refinar historias del próximo sprint
Comité de producto Quincenal PM + leads + stakeholders Decisiones de alcance, prioridades
Comité ejecutivo Mensual Dirección + PM KPIs, riesgos, presupuesto

4. Plan de entregas por fase

4.1 Fase de Inicio (✅ Completa)

Entregable Estado Documento
Documento de visión ✅ vision/objetivo.md
Perfiles de usuario ✅ vision/perfiles.md
Filosofía de producto ✅ vision/filosofia.md
Modelo de negocio AS-IS/TO-BE ✅ modelo-negocio.md
Estudio de factibilidad ✅ factibilidad.md
Glosario ✅ glosario.md
Plan del proyecto ✅ Este documento

4.2 Fase de Elaboración (🟡 85–90% documental)

Entregable Estado Documento Notas
Especificación de requisitos (SRS) ✅ ../02-elaboracion/srs.md v1.1 — RF-052 a RF-055 agregados, RF-046 a RF-051 renumerados
Modelo de datos ✅ ../../../datos/modelo-datos.md v2 limpio, archivo legacy archivado
Estados oficiales ✅ ../../../datos/estados.md Limpieza 2026-06-08 eliminó listo_para_enviar de docs activos
Catálogo de casos de uso ✅ ../02-elaboracion/casos-de-uso/catalogo.md Numeración consolidada
Casos de uso detallados (10+) ✅ ../02-elaboracion/casos-de-uso/catalogo.md CU-001 a CU-010 + CU-011 a CU-016
Diagrama general de casos de uso ✅ ../02-elaboracion/casos-de-uso/diagrama-general.md
Diagramas UML (clases, secuencias, actividad, estados) ✅ ../02-elaboracion/diagramas-uml/clases.md Estados de paquete sincronizados con estados.md
Arquitectura del sistema ✅ ../../../stack/arquitectura-backend.md
Stack tecnológico ✅ ../../../stack/tecnologias.md
Prototipo de interfaz (app real) ✅ Sección ../../../apk/index.md Maquetación visual en progreso
Plan de pruebas ✅ ../02-elaboracion/plan-pruebas.md
Reglas de negocio ✅ ../../../datos/reglas-negocio.md RN-105 a RN-118 agregados
Identificador y algoritmo ✅ ../../../datos/identificador.md
Categorías y aduana ✅ ../../../datos/aduana.md
Normativa cubana ✅ ../../../datos/aduana-normativa-cuba.md
Matriz de trazabilidad RF↔CU ✅ ../02-elaboracion/matriz-trazabilidad.md Cobertura MVP: 18%
Contrato de API ⚠️ ../../../stack/api-contract.md Pendiente marcar endpoints con etiqueta MVP/Fase 2
Documentos legales ⚠️ Borrador ../../../legal/terminos-condiciones.md Requieren revisión legal antes de publicación

4.3 Fase de Construcción (🟡 En curso)

Sprint Semana Épica Entregables
S0 1 Setup Repos, CI/CD, infra base (PostgreSQL, Redis, MinIO, Django skeleton)
S1 2 Auth Registro, login, recuperación, OTP, KYC mínimo
S2 3 Identificador Generación Mod-10, validación, asociación usuario
S3 4 Casillero Modelo, dirección, copia rápida, tutoriales básicos
S4 5-6 Prealerta Formulario, lista, estados, integración con prealerta backend
S5 7 Recepción Cola operativa, escaneo, asociación con prealerta
S6 8 Conciliación Cola, búsqueda, resolución manual, notificaciones
S7 9 Almacenaje Días gratis, alertas, cargos, jobs diarios
S8 10 Consolidación Selección, cálculo, estados, pago
S9 11 Cotización + Pago Quote, Invoice, registro manual de pago
S10 12 Notificaciones Push, email básico, in-app
S11 13 Módulo informativo de aduana Pantalla con Res. 175/2022
S12 14 Hardening Bugs, performance, seguridad, accesibilidad
S13 15 Beta cerrada 20-50 usuarios, feedback, ajustes
S14 16 Lanzamiento MVP Producción, monitoreo, comunicación

4.4 Fase de Transición (⏳ Pendiente)

Semana Actividad
17-18 Capacitación al equipo operativo
19 Onboarding de los primeros 100 usuarios beta ampliados
20 Lanzamiento público con campaña de marketing

5. Cronograma visual (Gantt simplificado)

gantt
    title Cronograma IslaBox MVP
    dateFormat YYYY-MM-DD
    axisFormat %b

    section Inicio
    Visión, actores, glosario         :done, ini1, 2026-03-01, 4w

    section Elaboración
    Requisitos y modelo de datos      :done, ela1, after ini1, 4w
    Arquitectura y casos de uso       :done, ela2, after ela1, 2w

    section Construcción
    Setup e infraestructura           :active, cons1, after ela2, 1w
    Auth + Identificador              :cons2, after cons1, 2w
    Casillero + Prealerta             :cons3, after cons2, 2w
    Recepción + Conciliación          :cons4, after cons3, 2w
    Almacenaje + Consolidación        :cons5, after cons4, 2w
    Cotización + Pago + Notificaciones :cons6, after cons5, 3w
    Hardening y Beta                  :cons7, after cons6, 2w

    section Transición
    Lanzamiento MVP                   :milestone, trans1, after cons7, 0d
    Onboarding usuarios               :trans2, after trans1, 2w

6. Recursos

6.1 Recursos humanos (estimación de costo mensual)

Rol Cantidad Costo mensual (USD) Subtotal
Product Manager 1 4,000 - 6,000 4,000 - 6,000
Tech Lead Backend 1 5,000 - 7,000 5,000 - 7,000
Tech Lead Mobile 1 5,000 - 7,000 5,000 - 7,000
Desarrollador Backend 1.5 3,500 - 5,000 5,250 - 7,500
Desarrollador Android 1 3,500 - 5,000 3,500 - 5,000
UX/UI Designer 0.5 3,000 - 4,500 1,500 - 2,250
QA 0.5 2,000 - 3,000 1,000 - 1,500
Operador líder 1 2,500 - 3,500 2,500 - 3,500
Total mensual — — $27,750 - $37,750

6.2 Recursos técnicos

Recurso Proveedor Costo estimado
Servidor app + DB DigitalOcean / AWS / GCP $200 - $500 / mes
Object storage (alternativa a MinIO) S3 / Wasabi $20 - $50 / mes
Redis (cache/locks) Upstash / Redis Cloud $30 - $80 / mes
MinIO self-hosted Auto-hospedaje Incluido en servidor
FCM (Firebase Cloud Messaging) Google Gratis hasta límite
Apple Developer Account Apple $99 / año
Google Play Console Google $25 (pago único)
Dominio + DNS Varios $15 - $30 / año
SSL/TLS (Let's Encrypt) Auto-renovado $0
Total técnico mensual — $250 - $630

6.3 Recursos físicos (one-time + mensuales)

Recurso Costo estimado
Alquiler del casillero propio en Miami (decisión resuelta 2026-06-06) $2,000 - $5,000 / mes
Equipamiento (estantes, báscula, scanner, cámaras) $5,000 - $10,000 (one-time)
Servicios del casillero (luz, internet, seguridad) $300 - $500 / mes
Equipo de oficina (computadoras, monitores) $3,000 - $5,000 (one-time)

7. Presupuesto consolidado (4 meses de Construcción + Transición)

Categoría Total estimado (USD)
Recursos humanos (4 meses) $111,000 - $151,000
Recursos técnicos (4 meses) $1,000 - $2,500
Recursos físicos (one-time + 4 meses) $21,000 - $32,000
Marketing pre-lanzamiento $5,000 - $10,000
Consultoría legal $3,000 - $6,000
Reserva para contingencias (15%) $21,000 - $30,000
TOTAL $162,000 - $231,500

8. Gestión de riesgos del proyecto

# Riesgo Probabilidad Impacto Mitigación Owner
1 Retraso en contratación de agencia aliada Media Alto Iniciar conversaciones en paralelo al desarrollo PM
2 Pérdida de miembro clave del equipo Media Alto Documentación continua; pair programming; bus factor > 1 Tech Lead
3 Cambio de alcance (scope creep) Alta Medio Comité de producto quincenal; criterios MoSCoW estrictos PM
4 Tecnología no rinde como se espera Baja Medio PoC tempranos en sprints 0-1; alternativas identificadas Tech Lead
5 Problema legal descubierto tarde Media Alto Consultoría legal desde el primer mes PM
6 Beta cerrada con bajo feedback Media Alto Incentivos a beta testers; canales de feedback directos PM
7 Crash en producción tras lanzamiento Baja Alto Hardening sprint, beta extendida, monitoreo, rollback plan Tech Lead
8 Costos de casillero más altos de lo previsto Media Medio Múltiples cotizaciones; contrato con cláusula de salida PM

9. Dependencias críticas

Dependencia Tipo Fecha límite Plan B
Casillero propio alquilado y acondicionado en Miami (decisión resuelta 2026-06-06) Externa Antes de S5 Almacén temporal; pausa de operaciones
Contrato con agencia aliada firmado (API ya confirmada, contrato pendiente) Externa Antes de S8 Despachar manualmente con courier conocido; retrasar lanzamiento
Licencia de courier — No aplica a IslaBox (sujeto a validación legal final) IslaBox opera como intermediario digital. La agencia aliada es quien posee la licencia de courier. Esta clasificación debe validarse legalmente antes del lanzamiento para confirmar que OFAC y el DOT no clasifiquen a IslaBox como freight forwarder.
Política de privacidad publicada Legal Antes de S1 Plantilla legal estándar revisada por abogado
Equipo de operaciones contratado RRHH Antes de S5 Contratar operador líder primero, luego 2 más

10. Criterios de salida de cada fase

Salir de Inicio → Elaboración

  • Documento de visión aprobado
  • Actores identificados
  • Glosario completo
  • Factibilidad validada
  • Plan de proyecto aprobado

Salir de Elaboración → Construcción

  • SRS completo
  • Modelo de datos definido
  • Casos de uso principales especificados
  • Arquitectura aprobada
  • Prototipo de la app navegable
  • Plan de pruebas definido

Salir de Construcción → Transición

  • 100% de los requisitos del MVP implementados
  • Plan de pruebas ejecutado con éxito
  • Beta cerrada con feedback positivo
  • Sin bugs críticos abiertos
  • Despliegue a producción validado

Salir de Transición (MVP lanzado)

  • Lanzamiento público ejecutado
  • Primeros 100 usuarios activos
  • KPIs de lanzamiento en verde
  • Equipo de operaciones entrenado
  • Plan de soporte definido

11. Herramientas de gestión

Propósito Herramienta
Código Git + GitHub
CI/CD GitHub Actions
Tracking de issues GitHub Issues / Projects
Documentación Este repositorio MkDocs
Comunicación Slack / Discord
Diseño Figma
Gestión de sprints GitHub Projects / Jira (opcional)
Monitoreo Sentry + Grafana
Gestión de infraestructura Terraform / Pulumi

12. Glosario de项目管理

  • Sprint: Iteración de 2 semanas con objetivos fijos
  • Backlog: Lista priorizada de historias de usuario pendientes
  • Definition of Done (DoD): Criterios que debe cumplir una historia para considerarse completa (código + tests + docs + review + demo)
  • Burndown chart: Gráfico de trabajo restante en el sprint
  • Velocity: Cantidad de puntos de historia completados por sprint
  • Stakeholder: Persona o grupo con interés legítimo en el proyecto