【软件文档】软件系统代码编写规范、SQL编写规范，程序验收文档支撑（Word资料）

易云码

于 2024-10-14 09:42:02 发布

阅读量1.4k

点赞数 42

分类专栏：项目管理资料下载行业资料文章标签： sql 数据库低代码 vue.js java

本文链接：https://blog.csdn.net/2301_79994950/article/details/142909963

版权

项目管理同时被 3 个专栏收录

268 篇文章

订阅专栏

资料下载

170 篇文章

订阅专栏

行业资料

168 篇文章

订阅专栏

一、概述

（一）背景

（二）读者对象

（三）商讨

二、基本原则

（一）一开始就必须正确的使用规范

（二）简易性原则

（三）清晰性原则

（四）健壮性原则

（五）效率原则

三、格式规范

（一）代码缩进

（二）分解较长的行

（三）空白区域的使用

（四） SQL语句书写规范

1． SELECT语句书写规则

2． insert语句书写规则

3． update语句的编写规则

4． delete语句的编写规则。

四、命名规范

（一）使用有意义的命名

（二）使用术语进行命名

（三）超长命名处理

（四）保留元音

（五）缩写后的首字母大写

（六）不要用字符的大小写来区分命名

（七）包命名

1．包命名

2．使用单一的、小写单词来命名每一个包

（八）类命名

1．类或接口的每个单词的首字母大写

2．使用名词来命名类

3．一组有关系的属性、静态服务或常量的类命名采用复数

（九）接口命名

1．使用名词或形容词来命名接口

（十）方法的命名

1．方法的首单词的首字母小写，后面的单词的首字母大写

2．使用动词来命名方法

3．遵从JavaBeans规则来命名访问方法

（十一）变量命名

1．在变量的命名中，变量的首单词的首字母小写，后面的单词的首字母大写

2．使用名词来命名变量

3．集合含义的变量采用复数形式进行命名

（十二）属性命名

1．使用“this”关键字限定属性变量，用于区分逻辑变量

（十三）参数命名

1．当一个构件器或一个“set”方法通过参数赋值给一个属性时，将参数和属性采用同样的名字来命名

（十四）常量命名

五、注释规范

（一）保持注释和代码同步

（二）使用主动语态并尽量忽略不需要的用词

（三）注释类型

（四）版权信息注释

（五）使用文档注释来描述程序接口

（六）使用标准代码去隐藏代码而不要删除它

（七）使用行注释来解释实现细节

（八）文档注释

1．在代码编写前就描述程序接口

2．文档中应描述公有、保护、包和私有的成员

3．对每个包提供概要描述信息和总体的功能

4．对每个应用或一组包提供概要描述信息和总体的功能

（九）注释格式

1．在所有的文档注释中，使用一致的格式和结构

（十）使用第三人称代词

（十一）使用“this”而不是“the”指向当前类的实例

（十二）不要在方法或构造函数名后添加“（）”，除非做一个特殊的标识

（十三）注释内容

1．为每一个类、接口、属性和方法提供一个概要描述

2．充分描述每个方法提供的操作

3．解释和理解你的软件的使用，最简单的方法是提供例子。

（十四）以文档方式记录已知的缺点和不足

（十五）记录同步的语义

（十六）代码内部注释

1．需要帮助他人理解代码时才增加内部注释

2．描述代码应该做的事情，而不是描述代码正在做什么

3．避免使用行末注释的方法

4．采用行末注释的方式解释局域变量

5．创建并使用一套关键字集来标注未解决的问题

6．在多重嵌套控制结构中标注结束标志

7．如果在switch语句中没有break，则在相应的两个case之间添加一行“fall-through”注释

8．标注empty语句

软件全套资料部分文档清单：
工作安排任务书，可行性分析报告，立项申请审批表，产品需求规格说明书，需求调研计划，用户需求调查单，用户需求说明书，概要设计说明书，技术解决方案，数据库设计说明书，详细设计说明书，单元测试报告，总体测试计划，单元测试计划，产品集成计划，集成测试报告，集成测试计划，系统测试报告，产品交接验收单，验收报告，验收测试报告，压力测试报告，项目总结报告，立项结项审批表，成本估算表，项目计划，项目周报月报，风险管理计划，质量保证措施，项目甘特图，项目管理工具，操作手册，接口设计文档，软件实施方案，运维方案，安全检测报告，投标响应文件，开工申请表，开工报告，概要设计检查表，详细设计检查表，需求规格说明书检查表，需求确认表，系统代码编写规范，软件项目质量保证措施，软件部署方案，试运行方案，培训计划方案，软件系统功能检查表，工程试运行问题报告，软件合同，资质评审材料，信息安全相关文档等。

建设方案部分资料清单：

信创云规划设计建设方案，新型智慧城市解决方案，医疗信息化中台技术架构方案，智慧消防建设规划方案，智慧校园技术方案，智慧医疗技术方案，智慧园区管理平台建设方案，智慧政务大数据整体技术解决方案，SRM系统解决方案，固定资产管理系统建设方案，工单管理系统建设方案，大数据管理平台技术方案，GIS地理信息服务平台建设方案，设备管理系统建设方案，远程抄表管理方案，BIM建模建设方案，数字孪生物联网云平台建设方案，仓储管理建设方案，智慧园区整体解决方案，智慧工地整体解决方案等等。

软件全套精华资料包获取：本文末个人名片获取；