软件架构设计说明书.docx
《软件架构设计说明书.docx》由会员分享，可在线阅读，更多相关《软件架构设计说明书.docx（17页珍藏版）》请在冰豆网上搜索。
软件架构设计说明书
架构设计说明书
版本1.0.0
签署栏
拟制
审核
批准
修订历史
版本
说明
作者
审核
修订日期
1.0
发布
Dick
1.引言
[对于由多个进程构成的复杂系统，系统设计阶段可以分为：
架构设计（构架设计）、组件高层设计、组件详细设计。
对于由单个进程构成的简单系统，系统设计阶段可以分为：
系统概要设计、系统详细设计。
本文档适用于由多个进程构成的复杂系统的构架设计。
]
[架构设计说明书是软件产品设计中最高层次的文档，它描述了系统最高层次上的逻辑结构、物理结构以及各种指南，相关组件（粒度最粗的子系统）的内部设计由组件高层设计提供。
]
[系统：
指待开发产品的软件与硬件整体，其软件部分由各个子系统嵌套组成，子系统之间具有明确的接口；
组件：
指粒度最粗的子系统；
模块：
指组成组件的各层子系统，模块由下一层模块或函数组成；]
[此文档的目的是：
1）描述产品的逻辑结构，定义系统各组件（子系统）之间的接口以及每个组件（子系统）应该实现的功能；
2）定义系统的各个进程以及进程之间的通信方式；
3）描述系统部署，说明用来部署并运行该系统的一种或多种物理网络（硬件）配置。
对于每种配置，应该指出执行该系统的物理节点（计算机、网络设备）配置情况、节点之间的连接方式、采用何种通信协议、网络带宽。
另外还要包括各进程到物理节点的映射；
4）系统的整体性能、安全性、可用性、可扩展性、异常与错误处理等非功能特性设计；
5）定义该产品的各个设计人员应该遵循的设计原则以及设计指南，各个编程人员应该遵循的编码规范。
]
[建议架构设计工程师与组件设计工程师共同完成此文档。
]
[架构设计说明书的引言应提供整个文档的概述。
它应包括此文档的目的、范围、定义、首字母缩写词、缩略语、参考资料和概述。
]
目的
[简要描述体系结构文档的目的。
]
范围
[简要说明此文档的范围：
它的相关项目以及受到此文档影响的任何其它事物]
预期的读者和阅读建议
[说明此文档的阅读对象，简要说明此文档中其它章节包含的内容与文档组织方式，对于不同读者的阅读方式建议。
如：
目标读者是系统最终用户、系统分析员、项目经理、产品经理、市场人员等。
此文档的第2章描述…..]
本项目的组织架构和参与人员如下：
A．项目负责人：
参与开发策划，负责批准项目开发计划书；
安排项目组成人员
从技术和业务上总体把握；
确定项目进度及检验标准
了解开发中存在问题，并及时制定相应对策。
B．技术总协调：
负责制订软件标准。
负责支撑软件的维护。
评估将在其中部署项目最终产品的目标组织的情况。
协调目标组织的建模工作。
在必要时对业务工程工作进行讨论和协调。
对目标组织中所建议的任何变更进行成本效益分析。
C．系统分析、设计：
负责获取用户最终需求，概括系统的功能和界定系统来领导和协调需求获取及用例建模，编写《XXX新版本软件详细设计》，制订命名规范。
软件构架设计，划分子模块并详细描述各模块功能、要求,和测试要点。
对软件架构中重要的类做详细说明，描述其属性、方法、和相互之间的关系。
数据库设计，包括定义表、索引、视图、约束条件、触发器、存储过程等。
D．软件开发：
严格按照软件详细设计说明，负责自己开发的模块的资料、软件的备份及保管工作。
在软件开发中如发现系统分析设计时漏洞提出异议，提交问题报告至项目负责人。
对各自编写的内容相互交换作单元测试。
负责《用户使用手册》的编写。
E．文档编写：
负责编写软件《详细设计说明书》、《数据库设计说明书》、《测试方案文档》。
F．软件测试：
负责对各模块的集成测试，和软件的整体评估测试，在测试完后负责编写《测试报告》。
术语、首字母缩写
序号
缩写
英文说明
中文说明
1
ACC
AFCClearingCenter
AFC清算管理中心
2
ACL
AccessControlList
访问控制列表
3
ACPI
AdvancedConfigurationandPowerInterface
先进的配置和电源接口
4
AFC
AutomaticFareCollection
自动售检票
5
AGM
AutomaticGateMachine
自动检票机
6
ALDT
AdministrativeandLogisticsDownTime
行政和后勤响应时间
7
ALU
ArithmeticLogicUnit
算术逻辑部件
8
ASA
AdaptiveSecurityAlgorithm
适应的安全算法
9
AVM
AddValueMachine
自动充值机
10
BCD
BinaryCodeDecimal
BCD码指每位十进制数用4位二进制数编码表示的方法
11
BIOS
BasicInput-OutputSystem
微机的基本输入输出系统
12
MAC
MunicipleAdministration&CommunicationCardCo.
市政交通一卡通
13
BOM
BookingOfficeMachine
半自动售票机
14
CPU
CentralProcessingUnit
中央处理器
15
CRC
CyclicRedundancyCheck
循环冗余校验
16
DAT
DigitalAudioTape
数字音频磁带
17
DB
Database
数据库
18
DBA
DatabaseAdministrator
数据库管理员
19
DDL
DataDefinitionLanguage
数据定义语言
20
DDS
DigitalDataStorage
数字数据存储
21
DES
DataEncryptionStandard
数据加密标准
22
DefaultGateway
DefaultGateway
默认网关
23
DMZ
De-militarisedzone
非军事区
24
DoS
DenialofService
拒绝服务
25
DRP
DynamicRoutingProtocol
动态路由协议
26
DSCP
DifferentiatedServicesCodePoint
区分服务代码
27
E/S
Encoder/SorterMachine
车票编码分拣机
28
EB
EmergencyButton
紧急按钮
29
ECC
ErrorCheckingandCorrecting
错误检查校正
30
ECU
EquipmentControlUnit
设备的主要控制单元
31
EEPROM
ElectricallyErasableProgrammableRead-OnlyMemory
电可擦除只读内存
32
EMC
ElectromagneticCampatibility
电磁兼容性
33
EnG
EntryGate
进站自动检票机
34
ExG
ExitGate
出站自动检票机
35
Fail-Over
Fail-Over
容错
36
FC-AL
FibreChannelArbitratedLoop
光纤通道仲裁环
37
FCSW
FiberChannelSwitch
光纤通道交换机
38
FDD
FloppyDisk
软盘
39
GUI
GraphicalUserInterface
图形用户接口
40
H/W
Hardware
硬件
41
HA
HighAvailability
高可用性
42
HD
HardDisk
硬盘
43
HDD
HardDiskDrive
硬盘驱动器
44
HotStandbyUnit
HotStandbyUnit
热备份单元
45
I/O
Input/Output
输入/输出
46
ID
Identification
身份
47
IDE
IntegratedDriveElectronics
IDE接口
48
ISA
IndustryStandardArchitecture
工业标准结构总线
49
Kbps
Kilo（thousand）bitspersecond
千比特/秒（速率）
50
KMS
KeyManagementSystem
密钥管理系统
51
LAN
LocalAreaNetwork
局域网
52
LCD
LiquidCrystalDisplay
液晶显示器
53
LC
LineCenter
线路中央计算机系统
54
LCS
LineComputerSystem
线路计算机系统
55
LED
LowEmittingDiode
发光二极管
56
LTO
LinearTapeOpen
线性磁带开放协议
57
MAC
MessageAuthenticationCode
消息认证码
58
MAK
MemoryAccessKey
内存存取密钥
59
Mbps
Mega（Million）bitspersecond
兆比特/秒（速率）
60
MCBF
Mean-CyclesBetweenFailure
平均无故障时间
61
MCU
MainControlUnit
主控单元
62
MHz
MegaHertz
兆赫兹（频率）
63
MTBF
Mean-TimeBetweenFailure
平均无故障时间
64
MTTR
MeanTimeToRepair
平均故障恢复维修时间
65
N/W
Network
网络
66
NIC
NetworkInterfaceCard
网络接口卡
67
NMS
NetworkManagementSystem
网络管理系统
68
NTP
NetworkTimeProtocol
网络时间协议
69
OA
OfficeAutomation
办公自动化
70
OT
TotalOperatingTime
总运营时间
71
PCI
ProtocolControlInformation
一种局部总线
72
PCI-X
PeripheralComponentInterconnectExtended
扩展的PCI
73
Peer
Peer
端
74
QA
Quality–Assurance
质量保证
75
RAID
RandomArrayofInexpensiveDisks
磁盘阵列
76
RDBMS
DatabaseManagementSystem
数据库管理系统
77
RF
RadioFrequency
射频
78
RMON
RemoteMonitoring
远程监控
79
RSE
RoutingSwitchingEngine
路由交换引擎
80
S/W
Software
软件
81
SLE
StationLevelEquipment
车站现场设备
82
SAM
SecureAccessModule
安全存取模块
83
SAN
storageareanetwork
存储网络
84
SNMP
SimpleNetworkManagementProtocol
简单网络管理协议
85
SC
StationComputersystem
车站计算机系统
86
SCSI
SmallComputerSystemInterface
小型计算机接口
87
ST
TotalStandbyTime
总待机时间
88
TCM
TicketCheckingMachine
自动查询机
89
TCP/IP
TransmissionControlProtocol/InternetProtocol
传输控制协议/网际协议
90
TFT-LCD
ThinFilmTransistor-LiquidCrystalDisplay
薄膜晶体管液晶显示器
91
Tom
TransactionsPerMinute
每分钟内系统处理的交易个数
92
TVM
TicketVendingMachine
自动售票机
93
UPS
Un-interruptiblePowerSupply
不间断电源
94
USB
UniversalSerialBus
通用串行总线
95
VLAN
VirtualLocalAreaNetwork
虚拟局域网
96
VRRP
VirtualRouterRedundancyProtocol（IETF）
虚拟路由器冗余协议
97
10/100
Base-FX
10/100Base-FX
10/100Base－FX标准
98
Usecaseview
Usecaseview
99
Implementationview
Implementationview
100
Activityview
Activityview
101
Classview
Classview
102
UML
UnifiedModelingLanguage
参考资料
此软件架构文档引用文件如下：
《计算机软件开发规范》GB8566-88
《计算机软件产品开发文件编制指南》GB/T8567-2003
《计算机软件需求说明编制指南》GB9385-88
《计算机软件测试文件编写规范》GB9386-88
《计算机软件可靠性及可维护性管理》GB/T14394-1993
《计算机软件质量保证计划规范》GB/T12504-1990
《计算机软件配置管理计划规范》GB/T12505-1990
《计算机软件测试文件编制规范》GB/T9386-1988
《软件维护指南》GB/T14079-1993
《软件文档管理指南》GB/T16680-1996
《软件质量评价》ISO/IEC14589
2.系统逻辑结构
[本章描述系统的总体逻辑结构，包括组件（子系统）的划分与依赖关系定义、组件之间的接口定义、系统功能在组件之间的实现流程、组件功能定义]
总体结构
[本节定义系统的总体逻辑结构，定义组件划分以及组件之间的依赖关系。
为了能够使系统具有较好的可重用性以及能够控制对第三方系统的依赖性（如第三方系统软件、中间件等），在结构设计时可以采用分层方法。
系统可以分为专用应用层、通用应用层、中间件层、系统软件层。
为了统一与便于理解，当用图形化表示组件（子系统）、组件之间的依赖关系时，要求采用UML的符号与表示方法。
]
系统功能实现
[针对《产品需求说明书》中定义的功能特性，在此描述它们在相关组件（子系统）之间是如何实现的，系统功能实现描述是定义组件之间的接口以及组件功能的基础，选择若干代表性的用例来说明。
在此要求用两种方式来描述功能实现：
1）UML的顺序图；
2）对顺序图的文字解释
需要注意的是UML顺序图中的生命线代表组件（子系统）。
《产品需求说明书》中各个功能特性的数据流图或顺序图描述是此处设计的基础。
]
组件接口
[本节明确定义：
各个组件之间的接口（系统内部接口）。
如果组件之间采用通信协议作为接口，则需要详细定义应用层协议以及低层通信方式。
如果采用API作为接口，则需要详细定义API接口函数（包括参数定义）。
]
[系统的所有对外接口在《产品需求说明书》中明确定义。
]
组件功能
[本节明确定义各个组件的软件功能，其依据是《产品需求说明书》以及系统功能实现描述。
本节通常按照组件进行组织。
2.4.1组件1
]
数据库关系模型
[本节在逻辑层面上定义系统所包含的主体数据库模型，以及主要的实体关系，通常以E-R图形式来表现。
]
3.系统物理实现
[本章明确定义各个组件的可执行程序名与库名、可执行程序与库的运行环境。
可以采用如下表的方式来描述（一个组件包含一个可执行程序与多个库）。
这是下一步设计与开发的分工依据。
组件名
可执行程序/库名
运行环境
组件1
定义系统包含的所有进程、每个进程包含的可执行程序名与库名、可执行程序与库的运行环境。
。
可以采用如下表的方式来描述（一个进程包含一个可执行程序与多个库，与组件不同的是，进程间可以包含相同的库）。
这是实际环境运行反映，也是系统部署的依据。
进程名
进程运行方式
可执行程序/库名
运行环境
进程1
[说明进程是以控制台、Windows服务程序、Unix后台进程或者其它方式运行]
]
4.系统部署
[本章描述系统部署，说明用来部署并运行该系统的一种或多种物理网络（硬件）配置。
对于每种配置，应该指出执行该系统的物理节点（计算机、网络设备）配置情况（包括硬件、操作系统、支撑软件）、节点之间的连接方式、采用何种通信协议、网络带宽。
另外还要包括各进程到物理节点的映射。
]
5.系统其它考虑
[本章描述系统的整体性能、安全性、可用性、可扩展性、异常与错误处理等非功能特性设计。
]
系统可扩展性
[描述系统可扩展性设计与实现方案。
需要对性能、功能、网管/审计、报表的可扩展性进行描述。
]
系统可靠性
[描述系统可靠性设计与实现方案，包括系统的可靠性设计，有硬件可用性与软件可用性两个方面。
]
系统性能
[描述系统性能设计与实现方案。
]
系统维护性
[描述系统可维护性设计与实现方案。
]
系统安全
[描述系统安全性设计与实现方案。
系统安全性包括网络安全、系统安全、数据安全、交易安全等。
]
系统异常处理
[给出系统中的错误类别，以及各类错误的处理要求。
同时对系统中的各个组件的错误异常的处理提出具体的要求。
]
6.约束
[本章给出设计人员与编码人员必须遵循的设计要求与编码要求，包括各种代码的命名、配置文件、日志文件格式定义。
可以通过引用的方式来写本章节。
研开中心将会提供几种主要语言的编码规范，在此可以引用。
]
设计指南
[规定在组件设计中的各种约定与标准。
]
编码规范
[规定在系统实现中必须遵循的编码规定，包括编码风格、变量与函数命名、注释等。
]
配置文件约定
[规定系统的所有配置文件命名方式与格式。
]
日志文件约定
[规定系统的所有日志文件命名方式与格式。
]
运行目录约定
[规定系统的运行目录结构。
]
7.需求矩阵
序号
需求来源
Requirement
设计
Priority
1
2
3
升级会员 