Files
balam/bitacora
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
..

Bitácora — cómo registrar

Esta carpeta es el registro vivo del proyecto Balam. Cada vez que pase algo relevante —una llamada, un correo, un mensaje de WhatsApp, una decisión— se anota aquí. Así el proyecto siempre tiene una sola fuente de la verdad de "qué se dijo, cuándo y qué quedó pendiente".

Archivos

Archivo Para qué
REGISTRO.md Log cronológico de toda comunicación (correos, llamadas, mensajes). Entradas numeradas, más antigua arriba.
PENDIENTES.md Acciones abiertas (checklist). Lo que hay que hacer y quién.
../planeacion/Seguimiento-horas.md Reglas, resumen y reconstrucción pendiente de horas efectivamente trabajadas.
../planeacion/Seguimiento-horas.csv Fuente tabular para conciliación con Jira y facturación.
../fuentes/ Material crudo: transcripciones, archivos .eml, PRD. No se edita; es evidencia.
../README.md Estado del proyecto (resumen ejecutivo, datos clave, decisiones). Se actualiza cuando algo cambia el rumbo.

Flujo cuando pasa algo

  1. Pasa algo (llamada / correo / mensaje / decisión).
  2. Guarda la evidencia en ../fuentes/ si existe (transcripción, .eml, captura). Nómbrala con fecha: 2026-06-04 - Transcript - <tema>.txt.
  3. Registra la entrada en REGISTRO.md con la plantilla que corresponda (ver abajo). Usa el siguiente número consecutivo.
  4. Mueve los pendientes que surjan a PENDIENTES.md.
  5. Si cambió el alcance, precio, plazo o una decisión clave, actualiza también ../README.md.
  6. Si hubo trabajo facturable, registra el tiempo real el mismo día en ../planeacion/Seguimiento-horas.csv; no infieras horas desde el porcentaje de avance.

Regla de oro: si no está en la bitácora, no pasó. Registrar toma 2 minutos y evita malentendidos caros.


Plantillas

Copia el bloque, pégalo en REGISTRO.md y rellena. La fecha en formato AAAA-MM-DD.

📞 Llamada / reunión

## N · AAAA-MM-DD HH:MM · Llamada · <tema>

> Participan: <nombres>. Canal: Teams / tel / presencial. Evidencia: `../fuentes/<archivo>` (si hay).

**Resumen:** <2-4 líneas de qué se trató.>

**Acuerdos / decisiones:**
- <decisión 1>
- <decisión 2>

**Pendientes que surgieron:**
- [ ] <responsable> — <acción> — <fecha objetivo>

**Citas relevantes:** *"<frase textual importante>"*

✉️ Correo

## N · AAAA-MM-DD HH:MM · Correo · <De> → <Para> · <asunto>

> Dirección: enviado / recibido. Evidencia: `../fuentes/<archivo>.eml` (si se guardó).

**Resumen:** <qué dice.>
**Acción derivada:** <qué hay que hacer, si aplica.>
**Adjuntos:** <nombre del adjunto, si hay.>

💬 Mensaje (WhatsApp / Teams chat)

## N · AAAA-MM-DD · Mensaje (WhatsApp) · <De> → <Para>

**Resumen:** <qué se dijo.>
**Acción:** <si aplica.>

⚖️ Decisión

## N · AAAA-MM-DD · Decisión · <título>

**Contexto:** <por qué se decide.>
**Decisión:** <qué se decidió.>
**Aprobada por:** <quién.>
**Impacto:** alcance / precio / tiempo — <detalle.>

Convenciones

  • Una entrada por evento, numeradas y en orden cronológico (más reciente al final, igual que el hilo actual).
  • Evidencia cruda en ../fuentes/, nunca editada; el resumen interpretado va en REGISTRO.md.
  • Pendientes siempre con responsable y fecha; al cerrarse se marcan [x] en PENDIENTES.md (no se borran, dejan rastro).
  • Fechas absolutas (2026-06-04), nunca "ayer" o "la próxima semana".
  • Citas textuales entre comillas y en cursiva para distinguir lo dicho de la interpretación.