GJB438B军用软件开发文档通用要求.ppt

单击此处编辑母版标题样式,单击此处编辑母版文本样式,第二级,第三级,第四级,第五级,*,GJB438B,概述,GJB438B,课题组,2010.07,1,提纲,背景,全貌,适用范围,一般要求,详细要求,2,修订背景,随着装备信息化迅速发展，装备中计算机软件的种类、规模、以及安全、保密等属性的要求都迅速增加或提高。实践中许多军用软件开发者感到,GJB 2786,武器系统软件开发,存在一些问题，如：,比较适合于采用结构化软件开发方法和瀑布式开发模型，缺乏灵活性；,对于大型信息系统的软件开发缺少有关规定（如：对于需求逐步明确的情况、数据库设计和实现）；,对上个世纪九十年代以后广泛采用的软件工程有关要求、技术和方法未明确涉及，如软件开发策划和跟踪、测量和分析、质量保证、软件重用等。,软件质量管理规定和,GJB5000,的贯彻实施，促使军用软件有关各方对软件工程化和软件过程改进的认识有很大提高。同时，也感到,GJB 2786,在有些方面还没有明确支持，或不够协调。,3,修订背景（续,1,）,软件文档是整个软件开发工作的重要产品，是实行管理、监督、控制软件开发的重要的方式。,软件文档把软件开发过程中的一些,不可见,的事物转化成为,可见的,文字资料，便于管理人员在各个阶段检查开发计划的进展情况，以提高软件生产过程的可见性和可控性。,软件文档作为软件产品的一部分，文档的质量在很大程度上决定了软件的质量。,软件的种类、文档的多少、文档的内容要求，对软件开发效率、开发成本以及将来的维护都产生重要的影响。,在软件开发中不论是软件承制方还是软件订购方对文档都极为重视。,4,修订背景,（续,2,）,GJB 2786A,军用软件开发通用要求,在修订过程中，主要以,MIL-STD-498,“,软件开发与文档编制,”,的框架为参考，并增加相关的软件工程实践。,因此，与之配套的文档类型、内容和形式上都要相应发生变化。,需要对,GJB 438A,进行修订，保留其有效方面，改进其不足之处，以适应当前我军装备软件研制的需要。,5,GJB 438B,更名原因,本标准是与,GJB 2786A,（修订中）配套使用,GJB 2786,在修订过程中，专家建议将名称改为,军用软件开发通用要求,本标准修订时也将名称作了相应变化，改为,军用软件开发文档通用要求,。,6,概貌,第,1,章,范围,第,2,章,引用文件,第,3,章,术语、定义和缩略语,第,4,章,一般要求,第,5,章,详细要求,附录,28,个附录,7,适用范围,在,GJB 438B,范围一节中明确指出：本标准规定了军用软件开发文档编制的种类、结构、格式和内容等要求。,本标准适用于军用软件开发过程中文档的编制。,而在,GJB2786A,的范围一节中指出，该标准规定了军用软件开发的通用要求，包括软件开发过程的开发、支持和管理等方面的要求。,本标准适用于需方和开发方获取、开发及维护军用软件（含固件中的软件）。,8,适用范围（续,1,）,本标准中所涉及的,“,系统,”,有两类：,一类是硬件软件系统（例如一个雷达系统），对于这种系统，本标准只适用于系统中的软件部分；另一类是软件系统（例如一个地理信息系统），对这类系统，本标准适用于其整个系统。,本标准规定了执行,GJB2786A,所产生的军用软件开发文档，适用于军用软件开发过程中文档的编制。,9,GJB438B,其他说明,本标准代替,GJB 438A-1997,。,与,GJB 438A-1997,相比，本次修订将标准的名称更改为,军用软件开发文档通用要求,。,依据,GJB 2786A,，从软件开发和管理的角度，规定了相应的文档编制要求。,考虑承研单位的实际要求，对测试计划的部分内容也进行了充实和调整。,10,文档编制,文档的内容是根据,GJB 2786A,各活动描述的工作任务而产生的，描述了军用软件开发过程中的主要活动信息和要求。,开发方应按照本标准的要求记录有关信息，编写有关文档，并按合同（或软件研制任务书）的要求交付。,文档若为电子文档，应规定电子文档的格式（如,DOC,文件、,PDF,文件等）。,11,软件开发活动分类,基本活动类（,18,个）,系统,需求分析,系统,设计,系统,集成与测试,系统,合格性测试,软件,需求,分析,软件,设计,软件,实现与单元测试,单元,集成与,测试,CSCI,合格性,测试,软件验收支持,支持活动类（,6,个）,软件使用准备,软件移交准备,软件配置管理,软件工作产品评价,软件质量保证,纠正措施,联合评审,测量与分析,组织活动类,（,2,个）,项目策划和监控,风险管理,分承制方管理,与,IV&V,机构联系,与相关开发方协调,保密性有关活动,软件开发环境建立,项目过程的改进,12,文档表示方式,表示形式：,为使各文档章条的信息更加清晰可读，可采用图、表、矩阵或其它形式的表示方式进行说明。,页码编制,文档正文的目录使用小写罗马数字编号；,文档正文和附录均使用阿拉伯数字顺序编号；,若一个文档分为若干卷，则每一卷应重新开始按顺序编号。,自变量：,字母,X,和,Y,为各文档小条编号的自变量。标题上圆括号中的文字在编写时要用实际内容替换。,13,文档结构,封面。,封面宜包括文档标识及版本号、密级、编制,/,修订日期、文档名称、编制单位、编写、审核、批准。,修改页。修改页应包括修改时间、修改内容以及修改人等。,目录。,目录应包括章、条、图表、注释和附录的编号、标题及其所在页码。,正文。正文为各文档的具体内容，详细要求见标准的第,5,章。,附录。,文档的附录应提供文档维护的详细信息（例如：图、表、分类数据等）。每个附录都应在文档的正文中被引用。为方便起见，附录可单独装订成册。,14,文档剪裁,承制方可根据项目所选择的,生存周期、合同（或软件研制任务书）的要求以及实际活动,，确定项目产生的文档种类，并根据实际情况对文档的种类进行,合并、拆分。,例如，可以在,软件开发计划,中描述了软件质量保证计划和软件配置管理计划的内容，也可不产生单独的,软件质量保证计划,、,软件配置管理计划,。,根据需要，也可以对,文档内容,进行剪裁。,按文档标题顺序与本标准规定的标题顺序相同的原则，若剪裁了某章条或某小条，则在被裁去的章条（或小条）的标题下将其标识为“不适用”，并说明理由。,若剪裁的是整章条（包括其所有小条），则仅需在最高层的章条标题下加以说明。,15,详细要求,该标准规定了对军用软件开发过程中主要活动产生的文档，指出哪些文档可以合并或剪裁。,下面按照,管理,和,工程,两类简要说明文档的概述和主要内容。,16,管理类文档,软件研制任务书（,SDTD,）,软件开发计划（,SDP,）,软件配置管理计划（,SCMP,）,软件质量保证计划（,SQAP,）,软件安装计划（,SIP,）,软件移交计划（,STrP,）,软件测试计划（,STP,）,软件配置管理报告（,SCMR,）,软件质量保证报告（,SQAR),17,软件研制任务书（,SDTD,）,描述软件开发的目的、目标、主要任务、功能及性能指标等要求。,18,SDTD,的主要内容,范围：,包括系统和软件的标识、系统概述和文档概述等。,引用文档。,运行环境要求：,包括硬件环境和软件环境。,技术要求：,包括软件的功能、性能、输入,/,输出、数据处理要求、接口、固件、关键性要求等。,设计约束。,质量控制要求：,包括软件关键性等级、标准、文档、配置管理、测试要求、对分承制方的要求等。,验收和交付。,软件保障要求。,进度和里程碑。,19,软件开发计划（,SDP,）,描述实施软件开发工作的计划。软件开发活动包含新开发、修改、重用、再工程、维护和由软件产品引起的其它所有活动。,SDP,是动态的，随着项目的进展，在出现重大偏差或者在里程碑处应进行分析，必要时重新策划并修订,SDP,。,根据实际需要，可将,SDP,中的某些部分编制成单独的计划，如,软件配置管理计划,、,软件质量保证计划,和,软件测试计划,等。,20,SDP,的主要内容,范围：,包括系统和软件的标识、系统概述、文档概述等。,引用文档。,策划背景概述。,软件开发活动的总体实施计划：,包括软件开发过程、软件开发总体计划、可重用的软件产品等。,详细的软件开发活动实施计划。,进度表和活动网络图。,项目组织和资源等。,21,软件配置管理计划（,SCMP,）,描述在项目中如何实施软件配置管理。,本计划既可作为,软件开发计划,的一部分，也可单独成文。,22,SCMP,的主要内容,范围：,包括系统和软件的标识、系统概述、文档概述等；,引用文档；,组织和职责：,描述软件配置管理负责人和软件配置控制委员会的组成以及他们在项目中的职责和权限；说明与项目配置管理相关人员的职责等；,软件配置管理活动：,描述配置标识、配置控制、配置状态记录与报告、配置审核以及软件发行管理和交付等五方面的软件配置管理活动的需求；,工具、技术和方法：,描述为支持特定项目的软件配置管理所使用的软件工具、技术和方法；,对供货单位的控制；,进度表等。,23,软件质量保证计划（,SQAP,）,描述在项目中采用的软件质量保证的措施、方法和步骤。,本计划既可作为,软件开发计划,的一部分，也可单独成文。,24,SQAP,的主要内容,组织和职责：,描述软件质量保证负责人在项目中的职责和权限；相应的高层经理、与软件质量保证紧密配合的项目经理的职责；部门内部软件质量保证组组长的职责和与项目软件质量保证负责人的关系等。,标准、条例和约定：,列出软件开发过程中要用到的标准、条例和约定，并列出监督和保证执行的措施。,活动审核：,描述对项目活动进行审核的方法和依据，并列出项目定义的活动以及相应的活动审核。,工作产品审核：,描述进行工作产品审核的方法和依据，列出项目过程应产生的工作产品和质量记录，以及需要由软件质量保证人员负责审核的工作产品和相应的产品审核活动。,25,SQAP,的主要内容（续）,不符合问题的解决：,描述过程评审和产品审核的记录以及形成记录的方法，并描述处理在评审和审核中出现的不符合问题的规程。,工具、技术和方法：,描述用以支持特定软件项目质量保证工作的工具、技术和方法，描述它们的用途。,对供货单位的控制：,描述对软件销售单位或软件承制方法进行控制的规程。,记录的收集、维护和保存。,26,软件安装计划（,SIP,）,描述在用户的现场安装软件的计划，内容包括准备工作、用户培训以及从现有系统进行转换。,当软件的安装需要开发人员参与，且安装过程十分复杂时，应制定该计划。,27,SIP,的主要内容,安装概述：,描述安装过程、安装地点列表、安装进度、安装方法、联系地点、保障材料、培训、软件安装过程中所涉及的各项任务、所需人员、保密性方面的考虑等。,为软件中心操作员提供特定现场信息：,描述现场安装期间要完成任务的进度表、软件清单、设施和食宿供应、安装小组的、安装规程、数据更新规程等。,软件用户的现场专用信息：,描述关于软件用户的安装计划，内容包括安装期间用户所完成任务的进度表、安装规程、用户数据更新规程等。,28,软件移交计划（,STrP,）,描述开发方向保障机构移交应交付项的计划。,如果在合同或软件研制任务书中规定了向独立保障方移交的责任，应制定,STrP,。,29,STrP,的主要内容,软件保障资源：,描述支持可交付软件所需的设施、硬件、软件及其相关的文档，描述支持可交付软件所需的人员及其它资源，并标识各部分软件保障资源之间的关系。,推荐的过程：,描述为支持可交付的软件和相关的保障环境，开发方希望向保障机构推荐的规程，包括建议和经验教训。,培训：,描述开发方关于软件交付支持人员的培训计划。,预期的更改区域：,描述可交付软件预期的更改区域。,移交计划：,描述开发方把可交付软件移交给保障机构的计划。,30,软件测试计划（,STP,）,描述对计算机软件配置项（,CSCI,）和软件系统或子系统进行合格性测试的计划。,通常每个项目都应有一个,STP,。,需方根据,STP,能够评估,CSCI,或软件系统合格性测试的策划是否充分。,31,STP,的主要内容,测试依据：,列出软件测试必须遵循的依据。,软件测试环境：,描述在各测试现场的测试活动所需的软件项、硬件和固件项等，描述网络拓扑图及所需的其它材料，描述与软件测试环境中每个元素有关的专有性质、需方权利与许可证等问题，描述开发方安装、测试和控制软件测试环境中的每一项的计划，描述拟建立的测试环境与需求环境之间的差异，描述参与现场测试的组织及职责、人员及分工，描述测试前和测试期间要进行的人员培训，标识测试现场要执行的测试等。,测试标识：,描述要执行的测试的级别、类别、一般测试条件、测试进展、数据记录整理和分析等一般信息，描述计划执行的测试等。,测试进度：,描述实施本计划中所标识测试的进度表。,测试终止条件：,描述被测软件的评价准则和方法以及结束测试的条件。,需求的可追踪性。,32,软件配置管理报告（,SCMR,）,描述软件整个研制,/,开发过程中软件配置管理情况。,33,SCMR,的主要内容,软件配置管理情况综述：,描述软件配置管理活动进展，与软件配置管理计划的偏差，软件配置管理活动与规程是否相符，对不符合项所采取的措施，完成软件配置管理工作的工作量等；,软件配置管理基本信息：,概述软件配置管理的基本信息；,专业组划分及权限分配：,列出项目专业组的划分、各专业组的成员以及各成员的权限分配；,配置项记录：,列出项目的所有配置项及配置项版本变更历史、配置项变更累计次数等内容；,变更记录：,列出软件研制过程中的所有变更；,34,SCMR,的主要内容（续）,基线记录：,列出项目的所有基线的内容及版本号等内容；,入库记录：,列出配置项的入库记录；,出库记录：,列出配置项的出库记录；,审核记录：,列出软件研制过程中所进行的软件配置审核；,备份记录：,列出软件研制过程中所做的配置库备份；,测量：,列出软件配置管理计划的版次数、配置状态记录份数、软件入库单份数、软件出库单份数、变更申请单份数、被批准的变更申请单份数、配置管理报告份数、配置审核记录份数、配置管理员工作量等。,35,软件质量保证报告（,SQAR),描述软件整个研制,/,开发过程中软件质量保证情况。,36,SQAR,的主要内容,软件研制概述：,逐项说明软件研制所经历的各项活动及其完成情况，包括软件需求分析、软件设计、软件实现和软件测试等；,软件质量保证情况：,逐项说明在保证软件质量方面所开展的各项工作及其完成情况，包括分析、评审、审查、测试、试验、软件质量保证、质量归零等；,软件配置管理情况：,描述软件配置管理活动的情况，包括与软件配置管理计划的偏差、配置管理活动与规程是否相符、对不符合项所采取的措施以及软件配置状态变化等；,第三方评测情况：,描述第三方评测工作情况和质量评价结论。,37,工程类文档,软件产品规格说明（,SPS,）,软件版本说明（,SVD,）,软件用户手册（,SUM,）,软件输入,/,输出手册（,SIOM,）,软件中心操作员手册（,SCOM,）,计算机编程手册（,CPM,）,计算机操作手册（,COM,）,固件保障手册（,FSM,）,软件研制总结报告（,SDSR),运行方案说明（,OCD,）,系统,/,子系统规格说明（,SSS,）,接口需求规格说明（,IRS,）,系统,/,子系统设计说明（,SSDD,）,接口设计说明（,IDD,）,软件需求规格说明（,SRS,）,软件设计说明（,SDD,）,数据库设计说明（,DBDD,）,软件测试说明（,STD,）,软件测试报告（,STR,）,38,运行方案说明（,OCD,）,描述系统应满足的用户需要、与现有系统或规程的关系以及使用方式等。,既可向开发者表述用户的需要，也可向用户或其它对象表达开发者的思路，以便在需方、开发方、支持者和用户代理之间，对所开发的系统的运行方案达成共识。,39,OCD,的主要内容,现行系统或状态：,描述现行系统或状态的背景、目标和范围，运行策略和约束，用户或相关人员和保障方案等，并给出现行系统或状态的具体描述。,更改理由和实质：,包括更改理由、所需更改的说明、更改的优先级别、考虑但未纳入的更改、假设和约束等。,新系统或修改后系统的方案：,描述新系统或修改后系统的背景、目标和范围，运行策略和约束，用户,/,受影响人员和保障方案等，并给出新系统或修改后系统的具体描述。,运行场景：,举例说明新系统或修改后系统的作用。,影响综述：,包括运行影响、组织影响、开发期间的影响等。,建议系统分析：,包括优点概述、缺点,/,限制概述、考虑的替代方案和权衡等。,40,系统或子系统规格说明（,SSS,）,描述系统的需求，以及确保满足各需求所使用的方法。,系统外部接口方面的相关需求，可在,SSS,中给出或在引用的一个或多个,接口需求规格说明,中给出。,SSS,可由,接口需求规格说明,补充，共同构成系统设计与合格性测试的基础。,41,SSS,的主要内容,需求：,描述系统要求的状态和方式、系统能力需求、系统外部接口需求、系统内部接口需求、适应性需求、安全性需求、保密性需求、系统环境需求、计算机资源需求、系统质量因素、设计和构造的约束、人员相关需求、培训相关需求、保障相关需求、包装需求、需求的优先顺序和关键性等。,合格性规定：,描述为确保每个需求得到满足所定义使用的方法。,需求可追踪性。,42,接口需求规格说明（,IRS,）,描述作用于一个或多个系统、子系统、硬件配置项（,HWCI,）、计算机软件配置项,(CSCI),、人工操作或者其它系统部件之间的需求，从而实现这些实体间的一个或多个接口。,一个,IRS,可以包含多个接口。,IRS,可作为,系统或子系统需求规格说明,和,软件需求规格说明,的补充，共同构成系统和,CSCI,设计与合格性测试的基础。,43,IRS,的主要内容,需求：,包括接口标识和接口图，描述为实现每个接口而提出一个或多个接口实体的需求，并描述需求的优先顺序和关键性。,合格性规定：,描述为确保每个需求得到满足所定义使用的方法。,需求可追踪性。,44,系统或子系统设计说明（,SSDD,）,描述系统或子系统的系统级或子系统级设计决策与体系结构设计。,SSDD,与其相关的,接口设计说明,和,数据库设计说明,，共同构成系统实现的基础。,45,SSDD,的主要内容,系统级设计决策：,描述系统级设计决策，即系统行为的设计决策（忽略其内部实现，从用户角度出发描述系统将怎样运转以满足需求）和其它对系统部件的选择与设计产生影响的决策。,系统体系结构设计：,包括系统部件、执行方案、接口设计等。,需求的可追踪性：,描述从本设计说明中标识的每个系统部件到相应的系统需求之间的可追踪性，从每个系统需求到相应的系统部件之间的可追踪性。,46,接口设计说明（,IDD,）,描述一个或多个系统或子系统、硬件配置项（,HWCI,）、计算机软件配置项（,CSCI,）、人工操作，或者其它系统部件的接口特性。,一个,IDD,可以描述多个接口。,IDD,可作为,系统或子系统设计说明,、,软件设计说明,和,数据库设计说明,的补充。,IDD,与其相关的,接口需求规格说明,可用于接口设计决策的交流和控制。,47,IDD,的主要内容,接口设计：,包括接口标识和接口图，并描述接口实体的单方或双方的接口特性等。,需求的可追踪性：,描述从本文档中每个接口实体到相应的系统或计算机软件配置项需求之间的可追踪性，从影响本文档接口的每个系统或计算机软件配置项需求到相应接口实体之间的可追踪性。,48,软件需求规格说明（,SRS,）,描述对计算机软件配置项（,CSCI,）的需求，及确保满足每个需求所使用的方法。,与,CSCI,外部接口有关的需求既可在本,SRS,中描述，也可在本,SRS,引用的一个或多个,接口需求规格说明,中描述。,SRS,可由,接口需求规格说明,补充，共同构成,CSCI,设计与合格性测试的基础。,49,SRS,的主要内容,需求：,描述,CSCI,要求的状态和方式、,CSCI,能力需求、,CSCI,外部接口需求、,CSCI,内部接口需求、,CSCI,内部数据需求、适应性需求、安全性需求、保密性需求、,CSCI,环境需求、计算机资源需求、软件质量因素、设计和实现约束、人员需求、培训需求、软件保障需求、验收交付和包装需求、需求的优先顺序和关键程度等。,合格性规定：,描述为确保每个需求得到满足所定义使用的方法。,需求可追踪性。,50,软件设计说明（,SDD,）,描述计算机软件配置项（,CSCI,）的设计，,SDD,的内容包括计算机软件配置项（,CSCI,）级设计决策、计算机软件配置项（,CSCI,）体系结构设计（概要设计）和实现该软件所需的详细设计。,SDD,与其相关的,接口设计说明,和,数据库设计说明,，共同构成软件实现的基础。,51,SDD,主要内容,CSCI,级设计决策：,描述,CSCI,级设计决策，即,CSCI,行为设计的决策和其它影响组成该,CSCI,的软件单元的选择与设计的决策。,CSCI,体系结构设计：,包括,CSCI,部件、执行方案、接口设计等。,CSCI,详细设计：,对软件单元进行说明。,需求可追踪性,。,52,数据库设计说明（,DBDD,）,描述数据库的设计以及存取或操纵数据所使用的软件单元。,DBDD,是实现数据库及相关软件单元的基础。,53,DBDD,主要内容,数据库级设计决策：,描述数据库级设计决策，即数据库的行为设计决策以及其它影响数据库进一步设计的决策。,数据库详细设计：,标识数据库设计级别，描述数据库的数据元素和数据元素集合。,用于数据库访问或操纵的软件单元的详细设计：,标识软件单元，并对该单元进行说明。,需求可追踪性。,54,软件测试说明（,STD,）,描述执行计算机软件配置项（,CSCI,）、软件系统或子系统合格性测试所需的测试准备、测试用例及测试过程。,需方根据,STD,可评估所执行的合格性测试是否充分。,55,STD,的主要内容,测试准备：,描述各测试项测试所需的硬件准备、软件准备和其他人员活动、准备工作或规程过程等。,测试说明：,标识各测试项的测试用例所涉及的,CSCI,需求或系统需求、执行测试用例前必须建立的先决条件、测试用例所需的测试输入、预期的测试结果、用于评价测试用例的中间和最终结果的准则、测试用例的测试过程、任何假设以及系统或测试条件给测试用例带来的约束或限制等。,需求的可追踪性。,56,软件测试报告（,STR,）,是对计算机软件配置项（,CSCI,）、软件系统或子系统进行合格性测试的记录。,需方根据,STR,可评估测试及其结果。,57,STR,的主要内容,测试结果概述：,描述对被测试软件的总体评估，给出测试环境与操作环境的差异及这种差异对测试结果的影响进行的评估，对被测试软件的设计、操作或测试提供改进建议。,详细测试结果：,描述对各测试项的测试结果的总结，描述与该测试相关联的每个测试用例的完成状态，标识遇到的问题和与测试用例,/,过程的偏差等。,58,软件产品规格说明（,SPS,）,描述或引用可执行软件、源文件以及软件保障信息。,SPS,的内容包括,“,已建成,”,CSCI,的设计信息，以及编译、构建和修改规程等。,SPS,可用于为,CSCI,订购可执行软件和（或）源文件，是,CSCI,的主要软件保障文档。,59,SPS,的主要内容,需求：,给出,CSCI,的可执行软件、,CSCI,的源文件、将,CSCI,拷贝打包和加标记的需求。,合格性规定：,描述用于证明指定软件实体是,CSCI,有效拷贝所使用的方法。,软件支持信息：,描述,“,已建成,”,CSCI,设计的信息，描述从源文件创建可执行文件和准备向固件或其它分布媒体中加载可执行文件所要使用的编译,/,建立过程，描述修改,CSCI,必须遵循的过程，描述,“,已建成,”,CSCI,对计算机硬件资源的实际使用情况。,需求的可追踪性。,60,软件版本说明（,SVD,）,标识并描述由一个或多个计算机软件配置项（,CSCI,）组成的软件版本，用于发布、追踪以及控制软件版本。,61,SVD,的主要内容,版本说明：,列出构成所发布软件的所有物理媒体和有关的文档、构成所发布软件版本的所有计算机文件，给出记录当前的软件版本自上一个版本后引入的所有更改列表，标识或引用包含在软件版本中的所有场地的唯一数据，列出与所发布软件有关但未包含在其中的所有文档，描述软件安装的有关说明、软件版本在发布时可能发生的问题和已知的错误等。,62,软件用户手册（,SUM,）,描述操作该软件的用户如何安装与使用计算机软件配置项（,CSCI,）、相关的,CSCI,、软件系统或子系统。,SUM,可能还包括软件运行的某些特殊方面，如特定位置或任务的说明等。,若软件由用户运行并且具有用户接口以获取联机用户输入或解释输出显示，则需要,SUM,。,如果软件是一个硬件,-,软件系统中的嵌入式软件，则该系统的用户手册或操作手册可能包括了,SUM,的内容，不必再 单独编制,SUM,。,本文档也可代替,软件输入,/,输出手册,和,软件中心操作员手册。,63,SUM,的主要内容,软件综述：,简要说明软件预期的用途，标识使软件运行而必须安装的所有软件文件，描述用户安装并运行该软件所需的硬件、软件、手工操作和其它的资源，简要描述软件的组织与操作，说明在紧急时刻以及在不同运行状态和方式下用户处理软件的差异，描述与软件有关的保密性考虑，给出帮助和问题报告等方面的信息。,软件入门：,描述软件的首次用户熟悉设备、访问控制、安装和设置等方面的信息，描述开始工作的步骤以及用户如何停止或中断软件的使用；,使用软件指南：,向用户提供使用软件的过程，提供软件使用概述，描述软件使用的任何约定，处理过程，描述创建和保留备份数据的过程，给出从处理过程中发生的错误或误操作中重启或恢复的详细步骤以及确保紧急时刻运行的连续性的详细步骤，列出完成用户功能时可能发生的所有错误消息，诊断消息和信息消息等。,64,软件输入,/,输出手册（,SIOM,）,是为安装在计算机中心或在其它集中式或网络化安装场所的软件系统而编制的，用户通过终端或个人计算机访问该系统，或者以批处理方式或以交互的方式提交输入和解释输出。,SIOM,常与,软件中心操作员手册,一起使用，此时可代替,软件用户手册,。,65,SIOM,的主要内容,软件环境：,简要说明软件预期的使用、软件清单、访问和使用该软件所需的软件环境，描述软件的组织与操作，描述在紧急时刻以及在不同运行状态和方式下用户处理该软件时的差异，描述与软件使用相关的保密性考虑、帮助和问题报告方面的信息。,使用软件：,启动软件所必须遵循的过程、准备软件的每种类型或类别的输入时遵守的条件、使用的布局格式、应遵守的规则和约定、必须使用的合法字符组合或编码等，描述每一类型或类别输出信息、布局、出现在输出中所有编码或缩略语，描述输出的使用，列出软件产生的错误代码描述用户应采取的纠正动作，描述针对通信确认和问题识别与分类方面用户可用的诊断过程。,查询过程：,描述能被查询的数据库,/,数据文件的内容与格式的用户视图、软件提供的预排程序的查询能力和特别的查询能力、对查询准备的说明，提供抽取查询请求响应所需要的运行序列和其他动作的指令。,用户终端处理过程：,分条向用户提供使用终端完成处理的信息，包括可用的能力、访问过程、显示更新和检索的过程、恢复和错误纠正过程、结束过程等。,66,软件中心操作员手册（,SCOM,）,是为计算机中心或在其它集中式或网络化的安装场所工作的人员，提供如何安装和操作软件系统的信息而编制的。,用户通过终端或个人计算机访问该系统，或以批处理方式或以交互的方式提交和接受输入与输出。,SCOM,常与,软件输入,/,输出手册,一起使用，此时可代替,软件用户手册,。,67,SCOM,的主要内容,软件综述：,简要说明软件预期的用途，标识使软件运行而必须安装的数据库和数据文件，描述用户安装并运行该软件所需的硬件、软件、手工操作和其它的资源，简要描述软件的组织与操作，说明在紧急时刻以及在不同运行状态和方式下用户处理软件的差异，描述与软件有关的保密性考虑，给出帮助和问题报告等方面的信息。,安装和设置：,描述在设备上安装、配置本软件，删除或覆盖旧版本的文件或数据，输入软件运行所需的参数时必须执行的规程。,运行描述：,描述要执行的运行，包括运行清单、阶段划分、诊断过程、错误信息列表、每个运行的说明等。,68,计算机编程手册（,CPM,）,为程序员描述对指定计算机进行编程所需要的信息。,69,CPM,的主要内容,软件编程环境：,描述计算机系统的部件和配置情况，描述计算机系统的操作特性、能力和限制，描述在计算机系统上执行编译与汇编所需要的设备。,编程信息：,描述计算机指令集体系结构的编程特征、计算机系统的每条指令、输入和输出控制信息，描述与计算机系统有关的附加的、受限的或专用的编程技术，举例说明上面的编程特性，描述与计算机系统相关的错误检测和诊断特性等。,70,计算机操作手册（,COM,）,描述操作指定的计算机及其外部设备所需要的信息。,71,COM,的主要内容,计算机系统操作：,描述计算机系统的加点和断电的操作规程，操作规程，问题处理规程等。,诊断特征：,概述计算机系统的诊断特征、相应 的诊断规程、诊断工具等。,72,固件保障手册（,FSM,）,描述对系统的固件设备进行编程和再编程所需的信息，也描述为擦除固件设备、向固件设备加载软件、验证加载过程和标记已加载的固件设备所需的固件设备和装备、软件以及规程，适用于只读存储器（,ROM,）、可编程,ROM,（,PROM,）、可擦除,PROM,（,EPROM,）以及其它固件设备。,73,FSM,的主要内容,固件编程指令：,针对系统中要使用的各被编程固件设备，应描述其预编程设备、写入设备的软件、编程设备、编程软件、编程规程、安装和修复规程、供应商信息等。,74,软件研制总结报告（,SDSR),描述软件用途、主要功能、运行情况以及整个研制过程。,75,SDSR,的主要内容,任务来源与研制依据。,软件概述：,说明软件用途，主要功能、性能要求，软件运行依附的设备的外部逻辑关系，软件系统内部多个计算机软件配置项之间的构成关系，及其开发语言、开发平台、运行平台、代码规模、软件版本、软件关键性等级等信息。,软件研制过程：,描述软件研制过程开展工作情况，描述软件参加系统联试、试验考核等情况，描述功能和性能指标、软件需求（含接口需求）、软件设计、软件代码的重大变更情况，描述软件研制各活动所采用的方法和工作产品。,76,SDSR,的主要内容（续）,软件满足任务指标情况：,描述软件任务所要求的功能和性能指标，并根据软件测评和软件试验的结果，逐项说明指标的满足情况。,质量保证情况：,描述质量保证措施实施情况、软件重大技术质量问题和解决情况等。,配置管理情况：,描述需方对软件配置管理的要求以及分承制对软件配置管理的要求，说明软件配置管理实施情况、软件配置状态变更情况。,测量和分析：,给出对开发期间产生的数据汇总和分析。,结论：,评述软件工程化实施情况，说明软件功能和性能指标是否满足软件任务的要求，给出软件是否可以交付需方使用的结论。,77,附录,附录包括上述文档的模板。,78,GJB438B,的特点,GJB438B,符合,GJB2786A,标准，可满足了执行,GJB2786A,所产生的军用软件开发文档的要求，适用于军用软件开发过程中文档的编制。,该标准在考虑软件定型、,GJB5000A,有关要求的基础上，增加了软件研制任务书、软件质量保证计划、软件配置管理计划、软件研制总结报告等文档，并在软件开发计划、软件质量保证计划、配置管理计划中，对,GJB5000A,二级有关要求，给予了适当考虑和体现。,此外，该标准还对原,GJB 438A,内容进行了调整，将文档要求部分作为一般要求和详细要求，删除了文档的目录格式部分，将文档的内容正文格式作为附录处理。,79,新旧版本的差异,文档种类的变化。,从,GJB 438A,的,16,个增加到,28,个，如在文档中增加了软件研制任务书，对其内容进行了描述和说明，以满足各方的需要，删除了的,GJB 438A,的系统和段设计文件。,文档格式的变化。,在标准的详细要求中，增加了文档的用途和简要说明，删除了,GJB 438A,各文档的目录格式部分。对原,GJB 438A,内容进行了调整，将文档要求部分作为一般要求和详细要求，将文档的内容格式作为附录处理。,从篇幅的精炼方面考虑，将各个文档模板最后的附录内容，统一放到正文的说明中。本标准对文档的封面需要描述的项目提出了要求，对于排版样式未作统一要求。,对文档种类及剪裁要求进行了描述，应根据要求的活动产生相应的文档。,80,GJB438B,与,GJB438A,比较,438A,438B,1,系统,/,段设计文档,系统,/,子系统设计说明,系统,/,子系统规格说明,运行方案说明,软件研制任务书,2,软件开发计划,软件开发计划,软件配置管理计划,软件质量保证计划,软件安装计划,软件移交计划,3,软件需求规格说明,软件需求规格说明,4,接口需求规格说明,接口需求规格说明,5,软件设计文档,软件设计说明,数据库设计说明,6,接口设计文档,接口设计说明,7,软件产品规格说明,软件产品规格说明,81,GJB438B,与,GJB438A,比较,（续,1,）,438A,438B,8,版本说明文档,软件版本说明,9,软件测试计划,软件测试计划,10,软件测试说明,软件测试说明,11,软件测试报告,软件测试报告,12,计算机系统操作员,软件输入,/,输出手册,软件中心操作员手册,13,软件用户手册,软件用户手册,计算机操作手册,14,软件程序员手册,计算机编程手册,15,固体保障手册,固件保障手册,16,计算机资源综合保障文档,软件配置管理报告,软件质量保证报告,软件研制总结报告,82,GJB438B,与,GJB438A,比较,（续,2,）,基本思路改变：,区别自然工作产品与可交付文档,关注自然工作产品，而非文档；,要求,定义和记录,活动所产生的信息，该信息以其,自然形式,（即自然工作产品）提供即可，而不要求编写给定的文档,关注实际,策划和工程,工作，,记录,这些工作所产生的,有关信息；,要求确实进行这些工作，所记录的信息可由需方方便地访问；但无必要时不要求将记录变成可交付物,文档说明,是检查单,，是对相关活动的充分定义，帮助检查工作的完整性,信息记录的,形式和载体灵活多样,，以便于使用和节省为准；,而,交付的文档（种类、内容和形式）,则,由合同规定。,83,5000A,过程分类,分析、,设计和实现,组织,过程定义,项目监控,组织,培训,配,置,管,理,验证,过程和,产品质量保证,确认,测,量,与,分,析,项目,策划,风险管理,供方协议管理,集成项目管理,组织,过程焦点,制度化要求,定量项目管理,决策分析和决定,需求,开发,技术解决方案,原因分析和,决定,组织,过程绩效,组织,创新和部署,产品集成,需求,管理,84,制度化说明,制定组织,方针,策划,过程,提供,资源,指派,职责,培训,人员,管理,配置,标识并吸纳,利益相关方,监督,并控制过程,客观,评价,遵循性,与更高层管理者一起,评审,状态,建立已,定义过程,采集,改进信息,计划,唇枪舌战,.,85,438B,对,500,0A,的支持,工程文档支持技术解决方案,管理类文档进行适当扩充,86,谢谢！,87,