# 11/11/2026 — Maqueta navegable, entrega 2a: hojas de ruta y despacho

## Prompt del usuario

**Mensaje inicial**

```text
Seguimos con la maqueta navegable: entrega 2 de 3.

Antes de empezar, leé:
- maqueta/README.md: cómo está armada, usuarios, guion y tests.
- docs/revisiones/20261111-04_maqueta-base-op.md: entrega 1, criterios y supuestos.
- docs/requerimientos/requerimientos.md: §2 a §4 (HR, despacho, recepción, estados).
- docs/pendientes.md: PR-13, PR-28, PR-29, PR-30 y PT-10.

Alcance de la entrega 2 (hoy son placeholders en PROXIMAS, en maqueta/js/app.js):
1. Hojas de ruta:
   - Listado con sus OP y bultos (RF-16) y los bultos que faltan en cada etapa.
   - Creación con calendario, fecha y horario mañana/tarde (RF-13). Numerador por prefijo (RN-18, RN-19).
   - Agregar, quitar y pasar OP entre HR (RF-14, RN-15, RN-16). La OP pasa a Asignada (RN-36).
   - Cerrar (RN-21; RN-33 registra quién confirma).
   - Volver a Preparación con motivo (RN-22).
   - Cancelar una HR vacía (RN-20). Mostrar que la cancelación automática de las 23:55 (RN-32) existe, sin simularla con reloj.
   - Rol Preparación: solo ve HR Abiertas o en Preparación (RN-34).
2. Despacho:
   - Elegir destino y tomar una HR Cerrada (pasa a Carga), y escanear la carga viendo lo que falta (RF-17, RN-23).
   - Si la HR vuelve de Carga a Cerrada, los bultos vuelven a Preparado (RN-35).
   - DS con transportista, patente y uno o más remitos, cada uno con prefijo, número sugerido y valor declarado (RF-18, RN-26, RN-27).
   - HR Despachada (RN-24). Mostrar el aviso de que "se envió el correo" (RF-31), sin enviar nada.
   - Vista de impresión del remito, genérica y marcada "formato pendiente PR-13" (RF-19).
3. Recepción:
   - Crear una RC en el depósito de trabajo y escanear bultos de una o varias HR (RF-20).
   - Marcar cada bulto como recibido, abierto o dañado (RF-21).
   - Observaciones automáticas de bultos ajenos y códigos rechazados (RF-22, RN-28, RN-29).
   - Cerrar la RC (RF-23).
   - Estados automáticos de la HR: Recepción, Recibida u Observada (RN-25).
   - Incompleta, por supervisor y con motivo (RF-35, RN-37), con los supuestos de PR-28.

Cómo seguir (ya acordado en la entrega 1):
- Mismo enfoque: HTML/CSS/JS sin librerías ni CDN. Se abre con doble clic. Datos ficticios.
- Reglas puras en maqueta/js/reglas.js, con tests que nombran su RN en maqueta/pruebas/reglas.prueba.js.
- Datos en maqueta/js/datos.js: sumá HR en todos los estados, con OP, bultos, DS y RC coherentes, para que el guion se pueda recorrer sin preparar nada a mano.
- Reutilizá lo que ya existe: tarjeta de cambio de estado (RF-25), historial (RF-26), diálogo con motivo (RN-06), pantalla de escaneo y "Códigos de ejemplo".
- Si se repite la lógica del escaneo, generalizala en un componente, como prevé docs/arquitectura.md.
- Diseño: logo de San Juan + "Logística", colores del logo en tonos pastel, primero para el celular.
- Lo no definido se marca INCIERTO y lleva su PR-NN. Implementá la opción más fácil de cambiar y anotala como supuesto. No inventes reglas.

Verificación:
- maqueta/pruebas/correr.sh: tests de reglas, con gjs (no hay Node).
- Ampliá maqueta/pruebas/recorrido.py con los flujos nuevos: HR → carga → DS → recepción con un bulto dañado → HR Observada.
- Capturas a 390 px (firefox --headless --screenshot --window-size=390,844) y a 1366 px. Todo en el scratchpad, nunca en el repo.

Al terminar:
- Actualizá maqueta/README.md: guion de la entrega 2 y tabla de entregas.
- Registro con la skill registro-trabajo. Actualizá docs/seguimiento.md y docs/pendientes.md.
- Commit solo cuando te lo pida.

Si la entrega es muy grande, proponé partirla (por ejemplo, 2a HR y despacho, 2b recepción) antes de empezar. Preguntá las dudas que tengas.
```

**Respuesta a pregunta**

¿Parto la entrega en 2a (HR y despacho, hasta la HR Despachada) y 2b
(recepción, hasta la HR Observada), cada una con su registro? → «Partir 2a /
2b (Recommended)».

¿Están bien los supuestos propuestos (Carga → Cerrada solo Supervisor;
quitar OP solo con la HR Abierta o en Preparación; Despacho ve las HR de su
depósito de trabajo; DS y RC con número de 8 dígitos; visibilidad de HR;
condición del bulto elegida antes de escanear)? → «Sí, seguí así
(Recommended)».

## Pedido

Entrega 2 de la maqueta (`maqueta/`), partida a pedido del agente en dos
tareas. **Esta es la 2a: hojas de ruta y despacho**, hasta la HR Despachada
con su DS y la vista de impresión del remito.

- Hojas de ruta: `RF-13` a `RF-16`, `RN-15`, `RN-16`, `RN-18` a `RN-22`,
  `RN-32` (solo el aviso), `RN-33`, `RN-34`, `RN-36`.
- Despacho: `RF-17` a `RF-19`, `RF-31` (simulado), `RN-23`, `RN-24`,
  `RN-26`, `RN-27`, `RN-35`.
- Componente de escaneo común (OP y Carga; la 2b le suma la RC).
- Afuera, para la **2b**: recepción (`RF-20` a `RF-23`, `RF-35`, `RN-25`,
  `RN-28`, `RN-29`, `RN-37`), las HR de ejemplo en Recepción, Recibida,
  Observada e Incompleta con sus RC, y el tramo del recorrido e2e desde la
  recepción con un bulto dañado hasta la HR Observada.

## Qué se hizo

- **`maqueta/js/reglas.js`**: reglas nuevas como funciones puras.
  - Visibilidad de HR (`puedeVerHR`) y resumen de bultos por etapa
    (`resumenHR`): cuánto falta preparar, cargar o recibir.
  - Alta de HR con prefijo y numerador (`crearHR`, `prefijoHR`,
    `proximoNumeroHR`).
  - OP en la HR: `agregarOPaHR` (Terminada → Asignada automática),
    `quitarOPdeHR` (Asignada → Terminada) y `pasarOP`.
  - Estados de la HR: `opcionesEstadoHR` arma la lista anterior/siguiente con
    el motivo de cada bloqueo, igual que la de OP. Además `habilitarHR`,
    `cerrarHR`, `retrocederHR` (con `RN-35`) y `cancelarHR`.
  - Cancelación automática: `hrsACancelarAutomaticamente` y
    `cancelarAutomaticamente`. Tienen test, pero la interfaz no las corre:
    solo muestra el aviso, como se pidió.
  - Despacho: `hrsParaDespacho`, `tomarHRCarga`, `validarCarga` y
    `cargarBulto`, `sugerirNumeroRemito`, `crearDS`. Al crear el DS se anota
    el correo a la sucursal de destino, sin enviarlo.
- **`maqueta/js/datos.js`**:
  - **Datos guardados:** `VERSION_DATOS` pasa a 2, así que lo guardado en el
    navegador por la entrega 1 se descarta solo.
  - **Permisos nuevos:** `hr.editar_op` (habilitar una HR y agregar, quitar
    o pasar OP) y `hr.ver_avanzadas` (ver HR desde Cerrada). Con este último,
    `RN-34` queda expresada como permiso y no como nombre de rol
    (decisión `0002`).
  - **Supervisor:** suma `despacho.cargar` y `ds.crear`, porque según §5
    trabaja con DS.
  - **HR de ejemplo:** se agregan 6, en Cancelada (cancelada por el sistema
    a las 23:55), Despachada (2, con DS de 1 y de 2 remitos), Cerrada, Carga
    (con 2 de 4 bultos cargados) y Abierta vacía. Tienen 6 OP y sus bultos.
  - **Numeración:** son anteriores a las de la entrega 1 y usan números más
    bajos. Así no cambian los números que esperan sus tests ni el recorrido
    (la próxima OP sigue siendo `00000108` y la próxima HR del prefijo
    `00001`, la `15`).
- **`maqueta/js/app.js`**:
  - **Componente de escaneo:** `componenteEscaneo` junta el campo con foco
    permanente, la cámara, el resultado y los códigos de ejemplo. Cada
    pantalla aporta qué hace con el código (`PROCESADORES`: `op` y
    `carga`). La lectura doble en menos de 2 s se sigue ignorando.
    `?escanear=` también funciona en la carga.
  - **Cambio de estado:** la tarjeta (`RF-25`) y la acción sirven para OP y
    HR (`TIPOS`, `SIGUIENTE`). El retroceso reutiliza el par de diálogos de
    confirmación y motivo (`RN-06`).
  - **Diálogo:** suma un selector, que se usa para elegir la HR al pasar una
    OP.
  - **Vistas nuevas:**
    - *Hojas de ruta*: chips por estado, búsqueda por HR u OP, tarjetas con
      sus OP, lo que falta en la etapa y una barra de avance.
    - *Nueva HR*: calendario mensual con la cantidad de HR por día y el
      formulario que anticipa el número.
    - *Detalle de HR*:
      - ficha con quién confirmó y cambio de estado;
      - OP con *Quitar* y *Pasar a otra HR*, y *Agregar OP* con las
        compatibles;
      - *Cancelar*, que se deshabilita con el motivo si tiene OP;
      - aviso de `RN-32` si está vacía, e historial.
    - *Despacho*: chips de destino, HR en Carga y Cerradas del depósito de
      trabajo, despachos recientes.
    - *Carga*: escaneo con contador, faltantes y cargados.
    - *Nuevo despacho*: remitos dinámicos con número sugerido.
    - *Despacho* (detalle): remitos, valor total y la tarjeta del correo.
    - *Remitos*: una hoja imprimible por remito, con la marca "formato
      pendiente PR-13" y estilos `@media print`.
  - **Inicio:** suma indicadores de HR y despacho, y el botón *Nueva hoja de
    ruta*. En el menú, Recepción figura como "entrega 2b".
- **`maqueta/css/estilos.css`**: colores pastel para los estados nuevos de la
  HR y del bulto, más los estilos del calendario, el control segmentado
  mañana/tarde, la lista de OP de la HR, los remitos y la impresión.
- **`maqueta/index.html`**: selector opcional en el diálogo.
- **`maqueta/pruebas/`**: 24 tests de reglas nuevos (44 en total) y
  31 verificaciones nuevas en el recorrido (60 en total).
- **`maqueta/README.md`**: guion de la entrega 2a, nota sobre `RN-32` y
  tabla de entregas con 2a y 2b.
- No se agregaron dependencias.

## Requerimientos y decisiones

| ID | Qué pasó | Test o verificación |
|---|---|---|
| `RF-13`, `RF-14`, `RF-16`, `RF-17`, `RF-18`, `RF-19`, `RF-31` | Simulados en la maqueta | `recorrido.py`; `RF-13`, `RF-16` y `RF-17` también con test |
| `RN-18`, `RN-19` | Prefijo y numerador de HR | `it('RN-18: …')`, `it('RN-19: …')` |
| `RN-15`, `RN-16`, `RN-36` | Agregar y pasar OP | `it('RN-15: se agrega …')`, `it('RN-16: …')`, `it('RN-36: al agregar …')` |
| `RN-20`, `RN-21`, `RN-22`, `RN-33` | Cancelar, cerrar, volver | Un test por regla |
| `RN-32` | Regla con test; en la interfaz, solo el aviso y una HR ya cancelada | `it('RN-32: …')` |
| `RN-34`, `RN-04` | Visibilidad de HR | `it('RN-34: …')`, `it('RN-04: Recepción ve …')` |
| `RN-23`, `RN-24`, `RN-26`, `RN-27`, `RN-35` | Carga y DS | Un test por regla (`RN-27`, dos) |

**Supuestos** (sin definición del cliente; aceptados por el mantenedor para la
maqueta):

- `PR-31` (a) a (e): quién vuelve de Carga a Cerrada, desde qué estados se
  quita una OP, HR con fecha pasada, HR vacía sin cierre y qué HR ve cada
  usuario.
- `PR-32` (a) a (c): HR del depósito de trabajo en Despacho, remito repetido
  y formato de los números de DS y remito.
- `PR-29`: al quitar una OP Asignada de su HR vuelve a Terminada (supuesto de
  la entrega 1, ahora implementado y con test).

## Verificaciones que sirvieron

```bash
maqueta/pruebas/correr.sh                  # 44 tests, 0 fallidos
python3 maqueta/pruebas/recorrido.py <tmp> # 60 verificaciones, 0 fallas
```

| Prueba en navegador (Firefox sin ventana) | Ancho | Resultado |
|---|---|---|
| Listado de HR, detalle, calendario, carga, formulario de DS | 390 px (`--screenshot`) | Bien |
| Despacho, detalle de HR Cerrada, remitos | 1366 px (`--screenshot`) | Bien |
| Recorrido nuevo, de punta a punta: Preparación solo ve Abiertas o en Preparación, ni por URL (`RN-34`). Alta con calendario, con el número anticipado (`RN-18`, `RN-19`). Habilitar, agregar una OP Terminada que pasa a Asignada (`RN-36`), pasar una OP (`RN-16`). Cerrar con quien confirma (`RN-33`) y volver con motivo obligatorio (`RN-22`, `RN-06`). Cancelar, bloqueado con OP y hecho con la HR vacía (`RN-20`). Carga → Cerrada con los bultos de vuelta a Preparado (`RN-35`). Despacho por destino; tomar; escaneo con un bulto ajeno rechazado (`RN-23`) y uno repetido. DS con remitos sugeridos `00001523` y `00001524` (`RN-27`), error sin transportista, HR Despachada (`RN-24`), correo (`RF-31`), dos hojas de remito con la marca `PR-13` (`RF-19`) | 1366 y 450 px (mínimo de la ventana con Marionette) | 60 de 60 |

**No se verificó:**

- **`npm run lint`, `typecheck` y `test`:** no hay proyecto Node (`PT-03`).
- **La impresión en papel:** solo se vio la vista en pantalla.
- **Chrome y un celular real:** no están disponibles en el servidor.

## Hallazgos

1. **El Supervisor no tenía las acciones de despacho.** En la entrega 1 tenía
   la pantalla *Despacho* pero no `despacho.cargar` ni `ds.crear`, aunque §5
   dice que trabaja con DS. Se corrigió en la carga inicial de roles. Las
   acciones de RC (`rc.crear`, `rc.cerrar`) faltan por el mismo motivo y se
   revisan en la 2b.

## Pendiente

- `PR-31` y `PR-32`: supuestos de hojas de ruta y despacho, para la demo con
  el cliente.
- Entrega 2b de la maqueta (recepción): en `docs/seguimiento.md`.

## Archivos modificados

- `maqueta/README.md`
- `maqueta/index.html`
- `maqueta/css/estilos.css`
- `maqueta/js/reglas.js`
- `maqueta/js/datos.js`
- `maqueta/js/app.js`
- `maqueta/pruebas/reglas.prueba.js`
- `maqueta/pruebas/recorrido.py`
- `docs/pendientes.md`
- `docs/seguimiento.md`
- `docs/revisiones/20261111-05_maqueta-hr-despacho.md` (este archivo)
