详细设计文档模板

文件名称		文件版本	V1.0
文档编号		总页数	共  页

 

                                                                                                    xxx系统详细设计说明书                                                                                                           

 

拟  制		日  期
复  核		日  期
质  量		日  期
标准化		日  期
批  准		日  期

                                                                   xxx有限公司

                                                                  修订记录

日期	修订版本	描述	作者

 

目    录

 

1       引言... 5

1.1             背景... 5

1.2             编写目的与范围... 6

1.3             术语定义... 6

1.4             参考资料... 8

1.5             相关工具... 8

2       设计概述... 8

2.1             任务和目标... 8

2.2             需求概述... 8

2.3             运行环境概述... 9

2.3.1         硬件环境... 9

2.3.2         支持环境... 11

2.4             限制和约束... 11

2.5             详细设计方法... 11

3       总体方案确认... 12

3.1             体系结构详细设计... 12

3.2             功能模块划分... 13

3.3             程序框架设计... 13

4       系统详细设计... 15

4.1             车辆信息维护... 15

4.1.1         界面... 15

5       数据库设计... 40

6       安全性设计... 41

6.1             用户权限... 41

6.2             软件授权... 41

7       设计与开发规范... 43

 

1  引言

1.1   背景

xxx。

产品名称：xxx

所属系统：xxx

任务提出：xxx

任务承担：xxx

产品用户：xxx

应用场景：xxx。

1.2   编写目的与范围

本文档为“xxx系统详细设计说明书”，主要用于为实现系统功能而进行的系统详细设计说明，具体描述了系统包含的的软件模块的实现流程、功能、接口、数据结构等内容，供项目组开发人员和软件维护人员阅读。

本文档用于软件设计阶段的详细设计阶段，其范围是：系统各组成部门的构成；各软件模块（或类）的属性、方法、事件、外部接口；用户界面设计；数据结构设计等内容。

1.3   术语定义

分层：在分解复杂的软件系统时，软件设计者用得最多的技术之一就是分层。在计算机本身的架构中，可以看到：到处都有分层的例子。不同的层从包含了操作系统调用的程序设计语言，到设备驱动程序和CPU指令集，再到芯片内部的各种逻辑门。网络互联众，FTP层架构再TCP之上，TCP架构再IP之上，IP又架构再以太网之上。

当用分层的观点来考虑系统时，可以将各个子系统想象成按照“多层蛋糕”的形式来组织，每一层都依托在其下层之上。在这种组织方式下，上层使用了下层定义的各种服务，而下层对上层一无所知。另外，每一层对自己的上层隐藏其下层的细节。因此，第4层使用第3层的服务，第3层使用第2层的服务，第4层无需知道第2层的细节。（当然，并非所有的分层架构都这么隔绝，但绝大多数是不透明的，或至少是几乎不透明的。）

WPF：Windows Presentation Foundation（WPF）是Microsoft的一个图形子系统（类似于WinForms），用于在基于Windows的应用程序中呈现用户界面。 WPF，以前称为“Avalon”，最初于2006年作为.NET Framework 3.0的一部分发布.WPF使用DirectX，并尝试为构建应用程序提供一致的编程模型。

MVVM：Model-view-viewmodel是一种软件架构模式，它有助于将应用程序的业务和表示逻辑与其用户界面（UI）完全分离。 在应用程序逻辑和UI之间保持清晰的分离有助于解决许多开发问题，并使应用程序更易于测试，维护和发展。 它还可以极大地改善代码重用机会，并允许开发人员和UI设计人员在开发应用程序的各个部分时更轻松地进行协作。

MVVM模式中有三个核心组件：模型，视图和视图模型。 每个都有不同的目的。 下图显示了三个组件之间的关系。 

EF 6：Entity Framework 6是一个经过实践检验的.NET对象关系映射器（O / RM），具有经过多年开发的功能和稳定性。

作为ORM，EF6减少了关系和面向对象世界之间的阻抗不匹配，使开发人员能够开发这样的程序：使用.NET应用程序域中的强类型对象，与存储在关系数据库中的数据进行交互，这样就不再需要编写大量的数据访问“管道”代码。

1.4   参考资料

《xxx需求规格设计说明书》

1.5   相关工具

设计时采用Power Designer、Visio等工具。开发时采用Visual Studio 2019、Sql Sever Management Studio 2012等工具。

2  设计概述

2.1   任务和目标

 

2.2   需求概述

 

2.3   运行环境概述

本系统的运行环境的规定如下：

2.3.1       硬件环境

本系统的硬件环境包括：

a)  服务器

服务器硬件推荐选用宝德至强双路云服务器PR2510SW，其主要技术参数如下表所示：

表1 服务器主要技术参数

指标名称	指标参数
处理器型号	Intel® Xeon® E5-2600V3/V4系列处理器
处理器数量	1/2个
尺寸	2U机架
内存	8 DIMM插槽, 支持2400MHz DDR4的RDIMM内存 ，最大支持512GB
硬盘	支持8个3.5”/2.5” SATA/SAS/SSD硬盘，可内置两个2.5” SATA/SAS/SSD硬盘，最大支持存储容量68TB
板载网络	集成2个Intel i210千兆GE网口；可选配外接千兆及万兆网卡
PCIE扩展	提供6个PCI-E 扩展插槽（3 PCI-E3.0×8，1 PCI-E3.0×4（in×8），1 PCI-E 3.0 ×16， 1 PCI-E 2.0×4(in ×8)）
风扇	3个热插拔风扇

2.3.2       支持环境

本系统软件运行环境包括：

a)  xxx系统软件所需的软件支持环境包括：

1)   数据库： SQL Server 2008 R2；

2)   操作系统：Windows Server 2012 Enterprise（如需正版软件，由用户方提供）；

3)   Web Server：IIS 7.5

4)   .Net Framework 4.5.2

2.4   限制和约束

 

2.5   详细设计方法

本文采用结构化设计方法，结合数据流图进行整体功能模块的划分。针对各个具体模块的设计采用面向对象设计方法，结合相应的UML模型进行功能设计，具体包括以包图表示的软件体系结构图，以交互图表示的用例实现图，完整精美的类图、针对复杂对象的类图，用以描述流程处理过程的活动图。

3  总体方案确认

3.1   体系结构详细设计

 

3.2   功能模块划分

 

3.3   程序框架设计

本系统采用分层架构模式将整个系统分为业务展示层（提供服务、显示信息）、系统服务层（业务逻辑，系统中真正的核心）、数据采集层（与数据库、消息系统及其他软件包通信）。

表现层采用MVVM（Model-View-View-Model）设计模式，结合微软 WPF 框架，可以把界面设计（用xaml语言实现）和业务逻辑开发（用C#实现）分离。

领域层设计符合面向接口编程规范，这样可以降低层与层之间的耦合，也有利于接口设计和实现的分离，但针对基本的单表的增删改查服务则是直接调用数据源层的EF API来实现，从而减少过度的接口封装。

数据源层运用ORM技术来简化对数据表结构的维护，具体运用了微软 .Net框架下的的Entity Framework 框架。

 

4  系统详细设计

4.1   车辆信息管理

4.1.1   菜单

基础数据 >> 车辆信息

 

4.1.2   界面

 

4.1.3   界面描述

页面元素	元素说明
查询条件
车牌号	文本录入，忽略大小写模糊匹配
列表项
车牌号	PlateNumber
操作
页面加载	默认不查询数据
查询	查询表“xxx” 固定条件：IsDelete != true 查询条件：根据条件录入，对应字段 排序：ID 倒序

 

4.1.4   新增/修改界面

 

4.1.5   功能详细说明

xxx。

4.1.6   类图

 

4.1.7   主要方法

public List<xxxDto> QueryList(); //查询信息列表

 

4.1.8   数据库表

xxx xxx表，表关系如下图：

 

4.1.9   UML模型

 

5  数据库设计

数据库表整体结构如下，详见《xxx系统数据库设计说明》。

 

6  安全性设计

6.1   用户权限

 

6.2   软件授权

 

7  设计与开发规范

7.1   界面设计原则

以用户为中心：Theo Mandel博士创造了人机交互的“黄金三原则”：置于用户控制之下；保持界面一致性；减轻用户的记忆负担。

拥有良好的直觉特征：以用户所熟悉的现实世界事务的抽象来给用户暗示和隐喻，来帮助用户快速地学会使用软件。

较快的响应速度。

简单且美观。

7.2   面向对象程序设计原则

单一职责原则（SRP）：就一个类而言，应该仅有一个引起它变化的原因。

里氏替换原则（LSP）：子类型（subtype）必须能够替换掉它们的基类型。

依赖倒置原则（DIP）：

a高层模块不应该依赖于低层模块，两者都应该依赖于抽象。

b抽象不应该依赖于细节，细节应该依赖于抽象。

接口隔离原则（ISP）：不应该强迫客户依赖于它们不要的方法。接口属于客户，不属于它所在的类层次结构。

开闭原则（OCP）：软件实体（类、模块、函数等）应该是可以扩展的，但是不可修改的。

迪米特原则（LoD）：也叫最少知识原则，即一个软件是他应当尽可能少地于其他实体发生相互作用，模块之间的交互要少。

7.3   编码规范

7.3.1   模块命名

       每一个模块分一个包，包名以包名的英文单词命名。小模块依次放在所属的大模块下面，也是以模块的英文单词来命名。

7.3.2   类命名

数据访问类，用驼峰式命名法，首字母大写，以业务名称开头，Repository结尾，例如UserRepository.cs。

业务逻辑类，用驼峰式命名法，首字母大写，以业务名称开头，Service结尾，例如UserService.cs。

业务控制类，用驼峰式命名法，首字母大写，以业务名称开头，ViewModel结尾，例子如UserViewModel.cs。

7.3.3   变量命名

要以有意义的命名的方式来为变量命名，并且单词首字母小写，以驼峰式命名法。

7.3.4   过程函数命名

本系统的过程或函数都在Sql Server2012中运行，命名规则按驼峰式命名法，写好每一个变量、过程、函数、包的注释。变量以@开头，后接实际名称。

总之一点，不管程序代码中还是数据库的过程或函数，都要以清晰的代码结构和详细的注释，以此为标准。

7.4   代码目录结构