Hand-项目编程规范

关于开发的语义化版本控制规范

1、标准的版本号必须采用X.Y.Z的格式，其中X、Y、Z为非负的整数，且禁止在数字前方补零。

X：主版本号

Y：次版本号

Z：修订号

例如：1.9.1 ——> 1.10.0——>1.11.0/2、

2、标记版本号软件发行后，禁止改变该版本软件内容。任何修改都必须以新版本发行

3、主版本号为零（0.y.z）的软件处于开发初始阶段，一切都可能随时改变。这样的公共API不应该被视为稳定版。以0.1.0作为你的初始化开发版本，并在后续的每次发行时递增次版本号

4、1.0.0版本号用于界定公共API的形成。这一版本之后所有的版本号更新都基于公共API及其修改内容。当你的软件被用于正式环境，它应该已经达到了1.0.0版

5、修订号Z，必须在只做了向下兼容的修正时才递增。这里的修正是指针对不正确结果进行的内部修改

6、次版本号Y，必须在有向下兼容的新功能出现时递增。在任何公共API的功能被标记为弃用时也必须递增。当每次版本号递增时，修订号必须归零

7、主版本号X，必须在有任何不兼容的修改被加入公共API时递增。其中可以包括次版本号及修订级别的改变。每当主版本号递增时，次版本号和修订号必须归零

服务的配置

  在开发过程中需要用到很多配置，为了保持可读性和维护性，配置段不宜过多，控制在4~5段即可，其中第一段为固定段：hzero，第二段为服务/组件段，第三，四段为规则段，最后一段为配置值。例：hzero:platform:init-cache:false

HPFM : 平台服务

HMDM：主数据服务

返回消息

• 按功能划分

服务模块 + 类型 + 功能 + 用途，如： hpfm.error.user.ageNull （年龄不能为空）

• 按服务划分

服务模块+类型+用途，如：hpfm.error.menuNameNull（菜单名称不能为空）

• 按全局划分

hpfm.error.noAuth（没有操作权限，请联系管理员）

返回消息的第二段类型只能是error，info，warn，为了与界面返回消息配置对应，请不要随意发挥

.