需求文档与需求分析的概念介绍

保罗骑士

需求的重要性

“需求”是技术开发的基础。这是开发的标准，同时是前期的成本预估，计划制定也都依赖于需求。从产品的设计、功能开发、过程中的测试、最后的验收，这些都依赖需求的描述。
需求的种类有很多：产品需求、功能需求、非功能需求，系统需求、软件需求、硬件需求……
需求的定义

ASPICE中无论是系统需求还是软件需求，它们表达方式上也有所差异，但其背后的思想、希望达到的效果都是一样的。因为他们底层的属性是一样的。
需求是什么？需求，就是描述要实现的功能是什么。这里所说的功能是广义层面的。就是要搞清楚你（上游）想要什么，我（开发者）要干什么。
需求说明书/需求文档

“需求”用文档表现出来——就是所谓的《需求说明书》或《需求文档》（以下文章中会交替使用“需求说明书”、“需求文档”）。它是站着技术视角，用专业的技术语言，按照特定的格式进行描述。它不是用日常用语随意的描述。
需求说明书的基本要素

按照特定的格式描述，并不是说要按照统一的模板写，而是指需求文档中要包含某些基本的要素。至少我参加过的CMMI 3、26262、ASPICE的培训， 老师给的模板都不同。但是它们里面都有一些共同的要素。也正是这些基本的要素构成了一个合格的需求文档。
需求规格说明书中要包含的要素：

• 需求的ID
  
• 对需求的详细描述
  
• 相关需求之间的关联性
  
• 需求的验证标准
  

需求说明书的基本要求

光有这些要素还构成不了一个合格的需求文档，它还需要有相应的质量要求：

• 需求必须要可以验证，否则在验收时无法知道工程师是否完成了需求。无法单独验证的需求就没有必要单独写出来了。
  
• 需求描述不能有歧义。
  
• 需求用客观的方式度量，不能用主观判断的描述。
  
• 不可将多个需求打包放在一条需求中描述。
  

为了更容易理解，我举一些反面例子说明。

• “电池电压下于9v后禁止迎宾功能。”这个需求描述的存在歧义。 它是想表达在该场景下禁止迎宾功能，还是从此以后禁止该功能项？
  
• “车速度要快”这个描述没有量化。应该这样描述速度要小于 xx km/h。
  
• “在5门上锁的状态下，按下遥控设防按键，则整车设防模式，转向灯闪点亮200ms。如果此时开任意一门，则整车进入报警模式，转向灯400ms亮400ms灭输出1分钟，喇叭200ms响800ms关闭输出1分钟” 这条需求是把2条需求放在一起了，没有拆分开。可以把它拆分成设防逻辑和防盗报警逻辑。
  

技术领域中需求说明书的目的

需求文档写好后先要和客户确认其正确性。让客户看看该文档所描述的是否是客户期望的。
当需求确认后，需求说明书是要作为开发人员的输入文档。工程师根据文档要求开发产品。
同时测试工程师会以需求文档为输入文件。根据需求文档编写测试用例。
<hr/>需求分析

需求分析的本质

需求文档告诉工程师要干什么。把需求整理出来，这个过程就是需求分析。需求分析的本质就是运用专业知识分析出要完成的工作，并且以文档的形式写出来。
需求分析的几个维度

怎么样分析才能够让工程师拿着需求文档就可以知道要干什么呢？从以下几个角度分析可以做到：清晰性、一致性、正确性、完整性。
也就是说工程师基于自己专业的知识对所需要做的事进行梳理。把含糊不清的定义清楚；把可能有相互矛盾的地方识别出来；把未考虑到的补充完整；最后也需要和客户确认是否与客户的原始意图一致。
至于需求分析得出的需求文档是否所能达到的效果，这取决于工程师的专业水平和工作经验。所以，工程师如果没有3-5年的相关业务经验是无法做需求分析的。优秀的开发团队都会安排有经验的工程师写需求文档，甚至会有专门的团队做需求分析。
<hr/>上述文章中所谈论的都是关于需求和需求分析的基本层面。好的需求文档远比我这里所写的要多。各个公司也会根据自己的业务特性和团队情况在需求文档中增加一些定制化的要素。
需求分析的初衷就是为了提高开发效率。前期需求梳理的越完善，后续的开发工作越简单。
相关文章链接：
Aspice学习笔记：https://zhuanlan.zhihu.com/p/483962308

火炬哥

1v1飘过