Files
balam/bitacora
Johann 3de2739e75 Registros #71–#83: se cierran los huecos del 21-ago al 29-sep — login web a BIND entregado, endpoint interno de la UI (Generar Venta → Prefactura, InvoiceDetails) y modelo de dos endpoints confirmado con el SDK oficial
Reconstruido desde el buzón (informes de Read AI, correos de Noé) y los commits
del repo del cliente: homologación de estados (21-ago), false = remisión (24-ago),
Generar Venta y requisitos de Azure (24/25-ago), la sesión del incidente (26-ago),
tenant de Azure + ítem por código (3-sep), publicación en paputec.mx (3-sep),
cotización en lote (7-sep), primera prefactura observada por DevTools (9-sep),
captura con Pedro (10-sep), corte de horas (15/16-sep) y la sesión de hoy.

- REGISTRO.md: encabezado Periodo, entradas #71–#83, bloque "Estado actual (al 29-sep)".
- PENDIENTES.md: sección 29-sep (credenciales fuera del repo, especificar InvoiceDetails,
  BindUiClient bajo ADR-001, CreatedByName, soporte BIND, error al crear cotización);
  cerrados los huecos de registro, el correo de causa del 21-ago, el experimento de
  folio compartido, el servicio por combo; movimientos de Azure y de la 2386.
- fuentes/: extractos de Read AI (9 informes), correo "Generar Venta" de Noé y el
  hilo de acceso a Azure.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
2026-09-29 08:06:25 -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.