技术规格和设计文件有什么区别?


38

什么是技术规格?它们是否与设计文件相同?如果没有,有什么区别和一些例子?


1
前者错过了设计,而后者错过了技术性。

Answers:


33

软件设计文件可以是在一个系统或组件的水平,并且通常包括:

  • 相关目标或要求(功能性和非功能性);
  • 静态结构(例如,组件,接口,依赖项);
  • 动态行为(组件如何相互作用);
  • 数据模型或外部接口(在文档中描述的系统/组件外部);和
  • 部署注意事项(例如,运行时要求,第三方组件)。

请注意,所有这些描述都是抽象级别的。目的是使读者对系统或组件有广泛的一般了解。设计文档可能有很多级别(例如,系统级别或组件级别)。

技术规范描述了一种设计的全部或特定部分,如的微小细节:

  • 接口的签名,包括所需的所有数据类型/结构(输入数据类型,输出数据类型,异常);
  • 详细的类模型,包括所有方法,属性,依赖关系和关联;
  • 组件采用的特定算法及其工作方式;和
  • 物理数据模型,包括每个实体/数据类型的属性和类型。

1
那么我们什么时候应该实际编写技术规范。开发之前?随着发展?或..之后?
shashwat 2014年

2
@ShashwatTripathi通常,规范是在开发之前编写的,以便其他人(或您稍后)可以实现这些组件。在完成开发后编写规范会使它毫无意义(除非您将其用作已实现内容的技术文档)。
miraculixx 2014年

我遇到了这个确切的场景,该场景是为一家大型公司从事多年项目的。在将项目迁移到Test然后又迁移到Prod!之后,我们在创建业务需求文档方面进行了反向工作。是的,很棒的项目管理,我知道!
ThinkCode

在功能上分解了详细的软件需求规范之后,是否不会创建技术规范?架构师如何创建没有SRS的TS?看来他/她将需要承担一吨的责任。
Oracular Man

同意,TS应该遵循SRS(系统需求规范)。但是请注意,这些术语尚未标准化,并且可以将其作为SRS的详细形式(在嵌入式系统中通常使用)创建,也可以将其用于补充高级SRS即设计文件(在商业应用中通常使用) )。关键是需求,设计和规格文档分别描述了系统及其组件的一个特定视图。团队同意所需的视图和详细程度比满足某些正式定义更为重要。
miraculixx

7

技术规范,至少以技术设计的形式,是设计文档的一部分,例如,需求列表,功能设计,用户案例,图形设计模型,可用性研究,UML图,业务流程图,数据型号规格等

事后编写的用于记录成品的类型的技术规格通常属于设计文件的一部分,但可以包含在更高版本(供参考)或具有以下功能的另一种产品的设计文件集中:依靠他们。


谢谢。基本上我也需要功能说明来知道要做什么,然后设计文档来知道要怎么做,对吗?只是一个问题,您指的是什么功能设计(希望它不会使我对功能规格的理解更加混乱)
John V

功能设计从用户的角度定义了产品的预期功能,而没有涉及实现细节。这里有很多问题,有很好的答案,可以详尽地解释什么是功能设计,什么不是功能设计。
tdammers

1
那么我们什么时候应该实际编写技术规范。开发之前?随着发展?或..之后?
shashwat 2014年
By using our site, you acknowledge that you have read and understand our Cookie Policy and Privacy Policy.
Licensed under cc by-sa 3.0 with attribution required.