# 12/11/2026 — Maqueta navegable, entrega 2b: recepción

## Prompt del usuario

El pedido completo de la entrega 2 y las respuestas a las preguntas (partir
en 2a y 2b; supuestos aceptados) están transcriptos en
`docs/revisiones/20261111-05_maqueta-hr-despacho.md`. Después del commit de
la 2a, el agente ofreció seguir con la 2b.

**Agregado**

```text
si, continúa con 2b
```

## Pedido

Segunda parte de la entrega 2 de la maqueta (`maqueta/`): **recepción**,
desde la HR Despachada hasta Recibida, Observada o Incompleta.

- Recepción: `RF-20` a `RF-23`, `RF-35`, `RN-25`, `RN-28`, `RN-29`,
  `RN-37`, con los supuestos de `PR-28`.
- HR de ejemplo en Recepción, Recibida, Observada e Incompleta, con sus RC.
- Sumar las acciones de RC al Supervisor (hallazgo de la 2a).
- Contexto `rc` en el componente de escaneo común.
- Completar el recorrido e2e pedido: HR → carga → DS → recepción con un
  bulto dañado → HR Observada.
- README, registro, seguimiento y pendientes. Sin commit hasta que se pida.

## Qué se hizo

- **`maqueta/js/reglas.js`**: sección nueva de recepción, con funciones
  puras.
  - RC: `crearRC` (en un depósito del usuario, número de 8 dígitos),
    `opcionesEstadoRC` y `cerrarRC` (Abierta → Cerrada), y las búsquedas
    `bultosDeRC`, `hrsDeRC`, `rcsDeHR`, `hrsEnCamino` y `puedeVerRC`.
  - `recibirBulto` valida en este orden:
    1. lectura válida (`RN-09`);
    2. bulto existente (`RN-29`);
    3. destinado al depósito de la RC (`RN-28`);
    4. que no se haya recibido antes;
    5. HR Despachada o en Recepción (`RN-29`; si la HR está Incompleta,
       supuesto `PR-28` (c)).

    Si pasa todo, el bulto queda Recepcionado, Abierto o Dañado, con la RC
    y la hora en que se recibió.
  - **Observaciones (`RF-22`):** los rechazos de los puntos 2, 3 y 5 se
    anotan en la RC, y también los bultos abiertos o dañados.
  - **Estado de la HR (`RN-25`):** `actualizarEstadoRecepcion` lo recalcula
    en cada lectura. La primera pasa la HR a Recepción. Con todos los
    bultos recibidos, pasa a Recibida, u Observada con el motivo "N bultos
    llegaron abiertos o dañados". Los pasos quedan en el historial como
    automáticos, a nombre de quien escaneó.
  - **Incompleta (`RN-37`):** `puedeMarcarIncompleta` y `marcarIncompleta`.
    Requiere el permiso `hr.incompleta`, la HR en Recepción y un motivo; los
    bultos que faltan quedan Despachados.
  - **Ajustes en lo existente:** `resumenHR` suma `observados` y la etapa
    `recibida` (Recibida, Observada e Incompleta). `opcionesEstadoHR` cubre
    Recepción, con ambas opciones bloqueadas porque son automáticas
    (`RN-07`).
- **`maqueta/js/datos.js`**:
  - **Datos guardados:** `VERSION_DATOS` pasa a 3.
  - **Supervisor:** suma `rc.crear` y `rc.cerrar`, porque según §5 trabaja
    con RC.
  - **HR de ejemplo:** 4 nuevas, con número bajo para no mover los
    numeradores que esperan los tests:

    | HR | Estado | Detalle |
    |---|---|---|
    | `00001-00000005` | Recibida | — |
    | `00001-00000006` | Observada | un bulto dañado |
    | `00001-00000007` | Incompleta | motivo cargado por Valeria |
    | `00002-00000003` | Recepción | 2 de 4 bultos recibidos |

    Tienen 4 OP (`00000081` a `00000084`) y sus bultos.
  - **RC de ejemplo:** 4, tres cerradas y una abierta (`00000004`, con 2
    observaciones).
  - **DS:** se renumeraron en orden cronológico, del `00000001` al
    `00000006`, con los remitos `00001514` a `00001522`. El próximo DS pasa
    a ser el `00000007`; el próximo remito sigue siendo el `00001523`.
  - **Constructor:** los DS se arman con una función que toma el correo de
    la sucursal de destino desde los datos.
- **`maqueta/js/app.js`**:
  - *Recepción* deja de ser una pantalla "próxima" (`PROXIMAS`).
  - **Rutas nuevas:** `#/recepcion` y `#/recepcion/NNNNNNNN`. La segunda es
    el escaneo si la RC está abierta y el usuario puede recibir; si no, el
    detalle de solo lectura.
  - **Pantalla *Recepción*:** RC abiertas, HR en camino al depósito de
    trabajo y RC cerradas recientes, más el botón *Nueva recepción*.
  - **Escaneo de la RC:**
    - Control segmentado *Condición del próximo bulto* (Recibido, Abierto,
      Dañado), arriba del componente de escaneo común (contexto `rc`).
    - Debajo, las HR de la RC con su avance, los bultos recibidos, las
      observaciones, el historial y *Cerrar recepción*.
    - Un rechazo que se anota también se guarda; antes solo se guardaban
      las lecturas correctas.
  - **Detalle de HR:**
    - En la ficha, las RC que la recibieron.
    - Por OP, recibidos y sin recibir.
    - Tarjeta *Bultos abiertos o dañados* y tarjeta *Marcar Incompleta*,
      esta última con un diálogo que pide motivo.
    - La tarjeta de cambio de estado dice "No tiene más cambios de estado"
      en los estados finales.
  - **Inicio:** con permiso de recepción, muestra los indicadores "HR en
    camino a este depósito" y "Recepciones abiertas", y el botón *Nueva
    recepción*.
  - **Escaneo desde la URL:** `?escanear=` también funciona en
    `#/recepcion/NNNNNNNN`.
- **`maqueta/css/estilos.css`**:
  - Colores pastel para los estados Recepción, Recibida, Observada,
    Incompleta, Recepcionado, Abierto y Dañado.
  - Ámbar y rojo para Abierto y Dañado en el control de condición.
  - Borde de color por tipo de observación.
  - Corrección: las columnas de `.rejilla` desbordaban a 390 px con códigos
    largos; ahora tienen `min-width: 0`.
- **`maqueta/pruebas/`**:
  - `reglas.prueba.js`: 11 tests nuevos (55 en total). Además, el test de
    `RN-24` espera ahora el DS `00000007`.
  - `recorrido.py`: 26 verificaciones nuevas (86 en total) y el número de
    DS actualizado.
- **`maqueta/README.md`**: guion de la entrega 2b, el parámetro `?escanear=`
  en recepción y la tabla de entregas.
- No se agregaron dependencias.

## Requerimientos y decisiones

| ID | Qué pasó | Test o verificación |
|---|---|---|
| `RF-20` | RC en el depósito de trabajo; una RC recibe de varias HR | `it('RF-20: la RC se crea …')`, `it('RN-25: con todos …; una RC recibe de varias HR (RF-20)')`, `recorrido.py` |
| `RF-21` | Condición elegida antes de escanear | `it('RF-21 y RN-25: …')`, `recorrido.py` |
| `RF-22`, `RN-28`, `RN-29` | Rechazos anotados en la RC | `it('RN-28: …')`, `it('RN-29: …')` |
| `RF-23` | Cierre de la RC | `it('RF-20: un bulto ya recibido …; con la RC cerrada no se escanea (RF-23)')` |
| `RN-25` | Recepción, Recibida u Observada automáticas | `it('RF-21 y RN-25: …')`, `it('RN-25: …')` |
| `RF-35`, `RN-37` | Incompleta por supervisor, con motivo | `it('RN-37: solo un supervisor …')`, `it('RN-37 (supuesto PR-28 (c)): …')` |
| `RN-07` | Los estados de recepción no se eligen a mano | `it('RN-07: …')` |
| `RN-04` | Visibilidad de RC y HR en camino | `it('RN-04: la RC se ve en su sucursal …')` |
| `RF-16` | Resumen de la HR recibida | `it('RF-16: el resumen de una HR recibida …')` |

**Supuestos** (sin definición del cliente):

- `PR-28` (a) a (c), ya abiertos: Incompleta es el estado 10; solo se marca
  desde Recepción; un faltante que aparece después no se recibe y se anota.
- `PR-33` (a) a (h), nuevo: varias RC abiertas, qué se anota, corrección de
  un bulto mal recibido, cierre sin condiciones, RC sin reapertura, formato
  del número, la condición del bulto y qué RC ve cada usuario.
  - El número de 8 dígitos (f) y la condición elegida antes de escanear (g)
    ya los había aceptado el mantenedor en la 2a.
  - Sobre (g), un refinamiento del agente: si la lectura se rechaza, la
    condición se conserva, para no perder un "Dañado" por un código mal
    leído.

## Verificaciones que sirvieron

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

| Prueba en navegador (Firefox sin ventana) | Ancho | Resultado |
|---|---|---|
| Inicio de Recepción, pantalla *Recepción*, escaneo de la RC abierta, HR en Recepción con *Marcar Incompleta* | 390 px (`--screenshot`) | Bien, después de corregir el desborde de `.rejilla` |
| Pantalla *Recepción*, detalle de una RC cerrada, HR Observada con su bulto dañado | 1366 px (`--screenshot`) | Bien |
| Recorrido nuevo (detalle abajo) | 450 px (mínimo de la ventana con Marionette) y 1366 px | 26 de 26 |

Recorrido nuevo, primero como Carla (Recepción):

- Crea la RC `00000005`. El primer bulto pasa la HR `00001-00000009` a
  Recepción.
- Elige Dañado antes de escanear, con el foco de vuelta en el campo de
  código. El bulto queda dañado y la condición vuelve a Recibido.
- Al completar la HR, queda Observada. La `00002-00000003`, en la misma RC,
  queda Recibida.
- Rechazos anotados: otro depósito, HR no despachada e inexistente. Un
  bulto ya recibido solo se avisa. La RC termina con 4 observaciones.
- Cierra la RC, que queda Cerrada. La HR muestra el bulto dañado y el motivo
  de Observada en el historial.

Después, como Valeria (Supervisor, depósito 06):

- Crea la RC `00000006` y recibe un bulto: la HR `00002-00000004` pasa a
  Recepción.
- *Marcar Incompleta*: sin motivo no se marca; con motivo, queda Incompleta
  y el bulto que falta sigue Despachado.
- El faltante escaneado después no se recibe y se anota (`PR-28` (c)).
- Como Carla, la acción de marcar Incompleta no aparece.

**No se verificó:**

- **`npm run lint`, `typecheck` y `test`:** no hay proyecto Node (`PT-03`).
- **Chrome y un celular real:** no están disponibles en el servidor.

## Hallazgos

1. **Los DS de ejemplo no seguían el orden cronológico** cuando se sumaron
   HR despachadas antes que las de la 2a. Se renumeraron, y cambiaron dos
   valores esperados en las pruebas: `00000003` → `00000007`. El registro
   `20261111-05` cita el DS `00000003` como resultado de aquel recorrido;
   no se edita porque documenta lo que pasó entonces.
2. **Desborde a 390 px.** Las tarjetas en `.rejilla.dos` se salían de la
   pantalla con códigos de bulto largos (los ítems de grilla tienen
   `min-width: auto`). Se corrigió para todas las pantallas.

## Pendiente

- `PR-33`: supuestos de recepción, y `PR-28`: Incompleta. Llevarlos a la demo
  con el cliente junto con `PR-29` a `PR-32`.
- Entrega 3 de la maqueta (paneles, administración y permisos): en
  `docs/seguimiento.md`.

## Archivos modificados

- `maqueta/README.md`
- `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/20261112-01_maqueta-recepcion.md` (este archivo)
