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.
MVP y roadmap de fases¶
Para salir rápido al mercado, el proyecto se divide en MVP operativo, base de datos preparada y fases de crecimiento. No todo entra en el primer lanzamiento.
Fase 1 — MVP operativo (lanzamiento)¶
Funcionalidades que deben estar operativas el día 1.
| # | Funcionalidad | Prioridad |
|---|---|---|
| 1 | Registro inicial simple (nombre, correo, teléfono) | Alta |
| 1b | Verificación de correo por enlace y teléfono por OTP | Alta |
| 1c | KYC obligatorio para despacho (no para prealerta) | Alta |
| 2 | Identificador único de usuario con dígito verificador | Alta |
| 3 | Dashboard con dirección copiable | Alta |
| 4 | Tutoriales simples para Amazon, SHEIN y Temu | Alta |
| 5 | Reportar compra (tracking opcional) | Alta |
| 6 | Mis reportes / Mis paquetes (separados) | Alta |
| 7 | Recepción manual en backoffice | Alta |
| 8 | Conciliación manual de paquetes | Alta |
| 9 | Estados de paquete visibles | Alta |
| 10 | Almacenaje con días gratis y alertas | Alta |
| 11 | Consolidación manual asistida | Alta |
| 12 | Cotización antes del pago | Alta |
| 13 | Pago o registro de pago | Alta |
| 14 | KYC para despacho (solo bloquea despacho, no prealerta) | Alta |
| 15 | Notificaciones push básicas | Alta |
| 16 | Módulo informativo de aduana (editabl) | Alta |
| 17 | Tarifario visible de servicios principales | Alta |
| 18 | Panel admin operativo con colas de trabajo | Alta |
| 19 | Colas operativas: recepción, conciliación, KYC, incidencias | Alta |
Fase 2 — Crecimiento (interfaz del programa)¶
Funcionalidades del programa de referidos que se preparan desde el inicio pero se activan después del lanzamiento.
| # | Funcionalidad | Prioridad |
|---|---|---|
| 20 | Código de referido por usuario | Media |
| 21 | Registro de referidos | Media |
| 22 | Crédito acumulado y vencimiento | Media |
| 23 | Pantalla de mi red (referidos, nivel, progreso) | Media |
| 24 | Pantalla de crédito y tarjetas | Media |
| 25 | Aplicación de crédito/tarjeta en el pago | Media |
| 26 | Niveles 1/2/3 dinámicos | Media |
| 27 | Pool de referidos y pool de fidelidad | Baja |
| 28 | Tarjetas promocionales | Baja |
Fase 3 — Automatizaciones futuras¶
Integraciones que no deben bloquear el lanzamiento.
| # | Funcionalidad | Prioridad |
|---|---|---|
| 29 | API de tracking de transportistas | Baja |
| 30 | OCR de etiquetas y lectura automática | Baja |
| 31 | WhatsApp API | Baja |
| 32 | Integración con Stripe como pasarela de pago online completa (Stripe Checkout + Webhooks) | Baja |
| 33 | App nativa iOS | Baja |
| 34 | App nativa Android | Baja |
Decisiones MVP ya tomadas¶
| Pregunta | Decisión MVP |
|---|---|
| ¿API o manual? | Manual en Fase 1. external_reference_id preparado para futuro. |
| ¿Consolidación automática o manual? | Manual asistida por operador. |
| ¿Paquetes no reportados? | Cola de conciliación + pantalla "paquete recibido sin prealerta". |
| ¿Costo estimado o final? | Estimado antes de recepción. Final después de peso real y validación. |
| ¿Pago online o contraentrega? | Registro de pago manual en backoffice + integración futura. |
| ¿KYC bloquea prealerta? | No. Solo bloquea despacho, consolidación para envío, pago y crédito. |
| ¿Apps nativas desde inicio? | No. PWA o Quasar mobile-first en Fase 1. Nativas en Fase 3. |
| ¿FastAPI desde inicio? | Sí. Django para modelos, migraciones, admin y lógica de negocio. FastAPI para la API pública consumida por las apps. Comparten la capa core/services/. |
Flujo del MVP operativo¶
flowchart TD
A["Registro"] --> B["Ver dirección del casillero propio en Miami"]
B --> C["Copiar dirección"]
C --> D["Ver tutorial de tienda"]
D --> E["Comprar en tienda online"]
E --> F["Reportar compra en la app"]
F --> G["Paquete llega al casillero propio de IslaBox"]
G --> H["Operador identifica y concilia"]
H --> I["Ver paquete en almacén (15 días gratis)"]
I --> J["Consolidar si desea"]
J --> K["Ver cotización"]
K --> L["Pagar o registrar pago (manual MVP, Stripe Fase 2)"]
L --> M["IslaBox entrega el envío a la agencia aliada"]
M --> N["Agencia aliada transporta a Cuba vía API"]
N --> O["Seguir estado hasta entrega"]Decisiones resueltas 2026-06-06 (../../roadmap/preguntas.md): casillero propio en Miami, agencia aliada con API, 15 días gratis de almacenaje, $0.50/día extra, Stripe en Fase 2, IslaBox opera como intermediario digital por lo que actualmente no requiere licencia de courier propia (la agencia aliada es quien la posee). Sujeto a validación legal final pre-lanzamiento.
Lo que NO debe dejarse para después¶
No postergar
Estas funcionalidades son esenciales aunque parezcan secundarias. Omitirlas en el MVP generará deuda técnica y operativa difícil de resolver:
- Registro progresivo — Registro inicial mínimo + KYC diferido; implementar ambas etapas desde el inicio o el segundo paso no tendrá donde apoyarse
- KYC obligatorio antes del primer envío — Si se agrega después, los datos de identidad de usuarios existentes quedan sin validar y la operación queda expuesta
- Identificador único
- Prealerta de paquetes
- Datos completos de remitente y destinatario
- Consolidación
- Control de almacenaje
- Estados logísticos
- Administración de contenido legal
- Estructura de cargos extra
- Código de referido y modelo de red — Si se agrega después, migrar los referidos históricos es costoso y los primeros usuarios no habrán tenido incentivo para traer a nadie
- Motor de crédito y pool — La estructura de datos debe existir desde el día 1; añadirla retroactivamente rompe la trazabilidad
- Vencimiento de crédito y tarjetas — Parte del modelo financiero; no se puede activar a medias
Flujo del MVP¶
flowchart TD
A["Registro"] --> B["Ver dirección del casillero"]
B --> C["Copiar dirección"]
C --> D["Ver tutorial de tienda"]
D --> E["Comprar en tienda online"]
E --> F["Reportar compra en la app"]
F --> G["Ver paquetes y estados"]
G --> H["Consolidar si desea"]
H --> I["Seguir envío hasta entrega"]
A --> J["Compartir código de referido"]
J --> K["Referido se registra y envía"]
K --> L["Se acredita crédito al referidor"]
L --> M["Convertir crédito en tarjetas"]
M --> N["Aplicar tarjeta en próximo envío"]