Accounting V3 — Target conceptual

Arquitectura propuesta para el sistema de Accounting de Intelia. Documento de trabajo para discusión con el equipo.

📅 2026-05-22 📝 Status: Conceptual · No implementación 👥 Producido por: Claude + Codex con dirección de Pablo

El Motor decide. El integrador traduce. El executor ejecuta. El SoR persiste. T3 calcifica patrones por nivel. T4 devuelve señales estructuradas desde la realidad. S1 mueve al humano entre Intelia y Holded según confianza. TX hace que todo esto sea durable, observable e idempotente.

Por dónde empezar

START v3-architecture — Arquitectura a alto nivel

Frame conceptual (SoR/SoA/Conector) · 5 reglas de oro · Mapa de 6 capas · Contratos principales · Flujo end-to-end del documento · Evolución por madurez del cliente · Trade-offs explícitos · Patologías estructurales · Criterios de éxito · Orden de implementación. Empieza aquí.

Componentes (zoom-in)

M1 Motor de decisión IA
SoA portable entre ERPs. Facts (5 owners: extracted/memory/erp_snapshot/human_context/runtime) + 3 LLMs (intérprete factual + decisor contable + crítico/validador) + Internal Plan + Contextual + Validation. Sobrevive a cualquier cambio de ERP.
I1 Integrador Holded
Conector con Plan Generator (agente LLM con 3 roles internos: Planner + Tool Mapper + Critic) + Plan Store (reglas calcificadas de traducción) + Executor determinístico + Final Validation. Toda la cicatriz Holded vive aquí, contenida.
T3 Calcification Engine
Convierte decisiones repetidas en reglas deterministas. Lifecycle de 5 estados: candidate → shadow → active → quarantined → retired. Bootstrap cruzado por archetype. Corazón del valor a largo plazo del producto IA-first.
T4 Reverse Sync
Polling de Holded por tiers (15min/6h/7d) + interpretación de comments del contable con LLM. Convierte ediciones post-write en Learning Signals tipados. Sustrato del aprendizaje — sin T4 vivo, T3 calcifica sobre evidencia mentirosa.
S1 UX Híbrido
Dashboard Intelia "Planes Pendientes" para baja confianza + Holded como interfaz para alta confianza (link al plan + tag estructural + comment con razonamiento). Madurez como matriz por isla, no estado global.
TX Signals + Temporal
Plumería transversal: Signal Registry tipado (catálogo central + dedupe + projection), Workflows durables (Document Accounting + Reverse-Sync Monitor + Calcification Loop), idempotencia por workflow_id, retries por dominio de fallo.

Referencias

REF README — índice y guía de lectura
Versión texto del índice. Útil si quieres copiarlo a otro lado.

Las 5 reglas de oro de V3

Eliminar account_lines o declararlo sombra explícita (no autoritativa).
Separar Facts por owner: extracted, memory, erp_snapshot, human_context, runtime.
Plan Store dentro del integrador, no fuera.
Guías Holded sin razonamiento semántico (sólo cómo, no qué).
Reglas calcificadas tipadas por nivel: semánticas en Motor, traducción en integrador.

Próximo paso recomendado

Antes de implementar, cerrar la pregunta de producto: ¿cuántos ERPs vais a soportar comercialmente en 2 años?. La respuesta condiciona alcance y prioridades del plan. Decisión de mesa con BD/comercial, no de mesa técnica.

Cuando esté cerrada: ejecutar /workflows:plan thoughts/shared/brainstorms/2026-05-22-accounting-v3-target-conceptual-brainstorm.md para producir el plan de implementación.