mirror of
https://github.com/x1xhlol/system-prompts-and-models-of-ai-tools.git
synced 2026-06-17 23:09:35 +00:00
22 lines
1.2 KiB
Markdown
22 lines
1.2 KiB
Markdown
# 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`](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`](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`](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`](lineage-catalog-choice.md) until an ADR changes it.
|