Files

T

JohannVelazquez 820b8d41c8 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.

2026-07-28 22:21:04 -06:00

6.3 KiB

Raw Blame History

Seguimiento de horas

Fuente local de horas efectivamente trabajadas para el proyecto Balam. Se mantiene mientras Johann obtiene acceso al flujo de Jira; después, Jira será el registro operativo y este archivo/CSV servirá para conciliación y facturación.

Tarifa contractual: $600 MXN/h + IVA Cadencia: corte semanal; factura los viernes; pago a 30 días Datos tabulares: Seguimiento-horas.csv Última actualización: 2026-07-27

Reglas de captura

Registrar el tiempo el mismo día, en incrementos de 0.25 h.
Separar sesiones, desarrollo, análisis, documentación y gestión técnica.
Vincular cada registro con una actividad del plan y una evidencia cuando exista.
No convertir porcentajes de avance en horas: el avance mide entregable; las horas miden esfuerzo real.
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.
Al habilitarse Jira, conciliar ambos registros y evitar duplicados.

Corte al 27-jul

Etapa	Horas al corte	Rango estimado de la etapa	Estado
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

Estado de validación de las horas (27-jul):

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

Distribución al 27-jul

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

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.

Nota sobre las sesiones asistidas por IA

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.
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.

6.3 KiB Raw Blame History Unescape Escape