---
date: 2026-05-07
type: frontend-bug
module: contract-scheme
priority: medium
notify: ["@mmg"]
status: pending
source: 测试用例汇总.xlsx (2026-05-07)
related_cases: [HF-001]
---

# 合同方案新增找不到填写入口

## 现象

测试用例 HF-001 "正常新增合同方案"：

> 步骤：1. 新增 → 2. 填写名称模板内容 → 3. 保存
> 实际结果：**没找到相关的填写**

## 推断方向（前端）

可能是：
1. 合同方案管理菜单/路由缺失
2. 菜单存在但点"新增"按钮没弹出表单 dialog
3. dialog 弹出来但内容空白（template 没渲染）

## 后端确认

后端 hl-contract-service 的合同方案 admin 接口 **应当存在**（不然合同生成 HT-001 也会挂），具体接口路径可能是：

- `POST /admin/contract/scheme/save`（按项目 SaveReqVO 命名习惯）
- `GET /admin/contract/scheme/page`

如果后端接口缺失或路径变了，前端会找不到对应 API 来对接。

## 排查步骤

1. **检查 hl-ui 路由**：搜 `contract.*scheme` / `合同方案`，确认菜单项是否在 router 配置里
2. **检查菜单权限**：admin RBAC 是否给当前账号开放了"合同方案"菜单
3. **检查 dialog 表单组件**：是否引用了 `<ContractSchemeForm />` 但组件文件不存在/import 错路径
4. **后端 API 确认**：在 hl-ui 的 api 目录搜 `contractScheme` 看有没有对接接口

## 关联 BUG

跟 HT-001 "合同生成网络错误" 可能同源 — 如果合同方案根本无法新增，那合同生成也无法选择方案 → 必然失败。

后端排查时一并看一下。

## 影响

- 合同模板配置流程整条断
- 阻塞 HT-001 合同生成 BUG 的修复闭环（合同生成依赖方案）

## 验收

- [ ] 进入"合同配置 → 合同方案"菜单
- [ ] 点击"新增"按钮看到弹窗 / 表单页
- [ ] 填名称 + 模板内容 → 保存成功
- [ ] 列表能看到新增的方案
- [ ] HT-001 合同生成时能选到这个方案
