研发平台状态配置的关键,是先把业务规则整理成可执行的清单,再映射到平台的工作项类型、状态集和流转条件上。本文按“定清单、画流转、落平台、做验证、过上线检查”的顺序展开,每一步都给出输入、动作和交付物,适合正在搭建或调整研发流程的团队参考。
要点总览(TL;DR)
- 状态配置从一份经评审的状态清单开始:按需求、任务、缺陷、评审等对象分别列出状态名、含义、进入与退出条件,并合并含义重叠的状态。
- 流转规则用一张五列表表达:起点状态、动作、目标状态、触发条件、执行角色;回退、跳转和终态要单独约定。
- 落到平台时按“工作项类型→状态集→流转条件→权限角色”的顺序配置,并同步记录配置项、取值、配置人和时间。
- 配置是否可用,用一条真实需求走通主路径和驳回、回退等异常路径来验证,问题按“规则歧义”和“配置不一致”分别修正。
- 上线前逐项核对规则一致性、权限无越权与断点、历史数据处理、验证结果和变更维护机制,签署后再正式启用。
先定状态清单:哪些对象需要状态、各有哪些状态
状态配置的第一步是准备输入物,也就是一份经过评审的状态清单。平台上的状态不是凭空设计的,它来自研发过程中各业务对象实际经历的阶段。建议由业务负责人牵头,把需求、任务、缺陷、评审等对象分别列出,逐一确认每个对象需要哪些状态。
状态清单建议包含五列:对象、状态名、含义、进入条件、退出条件。其中“含义”一列尤其重要,同一个状态名在不同团队可能有不同理解,例如“已完成”是指开发完成还是验收完成,必须在清单里写清楚唯一解释,避免后续配置和沟通出现歧义。
| 对象 | 状态名 | 含义 | 进入条件 | 退出条件 |
|---|---|---|---|---|
| 需求 | 待评审 | 需求已提交,尚未通过评审 | 需求创建并提交 | 评审通过或驳回 |
| 需求 | 开发中 | 需求已排期,进入实现阶段 | 评审通过并分配负责人 | 开发完成并提交测试 |
| 任务 | 进行中 | 任务已开始执行 | 任务被领取或指派 | 任务完成或转交 |
| 缺陷 | 待修复 | 缺陷已确认,等待处理 | 缺陷验证为有效 | 修复完成并提交验证 |
| 评审 | 评审中 | 评审活动正在进行 | 评审发起并通知参与人 | 形成评审结论 |
状态数量需要控制。原则是状态与业务阶段一一对应,含义重叠的状态应合并,例如“开发完成”和“待测试”如果指向同一节点,保留一个即可。为个别例外单独增设状态,会让流转路径变复杂,后续维护成本上升。清单完成后,组织业务负责人、平台管理员和相关角色做一次评审确认,确认后的版本作为配置依据。
画清流转规则:允许的路径、条件与责任人
状态清单回答“有哪些状态”,流转规则回答“状态之间怎么走”。这一步的产物是一张流转规则表,建议包含五列:起点状态、动作、目标状态、触发条件、执行角色。它既是业务共识,也是平台配置的直接输入。
先画状态流转图,把每个对象允许的合法路径标出来。以需求为例,典型路径是“待评审→开发中→测试中→待验收→已完成”,每条连线代表一次流转动作。图上要明确哪些路径允许、哪些不允许,例如需求能否从“待评审”直接跳到“已完成”,这类跳转需要业务上明确约定。
流转条件要写成可判断的规则,例如“评审通过”需要有评审结论记录,“测试完成”需要有测试通过的结果。条件写得越具体,平台配置时越容易对应到具体字段或校验项。执行角色则说明谁有权触发这次流转,例如“提交测试”由开发负责人执行,“验收通过”由需求提出方执行。
回退、跳转与终态需要单独约定。回退指从后续状态退回前序状态,例如测试不通过退回开发中,要明确回退是否需要填写原因、由谁审批。跳转指跨阶段的直接流转,应限定在少数合理场景。终态是流程结束的状态,例如“已完成”“已关闭”,进入终态后一般不再允许修改,确需变更时走单独的重新打开规则。
| 起点状态 | 动作 | 目标状态 | 触发条件 | 执行角色 |
|---|---|---|---|---|
| 待评审 | 评审通过 | 开发中 | 评审结论为通过 | 评审负责人 |
| 开发中 | 提交测试 | 测试中 | 开发完成并关联测试任务 | 开发负责人 |
| 测试中 | 测试不通过 | 开发中 | 填写缺陷或回退原因 | 测试负责人 |
| 测试中 | 测试通过 | 待验收 | 测试用例执行完成 | 测试负责人 |
| 待验收 | 验收通过 | 已完成 | 验收结论为通过 | 需求提出方 |
在平台上落地:工作项类型、状态集与流转配置
规则整理完成后,进入平台配置环节。核心动作是把状态清单和流转规则映射到平台的工作项类型、状态集和流转条件上。配置顺序建议是:先建工作项类型,再配状态集,然后设流转条件,最后绑定权限与角色。
工作项类型与状态集存在对应关系。需求、任务、缺陷、评审通常对应不同的工作项类型,每种类型挂载各自的状态集。配置时先确认类型划分与状态清单中的对象一致,避免出现一个类型承载多种对象状态的情况。状态集内按清单顺序录入状态,并填写状态说明,让使用者在界面上能看到状态含义。
流转条件按规则表逐条配置。每条流转对应一个动作,配置时需要指定起点状态、目标状态和触发条件。条件可以落在字段校验、必填项或关联记录上,例如“提交测试”要求关联测试任务存在。配置顺序上,建议先配主路径,再配回退和跳转路径,便于逐条核对。
权限与角色绑定决定谁能执行哪些流转。按规则表中的执行角色,把流转动作分配给对应角色或人员组,同时检查是否存在越权入口,例如普通成员能否直接关闭需求。配置完成后,把配置项、取值、配置人和时间记录到配置记录表中,作为后续变更追溯的依据。
在工具承载层面,ONES Project 提供自动化规则能力,管理者可在「配置中心」的「自动化规则」页面管理团队使用的流程自动化规则,并可根据需求自定义规则。其预置模板包含任务与需求的状态联动、父子工作项状态联动等场景,例如全部任务完成后自动完成来源需求。规则运行提供日志用于排查问题。具体状态集与流转条件的配置入口以产品内实际配置项为准,配置时建议同步记录配置版本,便于回溯。
角色与交付物分工:谁定义、谁配置、谁验收
状态配置涉及规则定义和平台操作两类工作,分工不清容易出现“规则写了但配不上去”或“配了但业务不认”的情况。建议明确四类角色及其交接物。
| 角色 | 主要职责 | 交付物 |
|---|---|---|
| 业务负责人 | 定义状态、含义与流转规则,组织评审确认 | 状态清单、流转规则表 |
| 平台管理员 | 执行平台配置,维护配置记录 | 平台配置记录 |
| 测试或质量角色 | 参与配置验证,设计验证用例 | 验证用例与问题清单 |
| 变更审批人 | 审批配置变更,确认发布 | 变更审批记录、上线签署 |
交接时以文档为准:业务负责人把评审通过的状态清单和流转规则表交给平台管理员,管理员按表配置并回填配置记录,测试角色依据规则表设计验证用例。配置变更同样走这条链路,先由业务负责人确认规则调整,再由管理员执行,审批人确认后发布,避免口头变更导致平台与规则脱节。
用一个真实需求走通全流程:配置验证示例
配置完成后,用一条真实需求走通全流程,是检验规则是否可用的直接方式。以下为演示情景,用于说明验证方法。
假设一条需求从创建开始,依次经历“待评审→开发中→测试中→待验收→已完成”。创建后由提出方提交评审,评审负责人执行“评审通过”,需求进入开发中并分配开发负责人;开发完成后开发负责人执行“提交测试”,需求进入测试中;测试负责人执行“测试通过”,需求进入待验收;需求提出方执行“验收通过”,需求进入已完成。每个环节核对状态是否按预期变化、条件是否被正确校验、执行角色是否有对应权限。
异常路径同样要验证。测试不通过时执行回退,确认需求能退回开发中且回退原因被记录;评审驳回时确认需求回到待评审或关闭;尝试用无权限账号执行流转,确认系统拦截。验证中发现的问题分两类处理:规则本身有歧义的,回到状态清单和流转规则表修订;配置与规则不一致的,由平台管理员修正配置并更新配置记录。验证结果和修正项汇总成验证用例记录与问题修正清单。
上线前完成检查:配置是否可交付
正式启用前,逐项核对以下检查项,全部通过并留下签署记录后再上线。
| 检查项 | 完成标准 | 确认人 |
|---|---|---|
| 状态与流转规则一致性 | 平台中的状态、路径、条件与评审通过的清单和规则表逐条对应 | 业务负责人 |
| 权限配置 | 各流转动作的执行角色正确,无越权入口,无流程断点 | 平台管理员 |
| 历史数据处理 | 存量工作项的状态映射方式已确认并执行或安排执行 | 平台管理员 |
| 验证结果 | 主路径与异常路径验证通过,问题清单已关闭 | 测试或质量角色 |
| 变更与维护机制 | 配置变更的申请、审批、记录和回滚方式已明确 | 变更审批人 |
检查通过后,由变更审批人签署上线记录,配置正式生效。上线后保留配置记录和验证用例,后续每次调整状态或流转时沿用同一套清单、规则表和验证方法,让平台配置持续与业务规则保持一致。
常见问题
状态清单评审时,业务负责人和平台管理员各自要确认什么?
业务负责人确认的是业务侧内容:每个状态的含义是否唯一、进入和退出条件是否与实际工作一致、状态数量是否已合并重叠项。平台管理员确认的是可配置性:每个状态能否对应到工作项类型和状态集,每个流转条件能否落到具体字段、必填项或关联记录上。
两类确认分开做,可以避免评审会上只讨论业务含义、没人判断能否配置,或者只讨论配置可行性、业务含义被含糊带过。评审结论形成清单版本,作为后续配置和变更的依据。
团队规模小、流程简单时,状态配置可以简化到什么程度?
流程简单的团队可以只保留与关键阶段对应的状态,例如需求保留“待评审、开发中、待验收、已完成”四个状态,把测试环节并入开发中或待验收。回退路径保留一条即可,跳转路径可以暂时不开放。
简化的前提是状态含义仍然写清楚,流转条件仍然可判断。简化的是状态数量和路径分支,不是规则本身的明确性。随着团队协作复杂度上升,再按同一套清单和规则表方法补充状态,比一开始就设计复杂流程更容易维护。
配置上线后业务规则要调整,怎么改才不至于让平台和历史数据混乱?
沿用配置时的同一条链路:业务负责人先修订状态清单和流转规则表并确认,平台管理员按修订后的表调整配置并更新配置记录,变更审批人确认后发布。涉及新增或删除状态时,先确认存量工作项如何映射到新状态,再执行配置变更。
每次调整保留配置记录和对应的验证用例,出现问题时可以对照记录定位是哪次变更引入的差异。避免口头通知直接改配置,否则平台状态与规则表会逐渐脱节,后续排查缺少依据。
验证阶段发现流转走不通,应该改规则还是改配置?
先判断问题出在哪一侧。如果规则表本身对某个场景没有约定,或者约定存在歧义,例如回退是否需要审批没写清楚,属于规则问题,回到状态清单和流转规则表修订,再重新评审确认。如果规则表写清楚了但平台行为与规则不一致,例如条件没有生效、角色权限缺失,属于配置问题,由平台管理员修正配置并更新配置记录。
两类问题分开记录,修正后重新跑一遍对应路径,确认问题关闭后再进入上线检查。
ONES 在状态配置这件事上能提供哪些支撑?
ONES Project 提供自动化规则能力,管理员可在「配置中心」的「自动化规则」页面管理团队使用的流程自动化规则,并可根据需求自定义规则。预置模板包含任务与需求的状态联动、父子工作项状态联动等场景,例如全部任务完成后自动完成来源需求;规则运行提供日志用于排查问题。
状态集与流转条件的具体配置入口以产品内实际配置项为准,配置时建议同步记录配置版本,便于回溯。公有云与私有部署团队可免费试用,专业版与企业版提供私有部署,具体权益以官方最新价格页为准。
