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
+7 -4
View File
@@ -28,10 +28,13 @@ necesita antes de operar agentes con impacto real.
└────────────────────────────────────────────────────────────────────┘
```
Detalles completos en [`ARCHITECTURE.md`](ARCHITECTURE.md). Para una explicación
didáctica de extremo a extremo (conceptos, recorrido por todos los módulos y sus
interrelaciones, y el viaje de una petición de principio a fin), ver
[`docs/explicacion.md`](docs/explicacion.md).
Detalles completos en [`ARCHITECTURE.md`](ARCHITECTURE.md). Además:
- [`docs/explicacion.md`](docs/explicacion.md) — explicación didáctica de extremo a
extremo (conceptos, recorrido por todos los módulos y sus interrelaciones, y el
viaje de una petición de principio a fin).
- [`docs/componentes.md`](docs/componentes.md) — referencia de cableado a bajo nivel
(grafo de dependencias de módulos, inyección de dependencias, firmas de los
contratos entre capas, cadenas de llamada de cada endpoint).
## Quickstart