禅道产品、项目、执行与工作流治理手册
禅道把产品、需求、项目、执行、任务、缺陷、版本和发布组织成一套对象链。对象之间的关系比菜单位置更重要：需求表达产品承诺，项目组织交付边界，执行承载迭代或阶段，任务和缺陷记录工程动作。把所有对象压进同一张看板，会让完成语义失真。
部署与试点先固定版本线
启用禅道前明确开源、旗舰或其他版本，以及自托管所需的数据库、文件存储、邮件和备份责任。不同版本的工作流、审批、导入导出和集成能力不同，不能拿另一版本截图作为配置依据。升级先在备份副本验证插件、数据和回滚路径。
试点创建独立产品、项目与执行，导入少量虚构数据，使用测试用户组验证权限。生产库、附件目录和配置文件进入统一备份，管理员账号不用于日常 API 自动化。
对象关系决定交付语义
产品需求经过评审后关联项目，项目下的执行承载任务，缺陷关联产品、版本与解决动作。版本和发布记录交付批次，但不能替代真实构建与部署证据。
产品 -> 需求 -> 项目 -> 执行 -> 任务
产品 -> 版本 -> 发布
缺陷 -> 解决任务 / 代码变更 -> 版本配置影响集中在对象必填字段、评审规则、状态动作和关系约束。自定义工作流可以扩展字段、动作、数据源与验证规则，但每项扩展都需要消费者和退出方案。
正向与反向验证工作流
正向实验从需求创建开始，完成评审、项目关联、任务拆分、代码回链、版本归属和验收关闭。每次状态动作记录 actor、时间和关键字段。预期输出是对象关系可查询，不是一张全绿看板。
需求通过：已有评审结论与验收标准
任务完成：已有代码或交付证据
缺陷关闭：已有验证结果与影响版本反例让无权限成员关闭需求、让缺少解决方案的缺陷进入关闭、删除仍被使用的数据源。门禁应拒绝动作并保留错误信息。失败证据来自操作日志、工作流配置和对象 ID，不以聊天截图替代。
权限、通知和项目接入
权限按组织角色以及产品、项目、执行访问控制分配。外部协作者只进入必要对象，附件与文档继承对应数据边界。Webhook、邮件与第三方通知只传递最小内容，Token 通过受控配置注入。
代码仓库提交或合并请求引用需求、任务或缺陷 ID，流水线将构建和部署链接回写。自动化处理重试与幂等，不能用个人账号长期运行。通知成功只是传输事实，对象状态和验收仍以禅道记录为准。
容量、故障与数据恢复
容量关注活跃用户、对象规模、附件、历史日志、数据库增长和备份窗口。页面变慢先区分查询、数据库、插件和附件存储，升级后错误则核对缓存、数据库变更和扩展兼容。保留最小失败对象和日志，避免直接在生产库手改状态。
恢复演练从数据库与附件备份重建隔离实例，抽查产品、需求、关系、权限和文件。只有页面能打开不足以证明恢复，关键工作流和搜索也要重新验证。
清理、迁移与长期治理
项目结束后关闭执行写入、归档版本和文档，保留产品需求与发布关系。删除字段或工作流前查询历史数据和报表。迁移到其他平台时导出对象、关系、评论、附件、用户和权限映射，逐项抽样而不是只对总数。
长期 owner 定期收敛重复状态、无消费者字段、过宽权限和失败通知。治理目标是让对象链解释交付，而不是让流程尽可能复杂。回滚与退出都有可执行记录时，自托管平台才不会变成只能继续维护的单向选择。