# 11/11/2026 — Consolidación de los borradores y propuesta de implementación

## Prompt del usuario

**Mensaje inicial**

```text
Analizá el archivo docs/borradores/Aplicación Zeitune Logística.md y tomalo como inicio del proyecto y hacé una propuesta de implementación.
```

## Pedido

Tomar `docs/borradores/Aplicación Zeitune Logística.md` como fuente inicial
del proyecto, analizarla junto con los borradores que enlaza (`Bultos.md`,
`OP - OrdenDePreparacion.md`, `HR - HojasDeRuta.md`, `DS - Despacho.md`,
`RC - Recepcion.md`, `RoldeUsuarios.md`, `EAN_ejemplo.png`) y proponer cómo
implementarla. Los borradores no se editan. No se escribe código: no hay Node
en el servidor ni bases creadas.

## Qué se hizo

- **`docs/requerimientos/requerimientos.md`:** de plantilla vacía a versión 1
  consolidada: glosario, `RF-01` a `RF-31`, `RN-01` a `RN-30`, estados de HR,
  OP, RC y bulto, roles, y campos de cada documento indicando cuáles se
  heredan. Cada contradicción o hueco quedó marcado como INCIERTO con su `PR`.
- **`docs/pendientes.md`:** 22 preguntas al cliente (`PR-01` a `PR-22`), 8
  bloqueantes, y pendientes técnicos de infraestructura (`PT-02` a `PT-07`).
  `PT-01` (stack) se cierra: el cliente fija Next.js y MariaDB.
- **Decisiones (en estado Propuesta):**
  - `0001-stack.md`: Prisma, Mantine, `@zxing/browser`, sesión propia, Zod,
    Vitest y Playwright, sobre Node 24 LTS.
  - `0002-permisos.md`: un único mecanismo de permisos (pantallas y
    acciones) para resolver la contradicción entre "roles configurables por
    ítems de menú" y "lo hace el rol supervisor".
- **`docs/arquitectura.md`:** stack, entornos, modelo de datos tentativo,
  módulo común de estados con historial, numeradores con bloqueo de fila y
  componente único de escaneo.
- **`docs/seguimiento.md`:** plan en 8 etapas (0 a 7) que sigue el recorrido
  del bulto (OP → HR → DS → RC → paneles), con los `RF`/`RN` de cada una.

Criterios de la consolidación:

- Cuando dos fuentes chocan, se siguió el **proceso** descripto en el
  principal por sobre las listas de propiedades. Ejemplo: el bulto pasa a
  Despachado al escanearse en la Carga, no "cuando la OP esté despachada"
  (la OP no tiene ese estado).
- Los campos heredados no se copian en el modelo: el bulto lee proveedor,
  departamento y depósitos de su OP (una sola fuente por dato).
- La recepción no se ata a una HR: el principal dice que las HR pueden llegar
  consolidadas o divididas por el transporte. Cada escaneo es un ítem de la RC
  y actualiza el estado de la HR a la que pertenece el bulto.

## Requerimientos y decisiones

- Decisiones creadas: `0001` (stack) y `0002` (permisos), ambas en estado
  Propuesta, a confirmar en `PT-02`.
- **Supuestos** (se implementan así mientras su `PR` siga abierto):
  - Las 2 primeras posiciones del EAN13 son la sucursal de destino (`PR-05`).
  - La OP pasa a Asignada sola cuando está Terminada y tiene HR (`PR-07`).
  - Los bultos abiertos o dañados cuentan como recibidos para que la HR pase
    a Recibida (`PR-08`).
  - Códigos inexistentes o de HR no despachadas se avisan y se anotan en la
    RC (`PR-15`).
  - Si una HR vuelve de Carga a Cerrada, sus bultos vuelven a Preparado
    (`PR-20`).
  - Se trabaja con conexión (`PR-22`).
- Propuestas técnicas, no pedidas por el cliente: `RN-15` (la OP y la HR
  comparten depósitos de origen y destino), `RN-21` (cerrar HR con todas sus
  OP terminadas), `RN-27` (sugerir el próximo número de remito) y `RN-29`
  (solo se reciben bultos de HR despachadas).

## Verificaciones que sirvieron

```bash
node -v      # orden no encontrada: no hay Node en el servidor
mariadb --version   # 10.11.18-MariaDB
httpd -v            # Apache/2.4.62 (AlmaLinux)
```

Dígito verificador del ejemplo de `Bultos.md` (`0100000000236`), calculado con
un script de Python: verificador 6 (coincide), destino `01`, bulto 23.

Referencias cruzadas: todo `PR`/`PT` citado en `docs/` existe en
`pendientes.md`, y todo `RF`/`RN` citado existe en `requerimientos.md`.

## Hallazgos

1. **Roles y permisos se contradicen entre fuentes:** el principal pide roles
   configurables por ítems de menú; las demás fuentes asignan acciones al rol
   por nombre. Se propone la decisión `0002` y se pregunta en `PR-02`.
2. **El "depósito asignado al usuario" no existe en el modelo de las
   fuentes:** al usuario se le asignan sucursales. Se propone elegir un
   depósito de trabajo al ingresar (`PR-03`), y de ahí sale el origen de la OP
   (`PR-04`).
3. **El EAN13 limita los códigos a 2 dígitos** (01 a 99) para el destino,
   mientras el prefijo de la HR usa 5 dígitos para el depósito (`PR-05`).
4. **La OP puede tener HR desde que se crea, pero tiene un estado
   4-Asignada** para cuando se le asigna una HR (`PR-07`).

## Pendiente

- `PR-01` a `PR-22`: preguntas al cliente; las bloqueantes son `PR-01` a
  `PR-05`, `PR-07`, `PR-11` y `PR-12`.
- `PT-02`: confirmar las decisiones `0001` y `0002`.
- `PT-03` a `PT-07`: infraestructura (Node, bases, dominios, HTTPS, backup).

## Archivos modificados

- `docs/requerimientos/requerimientos.md`
- `docs/pendientes.md`
- `docs/arquitectura.md`
- `docs/seguimiento.md`
- `docs/decisiones/0001-stack.md`
- `docs/decisiones/0002-permisos.md`
- `docs/revisiones/20261111-02_propuesta-implementacion.md` (este archivo)
