# Balam · Arquitectura Fase 1 vs. PRD original

Balam · MVP Fase 1

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

Cubierto en Fase 1
8
capacidades del PRD (incl. emisión)
Parcial en Fase 1
6
con cobertura acotada
Diferido a Fase 2
8
cotizado en Anexo B
Roadmap Fase 3+
8
sin cotización aún
Incluido en Fase 1 (MVP BIND-first)
Parcial en Fase 1 — versión limitada
Diferido a Fase 2 (cotizada en Anexo B)
Roadmap Fase 3+ (sin cotización aún)

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.

1
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
2
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
3
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
F2
Recordatorios email
Cron + worker
F2
Pagos Stripe
Checkout + webhook
F2
Conciliación bancaria
Match + cola humana
F2
Export asientos
Formato BIND
F3+
Detección anomalías
IA / LLM
F3+
Orquestador agentes IA
Auto-clasificación
4
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
F2
Storage documental
PDFs bancarios
F2
Movimientos bancarios
Extraídos PDF
5
Integraciones
Sistemas externos
CORE F1
BIND ERP API
Clientes · Cotizaciones · Facturas (lectura + emisión) · Pagos · PDF/XML
DOF (TC diario)
MXN ↔ USD
F2
Stripe
Checkout + webhook
F2
Resend (email)
Recordatorios cliente
F2
Claude API
Parsing PDFs banco
F2
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 consultable Multimoneda MXN/USD/EUR, descarga automática
- ✓
  Cobranza con seguimiento Lista blanca ACUNTIA + Top 3, registro pagos
- ✓
  Conciliación bancaria automática 3 bancos: 2 MX + IBC Bank Texas
- ✓
  Asientos contables automáticos Integración con BIND para registro contable
- ✓
  Dashboard financiero en tiempo real CxC, vencimientos, KPIs directivos
- ✓
  Alertas automáticas configurables Pagos pendientes, errores conciliación
- ✓
  Integración con BUK (nómina)Trigger nómina → factura
- ✓
  Trazabilidad completa Audit 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ón Emite MXN (con IVA) y USD (sin IVA) vía BIND, con dry-run + confirmación humana · EUR diferido a F2
- ~
  Cobranza con seguimiento interno Lista blanca + aging + alertas internas. Recordatorios a clientes en F2.
- →
  Conciliación bancaria — diferido Cotizado en Anexo B: PDF + Claude API + match
- →
  Asientos contables — diferido Cotizado en Anexo B: export formato BIND
- ✓
  Dashboard financiero v1 CxC totales + por cliente + aging + vencimientos
- ~
  Alertas internas configurables A equipo de Finanzas. A clientes en F2.
- ·
  BUK — roadmap F3+API confirmada, sin prioridad
- ✓
  Trazabilidad completa Audit 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