ＵＤＣ 狐 中华人民共和国行业标准 ＳＨ／Ｔ３９０１一１９９４ Ｐ 　　　　　　　　 工 程 设 计 计算机软件开发及文档编制规范 Ｐｒｏｃｅｄｕｒｅ　 ｆｏｒ　 ｃｏｍｐｕｔｅｒ　 ｓ ｏｆｔｗａｒｅ ｄｅｖｅｌｏｐｍｅｎｔ　 　　 ａｎｄ　 ｄｏｃｕｍｅｎｔ ａｔｉｏｎ １ ９９ ４ － ０２ － ２２发布 中国石油化工总公司 １ ９ ９ ４ － ０８ － ０１实施 发布 中华人民共和国行业标准 工 程 设 计 　　　　　　　　　　 计算机软件开发及文档编制规范 Ｐｒｏｃｅｄｕｒｅ　 ｆｏｒ　 ｃ ｏｍｐｕｔｅｒ　 ｓｏｆｔ ｗａｒｅ ｄｅｖｅｌｏｐｍｅｎｔ　 　　 ａｎｄ　 ｄｏｃｕｍｅｎｔａｔｉ ｏｎ ＳＨ／Ｔ３９０１－１９９４ 主编单位：中 国石 化 北 京设 计 院 批准部 门： 中 国 石 油 化 工 总 公 司 １９９ ４ 北 京 中 国 石 油 化 工 总 公司 文 件 中石化 （ １ ９９ ４）建字 ７８号 关于发布行业标准 《工程设计计算机软件开发 及文档编制规范》的通知 　　　　　　　　 各有关单位： 由中国石化北京设计院主编的 《工程设计计算机软件开发及文档编制规范》已审查 　　　　 定稿．现批准 《工程设计计算机软件开发及文档编制规范》Ｓ Ｈ／ Ｔ３ ９０１ 一１ ９９ ４为石油化工 行业推荐性标准，自一九九四年八月一日起实施． 本标准的具体解释工作，由中国石化北京设计院负责． 　　　　 中国石油化工总公司工程建设部 一九九四年 二月二十 四日 　　　　　　　　 目 次 １ 总则・ ・ ・ ・ ・・ ・ ・ ・ ・ ・ “・ ・ ・ ・ ・・ ・ ・ ・ ・ ・ ・ ・ ・ ・ ・ ・・ ”・ ・”・ ・ ・ ・ ・ ・ ・ “・ “・ ・・ ・ ・ ・ ・ “・・ ・ ””・ ”・ ”・ ・ ・ ・ “一 ”・ ・ ”・… １ ２ 软件开发期工作阶段的划分及其文档“・ ・ ・ ・ ・ ・・ ・ ・ ・ ・・ ”・ ・ ・ ・ ・・ ““・ “・ ・ ・・ ・ ・ ・ ”・ ”・ ・ ・ “・ ‘… ｚ ３ 项目开发计划・・ ・ ・ ・ ・ “・ ・ ・ ・ ・ ・ ・ ・ ・ ・ ・ ・ ・ ・ ・ ・ ・ ・ ・ ・ ・ ・ ・ ・ ・ “・ ・ ・ ・ ・ ・ ・ ・ ・ ・ ・ ・ ・ ・ ・ ・ ・ ・ ・ ・・ ・ ・ ”・ ・ ・ ・ ・ ・ ・ ・ ・ ・ ・ ・ ・ ・ ・ ・ ・・ …… ４ ４ 需求分析・ ． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ”一 ５ ５ 概要设计・ ・ ・ ・ ・ ・ ・ ”・ ・ ・ ・ ・ ・ ・ ”・ “・ ・ ・ ・ ”“・ ・ ・ ・ ・ ・ 一 ”・ ・ ・ ・ ・ ・ ・ ・ ・ ・ ・ ・ “・ ・ ““・ ・ ““・ ・ ・ ・ ・ ・ ・ ”・ ・ ・・ ・ ・ ・・ …… ７ ５ 　　 ．１ 用户界面设计”・ ・ ・ ・ ・ ・ ・ ・ ・”．・ ・ ・ ・ ・ ．・ ・ ・ ・ ・ ・ ・ ・ ・ ・ ・ ・ ・ ・ ・ ”・・ ・ ・ ・ ・ ・・・ ・ ”・ ・ ・ ・ ・ ・ ・ ・ ・ ・ ・ ・ ・ ・・ ・ ・ …… ７ ５：　 　　 ２ 算法设计・ ・ ・ ・ ・ ・ ”・ ・ ・ ・ ・ ”・ “・ ・ ・ ・ ・ ・ “・ ・ “・・ ・ ・ ・ ・ ・ ・ “・ ・ ・ ・ ・ ・ ・ ・ ・ ・ ・ ・ ・ ・一 ”“・ ・ ・ ・ ・ ・ ・ ・ ”・ ・ ・ ・ ・ ・ …… ８ ５． 　　 ３ 结构设计・ ”・ ・ ・ ・ ・・ ・ ・ ・ ・ ・ ・ ・ ・ ・ ・ ・ ・ ・ ・ ・ ・ ・ ・・ ・ ・・ ・ ・ ・ ・ ・ ・ ・ ・ ・ ・ ……： ・ ・ ・ ・ ・ ・ ・ ・ ・ ・ ”・ ・・ ・ ・ ・ ・ ・ ・ ・ ・ ・ ・ ・ ・ ・ ・ …… ９ ６ 详细设计 （ 模块设计）・ ・ ・ ・ ・ ・ ・ ・ ・ ・ ・ ・ ・ ・ ・ ・ ・ ・ ・ ・ ・ ・ ・ ・ ・ ・ ・ ・ ・ ・ ・ ・ ・ ・ ・ ・ ・・ ・ ・ ・ ・ ・ ・ ・ ・ ・ ・ ・ ・ ・ ・ ・ ・ ・ ・ ・ ・ ・ ・ ・ ・ ・ ”・ ・ ・ ・ 一 １ １ 了 编程 ・ ・ ・ ・ ・ ・ ・ ・ ・ “・ ・ ・ ・ ・ ・ ・ ・ ・ ・ ・ ・ ・ ・ ・ ・ ・ ・ ・ ・ ・・ ・ ・ ・ ・ ・ ．・ ， ・ “・ ・・ ・ ・ ・ ・ ・ ・ ・ ・ ・ ・ ・ ”・ ・ ・ ・ ・ ”・ “・ “・ ・・ ・ ・ ・ ・ ・ ・ ・ ・ ・ ・ ・ ・・ …… １ ２ ８ 调试． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ．　 １ ３ ９ 测试与验收“・ ・ ・ ・ ・ ・ ・ ・ ・ ・ ・ ・ ・ ・ ・ ・ ・ ”・ ”・ ・ ・ ・ ”“・ ・ ・ ・ ・ ・ ・ ・ ・ ・ ・ ・ ・ ・ ・ ・ ・ ””・ ・ ・ ・ ”・ ・ ・ ・ ・ ・ ・ ・ ・ ・ ・ “・ ・ ・ ・ ・ ・ ・ “・・ …… １ ４ 附录 Ａ 用词说明 ・ ・ ・ ・ ・・ ・ ・ ・ ・ ・ ・ ・ ・ ”・ ・ ・ ・ ・ ・ ・ ・ ”・・ ・ “・ ・ ・ ・ ・ ・ ・ ・ ・ ・・ ・ ”・ ・ ・ ・ ・ ・ ・ ”・・ ・ ““・ ・ ・ ・ ・ ・ ・ ・ ・ ・ ・ ・ ・ …… １ ５ 附加说 明 ・ ・ ・ ・ ・ ・ ・・ ・ ・ ・ ・ ・ ”・ ・ ”・ ・ ・ ・ ・・ ・・ ・・ ・ ・ ・ ・ ・ ・ ・ ・ ・ ・ ・ ・ ・ ・ ・ ・・ ・ ・ ・ ・ ・ ・ ”・・ ・ ・・ ・ ・ ・ ・ ・ ・ ・ ・ ・ ・ ・ ・ ・ ・ ・ ・ ・ ・ ・・ ・ ・ …… １ ６ 附条文说明・ ． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ． ．　 ． １ ７ 总 则 １ ． ０．１ 为使石油化工工程设计计算机应用软件的开发工作概念统一、格式一致、文档 资料清晰完整；使软件开发工作规范化、系统化、工程化：提高软件开发效率和软件产 品质量：促进软件的商品化：特制订本规范。 １ ． ０ ． ２ 本规范适用于一般开发难度的中型 （兼顾大、小型）石油化工工程设计计算机 应用软件的开发及文档编制工作。特殊软件项目可参照执行。 １ ．　 ｏ． ３ 开发石油化工工程设计计算机应用软件，除执行本规范外，尚应符合现行国家 的有关标准、规范的规定 。 ２ 软件开发期工作阶段的划分及其文档 ２．１ 软件开发期工作 阶段 的划分 ２．１． １ 软件开发期一般可划分为项目开发计划、需求分析、概要设计 （包括用户界面 设计、算法设计、结构设计）、详细设计、编程、调试、测试与验收等七个工作阶段。 如表２．１ ．１所示。 ２．１ ． ２ 软件开发期工作阶段的划分不是绝对的。复杂 的大、中型软件 ，可根据其特点 和 需要 ，对上 述划分的各工作阶段进 行再分解 。 ２． ２ 软件开发期的文档 ２．２ ．１ 软件规模 的划分 　　　　 小型软件：源程序少于５ ０ ００行或存储量小于 １ ｍ． 中型软件：源程序５ 　　　　 ００ ０＾－ ３０ ００ ０行或存储量 １ ＾－ ５０ Ｍ； 大型软件：源程序多于 ３ 　　　　 ０ ００ ０行或存储量大于５ ０Ｍ． ２ ．２ ．２ 在软件开发期的每个工作阶段，软件开发人员必须编写出相应的文档．不同规 模软件文档的组成见表２．１ ．１ ． ２ ．２ ．３ 文档编写的详略程度应随着软件的开发难度、复杂程度、重要性、开发风险等 的提高而增加。必要时可在各工作阶段的文档中增设需要的条目和内容。 ２ ．２ ．４ 文档的内容应完整、统一；定义应严格、准确：叙述应简练、逻辑性强；所提 的要求和指标应具体、可验证；使用的技术用语、图例、符号等，应符合有关专业技术 和软件技术的标准、规范、规定的要求，并在所有文档中保持一致． ２ ．２ ．５ 用户手册的编写除应符合 ２．２ ． ４条要求外，尚应适合工程技术人员的使用习惯 和要求． ２ ．２ ．６ 软件开发过程中的文档修改，应在严格管理下按以下不同情况分别对待： ２ 　　 ．２ ．６ ．１ 凡不涉及文档内容的修改，可仅仅修改源程序。 ２． 　　 ２． ６． ２ 涉及文档内容的一般性修改，应将源程序和文档同步修改。 ２． 　　 ２． ６． ３ 凡涉及软件的或模块的功能、性能、软件结构、数据结构、算法、接口等 文档，建 立本 次修改的文档 ，并 以新文档取代原文档． 软件开发期的工作阶段划分及其文档设置 大 型 工 作 阶 段 软 件 中 型 软 件， 小 文 档 设 里 工 作 阶 段 文 档 设 兰 表２ ． １ ． １ 型 工 作 阶段 软 件 文 档 设 呈 项目开发计划 书项目开发计划 与软件需求说 项 目 开 发 项 目 开 发计 项 目 开 发 项 目 开 发 计 划 划 书 　　　　 划 计 计 划 雷 求 分 析 软 件 需 求说 需 求 分 析 软 件 需 求 与需求分析 明 书 　　　　 说 明 用 户界 面 用户界面设计 用户界面 用户界面设计 设 设 说 计 说 明 书 概 算法设 计 要 算 法 设 计 说 设 结构设计 结 构 设 计 计 说 明 明 计 算法设计 书 明 书 算法设计说明 书 结构设计 书 明书 书 结构设 计 说明 书 软件 设计 说