# 一页流程图就开工，软件开发最容易漏掉什么

- Link: https://www.itor.cn/1434.html
- Published: 2026-11-12T01:59:36+08:00
- Author: it

软件开发项目常常启动得很快：客户拿来一页流程图，几个方框加几条箭头，把业务从提交
到完成的路径画出来，双方沟通几次就认为需求已经清楚，开发随即排期。等第一版交付，
问题才集中暴露。客户问某个按钮为什么只有主管可见，开发才发现原图没标注角色；测试
人员问某个字段填错该提示什么，才发现流程图只画了顺利走通的那条线；验收时双方对“做
完了”的理解不一致，才发现谁也没定义过验收标准。流程图能说明业务先做什么、后做什么，
却说不清每一步由谁操作、填什么内容、出错怎么办、做到什么程度算合格。这些空白不会
因为开工而消失，只会在开发中后期以返工的形式补回来。

开发前需要补齐的第一类信息是角色与权限。流程图的每个节点都要标注清楚由哪类角色发起、
哪类角色审批、哪类角色只能查看。同一张表单，普通员工、部门负责人和管理人员看到的
内容往往不同，这些差异必须提前写明，而不是等开发人员自行推测。

第二类是数据字段与来源。每个环节需要填写或展示哪些字段，字段是必填还是选填，长度
和格式有无限制，数据由用户手工录入、系统自动生成还是从其他模块带出，都要逐项列清楚。
字段来源不清，后期最容易出现同一份数据在两处对不上。

第三类是异常分支与提示。流程图画的是正常路径，实际使用中会出现提交重复、审批超时、
资料缺失、权限不足等情况。每一种异常应有怎样的提示语、是否可以撤回重提、超时后如何
处理，都需要补充说明。这部分内容往往决定系统上线后用户能否自己解决问题。

第四类是验收口径与责任边界。哪些功能属于本期范围，哪些留待后续，每项功能用什么方式
验证通过，由谁确认，都应在开发前形成文字。验收标准写得越具体，后期争议越少。

补文档的顺序可以这样安排：先补角色和字段，因为这两项决定数据结构，改动成本最高；
再补异常流程和提示语，它们依附在已有流程之上；最后与客户逐条过验收条目，确认一条
勾掉一条。整个过程不必追求文档厚度，一页流程图配上几页清单，已经足够支撑开发。

需要说明的是，并非所有内容都必须卡在开工前确认。界面配色、文案措辞、部分操作细节
可以在开发过程中逐步调整。但角色权限、核心字段、数据来源和验收口径属于地基，一旦
开发推进再改，牵动的往往是多处联动修改。把“必须前置”和“可以后置”分开，既能保证开发
质量，也能避免需求确认被无限拉长。

把技术问题说明白，把交付过程做清楚，是it数运在需求梳理中坚持的做法。面对只有一页
流程图的项目，先帮客户把角色、字段、异常和验收四条线补完整，再进入开发，后续的沟通
和交付都会顺畅很多。