《东联智胜软件项目管理制度.docx》由会员分享,可在线阅读,更多相关《东联智胜软件项目管理制度.docx(36页珍藏版)》请在三一办公上搜索。
1、目录、总述2二、项目计划2三、项目组织3四、项目管理44.1、软件开发规范44.1.1、命名体系44.1.2、编码风格44.1.3、界面风格44.1.4、版本控制54.1.5、通用约束54.1.6、开发方法54.1.7、开发流程54.1.8、交流制度64.1.9、代码标准化管理64.1.10、备份制度64.1.11、文档管理64.1.12、项目交付管理74.1.13、项目归档管理74.2、任务分解与分目标制定74.3、进度检查与绩效考评84.3.1、考评原则84.3.2、考评标准94.3.4、考评矩阵94.4、应对一些突发事件(协调与调整)114.5、与有利害关系的人共享信息11附录4-1项目
2、开发计划12附录4-2软件需求说明书14附录4-3详细设计说明书16附录4-4用户手册18附录4-5数据要求说明书21附录4-6项目开发总结报告23附录5-1 JAVA编码规范25附录5-2应用结构定义与命名规范31附录5-3数据库对象命名规范31一、总述项目管理覆盖整个项目生命周期,管理制度就是落实到管理过程中的一些基 本要素,这里我们将其概括为三项基本业务:I、项目计划 指明要取得的各种结果 指定进度表 估计所需资源II、项目组织落实项目体系中的角色配置与角色的职责III、项目管理 约束 任务分解与分目标制定 进度检查与质量评估 应对一些突发事件(协调与调整) 与有利害关系的人共享信息二、
3、项目计划项目计划的结果体现为“项目开发计划”书面形式,其中要对开发过程中各 项工作的负责人、开发进度、进度衡量的标准、完成进度所需经费预算以及所需 软、硬件条件等问题详尽的罗列出来,以便根据本计划开展和检查本项目的开发 工作。附录4-1给出计划书模板。三、项目组织项目组织包括项目角色定义、角色责任定义、角色间关系定义。角色定义是 根据项目需求配置(调配、招聘)具备相应素质与能力的成员。角色责任定义就 是将具体的任务分解到每个角色;角色间关系定义指明报告与检查体系;一般情 况下为三级组织:业务与商务协调组(商务洽谈、目标与进度及资源定义与落实调整)产品经理开发组系统支持组负责主机、网络、应用支撑
4、软件的安装调试开发经理系统架构组负责系统的体系结构与应用框架设计详细设计组落实到具体语言的功能实现质量控制组(负责功能、性能、可用性、可维护性、稳定性、压力测试)质量经理业务与商务协调组一般由客我双方成员共同组成,负责项目的总体需求、总 体目标、里程碑,关键技术路径定义。在制定项目总体目标、里程碑定义与关键 技术路径时候要与开发经理联合统筹,并以产品经理意见为主。开发组的责任人是开发经理,系统体系结构与框架由开发经理与开发组主力 程序员联合统筹,并以开发经理意见为主,具体功能实现一般以主力程序员(系 统分析员、高级程序员)意见为主。“系统支持”属于临时调配,很可能是外部 资源,但工作质量由开发
5、经理检查。质量控制由质量经理、开发经理、产品经理联合统筹,以质量经理意见为主。整个项目生命周期中一般角色责任定义如下:软件开发可分为:过程、定义、设计、编码、系统测试、接收、移植、运得过程。过程阶段职责文档成果描述角色定义需求定义问题说明书产品经理/分析员开始项目计划项目规划产品经理/分析员设计设计方案设计说明书技术经理/分析员编码编写程序编码说明书技术经理/程序员将程序集成到系统中集成测试说明书程序员测试验证系统功能与性能系统测试说明书质量经理/测试员接收向客户演示系统操作说明书产品经理/客户移植移植最终运行环境移植说明书技术经理/程序员数据米集及导入程序员运行用户培训用户培训文档产品经理/
6、用户监控系统运行性能用户/分析员项目管理41、软件开发规范这里只是给出我司软件开发必须遵从的原则,具体内容应该由产品经理或开 发经理根据具体项目制定详尽约定。在罗列规范之前,开发组织(团队)必须遵 从一个最基本的约定一一统一开发环境:OS:操作系统;IDE:集成开发工具;DEBUG :调试工具;SC:源代码控制器;IM:即时交流工具;DD:文档工具(计划,任务,报告);ASM:间接交流工具,一般以mail为主。另外还要为团队固定一些一些角色,builder / Server administrator(dba&osa)o严格区分开发平台与生产平台之间的界限(安全、测试、性能)4.1.1、命名体
7、系A)数据库与数据库对象命名;B)开发语言的元素命名(类、对象、文件、命名空间、组件、函数、方法等);C)页面与页面元素命名.D)文件目录体系4.1.2、编码风格缩进、换行、块大小、文件大小、注释4.1.3、界面风格组件类别、大小、前景、背景、字体、鼠标敏感、边框、布局4.1.4、版本控制创建权限、创建分之权限、更新频度、提交准则。4.1.5、通用约束向导设置、数据校验、提示信息、响应时间与响应方式4.1.6、开发方法鉴于用户需求的不容易澄清性与变动频繁这一特点,所有项目均采用迭代开 发方法。这就是说不要指望在明确的需求调研阶段能把问题搞清楚,弄清楚个大 概即可,以不超过两周的迭代间隔快速的交
8、互原型,以便反馈更进一步的需求、 这样一步步逼近用户的真实想法。这里要特别强调的是多与用户交流,项目组内 有关设计方法与策略也要频繁地交流。4.1.7、开发流程纯粹从开发的角度我们将项目周期划分为两个阶段,每个阶段要完成的的如下:4.1.8、交流制度项目组每周至少要进行不少于两次的集体交流,否则就是开发经理或产品经 理失职(交流不限制时间长短、方式、内容可以从需要到设计到实现、甚至是抱 怨)。4.1.9、代码标准化管理小组内成员必须开展互测,产品经理要督促进行。如果一般性的缺陷被质量 组测试发现,产品经理可以作出警告、取消休假、扣发奖金等处理措施。产品经 理或开发经理可抽查成员代码,对比规范作
9、出人员基本技术素养评测,计入期末 (项目结束)考核(去留)。4.1.10、备份制度应用系统的所有资料代码(程序、脚本块、数据库脚本)、文档、数据, 除了数据以外,全部纳入源代码控制系统。数据每天备份一次媒介是磁盘,代 码(程序脚本、数据库脚本)、文档每周一次媒介是磁盘,所有信息每月备份 一次媒介是光盘,并在开发经理处填写备份记录表格。(备份时间、备份类型、 备份目标、备份人签字)4.1.11、文档管理没有文档的软件是一种灾难。代码不是传达系统原理和结构的理想媒介;开 发团队更需要编制易于阅读的文挡,来对系统及其设计决策的依据进行描述。然而,过多的文档比过少的文档更糟。编制众多的文档需要花费大量
10、的时间, 并且要使这些文档和代码保持同步:就要花费更多的时间。如果文档和代码之间 失去同步,那么文档就会变成庞大的、复杂的谎言.会造成重大的误导;对于团队来说,编写并维护一份系统原理和结构方而的文挡将总是一个好主 张,但是那份文档应该是短小、突出主题的。为此我们拟定所有项目都必须编制 以下文档。1项目开发计划书,模板见附录4-12软件需求说明书,模板见附录4-23详细设计说明书,模板见附录4-34用户手册,模板见附录4-45数据库需求说明,模板见附录4-56项目开发总结报告,模板见附录4-64.1.12、项目交付管理软件交付应用,源代码文档交付视技术合同要求交付的内容而定运行维护技术交付:系统
11、、数据库、应用的日常管理与维护。系统安全性交付:操作系统管理与应用账号、数据库管理与应用开发账号、应用 服务器的管理与应用开发账号。4.1.13、项目归档管理项目执行过程的所有资料程序、脚本、数据、文档以光盘作媒介,并附上 资料清单,交给公司行政部。4.2、任务分解与分目标制定组织中的负责人负责具体的任务分解并落实到组织中的每个人。形式如下:软件开发任务单项目名称:任务编号子项名称按“子系统f模块f功能”最多三级划分功能描述技术要求复杂度(业务与技术两个层次)任务发出人任务承接人限时开始yyyy/MMdd限时结束yyyy/MMdd考核标准(百分制)分值考评项目301、时效性:(是否按时完成)4
12、02、客户关注点:(功能、可靠性、易用性、高效性、可维护 性、可移植性)表现如何103、规范与标准54、复用与创新85、团队精神26、奉献精神57、沟通精神4.3、进度检查与绩效考评4.3.1、考评原则软件开发人员的绩效考评要求遵循以下六条原则:1、被考核对象必须有明确的任务产品经理或开发经理必须发出明确的任务书:任务书中指定任务名称、任务 内容、完成时限、考核标准、向谁负责、任务的难易程度(业务与技术两个方面)。 难易程度由项目组成员集体评价。没有明确的任务当然就无法考评(见软件任务 开发单)。2、考评标准要综合计量量与非计量量。计量量如:完成时间、完成了多少功能、测试出多少缺陷等,非计量量
13、如: 用户接受程度如何、项目组合作情况如何等等,要将这些因素综合考虑。3、要体现多劳多得、奖勤罚懒。高效、高质完成任务的人员必须得到区别对待(调资、休假、奖金)。4、考评结果要及时与被考评对象沟通,容许争议协调。5、考评时间不得跨度太大一般为两周一次,不符合这种周期的,产品经理与开发经理需要适当对任务 做进一步分解。6、被考评要提供周报月报之类的内容周报、月报不作为考评的依据,只注重结果,也就是说根据结果认定过程。4.3.2、考评标准1、时效性:不管是承揽项目还是产品研发都有一定的时间限定,愈期就意味着成本增加 甚至是失败。所以能否按时完成任务是绩效考评的一个重要标致。2、客户关注点客户关注点
14、也就是软件的品质,涉及的内容很多,按国家标准分为六个层面, 即:功能、可靠性、易用性、高效性、可维护性、可移植性。这六个项目的次序 也就是我们考察的顺序,首先必须完成功能,然后再衡量功能是否可靠,再然后 才其他几个方面,以百分制来衡量,这六个指标的比例是50,25,15,10,5,5。也就 是说必须保证前四项。而功能、可靠性又是重中之重75%。3、规范与标准不以规矩不能成方园,不遵从标准的与规范的设计开发必将造成巨大的维护 成本与技术积累成本,同时也给软件交流与究错设置障碍,所以必须强调规范化 与标准化。4、复用与创新性这是软件开发人员设计与开发综合能力的一个集中体现。5、团队精神没有团队精神
15、的软件开发人员坚决辞退。开发过程中团队精神主要表现在:一、对测试出的问题是互相推委,还是协商解决;二、接口设计各行其事还是共同制订;三、发现他人犯错是善意提醒还是沉默不语;四、不注重版本管理。6、奉献精神任务比较紧张时候,是否不计较个人得失主动加班加点赶任务。7、沟通精神不懂问题是拖延时间还是主动寻求帮助,技术经验是否主动分享。4.3.4、考评矩阵开发人员当期任务评测表任务书编号:项目指标时效率按时未按时X%(X-100)完成X%客户关注点功能可靠易用性能维护移植功能可靠易用性能AW50%BW25%CW15%DW10%EW5%FW5%AW50%BW25%CW15%DW10%规范与标准好中差GE
16、6 一 10GW4G-0复用与创新性好中差HE35HW2H-0团队精神好中差IE58IW4IG0-奉献精神好中差JE1.52.0J-0.5J-0.沟通精神好中差KE35KW2K-0.记分(30 + (A+B+C+D+E+F)*40+G+H+I+J+K)*X%功能:实现的结果是否体现的客户的意图,与客户意图之间的差距(X%),功能测评比例(1-x%)*50%可靠性:主要以测试出的缺陷多少来衡量,如果一个最低级功能被测出超过三个缺陷,可靠性为零。易用性:重要从数据校验与否、出错提示信息明细程度,输入数据量多少,是否符合输入习惯四个方面进行衡量;性能:主要是响应速度可维护性与可移植性要看与规范与标准
17、的差距成都东联智胜有限公司Page 1012/8/20164.4、应对一些突发事件(协调与调整)项目可能造成的结果人员流动招聘、调配、项目延期突发性需求商务谈判、项目延期技术更新利润损失、技术积累损失、项目延期法律问题无法进展其它4.5、与有利害关系的人共享信息项目共享范围一般信息共享核心信息有限共享专有信息不共享附录4-1项目开发计划编制项目开发计划的目的是用文件的形式,把对于在开发过程中各项工作的负责人员、 开发进度、所需经费预算、所需软、硬件条件等问题作出的安排记载下来,以便根据本计 划开展和检查本项目的开发工作。编制内容要求如下:1引言1. 1编写目的说明编写这份项目开发计划的目的,并
18、指出预期的读者。1. 2背景说明:a. 待开发的软件系统的名称;b. 本项目的任务提出者、开发者、用户及实现该软件的计算中心或计算机网络;C.该软件系统同其他系统或其他机构的基本的相互来往关系。1. 3定义列出本文件中用到的专门术语的定义和外文首字母组词的原词组。1. 4参考资料列出用得着的参考资料,如:a. 本项目的经核准的计划任务书或合同、上级机关的批文;b. 属于本项目的其他已发表的文件;C.本文件中各处引用的文件、资料,包括所要用到的软件开发标准。列出这些文件 资料的标题、文件编号、发表日期和出版单位,说明能够得到这些文件资料的来源。2项目概述2. 1工作内容简要地说明在本项目的开发中
19、须进行的各项主要工作。2. 2主要参加人员扼要说明参加本项目开发工作的主要人员的情况,包括他们的技术水平。2. 3产品2. 3. 1程序列出需移交给用户的程序的名称、所用的编程语言及存储程序的媒体形式,并通过引用 有关文件,逐项说明其功能和能力。2. 3. 2文件列出需移交给用户的每种文件的名称及内容要点。2. 3. 3服务列出需向用户提供的各项服务,如培训安装、维护和运行支持等,应逐项规定开始日期、 所提供支持的级别和服务的期限。2. 3. 4非移交的产品说明开发集体应向本单位交出但不必向用户移交的产品(文件甚至某些程序)。2. 4验收标准对于上述这些应交出的产品和服务,逐项说明或引用资料说
20、明验收标准。2. 5完成项目的员迟用限2. 6本计划的批准者和批准日期3实施计划3. 1工作任务的分门与人员分工对于项目开发中需完成的各项工作,从需求分析、设计、实现、测试直到维护,包括文 件的编制、审批、打印、分发工作,用户培训工作,软件安装工作等,按层次进行分解,指 明每项任务的负责人和参加人员。3. 2接口人员说明负责接口工作的人员及他们的职责,包括:a .负责本项目同用户的接口人员;b. 负责本项目同本单位各管理机构,如合同计划管理部门、财务部门、质量管理部门 等的接口人员;c. 负责本项目同各分合同负责单位的接口人员等。3. 3进度对于需求分析、设计、编码实现、测试、移交、培训和安装
21、等工作,给出每项工作任务 的预。定开始日期、完成日期及所需资源,规定各项工作任务完成的先后顺序以及表征每项 工作任务完成的标志性事件(即所谓”里程碑”)。3. 4预算逐项列出本开发项目所需要的劳务(包括人员的数量和时间)以及经费的预算(包括办 公费、差旅费、机时费、资料费、通讯设备和专用设备的租金等)和来源。3. 5关键问题逐项列出能够影响整个项目成败的关键问题、技术难点和风险,指出这些问题对项目的 影响。4支持条件说明为支持本项目的开发所需要的各种条件和设施。4. 1计算机系统支持逐项列出开发中和运行时所需的计算机系统支持,包括计算机、外围设备、通讯设备、 模拟器、编译(或汇编)程序、操作系
22、统、数据管理程序包、数据存储能力和测试支持能 力等,逐项给出有关到货日期、使用时间的要求。4. 2需由用户承担的工作逐项列出需要用户承担的工作和完成期限。包括需由用户提供的条件及提供时间。4. 3由外单位提供的条件逐项列出需要外单位分合同承包者承担的工作和完成的时间,包括需要由外单位提供的 条件和提供的时间。5 专题计划要点说明本项目开发中需制订的各个专题计划(如分合同计划、开发人员培训计划、测试计 划、安全保密计划、质量保证计划、配置管理计划、用户培训计划、系统安装计划等)的 要点。附录4-2软件需求说明书软件需求说明书的编制是为了使用户和软件开发者双方对该软件的初始规定有一个 共同的理解,
23、使之成为整个开发工作的基础。编制软件需求说明书的内容要求如下:1引言1. 1编写目的说明编写这份软件需求说明书的目的,指出预期的读者。1. 2背景说明:a. 待开发的软件系统的名称;b. 本项目的任务提出者、开发者、用户及实现该软件的计算中心或计算机网络;C.该软件系统同其他系统或其他机构的基本的相互来往关系。1. 3定义列出本文件中用到的专门术语的定义和外文首字母组词的原词组。1. 4参考资料列出用得着的参考资料,如:a. 本项目的经核准的计划任务书或合同、上级机关的批文;b. 属于本项目的其他已发表的文件;c. 本文件中各处引用的文件、资料、包括所要用到的软件开发标准。列出这些文件资 料的
24、标题、文件编号、发表日期和出版单位,说明能够得到这些文件资料的来源。2任务概述2. 1目标叙述该项软件开发的意图、应用目标、作用范围以及其他应向读者说明的有关该软件开 发的背景材料。解释被开发软件与其他有关软件之间的关系。如果本软件产品是一项独立的 软件,而且全部内容自含,则说明这一点。如果所定义的产品是一个更大的系统的一个组成 部分,则应说明本产品与该系统中其他各组成部分之间的关系,为此可使用一张方框图来说 明该系统的组成和本产品同其他各部分的联系和接口。I2. 2用户的特点列出本软件的最终用户的特点,充分说明操作人员、维护人员的教育水平和技术专长, 以及本软件的预期使甩频度。这些是软件设计
25、工作的重要约束2. 3假定和约束列出进行本软件开发工作的假定和约束,例如经费限制、开发期限等。3 需求规定3. 1对功能的规定用列表的方式(例如IPO表即输入、处理、输出表的形式),逐项定量和定性地叙述对 软件所提出的功能要求,说明输入什么量、经怎样的处理、得到什么输出,说明软件应支持 的终端数和应支持的并行操作的用户数。3. 2对性能的规定3. 2. 1精度说明对该软件的输入、输出数据精度的要求,可能包括传输过程中的精度。3. 2. 2时间特性要求说明对于该软件的时间特性要求,如对:a. 响应时间;b. 更新处理时间;c. 数据的转换和传送时间;d. 解题时间;等的要求。3. 2. 3灵活性
26、说明对该软件的灵活性的要求,即当需求发生某些变化时,该软件对这些变化的适应能 力,如:a. 操作方式上的变化;b运行环境的变化;c. 同其他软件的接口的变化;d. 精度和有效时限的变化;e. 计划的变化或改进。对于为了提供这些灵活性而进行的专门设计的部分应该加以标明。3. 3输人输出要求解释各输入输出数据类型,并逐项说明其媒体、格式、数值范围、精度等。对软件的数 据输出及必须标明的控制输出量进行解释并举例,包括对硬拷贝报告(正常结果输出、状态 输出及异常输出)以及图形或显示报告的描述。3. 4数据管理能力要求说明需要管理的文卷和记录的个数、表和文卷的大小规模,要按可预见的增长对数据及 其分量的
27、存储要求作出估算。3. 5故障处理要求列出可能的软件、硬件故障以及对各项性能而言所产生的后果和对故障处理的要求。3. 6其他专门要求如用户单位对安全保密的要求,对使用方便的要求,对可维护性、可补充性、易读性、 可靠性、运行环境可转换性的特殊要求等。4运行环境规定4. 1设备列出运行该软件所需要的硬设备。说明其中的新型设备及其专门功能,包括:a. 处理器型号及内存容量;b. 外存容量、联机或脱机、媒体及其存储格式,设备的型号及数量;c-输入及输出设备的型号和数量,联机或脱机;d. 数据通信设备的型号和数量;e. 功能键及其他专用硬件4. 2支持软件列出支持软件,包括要用到的操作系统、编译(或汇编
28、)程序、测试支持软件等。4. 3 接口说明该软件同其他软件之间的接口、数据通信协议等。4. 4控制说明控制该软件的运行的方法和控制信号,并说明这些控制信号的来源。附录4-3详细设计说明书1引言1. 1编写目的说明编写这份详细设计说明书的目的,指出预期的读者。1. 2背景说明:a. 待开发软件系统的名称;b. 本项目的任务提出者、开发者、用户和运行该程序系统的计算中心。1. 3定义列出本文件中用到专门术语的定义和外文首字母组词的原词组。1. 4参考资料列出有关的参考资料,如:a. 本项目的经核准的计划任务书或合同、上级机关的批文;b. 属于本项目的其他已发表的文件;c. 本文件中各处引用到的文件
29、资料,包括所要用到的软件开发标准。列出这些文件的 标题、文件编号、发表日期和出版单位,说明能够取得这些文件的来源。2程序系统的结构用一系列图表列出本程序系统内的每个程序(包括每个模块和子程序)的名称、标识符 和它们之间的层次结构关系。3程序1 (标识符)设计说明从本章开始,逐个地给出各个层次中的每个程序的设计考虑。以下给出的提纲是针对一 般情况的。对于一个具体的模块,尤其是层次比较低的模块或子程序,其很多条目的内容 往往与它所隶属的上一层模块的对应条目的内容相同,在这种情况下,只要简单地说明这 一点即可。3. 1程序描述给出对该程序的简要描述,主要说明安排设计本程序的目的意义,并且,还要说明本
30、程 序的特点(如 是常驻内存还是非常驻?是否子程序?是可重人的还是不可重人的?有无覆 盖要求?是顺序处理还是并发处理卜.等)。3. 2功能说明该程序应具有的功能,可采用IPO图(即输入一处理一输出图)的形式。3. 3性能说明对该程序的全部性能要求,包括对精度、灵活性和时间特性的要求。3. 4输人项给出对每一个输入项的特性,包括名称、标识、数据的类型和格式、数据值的有效范围、 输入的方式。数量和频度、输入媒体、输入数据的来源和安全保密条件等等。3. 5输出项给出对每一个输出项的特性,包括名称、标识、数据的类型和格式,数据值的有效范围, 输出的形式、数量和频度,输出媒体、对输出图形及符号的说明、安
31、全保密条件等等。3. 6算法详细说明本程序所选用的算法,具体的计算公式和计算步骤。3. 7流程逻辑用图表(例如流程图、判定表等)辅以必要的说明来表示本程序的逻辑流程。3. 8 接口用图的形式说明本程序所隶属的上一层模块及隶属于本程序的下一层模块、子程序,说 明参数赋值和调用方式,说明与本程序相直接关联的数据结构(数据库、数据文卷)。3. 9存储分配根据需要,说明本程序的存储分配。3. 10注释设计说明准备在本程序中安排的注释,如:a. 加在模块首部的注释;b. 加在各分枝点处的注释;对各变量的功能、范围、缺省条件等所加的注释;d. 对使用的逻辑所加的注释等等。3. 11限制条件说明本程序运行中
32、所受到的限制条件。3. 12测试计划说明对本程序进行单体测试的计划,包括对测试的技术要求、输入数据、预期结果、进 度安排、人员职责、设备条件驱动程序及桩模块等的规定。3. 13尚未解决的问题说明在本程序的设计中尚未解决而设计者认为在软件完成之前应解决的问题。4程序2 (标识符)设计说明用类似3的方式,说明第2个程序乃至第N个程序的设计考虑。附录4-4用户手册1引言1. 1编写目的说明编写这份用户手册的目的,指出预期的读者。1. 2背景说明:a. 这份用户手册所描述的软件系统的名称;b. 该软件项目的任务提出者、开发者、用户(或首批用户)及安装此软件的计算中心。1. 3定义列出本文件中用到的专门
33、术语的定义和外文首字母组词的原词组。1. 4参考资料列出有用的参考资料,如:3.项目的经核准的计划任务书或合同、上级机关的批文;b. 属于本项目的其他已发表文件;C.本文件中各处引用的文件、资料,包括所要用到的软件开发标准。列出这些文件资 料的标题、文件编号、发表日期和出版单位,说明能够取得这些文件资料的来源。2用途2. 1功能结合本软件的开发目的逐项地说明本软件所具有各项功能以及它们的极限范围。2. 2性能2. 2. 1精度逐项说明对各项输入数据的精度要求和本软件输出数据达到的精度,包括传输中的精度 要求。2. 2. 2时间特性定量地说明本软件的时间特性,如响应时间,更新处理时间,数据传输、
34、转换时间,计 算时间等。2. 2. 3灵活性说明本软件所具有的灵活性,即当用户需求(如对操作方式、运行环境、结果精度、时 间特性等的要求)有某些变化时,本软件的适应能力。2. 3安全保密说明本软件在安全、保密方面的设计考虑和实际达到的能力。3 运行环境3. 1硬设备列出为运行本软件所要求的硬设备的最小配置,如:a. 处理机的型号、内存容量;b. 所要求的外存储器、媒体、记录格式、设备的型号和台数、联机/脱机;c. I/O设备(联机/脱机?);d. 数据传输设备和转换设备的型号、台数。3. 2支持软件说明为运行本软件所需要的支持软件,如:a. 操作系统的名称、版本号;b. 程序语言的编译/汇编系
35、统的名称和版本号;c. 数据库管理系统的名称和版本号;d. 其他支持软件。3. 3数据结构列出为支持本软件的运行所需要的数据库或数据文卷。4使用过程在本章,首先用图表的形式说明软件的功能同系统的输入源机构、输出接收机构之间的 关系。4. 1安装与初始化一步一步地说明为使用本软件而需进行的安装与初始化过程,包括程序的存储形式、安 装与初始化过程中的全部操作命令、系统对这些命令的反应与答复。表征安装工作完成的测 试实例等。如果有的话,还应说明安装过程中所需用到的专用软件。4. 2输入规定输入数据和参量的准备要求。4. 2. 1输入数据的现实背景说明输入数据的现实背景,主要是a. 情况-例如人员变动
36、、库存缺货;b情况出现的频度-例如是周期性的、随机的、一项操作状态的函数.c. 情况来源-一例如人事部门、仓库管理部门;d-输入媒体-例如键盘、穿孔卡片、磁带;e. 限制-出于安全、保密考虑而对访问这些输入数据所加的限制;f. 质量管理-例如对输入数据合理性的检验以及当输入数据有错误时应采取的措施,如 建立出错情况的记录等;g. 支配-例如如何确定输入数据是保留还是废弃,是否要分配给其他的接受者等。4. 2. 2输入格式说明对初始输入数据和参量的格式要求,包括语法规则和有关约定,如:a. 长度-一例如字符数/行,字符数/项;b. 格式基准-例如以左面的边沿为基准;c. 标号-例如标记或标识符;
37、d. 顺序-例如各个数据项的次序及位置;e. 标点-例如用来表示行、数据组等的开始或结束而使用的空格、斜线、星号、字符 组等。f. 词汇表-给出允许使用的字符组合的列表,禁止使用大的字符组合的列表等;g. 省略和重复-给出用来表示输人元素可省略或重复的表示方式;h. 控制-给出用来表示输入开始或结束的控制信息。H. 4. 2. 3输入举例为每个完整的输入形式提供样本,包括:a. 控制或首部-例如用来表示输入的种类和类型的信息,标识符输入日期,正文起点 和对所用编码的规定;b. 主体-输入数据的主体,包括数据文卷的输入表述部分;c. 尾部-用来表示输入结束的控制信息,累计字符总数等;d. 省略-
38、指出哪些输入数据是可省略的;e. 重复-指出哪些输入数据是重复的。4. 3输出对每项输出作出说明.4. 3. 1输出数据的现实背景,说明输出数据的现实背景,主要是:a. 使用-这些输出数据是给谁的,用来干什么;b. 使用频度-例如每周的、定期的或备查阅的;c. 媒体-打印、CRI显示、磁带、卡片、磁盘,d. 质量管理-一例如关于合理性检验、出错纠正的规定;e. 支配-例如如何确定输出数据是保留还是废弃,是否要分配给其他接受者等。4. 3. 2输出格式给出对每一类输出信息的解释,主要是:a. 首部-如输出数据的标识符,输出日期和输出编号;b. 主体-输出信息的主体,包括分栏标题;c. 尾部-包括
39、累计总数,结束标记。4. 3. 3输出举例为每种输出类型提供例子。对例子中的每一项,说明:a. 定义-每项输出信息的意义和用途;b. 来源-是从特定的输入中抽出、从数据库文卷中取出、或从软件的计算过程中得到c. 特性-输出的值域、计量单位、在什么情况下可缺省等。4. 4文卷查询这一条的编写针对具有查询能力的软件,内容包括:同数据库查询有关的初始化、准备、 及处理所需要的详细规定,说明查询的能力、方式,所使用的命令和所要求的控制规定。4. 5出错处理和恢复列出由软件产生的出错编码或条件以及应由用户承担的修改纠正工作。指出为了确保再 启动和恢 复的能力,用户必须遵循的处理过程。4. 6终端操作当软
40、件是在多终端系统上工作时,应编写本条,以说明终端的配置安排、连接步释、数 据和参数输入步骤以及控制规定.说明通过终端操作进行查询、检索、修改数据文卷的能 力、语言、过程以及辅助性程序等。附录4-5数据要求说明书1引言1. 1编写目的说明编写这份数据要求说明书的目的,指出预期的读者。1. 2背景说明:a. 待开发软件系统的名称;b. 列出本项目的任务提出者、开发者、用户以及将运行该项软件的计算站(中心)或 计算机网络系统。1. 3定义列出本文件中用到的专门术语的定义和外文首字母组词的原词组。1. 4参考资料列出有关的参考资料,如:a. 本项目的经核准的计划任务书或合同,上级机关的批文;b. 属于
41、本项目的其他已发表文件;c. 本文件中各处引用的文件、资料,包括所要用到的软件开发标准。列出这些文件的 标题、文件编号、发表日期和出版单位。说明能够得到这些文件资料的来源。2数据的逻辑描述对数据进行逻辑描述时可把数据分为动态数据和静态数据。所谓静态数据,指在运行过 程中主要作为参考的数据,它们在很长的一段时间内不会变化,一般不随运行而改变。所 谓动态数据.包括所有在运行中要发生变化的数据以及在运行中要输入、输出的数据。进 行描述时应把各数据元素逻辑地分成若干组,列如函数、源数据或对于其应用更为恰当的 逻辑分组。给出每一数据元的名称(包括缩写和代码)定义(或物理意义)度量单位、值 域、格式和类型
42、等有关信息。2. 1静态数据列出所有作为控制或参考用的静态数据元素。2. 2动态输人数据列出动态输入数据元素(包括在常规运行中或联机操作中要改变的数据)。2. 3动态输出数据列出动态输出数据元素(包括在常规运行中或联机操作中要改变的数据)。2. 4内部生成数据列出向用户或开发单位中的维护调试人员提供的内部生成数据。2. 5数据约定说明对数据要求的制约。逐条列出对进一步扩充或使用方面的考虑而提出的对数据要求 的限制(容量、文卷、记录和数据元的个数的最大值。对于在设计和开发中确定是临界性 的限制更要明确指出。3数据的采集3. 1要求和范围按数据元的逻辑分组来说明数据采集的要求和范围,指明数据的采集
43、方法,说明数据采 集工作的承担者是用户还是开发者。具体的内容包括:a-输入数据的来源,例如是单个操作员、数据输入站,专业的数据输入公司或它们的一个分组;b. 数据输入(指把数据输入处理系统内部)所用的媒体和硬设备。如果只有指定的输 入点的输入才是合法的,则必须对此加以说明;c. 接受者说明输出数据的接受者;d. 输出数据的形式和设备列出输出数据的形式和硬设备。无论接受者将接收到的数据 是打印输出,还是CRT上的一组字符、一帧图形,或一声警铃,或向开关线圈提供的一个 电脉冲,或常用介质如磁盘、磁带、穿孔卡片等,均应具体说明;e. 数据值的范围给出每一个数据元的合法值的范围;f. 量纲给出数字的度
44、量单位、增量的步长、零点的定标等。在数据是非数字量的情况 下,要给出每一种合法值的形式和含意;g. 更新和处理的频度给出预定的对输入数据的更新和处理的频度。如果数据的输入是 随机的,应给出更新处理的频度的平均值,或变化情况的某种其他度量。3. 2输人的承担者说明预定的对数据输入工作的承担者。如果输入数据同某一接口软件有关,还应说明该 接口软件的来源。3. 3预处理对数据的采集和预处理过程提出专门的规定,包括适合应用的数据格式、预定的数据通 信媒体和对输入的时间要求等。对于需经模拟转换或数字转换处理的数据量,要给出转换方 法和转换因子等有关信息,以便软件系统使用这些数据。3. 4影响说明这些数据要求对于设备、软件、用户、开发单位所可能产生的影响,例如要求用户 单位增设某个机构等。附录4-6项目开发总结报告I引言1. 1编写目的说明编写这份项目开发总结报告的目的,指出预期的阅读范围。1. 2背景说明:a. 本项目的名称和所开发出来的软件系统的名称;b. 此软件的任务提出者、开发者、用户及安装此软件的计算中心。I. 3定义列出本文件中用到的专门术语的定义和外文首字母组词的原词组。1. 4参考资料列出要用到的参考资料,如:a. 本项目的已核准的计划任务书或合同、上级机关的批文;b. 属于本项目的其他已发表的文件;c. 本文件中各处所引用的文件、资料,包括所要用