# Propuesta de proyecto — Zeitune Logística

Cliente: Grandes Tiendas San Juan · Fecha: 17/11/2026

## 1. Resumen

Proponemos desarrollar **Zeitune Logística**, una aplicación web para
preparar, despachar, recibir y seguir los bultos que la empresa envía entre
sus depósitos. Se usa desde el celular o la computadora, lee los códigos
EAN13 de los bultos con la cámara o con un lector, y muestra en todo momento
dónde está cada bulto y qué falta.

Para que la empresa empiece a operar cuanto antes, el proyecto se entrega en
**tres etapas**:

- **Etapa 1 — Maqueta MVP (1 semana):** sus usuarios prueban en el celular
  las pantallas con el diseño tentativo antes de programarlas.
- **Etapa 2 — Operación (8 semanas):** todo el circuito de los bultos, desde la
  preparación a la recepción, funcionando con el diseño definitivo. 
  Se entrega en partes, para probar cada uno de los pasos.
- **Etapa 3 — Seguimiento (2 semanas):** revisión y prueba de los paneles 
  con indicadores para supervisión, aviso por correo de cada despacho y
  funcionamiento en general de la aplicación.

## 2. Qué resuelve

Hoy el movimiento de bultos entre depósitos necesita:

- saber qué bultos tiene que preparar cada depósito y para dónde;
- armar los camiones agrupando lo que va a un mismo destino;
- controlar que suba al camión todo lo que tiene que subir, y nada más;
- controlar en destino qué llegó, qué falta y qué llegó abierto o dañado;
- avisar a la sucursal de destino que un envío salió;
- ver el estado de los envíos en el panel de indicadores.

La aplicación registra cada bulto con su código desde que se prepara hasta
que se recibe, y cada paso queda con usuario, fecha y hora.

## 3. Cómo funciona

| Paso | Documento | Quién | Qué pasa |
|---|---|---|---|
| 1 | Orden de preparación (OP) | Preparación | Se crea la orden para un proveedor, un departamento y un depósito de destino. El operario la toma y escanea cada bulto: el sistema valida el código, que el destino coincida y que no esté repetido. |
| 2 | Hoja de ruta (HR) | Supervisor | Se programa el viaje en un calendario (fecha y turno, origen y destino) y se le agregan las OP terminadas. Al cerrarla, queda lista para cargar. Las hojas vacías se cancelan solas a las 23:55. |
| 3 | Despacho (DS) | Despacho | Se toma la hoja de ruta y se escanea cada bulto que sube al camión; el sistema muestra cuáles faltan y rechaza los que no corresponden. Se registran transportista, patente y remitos, y se imprime el remito. |
| 4 | Recepción (RC) | Recepción | En destino se escanea lo que llega, marcando si vino bien, abierto o dañado. Lo que no corresponde queda anotado. La hoja de ruta pasa sola a Recibida, u Observada si hubo bultos abiertos o dañados. |
| 5 | Seguimiento | Despacho, Recepción, Supervisor | Paneles con el estado de órdenes, hojas de ruta, despachos, recepciones y bultos con problemas, con filtros e indicadores. Correo a la sucursal de destino en cada despacho. |

Cada documento tiene estados numerados. Se avanza de a un paso; volver atrás
exige confirmar y escribir el motivo, que queda en el historial.

## 4. Etapas

### Etapa 1 — Maqueta MVP e impresión de etiquetas (1 semana)

Maqueta navegable de todas las pantallas con el diseño visual
tentativo (colores e identidad de la empresa), en celular y computadora.
Módulo para impresión de etiquetas.
Recorrido con los referentes de cada rol en sus celulares, ajustes según lo
que surja, respuesta a las preguntas abiertas y registro de las sugerencias
de cambios.

### Etapa 2 — Operación (8 semanas)

| Entrega | Nombre | Qué se entrega |
|---|---|---|
| 2.1 | Definición e infraestructura | Requerimientos consolidados, maqueta de los flujos, servidor y proyecto base. |
| 2.2 | Base y administración | Ingreso con usuario y contraseña, elección del depósito de trabajo, menú según permisos, roles configurables, sucursales, depósitos, usuarios, proveedores, departamentos, transportistas, configuración y el manejo de estados con historial. |
| 2.3 | Órdenes de preparación | Alta y seguimiento de OP, pantalla de armado con escaneo por cámara y lector, validaciones del código de bulto y control de cantidad. |
| 2.4 | Hojas de ruta | Calendario, alta y numeración, armado con OP, cierre, reapertura y cancelación manual y automática; listado de hojas de ruta con sus OP y detalle de bultos. |
| 2.5 | Despacho | Control de carga por escaneo de la HR, datos del transportista y patente, impresión del remito y paso a Despachada. |
| 2.6 | Recepción | Recepción por escaneo de los bultos, registro del estado - ok, abiertos o dañados - notificación de ajenos, estados automáticos de la hoja de ruta. |
| 2.7 | Arranque operativo | Instalación en el celular como aplicación, revisión de seguridad, pase a producción con los datos iniciales, prueba piloto en un depósito con ajustes, capacitación por rol y acompañamiento de las dos primeras semanas de uso. |

Al terminar la Etapa 2, los depósitos operan con el sistema. El estado de
cada documento se consulta en los listados de órdenes y hojas de ruta.

### Etapa 3 — Seguimiento (2 semanas)

Paneles de estado de hojas de ruta y órdenes, detalle de recepciones,
detalle de despachos y bultos abiertos o dañados, con filtros; indicadores
adicionales propuestos y validados con ustedes (por ejemplo, tiempos entre
preparación, despacho y recepción); correo a la sucursal de destino al
despachar; ajustes de uso detectados en las primeras semanas.

### Aceptación de cada etapa y entrega

1. Presentamos lo hecho en el entorno de prueba, accesible por internet
   desde cualquier celular.
2. Ustedes lo prueban con sus usuarios dentro de la semana y nos envían
   observaciones. Mientras tanto avanzamos con lo siguiente.
3. Corregimos lo que no cumpla lo acordado y la etapa o entrega se da por
   aceptada.

## 5. Funcionalidades incluidas

**Administración**

- Sucursales, depósitos, usuarios, proveedores, departamentos y empresas
  transportistas.
- Roles configurables: el administrador decide qué pantallas y acciones
  habilita cada rol, y puede sumar permisos a un usuario puntual.
- Cada usuario pertenece a una sucursal, trabaja en uno o más de sus
  depósitos y ve solo lo que le corresponde. Una sucursal puede habilitarse
  para ver todas.
- Configuración general (por ejemplo, el prefijo del remito).
- Parametrización de etiquetas.

**Uso en depósito**

- Pantallas pensadas primero para el celular, también usables en
  computadora.
- Se instala en el celular como una aplicación, sin pasar por las tiendas de
  aplicaciones.
- Funciona con conexión a internet.

## 6. Cómo trabajamos

- **Todo queda documentado:** requerimientos numerados, reglas del negocio,
  preguntas abiertas con su respuesta y un registro de cada tarea. Si dentro
  de un año hay que modificar algo, se sabe por qué está hecho así.
- **Cada regla del negocio tiene una prueba automática** que verifica que se
  cumple; antes de cada entrega se corren todas.
- **Dos entornos separados:** uno de desarrollo y prueba, y otro de
  producción con bases de datos distintas. Lo que se prueba no toca los
  datos reales.

## 7. Tecnología

Next.js y MariaDB, sobre un servidor en la nube con S.O. AlmaLinux. 
Conexión segura (HTTPS) lo que posibilita que corra en cualquier dispositivo
conectado a internet.

## 8. Propuesta económica

El costo total del proyecto tendrá un costo de **USD 13.740 + IVA**

La propuesta está expresada en dólares estadounidenses (USD) o su equivalente en pesos argentinos según cotización oficial Billete tipo vendedor del BNA.

## 9. Forma de pago

| Momento | Porcentaje | USD |
|---|---:|---:|
| Para iniciar el proyecto (adelanto) | 30 % | 4.122 |
| Con la entrega de la Etapa 2 | 40 % | 5.496 |
| Al finalizar el proyecto | 30 % | 4.122 |
| **Total** | **100 %** | **13.740** |
Los importes no incluyen IVA.

## 10. Alcance del proyecto

- Todos los entregables descriptos en la propuesta para cada etapa, incluidas las
  correcciones solicitadas.
- Ajustes menores de textos, orden de campos o presentación que surjan al
  probar cada etapa.
- Los cambios que surjan luego de las pruebas preliminares de
  la maqueta realizadas por el cliente, definirán el alcance del proyecto;
  un cambio posterior a algo ya validado se cotiza aparte.
- **Impresión del remito:** sobre un formulario preimpreso común en
  impresora de oficina. Una impresora especial o un formulario con más de
  un modelo se cotiza aparte.
- **Indicadores adicionales (Etapa 3):** hasta cinco indicadores, acordados
  al empezar la etapa.

## 11. Cambios de alcance

Los aspectos que no están contemplados en la propuesta, o modificaciones de algo ya aceptado, se cotiza aparte con precio fijo antes de hacerlo, y se informa cómo afectará
los plazos de entrega.

## 12. Costos de terceros (no incluidos)

| Concepto | Comentario |
|---|---|
| Servicio de hosting (VPS con certificados SSL) para producción | Servidor donde corre la aplicación, con dominio propio y conexión segura (HTTPS) desde cualquier celular. |
| Servidor de correo (SMTP) | Puede ser el que ya usa la empresa. |
| Celulares, lectores de códigos de barra e impresoras | Los existentes en los depósitos sirven si tienen cámara y navegador actualizado. |

## 13. Qué necesitamos de ustedes

- Un referente por rol (preparación, despacho, recepción, supervisor) para
  probar cada etapa dentro de la semana de presentada y responder consultas.
- El formulario preimpreso del remito escaneado,
  con sus medidas y qué dato va en cada lugar.
- Respuesta a las preguntas que surjan sobre hojas de ruta,
  despacho y recepción.
- Los datos iniciales (sucursales, depósitos,
  usuarios, proveedores, departamentos y transportistas), el depósito
  elegido para la prueba piloto y, para producción.
- Los datos del servidor de correo.

La falta de cumplimiento o la demora de estos requisitos impactará en los plazos
del proyecto.

## 14. Fuera de alcance

- Funcionamiento sin conexión a internet.
- Integración con otros sistemas (ERP, facturación, stock).
- Aplicación nativa publicada en las tiendas de Android o iOS.
- Compra o configuración de celulares, lectores o impresoras.
- Soporte y mantenimiento después de las dos semanas de acompañamiento
  (se puede contratar aparte).
