2.2 KiB
2.2 KiB
title, type, tags, last_updated
| title | type | tags | last_updated |
|---|---|---|---|
| IntegrationGovernance | concept | 2026-04-25 |
IntegrationGovernance（集成治理）
Definition
对每个接入系统的角色、权限、数据流向和失败模式进行明确定义的治理规范，确保多系统协作的清晰性和可审计性。
Core Principle
"No integration is approved without source-of-truth clarity." （未经明确数据权威来源，不得批准任何集成。）
Required Definitions Per Connected System
| 维度 | 描述 |
|---|---|
| System Role & Source of Truth | 该系统在整个数据流中的角色，以及谁是数据的权威来源 |
| Auth Method & Token Lifecycle | 认证方式（API Key / OAuth / JWT 等）和令牌刷新策略 |
| Trigger Model | 触发方式（WebHook / Polling / Event Bus / Scheduled） |
| Field Mappings & Transformations | 输入/输出字段映射及数据转换规则 |
| Write-back Permissions & Read-only Fields | 写回权限范围和只读字段清单 |
| Rate Limits & Failure Modes | API 速率限制及常见失败场景处理 |
| Owner & Escalation Path | 系统负责人及问题升级路径 |
Integration Approval Checklist
- 数据权威来源已明确定义
- 认证方式已配置且令牌刷新机制已实现
- 触发模型已选定并实现
- 字段映射已文档化
- 写回权限已获授权方批准
- 速率限制和失败模式已评估
- 负责人已指定并知晓升级路径
- 集成已通过 ReliabilityBaseline 中的外部依赖失败测试
Re-Audit Triggers（重审计触发条件）
以下任一情况发生时，需重新评估现有集成：
- API 或 Schema 发生变更
- 错误率显著上升
- 业务容量大幅增长
- 合规要求发生变化
- 反复出现人工修复的情况
Related Concepts
- AutomationGovernance：集成治理是自动化治理的核心组成部分
- ReliabilityBaseline：通过集成治理确保整个系统链路的可靠性
- N8nWorkflowStandard：n8n 工作流中的"External Actions"步骤需遵循集成治理规范
- ReAuditTriggers：重审计触发条件
Sources
- automation-governance-architect（primary）