软件项目设计文档分类
软件项目设计文档分类
author：chinayaosir(jack.yao)
blog: http://blog.csdn.net/chinayaosir/
QQ: 44633197
声明：严禁其它网站不经过作者chinayaosir同意任意转载
软件设计所需要的知识与技能
UML 统一建模语言
软件工程
面向对象的编程 OOP
操作系统
数据库原理
设计模式
沟通能力
丰富的软件开发经验
------------------------------------------------------------------------------------------------------------------------------------
通常来说，作为软件项目，我们需要有这几类文档
1.需求说明文档
2.功能设计文档
3.系统架构说明书
4.模块概要设计文档
5.模块详细设计文档
------------------------------------------------------------------------------------------------------------------------------------
就像我之前说到的，在某个软件团队，对于以上的文档的要求是可以完全不同的，
在简单项目中，可能所有类型的文档放在一个文档中进行说明；
在复杂项目中，每一类文档可能都要写几个文档；
而在最极端的情况下，可能每一类文档都能装订成几册。
因此，在我们软件设计和开发人员心目中需要明确的是：文档并不是我们进行设计的目标，也不是我们设计过程中额外的工作。
软件设计文档是我们在软件设计开发过程中形成的，用来在软件设计开发团队内部以及与各干系人之间进行沟通的文档，
这些文档记录了软件项目中的各种知识，方案的思路、以及各种决策意见。
下面我们就软件设计开发过程中必须要完成的工作进行梳理，而我们需要注意到，这些需要完成的工作，
在不同的开发流程模型的指导下可能有不同的时间要求，而我们需要关注的是在这个阶段内需要完成的工作，以及这个阶段内我们需要沟通的人员。
------------------------------------------------------------------------------------------------------------------------------------
需求分析
需求分析是我们进行任何一个软件项目设计开发过程中都必须要完成的工作。
这个工作通常与客户一起完成。在不同的项目中，
这个“客户”可能来自真正的购买产品的用户，使用系统的用户，也有可能来自团队的某个人员，如产品经理等。
软件设计开发团队的参与成员根据项目的不同规模，则参与的人员也有所不同。
原则上，设计开发人员参与的时间点越早，对于需求的理解和把握会更好。这个阶段，通常需要软件架构师参与其中。
从资源优化的角度来说，开发人员不必参与需求分析，但需要理解需求。
需求分析的结果通常我们需要使用需求说明文档来描述，
目前主流的需求描述方法包括：用户例图、用户故事，用户场景等方式。
这些方式有所不同的侧重，其核心思想就是描述清楚用户的使用场景。
但无论采取何种方式，进行需求的描述，需求说明需要明确以下几点：
所需要开发的软件系统边界
系统所有的相关及使用人员角色
系统关键的使用场景
系统规模、性能要求以及部署方式等非功能性需求
------------------------------------------------------------------------------------------------------------------------------------
功能设计
功能设计与需求分析差不多同时在开展，在很多软件项目中，对于功能设计不是特别重视。
但对于某些软件项目而言，这是一个相当重要的工作。
对于主要是用户界面的软件项目来说，功能设计可以看作是画出原型界面，描述使用场景，获得用户认可的过程。
而对于没有界面的软件项目来说，则功能设计与需求分析的区分更为模糊。
参与的人员与需求分析的参与人员类似，架构师更侧重于参与此类工作，并给与一些实现层面的判断和取舍。
功能设计需要明确的核心是：
系统的行为
------------------------------------------------------------------------------------------------------------------------------------
系统架构设计
系统架构设计是一个非常依赖于经验的设计过程。
需要根据软件项目的特定功能需求和非功能性需求进行取舍，最终获得一个满足各方要求的系统架构。
系统架构的不同，将很大程度上决定系统开发和维护是否能够较为容易的适应需求变化，以及适应业务规模扩张。
架构设计工作中，用户参与程度很低。软件开发团队中的需求人员参与程度很低，
但团队中的所有核心设计和开发人员都应该参与其中，并达成一致意见。
架构设计的主要成果，是将系统的不同视图予以呈现，并使之落实到开发中：
技术路线选择
系统开发视图
系统逻辑视图
系统部署视图
系统模块视图
系统的领域模型
在软件开发过程中，系统的架构不是一成不变的，随着设计人员和开发人员对于系统的理解不断深入，系统的架构也会发生演化。
在软件项目中，架构设计是开发团队沟通的统一语言，设计文档必须要随着系统的变化进行更新，保障开发团队对于系统的理解和沟通的一致性。
------------------------------------------------------------------------------------------------------------------------------------
模块/子系统概要设计
模块/子系统的概要设计，
由架构师参与，核心设计和开发人员负责的方式进行。
在概要设计工作中，我们需要在架构确定的开发路线的指导下，完成模块功能实现的关键设计工作。
在概要设计阶段，需要关注于模块的核心功能和难点进行设计。
这个过程中更多推荐的采用UML来进行概要设计，需要进行：
模块实现机制设计
模块接口设计
关键类设计
画出时序图
交互图等。
------------------------------------------------------------------------------------------------------------------------------------
模块详细设计
在瀑布式开发模型中，模块的详细设计会要求比较严格，将所有类进行详细设计。
据我所知，除了一些对于系统健壮性要求非常严格的软件项目，如国防项目，金融项目还要求有详细设计文档之外。
其他的项目大多采用其他方式来处理这样的工作，如自动化测试等。
------------------------------------------------------------------------------------------------------------------------------------
综上所述，软件设计文档作为软件开发团队的沟通、理解、知识共享的手段，具有非常重要的意义。
而根据软件团队的规模，对于文档上承载的信息详细程度可以有不同程度的要求。
我们软件团队对于如何使用设计文档有一个统一的理解，并坚持更新设计文档，这就是软件设计的最佳实践！
软件项目设计文档分类相关推荐
- 软件设计文档如何编写，设计文档内容都包括什么
我们经常听到这样的话: "设计文档没有用,是用来糊弄客户和管理层的文档": "用来写设计文档的时间,项目开发早就做完了": "项目紧张,没有时间做设计 ...
- 软件概要设计文档（终）
软件概要设计文档 1.引言 1.1目的 该文档的目的是描述辅助选课系统的概要设计,主要内容包括系统功能简介.系统结构设计.系统结构设计.系统接口设计.模块设计和界面设计等. 本文档预期的读者包括设计人 ...
- 项目管理中软件项目文档的分类管理
软件文档可以分为产品文档和开发文档两大类. 产品文档包括:<产品简介>.<产品演示>.<疑问解答>.<功能介绍>. <技术白皮书>. ...
- 内部软件技术文档怎么做？
今天,互联网被认为是一个知识库.任何人都可以使用互联网访问任何类型的信息,例如文档,查看超文本和多媒体(音频和视频)通过Web服务器数据库. 此外,对于任何组织来说,提供对公司网站的公开访问都变得必要 ...
- 背单词-项目设计文档
项目设计文档 团队成员及分工 成员姓名 分工 比重 宋凯伦 完善代码 20% 吴岱岚 收集资料 20% 杨骏轩 撰写博客,画图 20% 黄栋 撰写需求文档 20% 孔祥龙 制作ppt 20% 系统设计 ...
- 【机器学习入门】(2) 朴素贝叶斯算法：原理、实例应用（文档分类预测）附python完整代码及数据集
各位同学好,今天我向大家介绍python机器学习中的朴素贝叶斯算法.内容有:算法的基本原理:案例实战--新闻文档的分类预测. 案例简介:新闻数据有20个主题,有10万多篇文章,每篇文章对应不同的主题, ...
- 敏捷开发：软件与文档
也曾尝试过,不带文档的"裸体"前进,可想而知,最后经常造成项目的返工,新来的人员要拼命读以前的人留下的几乎没有注释的源码. 后来尝试过,制订完善的规范,用了大量的软件 ...
- 软件需求分析文档模版
软件需求分析文档模版(转载自国家计算机标准和文件模板) 软件需求分析就是把软件计划期间建立的软件可行性分析求精和细化,分析各种可能的解法,并且分配给各个软件元素.需求分析是软件定义阶段中的最后一步,是 ...
- 局域网聊天软件 设计文档怎么写？
局域网聊天软件 设计文档怎么写?这种针对数据库记录的 局域网聊天软件 窃取,被一些攻击者称为拖库,于是有了一个自然而谐音的戏称脱裤.只是攻击者日趋不厚道,从前只是偷了人家的裤子,现在还要晾在大街上,并 ...
- 软件项目文档_什么是软件项目的好的文档？
软件项目文档 开放地理空间(OSGeo)基金会最近参加了Google的第一个文档季节 ,其中Google赞助了高级技术作家为开源项目做出贡献. OSGeo是大约50个地理空间开源项目的总括组织. 多年 ...
最新文章
- 渐进式遗传组卷算法（大规模题库，实际可用的算法） 智能组卷系统
- 异常检测-孤立森林(IsolationForest)
- TensorFlow | 使用Tensorflow带你实现MNIST手写字体识别
- 线性规划之单纯形法（2）
- 如何摆脱「自我否定」状态
- LeetCode 212. 单词搜索 II（Trie树+DFS）
- rhel5之光盘更新终结篇
- 快学Scala习题解答—第一章 基础
- 手把手Maven搭建SpringMVC+Spring+MyBatis框架(超级详细版)
- vue按钮Button
- asp.net网页版斗地主 已提供下载(开源) 测试版
- 小米笔记本装linux教程视频教程,手把手教你加装SSD，让小米笔记本运行更加666！...
- 面试官系列：前端高频面试题汇总 | Vue面试题
- 软件开发人员应该了解测试和QA
- 液压传动与气动技术【2】
- 图片怎么转换成PDF格式？这两种方法赶紧记下
- nz-modal 使用
- 【运维】- raid管理工具MegaCli以及storcli使用介绍
- 达达-高性能服务端优化之路
- 学习html/css基础的重点笔记