Casillero — App de envíos a Cuba¶
Documentación base del proyecto de aplicación móvil/web para gestión de casillero y envíos hacia Cuba.
Estado del proyecto
Este proyecto se encuentra en fase inicial. La documentación refleja la visión actual del producto y está sujeta a cambios conforme se vayan definiendo detalles técnicos y operativos.
¿Qué es este proyecto?¶
Una aplicación pensada para personas que compran en tiendas como Amazon, SHEIN y Temu, usan una dirección de casillero en Estados Unidos, reportan sus compras desde la app y reciben guía clara sobre el proceso de envío hacia Cuba: clasificación de paquetes, límites de aduana, servicios disponibles y costos.
Stack tecnológico¶
| Capa | Tecnología |
|---|---|
| Base de datos | PostgreSQL |
| Frontend (app + web) | Quasar Framework + CapacitorJS |
| Backend | Django + FastAPI |
La app en pocas palabras¶
flowchart LR
A["🛒 Compro online"] --> B["📋 Copio dirección del casillero"]
B --> C["📦 Reporto mi compra"]
C --> D["📊 Veo estado del paquete"]
D --> E["✈️ Se envía a Cuba"]
E --> F["🏠 Recibo en casa"]Estructura de esta documentación¶
| Sección | Contenido |
|---|---|
| Visión | Objetivo, problema que resuelve, perfiles de usuario y filosofía |
| Stack Técnico | Tecnologías seleccionadas y arquitectura |
| Flujos y Pantallas | Flujos de uso y pantallas del MVP |
| Datos y Reglas | Modelo de datos, identificador, reglas de negocio y aduana |
| Módulos | Módulos funcionales y catálogo de servicios |
| Operaciones | Panel interno y riesgos operativos |
| Crecimiento | Motor de referidos, niveles, crédito y fidelidad |
| Roadmap | MVP, requisitos, integraciones y próximos pasos |
Actores principales¶
La empresa actúa como intermediaria entre:
- El comprador final que adquiere productos online
- El remitente o responsable del envío en Estados Unidos
- El casillero / almacén de recepción
- La agencia que consolida o despacha hacia Cuba
- El destinatario final en Cuba