# Propuesta de proyecto — Zeitune Logística

Cliente: Grandes Tiendas San Juan · Fecha: 16/11/2026 · Versión 1

Horas, plazos, importes y condiciones: `cotizacion.md`, en esta misma
carpeta.

## 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.

El trabajo se divide en **ocho etapas**. Cada una termina con algo que el
personal de los depósitos puede usar y probar en el celular, en el mismo
orden en que viaja un bulto: nace en la orden de preparación, viaja en la
hoja de ruta, sale con el despacho y llega con la recepción.

La primera etapa (definición, maqueta navegable e infraestructura) está casi
terminada: los requerimientos están consolidados y respondidos por ustedes, y
la maqueta permite recorrer los flujos antes de programarlos.

## 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 todo esto sin llamar por teléfono a cada depósito.

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, se imprime el remito y se envía un correo a la sucursal de destino. |
| 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. |

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. Funcionalidades

**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).

**Operación**

- Órdenes de preparación con armado por escaneo (cámara, lector o tipeo) y
  control de la cantidad de bultos.
- Hojas de ruta con calendario, numeración automática por depósito,
  agregado y pase de órdenes entre hojas, cierre y cancelación.
- Despacho con control de carga, varios remitos por despacho e impresión
  sobre el formulario preimpreso.
- Recepción de bultos de una o varias hojas de ruta, con registro de bultos
  abiertos, dañados o ajenos, y cambios de estado automáticos.
- Historial de estados de cada documento.

**Seguimiento**

- Paneles: estado de hojas de ruta y órdenes, detalle de recepciones,
  detalle de despachos y bultos abiertos o dañados.
- Indicadores adicionales que proponemos y validamos con ustedes (por
  ejemplo, tiempos entre preparación, despacho y recepción, o bultos
  pendientes por depósito).
- Correo automático a la sucursal de destino cuando sale un envío.

**Uso en depósito**

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

## 5. Etapas

| Etapa | Nombre | Qué se entrega |
|---|---|---|
| 0 | Definición e infraestructura | Requerimientos consolidados, maqueta navegable de todos los flujos, servidor y proyecto base. **Casi terminada.** |
| 1 | Base y administración | Ingreso con usuario y contraseña, elección del depósito de trabajo, menú según permisos, todas las pantallas de administración y el manejo de estados con historial. |
| 2 | Ó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. |
| 3 | Hojas de ruta | Calendario, alta y numeración, armado con OP, cierre, reapertura y cancelación manual y automática. |
| 4 | Despacho | Control de carga por escaneo, despacho con remitos, impresión del remito y paso a Despachada. |
| 5 | Recepción | Recepción por escaneo, bultos abiertos, dañados o ajenos, estados automáticos de la hoja de ruta. |
| 6 | Seguimiento y avisos | Paneles con filtros, indicadores y correo al despachar. |
| 7 | Puesta en marcha | Instalación en el celular, prueba piloto en un depósito con ajustes, pase a producción, capacitación y acompañamiento de las dos primeras semanas. |

Al terminar cada etapa:

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

Los cambios a lo acordado que surjan en las pruebas se evalúan juntos: si
entran en las horas de la etapa se hacen; si no, se cotizan aparte (ver
`cotizacion.md`).

## 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.
- **Lo no definido no se inventa:** se pregunta. Si hace falta avanzar, se
  implementa la opción más fácil de cambiar y queda anotada hasta que
  ustedes la confirmen.

## 7. Tecnología

Next.js y MariaDB (pedidos por ustedes), sobre un servidor propio con
AlmaLinux. Conexión segura (HTTPS) en todos los celulares sin instalar nada.
El código y la base quedan en su servidor.

## 8. Qué necesitamos de ustedes

- Un referente por rol (preparación, despacho, recepción, supervisor) para
  probar cada etapa y responder consultas.
- El formulario preimpreso del remito escaneado, con sus medidas y qué dato
  va en cada lugar (antes de la Etapa 4).
- Respuesta a las preguntas que quedan abiertas sobre hojas de ruta,
  despacho y recepción; ninguna frena el inicio, se repasan en la
  presentación de la maqueta.
- Los datos iniciales: sucursales, depósitos, usuarios, proveedores,
  departamentos y transportistas.
- Los datos del servidor de correo para el aviso de despacho.
- Para producción: dominio de acceso y, si corresponde, contratación del
  plan del servicio de túnel seguro (ver `cotizacion.md`, costos de
  terceros).

## 9. 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).
