1.7 KiB
1.7 KiB
title, type, tags, last_updated
| title | type | tags | last_updated |
|---|---|---|---|
| N8nWorkflowStandard | concept | 2026-04-25 |
N8nWorkflowStandard（n8n 工作流标准）
Definition
n8n 编排的生产级工作流必须遵循的 10 步标准结构，确保每个自动化链路具备完整的可靠性、可审计性和可恢复能力。
Ten-Step Structure
- Trigger（触发器）：工作流的启动条件（定时/Webhook/API/事件）
- Input Validation（输入验证）：校验触发数据格式和必填字段
- Data Normalization（数据规范化）：统一字段格式、类型转换
- Business Logic（业务逻辑）：核心处理步骤
- External Actions（外部操作）：对外部系统的写操作（API 调用、数据库写入）
- Result Validation（结果验证）：确认外部操作返回符合预期
- Logging / Audit Trail（日志/审计跟踪）：记录完整执行轨迹
- Error Branch（错误分支）：异常处理的专门路径
- Fallback / Manual Recovery（降级/人工恢复）：无法自动恢复时的兜底方案
- Completion / Status Writeback（完成/状态回写）：更新任务状态并通知相关方
Naming Convention
[ENV]-[SYSTEM]-[PROCESS]-[ACTION]-v[MAJOR.MINOR]
示例：PROD-CRM-LeadIntake-CreateRecord-v1.0
规则：
- Major version：破坏性逻辑变更
- Minor version：向后兼容改进
- 禁止模糊命名（"final"/"new test"/"fix2"）
Related Concepts
- ReliabilityBaseline：每个工作流必须包含的可靠性组件
- AutomationGovernance：治理框架决定哪些工作流值得实施
- IntegrationGovernance：外部系统集成的治理规范
Sources
- automation-governance-architect（primary）