system-prompts-and-models-o.../docs/ws5-connector-events-metrics.md

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.