补全一些接口

2026-07-27 17:17:43 +08:00
parent 072ec1db7e
commit d46ccbd319
8 changed files with 221 additions and 43 deletions
--- a/internal/application/wecom/scene.go
+++ b/internal/application/wecom/scene.go
@@ -90,6 +90,22 @@ func (s *SceneService) InspectTemplate(ctx context.Context, applicationID uint,
 	}, nil
 }

+// ListBusinessFields 返回指定审批场景允许映射的业务快照字段。
+func (s *SceneService) ListBusinessFields(ctx context.Context, businessType string) (*dto.WeComBusinessFieldListResponse, error) {
+	userType := middleware.GetUserTypeFromContext(ctx)
+	if userType != constants.UserTypeSuperAdmin && userType != constants.UserTypePlatform {
+		return nil, errors.New(errors.CodeForbidden)
+	}
+	businessType = strings.TrimSpace(businessType)
+	items, ok := sceneBusinessFields(businessType)
+	if !ok {
+		return nil, errors.New(errors.CodeInvalidParam, "不支持的审批业务类型")
+	}
+	return &dto.WeComBusinessFieldListResponse{
+		BusinessType: businessType, BusinessTypeName: approvalBusinessTypeName(businessType), Items: items,
+	}, nil
+}
+
 // Save 校验模板控件后创建或替换指定稳定业务场景映射。
 func (s *SceneService) Save(ctx context.Context, businessType string, request dto.SaveWeComApprovalSceneRequest) (*dto.WeComApprovalSceneResponse, error) {
 	if s == nil || s.db == nil || s.provider == nil || s.repo == nil {
@@ -269,40 +285,50 @@ func validateSceneMapping(businessType string, mapping []dto.WeComControlMapping
 }

 func allowedSceneBusinessField(businessType, businessField string) bool {
-	allowed := map[string]struct{}{}
-	switch businessType {
-	case constants.ApprovalBusinessTypeOfflineRecharge:
-		allowed = map[string]struct{}{
-			constants.ApprovalFieldRechargeNo:        {},
-			constants.ApprovalFieldShopID:            {},
-			constants.ApprovalFieldShopName:          {},
-			constants.ApprovalFieldAmount:            {},
-			constants.ApprovalFieldAmountCent:        {},
-			constants.ApprovalFieldPaymentVoucherKey: {},
-			constants.ApprovalFieldRemark:            {},
-			constants.ApprovalFieldSubmitterID:       {},
-			constants.ApprovalFieldSubmitterName:     {},
-		}
-	case constants.ApprovalBusinessTypeRefund:
-		allowed = map[string]struct{}{
-			constants.ApprovalFieldRefundNo:              {},
-			constants.ApprovalFieldOrderID:               {},
-			constants.ApprovalFieldOrderNo:               {},
-			constants.ApprovalFieldAssetIdentifier:       {},
-			constants.ApprovalFieldAssetType:             {},
-			constants.ApprovalFieldActualReceivedAmount:  {},
-			constants.ApprovalFieldRequestedRefundAmount: {},
-			constants.ApprovalFieldRefundVoucherKey:      {},
-			constants.ApprovalFieldRefundReason:          {},
-			constants.ApprovalFieldPackageUsageID:        {},
-			constants.ApprovalFieldSubmitterID:           {},
-			constants.ApprovalFieldSubmitterName:         {},
-		}
-	default:
+	fields, ok := sceneBusinessFields(businessType)
+	if !ok {
 		return false
 	}
-	_, exists := allowed[businessField]
-	return exists
+	for _, field := range fields {
+		if field.Code == businessField {
+			return true
+		}
+	}
+	return false
+}
+
+func sceneBusinessFields(businessType string) ([]dto.WeComBusinessFieldResponse, bool) {
+	switch businessType {
+	case constants.ApprovalBusinessTypeOfflineRecharge:
+		return []dto.WeComBusinessFieldResponse{
+			{Code: constants.ApprovalFieldRechargeNo, Name: "充值单号", ValueType: constants.ApprovalFieldValueTypeString, Description: "员工线下代充值单号"},
+			{Code: constants.ApprovalFieldShopID, Name: "目标店铺 ID", ValueType: constants.ApprovalFieldValueTypeInteger, Description: "本次充值目标店铺的系统 ID"},
+			{Code: constants.ApprovalFieldShopName, Name: "目标店铺名称", ValueType: constants.ApprovalFieldValueTypeString, Description: "本次充值目标店铺名称快照"},
+			{Code: constants.ApprovalFieldAmount, Name: "充值金额", ValueType: constants.ApprovalFieldValueTypeMoney, Description: "以元为单位且保留两位小数的充值金额"},
+			{Code: constants.ApprovalFieldAmountCent, Name: "充值金额（分）", ValueType: constants.ApprovalFieldValueTypeInteger, Description: "以分为单位的充值金额整数"},
+			{Code: constants.ApprovalFieldPaymentVoucherKey, Name: "付款凭证", ValueType: constants.ApprovalFieldValueTypeFileList, Description: "提交时上传到企微文件控件的付款凭证列表"},
+			{Code: constants.ApprovalFieldRemark, Name: "备注", ValueType: constants.ApprovalFieldValueTypeString, Description: "员工提交线下代充值时填写的备注"},
+			{Code: constants.ApprovalFieldSubmitterID, Name: "提交人账号 ID", ValueType: constants.ApprovalFieldValueTypeInteger, Description: "本系统真实业务提交人账号 ID"},
+			{Code: constants.ApprovalFieldSubmitterName, Name: "提交人名称", ValueType: constants.ApprovalFieldValueTypeString, Description: "本系统真实业务提交人名称快照"},
+		}, true
+	case constants.ApprovalBusinessTypeRefund:
+		return []dto.WeComBusinessFieldResponse{
+			{Code: constants.ApprovalFieldRefundNo, Name: "退款单号", ValueType: constants.ApprovalFieldValueTypeString, Description: "本次退款申请单号"},
+			{Code: constants.ApprovalFieldOrderID, Name: "订单 ID", ValueType: constants.ApprovalFieldValueTypeInteger, Description: "退款关联订单的系统 ID"},
+			{Code: constants.ApprovalFieldOrderNo, Name: "订单号", ValueType: constants.ApprovalFieldValueTypeString, Description: "退款关联订单号"},
+			{Code: constants.ApprovalFieldAssetIdentifier, Name: "资产标识", ValueType: constants.ApprovalFieldValueTypeString, Description: "退款关联卡或设备的业务标识"},
+			{Code: constants.ApprovalFieldAssetType, Name: "资产类型", ValueType: constants.ApprovalFieldValueTypeString, Description: "退款关联资产类型编码"},
+			{Code: constants.ApprovalFieldActualReceivedAmount, Name: "订单实收金额", ValueType: constants.ApprovalFieldValueTypeMoney, Description: "以元为单位且保留两位小数的订单实收金额"},
+			{Code: constants.ApprovalFieldRequestedRefundAmount, Name: "申请退款金额", ValueType: constants.ApprovalFieldValueTypeMoney, Description: "以元为单位且保留两位小数的本次申请退款金额"},
+			{Code: constants.ApprovalFieldRefundVoucherKey, Name: "退款凭证", ValueType: constants.ApprovalFieldValueTypeFileList, Description: "提交时上传到企微文件控件的退款凭证列表"},
+			{Code: constants.ApprovalFieldRefundReason, Name: "退款原因", ValueType: constants.ApprovalFieldValueTypeString, Description: "业务提交人填写的退款原因"},
+			{Code: constants.ApprovalFieldPackageUsageID, Name: "套餐使用记录 ID", ValueType: constants.ApprovalFieldValueTypeInteger, Description: "退款关联套餐使用记录 ID；无关联记录时可能为空"},
+			{Code: constants.ApprovalFieldSubmitterID, Name: "提交人账号 ID", ValueType: constants.ApprovalFieldValueTypeInteger, Description: "本系统真实业务提交人账号 ID"},
+			{Code: constants.ApprovalFieldSubmitterName, Name: "提交人名称", ValueType: constants.ApprovalFieldValueTypeString, Description: "本系统真实业务提交人名称快照"},
+		}, true
+	default:
+		return nil, false
+	}
 }

 func normalizeSceneMapping(mapping []dto.WeComControlMappingItem) []dto.WeComControlMappingItem {
@@ -323,6 +349,13 @@ func validApprovalBusinessType(businessType string) bool {
 	return businessType == constants.ApprovalBusinessTypeRefund || businessType == constants.ApprovalBusinessTypeOfflineRecharge
 }

+func approvalBusinessTypeName(businessType string) string {
+	if businessType == constants.ApprovalBusinessTypeRefund {
+		return "退款审批"
+	}
+	return "员工线下代充值审批"
+}
+
 func sceneAuditSnapshot(scene *model.WeComApprovalScene) map[string]any {
 	return map[string]any{
 		"business_type": scene.BusinessType, "application_id": scene.ApplicationID,
@@ -336,12 +369,8 @@ func sceneResponse(scene model.WeComApprovalScene) (*dto.WeComApprovalSceneRespo
 	if err := sonic.Unmarshal(scene.ControlMapping, &mapping); err != nil {
 		return nil, errors.Wrap(errors.CodeInternalError, err, "解析企业微信控件映射失败")
 	}
-	name := "员工线下代充值审批"
-	if scene.BusinessType == constants.ApprovalBusinessTypeRefund {
-		name = "退款审批"
-	}
 	return &dto.WeComApprovalSceneResponse{
-		ID: scene.ID, BusinessType: scene.BusinessType, BusinessTypeName: name,
+		ID: scene.ID, BusinessType: scene.BusinessType, BusinessTypeName: approvalBusinessTypeName(scene.BusinessType),
 		ApplicationID: scene.ApplicationID, TemplateID: scene.TemplateID, TemplateName: scene.TemplateName,
 		TemplateFingerprint: scene.TemplateFingerprint,
 		ControlMapping:      mapping, Status: scene.Status, StatusName: constants.GetStatusName(scene.Status),