# Seguimiento del proyecto — Zeitune Logística

Última actualización: 12/11/2026

## Estado actual

**Etapa 0 — Definición e infraestructura.** Requerimientos consolidados
(versión 3) y stack aceptado (decisiones `0002` y `0003`), con una revisión
técnica del stack pendiente. Quedan abiertas `PR-13` (formato del remito, Etapa 4)
y `PR-28` (detalles del estado Incompleta, Etapa 5). Falta preparar el servidor (`PT-03` a
`PT-06`). No hay código de la aplicación; mientras tanto se arma una maqueta
navegable estática (`maqueta/`) para validar flujos con el cliente: hechas la
entrega 1, la 2a (hojas de ruta y despacho) y la 2b (recepción); sigue la 3.

## Etapas (propuesta)

Cada etapa termina con algo que se puede usar y probar en el celular. El orden
sigue el recorrido de un bulto: nace en la OP, viaja en la HR, sale con el DS y
llega con la RC.

| Etapa | Contenido | Requerimientos | Estado |
|---|---|---|---|
| 0 | Definición e infraestructura: Node, bases, vhosts, HTTPS, proyecto Next.js base con lint, tests y despliegue | `PT-03` a `PT-07` (`PT-08` y `PT-09` se necesitan en las Etapas 6 y 3) | 🔄 En curso |
| 1 | Base: ingreso, depósito de trabajo, maestros, configuración, roles y permisos, menú dinámico, visibilidad por sucursal, módulo de estados con historial | `RF-01` a `RF-08`, `RF-25`, `RF-26`, `RF-32`, `RF-33`, `RN-01` a `RN-07`, `RN-30` | ⏳ Pendiente |
| 2 | Órdenes de preparación y bultos: creación, armado, componente de escaneo (lector y cámara), validaciones del EAN13 | `RF-09` a `RF-12`, `RN-08` a `RN-17`, `RN-31`, `RN-36` | ⏳ Pendiente |
| 3 | Hojas de ruta: creación con calendario, numerador, asignación y pase de OP, cierre, retroceso, cancelación | `RF-13` a `RF-16`, `RN-18` a `RN-22`, `RN-32` a `RN-35` | ⏳ Pendiente |
| 4 | Despacho: Carga con escaneo, DS, impresión del remito preimpreso, HR Despachada | `RF-17` a `RF-19`, `RN-23`, `RN-24`, `RN-26`, `RN-27` | ⏳ Pendiente |
| 5 | Recepción: RC, escaneo, abiertos, dañados y ajenos, estados automáticos de la HR, Observada | `RF-20` a `RF-24`, `RF-35`, `RN-25`, `RN-28`, `RN-29`, `RN-37` | ⏳ Pendiente |
| 6 | Paneles de seguimiento con indicadores y correo al despachar | `RF-27` a `RF-31`, `RF-34` | ⏳ Pendiente |
| 7 | PWA, ajustes de uso en depósito, capacitación y pase a producción | — | ⏳ Pendiente |

Referencias: ✅ Hecho · 🔄 En curso · ⏳ Pendiente · ⛔ Bloqueado

## Etapa 0 — Detalle

| Tarea | Estado | Referencia |
|---|---|---|
| Consolidación de requerimientos y propuesta de implementación | ✅ 11/11/2026 | `20261111-02` |
| Respuestas del cliente a las preguntas bloqueantes | ✅ 11/11/2026 | `20261111-03`; quedan abiertas `PR-13` (Etapa 4) y `PR-28` (Etapa 5) |
| Confirmación de las decisiones de stack y permisos | ✅ 11/11/2026 | `20261111-03`, decisiones `0002` y `0003` |
| Node.js 24 LTS, bases y usuarios | ⏳ | `PT-03`, `PT-04` |
| Dominios, vhosts y HTTPS | ⏳ | `PT-05`, `PT-06` |
| Revisión técnica del stack (en otra conversación) | ⏳ | Decisión `0003` |
| Proyecto Next.js base (lint, typecheck, Vitest, Playwright, Drizzle conectado a `logistica_dev`, prueba de migración en MariaDB) | ⏳ | Depende de `PT-03`, `PT-04` |
| Maqueta navegable para el cliente, entrega 1: base, menú por permisos, OP y armado con escaneo | ✅ 11/11/2026 | `20261111-04`, `maqueta/README.md` |
| Maqueta, entrega 2a: hojas de ruta y despacho con remito | ✅ 11/11/2026 | `20261111-05`, `maqueta/README.md` |
| Maqueta, entrega 2b: recepción con condición del bulto, observaciones y HR Incompleta | ✅ 12/11/2026 | `20261112-01`, `maqueta/README.md` |
| Maqueta, entrega 3: paneles e indicadores, administración y permisos | ⏳ | — |

## Avance por módulo

Un módulo se marca hecho cuando sus pantallas funcionan en celular y
escritorio, sus `RN` tienen tests y está registrado.

| Módulo | Etapa | Estado |
|---|---|---|
| Ingreso y depósito de trabajo | 1 | ⏳ |
| Maestros y configuración | 1 | ⏳ |
| Roles y permisos | 1 | ⏳ |
| Estados e historial | 1 | ⏳ |
| Órdenes de preparación y escaneo | 2 | ⏳ |
| Hojas de ruta | 3 | ⏳ |
| Despacho | 4 | ⏳ |
| Recepción | 5 | ⏳ |
| Paneles de seguimiento | 6 | ⏳ |

## Próximos pasos

1. El mantenedor instala Node y crea las bases (`PT-03`, `PT-04`); con eso se
   puede crear el proyecto base aunque falten dominios y HTTPS.
2. Dominios, vhosts y HTTPS (`PT-05`, `PT-06`), necesarios para probar la
   cámara en el celular.
3. Revisión técnica del stack (en otra conversación); si cambia algo, se
   registra en una decisión que reemplace a `0003`.
4. Antes de la Etapa 4, el cliente envía el formato del remito (`PR-13`).
5. Maqueta: demo de las entregas 1 y 2 con el cliente, llevando `PR-28` a
   `PR-33`, y volcar sus correcciones a requerimientos y pendientes. Después,
   la entrega 3 (`maqueta/README.md`).

## Bitácora

Una línea por registro de trabajo, el más reciente arriba.

| Registro | Tema |
|---|---|
| `revisiones/20261112-01_maqueta-recepcion.md` | Maqueta, entrega 2b: recepción, observaciones, estados automáticos de la HR e Incompleta |
| `revisiones/20261111-05_maqueta-hr-despacho.md` | Maqueta, entrega 2a: hojas de ruta y despacho con remito |
| `revisiones/20261111-04_maqueta-base-op.md` | Análisis y propuesta de maqueta; entrega 1: base, permisos, OP y armado con escaneo |
| `revisiones/20261111-03_respuestas-cliente.md` | Respuestas del cliente (`PR-01` a `PR-27`, salvo `PR-13`) y cambio de Prisma a Drizzle |
| `revisiones/20261111-02_propuesta-implementacion.md` | Consolidación de los borradores y propuesta de implementación |
| `revisiones/20261111-01_reinicio-proyecto.md` | Reinicio del proyecto: se borra lo anterior y queda la estructura de trabajo |
