Valida y consolida las horas al 27-jul: 41.58 h trazables desde el CSV

Las horas quedan validadas una por una contra evidencia fechada y el Excel
deja de tener cifras escritas a mano: se generan desde Seguimiento-horas.csv
y el script aborta si el detalle no cuadra con el total.

Correcciones de fondo:
- El Excel reportaba 17 h de Etapa 1 contra 16 h en el CSV (override manual).
- Comas sin escapar en el CSV ocultaban 1.00 h del 19-jul al parseo.
- El 10-jul estaba mal etiquetado: la mayor parte fue pulido del prototipo
  (E0-05), no el entregable de cierre (E0-06). Mismo total, etiquetas reales.
- Se incorporan 3.50 h no cobradas con evidencia: diseño del plan de Etapa 1
  (2.00 h) y preparación de las sesiones del 22 y 24-jul (1.50 h).
- Ajustes a la baja de Johann en horas reconstruidas: análisis del Discovery
  1.92→1.00 h, documentación de cobranza 1.50→0.75 h, guion 0.75→0.45 h.
  Las duraciones con transcript no se tocaron. Etapa 0 vuelve al rango 18–22 h.

Presentación del avance:
- Se reporta 75 % de Etapa 1 = 6 de 8 entregables cerrados, en lugar del 82 %
  ponderado anterior, que no distinguía trabajo hecho de trabajo bloqueado.
- Capa de escritura al 40 % (diseño, ADR-001 y modelo listos; falta el
  BindWriteClient y los shapes de los POST) y Jira al 90 % (conectividad
  resuelta el 27-jul; falta qué estatus dispara qué, sujeto a la definición
  de Balam). Modelo de facturas al 85 % con horas propias: ya no aparece
  avanzado con cero horas.
- Las 7 h que acumulaba "Demostración semanal" se reparten a las filas
  técnicas que les corresponden; esa fila se queda con gestión (1.75 h).

Nuevo: Avance-Balam-2026-07-27.xlsx, versión simple para Erika, derivada del
Excel interno para que ambos no puedan contradecirse.

Bitácora #58: Erika confirma que el Excel de horas es el insumo de
FACTURACIÓN, corrige su lectura de la capa de escritura al 100 %, y vuelve a
pedir la propuesta ajustada por Jira (pendiente desde el 22-jul). La sesión
del flujo de facturación no queda agendada: Balam la revisa internamente.

planeacion/Seguimiento-horas.md

@@ -5,7 +5,7 @@ Fuente local de horas efectivamente trabajadas para el proyecto Balam. Se mantie
 **Tarifa contractual:** $600 MXN/h + IVA
 **Cadencia:** corte semanal; factura los viernes; pago a 30 días
 **Datos tabulares:** [`Seguimiento-horas.csv`](Seguimiento-horas.csv)
-**Última actualización:** 2026-07-15
+**Última actualización:** 2026-07-27
 
 ## Reglas de captura
 
@@ -16,47 +16,67 @@ Fuente local de horas efectivamente trabajadas para el proyecto Balam. Se mantie
 5. No completar retrospectivamente una duración sin respaldo. Si solo se conoce la actividad, dejarla en la lista de reconstrucción hasta que Johann confirme el tiempo.
 6. Al habilitarse Jira, conciliar ambos registros y evitar duplicados.
 
-## Corte reconstruido al 15-jul
+## Corte al 27-jul
 
 | Etapa | Horas al corte | Rango estimado de la etapa | Estado |
 |---|---:|---:|---|
-| Etapa 0 | **22.00 h** | 18–22 h | Límite superior consumido; prototipo pendiente de validación |
-| Etapa 1 | **8.00 h** | 32–39 h | En curso |
-| **Total** | **30.00 h** |  | Coincide con la facturación inicial propuesta |
+| Etapa 0 | **21.83 h** | 18–22 h | Cerrada y **validada por Balam el 24-jul**; dentro del rango |
+| Etapa 1 | **19.75 h** | 32–39 h | En curso; 6 de 8 entregables terminados |
+| **Total** | **41.58 h** |  |  |
 
-Las **26.92 h** que no corresponden a sesiones con duración documentada se reconstruyeron retrospectivamente por actividad. Deben validarse contra memoria, archivos de trabajo y Jira antes de presentarse como horas efectivamente trabajadas.
+**Estado de validación de las horas (27-jul):**
 
-## Horas con duración comprobable
+| Estado | Horas | Significado |
+|---|---:|---|
+| `confirmada` | 9.13 h | Duración documentada (transcripts, sesiones calendarizadas, tiempo de sesión) |
+| `validada` | 32.45 h | Reconstruida por actividad y **confirmada por Johann el 27-jul** contra evidencia fechada |
+| **Total** | **41.58 h** | Sin horas pendientes de validar |
 
-| Semana | Etapa | Horas confirmadas | Alcance incluido |
-|---|---:|---:|---|
-| 2026-W27 | 0 | 1.00 | Kickoff |
-| 2026-W28 | 0 | 2.08 | Discovery de facturación/envío y cobranza |
-| **Total comprobable** |  | **3.08** | Solo sesiones con duración documentada |
+## Distribución al 27-jul
 
-> Las 3.08 h están incluidas dentro del corte reconstruido de 30 h; no deben sumarse nuevamente.
+| Etapa | Actividad | ID | Horas |
+|---|---|---|---:|
+| 0 | Kickoff y preparación | E0-01 | 2.00 |
+| 0 | Discovery de facturación, envío y cobranza | E0-02 | 3.83 |
+| 0 | Accesos y salvaguardas | E0-03 | 1.00 |
+| 0 | Validación técnica de la API de BIND | E0-04 | 4.50 |
+| 0 | Prototipo navegable (incl. pulido final del 10-jul) | E0-05 | 7.50 |
+| 0 | Entregable de cierre: PDF, hallazgos, plan y correo | E0-06 | 1.50 |
+| 0 | Validación del prototipo con Balam (guion + sesión) | E0-07 | 1.50 |
+| 1 | Backend base, auth, roles, bitácora y syncs (B0–B4) | E1-01 | 6.50 |
+| 1 | Coordinación del repositorio | E1-02 | 0.50 |
+| 1 | Arquitectura multi-tenant y RLS (B6) | E1-03 | 2.00 |
+| 1 | Cliente productivo de la API de BIND | E1-04 | 2.00 |
+| 1 | Gestión, cortes de avance y sesión de reglas | E1-05 | 3.30 |
+| 1 | Entorno local, scaffold y Scalar | E1-06 | 3.25 |
+| 1 | Sesión de API de Jira | E1-07 | 0.20 |
+| 1 | Diseño del plan de ejecución de Etapa 1 | E1-08 | 2.00 |
+|  | **Total** |  | **41.58** |
 
-## Distribución reconstruida
+> **Ajustes a la baja aplicados por Johann el 27-jul:** el análisis del Discovery de facturación bajó de 1.92 a 1.00 h, la documentación del de cobranza de 1.50 a 0.75 h, y el guion de validación de 0.75 a 0.45 h. Las duraciones de sesión documentadas en transcript **no se tocaron**. Con esto Etapa 0 vuelve a quedar dentro del rango contractual de 18–22 h.
 
-Johann debe confirmar esta distribución antes de usarla para facturación:
+### Nota sobre las sesiones asistidas por IA
 
-| Etapa | Actividad consolidada | Horas |
-|---|---|---:|
-| 0 | Kickoff y preparación | 2.00 |
-| 0 | Discovery de facturación, envío y cobranza | 5.50 |
-| 0 | Accesos y salvaguardas | 1.00 |
-| 0 | Validación técnica de BIND | 4.50 |
-| 0 | Prototipo navegable | 6.00 |
-| 0 | Entregable, hallazgos, ADRs y plan | 3.00 |
-| 1 | Backend base | 3.50 |
-| 1 | Arquitectura multi-tenant | 1.50 |
-| 1 | Cliente productivo de BIND | 2.00 |
-| 1 | Repositorio y seguimiento | 1.00 |
-|  | **Total** | **30.00** |
+Los bloques B0–B6 de Etapa 1 (auth, RLS, cliente de BIND, sincronización de 1,494 facturas de producción) se ejecutaron en **3.50 h de tiempo de reloj** contra una estimación manual de 4–5.5 h *por bloque*. Se registra el tiempo efectivamente trabajado, conforme al contrato. El trabajo intelectual que hizo posible esa velocidad —diseño de arquitectura, decisión de ADRs y plan de ejecución— se registra por separado en **E1-08 (2.00 h)**.
+
+Consecuencia a vigilar: **Etapa 1 cerrará por debajo del rango de 32–39 h.** Conviene reportar avance por entregable (6 de 8) y no solo por horas, para que la eficiencia no se lea como alcance faltante.
+
+### Nota sobre el mapeo CSV → Excel
+
+El CSV agrupa por **actividad contractual**; el Excel desglosa por **tarea de proyecto**, y no mapean 1:1. El reparto vive en `HORAS_POR_FILA` dentro de `generar_avance_2026_07_27.py`, con la trazabilidad comentada línea por línea, y el script **aborta** si la suma del detalle no cuadra con el CSV.
+
+Dos casos que conviene recordar:
+- **E1-06 (entorno, scaffold, Scalar — 3.25 h)** no tiene fila propia: se carga a "Backend base", que se renombró y amplió su rango a 8–9 h.
+- **E1-08 (diseño del plan — 2.00 h)** se reparte en dos: **1.00 h** de diseño general va a "Arquitectura multi-tenant y diseño de la solución" (rango 3–4 h) y **1.00 h** del análisis de B7 —pipeline `Draft→DryRun→Confirm`, flags, regla PPD/PUE, ADR-001— va a la fila del **entregable 4 (capa de escritura)**, para que muestre el trabajo hecho aunque la implementación siga en pausa. La entidad `WriteOperation` y la policy `PuedeOperarEscritura` **no** se contabilizan ahí: se hicieron en B1/B2 y ya están en "Backend base" (evita doble conteo).
+- La fila de **seguimiento semanal se queda solo con gestión y cortes de avance (1.75 h)**. Antes acumulaba 7.00 h de trabajo técnico bajo un nombre que no lo describía, lo que se leía como sobrecosto en una actividad trivial.
+- La sesión **B4 (1.00 h)** se reparte entre "Sincronización de facturas" (0.50 h) y "Modelo de facturas" (0.50 h): produjo ambas cosas —el sync y el `InvoiceStatusMapper` con sus 13 pruebas más la migración `DetalleSyncPendiente`—, y antes el modelo aparecía al 85 % con 0 h.
+
+**Criterio general:** ninguna fila debe mostrar avance con 0 h trabajadas. Las únicas excepciones legítimas son Azure y CI/CD, que están en 0 % y 0 h porque dependen de accesos del lado de Balam.
 
 ## Corte comercial
 
 - La propuesta v1.2 contempla una **facturación inicial de 30 h ($18,000 + IVA)** que cubre Etapa 0 e inicio de Etapa 1.
-- Esas 30 h son el concepto comercial autorizado en la propuesta, pero el contrato exige reportar horas efectivamente trabajadas.
-- Antes de emitir, Johann debe validar el desglose reconstruido y conciliarlo contra Jira.
-- La emisión sigue pendiente de confirmación de Balam al correo del 2-jul.
+- Al 27-jul hay **41.58 h trabajadas**, es decir **11.58 h por encima** de esa facturación inicial. A tarifa de $600/h son **$6,948 + IVA** aún no facturados.
+- Todas las horas están validadas (ninguna pendiente de confirmar), por lo que el desglose ya es presentable para facturación.
+- Pendiente: conciliar contra Jira cuando Pedro lo habilite, y confirmar con Balam si la segunda factura va por el excedente o por corte de etapa.
+- La emisión de la factura inicial sigue pendiente de confirmación de Balam al correo del 2-jul.