team/tyapi-server
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

new

Browse Source
This commit is contained in:
liangzai
2025-09-20 23:29:49 +08:00
parent 7b1b75e7a9
commit 1b931cb816
13 changed files with 582 additions and 37 deletions
Download Patch File Download Diff File Expand all files Collapse all files

25
internal/domains/api/dto/api_request_dto.go
View File

@@ -277,6 +277,31 @@ type IVYZ7F3AReq struct {
Authorized string `json:"authorized" validate:"required,oneof=0 1"`
}
// 新增的QYGL处理器DTO
type QYGL5A3CReq struct {
EntCode string `json:"ent_code" validate:"required,validUSCI"`
PageSize int `json:"page_size" validate:"omitempty,min=1,max=100"`
PageNum int `json:"page_num" validate:"omitempty,min=1"`
}
type QYGL8B4DReq struct {
EntCode string `json:"ent_code" validate:"required,validUSCI"`
PageSize int `json:"page_size" validate:"omitempty,min=1,max=100"`
PageNum int `json:"page_num" validate:"omitempty,min=1"`
}
type QYGL9E2FReq struct {
EntCode string `json:"ent_code" validate:"required,validUSCI"`
PageSize int `json:"page_size" validate:"omitempty,min=1,max=100"`
PageNum int `json:"page_num" validate:"omitempty,min=1"`
}
type QYGL7C1AReq struct {
EntCode string `json:"ent_code" validate:"required,validUSCI"`
PageSize int `json:"page_size" validate:"omitempty,min=1,max=100"`
PageNum int `json:"page_num" validate:"omitempty,min=1"`
}
type YYSY4F2EReq struct {
MobileNo string `json:"mobile_no" validate:"required,min=11,max=11,validMobileNo"`
IDCard string `json:"id_card" validate:"required,validIDCard"`

35
internal/domains/api/services/api_request_service.go
View File

@@ -2,6 +2,7 @@ package services
import (
"context"
"encoding/json"
"fmt"
"tyapi-server/internal/application/api/commands"
@@ -119,6 +120,10 @@ func registerAllProcessors(combService *comb.CombService) {
"QYGL8271": qygl.ProcessQYGL8271Request,
"QYGLB4C0": qygl.ProcessQYGLB4C0Request,
"QYGL23T7": qygl.ProcessQYGL23T7Request, // 企业三要素验证
"QYGL5A3C": qygl.ProcessQYGL5A3CRequest, // 对外投资历史
"QYGL8B4D": qygl.ProcessQYGL8B4DRequest, // 融资历史
"QYGL9E2F": qygl.ProcessQYGL9E2FRequest, // 行政处罚
"QYGL7C1A": qygl.ProcessQYGL7C1ARequest, // 经营异常
"COMENT01": qygl.ProcessCOMENT01Request, // 企业风险报告
// YYSY系列处理器
@@ -151,9 +156,8 @@ func registerAllProcessors(combService *comb.CombService) {
"IVYZ5E3F": ivyz.ProcessIVYZ5E3FRequest,
"IVYZ7F3A": ivyz.ProcessIVYZ7F3ARequest,
// COMB系列处理器
"COMB298Y": comb.ProcessCOMB298YRequest,
"COMB86PM": comb.ProcessCOMB86PMRequest,
// COMB系列处理器 - 只注册有自定义逻辑的组合包
"COMB86PM": comb.ProcessCOMB86PMRequest, // 有自定义逻辑：重命名ApiCode
// QCXG系列处理器
"QCXG7A2B": qcxg.ProcessQCXG7A2BRequest,
@@ -185,10 +189,31 @@ var RequestProcessors map[string]processors.ProcessorFunc
// PreprocessRequestApi 调用指定的请求处理函数
func (a *ApiRequestService) PreprocessRequestApi(ctx context.Context, apiCode string, params []byte, options *commands.ApiCallOptions, callContext *processors.CallContext) ([]byte, error) {
// 设置Options和CallContext到依赖容器
deps := a.processorDeps.WithOptions(options).WithCallContext(callContext)
// 1. 优先查找已注册的自定义处理器
if processor, exists := RequestProcessors[apiCode]; exists {
// 设置Options和CallContext到依赖容器
deps := a.processorDeps.WithOptions(options).WithCallContext(callContext)
return processor(ctx, params, deps)
}
// 2. 检查是否为组合包（COMB开头），使用通用组合包处理器
if len(apiCode) >= 4 && apiCode[:4] == "COMB" {
return a.processGenericCombRequest(ctx, apiCode, params, deps)
}
return nil, fmt.Errorf("%s: 未找到处理器: %s", ErrSystem, apiCode)
}
// processGenericCombRequest 通用组合包处理器
func (a *ApiRequestService) processGenericCombRequest(ctx context.Context, apiCode string, params []byte, deps *processors.ProcessorDependencies) ([]byte, error) {
// 调用组合包服务处理请求
// 这里不需要验证参数，因为组合包的参数验证由各个子处理器负责
combinedResult, err := deps.CombService.ProcessCombRequest(ctx, params, deps, apiCode)
if err != nil {
return nil, err
}
// 直接返回组合结果，无任何自定义处理
return json.Marshal(combinedResult)
}

18
internal/domains/api/services/form_config_service.go
View File

@@ -88,6 +88,10 @@ func (s *FormConfigServiceImpl) getDTOStruct(apiCode string) interface{} {
"QYGL8271": &dto.QYGL8271Req{},
"QYGLB4C0": &dto.QYGLB4C0Req{},
"QYGL23T7": &dto.QYGL23T7Req{},
"QYGL5A3C": &dto.QYGL5A3CReq{},
"QYGL8B4D": &dto.QYGL8B4DReq{},
"QYGL9E2F": &dto.QYGL9E2FReq{},
"QYGL7C1A": &dto.QYGL7C1AReq{},
"YYSY4B37": &dto.YYSY4B37Req{},
"YYSY4B21": &dto.YYSY4B21Req{},
"YYSY6F2E": &dto.YYSY6F2EReq{},
@@ -131,7 +135,19 @@ func (s *FormConfigServiceImpl) getDTOStruct(apiCode string) interface{} {
"FLXG8B4D": &dto.FLXG8B4DReq{},
}
return dtoMap[apiCode]
// 优先返回已配置的DTO
if dto, exists := dtoMap[apiCode]; exists {
return dto
}
// 检查是否为通用组合包（COMB开头且未单独配置）
if len(apiCode) >= 4 && apiCode[:4] == "COMB" {
// 对于通用组合包，返回一个通用的空结构体，表示无需特定参数验证
// 因为组合包的参数验证由各个子处理器负责
return &struct{}{}
}
return nil
}
// parseDTOFields 通过反射解析DTO结构体字段

74
internal/domains/api/services/processors/comb/README.md Normal file
View File

@@ -0,0 +1,74 @@
# 组合包处理器说明
## 🚀 动态组合包机制
从现在开始，组合包支持**动态处理机制**，大大简化了组合包的开发和维护工作。
## 📋 工作原理
### 1. 自动识别
- 所有以 `COMB` 开头的API编码会被自动识别为组合包
- 系统会自动调用通用组合包处理器处理请求
### 2. 处理流程
1. **优先级检查**：首先检查是否有注册的自定义处理器
2. **通用处理**：如果没有自定义处理器，且API编码以COMB开头，使用通用处理器
3. **数据库驱动**：根据数据库中的组合包配置自动调用相应的子产品处理器
## 🛠️ 使用方式
### 普通组合包（无自定义逻辑）
**只需要在数据库配置，无需编写任何代码！**
1. 在 `products` 表中创建组合包产品：
```sql
INSERT INTO products (code, name, is_package, ...)
VALUES ('COMB1234', '新组合包', true, ...);
```
2. 在 `product_package_items` 表中配置子产品：
```sql
INSERT INTO product_package_items (package_id, product_id, sort_order)
VALUES
('组合包产品ID', '子产品1ID', 1),
('组合包产品ID', '子产品2ID', 2);
```
3. **直接调用**：无需任何额外编码，API立即可用！
### 自定义组合包（有特殊逻辑）
如果需要对组合包结果进行后处理，才需要编写代码：
1. **创建处理器文件**：`combXXXX_processor.go`
2. **注册处理器**：在 `api_request_service.go` 中注册
3. **实现自定义逻辑**：在处理器中实现特殊业务逻辑
## 📁 现有组合包示例
### COMB86PM（自定义处理器）
```go
// 有自定义逻辑：重命名子产品ApiCode
for _, resp := range combinedResult.Responses {
if resp.ApiCode == "FLXGBC21" {
resp.ApiCode = "FLXG54F5"
}
}
```
### COMB298Y（通用处理器）
- **无需编码**：已删除专门的处理器文件
- **自动处理**：通过数据库配置自动工作
## ✅ 优势
1. **零配置**：普通组合包只需数据库配置，无需编码
2. **灵活性**：特殊需求仍可通过自定义处理器实现
3. **维护性**：减少重复代码，统一处理逻辑
4. **扩展性**：新增组合包极其简单，配置即用
## 🔧 开发建议
1. **优先使用通用处理器**：除非有特殊业务逻辑，否则不要编写自定义处理器
2. **命名规范**：组合包编码必须以 `COMB` 开头
3. **数据库配置**：确保组合包在数据库中正确配置了 `is_package=true` 和子产品关系
4. **排序控制**：通过 `sort_order` 字段控制子产品在响应中的顺序

30
internal/domains/api/services/processors/comb/comb298y_processor.go
View File

@@ -1,30 +0,0 @@
package comb
import (
"context"
"encoding/json"
"errors"
"tyapi-server/internal/domains/api/dto"
"tyapi-server/internal/domains/api/services/processors"
)
// ProcessCOMB298YRequest COMB298Y API处理方法
func ProcessCOMB298YRequest(ctx context.Context, params []byte, deps *processors.ProcessorDependencies) ([]byte, error) {
var paramsDto dto.COMB298YReq
if err := json.Unmarshal(params, &paramsDto); err != nil {
return nil, errors.Join(processors.ErrSystem, err)
}
if err := deps.Validator.ValidateStruct(paramsDto); err != nil {
return nil, errors.Join(processors.ErrInvalidParam, err)
}
// 调用组合包服务处理请求
// Options会自动传递给所有子处理器
combinedResult, err := deps.CombService.ProcessCombRequest(ctx, params, deps, "COMB298Y")
if err != nil {
return nil, err
}
return json.Marshal(combinedResult)
}

63
internal/domains/api/services/processors/qygl/qygl5a3c_processor.go Normal file
View File

@@ -0,0 +1,63 @@
package qygl
import (
"context"
"encoding/json"
"errors"
"strconv"
"tyapi-server/internal/domains/api/dto"
"tyapi-server/internal/domains/api/services/processors"
)
// ProcessQYGL5A3CRequest QYGL5A3C API处理方法 - 对外投资历史
func ProcessQYGL5A3CRequest(ctx context.Context, params []byte, deps *processors.ProcessorDependencies) ([]byte, error) {
var paramsDto dto.QYGL5A3CReq
if err := json.Unmarshal(params, &paramsDto); err != nil {
return nil, errors.Join(processors.ErrSystem, err)
}
if err := deps.Validator.ValidateStruct(paramsDto); err != nil {
return nil, errors.Join(processors.ErrInvalidParam, err)
}
// 设置默认值
pageSize := paramsDto.PageSize
if pageSize == 0 {
pageSize = 20
}
pageNum := paramsDto.PageNum
if pageNum == 0 {
pageNum = 1
}
// 构建API调用参数
apiParams := map[string]string{
"keyword": paramsDto.EntCode,
"pageSize": strconv.Itoa(pageSize),
"pageNum": strconv.Itoa(pageNum),
}
// 调用天眼查API - 对外投资历史
response, err := deps.TianYanChaService.CallAPI(ctx, "InvestHistory", apiParams)
if err != nil {
if err.Error() == "数据源异常" {
return nil, errors.Join(processors.ErrDatasource, err)
} else {
return nil, errors.Join(processors.ErrSystem, err)
}
}
// 检查天眼查API调用是否成功
if !response.Success {
return nil, errors.Join(processors.ErrDatasource, errors.New(response.Message))
}
// 返回天眼查响应数据
respBytes, err := json.Marshal(response.Data)
if err != nil {
return nil, errors.Join(processors.ErrSystem, err)
}
return respBytes, nil
}

63
internal/domains/api/services/processors/qygl/qygl7c1a_processor.go Normal file
View File

@@ -0,0 +1,63 @@
package qygl
import (
"context"
"encoding/json"
"errors"
"strconv"
"tyapi-server/internal/domains/api/dto"
"tyapi-server/internal/domains/api/services/processors"
)
// ProcessQYGL7C1ARequest QYGL7C1A API处理方法 - 经营异常
func ProcessQYGL7C1ARequest(ctx context.Context, params []byte, deps *processors.ProcessorDependencies) ([]byte, error) {
var paramsDto dto.QYGL7C1AReq
if err := json.Unmarshal(params, &paramsDto); err != nil {
return nil, errors.Join(processors.ErrSystem, err)
}
if err := deps.Validator.ValidateStruct(paramsDto); err != nil {
return nil, errors.Join(processors.ErrInvalidParam, err)
}
// 设置默认值
pageSize := paramsDto.PageSize
if pageSize == 0 {
pageSize = 20
}
pageNum := paramsDto.PageNum
if pageNum == 0 {
pageNum = 1
}
// 构建API调用参数
apiParams := map[string]string{
"keyword": paramsDto.EntCode,
"pageSize": strconv.Itoa(pageSize),
"pageNum": strconv.Itoa(pageNum),
}
// 调用天眼查API - 经营异常
response, err := deps.TianYanChaService.CallAPI(ctx, "AbnormalInfo", apiParams)
if err != nil {
if err.Error() == "数据源异常" {
return nil, errors.Join(processors.ErrDatasource, err)
} else {
return nil, errors.Join(processors.ErrSystem, err)
}
}
// 检查天眼查API调用是否成功
if !response.Success {
return nil, errors.Join(processors.ErrDatasource, errors.New(response.Message))
}
// 返回天眼查响应数据
respBytes, err := json.Marshal(response.Data)
if err != nil {
return nil, errors.Join(processors.ErrSystem, err)
}
return respBytes, nil
}

63
internal/domains/api/services/processors/qygl/qygl8b4d_processor.go Normal file
View File

@@ -0,0 +1,63 @@
package qygl
import (
"context"
"encoding/json"
"errors"
"strconv"
"tyapi-server/internal/domains/api/dto"
"tyapi-server/internal/domains/api/services/processors"
)
// ProcessQYGL8B4DRequest QYGL8B4D API处理方法 - 融资历史
func ProcessQYGL8B4DRequest(ctx context.Context, params []byte, deps *processors.ProcessorDependencies) ([]byte, error) {
var paramsDto dto.QYGL8B4DReq
if err := json.Unmarshal(params, &paramsDto); err != nil {
return nil, errors.Join(processors.ErrSystem, err)
}
if err := deps.Validator.ValidateStruct(paramsDto); err != nil {
return nil, errors.Join(processors.ErrInvalidParam, err)
}
// 设置默认值
pageSize := paramsDto.PageSize
if pageSize == 0 {
pageSize = 20
}
pageNum := paramsDto.PageNum
if pageNum == 0 {
pageNum = 1
}
// 构建API调用参数
apiParams := map[string]string{
"keyword": paramsDto.EntCode,
"pageSize": strconv.Itoa(pageSize),
"pageNum": strconv.Itoa(pageNum),
}
// 调用天眼查API - 融资历史
response, err := deps.TianYanChaService.CallAPI(ctx, "FinancingHistory", apiParams)
if err != nil {
if err.Error() == "数据源异常" {
return nil, errors.Join(processors.ErrDatasource, err)
} else {
return nil, errors.Join(processors.ErrSystem, err)
}
}
// 检查天眼查API调用是否成功
if !response.Success {
return nil, errors.Join(processors.ErrDatasource, errors.New(response.Message))
}
// 返回天眼查响应数据
respBytes, err := json.Marshal(response.Data)
if err != nil {
return nil, errors.Join(processors.ErrSystem, err)
}
return respBytes, nil
}

63
internal/domains/api/services/processors/qygl/qygl9e2f_processor.go Normal file
View File

@@ -0,0 +1,63 @@
package qygl
import (
"context"
"encoding/json"
"errors"
"strconv"
"tyapi-server/internal/domains/api/dto"
"tyapi-server/internal/domains/api/services/processors"
)
// ProcessQYGL9E2FRequest QYGL9E2F API处理方法 - 行政处罚
func ProcessQYGL9E2FRequest(ctx context.Context, params []byte, deps *processors.ProcessorDependencies) ([]byte, error) {
var paramsDto dto.QYGL9E2FReq
if err := json.Unmarshal(params, &paramsDto); err != nil {
return nil, errors.Join(processors.ErrSystem, err)
}
if err := deps.Validator.ValidateStruct(paramsDto); err != nil {
return nil, errors.Join(processors.ErrInvalidParam, err)
}
// 设置默认值
pageSize := paramsDto.PageSize
if pageSize == 0 {
pageSize = 20
}
pageNum := paramsDto.PageNum
if pageNum == 0 {
pageNum = 1
}
// 构建API调用参数
apiParams := map[string]string{
"keyword": paramsDto.EntCode,
"pageSize": strconv.Itoa(pageSize),
"pageNum": strconv.Itoa(pageNum),
}
// 调用天眼查API - 行政处罚
response, err := deps.TianYanChaService.CallAPI(ctx, "PunishmentInfo", apiParams)
if err != nil {
if err.Error() == "数据源异常" {
return nil, errors.Join(processors.ErrDatasource, err)
} else {
return nil, errors.Join(processors.ErrSystem, err)
}
}
// 检查天眼查API调用是否成功
if !response.Success {
return nil, errors.Join(processors.ErrDatasource, errors.New(response.Message))
}
// 返回天眼查响应数据
respBytes, err := json.Marshal(response.Data)
if err != nil {
return nil, errors.Join(processors.ErrSystem, err)
}
return respBytes, nil
}