| 
									
										
										
										
											2025-03-23 09:44:16 +08:00
										 |  |  |  |  ## maven 模块说明: | 
					
						
							| 
									
										
										
										
											2025-03-22 20:49:13 +08:00
										 |  |  |  | 
 | 
					
						
							| 
									
										
										
										
											2025-03-23 09:44:16 +08:00
										 |  |  |  | ### code-util(实体代码生成器)
 | 
					
						
							| 
									
										
										
										
											2025-03-22 20:49:13 +08:00
										 |  |  |  | 
 | 
					
						
							| 
									
										
										
										
											2025-05-27 15:03:45 +08:00
										 |  |  |  | ### bd-api(RPC调用接口)
 | 
					
						
							|  |  |  |  |     bd-api-activity -- 活动服务接口以及RPC传输数据DTO实体 | 
					
						
							|  |  |  |  |     bd-api-bonus -- 奖金服务接口以及RPC传输数据DTO实体 | 
					
						
							|  |  |  |  |     bd-api-member -- 会员服务接口以及RPC传输数据DTO实体 | 
					
						
							|  |  |  |  |     bd-api-report -- 报表服务接口以及RPC传输数据DTO实体 | 
					
						
							|  |  |  |  |     bd-api-system -- 系统基础服务接口以及RPC传输数据DTO实体 | 
					
						
							|  |  |  |  |     bd-api-third -- 三方服务接口以及RPC传输数据DTO实体 | 
					
						
							| 
									
										
										
										
											2025-03-22 20:49:13 +08:00
										 |  |  |  | 
 | 
					
						
							| 
									
										
										
										
											2025-03-23 09:44:16 +08:00
										 |  |  |  | ### hzs-business(业务相关服务)
 | 
					
						
							|  |  |  |  |     hzs-business-activity -- 活动服务(所有活动等)  8095 | 
					
						
							|  |  |  |  |     hzs-business-bonus -- 奖金服务(奖金计算等)  8098 | 
					
						
							|  |  |  |  |     hzs-business-common -- 业务服务公共类(工具类) | 
					
						
							|  |  |  |  |     hzs-business-member -- 会员服务(会员、账户、银行等)  8092 | 
					
						
							|  |  |  |  |     hzs-business-report -- 报表服务(统计分析、仪表盘等)  8097 | 
					
						
							|  |  |  |  |     hzs-business-system -- 系统基础服务(基础配置、自定义配置等)   8091 | 
					
						
							| 
									
										
										
										
											2025-03-22 20:49:13 +08:00
										 |  |  |  | 
 | 
					
						
							| 
									
										
										
										
											2025-03-23 09:44:16 +08:00
										 |  |  |  | ### hzs-common(基础公用组件)
 | 
					
						
							|  |  |  |  |     hzs-common-core -- 核心公用组件、缓存操作等 | 
					
						
							|  |  |  |  |     hzs-common-domain -- 系统对应数据库实体以及扩展分类 | 
					
						
							|  |  |  |  |     hzs-common-security -- security用户鉴权依赖组件  | 
					
						
							| 
									
										
										
										
											2025-03-22 20:49:13 +08:00
										 |  |  |  | 
 | 
					
						
							| 
									
										
										
										
											2025-05-27 15:03:45 +08:00
										 |  |  |  | ### bd-gateway(统一网关入口)
 | 
					
						
							|  |  |  |  |     bd-gateway -- 统一网关  8080 | 
					
						
							| 
									
										
										
										
											2025-03-23 09:44:16 +08:00
										 |  |  |  |      | 
					
						
							|  |  |  |  | ### hzs-third(三方服务)
 | 
					
						
							|  |  |  |  |     hzs-third -- 三方服务(支付、短信、邮件、物流)以及MQ等异步接收消息处理  8082 | 
					
						
							| 
									
										
										
										
											2025-03-22 20:49:13 +08:00
										 |  |  |  | 
 | 
					
						
							| 
									
										
										
										
											2025-03-23 09:44:16 +08:00
										 |  |  |  | ### 订单编号获取方法
 | 
					
						
							|  |  |  |  |     方法:CommonUtil.createSerialNumber("") | 
					
						
							|  |  |  |  |     前缀枚举:EOrderPrefix | 
					
						
							| 
									
										
										
										
											2025-03-22 20:49:13 +08:00
										 |  |  |  | 
 | 
					
						
							| 
									
										
										
										
											2025-03-23 09:44:16 +08:00
										 |  |  |  | ### 枚举类添加
 | 
					
						
							|  |  |  |  |     枚举类添加时,对应的国际化翻译key值,需要在 EnumsPrefixConstants 常量中添加对应的前缀 | 
					
						
							| 
									
										
										
										
											2025-03-22 20:49:13 +08:00
										 |  |  |  | 
 | 
					
						
							| 
									
										
										
										
											2025-03-23 09:44:16 +08:00
										 |  |  |  | ### 用户ID转用户处理
 | 
					
						
							|  |  |  |  |     数据库中保存用户ID转化为用户实际,调用 IBusinessCommonService 接口中的方法进行统一转换处理 | 
					
						
							| 
									
										
										
										
											2025-03-22 20:49:13 +08:00
										 |  |  |  | 
 | 
					
						
							| 
									
										
										
										
											2025-03-23 09:44:16 +08:00
										 |  |  |  | ### 枚举返回处理
 | 
					
						
							|  |  |  |  |     后台接口返回枚举列表时,统一在 EnumsController 中进行添加处理 | 
					
						
							| 
									
										
										
										
											2025-03-22 20:49:13 +08:00
										 |  |  |  | 
 | 
					
						
							| 
									
										
										
										
											2025-03-23 09:44:16 +08:00
										 |  |  |  | ### 日志拦截处理
 | 
					
						
							|  |  |  |  |     后台管理端controller层涉及到的操作方法,需要添加 @Log 注解,用于记录管理后操作日志 | 
					
						
							| 
									
										
										
										
											2025-03-22 20:49:13 +08:00
										 |  |  |  | 
 | 
					
						
							|  |  |  |  | 
 | 
					
						
							| 
									
										
										
										
											2025-03-23 09:44:16 +08:00
										 |  |  |  | 
 | 
					
						
							|  |  |  |  | ## 分支说明:
 | 
					
						
							|  |  |  |  | 
 | 
					
						
							|  |  |  |  | ### 日志拦截处理
 | 
					
						
							|  |  |  |  |     dev_inter分支: 为当前研发主分支,正常需求迭代以及非紧急BUG修改都提交到该分支,正常进行迭代开发。 | 
					
						
							|  |  |  |  | 
 | 
					
						
							|  |  |  |  | ### 日志拦截处理
 | 
					
						
							|  |  |  |  |     pre分支:预上线(测试)分支,由 dev_inter 分支中提交内容提取合并而来,该分支进行测试并测试通过后进行上线。 | 
					
						
							|  |  |  |  | 
 | 
					
						
							|  |  |  |  | ### 日志拦截处理
 | 
					
						
							|  |  |  |  |     release分支:线上分支,pre 分支上线稳定后,将 pre 分支合并到该分支,做为线上稳定分支。如果有加急BUG需要上线,从此分支拉取临时上线分支进行上线,上线成功后,合并回本分支。 |