The integration contract
An integration is a promise between systems. It says which system owns which record, what fields move, when they move, what happens on failure, and how people know the sync is healthy.
Weak integrations fail quietly. Strong integrations are narrow, monitored, retryable, and explainable.
Integration contract sketch
Owner
Which system is source of truth for this object?
Mapping
Which fields move, transform, or stay private?
Trigger
What event, schedule, or webhook starts the sync?
Retry
What should happen if the external system is unavailable?
Reconcile
How do operators compare and repair mismatches?