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