docs: añade docs/componentes.md — referencia de cableado a bajo nivel

Complementa a docs/explicacion.md (alto nivel) con la vista de bajo nivel:
- grafo de dependencias de módulos por niveles topológicos (imports internos)
- el grafo de inyección de dependencias de api/deps.py (lru_cache + factories)
- las firmas exactas de los contratos: LLMProvider, GuardrailEngine, los
  validadores, el registry/policy store, el AgentOrchestrator, AgentState y el
  cableado del grafo LangGraph, y cómo orchestrator._build_execution mapea el
  StateSnapshot a AgentExecution
- la cadena de llamada de cada endpoint (qué deps, qué llama, qué persiste)
- mapa de persistencia (quién escribe/lee cada artefacto YAML/JSON/JSONL/SQLite)
- mapa CoreClient ↔ endpoints ↔ páginas del dashboard
- arranque/ciclo de vida y tabla Settings → consumidor
- "gotchas" conocidos
README y docs/explicacion.md enlazan al nuevo documento.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
This commit is contained in:
Juan
2026-05-11 15:20:00 +02:00
co-authored by Claude Opus 4.7
parent 57ba136c70
commit ce629139c2
3 changed files with 437 additions and 5 deletions
+3 -1
View File
@@ -5,7 +5,9 @@
> y *cómo encajan las piezas* sin tener que leer todo el código primero.
>
> Si solo quieres arrancarlo, ve al [`README.md`](../README.md). Si quieres las
> decisiones técnicas en bruto, ve a [`ARCHITECTURE.md`](../ARCHITECTURE.md).
> decisiones técnicas en bruto, ve a [`ARCHITECTURE.md`](../ARCHITECTURE.md). Si
> quieres la referencia de cableado a bajo nivel (módulos, firmas, grafos de
> dependencias, cadenas de llamada), ve a [`docs/componentes.md`](componentes.md).
> Este documento está en medio: cuenta la historia.
---