mirror of
https://github.com/x1xhlol/system-prompts-and-models-of-ai-tools.git
synced 2026-06-17 23:09:35 +00:00
1.2 KiB
1.2 KiB
WS5 — Connector facade, events, semantic metrics (completion)
Connector facade standard (required for new integrations)
Each connector MUST document: contract, version, retry, timeout, idempotency key, approval policy hook, audit field mapping, observability hooks, rollback notes.
Pattern reference: governance/connectors-and-data-plane.md.
Rule: No new agent path may call a vendor SDK directly for a production integration; add a facade module under salesflow-saas/backend/app/services/integrations/ (or agreed package) with tests.
Event envelope and schema registry
- Envelope fields: see
governance/events-and-schema.md. - Registry: start with versioned JSON Schema under
docs/schemas/events/(create per event family) before adopting a hosted registry.
Semantic metrics dictionary
Authoritative definitions: semantic-metrics-dictionary.md. Application code must import metric keys from a single module once introduced (WS5 follow-up PR).
Lineage / catalog
Single choice documented in lineage-catalog-choice.md until an ADR changes it.