# 采集协议单 · 一键导入标准信息

> 日期：2026-07-02  
> 状态：已实现  
> 关联：`ProtocolFormDialog.vue`、捐赠单 `DonationFormDialog.vue` + `donation-standard-import-parse.ts`  
> 参考样例：客户提供的标准信息1（单样本趸交）、标准信息2（双存部分缴费）

---

## 1. 背景与目标

采集协议单**新增**弹窗需支持「一键导入」：粘贴客户标准文本，解析后填充各 Tab 字段。交互与捐赠协议单一致（左侧粘贴区 + 右侧基本信息，仅新增模式展示）。

### 1.1 已确认业务规则

| 规则 | 决策 |
|------|------|
| **金额** | **以标准信息中的金额为准**（合同金额、转账金额等），不以样本优惠价自动合计覆盖导入结果 |
| **缴费方式** | 文本为「微信 / 支付宝 / 银行卡 / 现金」等时，**默认趸交 `dj`**；仅当明确出现「分期」时设为 `fq` |
| **转账方式** | 「转账方式：微信」或「缴费方式：微信」（非分期语义）→ 映射字典 `zzfs`（如微信→`wxzz`） |
| **导入策略** | 点击一键导入时**先清空**可覆盖字段，再按当前粘贴内容填充（与捐赠单一致） |
| **协议级采集时间** | 多样本时取各样本采集时间中的**最早值** |

### 1.2 非目标

- 后端新 API（纯前端解析 + 既有 lookup 接口）
- 编辑模式下一键导入
- 附件、协议号自动生成规则变更

---

## 2. 标准文本格式

### 2.1 标准信息1（单样本 · 趸交 · 两笔转账）

```
围产期干细胞储存
造血干细胞:ZKZX34000870
产妇姓名：刘晓艳
…
缴费方式：趸交
转账方式：微信
合同金额：22880元
转账金额：22880元
转账时间：2026年6月17日13时09分05秒2000元，6月18日15:50:12付20880元
孕妇电话：13966850002
运输方式：顺丰快递
预计送达时间:
```

### 2.2 标准信息2（双存 · 部分缴费 · 人员携带）

```
围产期干细胞储存（双存）
造血干细胞:ZKZX34000922
脐带间充质干细胞：ZKQD34000839
…
缴费方式：微信
合同金额：37000元
转账金额：2000元
转账时间：2026年3月10日11:34:40
运输方式：露露帮助到医院取样本送到实验室
备注：剩余尾款两天内交清
```

---

## 3. 字段映射

### 3.1 公共字段（与捐赠类似）

| 客户 key / 模式 | 目标字段 | 备注 |
|-----------------|----------|------|
| 产妇姓名 | 母亲姓名 / 关联客户 | 远程匹配 |
| 孕妇电话 | `motherPhone` | 去空格 |
| 新生儿性别 | `newbornSex` | 男孩/女孩 |
| 新生儿体重 | `newbornWeightGram` | |
| 新生儿评分 | `apgar1min` | |
| 分娩时间 | `newbornDeliveryTime` | |
| 母血采集时间 | `maternalBloodCollectTime` | 未采集→清空 |
| 分娩方式 | `deliveryMode` | 含「刨宫产」→ `pgc` |
| 胎次 | `birthOrder` | 中文数字 |
| 采集医护 | `medicalStaff` | |
| 采集医院 | `regionId` + `hospitalId` | |
| 销售人员 | `salesUserId` | **仅销售，不改采集专员** |
| 备注 | `remark` | |
| 运输方式 | 样本 `transport` | 见 §3.4 |
| 预计送达时间 | `transport.etaTime` | 空则跳过 |

### 3.2 样本：编码行 + 采集时间行

**编码行**（优先识别样本行）：

```
造血干细胞:ZKZX34000870
脐带间充质干细胞：ZKQD34000839
```

| 类型关键词 | 系统类型名 | typeKey |
|------------|------------|---------|
| 造血干细胞（非间充质） | 围产期造血干细胞 | `hsc` |
| 脐带间充质干细胞 | 脐带间充质干细胞 | `uc_msc` |

**采集时间行**（与编码行按 typeKey 合并）：

| 字段名（含别名） | typeKey |
|------------------|---------|
| 造血干细胞采集时间、造血干细胞样本采集时间 | `hsc` |
| 脐带间充质干细胞采集时间、脐带采集时间 | `uc_msc` |

- 首行标题（围产期干细胞储存…）仅作**无编码/无时间行**时的兜底类型匹配。
- 协议级 `sampleCollectTime` = 各 hint 已解析 `collectTime` 的**最早值**。

**样本编码**：按文本中的 `ZK…` 编码远程查 `fetchSampleCodeList`，写入 `sampleCodeId` + `sampleCode`；找不到则 warning。

**样本价格**：匹配样本类型后带出 `storagePrice` 作为原价/优惠价初始值；**合同金额仍以文本「合同金额」为准**（§3.3）。

### 3.3 缴费（金额以标准信息为准）

| 客户字段 | 解析 | 写入 |
|----------|------|------|
| 缴费方式：趸交 | `payMode = dj` | 缴费主表 |
| 缴费方式：分期 | `payMode = fq` | 缴费主表 + 分期默认参数 |
| 缴费方式：微信/支付宝/… | **`payMode = dj`**（非分期） | 同时作为转账方式 hint |
| 转账方式：微信 | `transferType` | 字典匹配 `zzfs` |
| 合同金额：22880元 | `22880` | **`formData.contractAmount`**（权威，覆盖自动合计） |
| 转账金额 | 单值或明细金额 | 缴费明细 `transferAmount` |
| 转账时间 | 见 §3.3.1 | 缴费明细 `transferTime` |

**趸交 + 部分已转**（标准2）：`payMode=dj`，合同 37000，明细 1 条 transfer 2000；`syncPaymentDueAmounts()` 计算待缴应缴额。

**趸交 + 多笔转账**（标准1）：解析 2 条明细（2000 + 20880），转账方式均为微信；合计应等于合同金额，不等则 warning。

#### 3.3.1 转账时间复杂格式

支持拆段，例如：

`2026年6月17日13时09分05秒2000元，6月18日15:50:12付20880元`

→ 两条 `{ transferTime, transferAmount }`。

单段格式：`2026年3月10日11:34:40` + 全局「转账金额」字段。

### 3.4 运输

复用 `resolveTransportType`（含顺丰快递→`kdys`、顺丰车→`ryxd`、顺风车/露露帮助…→`ryxd`）。

- `kdys`：匹配快递公司，填 `expressCompanyId`
- `ryxd`：不填快递；可选从文本提取人名（如「露露」）→ `carrierName`

---

## 4. 技术设计

### 4.1 新建解析器

**文件**：`web-admin/src/utils/protocol-standard-import-parse.ts`

```typescript
export type ProtocolSampleImportHint = {
  typeKey: 'hsc' | 'uc_msc'
  typeName: string
  sampleCode?: string
  collectTime?: string
}

export type ProtocolPaymentTransferHint = {
  transferAmount: number
  transferTime: string // YYYY-MM-DD HH:mm:ss
}

export type ProtocolStandardImportParsed = {
  sampleTypeHeader: string
  sampleHints: ProtocolSampleImportHint[]
  motherName?: string
  motherPhone?: string
  newbornSex?: '1' | '0'
  newbornWeightGram?: number | null
  apgarScore?: number | null
  newbornDeliveryTime?: string
  sampleCollectTime?: string
  maternalBloodCollectTime?: string
  maternalBloodExplicitEmpty?: boolean
  deliveryMode?: string
  birthOrder?: number | null
  medicalStaff?: string
  hospitalName?: string
  salesUserName?: string
  payMode?: 'dj' | 'fq'
  contractAmount?: number | null
  transferTypeLabel?: string // 原始「微信」等，填充时查字典
  paymentTransfers: ProtocolPaymentTransferHint[]
  transportModeText?: string
  transportType?: 'kdys' | 'ryxd'
  etaTime?: string
  remark?: string
}
```

**复用**（import from 已有模块）：

- `parseChineseDatetimeText` / `formatDatetimeToMinute`
- `parseBirthOrder`
- `resolveTransportType`
- `matchSampleTypeByExactName` / `matchCellSampleType`
- `isBlankString` / `extractNumericPart`

**新增**：

- `parsePayMode(text)`：`分期`→`fq`，否则 `dj`（趸交、微信、空均默认 dj）
- `parseSampleCodeLine(key, value)`：类型名 + ZK 编码
- `parsePaymentTransferSegments(text)`：多笔转账时间行
- `resolveTransferTypeCode(label, dictOptions)`：label→`wxzz` 等

### 4.2 UI

**文件**：`ProtocolFormDialog.vue`

- 新增模式 Tab「基本信息」：左侧 `section-card--import`（与捐赠同布局类名，见 `DonationFormDialog` SCSS）
- `standardImportText` + `handleStandardImport`
- `clearFormBeforeStandardImport()`：清空导入覆盖范围（含 samples、paymentDetails、缴费主表金额字段、客户/采集字段；**保留**协议状态、登记日期、采集专员、附件）
- `handleStandardImport` 流程见 §4.3

### 4.3 填充流程

```
1. parseProtocolStandardImportText(text)
2. clearFormBeforeStandardImport()
3. 预加载：样本类型、站点、快递、转账字典 zzfs
4. 并行：母亲(by name/phone)、医院、销售用户
5. 写入采集/客户/新生儿字段
6. 按 sampleHints 创建样本行（类型+编码 lookup+运输）
7. formData.contractAmount = parsed.contractAmount（来自标准信息）
8. formData.payMode = parsed.payMode ?? 'dj'
9. 重建 paymentDetails from paymentTransfers + transferType
10. syncFormSamplesAfterImport()
11. syncPaymentDueAmounts()（不调用 syncContractAmount 覆盖合同额）
12. 若样本价合计与合同金额差异 > 0.01 → warning（提示人工核对样本优惠价）
13. ElMessage success/warning
```

### 4.4 与捐赠差异摘要

| 项 | 捐赠 | 采集协议 |
|----|------|----------|
| 样本编码 | 自动生成 | 文本指定 + API 匹配 |
| 合同金额 | 无 | **标准信息为准** |
| 缴费 | 无 | 主表 + 明细 |
| 销售导入 | 同时写采集专员 | **仅 salesUserId** |
| 孕妇电话 | 无 | 有 |

---

## 5. 测试用例

| 用例 | 断言 |
|------|------|
| 标准信息1 全文 | 1 样本 ZKZX…；contract=22880；payMode=dj；2 条明细 2000+20880；运输 kdys |
| 标准信息2 全文 | 2 样本；contract=37000；payMode=dj；1 明细 2000；运输 ryxd；remark 有值 |
| 缴费方式：微信 | payMode=dj，transferType 匹配微信 |
| 缴费方式：分期 | payMode=fq |
| 刨宫产 / 头胎 | deliveryMode=pgc，birthOrder=1 |
| 重复点击导入 | 旧数据清空，仅保留新粘贴结果 |

---

## 6. 改动文件清单

| 文件 | 改动 |
|------|------|
| `utils/protocol-standard-import-parse.ts` | 新建 |
| `views/cell-storage/protocol/ProtocolFormDialog.vue` | UI + 导入逻辑 + SCSS |
| `utils/donation-standard-import-parse.ts` | 可选：导出共享函数，避免重复 |
| `utils/chinese-datetime-parse.ts` | 如需支持「付20880元」段内金额，扩展解析 |

**不改**：后端、DB。

---

## 7. 决策记录

| 日期 | 决策 |
|------|------|
| 2026-07-02 | 金额以标准信息为准，不用样本价自动合计覆盖合同金额 |
| 2026-07-02 | 缴费方式「微信」等默认趸交，仅明确「分期」时分期 |
| 2026-07-02 | 协议级 sampleCollectTime 取最早采集时间 |
| 2026-07-02 | 导入前清空可覆盖字段 |