1、 项目创建需符合<code>group</code>规范。
2、 创建项目必须添加<code>project description</code>说明。
3、 每个项目都需要<code>readme.md</code>文件。
4、 除文档说明类型仓库，所有代码仓库都需要<code>.gitignore</code>。
注：有模板的项目，要以统一的模板创建项目
readme文件结构如下：
<code>introduction</code> 用于阐述项目基本情况和功能（是什么，用来做什么的）。
<code>quick start</code> 主要包括两部分内容：简易的安装部署说明(deployment)和使用案例(example)。
<code>documentation</code> 部分是核心的文档，对于大型项目可以使用超链接代替。
参考：
项目代码release包括三类：
大版本(x.0.0)
小版本(x.x.0)
补丁(x.x.x)
git commit 提交样式规范：
<type>: <subject> 注意：冒号后面又空格
用于说明 commit 的类别(type)，只允许使用下面7个标识。
当一次改动包括<code>主要type</code>与<code>特殊type</code>时，统一采用<code>主要type</code>。
commit 目的的简短描述，不超过50个字符
对本次 commit 的详细描述，可以分成多行，可详细说明代码变动的动机。
远程仓库只允许出现五种类型的分支：
主分支：项目的主要分支也就是master分支。用于正式发布，该分支禁止任何人直接提交，提交合并请求由对应项目主管人员确认合并。
开发分支：项目的开发迭代分支，用于开发发布，常规开发任务的代码直接提交至该分支或者由临时分支合并至该分支。
测试分支：项目的测试迭代分支，用户测试发布，该分支禁止任何人直接提交，提交合并请求由对应项目主管人员确认合并。
归档分支：项目的里程碑版本保留分支，由测试负责人、项目负责人、产品负责人直接定义版本，从测试分支归档出新分支。
临时分支：由项目的开发人员建立的临时分支，禁止交叉提交，谁建立的分支便由谁负责管理，用于合并至开发分支，合并完成之后禁止新提交应当立刻删除。
主分支全局仓库唯一，分支名称固定为master，任何对主分支的直接提交定性为严重违规行为，需要尝试对主分支进行合并应当由对应仓库的开发负责人提交合并请求并由上级负责人通过合并实现对主分支的变更。
开发分支全局仓库唯一，分支名称固定为devloop，开发人员允许对该分支直接提交，任何向开发分支提交的代码在提交之前应当保证能够正常通过编译、部署并运行，无法部署的提交应当立刻修复并重新提交。开发分支部署的代码应当由开发人员完成所有的单元测试，全部通过之后再向测试分支提交。
测试分支全局仓库唯一，分支名称固定为testlooop，禁止直接对该分支提交，测试分支应当由开发分支提交合并请求而来，由开发人员提交合并请求，由主要开发人员通过合并请求实现测试部署。小型项目、中间件研发可以酌情省略测试分支，由开发分支部署交于测试进行质量校验，大型项目或产品必须保证有测试分支。
归档分支全局仓管可以具备多个，直接由测试分支或主分支派生，除特殊情况下禁止任何提交行为，归档分支名称格式为release-版本号（如：<code>release-1.2.0</code>），分支由对应项目的开发主要负责人再与测试负责人沟通之后创建，已经后续无论是bug、还是功能性问题都不应当项归档分支提交。
临时分支全局仓库可以具备多个，临时分支名称格式为tem-开发者-创建时间（如：<code>tem-tangyuecan-20200724</code>），由开发人员自行创建，临时分支的提交进制交叉提交，只允许分支创建者提交，临时分支只能合并到开发分支一旦完成合并之后应当立即删除，可以直接本地合并之后向开发分支提交或者提交合并请求由开发负责人进行合并，临时分支的生命周期原则上不超过三个工作日。临时分支主要用于无法在短时间之内完成的开发工作，或者整合至开发分支之后无法运行情况，这样考虑之下才有临时分支的概念。
所以代码的提交、合并都应该通过文字目前描述出改此提交、合并的目的如下面几种：
<code>修复问题：#xxxx</code>（禅道bug的id或者issue）
<code>修复问题：xxxx</code>（bug的名称）
<code>完成功能：#xxxx</code>（禅道的任务id）
<code>完成功能：xxxxx</code>（功能的名称）
任何无意义或者具体目的的提交禁止同步至远程仓库，包括远程临时分支（禁止commit）
好的命名能体现出代码的特征，含义或者是用途，让阅读者可以根据名称的含义快速厘清程序的脉络。不同语言中采用的命名形式大相径庭，java 中常用到的命名形式共有三种，既首字母大写的 uppercamelcase ，首字母小写的 lowercamelcase 以及全部大写的并用下划线分割单词的upper_camel_unser_score。通常约定，类一般采用大驼峰命名，方法和局部变量使用小驼峰命名，而大写下划线命名通常是常量和枚举中使用。
类型
约束
例
项目名
全部小写，多个单词用中划线分隔‘-’
spring-cloud
包名
全部小写
com.alibaba.fastjson
类名
单词首字母大写
feature, parserconfig,defaultfielddeserializer
变量名
首字母小写，多个单词组成时，除首个单词，其他单词首字母都要大写
password, username
常量名
全部大写，多个单词，用'_'分隔
cache_expired_time
方法
同变量
read(), readobject(), getbyid()
包名统一使用小写，点分隔符之间有且仅有一个自然语义的英文单词或者多个单词自然连接到一块（如 springframework，deepspace 不需要使用任何分割）。包名统一使用单数形式，如果类命有复数含义，则可以使用复数形式。
包名的构成可以分为以下几四部分【前缀】 【发起者名】【项目名】【模块名】。常见的前缀可以分为以下几种：
前缀名
含义
indi（或onem ）
indi.发起者名.项目名.模块名.……
个体项目，指个人发起，但非自己独自完成的项目，可公开或私有项目，copyright主要属于发起者。
pers
pers.个人名.项目名.模块名.……
个人项目，指个人发起，独自完成，可分享的项目，copyright主要属于个人
priv
priv.个人名.项目名.模块名.……
私有项目，指个人发起，独自完成，非公开的私人使用的项目，copyright属于个人。
team
team.团队名.项目名.模块名.……
团队项目，指由团队发起，并由该团队开发的项目，copyright属于该团队所有
顶级域名
com.公司名.项目名.模块名.……
公司项目，copyright由项目发起的公司所有
类名使用大驼峰命名形式，类命通常时名词或名词短语，接口名除了用名词和名词短语以外，还可以使用形容词或形容词短语，如 cloneable，callable 等，表示实现该接口的类有某种功能或能力。对于测试类则以它要测试的类开头，以 test 结尾，如 hashmaptest。
对于一些特殊特有名词缩写也可以使用全大写命名，比如xmlhttprequest，不过笔者认为缩写三个字母以内都大写，超过三个字母则按照要给单词算。这个没有标准如阿里巴巴中fastjson用jsonobject作为类命，而google则使用jsonobjectrequest 命名，对于这种特殊的缩写，原则是统一就好。
属性
抽象类
abstract 或者 base 开头
baseuserservice
枚举类
enum 作为后缀
genderenum
工具类
utils作为后缀
stringutils
异常类
exception结尾
runtimeexception
接口实现类
接口名+ impl
userserviceimpl
领域模型相关
/do/dto/vo/dao
正例：userdao 反例： userdo， userdao
设计模式相关类
builder，factory等
当使用到设计模式时，需要使用对应的设计模式作为后缀，如threadfactory
处理特定功能的
handler，predicate, validator
表示处理器，校验器，断言，这些类工厂还有配套的方法名如handle，predicate，validate
测试类
test结尾
userservicetest， 表示用来测试userservice类的
mvc分层
controller，service，serviceimpl，dao后缀
usermanagecontroller，usermanagedao
方法命名采用小驼峰的形式，首字小写，往后的每个单词首字母都要大写。 和类名不同的是，方法命名一般为动词或动词短语，与参数或参数名共同组成动宾短语，即动词 + 名词。一个好的函数名一般能通过名字直接获知该函数实现什么样的功能。
注：prefix-前缀，suffix-后缀，alone-单独使用
位置
单词
意义
prefix
is
对象是否符合期待的状态
isvalid
can
对象能否执行所期待的动作
canremove
should
调用方执行某个命令或方法是好还是不好,应不应该，或者说推荐还是不推荐
shouldmigrate
has
对象是否持有所期待的数据和属性
hasobservers
needs
调用方是否需要执行某个命令或方法
needsmigrate
ensure
检查是否为期待的状态，不是则抛出异常或返回error code
ensurecapacity
validate
检查是否为正确的状态，不是则抛出异常或返回error code
validateinputs
suffix
ifneeded
需要的时候执行，不需要的时候什么都不做
drawifneeded
might
同上
mightcreate
try
尝试执行，失败时抛出异常或是返回errorcode
trycreate
ordefault
尝试执行，失败时返回默认值
getordefault
orelse
尝试执行、失败时返回实际参数中指定的值
getorelse
force
强制尝试执行。error抛出异常或是返回值
forcecreate, forcestop
blocking
线程阻塞方法
blockinggetuser
inbackground
执行在后台的线程
doinbackground
async
异步方法
sendasync
sync
对应已有异步方法的同步方法
sendsync
prefix or alone
schedule
job和task放入队列
schedule, schedulejob
post
postjob
execute
执行异步方法（注：我一般拿这个做同步方法名）
execute, executetask
start
start, startjob
cancel
停止异步方法
cancel, canceljob
stop
stop, stopjob
on
事件发生时执行
oncompleted
before
事件发生前执行
beforeupdate
pre
preupdate
will
willupdate
after
事件发生后执行
afterupdate
postupdate
did
didupdate
确认事件是否可以发生时执行
shouldupdate
initialize
初始化。也可作为延迟初始化使用
pause
暂停
onpause ，pause
停止
onstop，stop
abandon
销毁的替代
destroy
dispose
contains
是否持有与指定对象相同的对象
add
添加
addjob
append
appendjob
insert
插入到下标n
insertjob
put
添加与key对应的元素
putjob
remove
移除元素
removejob
enqueue
添加到队列的最末位
enqueuejob
dequeue
从队列中头部取出并移除
dequeuejob
push
添加到栈头
pushjob
pop
从栈头取出并移除
popjob
peek
从栈头取出但不移除
peekjob
find
寻找符合条件的某物
findbyid
create
新创建
createaccount
new
newaccount
from
从既有的某物新建，或是从其他的数据新建
fromconfig
to
转换
tostring
update
更新既有某物
updateaccount
load
读取
loadaccount
fetch
远程读取
fetchaccount
delete
删除
deleteaccount
removeaccount
save
保存
saveaccount
store
storeaccount
commit
commitchange
apply
保存或应用
applychange
clear
清除数据或是恢复到初始状态
clearall
reset
resetall
get获取
set 设置
add 增加
remove 删除
create 创建
destory 移除
start 启动
stop 停止
open 打开
close 关闭
read 读取
write 写入
load 载入
save 保存
destroy 销毁
begin 开始
end 结束
backup 备份
restore 恢复
import 导入
export 导出
split 分割
merge 合并
inject 注入
extract 提取
attach 附着
detach 脱离
bind 绑定
separate 分离
view 查看
browse 浏览
edit 编辑
modify 修改
select 选取
mark 标记
copy 复制
paste 粘贴
undo 撤销
redo 重做
insert 插入
delete 移除
add 加入
append 添加
clean 清理
clear 清除
index 索引
sort 排序
find 查找
search 搜索
increase 增加
decrease 减少
play 播放
pause 暂停
launch 启动
run 运行
compile 编译
execute 执行
debug 调试
trace 跟踪
observe 观察
listen 监听
build 构建
publish 发布
input 输入
output 输出
encode 编码
decode 解码
encrypt 加密
decrypt 解密
compress 压缩
decompress 解压缩
pack 打包
unpack 解包
parse 解析
emit 生成
connect 连接
disconnect 断开
send 发送
receive 接收
download 下载
upload 上传
refresh 刷新
synchronize 同步
update 更新
revert 复原
lock 锁定
unlock 解锁
check out 签出
check in 签入
submit 提交
commit 交付
push 推
pull 拉
expand 展开
collapse 折叠
begin 起始
start 开始
finish 完成
enter 进入
exit 退出
abort 放弃
quit 离开
obsolete 废弃
depreciate 废旧
collect 收集
aggregate 聚集
变量是指在程序运行中可以改变其值的量，包括成员变量和局部变量。变量名由多单词组成时，第一个单词的首字母小写，其后单词的首字母大写，俗称骆驼式命名法（也称驼峰命名法），如 computedvalues，index、变量命名时，尽量简短且能清楚的表达变量的作用，命名体现具体的业务含义即可。
变量名不应以下划线或美元符号开头，尽管这在语法上是允许的。变量名应简短且富于描述。变量名的选用应该易于记忆，即，能够指出其用途。尽量避免单个字符的变量名，除非是一次性的临时变量。pojo中的布尔变量，都不要加is(数据库中的布尔字段全都要加 is_ 前缀)。
常量命名constant_case，一般采用全部大写（作为方法参数时除外），单词间用下划线分割。那么什么是常量呢？
常量是在作用域内保持不变的值，一般使用final进行修饰。一般分为三种，全局常量（public static final修饰），类内常量（private static final 修饰）以及局部常量（方法内，或者参数中的常量），局部常量比较特殊，通常采用小驼峰命名即可。
常量一般都有自己的业务含义,不要害怕长度过长而进行省略或者缩写。如，用户消息缓存过期时间的表示，那种方式更佳清晰，交给你来评判。
尽量不要使用拼音；杜绝拼音和英文混用。对于一些通用的表示或者难以用英文描述的可以采用拼音，一旦采用拼音就坚决不能和英文混用。 正例： beijing， hangzhou 反例： validatecanshu
命名过程中尽量不要出现特殊的字符，常量除外。
尽量不要和jdk或者框架中已存在的类重名，也不能使用java中的关键字命名。
妙用介词，如for(可以用同音的4代替), to(可用同音的2代替), from, with，of等。 如类名采用user4redisdo，方法名getuserinfofromredis，convertjson2map等。
好的命名增加代码阅读性，代码的命名往往有严格的限制。而注解不同，程序员往往可以自由发挥，单并不意味着可以为所欲为之胡作非为。优雅的注解通常要满足三要素。
nothing is strange 没有注解的代码对于阅读者非常不友好，哪怕代码写的在清除，阅读者至少从心理上会有抵触，更何况代码中往往有许多复杂的逻辑，所以一定要写注解，不仅要记录代码的逻辑，还有说清楚修改的逻辑。
less is more 从代码维护角度来讲，代码中的注解一定是精华中的精华。合理清晰的命名能让代码易于理解，对于逻辑简单且命名规范，能够清楚表达代码功能的代码不需要注解。滥用注解会增加额外的负担，更何况大部分都是废话。
advance with the time 注解应该随着代码的变动而改变，注解表达的信息要与代码中完全一致。通常情况下修改代码后一定要修改注解。
注解大体上可以分为两种，一种是javadoc注解，另一种是简单注解。javadoc注解可以生成javaapi为外部用户提供有效的支持javadoc注解通常在使用idea，或者eclipse等开发工具时都可以自动生成，也支持自定义的注解模板，仅需要对对应的字段进行解释。参与同一项目开发的同学，尽量设置成相同的注解模板。
包注解在工作中往往比较特殊，通过包注解可以快速知悉当前包下代码是用来实现哪些功能，强烈建议工作中加上，尤其是对于一些比较复杂的包，包注解一般在包的根目录下，名称统一为package-info.java。
javadoc注解中，每个类都必须有注解。
在每个属性前面必须加上属性注释，通常有一下两种形式，至于怎么选择，你高兴就好，不过一个项目中要保持统一。
在每个方法前面必须加上方法注释，对于方法中的每个参数，以及返回值都要有说明。
在每个构造方法前面必须加上注释，注释模板如下：
而简单注解往往是需要工程师字节定义，在使用注解时应该注意一下几点：
枚举类的各个属性值都要使用注解，枚举可以理解为是常量，通常不会发生改变，通常会被在多个地方引用，对枚举的修改和添加属性通常会带来很大的影响。
保持排版整洁，不要使用行尾注释；双斜杠和星号之后要用1个空格分隔。
工程命名由三部分组成：前缀-项目名称-后缀。
工程根据功能分为：手机工程和一般性工程，手机工程主要给手机端及app提供页面和接口，除手机之外的工程统一称为一般性工程，由前缀决定。
工程根据访问渠道分为：外部工程和内部工程，外部工程的主要用户为外部注册用户，对公网开放，内部工程的访问用户为公司内部人员，只能在公司内网访问，由后缀决定。
前缀
说明
mobile
基于手机浏览器的web项目，主要提供h5页面
android
关于安卓手机的native app项目
ios
关于ios手机的native app项目
ins
公司的一般项目，非手机类项目都使用该前缀
项目名称需要和项目内容非常贴切，让人一看就知道项目是干什么的，命名需要leader、部门总监，一起评审，通过后才能使用。
后缀
front
前端项目
web
外部工程，提供json请求，不能提供rpc接口，此类工程偏向于提供web页面业务为主
proxy
外部工程，提供对外调用接口，不能提供rpc接口，此类工程偏向于提供外部接口为主
platform
内部工程，主要提供rpc接口服务，另：可以只为技术人员提供一些监控管理的页面，此类工程偏向于rpc接口为主且只能内网访问
internal
内部工程，即可以提供rpc接口服务也可以提供json请求，但以json请求为主。此类工程偏向于提供后台页面为主且只能内网访问，如果此类工程的业务名跟platform工程的业务名同名，则在业务名后跟admin，以免他们的client重名冲突。比如：ins-xy-platform 和 ins-xy-internal 后者应该改为ins-xyadmin-internal.
task
以main函数存在的，通常是以jar包的形式，不需要容器，独立运行
app
手机上安装的软件
client
提供sdk的客户端
util
工具包（ins-utility应该改名为ins-common-util）
1、车路协同单体提供pc端访问的项目应该叫：ins-cvis-web，为车路协同提供手机端页面访问的项目应该叫：mobile-cvis-web。
2、车路协同给其他端提供业务接口调用的项目应该叫：ins-cvis-platform，为公司内部业务人员提供页面访问的项目应该叫：ins-cvis-internal。
3、给app提供外部接口支持的项目应该叫：ins-xxx-proxy。
4、像文件系统(lpfs)即需要提供管理页面，又需要提供rpc接口调用，还需要给外网提供接口和页面的项目需要根据访问渠道分成外部工程和内部工程两个工程，
外部工程应该命名为：ins-lpfs-proxy，因为主要以提供外部接口为主所以后缀应该为proxy。
5、内部工程应该命名为：ins-lpfs-platform，因为主要以rpc接口为主，且提供的页面只为内部技术人员使用，所以后缀应该为platform，如果提供的页面是给业务人员使用则应该为：ins-lpfs-internal。
com.hiacent.项目名称.web/platform【.模块名】。
如果只有一个业务模块，则业务模块级可以省略。
例如 :
ins-biz-web: 工程结构包名:com.hiacent.biz.web【.模块名】
ins-user-platform:工程结构包名：com.hiacent.user.platform【.模块名】
工程字符集: 工程符集全部设定为utf-8格式
模块名称
模块说明
示例
备注
entity层
实体类命名与表名相同，首字母大写，如果表名存在_那么将_这去掉后首字母大写。
表名:like_log 实体名 likelog
实体类属性必须与数据库字段名保持一致。
dao层
继承com.baomidou.mybatisplus.core.mapper.basemapper<t> 要求实体泛型dao层下接口命名：实体名+mapper 。
likelogmapper
service层
要求：接口继承com.baomidou.mybatisplus.extension.service.iservice<t>要求实体泛型
service.impl层类
继承com.baomidou.mybatisplus.extension.service.impl.serviceimpl，service层下接口命名：业务名称+service 。service.impl层命名： 业务名称+serviceimpl 。
likelogservice；likelogserviceimpl
service层可以调用service层和dao层和其他项目。 service层下可再包一层bean层，用以存放数据结构的类，必须以bean结尾。 平台service层内部调用的方法可以返回entity，但是被manage层调用的service方法只能返回dto或基本数据类型，不能返回entity到manage。
manage层
调用其他服务的接口，通常使用feign来实现
ilikelogmange
manage层下接口命名：i+业务名称+manage。
controller层
继承: org.jeecg.common.system.base.controller.jeecgcontroller<t, s extends iservice<t>>controller层命名：以controller结尾。
likelogcontroller
web/proxy/internal可用；controller层不能出现dto
form层
web/proxy/internal可用；form下类命名：以form结尾。
likebaseinfoform
form可以引用其他form form中不可以包含dto
dto层
internal/platform 可用；dto层命名：以dto结尾，前缀不一定是entity。
likelogdto
dto不能引用别人的dto
schedule类
schedule层命名: 以业务名称开头，以schedule结尾，前缀不一定是entity。
sendemailschedule
idp类
idp层命名：以idphandler结尾。
resumeidphandler
util层
util层命名：以util或utils结尾。
moneyutil
consts层
静态变量类consts层命名：以const结尾。
likelogconst
helper层
helper层命名：client名+helper结尾。
userplatformclienthelper
helper层主要放置调用其它端client的工具类； helper只可以出现调平台的代码和处理平台返回错误的代码； helper不允许调其他helper；
filter
filter命名：以filter结尾。
authfilter
只能出现在common包下面的filter包中
resolver
包名只能叫resolver且同一工程下只能有一个resolve包，只能出现在common包下的resolver包中，此包下只能有一个类文件且名称为：mvcexceptionresolver。
dto，form，entity，bean四者间的转换只能通过手动get，set方式赋值。
类的静态变量、静态区域块、构造函数中，不允许出现数据库的调用和rpc的调用。
同一工程下的受spring管理的类的类名不能相同，即使包名不同也不允许类名相同。
ajax方法里不能声明callback参数，因为此参数在使用跨域时做为系统占用参数。
所有可以通过网页端访问的url命名统一全小写，可以在单词之间用“-”（减号）分隔，controller采用骆峰格式命名两者除了大小写之外其他尽量保持相同。
例：@requestmapping("/getassesseeandbranch")
所有rpc接口统一用驼峰形式。
返回值是json格式url名必须是以.json结尾.
controller中url的requestmapping不能以＂/＂结尾 。
在前端页面中书写的url必须以“/”结尾。
例：<a rel="nofollow" href="/getassesseeandbranch/">
所有非登录能访问的目录型url（不是以.*结尾的url），如果访问时没有“/”结尾，则需要自动加上“/”并作301跳转。
例如：http://www.hiacent.com/login?name=xxx应该301跳转到http://www.hiacent.com/login/?name=xxx。此条只针对get请求。
所有非登录能访问的列表页面，所有翻页都需要修改成 http://www.hiacent.com/list/pnx/ (x为页码）的形式。
ajax翻页的不用遵循这个规范。
ajax方法必须以.json结尾。
例：@requestmapping("/getuser.json")
header头信息里包括x-requested-with=xmlhttprequest 或者 带有callback参数。
app方法必须以.json结尾。
请求都是压缩格式，header头信息里包括accept-encoding=gzip，不能包含x-requested-with=xmlhttprequest头信息或callback参数。
ajax请求以.json结尾，header头信息里包括x-requested-with=xmlhttprequest 或者 带有callback参数请求并且是.json后缀的访问也属于ajax请求。
ajax和web根据功能放在同一controller里。
请求参数放在方法行参里，不在使用reqeust获取请求参数，扁平化参数或封装form对象，controller方法参数扁平话后，大家写对象时一定要定义成form，不要用弱对象map这些类型。
controller方法参数不再有httpservletrequest、httpservletresponse，统一在继承的父类abstractcontroller提供方法操作，如cookie、文件下载等。
返回结果使用方法直接返回ajax方法并且，返回值是json格式的方法的返回值不需要自己转换json。
在正常情况下，后台只返回 flag 和 data 两个字段，异常情况下，返回 flag / code 和 msg 三个字段。
对于复杂业务场景，返回正常数据可能包含多种情况，以下面的方式来约束：
和前端约定：成功失败的返回值（成功flag=1，失败flag=0）。
请求以.json结尾，请求都是压缩格式，header头信息里包括accept-encoding=gzip。
请求参数放在方法行参里，不在使用reqeust获取请求参数，扁平化参数或封装form对象，请求参数放在方法行参里，不在使用reqeust获取请求参数，扁平化参
数或封装form对象，controller方法参数扁平话后，大家写对象时一定要定义成form，不要用弱对象map这些类型。
返回结果使用方法直接返回。
请求参数形式：http://domain.lietou.com/uri?mustkey1=v1&mustkey2=v2&data={}
兼容版本 返回的协议体：
最终版本和ajax返回一样。
关于缓存的使用规范
所有业务缓存、二级缓存缓存都用redis，不能用memcache。
redis只用作不持久化的缓存
1、所有数据库对象名称必须使用小写字母并用下划线分割
2、所有数据库对象名称禁止使用mysql保留关键字（如果表名中包含关键字查询时，需要将其用单引号括起来）
3、数据库对象的命名要能做到见名识意，并且最后不要超过32个字符
4、临时库表必须以tmp_为前缀并以日期为后缀，备份表必须以bak_为前缀并以日期(时间戳)为后缀
5、所有存储相同数据的列名和列类型必须一致（一般作为关联列，如果查询时关联列类型不一致会自动进行数据类型隐式转换，会造成列上的索引失效，导致查询效率降低）
采用小写字母、数字（通常不需要）和下划线组成。禁止使用’-’，命名简洁、含义明确。
根据业务类型不同，采用不同的前缀，小写字母、下划线组成
长度控制在30个字符以内
推荐的命名规则
业务表
tb_
关系表
tr_
历史表
th_
统计表
ts_
日志表
tl_xx_log
系统表、字典表、码表
sys_
临时表
tmp_
禁止使用
备份表
bak_xx_ymd
视图
view_
避免使用
没有特殊要求（即innodb无法满足的功能如：列存储，存储空间数据等）的情况下，所有表必须使用innodb存储引擎（mysql5.5之前默认使用myisam，5.6以后默认的为innodb）innodb 支持事务，支持行级锁，更好的恢复性，高并发下性能更好。
兼容性更好，统一字符集可以避免由于字符集转换产生的乱码，不同的字符集进行比较前需要进行转换会造成索引失效。
解读：在mysql中的utf-8并非“真正的utf-8”，而utf8mb4”才是真正的“utf-8”。
使用comment从句添加表和列的备注 从一开始就进行数据字典的维护
500万并不是mysql数据库的限制，过大会造成修改表结构，备份，恢复都会有很大的问题
可以用历史数据归档（应用于日志数据），分库分表（应用于业务数据）等手段来控制数据量大小。
分区表在物理上表现为多个文件，在逻辑上表现为一个表 谨慎选择分区键，跨分区查询效率可能更低 建议采用物理分表的方式管理大数据
mysql限制每个表最多存储4096列，并且每一行数据的大小不能超过65535字节 减少磁盘io,保证热数据的内存缓存命中率（表越宽，把表装载进内存缓冲池时所占用的内存也就越大,也会消耗更多的io） 更有效的利用缓存，避免读入无用的冷数据 经常一起使用的列放到一个表中（避免更多的关联操作）
预留字段的命名很难做到见名识义 预留字段无法确认存储的数据类型，所以无法选择合适的类型 对预留字段类型的修改，会对表进行锁定
通常文件很大，会短时间内造成数据量快速增长，数据库进行数据库读取时，通常会进行大量的随机io操作，文件很大时，io操作很耗时 通常存储于文件服务器，数据库只存储文件地址信息
解读：由于innodb组织数据的方式决定了需要有一个主键，而且若是这个主键id是单调递增的可以有效提高插入的性能，避免过多的页分裂、减少表碎片提高空间的使用率。 而在分库分表环境下，则需要统一来分配各个表中的主键值，从而避免整个逻辑表中主键重复。
解读：外键会导致表与表之间耦合，update与delete操作都会涉及相关联的表，十分影响sql的性能，甚至会造成死锁。
解读：单表列数太多使得mysql服务器处理innodb返回数据之间的映射成本太高。
<font color='red'>原因</font>
列的字段越大，建立索引时所需要的空间也就越大，这样一页中所能存储的索引节点的数量也就越少也越少，在遍历时所需要的io次数也就越多， 索引的性能也就越差
<font color='blue'>方法</font>
1）将字符串转换成数字类型存储，如：将ip地址转换成整形数据。
mysql提供了两个方法来处理ip地址：
插入数据前，先用inet_aton把ip地址转为整型，可以节省空间。显示数据时，使用inet_ntoa把整型的ip地址转为地址显示即可。
2）对于非负型的数据（如自增id、整型ip）来说，要优先使用无符号整型来存储
因为：无符号相对于有符号可以多出一倍的存储空间
varchar(n)中的n代表的是字符数，而不是字节数
使用utf8存储255个汉字 varchar(255)=765个字节。过大的长度会消耗更多的内存
<font color='red'>建议把blob或是text列分离到单独的扩展表中</font>
mysql内存临时表不支持text、blob这样的大数据类型，如果查询中包含这样的数据，在排序等操作时，就不能使用内存临时表，必须使用磁盘临时表进行。
而且对于这种数据，mysql还是要进行二次查询，会使sql性能变得很差，但是不是说一定不能使用这样的数据类型。
如果一定要使用，建议把blob或是text列分离到单独的扩展表中，查询时一定不要使用select * 而只需要取出必要的列，不需要text列的数据时不要对该列进行查询。
<font color='red'>text或blob类型只能使用前缀索引</font>
因为mysql对索引字段长度是有限制的，所以text类型只能使用前缀索引，并且text列上是不能有默认值的。
1、修改enum值需要使用alter语句
2、enum类型的order by操作效率低，需要额外操作
3、禁止使用数值作为enum的枚举值
<font color='red'>原因：</font>
1、索引null列需要额外的空间来保存，所以要占用更多的空间；
2、进行比较和计算时要对null值做特别的处理
解读：
null的列使索引/索引统计/值比较都更加复杂，对mysql来说更难优化；
null这种类型msql内部需要进行特殊处理，增加数据库处理记录的复杂性；同等条件下，表中有较多空字段的时候，数据库的处理性能会降低很多；
null值需要更多的存储空，无论是表还是索引中每行中的null的列都需要额外的空间来标识。
timestamp 存储的时间范围 1970-01-01 00:00:01 ~ 2038-01-19-03:14:07。
timestamp 占用4字节和int相同，但比int可读性高
超出timestamp取值范围的使用datetime类型存储。
<font color='red'>经常会有人用字符串存储日期型的数据（不正确的做法）：</font>
缺点1：无法用日期函数进行计算和比较
缺点2：用字符串存储日期要占用更多的空间
1、非精准浮点：float,double
2、精准浮点：decimal
decimal类型为精准浮点数，在计算时不会丢失精度。占用空间由定义的宽度决定，每4个字节可以存储9位数字，并且小数点要占用一个字节。可用于存储比bigint更大的整型数据。
解读：能够减少空间碎片，节省存储空间。
索引并不是越多越好！索引可以提高效率同样可以降低效率。
索引可以增加查询效率，但同样也会降低插入和更新的效率，甚至有些情况下会降低查询效率。
因为mysql优化器在选择如何优化查询时，会根据统一信息，对每一个可以用到的索引来进行评估，以生成出一个最好的执行计划，如果同时有很多个索引都可以用于查询，就会增加mysql优化器生成执行计划的时间，同样会降低查询性能。
5.6版本之前，一个sql只能使用到一个表中的一个索引，5.6以后，虽然有了合并索引的优化方式，但是还是远远没有使用一个联合索引的查询方式好
innodb是一种索引组织表：数据的存储的逻辑顺序和索引的顺序是相同的。
每个表都可以有多个索引，但是表的存储顺序只能有一种 innodb是按照主键索引的顺序来组织表的。
不要使用更新频繁的列作为主键，不适用多列主键（相当于联合索引） 不要使用uuid、md5、hash、字符串列作为主键（无法保证数据的顺序增长）。
主键建议使用自增id值。
【建议】（1）避免在更新比较频繁、区分度不高的列上单独建立索引
解读：区分度不高的列单独创建索引的优化效果很小，但是较为频繁的更新则会让索引的维护成本更高。
【强制】（2） join的表不允许超过五个。需要join的字段，数据类型必须绝对一致; 多表关联查询时，保证被关联的字段需要有索引
解读：太多表的join会让mysql的优化器更难权衡出一个“最佳”的执行计划（可能性为表数量的阶乘），同时要注意关联字段的类型、长度、字符编码等等是否一致。
【强制】（3）在一个联合索引中，若第一列索引区分度等于1，那么则不需要建立联合索引
解读：索引通过第一列就能够完全定位的数据，所以联合索引的后边部分是不需要的。
【强制】（4）建立联合索引时，必须将区分度更高的字段放在左
解读：区分度更高的列放在左边，能够在一开始就有效的过滤掉无用数据。提高索引的效率，相应我们在mapper中编写sql的where条件中有多个条件时，需要先看看当前表是否有现成的联合索引直接使用，注意各个条件的顺序尽量和索引的顺序一致。
【建议】（5）利用覆盖索引来进行查询操作，避免回表
解读：覆盖查询即是查询只需要通过索引即可拿到所需data，而不再需要再次回表查询，所以效率相对很高。我们在使用explain的结果，extra列会出现："using index"。这里也要强调一下不要使用“select * ”，否则几乎不可能使用到覆盖索引。
【建议】（6）在较长varchar字段,例如varchar(100)上建立索引时，应指定索引长度，没必要对全字段建立索引，根据实际文本区分度决定索引长度即可
解读：索引的长度与区分度是一对矛盾体，一般对字符串类型数据，若长度为20的索引，区分度会高达90%以上，则可以考虑创建长度例为20的索引，而非全字段索引。例如可以使用select count(distinct left(lesson_code, 20)) / count(*) from lesson;来确定lesson_code字段字符长度为20时文本区分度。
【建议】（7）如果有order by的场景，请注意利用索引的有序性。order by最后的字段是联合索引的一部分，并且放在索引组合顺序的最后，避免出现file_sort的情况，影响查询性能。
假设有查询条件为where a=? and b=? order by c；存在索引：a_b_c，则此时可以利用索引排序；
反例：在查询条件中包含了范围查询，那么索引有序性无法利用，如:where a>10 order by b; 索引a_b无法排序。
【建议】（8）在where中索引的列不能某个表达式的一部分，也不能是函数的参数
解读：即是某列上已经添加了索引，但是若此列成为表达式的一部分、或者是函数的参数，mysql无法将此列单独解析出来，索引也不会生效。
【建议】 （9）我们在where条件中使用范围查询时，索引最多用于一个范围条件，超过一个则后边的不走索引
解读：mysql能够使用多个范围条件里边的最左边的第一个范围查询，但是后边的范围查询则无法使用。
【建议】 （10）在多个表进行外连接时，表之间的关联字段类型必须完全一致
解读：当两个表进行join时，字段类型若没有完全一致，则加索引也不会生效，这里的完全一致包括但不限于字段类型、字段长度、字符集、collection等等。
1、出现在select、update、delete语句的where从句中的列
2、包含在order by、group by、distinct中的字段
并不要将符合1和2中的字段的列都建立一个索引，通常将1、2中的字段建立联合索引效果更好
3、多表join的关联列
建立索引的目的是：希望通过索引进行数据查找，减少随机io，增加查询性能 ，索引能过滤出越少的数据，则从磁盘中读入的数据也就越少。
1、区分度最高的放在联合索引的最左侧（区分度=列中不同值的数量/列的总行数）；
2、尽量把字段长度小的列放在联合索引的最左侧（因为字段长度越小，一页能存储的数据量越大，io性能也就越好）；
3、使用最频繁的列放到联合索引的左侧（这样可以比较少的建立一些索引）。
因为这样会增加查询优化器生成执行计划的时间。
重复索引示例：primary key(id)、index(id)、unique index(id)
冗余索引示例：index(a,b,c)、index(a,b)、index(a)
对于频繁的查询优先考虑使用覆盖索引。
<font color='red'>覆盖索引：就是包含了所有查询字段(where,select,ordery by,group by包含的字段)的索引</font>
覆盖索引的好处：
避免innodb表进行索引的二次查询
innodb是以聚集索引的顺序来存储的，对于innodb来说，二级索引在叶子节点中所保存的是行的主键信息，如果是用二级索引查询数据的话，在查找到相应的键值后，还要通过主键进行二次查询才能获取我们真实所需要的数据。而在覆盖索引中，二级索引的键值中可以获取所有的数据，避免了对主键的二次查询 ，减少了io操作，提升了查询效率。
<font color='red'>可以把随机io变成顺序io加快查询效率</font>
由于覆盖索引是按键值的顺序存储的，对于io密集型的范围查找来说，对比随机从磁盘读取每一行的数据io要少的多，因此利用覆盖索引在访问时也可以把磁盘的随机读取的io转变成索引查找的顺序io。
尽量避免使用外键约束
1、不建议使用外键约束（foreign key），但一定要在表与表之间的关联键上建立索引；
2、外键可用于保证数据的参照完整性，但建议在业务端实现；
3、外键会影响父表和子表的写操作从而降低性能。
预编译语句可以重复使用这些计划，减少sql编译所需要的时间，还可以解决动态sql所带来的sql注入的问题 只传参数，比传递sql语句更高效 相同语句可以一次解析，多次使用，提高处理效率。
隐式转换会导致索引失效。如：select name,phone from customer where id = '111';
解读：假设我们在手机号列上添加了索引，然后执行下面的sql会发生什么？explain select user_name from parent where phone=13812345678; 很明显就是索引不生效，会全表扫描。
<font color='red'>避免使用双%号的查询条件。</font>
如a like '%123%'，（如果无前置%,只有后置%，是可以用到列上的索引的）
解读：根据索引的最左前缀原理，%开头的模糊查询无法使用索引，可以使用es来做检索。
<font color='red'>一个sql只能利用到复合索引中的一列进行范围查询</font>
如：有 a,b,c列的联合索引，在查询条件中有a列的范围查询，则在b,c列上的索引将不会被用到，在定义联合索引时，如果a列要用到范围查找的话，就要把a列放到联合索引的右侧。
<font color='red'>使用left join或 not exists来优化not in操作</font>
因为not in 也通常会使用索引失效。
1、为数据库迁移和分库分表留出余地
2、降低业务耦合度
3、避免权限过大而产生的安全风险
消耗更多的cpu和io以网络带宽资源
无法使用覆盖索引
可减少表结构变更带来的影响
读取不需要的列会增加cpu、io、net消耗；
如：insert into values ('a','b','c');
应使用insert into t(c1,c2,c3) values ('a','b','c');
通常子查询在in子句中，且子查询中为简单sql(不包含union、group by、order by、limit从句)时，才可以把子查询转化为关联查询进行优化。
<font color='red'>子查询性能差的原因：</font>
1、子查询的结果集无法使用索引，通常子查询的结果集会被存储到临时表中，不论是内存临时表还是磁盘临时表都不会存在索引，所以查询性能会受到一定的影响；
3、特别是对于返回结果集比较大的子查询，其对查询性能的影响也就越大；
3、由于子查询会产生大量的临时表也没有索引，所以会消耗过多的cpu和io资源，产生大量的慢查询。
对于mysql来说，是存在关联缓存的，缓存的大小可以由join_buffer_size参数进行设置。
在mysql中，对于同一个sql多关联（join）一个表，就会多分配一个关联缓存，如果在一个sql中关联的表越多，所占用的内存也就越大。
如果程序中大量的使用了多表关联的操作，同时join_buffer_size设置的也不合理的情况下，就容易造成服务器内存溢出的情况，就会影响到服务器数据库性能的稳定性。
同时对于关联操作来说，会产生临时表操作，影响查询效率mysql最多允许关联61个表，建议不超过5个。
数据库更适合处理批量操作 合并多个相同的操作到一起，可以提高处理效率
<font color='red'>应尽量避免在where子句中使用or作为连接条件</font>
in的值不要超过500个in操作可以更有效的利用索引，or大多数情况下很少能利用到索引。
解读：根据情况可以选择使用union all来代替or。
会把表中所有符合条件的数据装载到内存中，然后在内存中对所有数据根据随机生成的值进行排序，并且可能会对每一行都生成一个随机值，如果满足条件的数据集非常大，就会消耗大量的cpu和io及内存资源。
推荐在程序中获取一个随机值，然后从数据库中获取数据的方式
对列进行函数转换或计算时会导致无法使用索引。
不推荐：
推荐：
1、union会把两个结果集的所有数据放到临时表中后再进行去重操作
2、union all不会再对结果集进行去重操作
1、大sql：逻辑上比较复杂，需要占用大量cpu进行计算的sql
2、mysql：一个sql只能使用一个cpu进行计算
3、sql拆分后可以通过并行执行来提高处理效率
解读：外键与级联更新适用于单机低并发，不适合分布式、高并发集群;级联更新是强阻塞，存在数据库更新风暴的风险；外键影响数据库的插入速度。
<font color='red'> 大批量操作可能会造成严重的主从延迟</font>
主从环境中，大批量操作可能会造成严重的主从延迟，大批量的写操作一般都需要执行一定长的时间，而只有当主库上执行完成后，才会在其他从库上执行，所以会造成主库与从库长时间的延迟情况
<font color='red'> binlog日志为row格式时会产生大量的日志</font>
大批量写操作会产生大量日志，特别是对于row格式二进制数据而言，由于在row格式中会记录每一行数据的修改，我们一次修改的数据越多，产生的日志量也就会越多，日志的传输和恢复所需要的时间也就越长，这也是造成主从延迟的一个原因。
<font color='red'>避免产生大事务操作</font>
大批量修改数据，一定是在一个事务中进行的，这就会造成表中大批量数据进行锁定，从而导致大量的阻塞，阻塞会对mysql的性能产生非常大的影响。
特别是长时间的阻塞会占满所有数据库的可用连接，这会使生产环境中的其他应用无法连接到数据库，因此一定要注意大批量写操作要进行分批。
1、避免大表修改产生的主从延迟
2、避免在对表字段进行修改时进行锁表
对大表数据结构的修改一定要谨慎，会造成严重的锁表操作，尤其是生产环境，是不能容忍的。
pt-online-schema-change它会首先建立一个与原表结构相同的新表，并且在新表上进行表结构的修改，然后再把原表中的数据复制到新表中，并在原表中增加一些触发器。
把原表中新增的数据也复制到新表中，在行所有数据复制完成之后，把新表命名成原表，并把原来的表删除掉。
把原来一个ddl操作，分解成多个小的批次进行。
当达到最大连接数限制时，还运行1个有super权限的用户连接super权限只能留给dba处理问题的账号使用。
程序使用数据库账号只能在一个db下使用，不准跨库 程序使用的账号原则上不准有drop权限。
公共参数是每个接口都要携带的参数，描述每个接口的基本信息，用于统计或其他用途，放在header或url参数中。例如：
字段名称
version
客户端版本。1.0.0
token
登录令牌
os
手机系统版本。12
请求来源。android/ios/h5
screen
手机尺寸。1080*1920
model
机型。iphone7
net
网络状态。wifi
为了方便给客户端响应，响应数据会包含三个属性，状态码（code）,信息描述（message）,响应数据（data）。客户端根据状态码及信息描述可快速知道接口，如果状态码返回成功，再开始处理数据。
array类型数据。通过list字段，保证data的object结构。
分页类型数据。返回总条数，用于判断是否可以加载更多。
列表类数据接口，无论是否要求分页，最好支持分页，pagesize=integer.max即可。
响应结果定义及常用方法：
统一使用string类型。某些情况，统一使用string可以防止解析失败，减少类型转化操作。
boolean类型，1是0否。客户端处理时，非1都是false。
status类型字段，从1+开始，区别boolean的0和1。“0”有两种含义，（1）boolean类型的false，（2）默认的status
上传/下载，参数增加文件md5，用于完整性校验（传输过程可能丢失数据）。
缩小单位保存数据，如：钱以分为单位、距离以米为单位。
获取token一般会涉及到几个参数<code>appid</code>，<code>appkey</code>，<code>timestamp</code>，<code>nonce</code>，<code>sign</code>。我们通过以上几个参数来获取调用系统的凭证。
<code>appid</code>和<code>appkey</code>可以直接通过平台线上申请，也可以线下直接颁发。<code>appid</code>是全局唯一的，每个<code>appid</code>将对应一个客户，<code>appkey</code>需要高度保密。
<code>timestamp</code>是时间戳，使用系统当前的unix时间戳。时间戳的目的就是为了减轻dos攻击。防止请求被拦截后一直尝试请求接口。服务器端设置时间戳阀值，如果请求时间戳和服务器时间超过阀值，则响应失败。
<code>nonce</code>是随机值。随机值主要是为了增加<code>sign</code>的多变性，也可以保护接口的幂等性，相邻的两次请求<code>nonce</code>不允许重复，如果重复则认为是重复提交，响应失败。
<code>sign</code>是参数签名，将<code>appkey</code>，<code>timestamp</code>，<code>nonce</code>拼接起来进行md5加密（当然使用其他方式进行不可逆加密也没问题）。
<code>token</code>，使用参数<code>appid</code>，<code>timestamp</code>，<code>nonce</code>，<code>sign</code>来获取token，作为系统调用的唯一凭证。<code>token</code>可以设置一次有效（这样安全性更高），也可以设置时效性，这里推荐设置时效性。如果一次有效的话这个接口的请求频率可能会很高。<code>token</code>推荐加到请求头上，这样可以跟业务参数完全区分开来。
一般调用接口最常用的两种方式就是get和post。两者的区别也很明显，get请求会将参数暴露在浏览器url中，而且对长度也有限制。为了更高的安全性，所有接口都采用post方式请求。
安全且幂等
获取表示
变更时获取表示（缓存）
==适合查询类的接口使用==
不安全且不幂等
使用服务端管理的（自动产生）的实例号创建资源
创建子资源
部分更新资源
如果没有被修改，则不过更新资源（乐观锁）
==适合数据提交类的接口使用==
不安全但幂等
用客户端管理的实例号创建一个资源
通过替换的方式更新资源
如果未被修改，则更新资源（乐观锁）
==适合更新数据的接口使用==
删除资源
==适合删除数据的接口使用==
ip白名单是指将接口的访问权限对部分ip进行开放。这样就能避免其他ip进行访问攻击，设置ip白名单比较麻烦的一点就是当你的客户端进行迁移后，就需要重新联系服务提供者添加新的ip白名单。设置ip白名单的方式很多，除了传统的防火墙之外，spring cloud alibaba提供的组件sentinel也支持白名单设置。为了降低api的复杂度，推荐使用防火墙规则进行白名单设置。
限流是为了更好的维护系统稳定性。使用redis进行接口调用次数统计，ip+接口地址作为key，访问次数作为value，每次请求value+1，设置过期时长来限制接口的调用频率。
使用aop全局记录请求日志，快速定位异常请求位置，排查问题原因。
在接口调用过程中，可能会涉及到订单号等敏感数据，这类数据通常需要脱敏处理，最常用的方式就是加密。加密方式使用安全性比较高的<code>rsa</code>非对称加密。非对称加密算法有两个密钥，这两个密钥完全不同但又完全匹配。只有使用匹配的一对公钥和私钥，才能完成对明文的加密和解密过程。
客户端尽量不处理逻辑
客户端不处理金额
客户端参数校验规则可以通过接口返回，同时提供默认规则，接口不通则使用默认规则。
图片文案等，与校验规则类似，通过接口返回，并提供默认。
列表界面
多个boolean可以flag替换
采用http的状态码进行数据封装，例如200表示请求成功，4xx表示客户端错误，5xx表示服务器内部发生错误。状态码设计参考如下：
分类
描述
1xx
信息，服务器收到请求，需要请求者继续执行操作
2xx
成功
3xx
重定向，需要进一步的操作以完成请求
4xx
客户端错误，请求包含语法错误或无法完成请求
5xx
服务端错误
状态码枚举类：
响应状态码2xx
200：常规请求
201：创建成功
响应状态码3xx
301：永久重定向
302：暂时重定向
响应状态码4xx
403：请求无权限
404：请求路径不存在
405：请求方法不存在
响应状态码5xx
500：服务器异常
告别编码5分钟，命名2小时！史上最全的java命名规范参考！
java编码命名规范
git分支管理办法