需求文档化与验证
一、为什么文档化需求
合作和交流
- 项目管理人员
- 工程师
- 软件设计人员
- 程序员
- 维护人员
二、用例文档
在用户的角度以用例文本为主描述软件系统与外界的交互
基本职责是把问题域信息和需求传达给软件系统解决方案的设计者
三、软件需求规格说明文档
在软件产品的角度以系统级需求列表的方式描述软件系统解决方案
| 用例 | 系统规格 |
|---|---|
| 侧重于交互流程 | 侧重于独立需求 |
| 以一次交互为基础 | 以一次交互中的软件系统处理细节为基础 |
示例：
四、文档化需求的注意事项
技术文档写作要点
- 简洁
- 精确
- 易读（查询）（有效使用引言、目录、索引等能够增强文档易读性的方法）（使用系统化的方式组织内容信息，提供文档内容的可读性）
- 易修改
系统化的方式
- 相同的语句 表达 相似关联的信息
- 列表或表格 组织 独立并列的信息
- 编号 表达 繁杂信息之间的关系
需求书写要点
- 使用用户术语
- 可验证
- 可行性
需求规格说明文档书写要点
- 充分利用标准的文档模板，保持所有内容位置得当
- 保持文档内的需求具有完备性和一致性
- 为需求划分优先级
五、需求验证文档
验证需求的方法
- 评审
- 开发系统测试用例
- 度量
评审注意事项
重视需求评审，保证用户于与客户参与，使用检查列表
开发系统测试用例
- 以需求为线索，开发测试用例套件
- 使用测试技术确定输入/输出数据，开发测试用例
测试用例套件：
建立测试用例：
主要是基于规格的技术，设计测试场景的输入与输出数据
六、度量需求功能点
度量需求：
- 用例的数量（平均每个用例中的场景数量，平均用例行数）
- 软件需求数量
- 非功能需求数量
- 功能点数量
度量的意义：
- 用例过低：可能存在异常考虑不周
- 用例行数过大过小：用例细分粒度过大过小
- 用例数量、软件需求数量、功能点数量应该是相对比例均衡的。差距大可能有需求遗漏
功能点度量
用于估算和度量软件系统规模与复杂度的抽象单位
- 输入数量
- 输出数量
- 查询数量
- 逻辑文件数量
- 对外接口数量
需求的度量
功能点测度总数=每个功能点乘以加权因子的总和
