balam/planeacion/Avance-Etapa1-2026-07-27.md

Corte de avance — Etapa 1

Fecha: 27-jul-2026 (corte de los lunes, formato pedido por Erika: entregable + actividad + horas por etapa) Etapa: Plataforma base y sincronización con BIND Rango estimado contractual: 32–39 h · Horas registradas de Etapa 1: 17.0 h Adjunto: Plan-actividades-avance-2026-07-27.xlsx

Documento interno de Johann. El mensaje para Erika va abajo; el resto es sustento propio (no se comparte).

---

Mensaje breve para Erika (WhatsApp)

Hola Erika, buen día. Te comparto el avance de la Etapa 1 al corte de hoy (Excel adjunto, con entregable · actividad · horas por etapa como lo pediste).

El núcleo de la plataforma ya está construido y probado contra producción: autenticación con roles y bitácora de auditoría, arquitectura multi-tenant con aislamiento por RLS, el cliente de la API de BIND, la sincronización de clientes, facturas y cotizaciones, el modelo central de facturas con sus estados y la cartera separada por moneda. La sincronización del histórico ya corrió y cuadró: 1,494 facturas con sus totales de cartera coincidiendo con BIND.

Lo que sigue pendiente es, sobre todo, la capa de escritura (cotización→factura), que dejé en pausa a propósito hasta que definan el flujo de facturación en la sesión del martes, ya que de ahí dependen las reglas. También quedan por cerrar el afinado de datos de prueba y la parte de Azure/CI-CD, que depende de los accesos de su lado.

En horas voy en 17 h de Etapa 1 (rango estimado 32–39 h). Con la key de Jira que nos pasó Pedro hoy y las definiciones del martes, arranco la integración con Jira y la capa de escritura. Cualquier duda quedo al pendiente. 🙌

(Nota: el ajuste de la propuesta y el conteo de horas formal van por separado; este mensaje es solo el avance de Etapa 1.)

---

Sustento interno

Terminado y verificado contra producción

• Backend base: autenticación con JWT propio, matriz de roles (Finanzas, Dirección, Operaciones, Administración) con policies, y bitácora de auditoría universal (logins, sync, transiciones, escritura). — entregable contractual 1 ✅
• Multi-tenant + RLS real de Postgres (no solo filtro EF): políticas tenant_isolation fail-closed en las 8 tablas de negocio + interceptor de conexión. — entregable 2 ✅ (verificación de aislamiento local pendiente de rol de app no-superusuario; las políticas ya están correctas — ver REGISTRO #53)
• Cliente productivo de BIND en C#: paginación OData, reintentos, control de cuota y errores; solo lectura por defecto. — entregable 3 ✅
• Sync de clientes (full-scan barato + hash + detalle solo de nuevos/cambiados, normalización RFC/nombre, dedup por RFC exacto). — entregable 5 ✅
• Sync de facturas y cotizaciones con estados normalizados, tipo de cambio y detección de pagos (fecha de detección, ADR-004). — entregable 6 ✅
• Modelo central de facturas con estados (Emitida, Vigente, Vencida, Pagada, Cancelada) como función pura con pruebas. — entregable 7 ✅
• Cartera por moneda (jamás suma monedas): GET /api/cartera verificado BD↔endpoint — MXN 17 abiertas $1,568,772.32 · USD 92 abiertas $320,379.06.
• Sync histórico corrido y verificado (jamás en vivo): 1,494 facturas + 43 cotizaciones, detalle 1,494/1,494, idempotencia comprobada, 0 pagos falsos. (REGISTRO #52)
• 26/26 pruebas unitarias verdes.

En construcción / en pausa

• Capa de escritura controlada (cotización→factura) — entregable 4. 🔴 En pausa deliberada hasta la definición del flujo de facturación (sesión martes 28-jul con Arturo/Araceli): de ahí salen las reglas de prefactura, PPD/PUE, alta de cliente y qué estatus de Jira dispara qué. El andamiaje (pipeline dry-run→confirm, flags apagados, WriteOperations) está diseñado; se implementa contra las reglas ya cerradas.
• Scheduler + backfill (sync programado cada 15 min) — el sync ya funciona en manual; falta automatizarlo.
• Datos de prueba (seeder) + runbook — entregable 8: migraciones ✅, seeder ficticio pendiente.
• Suite de pruebas de flujos críticos (integración) — pendiente.

Dependencias externas (lado Balam)

• Definición del flujo de facturación/prefacturación — sesión martes 28-jul (Erika coordina). Desbloquea la capa de escritura.
• Correo del flujo de facturación de Jira (Erika lo envió 22-jul) — a incorporar.
• Token de Jira (PAF) recibido el 27-jul + docs de Atlassian; falta confirmar límites de consumo (Pedro investiga). Bandeja: Facturación (FAC).
• Acceso a Azure + CI/CD (Pedro/Noé) — condiciona el despliegue.

Criterio de medición

• Horas de Etapa 1: 17.0 h registradas de un rango de 32–39 h (~44–53 % del esfuerzo estimado).
• Entregables contractuales: 6 de 8 terminados (1, 2, 3, 5, 6, 7); el 8 parcial (migraciones sí, seeder no); el 4 (escritura) en pausa por definición de Balam.
• Se reporta por hora + entregable, no un porcentaje global único, para no dar una cifra engañosa. El Excel muestra ~82 % ponderado por actividad porque el trabajo restante (escritura, seeder, scheduler) es de menor peso que el núcleo ya hecho, pero la escritura está bloqueada por la definición pendiente de Balam, no por avance de desarrollo.

Puntos de juicio a confirmar por Johann antes de enviar

1. Horas 22–27 jul: solo cargué las sesiones documentadas (reglas 22-jul 0.80 h, validación 24-jul 1.05 h como Etapa 0, API Jira 27-jul 0.20 h). Si trabajaste desarrollo adicional en esa ventana, hay que sumarlo.
2. % de Etapa 1 (82 %): es el valor ponderado heredado del corte del 21-jul + avance; si prefieres una lectura más conservadora (por horas, ~50 %), lo ajusto.
3. Tono del mensaje: el borrador enmarca la capa de escritura como "en pausa por la definición del 28-jul" (pone la pelota de su lado, y es verdad). Si prefieres suavizarlo, lo cambio.