运维手册

项目管理：禅道需求、缺陷与发布追踪

以需求、缺陷、测试和发布编号串联工程证据，明确权限、附件和工作流恢复要求。

项目管理：禅道交付追踪

禅道在图中负责项目管理，本方案以需求、任务、缺陷、测试和发布记录形成交付台账。项目状态反映团队确认的业务进展，不根据一次构建成功自动将所有需求关闭；生产发布批准、数据库变更批准和技术评审应有各自证据。

本文没有创建实际项目或同步账号。具体产品版本、许可、工作流字段和外部集成功能需要实施方验证，所有接入、数据迁移和演练都待目标环境授权。

为产品、项目和执行迭代明确负责人及可见范围，区分需求提出者、开发者、测试者和发布确认人。登记实际部署形态、数据库、附件位置、通知方式和外部账号来源；不要把产品与项目同名当作已经建立关联。

建议以需求编号和发布编号关联 GitLab 提交、Jenkins 构建、YApi 契约版本、Archery 工单及 WIKI 复盘。统一编号只承担索引作用，不在评论中粘贴真实凭据、敏感 SQL 结果或生产日志原文。链接目标权限由源系统控制，不能因项目可见就推定所有附件可公开。

先用合成需求走一次提出、评审、任务拆分、开发、测试、缺陷回归和发布确认。每个状态写清进入条件、责任人和必需证据；缺陷关闭应由约定角色确认复测，不能仅凭开发者提交修复即关闭。

跨系统关联先从可审阅链接开始，自动同步须明确字段权威来源、重试策略、冲突规则和停用方式。试点同步只使用测试项目，避免同名字段双向覆盖。迁移历史项目时核对成员映射、状态含义、附件和评论时间，不擅自把旧系统已归档项目重新激活。

检查无负责人任务、长期阻塞需求、未复测缺陷、缺少发布证据的已关闭项和即将到期里程碑。统计口径需区分新增、关闭、重新打开以及历史迁移数据，避免因为批量补录造成错误进度判断。

平台巡检检查登录、数据库连接、附件上传下载、通知队列、定时备份和磁盘空间。值班交接记录当前变更窗口、未解决高影响缺陷、负责人与应急联系渠道；不以群聊天截图替代可搜索、可追踪的正式交接项。

任务找不到先核对产品、项目、迭代筛选及成员权限，再查是否归档或迁移；不可直接批量重建，以免产生编号冲突。页面数据正常而附件丢失，独立核查存储挂载、路径映射和访问权限，不把数据库恢复成功等同附件已恢复。

通知未到时区分状态变更是否产生、任务是否排队和外部邮件或消息渠道是否拒绝。跨系统状态不同步时先暂停有问题的同步方向，比较原始事件和权威字段，不能用全量覆盖来掩盖冲突。

官方备份说明将配置、修改代码、数据库和附件都列入范围，具体方式随安装形态变化。禅道备份文档本方案因此要求备份清单覆盖这四类内容，并记录同一恢复批次及校验结果，不直接照搬其他安装环境的数据路径。

恢复使用隔离实例，先禁用真实通知与同步，再核对需求数、缺陷数、状态、成员、评论和附件打开情况。数据库与附件跨时点恢复可能出现孤立记录，应列出差异并由项目负责人决定补录。恢复点后的需求编辑和状态变更不能无提示覆盖。

用一条需求证明从提出到发布的证据可追踪，再验证无权限成员不能读取受限项目、离职账号不能继续编辑、故障恢复后附件和历史评论可用。缺少字段映射评审、数据归属不清、恢复样本不可读或同步会覆盖正式状态时，停止迁移和扩大接入。

部署与迁移前对照禅道官方使用手册选择实际安装方式的备份方法；本文不提供覆盖目录或导入生产数据库的快捷指令。知识交接的长期保存要求见WIKI 手册。