Balam · Arquitectura Fase 1 vs. PRD original

El PRD original de Balam pidió una plataforma end-to-end que cubriera facturación, cobranza, conciliación bancaria, asientos contables y reportes. Después de la llamada con Noe del 19-may y su recorte explícito del 25-may ("primer interés es facturación, solo BIND ERP primero"), la Fase 1 se acota a facturación-first sobre BIND — incluida la emisión asistida de facturas en MXN y USD. Lo demás vive en Fase 2 (cotizada en Anexo B) y Fase 3+ (roadmap) sin perder la arquitectura objetivo.

1 / Arquitectura objetivo

Stack por capas · módulos por fase

Misma arquitectura objetivo del PRD. Lo que cambia es qué módulos se entregan en Fase 1 y cuáles se conectan después sin rearquitectar.

Usuarios

Roles y canales

Finanzas

Operación diaria

Dirección

Visibilidad ejecutiva

Operaciones

Excepciones

Admin técnico

Config + RBAC

F3+

RRHH (BUK)

Vía BUK API

Experiencia

Frontend / Dashboard

Auth + RBAC

4 roles, RLS

Listado de facturas

Filtros + búsqueda

Detalle factura

PDF + XML + bitácora

Catálogo clientes

Lista blanca configurable

Dashboard CxC

KPIs + aging

Cobranza operativa

Alertas internas

Config + reportes

CSV/XLSX export

F3+

Portal cliente

Self-service

Núcleo

Backend / Orquestación

Módulo Facturación

Emisión MXN/USD, estados, vencimientos

Módulo Cobranza

Aging + lista blanca

Motor de reglas

Alertas + excepciones

Bitácora / Audit log

Eventos universales

Multi-tenancy

tenant_id + RLS

Recordatorios email

Cron + worker

Pagos Stripe

Checkout + webhook

Conciliación bancaria

Match + cola humana

Export asientos

Formato BIND

F3+

Detección anomalías

IA / LLM

F3+

Orquestador agentes IA

Auto-clasificación

Datos

Persistencia

Postgres central

Azure Flexible

Clientes + Facturas

Snapshot normalizado

PARCIAL

Pagos

Solo lo de BIND en F1

Alertas + Bitácora

Eventos + audit

Configuración + Reglas

Lista blanca, ventanas

Storage documental

PDFs bancarios

Movimientos bancarios

Extraídos PDF

Integraciones

Sistemas externos

CORE F1

BIND ERP API

Clientes · Cotizaciones · Facturas (lectura + emisión) · Pagos · PDF/XML

DOF (TC diario)

MXN ↔ USD

Stripe

Checkout + webhook

Resend (email)

Recordatorios cliente

Claude API

Parsing PDFs banco

BUK API

Nómina + colaboradores

F3+

Belvo / Plaid

Bancos en vivo

F3+

Jira API

Horas → input facturación

★

Arquitectura preparada para el futuro: los módulos en azul/gris no requieren rearquitectar la base. El motor de reglas, audit log y multi-tenancy de Fase 1 los soporta tal cual cuando se activen. El único costo de diferirlos es tiempo, no rework.

2 / Lo que pidió el PRD vs. lo que entrega Fase 1

Comparación directa por bloque funcional

Cada bloque del PRD original (§3.1) mapeado a su entrega real en Fase 1. Diferidos no son "cortes" sino re-secuenciaciones validadas con el CTO.

PRD original

Lo que Balam pidió en el PRD

Plataforma end-to-end con todas las integraciones desde día 1

✓
Facturación visible y consultableMultimoneda MXN/USD/EUR, descarga automática
✓
Cobranza con seguimientoLista blanca ACUNTIA + Top 3, registro pagos
✓
Conciliación bancaria automática3 bancos: 2 MX + IBC Bank Texas
✓
Asientos contables automáticosIntegración con BIND para registro contable
✓
Dashboard financiero en tiempo realCxC, vencimientos, KPIs directivos
✓
Alertas automáticas configurablesPagos pendientes, errores conciliación
✓
Integración con BUK (nómina)Trigger nómina → factura
✓
Trazabilidad completaAudit log universal

Fase 1 entrega

Lo que Fase 1 entrega en 6 – 7 sem

MVP BIND-first acotado a facturación (consulta + emisión) + cobranza operativa interna

✓
Facturación: consulta y emisiónEmite MXN (con IVA) y USD (sin IVA) vía BIND, con dry-run + confirmación humana · EUR diferido a F2
~
Cobranza con seguimiento internoLista blanca + aging + alertas internas. Recordatorios a clientes en F2.
→
Conciliación bancaria — diferidoCotizado en Anexo B: PDF + Claude API + match
→
Asientos contables — diferidoCotizado en Anexo B: export formato BIND
✓
Dashboard financiero v1CxC totales + por cliente + aging + vencimientos
~
Alertas internas configurablesA equipo de Finanzas. A clientes en F2.
·
BUK — roadmap F3+API confirmada, sin prioridad
✓
Trazabilidad completaAudit log universal desde día 1

3 / Cobertura granular

Matriz de requerimientos funcionales (PRD §6)

Trazabilidad uno a uno de los RF del PRD contra el alcance comprometido en Fase 1.

ID	Descripción PRD	Cobertura	Notas
RF-01	Generar facturas automáticamente desde eventos de negocio	Parcial	Creación manual (cotización→factura) incluida en Fase 1; la generación automática desde eventos (Jira/BUK) → Fase 2. BIND timbra.
RF-02	Soporte multimoneda USD/EUR/MXN	Parcial	MXN + USD en Fase 1. EUR en Fase 2.
RF-03	Integración con sistemas existentes (BUK / nómina)	Fase 2	API BUK confirmada, no prioridad del CTO.
RF-04	Registrar pagos automáticamente desde fuentes bancarias	Fase 2	Diferido junto con conciliación bancaria.
RF-05	Asociar pagos a facturas	Parcial	Lo que reporta BIND vía Payments. Matching avanzado en Fase 2.
RF-06	Identificar pagos parciales y completos	Parcial	Según expone BIND. Validar en Discovery (Plan A/B/C).
RF-07	Conciliar automáticamente transacciones bancarias	Fase 2	Cotizado: 3 bancos + Claude API + cola humana.
RF-08	Detectar discrepancias	Fase 2	Sigue a RF-07.
RF-09	Generar reportes de conciliación	Fase 2	Sigue a RF-07.
RF-10	Generar asientos contables automáticos	Fase 2	Depende de capacidad de escritura de la API BIND validada.
RF-11	Integración con sistema contable	Fase 2	Export formato BIND para carga manual del contador.
RF-12	Dashboard financiero en tiempo real	Fase 1	KPIs sincronizados cada 4h con BIND.
RF-13	Alertas automáticas configurables	Parcial	Alertas internas en Fase 1. A clientes en Fase 2.
RF-14	Reportes exportables	Fase 1	CSV/XLSX por filtros · reporte operativo configurable.

ID	Requerimiento no funcional (PRD §7)	Cobertura	Notas
RNF-01	Arquitectura modular y escalable	Fase 1	Multi-tenancy + RLS desde día 1.
RNF-02	Alta disponibilidad	Parcial	Single-region en Azure. HA real (multi-region) → Fase 2.
RNF-03	Seguridad de datos financieros	Fase 1	Key Vault, RBAC, audit log, hardening.
RNF-04	Cumplimiento fiscal (México y Texas)	Parcial	Tax estándar en MVP. Compliance avanzado Texas → Fase 2.
RNF-05	Integración con APIs externas	Fase 1	BIND API + DOF para TC.
RNF-06	Trazabilidad completa de operaciones	Fase 1	Audit log universal desde día 1.

4 / Resumen por fase

Qué entra, qué se difiere, qué espera

Vista de tres tiempos para alinear expectativas con Noe, Ara y Pedro.

✓ Fase 1 — Facturación-first

6 – 7 semanas · 112 – 136 h · $67.2K – $81.6K MXN

Integración API BIND (lectura + escritura asistida)
Emisión de facturas MXN/USD con dry-run + confirmación
Vista facturación · estados · filtros · PDF/XML
Catálogo clientes + lista blanca ACUNTIA + Top 3
Cobranza operativa interna (aging + alertas a Finanzas)
Dashboard CxC · KPIs · multimoneda MXN+USD
Reportes CSV/XLSX configurables
Auth + RBAC + multi-tenancy + audit log universal
Prototipo visual navegable en Semana 1

→ Fase 2 — Anexo B (cotizada)

80 – 106 h · $48K – $63.6K MXN indicativo

Recordatorios email automáticos a clientes + templates
Pago con link Stripe Checkout + webhook
Conciliación bancaria PDF (3 bancos) + Claude API
Export asientos contables formato BIND
Integración BUK (lectura nómina + colaboradores)
Soporte EUR · alta disponibilidad multi-region
Compliance avanzado Texas

… Fase 3+ — Roadmap (sin cotizar)

Se cotiza al cerrar Fase 2 con datos reales

Integración bancaria en vivo (Belvo, Plaid)
Conector BIND para asientos contables automáticos
Integración Jira (horas → input facturación)
Cash-flow proyectado 30/60/90
Domiciliación / pagos recurrentes Stripe
Detección anomalías con IA / LLM
Portal de cliente self-service
Multi-tenancy comercial · productización SaaS