Decisiones (ADRs)¶
Ver tabla consolidada en architecture.md §8.
ADR-01 — Por qué APIM¶
Mediación única: authn/z, rate limit, versionado, correlation IDs, abstracción de backends. Las apps no conocen URLs internas. AI Gateway features solo si GA y necesarias; si no, policies estándar APIM.
ADR-02 — Por qué Foundry¶
Capa de modelos, agentes y tools alineada al ecosistema Azure; evita reinventar hosting de agentes. Si Agent Service / MCP binding está en preview en la región, se documenta y se usa fallback FastAPI + tool calling.
ADR-03 — Por qué MCP¶
Demuestra el segundo patrón de integración del MVP (además de REST). HR es el caso natural (herramientas documentales). Suppliers MCP refuerza el mensaje “heterogéneo” en Finance.
ADR-04 — REST vs MCP¶
| Caso | Patrón |
|---|---|
| get_purchase_order, montos, duplicados, approve/reject | REST |
| validate_supplier (opcional) | MCP |
| search_hr_policy, get_policy, benefits | MCP |
ADR-05 — Determinístico vs LLM¶
Reglas financieras y cambios de estado críticos = código/SQL. LLM = explicación, conversación, extracción asistida no autoritativa.