软件开发和文档编制管理程序文档格式.docx

1、 f、定期填报工作进度，若进度计划需修改，应在报表中申述（进度报表既可按月也可按项目分阶段填报）。 软件的交付管理按版本启用/存档细则执行。 软件版本管理5.8.1 应顾客需要进行软件版本升级或修订时，设计部门负责人确定项目负责人，组织软件人员实施。5.8.2 软件负责人发出版本送检（启用）通知单升级的版本由物流部组织检测合格后，由软件负责人将新版本存入标准档案室；并在版本档案中详细记录升级内容，存入项目档案中。5.8.3 技术人员在为顾客服务的现场，遇到需要版本修订时，应先电告项目负责人，经认可后，回厂填写用户服务档案，必要时项目负责人应组织评审和检测。 文档要求5.9.1 各阶段需具备的基

2、本文档及文档格式（见附录） 鉴定需具备的文档参见附录。6 支持文件7 记录 质量记录 7.1.1 JL/ 版本启用通知单 7.1.2 JL/ 用户服务档案 7.1.3 JL/ 软件测试修改单 以上记录由标准档案室保存三年。 工作记录 7.2.3 版本档案 以上记录由标准档案室保存三年。 附录 附录一：软件产品文件表附录二：版本启用/存档实施细则附录三：概要设计说明书附录四：需求说明书附录五：软件开发规范附录六：程序设计若干规定附录一：序号文 件 名 称文件简号产 品产品的组成部门成套软件整 件软 件1任务委托书RW2可行性研究报告KY3软件需求说明RX4数据要求说明书SY5项目开发计划XK6G

3、S7详细设计说明书QS8数据库设计说明书SG9测试计划CJ10程序CX11测试分析报告CF12用户手册YS13操作手册CS14程序维护手册CW15项目开发总结报告XZ16使用报告SB17产品标准18媒体内程序/数据目录MM19成套软件明细表MX20整件明细表21成套运用文件清单YQ22整件汇总表ZH23鉴定报告JB24用户反馈信息YX25维护记录文件WJ26版本更新通知BT注：表示必须编制的文件；表示可根据产品的需要制定。湖南计算机股份有限公司用户服务档案JL/出 差 人出差时间出差地点用户名称产品名称版 本 号实际费用（元）使用的系统环境：发现的问题：解决情况：改动的程序模块：用户意见：办事

4、处意见：处理结果（回厂后经协调或评审结论）：版 本 档 案（工作记录） 编号：版本号版本适用范围源 版 本取代版本号版本源程序压缩文件名代 码 和提 交 人提交时间存档日期配备的输入方法：修改记录：备注：软 件 测 试 修 改 单 JL/软件名称测试人日 期测试问题： 测试人： 日 期：原因分析： 签 字：纠正措施：回归测试：审批意见： 批准人：为了规范版本的管理，减少版本的数量，文档资料的管理和保存，文档的及时更新，以及便于电子化的管理和规范工作流程，特制定该实施细则。一、工作流程和任务:说明：1. 内部测试：进行白盒测试，要求对源程序进行检查，分析出可能影响的模块，并对相应的模块进行测试。

5、2. 外部测试：进行黑盒测试，对整个系统进行测试。3. 审核：检查文件的完整性和正确性。4. 资料审查：检查文件的完整性和格式的正确性。5. 批准：审查该版本是否可以发行。委派他人对提交的文档进行抽查，验证其正确性和完备性。6. 编号、录入数据、刻盘：光盘的卷标为8位数字的序列号，在根目录下建立以版本编号为名称的子目录，所有提交的文档资料存放在该子目录中。版 本 启 用 通 知 单名称编号状态配套版本简要描述日期光盘编号提交人被取代的版本编号验证码适用范围编制人资料审查复制要求修改的原因不能合并的原因测试结果审核意见批准意见栏目描述填写人备注要求填写产品的全称由项目编号+分模块编号+序列号构成

6、项目编号由4位数字构成，分模块编号由2位数字构成，序列号由4位构成该版本批准后，编写编号档案管理员提交的日期负责检查提交文件的完整性，并将版本启用单录入计算机要求复制时能验证版本正确性的关键数据（代码和、文件长度等）对该版本的简单描述由8位数字序列号构成负责提交所有的文件主要设计者适应范围描述适用的用户和机器的批次作废/使用编写该程序的人员签名对提交的文件负责对被取代版本已发行产品的处理意见和该版本的使用时效项目负责人技术部经理修改原因写明改正了的错误或新增的功能在原来的版本基础上产生了一个新版本时，但应又不能取代原来版本时，必须说明原因。复制要求说明发行版本的格式，版本载体的类型（介质），复

7、制的设备，复制的特殊要求当一个产品需要几个软件构成，必须主要与该版本配套的版本的编号，或关系用“/”隔开，与关系用“，”隔开不能少于两人测试该版本的所有人员的名单，要求签名概 要 设 计 说 明 书概述介绍该项目的名称、任务提出者、提出的背景，应用的目标。功能和性能对照软件需求说明书，来说明系统是如何满足功能和性能需求的。开发工具和平台描述采用何种操作系统平台、何种编程语言、开发工具进行开发。总体结构设计用图表和文字方式说明该系统由几个模块构成，各模块的功能、各模块之间的关系。用数据流图描述出数据在该系统中的流动过程，在各模块输入前和输出后数据的变换。用程序流程图描述出主要功能的实现方式。接口

8、设计外部接口说明该系统同外部所有的接口安排，包括硬件接口、软件接口、用户接口。内部接口说明该系统内部各个模块之间的接口安排。系统数据结构设计逻辑数据结构设计给出该系统内所使用的每个数据项、记录、文件的标识、定义、长度以及他们之间的相互关系。物理数据结构设计给出系统中的数据的存储要求和访问方式、和存储介质。系统出错处理设计出错信息用表格形式列出每种可能的出错或故障情况出现时，系统输出信息的形式、含义及处理方法。补救措施说明故障出现后可能采取的变通措施，如后备技术、降效技术、恢复及再启动技术等。系统维护设计说明为了系统维护方便而在程序内部设计中作出的安排，如在程序中专门安排用于系统的检查与维护的检

9、测点和专用模块。关键的技术和难点描述开发该系统采用的关键技术和难点，对关键技术和难点作出风险评估，要求作出相应的解决对策，或提出其他的解决方案。交付方式交付的内容全部的设计文件、发行版本、源程序交付的媒体介质纸质文件、电子文件、CD、FLASH、软盘需 求 说 明 书简介介绍该项目的名称、任务提出者、提出的背景，应用的目标详细需求环境需求硬件环境 描述运行该软件需要的设备能力 处理器的速度、数量和内存容量 存储媒体的容量 输入、输出设备的种类和数量 通讯网络软件环境运行该软件需要的操作系统、数据库软件、以及相应的其他应用软件人员环境操作该软件对人员的要求，人员的素质、数量功能需求对系统中每一个

10、功能，要求用图示或文字详细描述：概述叙述功能名称、目标和作用输入详述该功能输入的信息处理描述该功能作什么，如何对输入信息进行加工并转换成输出信息输出详述该功能输出的信息内部生成数据列出用户所关心的内部生成数据性能需求定量的描述该软件系统应满足的具体性能需求精度说明该软件系统的精度要求，如： 数据的精度要求 数字计算的精度要求 数据转送的误码率要求时间特性说明该软件系统的时间要求，如： 解题时间 询问和更新数据文件的响应时间 系统各项功能的顺序关系 由于输入类型的不同和操作方式的变化而引起的优先顺序 在峰值负载期，与所规定的响应时间的允许偏离范围灵活性说明当需求发生某些变化时该软件系统的适应能力

11、，指出为适应这些变化而需要设计的软件成分和过程输入和输出描述输入和输出的每个数据元素，对每个数据元素可列出如下信息： 数据元素名 同义名 定义 格式 值域 度量单位 数据项名、缩写词和代码对于输入数据，还要说明时间要求、优先顺序和输入媒体。对于输出数据，亦要说明时间要求、优先顺序和输出形式，并要描述对特殊输入输出项的保密要求和措施。数据库特性详细描述数据库中要用到的每个数据元素，对每个数据元素可列出如下信息：要根据记录的规模和数量来估计数据存储要求，并要预测数据的增长率。故障处理列出在该系统出现故障时，为满足信息处理要求而可能采取的技术措施，如： 后备技术 低效技术 再启动技术接口说明该软件系

12、统与其他系统和子系统的接口软件接口和硬件接口安全和保密说明该软件系统在安全和保密方面的要求软 件 开 发 规 范软件开发的流程和需要的文档资料同项目开发类似，在第 章中有详细的描述，在这不再作介绍了，仅介绍与软件紧密相关的常用文档资料的格式模板，以及编程设计中的若干规定常用文档的格式模板流程图国家标准GB1526-89信息处理数据流程图、程序流程图、系统流程图、程序网络图和系统资源图的文件编制符号及约定规定了信息处理文件使用的各种符号及其使用的具体约定。要求采用VISIO或SMARTDRAW软件绘制流程图。流程图所用符号及其简要说明符号符号名简要说明备注数据表示数据，其中可注明数据名、来源、用

13、途或其他的文字说明。此符号并不限定数据的媒体处理表示各种处理功能。符号内可注明处理名或其简要功能既定处理表示已命名的既定处理。该处理为在另外地方已得到详细说明的一个操作或一组操作。例如子程序、函数、模块。准备表示修改一条指令或一组指令以影响随后的活动。例如：设置开关、修改变址寄存器、初始化例行程序判断表示判断或开关。符号内可注明判断的条件，它只有一个入口，但可以有若干可以选择的出口。在对符号内的条件求值后，有一个且只有一个出口被激活。求值结果可在表示出口路径的流线附近写出并行处理表示同步进行两个或两个以上并行方式的操作。循环界限循环界限由上界限和下界限构成，分别表示循环的开始和结束。流线表示控

14、制流的流向虚线用于表明被注解的范围或连接被注解部分与注解正文连接符用于表明转向流程图的它处，或从它处转入。它是流线的断点。在圆内注明某一标志符，表明该流线将在具有相同标志符的另一连接符处继续下去。端点符程序流程的起点或结束注解符表示注解的内容，虚线须连接到被注解的符号或符号组合上。省略符若流程图中有些部分无需给出符号的具体形式和数量，可用省略符。省略符应夹在流线符号之中。使用约定图的布局流程图所用的符号应该均匀分布，连线保持合理的长度，并尽量少使用长线。符号标志符这是赋予某个符号的标志符，其作用是便于其他文件中引用该符号。符号标志符要写在符号的左上角。符号描述符它用于交叉引用，表达一个符号的特

15、殊用途，或者进一步理解某个符号的功能。描述符要写在符号的右上角。连接的约定 标准流向从左至右，自上而下 箭头的使用可随时在流线上使用箭头指示方向，当流程不是标准流向时，一定要采用箭头来指示方向。 流线的交叉应当尽量避免流线的交叉，即使出现，交叉的流线之间没有任何逻辑关系，不对流向产生影响。 流线的汇集两根或更多的进入线可以汇集为一根输出线，各连接点应相互错开以提高清晰度，并在必要时使用箭头表示流向。 互连一般情况下，流线应从符号的左边或顶端进入，从右边或底端离开。它们都应对准符号的中心。 多出口一个符号如有多个出口，应按下述方式表示，在每个出口都应标有适当的条件值，以反映它所表示的逻辑路径。数

16、据结构结构名称名 称定 义描 述使用特点数据字典数据字典和数据结构图可形成交互参照关系定义项目计划表要求采用PROJECT软件制作，大致格式如下：项目名称标识号任务工期开始时间完成时间提交件负责人拟制： 校对： 审核： 批准： 第 页函数/过程接口函数名：必须与源程序中的一致，包括大小写功能：简要说明该函数/过程实现的功能，以及主要的算法，对重要的函数/过程可采用伪语言进行描述入口参数：对入口参数作简要的说明，利用全局变量，则也要说明出口参数：对出口参数作简要的说明，改变了全局变量，则也要说明返回值：对函数的返回值说明其类型和作用程序设计的若干规定这里例举了C语言和汇编语言的规定，其他编程语言

17、应参照这些规定编写C语言见附录六汇编语言程 序 设 计 若 干 规 定引言本文档描述了项目开发中的编程标准，其目的是提供一个编程的严格规则，使得程序有统一的风格，以便于理解和维护，项目主要由C语言和汇编语言编写.产生新代码图D-1描述了产生C语言新代码的格式，在写新代码之前，程序员必需首先将拷贝到新文件中，然后编辑新文件以提供下列信息.目的提供一个关于程序的简要描述.版本状态给出当日的日期，程序员姓名，创建或修改.输入列出及描述所有该程序将输入的变量，描述应简要而完全，有必要要描述一个组中不同的元素，或者一个词的字节或位，如果没有输入变量,则键入none.输出列出及描述所有该函数的输出变量，同

18、时描述副作用，如果有的话.限制简要说明程序的限制，例如数组长度，算法等等，同时给出对未来版本的建议，如果没有限制，给出“none”错误信息描述出错信息或在出错时变量的置值，如果没有的话给出“none”.方法简单描述程序中所有调用的算法及方法，如果方法很明显，则删去这一项，如果应用了复杂的算法或方程式，请给出解释及参考.外部变量描述仅列出及描述那些一般不为人所知的变量，如果该函数不用任何外部变量，给出“none”.局部、静态、寄存器变量描述列出及描述局部，静态寄存器变量，如果一个变量的用途可从其它变量名中明显地看到，则不必给出解释，变量名按字典顺序列出. /* * 本程序属于XXXXXXXXX（

19、公司名）.作为商品机密 * * 版权所有,未经许可不得公布或使用. * *. 目的- 函数的功能描述. 版本状态- 11-7-90（程序员姓名）新代码. 输入- 列出所有输入变量和解释. 输出- 列出所有输出变量参数返回值及解释. 限制- 给出使用的算法和处理方法. 错误信息- 描述错误信息. 方法- 该函数中用的算法和处理方法. 函数调用- 列出调用的函数. 外部变量- 描述所有使用的外部变量. 局部变量- 描述局部变量. */图 D-1 C标准格式（in “”）改旧代码在函数头上的所有必要的信息必须修改, 版本状态必须包含版本日期, 程序员姓名, 以及版本的简要描述, 这种描述必须规格化,

20、 而且要包含足够的信息, 以便于对这些修改进行回溯. 版本状态列出的顺序必须使得最新的版本列在最上边. 所有其它的信息包括输入、输出、限制、以及函数调用等等, 必须与最新的版本保持一致.编程常规下面说明了C语言指令中的标准结构:程序设计风格 通过空格和空行, 使程序有层次感, 便于阅读. 提倡使用C+的语法和程序结构. 所有代码必须是小写字符, 以下的例外: 1。常量或宏（用#define 或 #typedef 在include文件中定义的）必须用大写字母. 2。在编译或连接器中要求大写的标识符或库函数名. 3。该文本中说明的其它必须大写的字母. 代码尽可能写得简单、清晰、将复杂语句切成几个简单的语句以增加可读性. 一般将子程序限制在100行以内. 对于一个程序只允许一个入口和出口（在有出错处理等情况下可能允许有若干个出口）. 设计的子程