标 题:China Advanced Construction Materials Group信息技术管理制度 主 题: 软件开发管理制度 文档编号: 版本说明:
版本号 V1.0 V1.0
版本日期 作者 备注 创建 审批 China Advanced Construction Materials Group
软件开发管理制度
第一节 总 则
第一条
为规范自有软件研发以及外包软件的管理工作,特制定本制度。本制度适用于公司总公司软件研发与管理,分公司参照执行。
第二条 第三条
本制度中软件开发指新系统开发和现有系统重大改造。
本制度中自行开发是指主要依赖公司自身的管理、业务和技术力量进行系统设计、软件开发、集成和相关的技术支持工作,一般仅向外购置有关的硬件设备和支撑软件平台;合作开发是公司与专业IT公司(合作商)共同协作完成IT应用的项目实施和技术支持工作,一般形式是公司负责提供业务框架,合作商提供技术框架,双方组成开发团队进行项目实施,IT系统的日常支持由IT技术中心和合作商共同承担,IT技术中心负责内部(一级)支持,合作商负责外部(二级)支持;外包开发是指将IT应用项目的设计、开发、集成、培训等任务承包给某家专业公司(可以是专业的IT公司或咨询公司等),由该公司(承包商)负责应用项目的实施。
第四条
软件开发遵循项目管理和软件工程的基本原则。项目管理涉及立项管理、项目计划和监控、配置管理、合作开发管理和结项管理。软件工程涉及需求管理、系统设计、系统实现、系统测试、用户接受测试、试运行、系统验收、系统上线和数据迁移。
第五条
除特别指定,本制度中项目组包括业务组(或需求提出组)、IT组(可能包括网络管理员和合作开发商)。
第二节 立项管理
第六条
提出开发需求的信息技术部门参与公司层面立项,进行立项的技术可行性分析,编写《立项分析报告》(附件一),开展前期筹备工作。《立项分析报告》应明确项目的范围和边界。
第七条
应用系统主要使用部门将《立项分析报告》上交公司总裁室进行立项审批,以保证系统项目与公司整体策略相一致。
第八条
第九条
第十条
第十一条第十二条第十三条第十四条第十五条第十六条《立项分析报告》得到批准后,成立项目组(如果是外包开发,则成立外包商项目组;如果是合作开发,则与外包商共同成立合作开发项目组,以下统称“项目组”),项目组应包括业务组(由公司相关业务部门组成)和IT组(自行开发为办公室网络管理员;外包开发为外包商成员;合作开发为网络管理员和外包商成员)。公司委派一名员工负责监督项目的进度,进行项目管理工作,确保开发能及时完成并能满足业务需要。项目组人员的选择应满足项目对业务及技术要求,项目组人员应有足够的业务和IT技术方面的专业知识来胜任项目各方面的工作。
第三节 需求分析
立项后业务组对用户需求进行汇总整理,出具《业务需求说明书》(附件二),并确保《业务需求说明书》中包含了所有的业务需求。经系统使用部门审批确认,作为业务需求基线。
IT组在获得《业务需求说明书》后,提出技术需求和解决方案,并对系统进行定义,出具《系统需求规格说明书》(附件三)。《系统需求规格说明书》需详细列出业务对系统的要求(界面、输入、输出、管理功能、安全需求、运作模式、关键指标(KPI)等)。《系统需求规格说明书》需要由业务组提交给相关业务流程负责人确认。
对于合作开发的项目,当业务需求发生变更时,业务组应提交《需求变更申请》(附件四),IT组组长审批后交给合作开发商实施。
项目组应对需求变更影响到的文档及时更新。
第四节 项目计划和监控
软件开发采用项目形式进行管理。项目经理负责整个项目的计划、组织、领导和控制。
需求分析过程中,项目经理组织制定详细的《项目计划书》(附件五),包括具体任务描述和项目进度表等。
在项目的各个阶段,业务组组长和IT组组长需配合项目经理制定阶段性项目计划。业务组组长和IT组组长需配合项目经理对项目计划执行情况进行监控,确保项目按计划完成。
项目计划需要变更时,项目经理填写《项目计划变更说明》(附件六),并提
第十七条
第十八条 第十九条
第二十条
第二十一条第二十二条第二十三条第二十四条第二十五条第二十六条第二十七条第二十八条交公司主管领导审批,通过审批后,交给业务组组长和IT组组长执行。
第五节 系统设计
系统设计应分为概要设计和详细设计,系统设计要遵循完备性、一致性、扩展性、可靠性、安全性、可维护性等原则。
在系统设计阶段中,用户应充分参与,确保系统设计能满足系统需求。 项目组进行详细设计,出具《设计说明书》(附件七)和《单元测试用例》(附件八)。《设计说明书》中需要定义系统输入输出说明和接口设计说明。公司主管领导组织相关人员对概要设计进行评审,出具《设计评审报告》(附件九)。业务组组长和IT组组长应参加此评审并对评审意见签字确认。
设计评审均以《业务需求说明书》和《系统需求规格说明书》为依据,确保系统设计满足全部需求。
对已确认通过的系统设计进行修改需获得管理部门、业务组组长和IT组组
长的审批后方可进行。
对系统设计的修改的文档须由文档管理人员进行归档管理。
第六节 系统实现
项目组根据《设计说明书》制定系统实现计划,并提交项目经理对计划可行
性进行审批。
系统实现包括程序编码、单元测试和集成测试。
项目组保证开发、测试和生产环境独立,为各环境建立访问权限控制机制,
并明确项目成员的职责分工。对开发环境、测试环境与生产环境在物理或逻辑方面应该做到隔离;如果环境的分隔是通过逻辑形式实现的,应定期检查网络设置。项目组对已授权访问生产环境的人员进行详细记录,并对该记录进行定期检查,确保只有经授权的人员才能访问到生产环境。
项目组进行单元测试和集成测试,测试人员签字确认测试结果。
第七节 系统测试和用户测试
项目组制定《系统/用户测试计划》(附件十),并提交项目经理对计划可行
性进行审批。
《系统/用户测试计划》必须定义测试标准,并明确各种测试的测试步骤和
需要的系统设置要求。
第二十九条 项目组向数据拥有部门申请获取测试用业务数据的使用权,对获取的数据进
行严格的访问控制,确保只有相关项目人员才能访问及使用。
第三十条
项目组负责测试数据准备,测试用数据要足够模拟生产环境中的实际数据。对已评定为敏感信息的数据进行敏感性处理和保护。
第三十一条 IT组或合作开发商建立测试环境进行系统测试。在系统测试中对新系统内部
第三十二条 第三十三条
第三十四条 第三十五条 第三十六条 第三十七条 第三十八条 第三十九条 各模块之间的接口和与其他系统的接口进行充分测试。出具《系统测试报告》(附件十一),测试人员签字确认测试结果。
系统测试通过后,IT组配合业务组建立用户测试环境,业务组根据用户测试
用例进行用户测试,出具《用户测试报告》(附件十一),业务组组长和IT组组长应在用户测试报告中签字确认。
项目组完成系统帮助文档(其中包括《用户操作手册》和《安装维护手
册》)。凡涉及应用系统的变更,应对系统帮助文档及时更新。
第八节 试运行
系统主要使用部门根据项目规模及影响决定试运行策略。
项目组制定《试运行计划》(附件十二),并制定试运行验收指标,上报公司
主管领导审批。《试运行计划》中应包含问题应对机制,明确问题沟通渠道和职责分工。
项目组联合试运行单位进行相关系统部署工作,准备培训资料,对相关用户
和信息技术人员进行培训。用户培训的完成度应为实施后评估的指标之一。
项目组根据《试运行计划》进行系统转换和数据迁移。系统转换前,检查系
统环境,确保运行环境能满足新应用系统的需要。系统转换时必须详细记录原系统中的重要参数、设置等系统信息,并填写试运行报告相关内容。系统参数、设置的转换工作作为系统上线的验收的评估指标之一。
数据迁移前,应制定详细的《数据迁移计划》(附件十三),《数据迁移计
划》中应包含迁移方案、测试方案、数据定义,新旧数据对照表、迁移时间、回退计划等信息。数据迁移计划需经项目经理和主管领导签字审批。
数据迁移后,项目组对数据迁移的完整性和准确性作出检查,出具《数据迁
移报告》(附件十四),其中包括数据来源、转换前状态、转换后状态,数据迁移负责人、对完整性检查情况、对准确性检查情况等内容。各相关部门验收转换结果后在该报告上签字确认。
第四十条 系统转换和数据迁移由试运行单位业务部门和公司主管领导共同监督并进行验收。
第四十一条 系统转换和数据迁移验收通过后,正式启动试运行。在试运行过程中,试运
行单位办公室把系统运行情况(系统资源使用,反应速度等)记录到试运行报告中。必要时,项目组应根据系统运行情况对应用系统进行优化。
第四十二条 试运行达到试运行计划规定的终止条件时,项目组编写《试运行报告》(附
第四十三条 第四十四条 第四十五条 第四十六条 第四十七条 第四十八条 第四十九条 件十五)。此报告应由项目组和试运行单位签字确认,并提交公司主管领导审阅。公司主管领导审阅试运行结果,决定试运行结束或延期。
第九节 系统验收
系统主要使用部门及信息技术部门联合组成独立系统验收小组,也可授权原
项目组作为验收小组。验收小组从功能需求及技术需求层面对系统进行综合评估。
验收小组应根据验收情况整理形成《系统验收报告》(附件十六)提交系统
主要使用部门和信息技术部门审阅。
系统主要使用部门和信息技术部门负责人根据系统测试、试运行情况签署验
收意见。
第十节 系统上线
系统上线应遵循稳妥、可控、安全的原则。 通常情况下,系统上线包含数据迁移工作。
项目组制定《系统上线计划》(附件十七),上报公司主管领导审批。在上线
计划得到批准后才能开始部署上线工作。
《系统上线计划》内容应包括但不限于:
1、部署方式和资源分配(包括人力资源及服务器资源); 2、上线工作时间表;
3、上线操作步骤以及问题处理步骤;
4、项目阶段性里程碑和成果汇报(项目执行状态的审阅、进度安排等); 5、数据迁移的需求和实施计划; 6、完整可行的应急预案和“回退”计划;
7、用户培训计划(包括:培训计划、培训手册、培训考核等);
8、总公司下发的系统标准参数配置。
第五十条
上线单位在上线初期需加强日常运行状态监控,出现问题时应及时处理,对重大问题应启动紧急预案。
第五十一条 在完成上线后要填写《系统验收评估报告》(附件十八),上报总公司项目组
第五十二条 第五十三条
第五十四条 第五十五条 第五十六条 第五十七条 第五十八条 第五十九条 第六十条
汇总整理。《系统验收评估报告》内容包括:数据准确性、系统性能及稳定性、接口问题、权限问题、业务操作影响度、问题处理情况、备份、批处理等。
上线单位管理层要对《系统验收评估报告》进行审批签字。
公司主管领导批准结项后,业务组和IT组将整理的文档提交各自部门统一
管理。
第十一节 合作开发管理
合作开发商的选择应遵循公司相关规定,合作商资质认定参见第三方管理制
度。
合作开发商必须遵循公司《软件开发管理制度》。
项目经理同合作开发商明确规定项目变更的范围和处理方式,重点关注需求
和设计变更。
项目经理负责监控合作开发商的项目管理及软件开发活动。合作开发商应按
计划定期向项目经理报告进展状态,并提交阶段性成果文档。发生重大问题时,合作开发商需及时向项目经理汇报。
IT组组长派专人监控合作开发商的质量保证过程。 项目组同合作开发商商定验收的标准和方法。 以上各要求需要在开发合同中明确。
第十二节 外包开发管理
第六十一条 立项申请得到公司主管领导的审批后,选定开发商,签订外包开发合同。 第六十二条 项目经理负责监控外包开发商的项目管理及软件开发活动。外包开发商应按
计划定期向项目经理报告进展状态,并提交阶段性成果文档。发生重大问题时,外包开发商需及时向项目经理汇报。
第六十三条 项目经理监控外包开发商的质量保证过程。 第六十四条 第六十五条
第六十六条 第六十七条
项目组同外包开发商商定验收的标准和方法。 以上各要求需要在开发合同中明确。 第十三节 附则
本制度由公司总部信息技术部负责解释和修订。 本制度自发布之日起开始执行。 附件一 立项分析报告
文件状态: [√] 草稿 [ ] 正式发布 [ ] 正在修改 版 本 历 史 版本/状态 1. 项目介绍 1.1. 项目目的
作者 参与者 起止日期 备注 文件标识: ProjectName- 当前版本: X.Y 作 者: 完成日期: Year-Month-Day 提示:用简练的语言说明本项目“是什么”,“实现什么目的”。描述简练且清晰。 1.2. 项目背景
提示:阐述项目背景,重点说明“为什么”会产生本项目。 (1)公司的短期、长期发展战略; (2)业务需求及发展趋势; (3)技术状况及发展趋势; (4)特殊的业务需求等。 1.3. 项目范围
提示:根据对现有需求的了解来确定项目基本范围,说明本系统“应当包含的内容”和“不包含的内容”。 2. 项目计划 2.1. 项目团队
提示:说明项目团队的角色、知识技能要求、建议人选、人数、工作时间,如下表所示。
角色 项目经理 需求开发人员 系统设计人员 知识技能要求 建议人选、人数 工作时间 编程人员 测试人员 质量保证人员 配置管理人员 服务与维护人员 …… 2.2. 成本估计 内容 人力资源 软硬件资源 差旅费 会议费 接待费 … 2.3. 进度表 成本(人民币) 备注 提示:制定项目开发的进度表(建议给出项目里程碑计划)。例如: 编号 里程碑名称 预计结束时间 备注 3. 总结 需求调研完成 项目计划完成 需求分析完成 概要设计完成 详细设计完成 实现完成 集成测试完成 系统测试完成 用户验收测试完成 试运行结束 项目验收 提示:给出清晰的建议结论,便于上级领导决策。
附件二 业务需求说明书
文件状态: [√] 草稿 [ ] 正式发布 [ ] 正在修改 版 本 历 史 版本/状态 1概述
1.1 业务调研人员名单 【可选】 序号 职能部门 姓名 主管 联系电话 备注 作者 参与者 起止日期 备注 文件标识: ProjectName- 当前版本: X.Y 作 者: 完成日期: Year-Month-Day 1.2业务范围 此处描写总体业务的概要分类并。 1.3 业务目标
从高层或商务利益的角度提出本业务系统的期望目标,以及评价标准。 1.4 相关文档
说明:列出本文档的所有参考文献(可以是非正式出版物),包括现有规范、标准、批文、引用到的文件、资料等。 1.5 业务词汇表
说明:列出本文档的所引用的专属领域词汇、术语等,以便于业务需求的提供者和接收者是建立在一致的业务理解基础之上的。 2 组织结构及业务
2.1 业务相关组织结构、人员组织结构
说明:如果客户岗位设置复杂可分别设置,业务组织结构和人员组织结构
2.2 组织机构描述 2.3 角色职责
说明:将业务涉及的具体人员进行一定程度的分类和抽象,描述该抽象角色的操作职责。 2.4 管理综述 【可选】
说明:主要描述该业务的管理特点和管理模式。例如:
典型按库存生产模式。生产计划以年度销售计划为指导,并综合考虑设备能力、生产天数、库存、历史销售记录。采购计划的制订以生产计划为依据。 2.5 现有业务流程清单 【可选】
说明:现有业务流程需要考虑,很多新的业务是在已有业务流程基础上进行重组的。
流程编号 3 业务流程及业务处理描述 说明:针对每一项具体的目标业务,描述具体的业务流程,以及相关业务的具体描述。 3.1 具体业务流程(系统名称+编号)
对于具体业务流程的命名有规范,对具体流程进行编号,便于形成需求矩阵,同时形成需求的管理和跟踪。 3.1.1业务流程 3.1.2业务描述
说明:描述具体的业务流程。 3.1.3相关业务对象
说明:业务对象:业务流程中涉及的单据、报表等。
业务对象 3.1.4业务规则及关键算法 说明:描述业务环节关键算法体系。 4 假定和约束
说明:列出进行本软件开发工作的假定和约束,例如开发期限等。 4.1 运行环境约束
使用部门 对应电子档案编号 流程名称 责任部门 辅助部门 4.2 设计约束 【可选】
说明:开发过程中必须使用的软件语言、软件进程需求、主要开发工具、核心技术、第三方产品等。 4.3 产品应当遵循的标准或规范 【可选】
说明:阐述本产品应当遵循什么标准、规范或业务规则,违反标准、规范或业务规则的产品通常不太可能被接受。 5 其他
5.1 目前核心问题和困难 5.2 业务对项目实施的需求和期望 【可选】 5.3 其他未尽事宜
附件三 系统需求规格说明书
文件状态: [√] 草稿 [ ] 正式发布 [ ] 正在修改 版 本 历 史 版本/状态 1 引言 1.1 目的
例如:规定系统的边界和目标,描述系统的功能性需求和非功能性需求。 1.2读者对象及阅读建议
说明:指明本文档面向的读者群,及相应的阅读意见。 1.3文档范围 【可选】
说明:对本文的范围做阐述,本文档改动时,受到影响的范围,例如,本文引用到的用例模型,系统原型,系统测试用例等文档。 1.4 参考文档
说明:列出本文档的所有参考文献(可以是非正式出版物),包括计划任务书、合同、批文、引用到的文件、资料及软件开发标准等。 1.5 术语与缩写解释
说明:列出本文件中用到的专门术语的定义和缩写词的原词组,并给予解释,以便于所有读者达成共识。 2 综合描述 2.1 系统背景 【可选】
说明:介绍系统的预期效果、历史原因。
作者 参与者 起止日期 备注 文件标识: ProjectName- 当前版本: X.Y 作 者: 完成日期: Year-Month-Day 2.2 问题说明 【可选】
提供一段说明,总结此项目需要解决的问题。可以采用以下格式:
问题是 影响 问题的后果 成功的解决方案 2.3系统范围 说明:阐述本项目“适用的业务领域”和“不适用的业务领域”,本产品“应当包含的内容”和“不包含的内容”。说清楚系统范围的好处是:(1)有助于判断什么是需求,什么不是需求;(2)可以将开发精力集中在产品范围之内;(3)有助于控制需求的变更。 完整而准确的定义本产品的干系人; 明确本产品所影响到的部门和业务;
用图表或者文字描述产品的范围,概要的定义产品的功能。 2.4 干系人与用户说明 【可选】 2.4.1用户环境 【可选】
详细说明目标用户的工作环境。以下是几项建议: 该任务由多少人来完成?是否总在变化?
一个任务周期需要多长时间?执行每项活动要用多长时间?是否总在变化? 是否有特殊的环境约束:移动、户外、乘机旅行等? 目前使用的是哪些系统平台?以后会使用哪些平台?
还在使用哪些应用程序?您的应用程序是否需要和这些应用程序集成? 在此处可以从业务模型中摘录一些内容来概述所涉及的任务和角色等等。 2.4.2 干系人简档 【可选】
通过在下表中填写各干系人的相关信息来说明系统中的各个干系人,详尽的简档应包括各种干系人在以下方面的信息: 代表 [谁是此产品的干系人代表?(如在他处已作记录,则此处为可选。)此处只需填写姓名。] [对问题进行说明] [问题影响的干系人] [该问题会导致什么后果] [应列出成功解决方案的一些主要优点] 说明 类型 [对干系人类型的简要说明。] [介绍干系人的技能特长、技术背景和熟练程度(即权威用户、业务用户、专家用户、初级用户等)] 职责 [列出干系人对所开发的系统负有的关键职责,即他们作为干系人的利益。] 使用频率 意见/问题
[该干系人使用系统的频率] [在此处列出会阻碍成功的问题以及任何其他相关信息。] 2.4.3关键的干系人/用户需要
列出干系人认为现有解决方案存在的关键问题。对于列出的每个问题,需澄清以下要点: • 为什么会出现这一问题? • 目前如何解决该问题? • 干系人需要什么样的解决方案?
务必要了解干系人或用户对解决各个问题的相对重视程度。分级和累积投票方法表明,必须解决的问题与干系人或用户希望解决的问题大有不同。 2.5 目标业务模型 【可选】
说明:新系统业务模型描述,如有相应业务模型材料了,可作为需求规格说明书的输入参考资料。 2.6 功能摘要
总结该产品将提供的主要优点和特性,而不必涉及每个功能的细节。对功能加以组织,使客户或初次阅读该文档的其他人能够理解此功能列表。 2.7 功能清单及重要程度说明
说明:功能名称、功能描述、重要程度。
重要程度,以ABC三类来表示:A:核心功能;B:辅助功能;C:外围功能; 级别,按照继承关系分为:一级,二级,三级; 编号 级别 重要程度 功能名称 功能描述 备注 2.8 功能与业务对照关系表 说明:业务组为主编写业务需求,业务需求提交至信息技术组后,由信息技术组建立目标
系统业务模型并与业务组进行确认(本操作可选,也可由信息技术组与开发商合作建立),目标业务模型作为系统需求的输入,由信息技术组与开发商合作撰写和评审《系统需求规格书明书》。 业务需求 2.9 假定和约束 说明:列出进行本软件开发工作的假定和约束,例如:开发语言、开发期限等。 格式限制说明:本项将指定由现有的标准或规则派生的要求。例如: 报表格式;数据命名;财务处理;审计追踪,等等。
硬件限制说明:本项包括在各种硬件约束下运行的软件要求,例如,应该包括: 硬件配置的特点(接口数,指令系统等);内存储器和辅助存储器的容量。 2.9.1运行环境约束
说明:硬件设备、支持软件、接口、控制等方面的约束 名称 2.9.2设计约束 【可选】
说明:开发过程中必须使用的软件语言、软件进程需求、主要开发工具、核心技术、第三方产品等。
2.9.3产品应当遵循的标准或规范
说明:阐述本产品应当遵循什么标准、规范或业务规则,违反标准、规范或业务规则的产品通常不太可能被接受。 3 具体需求 3.1功能需求 3.1.1具体功能 3.1.1.1内容
说明:对于每一类功能或者有时对于每一个功能,需要具体描述其输入、加工和输出的需求。
详细要求 目标系统业务活动(可选) 功能名称 3.2 非功能需求 3.2.1 外部接口 3.2.1.1用户接口
说明:提供用户使用软件产品时的接口需求。例如,如果系统的用户通过显示终端进行操作,就必须指定如下要求:
a 对屏幕格式的要求
说明:对界面上的各对象、类型、宽度、取值范围、数据来源、能否为空等属性进行描述。
b 报表或菜单的页面打印格式和内容 c 输入输出的需求
说明:解释各输入输出数据类型,并逐项说明其媒体、格式、数值范围、精度等。对软件的数据输出及必须标明的控制输出量进行解释并举例,包括对硬拷贝报告(正常结果输出、状态输出及异常输出)以及图形或显示报告的描述。 d 程序功能键的可用性 说明:快捷键定义等。 3.2.1.2 硬件接口 【可选】
说明:要指出软件产品和系统硬部件之间每一个接口的逻辑特点。还可能包括如下事宜:支撑什么样的设备,如何支撑这些设备,有何约定。 3.2.1.3软件接口 【可选】
说明:在此要指定需使用的其他软件产品(例如,数据管理系统、操作系统或数学软件包),以及同其他应用系统之间的接口。对每一个所需的软件产品,要提供如下内容:名字、助记符、规格说明号、版本号、来源。
对于每一个接口,这部分应说明与软件产品相关的接口软件的目的,并根据信息的内容和格式定义接口,但不必详细描述任何已有完整文件的接口,只要引用定义该接口的文件即可。 【接口定义】
下表是对一些接口的具体描述:
接口名称 接口描述 填写接口完成的任务 接口类型 源系统 目标系统 厂商提供/客户化开发 文件类型 填写是输入接口(inbound)还是输出接口(outbound) 填写接口输入方系统或部件 填写接口输出方系统或部件 填写文件类型;若通过数据库表来交互,请指明数据库及表名 文件数量 峰值数据量 频度 复杂度 批处理 /人工 填写数据处理的频度 填写接口数据的驱动模式是人工(manual)还是自动(automatic),还是都支持 接口类型
【其他系统详细信息】
填写是实时接口还是批量接口等 说明:列出所有与接口交互的外围系统的详细信息。包括输入、输出系统等
系统 系统类型 数据库 软件 架构类型 位置 技术支持 功能支持 数据归属
填写与接口交互的系统名称 填写是接口的数据源系统(source)还是目标系统(object) 填写交互系统使用的数据库及版本 填写交互系统的软件名称 交互系统的架构类型是B/S 还是C/S。 填写该软件在交互软件体系中所出的位置 填写交互系统的开发商和支持商 填写具体的支持商或技术团队 【接口隶属系统的详细信息[可选] 】
系统 模块 数据库 负责人 填写接口隶属系统的名称 隶属于具体的模块名称 隶属系统的数据库及版本 控制报告
【接口配置】
(1)接口基础信息配置
说明:接口基础信息的配置项目,描述配置的方式。 (2)接口运行参数配置
说明:接口运行参数的配置方式和步骤。
【其他配置[可选] 】
说明:外围系统或相关模块的配置。 3.2.1.4通信接口 【可选】
说明:指定各种通信接口。例如,局部网络的协议等等。 3.2.2 其他非功能性需求
说明:下表中的各种需求,可根据实际情况进行选择其中的一种或者几种进行描述,在表的后面是各种需求的详细解释。
名称 静态数值需求 动态数值需求 精度 时间特性要求 可用性 可靠性 可维护性 安全性 可移植性 可扩展性 兼容性 … 3.2.2.1 静态数值需求 说明:支持的终端数;支持并行操作的用户数。 3.2.2.2 动态数值需求
详细要求 说明:欲处理的事务和任务的数量,以及在正常情况下和峰值工作条件下一定时间周期中处理的数据总量。 3.2.2.3 精度
说明:对该软件的输入、输出数据精度的要求,可能包括传输过程中的精度。 3.2.2.4时间特性要求
说明:对于该软件的时间特性要求,如对:
a.响应时间; b.更新处理时间; c.数据的转换和传送时间;
d.解题时间等要求。
3.2.2.5 数据管理要求 【可选】
说明:需要管理的文卷和记录的个数、表和文卷的大小规模,要按可预见的增长对数据及其分量的存储要求做出估算。 3.2.2.6 可用性
指出普通用户和高级用户要高效地执行特定操作所需的培训时间,指出典型任务的可评测任务次数或根据用户已知或喜欢的其他系统确定新系统的可用性需求 性能 3.2.2.7可靠性
指出可用时间百分比 ( xx.xx%)、使用小时数、维护访问权、降级模式操作等。平均故障间隔时间 (MTBF)。平均修复时间 (MTTR)—系统在发生故障后可以暂停运行的时间。指出系统输出要求具备的精密度(分辨率)和精确度(按照某一已知的标准)。 3.2.3文档需求
说明:主要是在线用户手册与帮助系统,也包括其他的文档 3.2.4 第三方产品 【可选】
说明:使用到的第三方产品相关的 使用许可、使用限制、接口标准。 3.3 数据字典
说明:把相关的数据抽取出来统一维护,在其他章节如有类似信息描述,则关联到数据字典的相关部分并加辅助说明,如:引用到的字段等。 4 补充资料 【可选】
4.1待确定的问题列表 【可选】 需求标题1 调查方式 调查人 调查对象 时间、地点 需求信息记录 附件四 需求变更申请
记录号: 项 目: 项目负责人: 申请部门: 类 型: 变更申请人: 申请日期: 变更内容 变更的内容 及其理由 开发项目 说明变更的内容及变更的理由, 如果变更为业务组提出,则业务组填写; 如果变更为为信息技术组提出,则信息技术组填写; 变更的系统及说明变更所涉及的工作产品及其当前版本, 版本 如果变更为业务组提出,则业务组填写; 如果变更为为信息技术组提出,则信息技术组填写; 对业务及其接分析需求变更引起的业务变更、业务接口的变更, 口的影响 业务组填写 业务负责人意见: 同意 不同意 签字: 日期: 变更结果
变更分析 对相关的资源影响 分析需求变更对人员、开发设备和目标设备的影响, 仅信息技术组填写 风险分析 分析需求变更的风险, 仅信息技术组填写 对其他系统或接口分析需求变更引起的系统变更、其他系统或接口的变更, 的影响 仅信息技术组填写 对开发工作量、进估计需求变更对开发工作量和进度的影响,需说明本次变更工作量/度和成本影响 成本是否超过本项目总开发工作量/总成本的1%? 仅信息技术组填写 信息技术部审批意见 信息技术组负责人意见: 同意 不同意 指定验证人员: 签字: 日期: 处经理意见: 同意 不同意 汇报上级 签字: 日期: 上级经理意见: 签字: 日期: 变更结果 变更的系统及版本 说明变更后的工作产品 签字: 日期: 变更验证 验证变更结果 完整性 正确性 是 否 是 否 同意 不同意 附加变更 版本和名称 验证人意见: 签字: 日期:
是 否 是 否 符合要求 不符合要求 附件五 项目计划书
文件状态: [√] 草稿 [ ] 正式发布 [ ] 正在修改 版 本 历 史 版本/状态 1 文档介绍 1.1 文档目的 1.2文档范围 1.3参考文献
提示:
列出本文档的所有参考文献(可以是非正式出版物),格式如下: [标识符] 作者,文献名称,出版单位(或归属单位),日期 例如:
[AAA] 作者,《立项建议书》,机构名称,日期
1.5 术语与缩写解释
缩写、术语 2 项目介绍 2.1项目范围
提示:
(1)用简练的语言说明本项目“是什么”,“说明用途”。 (2)说明本项目“应当包含的内容”和“不包含的内容”。
解 释 作者 参与者 起止日期 备注 文件标识: ProjectName- 当前版本: X.Y 作 者: 完成日期: Year-Month-Day 2.2项目目标
提示:给出“清晰的”、“可实现”、“可验证”的目标。 2.3客户与最终用户介绍
提示:请说明本项目的客户、用户及其相关责任人是谁,描述最终用户的特征。 2.4 约束
提示:
(1)请说明在项目开发过程中应当遵循的标准或规范 (2)请说明相关项目可能对本项目造成的影响。 (3)说明一些假设和依赖。 3 项目过程定义 3.1软件生命周期模型
提示:简要描述、绘制本项目的软件生命周期模型。 3.2项目规范
提示:描述项目需遵循的规范,例如:编码规范。此处可以表现为编码规范的链接。 3.3方法与工具
提示:说明在过程中将采用的方法与工具。例如采用Rational Rose进行面向对象分析与设计,采用Visual SourceSafe进行配置管理,采用Microsoft Office制作文档。
方法与工具 Visual SourceSafe … 4 里程碑计划 序号 里程碑名称 开始日期 结束日期 工作成果 备注 配置管理 用途 5 资源计划 5.1人力资源计划
提示:制定本项目的角色职责表,并为已知的项目成员分配角色(一个人可以兼多个角色)。
角色 职责 人员姓名 工作说明 高层领导 项目经理 需求分析员 系统设计员 程序员 测试员 … 5.2 软硬件资源计划 提示:分析项目开发、测试、运行所需的软硬件资源和关键计算机资源(会影响软件产品的性能的CPU、内存、带宽等内容),主要内容包括:
资源级别(分为“关键”、“普通”两种) 详细配置
获取方式(如“已经存在”、“可以借用”或“需要购买”等)与获取时间 使用说明(如“谁”在“什么”时候使用) 软硬件资源名称 … 6 文档交付列表 序号 交付文档名称 交付日期 备注 关键 关键 普通 级别 详细配置 获取方式与时间 使用说明 7 风险管理计划 提示:以下是各个列标题的解释。
约定在项目中的风险管理方案,例如:风险识别频度、风险跟踪频度等。 风险级别:确定风险的严重性、可能性、风险系数 风险描述:缓解方案或者应急计划。 风险编号 风险级别 风险描述 缓解方案 应急计划 严重性 可能性 (1-5) (%) 风险系数 (严重性*可能性) 8 沟通计划 甲方代表 9 附件 项目进度计划
乙方代表 沟通方式 沟通频率/时间 期望结果 附件六 项目计划变更说明
项目名称 申请日期 项目计划变更申请 申请变更的 《项目计划》 变更的内容 及其理由 评估计划变更将对 项目造成的影响 输入名称,版本,完成日期等信息 变更申请的审批意见 审批意见: 处经理审批 签字,日期 信息技术部负责人审批 审批意见: 签字,日期 审批意见: 业务部门意见 签字,日期 更改项目计划 变更后的 《项目计划》 项目负责人签字 输入名称,版本,完成日期等信息 项目负责人签字 附件七 设计说明书
文件状态: [√] 草稿 文件标识: 当前版本: ProjectName-Module-Design X.Y Year-Month-Day [ ] 正式发布 作 者: [ ] 正在修改 完成日期: 版 本 历 史 版本/状态 作者 参与者 起止日期 备注 1引言 1.1编写目的
说明编写这份详细设计说明书的目的,指出预期的读者。 1.2背景
说明:
待开发软件系统的名称;
本项目的任务提出者、开发者、用户和运行该程序系统的计算中心。 1.3定义
列出本文件中用到专门术语的定义和外文首字母组词的原词组。 1.4参考资料
列出有关的参考资料,如:
本项目的经核准的计划任务书或合同、上级机关的批文; 属于本项目的其他已发表的文件;
本文件中各处引用到的文件资料,包括所要用到的软件开发标准。列出这些文件的标题、文件编号、发表日期和出版单位,说明能够取得这些文件的来源。 2程序系统的结构
用一系列图表列出本程序系统内的每个程序(包括每个模块和子程序)的名称、标识符和它们之间 的层次结构关系。 3程序1(标识符)设计说明
从本章开始,逐个地给出各个层次中的每个程序的设计考虑。以下给出的提纲是针对一般情况的。对于一个具体的模块,尤其是层次比较低的模块或子程序,其很多条目的内容往往与它所隶属的上一层 模块的对应条目的内容相同,在这种情况下,只要简单地说明这一点即可。 3.1程序描述
给出对该程序的简要描述,主要说明安排设计本程序的目的意义,并且,还要说明本程序的特点(如 是常驻内存还是非常驻?是否子程序?是可重人的还是不可重人的?有无覆盖要求?是顺序处理还是并发处理等)。 3.2功能
说明该程序应具有的功能,可采用IPO图(即输入一处理一输出图)的形式。 3.3性能
说明对该程序的全部性能要求,包括对精度、灵活性和时间特性的要求。
3.4输人项
给出对每一个输入项的特性,包括名称、标识、数据的类型和格式、数据值的有效范围、输入的方式。数量和频度、输入媒体、输入数据的来源和安全保密条件等等。 3.5输出项
给出对每一个输出项的特性,包括名称、标识、数据的类型和格式,数据值的有效范围,输出的形式、数量和频度,输出媒体、对输出图形及符号的说明、安全保密条件等等。 3.6算法
详细说明本程序所选用的算法,具体的计算公式和计算步骤。 3.7流程逻辑
用图表(例如流程图、判定表等)辅以必要的说明来表示本程序的逻辑流程。 3.8接口
用图的形式说明本程序所隶属的上一层模块及隶属于本程序的下一层模块、子程序,说明参数赋值和调用方式,说明与本程序相直接关联的数据结构(数据库、数据文卷)。 3.9存储分配
根据需要,说明本程序的存储分配。 3.10注释设计
说明准备在本程序中安排的注释,如: 加在模块首部的注释; 加在各分枝点处的注释;
对各变量的功能、范围、缺省条件等所加的注释; 对使用的逻辑所加的注释等等。 3.11限制条件
说明本程序运行中所受到的限制条件。 3.12测试计划
说明对本程序进行单体测试的计划,包括对测试的技术要求、输入数据、预期结果、进度安排、人员职责、设备条件驱动程序及桩模块等的规定。 3.13尚未解决的问题
说明在本程序的设计中尚未解决而设计者认为在软件完成之前应解决的问题。 4程序2(标识符)设计说明
用类似F.3的方式,说明第2个程序乃至第N个程序的设计考虑。
附件八 单元测试用例
1 测试范围
说明:本用例测试的功能点。 2 测试环境
环境1: 硬件环境: 服务器端: 客户端: 软件环境: 服务器端: 客户端: 网络环境: 环境2: 3 数据准备
说明:可以引用适当的附件,如EXCEL文件、文本文件等扁平文件等,这些文件内存放着测试准备的数据。 测试用例 功能1 测试编号 测试项目 用例描述 依赖描述 功能模块-子模块-编号 模块功能-子模块功能 描述测试上述功能的测试点 无 环境及初环境1, 填写用到的各种测试数据的名称 始数据 依赖样例 序号 测试本用例依赖的相关用例名称 前置条件 测试子项 执行步骤 预期结果 实际结果 备注 测试序号 填写本用说明测试详细列出对应每一对应每一填写与测例运行的的基本流各个用例步的预测个执行步试相关联前置条还是备选角色的操结果; 件。如登流;要求作的动陆、权测试遍历作。 限、设备所有的备就绪等; 选流; 骤的实际的核对结果; 点、检查点。 附件九 设计评审报告
文件状态: [√] 草稿 [ ] 正式发布 [ ] 正在修改 版 本 历 史 版本/状态 1. 基本信息
作者 参与者 起止日期 备注 文件标识: ProjectName- 当前版本: X.Y 作 者: 完成日期: Year-Month-Day 提示:由评审主持人或评审员填写此表格。 待评审的工作成果 工作成果名称,标识符,版本,作者,时间… 技术评审方式 评审时间 评审地点 参加技术评审的人员 类别 主持人 评审 小组 成员 记录员 名字 工作单位 职称、职务: (正式评审)或者(走查) 2. 缺陷识别和跟踪
评审问题跟踪表 编问题问题严重性 提交者 提交日期 问题处理负责人 解决措施/原因说明 问题解决状态 实际关闭日期 问题关闭验证人 1 2 3 3. 评审结论与意见
备注 号 描述 类型 提示:由主持人或评审员填写此表格。
[ ] 工作成果合格,“无需修改”或者“需要轻微修改但不必再审核”。 评审结论 [√] 工作成果基本合格,需要作少量的修改,之后通过审核即可。 [ ] 工作成果不合格,需要作比较大的修改,之后必须重新对其评审。 意见 负责人 签字 签字: 日期: 附件十 系统/用户测试计划
文件状态: [√] 草稿 [ ] 正式发布 [ ] 正在修改 版 本 历 史 版本/状态 1. 测试范围与主要内容
提示:系统测试小组应当根据项目的特征确定测试范围与内容。一般地,系统测试的主要内容包括功能测试、健壮性测试、性能测试、用户界面测试、安全性(security)测试、安装与反安装测试等。
2. 测试方法
提示:例如黑盒测试和白盒测试。 3. 测试环境与测试辅助工具 环境
设备 服务器 客户端 网络 工具 配置 软件 硬件 软件 硬件 名称/类型 工具 文件标识: 当前版本: 作 者: 完成日期: Year-Month-Day 作者 参与者 起止日期 备注 备注 类型 测试管理 缺陷跟踪 用于功能性测试的工具 用于性能测试的工具 开发商 版本 测试覆盖监测器或评测器 4. 测试进度计划 任务 制定测试计划 设计测试 实施测试 执行测试 对测试进行评估 5. 测试完成准则 提示:
人员 任务 开始日期 结束日期 对于非严格系统可以采用“基于测试用例”的准则: (1)功能性测试用例通过率达到100%; (2)非功能性测试用例通过率达到95%时。 对于严格系统,应当补充“基于BUG密度”的规则:
相邻n个CPU小时内“测试期BUG密度”全部低于某个值m。例如n大于10,m小于等于1。
最后一次回归测试二类缺陷数量为零,用例外非常规缺陷数量小于等于2 个/万行程序;
测试用例功能点覆盖率100%; 6. BUG管理与改错计划
提示:根据所采用的BUG管理工具确定:(1)BUG管理流程,(2)BUG修改流程。
定义BUG修改约定,例如:不同级别的BUG必须在几日内处理完成。 7. 附录. 本计划审批意见 项目经理审批意见: 签字 日期
附件十一 系统/用户测试报告
1. 基本信息 测试依据 测试范围 测试验收标准 测试环境描述 测试驱动程序描述 测试人员 测试时间 须注明每次回归测试的时间 测试工具 2. 实况记录 模块 测试用例编号 期望结果 测试结果 缺陷密度 是否执行了回归测试 例如:参照标准、客户需求、需求规格说明书、测试用例等 提示:可以把测试驱动程序当作附件 3. 测试总评价 根据对测试结果提出一个关于软件能力的全面分析,需标明遗留的主要缺陷、局限性和软件的约束限制等,并提出软件测试过程中程序中的不足。
根据测试标准及测试结果,综合评价软件的开发是否已达到预定目标。 4. 缺陷修改记录
提示:如果采用了缺陷管理工具,能自动产生缺陷报表的话,则无需本表。 缺陷名称 缺陷类型 … 测试人员签字/日期:
严重程度 模块 原因 驻留时间 解决方案 附件十二 试运行计划
文件状态: [√] 草稿 文件标识: 当前版本: ProjectName-TestRun-PLAN X.Y Year-Month-Day [ ] 正式发布 作 者: [ ] 正在修改 完成日期: 版 本 历 史 版本/状态 1. 试运行目标
作者 参与者 起止日期 备注 提示:说明本次试运行的主要内容与目标(必须是可以验证的)。 2. 工作条件
提示:说明试运行地点、参加人员、软硬件设施、经费等要求。 3. 应递交的工作成果
工作成果名称 试运行报告 报错趋势分析报告 …… 4. 进度表 提示:(1)用Microsoft Project制作进度表(Gantt Chart)插入此处或者参照此表制作一份进度表。 任务名称及其描述 任务1 任务2 … 5. 可能存在的困难与风险 提示:指出可能存在的困难和风险,制定应急计划以应对突发事件。
开始时间 结束时间 参加人员 预计完成时间 附录:本计划审批意见
提示:项目经理或者技术负责人根据项目计划以及现实情况(如可以支配的人力资源),审批该《试运行计划》。 项目经理或试运行负责人审批意见: 签字 日期 附件十三 数据迁移计划
1. 数据迁移的重要事件和里程碑日期 2. 数据迁移前的备份要求 3. 数据迁移测试结果清单 4.转换工作进度表
提示:(1)用Microsoft Project制作进度表(Gantt Chart),插入此处或作为附件。(2)或者在此处用表格制作一份进度表,例如: 任务名称及其描述 任务1 任务2 … 5. 转换操作步骤以及问题处理步骤 6.数据核对计划
7.数据迁移的需求和实施计划 8.应急预案及回退计划
1). 分析引发转换失败的潜在原因
提示:说明转换失败的几类原因,考虑人员、软硬件设施、经费等因素。 2). 预防措施
提示:针对转换失败的几类原因,制定预防措施。 3). 事件处理及回退计划
提示:在突发事件出现时的应对策略,应从人员组织、流程制定等方面考虑。 4). 组织机制
提示:建立应急处理小组成员,明确职责到人。 应急处理人员 8.培训计划 说明培训内容,时间,地点,培训讲师等信息。 9.附录:本计划审批意见
角色 职责 开始时间 结束时间 参加人员 项目负责人审批意见: 签字 日期 信息技术部审批意见 签字 日期 业务部门审批意见 签字 日期
附件十四 数据迁移报告
1. 背景介绍
提示:介绍系统转换的背景情况。 2. 数据迁移目标
提示:说明本次数据迁移的主要内容与目标。 3. 数据准备
提示:所准备进行转换的数据情况描述以及数据来源部门的审批结果 4. 数据迁移实录
提示:回顾系统上线各阶段工作,大体步骤 5.数据迁移后数据核对过程和结论
提示:说明本次数据迁移后进行数据核对的过程以及结论。包含主文件检查、转换前后数据记录与余额核对、数据映射表、会计科目对照表、机构对照表、内部基础数据对照表、账务报表的核对结果等。 6. 数据异常/差异处理
提示:数据迁移过程中,形成的数据异常/差错/数据修改所进行的处理过程记录,以及处理后的结论。 7. 问题和建议
提示:对数据迁移过程的问题进行总结,提出意见,并就运行维护情况提出自己的建议附录:本计划审批意见
项目负责人审批意见: 签字 日期 信息技术部审批意见 签字 日期 业务部门审批意见 签字 日期 附件十五 试运行报告
文件状态: [√] 草稿 文件标识: 当前版本: ProjectName-TestRun-REPORT X.Y [ ] 正式发布 作 者: [ ] 正在修改 版 本 历 史 版本/状态
1. 背景介绍
作者 参与者 起止日期 备注 提示:说明此次运行工作的必要性。 2. 试运行目标
提示:说明本次试运行的主要内容与目标(必须是可验证的)。 3. 试运行取得的工作成果
提示:说明本次试运行工作成果(程序、文档、数据等)以及试运行平台和时间。 4. 报错趋势分析报告 提示:建议制作趋势图 5. 试运行经验总结 6. 下一阶段工作安排
附件十六 系统验收报告
版 本 历 史 版本/状态 1. 基本信息 项目名称 甲方 乙方 合同 甲方验收人员 乙方人员 2. 成果审查报告 应交付成果的 名称、版本 3. 问题处理 甲方审核人 乙方协助人 时间 地点 审查 结论 角色 角色 职责 职责 作者 参与者 起止日期 备注 提示:如果甲方发现工作成果中存在缺陷,双方应当视问题的严重性给出合适的处理措施。(1)如果工作成果存在严重的缺陷,则退回给乙方。乙方应当给出纠正缺陷,双方协商第二次验收的时间。乙方应当赔偿给客户方造成的损失。(2)如果工作成果存在一些轻微的缺陷,则乙方应当给出纠正缺陷的措施,双方协商是否需要第二次验收。 问题 甲方负责人签字 乙方负责人签字 4. 交付签字 处理措施 提示: (1)当待验收的所有工作成果都通过了审查和测试后,乙方将其交付给甲方。 (2)双方的责任人签字认可。 交付签字 业务部门负责人签字 信息技术部项目负责人签字 乙方项目负责人签字 附件十七 系统上线计划
1. 部署方式及资源分配(包括人力资源及服务器资源)
提示:说明成立项目领导组等情况;说明人员、软硬件设施、经费等要求。
2.上线工作进度表
提示:(1)用Microsoft Project制作进度表(Gantt Chart),插入此处或作为附件。(2)或者在此处用表格制作一份进度表,例如:
任务名称及其描述 任务1 任务2 … 3. 数据准备计划
提示:手工系统向电子系统切换或者省级电子系统需要准备基础数据或进行数据迁移。
4.上线操作步骤以及问题处理步骤
5系统的功能测试计划
6.数据迁移的需求和实施计划
提示:此处可以直接说明请见附件“数据迁移实施计划”。
7. 应急预案及回退计划
1). 分析引发上线失败的潜在原因
提示:说明上线失败的几类原因,考虑人员、软硬件设施、经费等因素。 2). 预防措施
提示:针对上线失败的几类原因,制定预防措施。 3). 事件处理及回退计划
提示:在突发事件出现时的应对策略,应从人员组织、流程制定等方面考虑。 4). 组织机制
开始时间 结束时间 参加人员 提示:建立应急处理小组成员,明确职责到人。
应急处理人员 8. 业务人员培训方案
提示:说明培训内容,时间,地点,培训讲师等信息
9. 总公司下发的系统标准参数配置
提示:可以直接将该配置作为附件。 附录:本计划审批意见 项目负责人审批意见: 签字 日期 角色 职责 信息技术部审批意见 签字 日期 业务部门审批意见 签字 日期 附件十八 系统验收评估报告
1. 背景介绍
提示:介绍系统上线的背景情况。 2. 系统上线目标
提示:说明本次系统上线的主要内容与目标。 3. 系统上线实录
提示:回顾系统上线各阶段工作,大体步骤及异常处理情况。 4.系统上线后数据准确性结论
提示:可以描述详见附件“数据迁移评估表” 5. 接口检查结论 6. 权限设置情况
提示:请将权限设置表作为附件 7. 系统上线后稳定性结论
提示:说明本次系统上线后系统的稳定性,是否影响业务操作,系统性能。 8. 备份以及批处理设置情况
提示:可将设置情况作为附件 9.问题和建议
提示:对系统上线过程的问题进行总结,提出意见,并就上线及运行维护情况提出自己的建议。
项目负责人审批意见:
签字 日期
信息技术部审批意见:
签字 日期
系统使用部门审批意见:
因篇幅问题不能全部显示,请点此查看更多更全内容