Commit 92c79873 authored by fangxinjiang's avatar fangxinjiang

docs(V24): 见费出单文档归入子目录并补充测试清单与自检报告

parent a5ce3757
This source diff could not be displayed because it is too large. You can view the blob instead.
# 登记保单保费 · 测试用例清单(摘选)
> 完整场景见 EKP1.9.24测试用例-见费出单-整理.md 中含「登记保单保费」的 TC
## 一、历史见费出单(is_new_data=0)
| 编号 | 场景 | 预期要点 | 对应 TC |
|------|------|----------|---------|
| H-01 | 首次实缴导入 BPO | 实缴应支=导入额;差额应支=实缴应支-预估应支;无管理费 | TC-009 |
| H-02 | 首次实缴导入 非BPO | 实缴应支=导入额;差额应收=实缴应支-预估应收 | TC-011 |
| H-03 | 再次登记产生不同差额 | 删旧实缴/差额,重新推送 | TC-010/012 |
| H-04 | EKP 预估/实缴结算中或已结算 | **拦截**登记(历史规则) | 5149-5163 |
| H-05 | EKP 实缴支出中/已支出 | **拦截**再次登记 | 5165-5175 |
| H-06 | 已登记后未支出退保 | 删实缴+差额,负数预估 | TC-013 |
| H-07 | 已登记后未支出已结算退保 | **正确**应负实缴红冲(产品暂按现状) | TC-014 |
## 二、新提前缴费(is_new_data=1)
| 编号 | 场景 | 预期要点 | 参考 TC |
|------|------|----------|---------|
| N-01 | 派单后(待投保) | 无预估 settle;不推 pushEstime;无管理费 | TC-017+ |
| N-02 | 走至已投保 → 首次登记 | 实缴 EKP:有无预估=无;BPO 应收0/应支=实缴;非BPO 应收=应支=实缴 | TC-018+ |
| N-03 | 首次登记时 createInsuranceInfo | 仅实缴登记时生成收入/管理费(视项目配置) | TC-018+ |
| N-04 | 再次登记(金额变更) | 实缴更新,不重复生成管理费 | TC-018+ |
| N-05 | 无 defaultSettleId 时校验 | 不因「预估结算中」拦截 | 5149-5163 |
| N-06 | 有实缴且支出中/已支出 | **拦截**登记或退保 | 5149-5175 / rollBack |
| N-07 | 已登记 → 未结算退保 | 删 EKP 实缴,不产生负管理费(BPO/已收过费场景) | TC-018+ |
| N-08 | 已登记 → 结算中/已结算未支出退保 | 推**负实缴**至 EKP,无差额 | TC-018+ |
| N-09 | 支出中/已支出 → 退保 | **禁止**退保 | TC-018+ |
| N-10 | 直接支出(无收款结算单) | 可提交支出;支出中/已支出禁止退保 | TC-018+ |
## 三、非见费出单对照(原逻辑)
| 编号 | 场景 | 预期 | 参考 |
|------|------|------|------|
| O-01 | isJfcd=否 派单 | EKP 无数据;投保成功后登记才产生实缴/管理费 | TC-017 原逻辑 |
| O-02 | 预估结算方式 + 投保成功 | EKP 预估;登记实缴产生差额 | 原逻辑测试 |
\ No newline at end of file
# EKP1.9.24 见费出单 · 本地代码自检报告(只读)
> 对照:`见费出单-历史16条测试清单.md`、`登记保单保费-测试用例清单.md`
> 代码范围:MVP `yifu-insurances`(主路径 `TInsuranceDetailServiceImpl`)
> **未改代码**,结论基于静态阅读 + OpenSpec 归档设计。
## 图例
| 标记 | 含义 |
|------|------|
| ✅ | 逻辑与用例一致,MVP 侧可支撑 |
| ⚠️ | 部分一致 / 依赖 EKP 联调 / 按产品「现状」验收 |
| ❌ | 与用例明显不符 |
| 🔗 | 主要在 EKP 端验证 |
---
## 一、历史 16 条(is_new_data=0)
| ID | 自检 | 代码依据 | 备注 |
|----|------|----------|------|
| TC-001 | ✅ | `callBack` 10522-10523 拦截已结算/结算中 | 仅历史待缴费(6)可走撤回 |
| TC-002 | ✅ | `callBack` 10527-10546 删 EKP/HRO/收入/管理费/风险金 | 需 EKP 侧配合删除 |
| TC-003 | ⚠️ | `initLegacyJfcdInfo` + `pullPaymentStatus` 仅 legacy | 收款结算单匹配在 EKP;MVP 拉状态有过滤 legacy |
| TC-004 | ⚠️ | 同上 + 登记差额 `callBackBalance` 2994+ | BPO 差额规则在 EKP 规整 |
| TC-005 | ⚠️ | `updateInsuranceSettleStatus`(legacy 分支) | 垫付匹配回调需 EKP 联调 |
| TC-006 | ✅ | legacy 退保 2278-2284 负数预估 + deleteEkpInsuranceDetailAsso | 无管理费场景 |
| TC-007 | ✅ | 同上 + `syncRollbackIncome` 负收入/管理费 | 有管理费场景 |
| TC-008 | ✅ | 同 TC-006 | 已投保未登记退回 |
| TC-009 | ✅ | `registeredPolicyPremium` legacy 2933+ 实缴;2994+ 差额 | BPO 应支/差额在 EKP |
| TC-010 | ✅ | 2996-3009 删旧差额再生成 | |
| TC-011 | ✅ | 同 TC-009 非 BPO | 差额应收在 EKP |
| TC-012 | ✅ | 同 TC-010 | |
| TC-013 | ✅ | legacy 退保删实缴/差额 + 负数预估 + 负管理费 | 未支出未结算 |
| TC-014 | ⚠️ | legacy 见费出单退保 **始终** push 负数预估(2278-2281) | **按现状通过**;与「正确=负实缴」不符,产品已知 |
| TC-015 | 🔗 | MVP 不拦支出 | EKP 商险支出流程 |
| TC-016 | 🔗 | — | EKP 打印/凭证 |
**历史小结**:MVP 存量路径完整;TC-003~005、015~016 需 EKP 环境;TC-014 为已知产品决策(现状=负预估)。
**前置条件**:历史用例需 DB 存量 `is_new_data=0`。当前 `initJfcd` 新派单写死 `isNewData=1`**无法再造 legacy 新单**,只能测迁移数据。
---
## 二、登记保单保费 · 历史(H-xx)
| 编号 | 自检 | 代码依据 |
|------|------|----------|
| H-01 | ✅ | 2933-2958 实缴 + 2994+ 差额 |
| H-02 | ✅ | 同上 |
| H-03 | ✅ | 2996-3009 callBackBalance + remove + 重建 |
| H-04 | ✅ | 5154-5163 仅 legacy 校验 settleStatus |
| H-05 | ✅ | 5166-5175 payStatus 全量校验(含新数据) |
| H-06 | ✅ | legacy rollBack 2278-2284 |
| H-07 | ⚠️ | 同 TC-014 现状 |
---
## 三、登记保单保费 · 新提前缴费(N-xx)
| 编号 | 自检 | 代码依据 | 备注 |
|------|------|----------|------|
| N-01 | ✅ | `initNewAdvancePayInfo` 659-660 待投保、无预估 settle | |
| N-02 | ✅ | `registerNewAdvancePayActualPremium` 735-752 推实缴 | EKP「有无预估=无」需联调 |
| N-03 | ✅ | 737-738 首次登记 `createInsuranceInfo` | 管理费视项目 signFlag |
| N-04 | ⚠️ | 762-767 更新实缴 | else 分支未显式 `updateById`,依赖异步回写 |
| N-05 | ✅ | 5149 有 settle 才查;新数据无预估 settle 不拦 | 5149 修复后正确 |
| N-06 | ✅ | 5166-5175 登记拦截;2110-2122 退保拦截 | 用户 5149 修复后一致 |
| N-07 | ✅ | `rollBackNewAdvancePayInsurance` 683-685 未结算删实缴 | 无负数预估 |
| N-08 | ✅ | 687-704 已结算未支出推负实缴 `pushEstimate(SIX)` | |
| N-09 | ✅ | 2110-2122 支出中/已支出禁止退保 | |
| N-10 | 🔗 | MVP 不创建收款结算单 | EKP 直接支出 + 退保守卫在 MVP |
---
## 四、非见费出单对照(O-xx)
| 编号 | 自检 | 说明 |
|------|------|------|
| O-01 | ✅ | `isJfcd≠0` 走 625-627,不 init 见费逻辑 |
| O-02 | ✅ | 非见费/预估结算原 `registeredPolicyPremium` 分支 |
---
## 五、风险与待联调项
1. **DB 迁移**:历史 16 条依赖 `is_new_data=0` 存量;须确认迁移脚本已执行。
2. **EKP 联调**(OpenSpec task 3.8):实缴「有无预估=无」、BPO 应收 0、非 BPO 应收=应支、支出打印 — MVP 只推数,字段规整在 EKP。
3. **TC-014 / H-07**:legacy 已结算未支出退保仍为负预估,与用例「正确」不一致,**产品确认按现状测**
4. **N-04**`registerNewAdvancePayActualPremium` 更新分支未 `tInsuranceSettleService.updateById`,若异步失败可能导致 HRO/EKP 不一致 — 建议联调时关注。
5. **前端**:新数据撤回按钮禁用(`callBack` 注释 10516);待办状态联动(task 2.5)未在本报告范围。
6. **无自动化测试**:codegraph 显示相关方法无单测覆盖,结论均为静态分析。
---
## 六、总体结论
| 范围 | 可测性 |
|------|--------|
| 新逻辑(is_new_data=1)登记/退保/支出守卫 | **MVP 主路径对齐用例**,建议优先冒烟 N-01~N-09 |
| 历史逻辑(is_new_data=0) | **代码路径保留**,需迁移数据 + EKP 配合 |
| EKP 展示/支出/打印 | **必须 EKP V1.9.24 环境** |
**不建议仅凭 MVP 静态自检宣称「全量 112 条通过」**;MVP 侧新逻辑核心场景(登记实缴、支出拦截、新退保负实缴)与整理用例一致,历史场景与 EKP 侧需集成测试补全。
# 见费出单 · 历史数据测试用例清单(16条)
> 来源:EKP1.9.24测试用例(商险见费出单).xmind → EKP1.9.24测试用例-见费出单-整理.md
> 数据前提:**is_jfcd=0 且 is_new_data=0**(存量迁移后)
| ID | 操作摘要 | 关键预期 |
|----|----------|----------|
| TC-001 | 待缴费 + 结算中/已结算 → 撤回 | 无法撤回 |
| TC-002 | 待缴费 + 未结算 + 已有管理费风险金 → 撤回 | MVP/EKP 数据消失,管理费风险金删除 |
| TC-003 | 待缴费 → 收款结算单(非BPO) | 后续可流转:待投保→投保成功→登记保单保费 |
| TC-004 | 待缴费 → 收款结算单(BPO) | 可拉预估;登记时只能拉差额(原逻辑) |
| TC-005 | 待缴费商险 → 收款结算单匹配/垫付 | MVP 缴费状态同步,变待投保 |
| TC-006 | 待投保 → 投保退回(无管理费风险金) | EKP 负数预估;MVP 退回;无负管理费 |
| TC-007 | 投保中 → 投保退回(有管理费风险金) | EKP 负数预估;MVP 退回;有负管理费 |
| TC-008 | 已投保未登记 → 投保退回(无管理费风险金) | 同 TC-006 |
| TC-009 | 已投保未登记 → 实缴导入(BPO) | 实缴+差额(应支);无管理费风险金 |
| TC-010 | TC-009 后再登记产生不同差额 | 删旧实缴/差额,重新生成并更新 |
| TC-011 | 已投保未登记 → 实缴导入(非BPO) | 实缴+差额(应收);无管理费风险金 |
| TC-012 | TC-011 后再登记产生不同差额 | 删旧实缴/差额,重新生成并更新 |
| TC-013 | 已登记实缴 → 退保(有管理费,未支出未结算) | 负数预估+删实缴/差额+负管理费 |
| TC-014 | 已登记实缴 → 退保(无管理费,未支出已结算) | **现状**:负数预估;**正确**:负实缴(产品暂按现状) |
| TC-015 | 实缴数据 → 商险支出 | 未结算/结算中/已结算均可支出 |
| TC-016 | TC-015 → 查看打印 | 预估封面带收款结算单信息,凭证可生成 |
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment