tyapi-server/internal/domains/api/services/processors/dwbg/dwbg9fb3.md

# DWBG9FB3 个人风险档案 — 响应结构说明

## 概述

`DWBG9FB3`（个人风险档案）本身是一个独立接口，接收三要素入参后，**并发**调用 12 个子产品处理器，将各子接口原始返回数据**直接拼接融合**为一个 JSON 对象返回。

- 不使用 `success` / `data` / `error` 等包装结构
- 顶层 key 为简短**英文单词**字段名
- 每个大字段的 value 即为对应子处理器的原始返回对象
- 子产品调用失败时，该字段值为 `null`，不影响其他字段

## 字段映射表

| 产品编码 | 产品名称 | 英文字段名 | 子处理器 |
| :--- | :--- | :--- | :--- |
| YYSYE7V5 | 手机在网状态V即时版 | `presence` | `ProcessYYSYE7V5Request` |
| YYSYP0T4 | 手机号码在网时长V即时版 | `duration` | `ProcessYYSYP0T4Request` |
| YYSYK9R4 | 全网手机三要素验证 | `triple` | `ProcessYYSYK9R4Request` |
| IVYZN2P8 | 公安二要素政务版 | `identity` | `ProcessIVYZN2P8Request` |
| JRZQV3HM | 债务欺诈黑名单V3 | `fraud` | `ProcessJRZQV3HMRequest` |
| JRZQ4B6C | 探针C | `probe` | `ProcessJRZQ4B6CRequest` |
| JRZQ5E9F | 借选指数 | `rating` | `ProcessJRZQ5E9FRequest` |
| JRZQ3C7B | 借贷意向验证 | `intent` | `ProcessJRZQ3C7BRequest` |
| JRZQV7MD | 特殊名单 | `special` | `ProcessJRZQV7MDRequest` |
| JRZQVT43 | 投诉风险筛查V709 | `complaint` | `ProcessJRZQVT43Request` |
| JRZQV0MD | 行为黑名单 | `behavior` | `ProcessJRZQV0MDRequest` |
| FLXG7E8F | 个人司法数据查询 | `judicial` | `ProcessFLXG7E8FRequest` |

## 请求参数

```json
{
  "id_card": "110101199001011234",
  "name": "张三",
  "mobile_no": "13800138000"
}
```

## 响应结构

顶层为一个扁平对象，12 个字段并列，每个字段 value 为子处理器原始返回的 JSON 对象：

```json
{
  "presence": { },
  "duration": { },
  "triple": { },
  "identity": { },
  "fraud": { },
  "probe": { },
  "rating": { },
  "intent": { },
  "special": { },
  "complaint": { },
  "behavior": { },
  "judicial": { }
}
```

## 响应示例

```json
{
  "presence": {
    "status": "1",
    "operator": "1"
  },
  "duration": {
    "result": "3",
    "desc": "在网时长12-24个月"
  },
  "triple": {
    "state": "1",
    "operator": "1"
  },
  "identity": {
    "result": 0,
    "desc": "一致",
    "sex": "男",
    "birthday": "1990-01-01",
    "address": "北京市东城区"
  },
  "fraud": {
    "hit": 0
  },
  "probe": {
    "score": 650,
    "risk_level": "B"
  },
  "rating": {
    "score": 720,
    "level": "A"
  },
  "intent": {
    "apply_loan": {
      "d7": { "id": 0, "cell": 1 },
      "m1": { "id": 1, "cell": 2 }
    }
  },
  "special": {
    "hit": 0
  },
  "complaint": {
    "hit": 0
  },
  "behavior": {
    "hit": 0
  },
  "judicial": {
    "judicial_data": {
      "lawsuitStat": {
        "count_total": 0,
        "count_jie_total": 0,
        "count_wei_total": 0
      },
      "breachCaseList": [],
      "consumptionRestrictionList": []
    }
  }
}
```

## 部分失败示例

某个子产品查无记录或异常时，对应字段为 `null`，其余字段正常返回：

```json
{
  "presence": {
    "status": "1",
    "operator": "1"
  },
  "judicial": null
}
```

## 调用流程

```mermaid
flowchart LR
    A[DWBG9FB3 请求] --> B[参数校验]
    B --> C[并发调用 12 个子处理器]
    C --> D1[presence]
    C --> D2[duration]
    C --> D3[triple]
    C --> D4[identity]
    C --> D5[fraud]
    C --> D6[probe]
    C --> D7[rating]
    C --> D8[intent]
    C --> D9[special]
    C --> D10[complaint]
    C --> D11[behavior]
    C --> D12[judicial]
    D1 --> E[拼接融合为一个对象]
    D2 --> E
    D3 --> E
    D4 --> E
    D5 --> E
    D6 --> E
    D7 --> E
    D8 --> E
    D9 --> E
    D10 --> E
    D11 --> E
    D12 --> E
    E --> F[返回 JSON]
```

## 实现说明

- 复用 `dwbg8b4d` 中的 `callProcessor`，通过 `CombService.GetProcessor` 按产品编码路由。
- 12 个 goroutine 并发执行，结果写入 `map[英文字段名]子处理器原始数据`。
- 子产品数据保持各处理器原有返回结构，不做二次转换。