# Base de cálculo del precio fijo — Zeitune Logística

**Documento interno del mantenedor. No se envía al cliente.**

Horas con las que se arman los precios de `cotizacion_precio_fijo.md`.
Fecha: 16/11/2026.

## 1. Criterio

- Horas estimadas **trabajando con el agente** (Claude Code): el agente
  escribe código, tests y migraciones; el mantenedor revisa, prueba y
  decide. Frente a la estimación tradicional (`cotizacion.md`, versión 1)
  se reduce entre el 40 y el 50 % lo que es programación, y bastante menos
  lo que no se acelera: pruebas en celulares reales, calibración del
  remito, piloto, capacitación y acompañamiento.
- No hay horas reales registradas para comparar: es una estimación. Conviene
  anotar las horas reales de la entrega 2.2 y recalibrar las demás.
- Coordinación, demos y documentación: 24 h (≈ 8 %).
- Reserva para imprevistos: 15 % de desarrollo más coordinación. Con precio
  fijo, la reserva **va dentro del precio**: si no se usa, es margen; si se
  supera, es pérdida.
- Coordinación y reserva se reparten en proporción a las horas de cada
  entrega (factor 382 / 308 ≈ 1,24).
- Dedicación de referencia para los plazos: 40 h semanales.
- **Valor hora: USD 30.**

**Precio de una etapa o entrega = horas con coordinación y reserva × USD 30.**

La maqueta MVP (Etapa 1) es una semana fija: 40 h, sin coordinación ni
reserva aparte.

## 2. Horas por etapa y entrega

| Etapa o entrega | Desarrollo | Con coordinación y reserva | Precio (USD) |
|---|---:|---:|---:|
| **Etapa 1 — Maqueta MVP** | **40** | **40** | **1.200** |
| 2.1 — Definición e infraestructura | 36 | 36 | 1.080 |
| 2.2 — Base y administración | 60 | 74 | 2.220 |
| 2.3 — Órdenes de preparación | 42 | 52 | 1.560 |
| 2.4 — Hojas de ruta | 34 | 42 | 1.260 |
| 2.5 — Despacho | 34 | 42 | 1.260 |
| 2.6 — Recepción | 28 | 35 | 1.050 |
| 2.7 — Arranque operativo | 62 | 77 | 2.310 |
| **Etapa 2 — Operación** | **296** | **358** | **10.740** |
| **Etapa 3 — Seguimiento y avisos** | **48** | **60** | **1.800** |
| **Total** | **384** | **458** | **13.740** |

Coordinación y reserva (factor 1,24) se aplican a las entregas 2.2 a 2.7 y
a la Etapa 3; no a la Etapa 1 ni a la entrega 2.1.

**Entrega 2.1 (36 h, estimación a corregir con lo real):** lo hecho
(registros `20261111-01` a `20261116-03`) se estima trabajando con el
agente en 30 h: requerimientos y preguntas 8, maqueta entregas 1, 2a y 2b
14, servidor 4, proyecto base 4. Falta la maqueta, entrega 3, con su
demostración (6 h), que se hace en la semana 1 junto con la maqueta MVP.
Aunque es trabajo previo, va en la Etapa 2 porque así lo pidió el
mantenedor al reordenar la propuesta en tres etapas.

## 3. Detalle

### Etapa 1 — Maqueta MVP (40 h, una semana)

Se distingue de la maqueta de la entrega 2.1: aquella validó flujos y
reglas; esta muestra las pantallas de la Etapa 2 con el diseño visual definitivo
(partiendo de los mockups y el sistema de diseño de `opendesign/`) y la
prueban los referentes de cada rol en sus celulares.

| Tarea | Horas |
|---|---:|
| Pantallas de la Etapa 2 con el diseño definitivo, celular y escritorio | 20 |
| Recorrido con los referentes de cada rol | 6 |
| Ajustes según el recorrido | 8 |
| Cierre de preguntas abiertas y alcance de la Etapa 2 por escrito | 6 |

### Entrega 2.2 — Base y administración (60 h)

| Tarea | Horas |
|---|---:|
| Modelo de maestros, migraciones y seed | 6 |
| Ingreso, sesión y cambio de depósito de trabajo | 8 |
| Estructura de pantallas y menú según permisos | 6 |
| Roles, permisos y pantalla de permisos por usuario | 9 |
| Sucursales, depósitos y usuarios | 9 |
| Proveedores, departamentos, transportistas y configuración | 5 |
| Visibilidad por sucursal y depósito | 3 |
| Estados con historial, avance y retroceso con motivo | 6 |
| Pruebas automáticas y en celular | 8 |

### Entrega 2.3 — Órdenes de preparación (42 h)

| Tarea | Horas |
|---|---:|
| Modelo de OP y bultos, numerador | 3 |
| Alta, listado con filtros y detalle de OP | 7 |
| Pantalla de armado y toma de una OP | 3 |
| Escaneo por cámara, lector y tipeo; prueba en varios celulares | 14 |
| Carga y quita de bultos con validaciones del EAN13 | 5 |
| Terminar OP con control de cantidad | 2 |
| Pruebas automáticas y en celular | 8 |

El escaneo casi no baja respecto de la versión 1 (18 → 14 h): el tiempo
está en probar cámaras y lectores reales.

### Entrega 2.4 — Hojas de ruta (34 h)

| Tarea | Horas |
|---|---:|
| Modelo y numerador por depósito de origen | 3 |
| Alta con calendario | 5 |
| Listado y detalle con OP, bultos y faltantes (`RF-16`) | 6 |
| Agregar, quitar y pasar OP; OP Asignada automática | 5 |
| Cierre, reapertura y cancelación manual | 4 |
| Cancelación automática a las 23:55 (`PT-09`) | 4 |
| Pruebas automáticas y en celular | 7 |

### Entrega 2.5 — Despacho (34 h)

| Tarea | Horas |
|---|---:|
| Elección de destino y toma de la HR | 3 |
| Escaneo de carga con faltantes; vuelta de Carga a Cerrada | 5 |
| DS con transportista, patente y varios remitos | 6 |
| Impresión sobre el preimpreso (calibración con el formulario real) | 12 |
| Paso a Despachada | 2 |
| Pruebas automáticas y en celular | 6 |

Riesgo: `PR-13`. La impresión casi no baja (14 → 12 h): es prueba y error
con el papel.

### Entrega 2.6 — Recepción (28 h)

| Tarea | Horas |
|---|---:|
| Alta, listado y cierre de RC | 4 |
| Escaneo con condición del bulto | 5 |
| Observaciones: ajenos, rechazados, abiertos o dañados | 4 |
| Estados automáticos de la HR | 5 |
| HR Incompleta | 2 |
| Pruebas automáticas y en celular (varias RC a la vez) | 8 |

### Entrega 2.7 — Arranque operativo (62 h)

| Tarea | Horas |
|---|---:|
| Listado simple de estados de OP y HR para supervisión (hasta la Etapa 3) | 4 |
| PWA instalable | 5 |
| Revisión de seguridad y permisos (incluye `PT-12`) | 5 |
| Pase a producción en el VPS: servicio, proxy y certificados SSL, backup (`PT-07`, `PT-16`), migraciones, carga inicial | 8 |
| Prueba piloto en un depósito y ajustes | 14 |
| Capacitación por rol y guía de uso | 10 |
| Acompañamiento de las dos primeras semanas | 16 |

### Etapa 3 — Seguimiento y avisos (48 h)

| Tarea | Horas |
|---|---:|
| Cuatro paneles con filtros (`RF-27` a `RF-30`) | 18 |
| Indicadores adicionales, hasta cinco (`RF-34`) | 12 |
| Correo al despachar (`RF-31`, `PT-08`) | 4 |
| Pruebas y tiempos de respuesta | 6 |
| Ajustes de uso detectados en las primeras semanas | 6 |
| Pase a producción y presentación a supervisores | 2 |

## 4. Plazos (a 40 h semanales)

| Tramo | Horas | Semanas |
|---|---:|---:|
| Etapa 1 (maqueta MVP) + cierre de la entrega 2.1 | 46 | 1 |
| Entregas 2.2 a 2.6 | 245 | 2 a 7,5 |
| Entrega 2.7 sin acompañamiento | 57 | 7,5 a 9 |
| Etapa 3 + acompañamiento (en paralelo) | 80 | 10 a 11 |

## 5. Correspondencia con `docs/seguimiento.md`

La propuesta renumera y reordena las etapas de `seguimiento.md`:

| Propuesta | `seguimiento.md` |
|---|---|
| Etapa 1 — Maqueta MVP | Nueva |
| Entrega 2.1 — Definición e infraestructura | Etapa 0 |
| Entregas 2.2 a 2.6 — Base, OP, HR, Despacho, Recepción | Etapas 1 a 5 |
| Entrega 2.7 — Arranque operativo | Etapa 7, adelantada |
| Etapa 3 — Seguimiento y avisos | Etapa 6 |

Si el cliente acepta, se actualiza `seguimiento.md` con este orden.
