代码质量改进:修复架构违规、完善文档注释和清理冗余代码

- 修复 health.go handler 直接操作响应的架构违规问题
- 为 model 字段添加 GORM comment 标签(account_role、base、role_permission)
- 为 handler、service、store 包添加包级文档注释
- 清理 customer service 和 personal_customer handler 中注释掉的代码

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
This commit is contained in:
2026-01-12 16:28:48 +08:00
parent 590614aecc
commit 4507de577b
17 changed files with 50 additions and 41 deletions

View File

@@ -1,3 +1,5 @@
// Package customer 提供客户管理的业务逻辑服务
// 包含客户信息管理、客户查询等功能
package customer
import (
@@ -47,16 +49,7 @@ func (s *Service) Create(ctx context.Context, req *model.CreatePersonalCustomerR
return nil, err
}
// TODO: 创建 PersonalCustomerPhone 记录
// if req.Phone != "" {
// phoneRecord := &model.PersonalCustomerPhone{
// CustomerID: customer.ID,
// Phone: req.Phone,
// IsPrimary: true,
// Status: constants.StatusEnabled,
// }
// // 需要通过 PersonalCustomerPhoneStore 创建
// }
// TODO: 创建 PersonalCustomerPhone 记录,需要通过 PersonalCustomerPhoneStore 创建手机号关联
return customer, nil
}
@@ -69,11 +62,7 @@ func (s *Service) Update(ctx context.Context, id uint, req *model.UpdatePersonal
return nil, errors.New(errors.CodeCustomerNotFound, "个人客户不存在")
}
// 注意:手机号的更新逻辑需要通过 PersonalCustomerPhone 表处理
// TODO: 实现手机号的更新逻辑
// if req.Phone != nil {
// // 通过 PersonalCustomerPhoneStore 更新或创建手机号记录
// }
// TODO: 手机号的更新逻辑需要通过 PersonalCustomerPhoneStore 更新或创建手机号记录
// 更新字段
if req.Nickname != nil {