1、*科技股份有限公司软件项目管理制度目录项目开发计划2软件需求说明书4具体设计说明书6用户手册8数据规定说明书11项目开发总结报告13项目开发计划 编制项目开发计划的目的是用文献的形式,把对于在开发过程中各项工作的负责人员、开发进度、 所需经费预算、所需软、硬件条件等问题作出的安排记载下来,以便根据本计划开展和检查本项目的开 发工作。编制内容规定如下:1引言11编写目的 说明编写这份项目开发计划的目的,并指出预期的读者。12背景说明:a待开发的软件系统的名称;b本项目的任务提出者、开发者、用户及实现该软件的计算中心或计算机网络;C该软件系统同其他系统或其他机构的基本的互相来往关系。13定义 列出
2、本文献中用到的专门术语的定义和外文首字母组词的原词组。14参考资料列出用得着的参考资料,如:a本项目的经核准的计划任务书或协议、上级机关的批文;b属于本项目的其他已发表的文献;C本文献中各处引用的文献、资料,涉及所要用到的软件开发标准。 列出这些文献资料的标题、文献编号、发表日期和出版单位,说明可以得到这些文献资料的来源。2项目概述 21 工作内容简要地说明在本项目的开发中须进行的各项重要工作。22重要参与人员扼要说明参与本项目开发工作的重要人员的情况,涉及他们的技术水平。23产品231程序列出需移交给用户的程序的名称、所用的编程语言及存储程序的媒体形式,并通过引用有关文献, 逐项说明其功能和
3、能力。 232文献列出需移交给用户的每种文献的名称及内容要点。 233服务列出需向用户提供的各项服务,如培训安装、维护和运营支持等,应逐项规定开始日期、所提供支持 的级别和服务的期限。234非移交的产品 说明开发集体应向本单位交出但不必向用户移交的产品(文献甚至某些程序)。24验收标准 对于上述这些应交出的产品和服务,逐项说明或引用资料说明验收标准。25完毕项目的员迟用限 26本计划的批准者和批准日期 3实行计划 31工作任务的分门与人员分工 对于项目开发中需完毕的各项工作,从需求分析、设计、实现、测试直到维护,涉及文献的编制、审批、打印、分发工作,用户培训工作,软件安装工作等,按层次进行分解
4、,指明每项任务的负责人和参与人员。32 接口人员说明负责接口工作的人员及他们的职责,涉及:a 负责本项目同用户的接口人员;b负责本项目同本单位各管理机构,如协议计划管理部门、财务部门、质量管理部门等的接口人员; c负责本项目同各分协议负责单位的接口人员等。 33进度 对于需求分析、设计、编码实现、测试、移交、培训和安装等工作,给出每项工作任务的预。定开始日期、完毕日期及所需资源,规定各项工作任务完毕的先后顺序以及表征每项工作任务完毕的标志性事件(即所谓里程碑)。 34预算 逐项列出本开发项目所需要的劳务(涉及人员的数量和时间)以及经费的预算(涉及办公费、差旅费、机时费、资料费、通讯设备和专用设
5、备的租金等)和来源。35关键问题逐项列出可以影响整个项目成败的关键问题、技术难点和风险,指出这些问题对项目的影响。4支持条件说明为支持本项目的开发所需要的各种条件和设施。41计算机系统支持逐项列出开发中和运营时所需的计算机系统支持,涉及计算机、外围设备、通讯设备、模拟器、编译 (或 汇编)程序、操作系统、数据管理程序包、数据存储能力和测试支持能力等,逐项给出有关到货日期、 使用时间的规定。42需由用户承担的工作逐项列出需要用户承担的工作和完毕期限。涉及需由用户提供的条件及提供时间。43由外单位提供的条件 逐项列出需要外单位分协议承包者承担的工作和完毕的时间,涉及需要由外单位提供的条件和提 供的
6、时间。 5专题计划要点说明本项目开发中需制订的各个专题计划(如分协议计划、开发人员培训计划、测试计划、安全保密 计划、质量保证计划、配置管理计划、用户培训计划、系统安装计划等)的要点。 软件需求说明书 软件需求说明书的编制是为了使用户和软件开发者双方对该软件的初始规定有一个共同的理解, 使之成为整个开发工作的基础。编制软件需求说明书的内容规定如下:1引言11编写目的说明编写这份软件需求说明书的目的,指出预期的读者。12背景 说明: a待开发的软件系统的名称;b本项目的任务提出者、开发者、用户及实现该软件的计算中心或计算机网络;C该软件系统同其他系统或其他机构的基本的互相来往关系。 13定义列出
7、本文献中用到的专门术语的定义和外文首字母组词的原词组。14参考资料 列出用得着的参考资料,如:a本项目的经核准的计划任务书或协议、上级机关的批文;b属于本项目的其他已发表的文献;c本文献中各处引用的文献、资料、涉及所要用到的软件开发标准。 列出这些文献资料的标题、文献编号、发表日期和出版单位,说明可以得到这些文献资料的来源。2任务概述 21目的 叙述该项软件开发的意图、应用目的、作用范围以及其他应向读者说明的有关该软件开发的背景材料。解释被开发软件与其他有关软件之间的关系。假如本软件产品是一项独立的软件,并且所有内容自含,则说明这一点。假如所定义的产品是一个更大的系统的一个组成部分,则应说明本
8、产品与该系统中其他各组成部分之间的关系,为此可使用一张方框图来说明该系统的组成和本产品同其他各部分的联系和接口。|22用户的特点 列出本软件的最终用户的特点,充足说明操作人员、维护人员的教育水平和技术专长,以及本软件的预期使甩频度。这些是软件设计工作的重要约束23假定和约束列出进行本软件开发工作的假定和约束,例如经费限制、开发期限等。3需求规定 31对功能的规定用列表的方式(例如IPO表即输入、解决、输出表的形式),逐项定量和定性地叙述对软件所提出的功能规定,说明输入什么量、经如何的解决、得到什么输出,说明软件应支持的终端数和应支持的并行操作的用户数。 32对性能的规定321精度 说明对该软件
9、的输入、输出数据精度的规定,也许涉及传输过程中的精度。322时间特性规定 说明对于该软件的时间特性规定,如对:a响应时间;b更新解决时间;c数据的转换和传送时间;d解题时间; 等的规定。323灵活性 说明对该软件的灵活性的规定,即当需求发生某些变化时,该软件对这些变化的适应能力,如:a操作方式上的变化;b运营环境的变化; c同其他软件的接口的变化;d精度和有效时限的变化; e计划的变化或改善。 对于为了提供这些灵活性而进行的专门设计的部分应当加以标明。33输人输出规定解释各输入输出数据类型,并逐项说明其媒体、格式、数值范围、精度等。对软件的数据输出及必须标明的控制输出量进行解释并举例,涉及对硬
10、拷贝报告(正常结果输出、状态输出及异常输出)以及图形或显示报告的描述。34数据管理能力规定 说明需要管理的文卷和记录的个数、表和文卷的大小规模,要按可预见的增长对数据及其分量的存储规定作出估算。 35故障解决规定列出也许的软件、硬件故障以及对各项性能而言所产生的后果和对故障解决的规定。36其他专门规定如用户单位对安全保密的规定,对使用方便的规定,对可维护性、可补充性、易读性、可靠性、运营环境可转换性的特殊规定等。 4运营环境规定 41设备 列出运营该软件所需要的硬设备。说明其中的新型设备及其专门功能,涉及:a解决器型号及内存容量;b外存容量、联机或脱机、媒体及其存储格式,设备的型号及数量;c输
11、入及输出设备的型号和数量,联机或脱机; d数据通信设备的型号和数量;e功能键及其他专用硬件42支持软件 列出支持软件,涉及要用到的操作系统、编译(或汇编)程序、测试支持软件等。43 接口说明该软件同其他软件之间的接口、数据通信协议等。44控制 说明控制该软件的运营的方法和控制信号,并说明这些控制信号的来源。 具体设计说明书 1 引言 11编写目的说明编写这份具体设计说明书的目的,指出预期的读者。12背景 说明:a待开发软件系统的名称; b本项目的任务提出者、开发者、用户和运营该程序系统的计算中心。 13定义 列出本文献中用到专门术语的定义和外文首字母组词的原词组。14参考资料 列出有关的参考资
12、料,如: a本项目的经核准的计划任务书或协议、上级机关的批文;b属于本项目的其他已发表的文献;c本文献中各处引用到的文献资料,涉及所要用到的软件开发标准。 列出这些文献的标题、文献编号、发表日期和出版单位,说明可以取得这些文献的来源。2程序系统的结构用一系列图表列出本程序系统内的每个程序(涉及每个模块和子程序)的名称、标记符和它们之间 的层次结构关系。3程序1(标记符)设计说明 从本章开始,逐个地给出各个层次中的每个程序的设计考虑。以下给出的提纲是针对一般情况的。 对于一个具体的模块,特别是层次比较低的模块或子程序,其很多条目的内容往往与它所从属的上一层 模块的相应条目的内容相同,在这种情况下
13、,只要简朴地说明这一点即可。 31程序描述 给出对该程序的简要描述,重要说明安排设计本程序的目的意义,并且,还要说明本程序的特点(如 是常驻内存还是非常驻?是否子程序?是可重人的还是不可重人的?有无覆盖规定?是顺序解决还是并发 解决卜等)。32功能 说明该程序应具有的功能,可采用IPO图(即输入一解决一输出图)的形式。33性能说明对该程序的所有性能规定,涉及对精度、灵活性和时间特性的规定。34输人项 给出对每一个输入项的特性,涉及名称、标记、数据的类型和格式、数据值的有效范围、输入的方式。 数量和频度、输入媒体、输入数据的来源和安全保密条件等等。3 5输出项 给出对每一个输出项的特性,涉及名称
14、、标记、数据的类型和格式,数据值的有效范围,输出的形式、 数量和频度,输出媒体、对输出图形及符号的说明、安全保密条件等等。36算法 具体说明本程序所选用的算法,具体的计算公式和计算环节。37流程逻辑 用图表(例如流程图、鉴定表等)辅以必要的说明来表达本程序的逻辑流程。38接口用图的形式说明本程序所从属的上一层模块及从属于本程序的下一层模块、子程序,说明参数赋值和调用方式,说明与本程序相直接关联的数据结构(数据库、数据文卷)。 39存储分派 根据需要,说明本程序的存储分派。 310注释设计 说明准备在本程序中安排的注释,如:a 加在模块首部的注释;b加在各分枝点处的注释; 对各变量的功能、范围、
15、缺省条件等所加的注释; d对使用的逻辑所加的注释等等。 311限制条件 说明本程序运营中所受到的限制条件。312测试计划 说明对本程序进行单体测试的计划,涉及对测试的技术规定、输入数据、预期结果、进度安排、人员职责、设备条件驱动程序及桩模块等的规定。313尚未解决的问题说明在本程序的设计中尚未解决而设计者认为在软件完毕之前应解决的问题。4程序2(标记符)设计说明用类似3的方式,说明第2个程序乃至第N个程序的设计考虑。 用户手册 1引言 11编写目的说明编写这份用户手册的目的,指出预期的读者。 12背景说明:a这份用户手册所描述的软件系统的名称;b该软件项目的任务提出者、开发者、用户(或首批用户
16、)及安装此软件的计算中心。13定义列出本文献中用到的专门术语的定义和外文首字母组词的原词组。14参考资料 列出有用的参考资料,如:a项目的经核准的计划任务书或协议、上级机关的批文;b属于本项目的其他已发表文献; c本文献中各处引用的文献、资料,涉及所要用到的软件开发标准。 列出这些文献资料的标题、文献编号、发表日期和出版单位,说明可以取得这些文献资料的来源。2用途21功能结合本软件的开发目的逐项地说明本软件所具有各项功能以及它们的极限范围。22性能221精度 逐项说明对各项输入数据的精度规定和本软件输出数据达成的精度,涉及传输中的精度规定。222时间特性 定量地说明本软件的时间特性,如响应时间
17、,更新解决时间,数据传输、转换时间,计算时间等。 223灵活性 说明本软件所具有的灵活性,即当用户需求(如对操作方式、运营环境、结果精度、时间特性等的规定)有某些变化时,本软件的适应能力。 2 3 安 全保密说明本软件在安全、保密方面的设计考虑和实际达成的能力。3运营环境31 硬设备列出为运营本软件所规定的硬设备的最小配置,如: a解决机的型号、内存容量; b所规定的外存储器、媒体、记录格式、设备的型号和台数、联机脱机;c IO设备(联机脱机?); d数据传输设备和转换设备的型号、台数。32支持软件说明为运营本软件所需要的支持软件,如:a操作系统的名称、版本号;b程序语言的编译汇编系统的名称和
18、版本号;c数据库管理系统的名称和版本号;d其他支持软件。33数据结构 列出为支持本软件的运营所需要的数据库或数据文卷。4使用过程 在本章,一方面用图表的形式说明软件的功能同系统的输入源机构、输出接受机构之间的关系。4 1安装与初始化 一步一步地说明为使用本软件而需进行的安装与初始化过程,涉及程序的存储形式、安装与初始化过程中的所有操作命令、系统对这些命令的反映与答复。表征安装工作完毕的测试实例等。假如有的话,还应说明安装过程中所需用到的专用软件。42输入规定输入数据和参量的准备规定。421输入数据的现实背景说明输入数据的现实背景,重要是a情况-例如人员变动、库存缺货;b情况出现的频度-例如是周
19、期性的、随机的、一项操作状态的函数c情况来源-一例如人事部门、仓库管理部门;d输入媒体-例如键盘、穿孔卡片、磁带;e限制-出于安全、保密考虑而对访问这些输入数据所加的限制;f质量管理-例如对输入数据合理性的检查以及当输入数据有错误时应采用的措施,如建立犯错情况的记录等;g支配-例如如何拟定输入数据是保存还是废弃,是否要分派给其他的接受者等。422输入格式 说明对初始输入数据和参量的格式规定,涉及语法规则和有关约定,如:a长度-一例如字符数行,字符数项;b格式基准-例如以左面的边沿为基准;c标号-例如标记或标记符; d顺序-例如各个数据项的顺序及位置;e标点-例如用来表达行、数据组等的开始或结束
20、而使用的空格、斜线、星号、字符组等。f词汇表-给出允许使用的字符组合的列表,严禁使用的字符组合的列表等;g省略和反复-给出用来表达输人元素可省略或反复的表达方式; h控制-给出用来表达输入开始或结束的控制信息。 H423输入举例 为每个完整的输入形式提供样本,涉及: a控制或首部-例如用来表达输入的种类和类型的信息,标记符输入日期,正文起点和对所用编码的规定; b主体-输入数据的主体,涉及数据文卷的输入表述部分;c尾部-用来表达输入结束的控制信息,累计字符总数等; d省略-指出哪些输入数据是可省略的;e反复-指出哪些输入数据是反复的。43输出 对每项输出作出说明 431输出数据的现实背景,说明
21、输出数据的现实背景,重要是:a使用-这些输出数据是给谁的,用来干什么; b使用频度-例如每周的、定期的或备查阅的;c媒体-打印、CRI显示、磁带、卡片、磁盘, d质量管理-一例如关于合理性检查、犯错纠正的规定;e支配-例如如何拟定输出数据是保存还是废弃,是否要分派给其他接受者等。432输出格式 给出对每一类输出信息的解释,重要是:a首部-如输出数据的标记符,输出日期和输出编号;b主体-输出信息的主体,涉及分栏标题;c尾部-涉及累计总数,结束标记。433输出举例 为每种输出类型提供例子。对例子中的每一项,说明:a定义-每项输出信息的意义和用途; b来源-是从特定的输入中抽出、从数据库文卷中取出、
22、或从软件的计算过程中得到c特性-输出的值域、计量单位、在什么情况下可缺省等。44文卷查询 这一条的编写针对具有查询能力的软件,内容涉及:同数据库查询有关的初始化、准备、及解决所需 要的具体规定,说明查询的能力、方式,所使用的命令和所规定的控制规定。 45犯错解决和恢复 列出由软件产生的犯错编码或条件以及应由用户承担的修改纠正工作。指出为了保证再启动和恢 复的能力,用户必须遵循的解决过程。46终端操作 当软件是在多终端系统上工作时,应编写本条,以说明终端的配置安排、连接步释、数据和参数输入 环节以及控制规定说明通过终端操作进行查询、检索、修改数据文卷的能力、语言、过程以及辅助性程 序等。 数据规
23、定说明书 1引言 11编写目的说明编写这份数据规定说明书的目的,指出预期的读者。 12背景说明: a待开发软件系统的名称; b列出本项目的任务提出者、开发者、用户以及将运营该项软件的计算站(中心)或计算机网络系统。 13定义 列出本文献中用到的专门术语的定义和外文首字母组词的原词组。14参考资料列出有关的参考资料,如:a本项目的经核准的计划任务书或协议,上级机关的批文; b属于本项目的其他已发表文献;c本文献中各处引用的文献、资料,涉及所要用到的软件开发标准。列出这些文献的标题、文献编号、发表日期和出版单位。说明可以得到这些文献资料的来源。2数据的逻辑描述 对数据进行逻辑描述时可把数据分为动态
24、数据和静态数据。所谓静态数据,指在运营过程中重要作 为参考的数据,它们在很长的一段时间内不会变化,一般不随运营而改变。所谓动态数据涉及所有在运 行中要发生变化的数据以及在运营中要输入、输出的数据。进行描述时应把各数据元素逻辑地提成若干 组,列如函数、源数据或对于其应用更为恰当的逻辑分组。给出每一数据元的名称(涉及缩写和代码)、定 义(或物理意义)度量单位、值域、格式和类型等有关信息。 21静态数据列出所有作为控制或参考用的静态数据元素。22动态输人数据列出动态输入数据元素(涉及在常规运营中或联机操作中要改变的数据)。23动态输出数据 列出动态输出数据元素(涉及在常规运营中或联机操作中要改变的数
25、据)。24内部生成数据列出向用户或开发单位中的维护调试人员提供的内部生成数据。 25数据约定说明对数据规定的制约。逐条列出对进一步扩充或使用方面的考虑而提出的对数据规定的限制(容 量、文卷、记录和数据元的个数的最大值)。对于在设计和开发中拟定是临界性的限制更要明确指出。 3数据的采集31规定和范围 按数据元的逻辑分组来说明数据采集的规定和范围,指明数据的采集方法,说明数据采集工作的承担者是用户还是开发者。具体的内容涉及:a输入数据的来源,例如是单个操作员、数据输入站,专业的数据输入公司或它们的一个分组;b数据输入(指把数据输入解决系统内部)所用的媒体和硬设备。假如只有指定的输入点的输入才是合法
26、的,则必须对此加以说明;c接受者说明输出数据的接受者; d输出数据的形式和设备列出输出数据的形式和硬设备。无论接受者将接受到的数据是打印输出,还是CRT上的一组字符、一帧图形,或一声警铃,或向开关线圈提供的一个电脉冲,或常用介质如磁盘、磁带、穿孔卡片等,均应具体说明;e数据值的范围给出每一个数据元的合法值的范围;f量纲给出数字的度量单位、增量的步长、零点的定标等。在数据是非数字量的情况下,要给出每一种合法值的形式和含意;g更新和解决的频度给出预定的对输入数据的更新和解决的频度。假如数据的输入是随机的,应给出更新解决的频度的平均值,或变化情况的某种其他度量。32输人的承担者 说明预定的对数据输入
27、工作的承担者。假如输入数据同某一接口软件有关,还应说明该接口软件的来源。 33预解决对数据的采集和预解决过程提出专门的规定,涉及适合应用的数据格式、预定的数据通信媒体和对输入的时间规定等。对于需经模拟转换或数字转换解决的数据量,要给出转换方法和转换因子等有关信息,以便软件系统使用这些数据。34 影响 说明这些数据规定对于设备、软件、用户、开发单位所也许产生的影响,例如规定用户单位增设某个机构等。 项目开发总结报告 I引言 11编写目的 说明编写这份项目开发总结报告的目的,指出预期的阅读范围。12背景 说明: a本项目的名称和所开发出来的软件系统的名称;b此软件的任务提出者、开发者、用户及安装此
28、软件的计算中心。I3定义列出本文献中用到的专门术语的定义和外文首字母组词的原词组。14参考资料 列出要用到的参考资料,如:a本项目的已核准的计划任务书或协议、上级机关的批文;b属于本项目的其他已发表的文献;c本文献中各处所引用的文献、资料,涉及所要用到的软件开发标准。 列出这些文献的标题、文献编号、发表日期和出版单位,说明可以得到这些文献资料的来源。2实际开发结果 21产品 说明最终制成的产品,涉及:a程序系统中各个程序的名字,它们之间的层次关系,以千字节为单位的各个程序的程序量、存储媒体的形式和数量;b程序系统共有哪几个版本,各自的版本号及它们之间的区别;c每个文献的名称; d所建立的每个数
29、据库。 假如开发中制订过配置管理计划,要同这个计划相比较。22重要功能和性能逐项列出本软件产品所实际具有的重要功能和性能,对照可行性研究报告、项目开发计划、功能需 求说明书的有关内容,说明原定的开发目的是达成了、未完全达成、或超过了。23基本流程 用图给出本程序系统的实际的基本的解决流程。24进度列出原定计划进度与实际进度的对比,明确说明,实际进度是提前了、还是延迟了,分析重要因素。 25费用列出原定计划费用与实际支出费用的对比,涉及: a工时,以人月为单位,并按不同级别记录;b计算机的使用时间,区别CPU时间及其他设备时间; c物料消耗、出差费等其他支出。 明确说明,经费是超过了、还是节余了,分析其重要因素。3开发工作评价 31对生产效率的评价给出实际生产效率,涉及:a程序的平均生产效率,即每人月生产的行数;b文献的平均生产效率,即每人月生产的千字数; 并列出原订计划数作为对比。32对产品质量的评价 说明在测试中检查出来的程序编制中的错误发生率,即每干条指令(或语句)中的错误指令数(或语句数)。假如开发中制订过质量保证计划或配置管理计划,要同这些计划相比较。33对技术方法的评价给出对在开发中所使用的技术、方法、工具、手段的评价。 34犯错因素的分析 给出对于开发中出现的错误的因素分析。4经验与教训 列出从这项开发工作中所得到的最重要的经验与教训及对此后的项目开发工作的建议。