# 11/11/2026 — Maqueta navegable: análisis, propuesta y entrega 1 (base y OP)

## Prompt del usuario

**Mensaje inicial**

```text
Con la información que tenemos del proyecto ya se puede construir una maqueta para mostrar al cliente como quedaría el sistema?
Haz un análisis y genera una propuesta o lo que nos hace falta para realizarla.
Pregunta cualquier duda
```

**Respuesta a pregunta**

¿Cómo se la van a mostrar al cliente? → «Archivo local para demo guiada».

¿Qué partes debe cubrir la maqueta? → «Recorrido OP → HR → DS → RC, Paneles e
indicadores, Administración y permisos, Remito de carga».

Identidad visual: ¿hay logo o colores de la empresa? → «Te paso logo y
colores».

Datos de ejemplo: ¿reales o ficticios? → «Ficticios verosímiles
(Recommended)».

**Agregado**

```text
ya puse el logo sin fondo en borradores
```

**Respuesta a pregunta**

El logo es de "Grandes Tiendas San Juan" y el proyecto se llama "Zeitune
Logística": ¿qué nombre muestra la maqueta? → «Logo San Juan + "Logística"».

**Agregado**

```text
si usás los colores del logo en el diseño de la maqueta usá colores más atenuados, pastel
Arrancá con la tarea.
```

**Agregado**

```text
commitea todo
```

## Pedido

Analizar si con la definición actual se puede hacer una maqueta para mostrar
al cliente y proponer cómo hacerla. Con las respuestas, construir la
**entrega 1** de la maqueta.

1. Análisis: con los requerimientos versión 4 alcanza para la maqueta; `PR-13`
   y `PR-28` no la bloquean. El servidor todavía no tiene Node, bases ni HTTPS
   (`PT-03`, `PT-04`, `PT-06`), así que la maqueta no puede ser el proyecto
   Next.js. Además, hacerla así mezclaría código descartable con el
   definitivo.
2. Propuesta aceptada: maqueta estática navegable en `maqueta/` (HTML, CSS y
   JS sin librerías), que se abre con doble clic para una demo guiada, con
   datos ficticios en memoria, en tres entregas:
   1. Base, ingreso, menú por permisos, OP y armado con escaneo (esta tarea).
   2. Hojas de ruta, despacho con remito genérico (`PR-13`), recepción.
   3. Paneles e indicadores, administración y permisos.
3. (Agregado después) Logo de San Juan con el texto "Logística"; "Zeitune" no
   aparece en pantalla. Colores del logo atenuados a tonos pastel.
4. Afuera: cámara (requiere HTTPS; en la maqueta se tipea, se usan códigos de
   ejemplo o un lector USB) y cualquier parte de la aplicación real.

## Qué se hizo

- **`maqueta/js/reglas.js`**: reglas de negocio simuladas como funciones
  puras sobre un objeto de datos, sin DOM, para poder probarlas:
  - EAN13 (verificador, armado).
  - Validación del bulto contra la OP.
  - Permisos efectivos: roles más adicionales.
  - Visibilidad por sucursal.
  - Alta de OP con numerador y HR compatibles.
  - Tomar, terminar y retroceder una OP, con su historial.
  - Opciones de la lista de cambio de estado.

  Son una simulación: en la aplicación van en `src/server/`, y este código
  no se reutiliza.
- **`maqueta/js/datos.js`**: catálogo de pantallas y acciones (decisión
  `0002`), los 5 roles con los permisos de la tabla de requerimientos §5, y
  datos ficticios: 3 sucursales (la 10 "ve todas"), 5 depósitos, 5
  proveedores, 5 departamentos, 3 transportistas, 7 usuarios, 3 HR y 7 OP en
  todos los estados, con bultos. Las fechas son relativas al día en que se
  abre la maqueta.
- **`maqueta/js/app.js`**: rutas por `#hash` y vistas:
  - Ingreso, con la lista de usuarios de demostración.
  - Barra con el logo y el selector de depósito de trabajo.
  - Menú armado según los permisos (lateral en escritorio, desplegable en el
    celular).
  - Inicio con indicadores por rol.
  - Listado de OP con filtro por estado y búsqueda.
  - Alta de OP.
  - Detalle de OP con datos, cambio de estado, bultos e historial.
  - Armado (para tomar y en preparación).
  - Pantalla de escaneo, con aviso visual, sonoro y por vibración, e
    "Códigos de ejemplo" para la demo.
  - Las pantallas de las entregas 2 y 3 figuran en el menú con la etiqueta
    "entrega N" y una ficha de lo que van a mostrar.

  La franja "MAQUETA" permite cambiar de usuario, mostrar las referencias
  `RF`/`RN` en pantalla y reiniciar los datos. El estado se guarda en el
  almacenamiento local del navegador para que sobreviva a una recarga.
- **`maqueta/css/estilos.css`**: diseño pensado primero para el celular, con
  objetivos táctiles de 44 px como mínimo. La paleta sale del azul (≈
  `#13297A`) y el rojo (≈ `#E0242A`) del logo, atenuados a tonos pastel; los
  tonos oscuros solo se usan para texto.
- **`maqueta/img/logo.png`**: copia del logo sin el margen transparente,
  recortada con Python puro (no hay ImageMagick ni PIL). El original de
  `docs/borradores/` no se tocó.
- **`maqueta/pruebas/`**:
  - `reglas.prueba.js`: 20 tests que nombran su `RN`.
  - `correr.sh`: los corre con `gjs`, el motor JavaScript de GNOME que ya
    está en el servidor, sin Node.
  - `index.html`: los mismos tests en el navegador.
  - `recorrido.py`: recorrido e2e en Firefox sin ventana mediante el
    protocolo Marionette, sin dependencias, con las capturas fuera del
    repositorio.
- **`maqueta/README.md`**: cómo abrirla, usuarios, guion de la demo y
  parámetros de URL para preparar la demo.
- Criterios no obvios:
  - **Armado por depósito de trabajo.** La pantalla de armado (`RF-10`)
    filtra por el depósito de trabajo, porque el preparador opera solo en sus
    depósitos (`RN-02`).
  - **Rol para crear OP.** Las OP las crea el Supervisor (`OP -
    OrdenDePreparacion.md`); Preparación no tiene `op.crear`.
  - **Retroceso.** Solo quien tiene `op.retroceder` (Supervisor) vuelve una
    OP al estado anterior. Primero se pide confirmación y después el motivo
    (`RN-06`, como dice el principal).
  - **Lecturas dobles.** Se ignora la misma lectura repetida en menos de 2 s,
    como prevé `docs/arquitectura.md`.
- No se agregaron dependencias: no hay `package.json` y la maqueta no usa
  librerías ni CDN.

## Requerimientos y decisiones

| ID | Qué pasó | Dónde |
|---|---|---|
| `RF-08`, `RF-09`, `RF-10`, `RF-11`, `RF-12`, `RF-25`, `RF-26` | Simulados en la maqueta | `maqueta/js/app.js` |
| `RN-04`, `RN-05`, `RN-06`, `RN-08` a `RN-15`, `RN-17`, `RN-30`, `RN-31`, `RN-36` | Simuladas, con test que las nombra | `maqueta/pruebas/reglas.prueba.js` |

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

- Una OP Asignada no se retrocede a mano; para modificarla se la quita de la
  HR, y entonces vuelve a Terminada. Ver `PR-29`.
- El destino de una OP no puede ser el mismo depósito de origen. Ver `PR-30`.

## Verificaciones que sirvieron

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

| Prueba en navegador (Firefox 140 sin ventana) | Ancho | Resultado |
|---|---|---|
| Ingreso, inicio, listado de OP | 390 px (`--screenshot`) | Bien; se ajustaron la franja demo, los filtros y el recorrido origen → destino |
| Escaneo: válido, verificador mal, otro destino, repetido en otra OP | 390 px | Avisos claros, contador y progreso correctos |
| Menú desplegable | 450 px (mínimo de la ventana con Marionette) | Bien |
| Recorrido completo: menú de Preparación sin Despacho (`RN-30`); tomar (`RN-17`); escaneos con las validaciones (`RN-09`, `RN-10`, `RN-11`) y la lectura doble ignorada; quitar; terminar con diferencia, cancelar y confirmar (`RN-31`); terminar con HR → Asignada automática (`RN-36`); retroceso con confirmación y motivo obligatorio (`RN-06`); alta de OP con HR compatibles (`RN-14`, `RN-15`); Recepción sin acceso a OP, ni siquiera por URL | 450 y 1366 px | 29 de 29 |
| Detalle de OP, alta de OP, armado, pantalla "entrega 3" | 1366 px | Bien; se corrigió la preselección de un estado bloqueado |
| Tests de reglas en `maqueta/pruebas/index.html` | 600 px | 20 de 20 |

**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.
- **Sonido y vibración del escaneo:** no se pueden comprobar sin ventana.

## Hallazgos

1. **Quitar bultos choca con "no hay bajas físicas".** `RF-11` pide quitar
   bultos de una OP en Preparación, y `CLAUDE.md` prohíbe borrar físicamente
   los bultos. Hay que decidirlo antes de modelar los datos en la Etapa 2,
   junto con su efecto sobre la unicidad del código (`RN-11`): ver `PT-10`.
   En la maqueta, el bulto quitado simplemente desaparece.
2. **No está definido qué pasa con una OP Asignada** si se la quiere modificar
   o se la quita de su HR: ver `PR-29`.
3. **Permisos del logo.** `docs/borradores/logo_tienda_sanjuan.*` quedaron
   con modo `rw-------`, a diferencia del resto de la carpeta. No afecta a la
   maqueta, que usa una copia, pero Apache no podría servirlos.

## Pendiente

- `PR-29`: OP Asignada, retroceso y quitarla de la HR.
- `PR-30`: destino igual al origen.
- `PT-10`: quitar bultos sin baja física.
- Entregas 2 y 3 de la maqueta: 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/img/logo.png`
- `maqueta/pruebas/reglas.prueba.js`
- `maqueta/pruebas/correr.sh`
- `maqueta/pruebas/index.html`
- `maqueta/pruebas/recorrido.py`
- `docs/borradores/logo_tienda_sanjuan.png` y `.jpeg` (agregados por el
  mantenedor; versionados en un commit aparte)
- `docs/arquitectura.md`
- `docs/pendientes.md`
- `docs/seguimiento.md`
- `docs/revisiones/20261111-04_maqueta-base-op.md` (este archivo)
