# 需求：F002 MCP publish_rfq 补全商务字段

**提出方**：平台助手（nest-api）
**接收方**：devbox 产品网络（renren-supplier-server）
**优先级**：P1
**时间**：2026-06-22

## 一、背景

平台助手正在用 MCP 协议替换旧的 Playwright GUI 流程（`direv-publish` skill），自动把抓取的招标线索发布到 B2B 平台。当前 MCP `publish_rfq` tool（对应 `supplier/inquiry/publish` 接口）只设了 5 个字段，**丢失了 11 个关键商务字段**，导致发布的询价质量远低于旧 GUI 流程。

## 二、当前 F002 publish 实现的问题

`renren-supplier-server` 的 `InquiryServiceImpl.publish()` 当前只设了这些字段：

| ✅ 已设 | ❌ 未设（旧 GUI 流程里有） |
|--------|------------------------|
| `title` | `inquiryValidDate`（截止日期）|
| `note`（来自 description）| `deliverDate`（要求交货日期）|
| `purchaseQuantity` | `shippingAddress`（收货地址）|
| `userId` | `contactName`（联系人）|
| `inquiryEnterpriseId` | `contactPhone`（联系电话）|
| `inquiryEnterpriseName` | `freightFlag`（报价含运费）|
| `orderId` | `paymentMethod`（付款方式）|
| `publishDate` | `invoiceType`（开票要求）|
| `quotationType` | `quotationDemand`（报价要求）|
| `apprStatus` | `name`/`mobile`（询价人姓名/电话）|
| `auditDate` | `inquiryParty`（询价主体）|
| `urls`（附件）| `procurementType`（采购类型）|

**对比**：旧 GUI 流程有 18 个字段 + 商品封面图。

## 三、需求：补全 11 个核心商务字段

### 3.1 MCP `publish_rfq` tool schema 升级

在 `product_network_mcp/src/tools/inquiry.ts` 的 `publish_rfq` zod schema 里增加：

```typescript
{
  title: z.string(),
  description: z.string().optional(),
  qty: z.number().positive().optional(),
  // ===== 新增字段 =====
  deadline: z.string().optional().describe("询价截止日期 YYYY-MM-DD（映射 inquiryValidDate）"),
  deliveryDate: z.string().optional().describe("要求交货日期 YYYY-MM-DD（映射 deliverDate）"),
  shippingAddress: z.string().optional().describe("收货地址（映射 shippingAddress）"),
  contactName: z.string().optional().describe("联系人（映射 contactName）"),
  contactPhone: z.string().optional().describe("联系电话（映射 contactPhone）"),
  freightFlag: z.enum(["含运费", "不含运费"]).optional().describe("报价是否含运费"),
  paymentMethod: z.string().optional().describe("付款方式名称，如 货到付款（映射 paymentMethod 字典）"),
  invoiceType: z.enum(["增值税专票", "增值税普票", "不开发票"]).optional().describe("开票要求（1/2/3）"),
  procurementType: z.string().optional().describe("采购类型：定量采购/议价采购（映射 procurementType 字典）"),
  inquiryParty: z.string().optional().describe("询价主体（公司名，如 郑州巨变网络科技有限公司）"),
  // ===== 现有字段保留 =====
  userId: z.number().optional(),
  enterpriseId: z.number().optional(),
  enterpriseName: z.string().optional(),
  attachments: z.array(z.string()).optional(),
}
```

### 3.2 Java 后端 `InquiryServiceImpl.publish()` 升级

`renren-supplier-server/src/main/java/io/renren/service/impl/InquiryServiceImpl.java`

**当前实现**（F002 简化版）只设了 6 个字段，需要补：

```java
public Result<Map<String, Object>> publish(Map<String, Object> params) {
    InquiryEntity inquiryEntity = new InquiryEntity();

    // ===== 已有字段 =====
    inquiryEntity.setTitle((String) params.get("title"));
    inquiryEntity.setNote((String) params.get("description"));
    // qty / userId / enterpriseId / enterpriseName / urls / 系统字段...

    // ===== 新增字段映射 =====

    // 截止日期（YYYY-MM-DD 字符串 → Date）
    String deadline = (String) params.get("deadline");
    if (StringUtils.isNotBlank(deadline)) {
        inquiryEntity.setInquiryValidDate(DateUtil.parse(deadline, "yyyy-MM-dd"));
    }

    // 要求交货日期
    String deliveryDate = (String) params.get("deliveryDate");
    if (StringUtils.isNotBlank(deliveryDate)) {
        inquiryEntity.setDeliverDate(DateUtil.parse(deliveryDate, "yyyy-MM-dd"));
    }

    // 收货地址
    String shippingAddress = (String) params.get("shippingAddress");
    if (StringUtils.isNotBlank(shippingAddress)) {
        inquiryEntity.setShippingAddress(shippingAddress);
    }

    // 联系人/电话
    String contactName = (String) params.get("contactName");
    if (StringUtils.isNotBlank(contactName)) {
        inquiryEntity.setContactName(contactName);
    }
    String contactPhone = (String) params.get("contactPhone");
    if (StringUtils.isNotBlank(contactPhone)) {
        inquiryEntity.setContactPhone(contactPhone);
    }

    // 询价主体
    String inquiryParty = (String) params.get("inquiryParty");
    if (StringUtils.isNotBlank(inquiryParty)) {
        inquiryEntity.setInquiryParty(inquiryParty);
    }

    // 报价含运费（0=不含/1=含）
    String freightFlag = (String) params.get("freightFlag");
    if ("含运费".equals(freightFlag)) {
        inquiryEntity.setFreightFlag("1");
    } else if ("不含运费".equals(freightFlag)) {
        inquiryEntity.setFreightFlag("0");
    }

    // 采购类型（字典映射：定量采购/议价采购 → procurementType 枚举值）
    // 需要确认现有字典值

    // 付款方式（字符串 → paymentMethod 字典 ID，需要查 supplier-server 的字典表）
    // 建议：先按字符串存，Java 后端查表映射

    // 发票要求（1/2/3）
    String invoiceType = (String) params.get("invoiceType");
    if ("增值税专票".equals(invoiceType)) {
        inquiryEntity.setInvoiceType(1);
    } else if ("增值税普票".equals(invoiceType)) {
        inquiryEntity.setInvoiceType(2);
    } else if ("不开发票".equals(invoiceType)) {
        inquiryEntity.setInvoiceType(3);
    }

    // ... 系统字段保持不变
    insert(inquiryEntity);

    // 返回不变
    Map<String, Object> result = new HashMap<>();
    result.put("rfqId", inquiryEntity.getId());
    result.put("orderId", orderId);
    result.put("status", "published");
    return new Result<Map<String, Object>>().ok(result);
}
```

## 四、验收标准

升级后，平台助手通过 MCP `publish_rfq` 发布一条询价，在 B2B 平台 `list_my_rfqs` 接口查询时，能看到以下字段都正确填充：

- ✅ `note`（备注）
- ✅ `purchaseQuantity`（数量）
- ✅ `inquiryValidDate`（截止日期，非 null）
- ✅ `deliverDate`（交货日期，非 null）
- ✅ `shippingAddress`（收货地址）
- ✅ `contactName`（联系人）
- ✅ `contactPhone`（电话）
- ✅ `inquiryParty`（询价主体）
- ✅ `freightFlag`（运费标识）
- ✅ `invoiceType`（发票类型）
- ✅ `quotationType`（报价方式）

## 五、不在本次升级范围

下列字段有特殊复杂度，**不在本次升级中处理**：

- ❌ `match_category` 智能匹配（API 暂未实现，等 devbox 后端补齐）
- ❌ 商品封面图（MCP 无对应机制，旧 GUI 用 AI 生图，新 MCP 不支持）
- ❌ 多商品（询价单 → 询价明细 1:N，旧 GUI 是单商品）

## 六、测试用例

升级后请用以下 payload 测试：

```json
{
  "title": "【测试】新疆水泥采购 100 吨",
  "description": "P.O 42.5 普通硅酸盐水泥",
  "qty": 100,
  "deadline": "2026-12-31",
  "deliveryDate": "2027-01-30",
  "shippingAddress": "新疆乌鲁木齐市新市区XX路XX号",
  "contactName": "郑钊",
  "contactPhone": "15532027557",
  "freightFlag": "含运费",
  "paymentMethod": "货到付款",
  "invoiceType": "增值税专票",
  "inquiryParty": "郑州巨变网络科技有限公司",
  "attachments": ["https://example.com/notice.pdf"]
}
```

调用 `list_my_rfqs` 验证上述字段都被持久化。

## 七、平台助手这边的改动（已完成）

✅ Lead 模型已加 4 个新字段：`quantity`、`unit`、`regionDetail`、`attachments`
✅ `publishToDirev` 参数拼接逻辑已改：只传 schema 接受的字段（不传 unknown 字段）
✅ 端到端验证：当前新 schema 下能成功创建询价并拿到真 rfqId

待 devbox 升级 schema 后，平台助手这边只需把新参数加进 `publishToDirev` 的 `publishArgs` 对象即可，无需改 schema/迁移数据。