完成账户库管理功能开发与验收

docs/tests/plans/2026-04-14-account-library-acceptance-checklist.md

@@ -0,0 +1,219 @@
+# 账户库管理验收清单
+
+## 1. 验收目标
+
+确认“账户库管理”页面已满足本轮最小闭环范围，包含：
+
+- 菜单可见
+- 页面可打开
+- 列表查询正常
+- 新增、编辑、删除正常
+- 导入、导出正常
+- 导入模板可下载
+- 字段口径与数据库一致
+- 页面样式与其他“信息维护”页面保持一致
+
+## 2. 验收前提
+
+验收前需先确认：
+
+- 前端服务已启动
+- 后端服务已启动
+- Redis 可连接
+- 数据库使用开发库 `116.62.17.81:3307/ccdi`
+- 当前账号具备“账户库管理”菜单与按钮权限
+
+建议验收入口：
+
+- 菜单入口：`信息维护 -> 账户库管理`
+- 路由入口：`/maintain/accountInfo`
+
+## 3. 基础可用性验收
+
+### 3.1 菜单与路由
+
+- [ ] 左侧“信息维护”下可见“账户库管理”
+- [ ] 点击“账户库管理”可正常进入页面
+- [ ] 页面打开后无白屏、无 404、无 `No static resource`
+- [ ] 页面刷新后仍可正常进入
+
+### 3.2 页面样式
+
+- [ ] 页面背景、卡片、表头颜色与其他“信息维护”页面一致
+- [ ] 页面顶部不再显示“信息维护 / 账户库管理”说明卡片
+- [ ] 搜索区、工具栏、表格、分页布局正常
+- [ ] 右上角搜索折叠工具栏可正常使用
+
+## 4. 查询列表验收
+
+### 4.1 列表展示
+
+- [ ] 页面默认可加载账户列表
+- [ ] 表格列显示完整，无错位、无遮挡
+- [ ] 列表包含“证件号”列
+- [ ] “所属人类型”列能正确显示：员工、员工关系人、中介、外部人员
+- [ ] “账户类型”列能正确显示：银行账户、证券账户、支付账户、其他
+- [ ] “账户范围”列能正确显示：行内、行外
+- [ ] 风险等级、频率等级、状态色块显示正常
+
+### 4.2 查询条件
+
+- [ ] “所属人类型”筛选在最前面
+- [ ] 可按员工姓名查询
+- [ ] 可按账户范围查询
+- [ ] 可按关系类型查询
+- [ ] 可按账户姓名查询
+- [ ] 可按账户类型查询
+- [ ] 可按是否实控查询
+- [ ] 可按风险等级查询
+- [ ] 可按状态查询
+- [ ] “搜索”后结果正确
+- [ ] “重置”后条件恢复默认
+
+## 5. 新增验收
+
+### 5.1 新增弹窗
+
+- [ ] 点击“新增”可打开弹窗
+- [ ] 弹窗内“所属人类型”可选：员工、员工关系人、中介、外部人员
+- [ ] 默认新增账户范围为“行外”
+- [ ] 账户类型下拉仅有：
+  - [ ] `BANK`
+  - [ ] `SECURITIES`
+  - [ ] `PAYMENT`
+  - [ ] `OTHER`
+
+### 5.2 所属人逻辑
+
+- [ ] 选择“员工”时，可选择员工姓名
+- [ ] 选择“员工”后可自动带出证件号
+- [ ] 选择“员工关系人”时，可先选员工，再选关系人
+- [ ] 选择“员工关系人”后可自动带出关系类型、关系人证件号
+- [ ] 选择“中介”时，可手工录入中介名称和证件号
+- [ ] 选择“外部人员”时，可手工录入姓名和证件号
+
+### 5.3 保存验证
+
+- [ ] 必填项为空时有校验提示
+- [ ] 保存成功后列表可看到新增数据
+- [ ] 刷新页面后新增数据仍存在
+
+## 6. 编辑验收
+
+- [ ] 点击“编辑”可打开已有记录
+- [ ] 已有字段可正确回显
+- [ ] 可修改基础信息并保存成功
+- [ ] 保存后列表显示更新内容
+- [ ] 刷新页面后修改结果仍存在
+
+## 7. 删除验收
+
+- [ ] 点击“删除”有确认提示
+- [ ] 确认删除后提示成功
+- [ ] 删除后列表不再显示该数据
+- [ ] 刷新页面后该数据仍已删除
+
+## 8. 详情验收
+
+- [ ] 点击“详情”可打开只读弹窗
+- [ ] 基础信息、归属信息、分析信息都可查看
+- [ ] 详情弹窗内字段与列表、数据库保持一致
+
+## 9. 批量维护验收
+
+### 9.1 工具栏能力
+
+- [ ] 页面工具栏包含“导入”“导出”按钮
+- [ ] 按钮风格、位置与其他“信息维护”页面一致
+- [ ] 权限控制正常，无权限时按钮不显示
+
+### 9.2 导入功能
+
+- [ ] 点击“导入”可打开上传弹窗
+- [ ] 点击“下载模板”可下载 Excel 模板
+- [ ] 上传合法模板后可返回导入结果
+- [ ] 导入成功后页面列表可看到更新结果
+
+### 9.3 导出功能
+
+- [ ] 点击“导出”可按当前筛选条件导出 Excel
+- [ ] 导出文件可正常打开
+- [ ] 导出列与页面口径一致
+
+## 10. 数据口径验收
+
+### 9.1 页面与数据库字段映射
+
+- [ ] `ccdi_account_info.account_id -> 页面主键 id`
+- [ ] `ccdi_account_info.owner_type -> 所属人类型`
+- [ ] `ccdi_account_info.owner_id -> 证件号`
+- [ ] `ccdi_account_info.account_no -> 账户号码`
+- [ ] `ccdi_account_info.account_type -> 账户类型`
+- [ ] `ccdi_account_info.bank_scope -> 账户范围`
+- [ ] `ccdi_account_info.account_name -> 账户姓名`
+- [ ] `ccdi_account_info.bank -> 开户机构`
+- [ ] `ccdi_account_info.bank_code -> 银行代码`
+- [ ] `ccdi_account_info.currency -> 币种`
+- [ ] `ccdi_account_info.status -> 状态`
+- [ ] `ccdi_account_info.effective_date -> 生效日期`
+- [ ] `ccdi_account_info.invalid_date -> 失效日期`
+- [ ] `ccdi_account_result.is_self_account -> 是否实控账户`
+- [ ] `ccdi_account_result.monthly_avg_trans_count -> 月均交易笔数`
+- [ ] `ccdi_account_result.monthly_avg_trans_amount -> 月均交易金额`
+- [ ] `ccdi_account_result.trans_freq_type -> 频率等级`
+- [ ] `ccdi_account_result.trans_risk_level -> 风险等级`
+
+### 9.2 当前口径确认
+
+- [ ] `owner_id` 口径为“证件号”
+- [ ] `owner_type` 仅有：`EMPLOYEE / RELATION / INTERMEDIARY / EXTERNAL`
+- [ ] `account_type` 仅有：`BANK / SECURITIES / PAYMENT / OTHER`
+- [ ] 行内账户分析信息只读
+- [ ] 行外账户分析信息支持人工维护
+
+## 11. 测试数据验收
+
+建议至少核对以下场景各 1 条：
+
+- [ ] 员工 + 银行账户 + 行外
+- [ ] 员工关系人 + 证券账户 + 行外
+- [ ] 中介 + 支付账户 + 行外
+- [ ] 外部人员 + 其他账户 + 行外
+
+建议重点核对：
+
+- [ ] 中介支付账户账号表现为手机号样式
+- [ ] 证件号列显示正确
+- [ ] 不存在本轮新增测试数据被重复插入两次的情况
+
+## 12. 异常与兼容性验收
+
+- [ ] 后端不可用时，前端错误提示可理解
+- [ ] 页面没有明显控制台报错
+- [ ] 分页切换正常
+- [ ] 搜索后再点详情/编辑不报错
+- [ ] 移动端窄屏下页面不出现严重错位
+
+## 13. 本轮验收结论
+
+### 12.1 验收结果
+
+- [ ] 通过
+- [ ] 有问题需整改
+
+### 12.2 问题记录
+
+| 序号 | 问题描述 | 严重程度 | 是否已修复 | 备注 |
+|---|---|---|---|---|
+| 1 |  |  |  |  |
+| 2 |  |  |  |  |
+| 3 |  |  |  |  |
+
+### 12.3 验收签字
+
+| 角色 | 姓名 | 日期 | 结果 |
+|---|---|---|---|
+| 业务验收 |  |  |  |
+| 产品/需求 |  |  |  |
+| 开发确认 |  |  |  |
+| 测试确认 |  |  |  |

docs/tests/records/2026-04-14-account-library-acceptance-record.md

@@ -0,0 +1,119 @@
+# 账户库管理验收记录
+
+## 验收时间
+
+- 日期：2026-04-14
+- 验收方式：代码检查 + 数据库核对 + 页面在线验收 + 真实接口联调
+
+## 验收结论
+
+本轮“账户库管理”页面已完成最小闭环与批量维护能力验收，字段口径、菜单挂载、批量导入导出、测试数据、页面收口均已完成，正式页联调通过。
+
+## 已通过项
+
+### 1. 页面与样式
+
+- 已删除顶部“信息维护 / 账户库管理”说明卡片
+- 页面背景、主卡片、表头样式已收回到信息维护页常见灰白体系
+- 已补 `right-toolbar`
+- 搜索区域支持显隐
+- 工具栏、操作列风格已向若依现有页面对齐
+- 页面工具栏已补“导入”“导出”按钮，风格与中介库等页面保持一致
+
+### 2. 字段口径
+
+- `owner_id` 已按“证件号”口径处理
+- `owner_type` 仅支持：
+  - `EMPLOYEE`
+  - `RELATION`
+  - `INTERMEDIARY`
+  - `EXTERNAL`
+- `account_type` 仅支持：
+  - `BANK`
+  - `SECURITIES`
+  - `PAYMENT`
+  - `OTHER`
+- 新增默认账户范围为“行外”
+- 列表已展示“证件号”列
+- 所属人类型筛选已移动到最前面
+
+### 3. 批量维护能力
+
+- 已补导入模板下载接口：`POST /ccdi/accountInfo/importTemplate`
+- 已补导入接口：`POST /ccdi/accountInfo/importData`
+- 已补导出接口：`POST /ccdi/accountInfo/export`
+- 已补按钮权限：
+  - `ccdi:accountInfo:import`
+  - `ccdi:accountInfo:export`
+- 已补管理员角色菜单授权
+
+本次在线验收结果：
+
+- 导入模板下载成功，生成文件：`logs/account-info-import-template-check.xlsx`
+- 导出成功，生成文件：`logs/account-info-export-check.xlsx`
+- 合法导入样例成功，结果为“共 1 条，成功 1 条，失败 0 条”
+- 非法导入样例会在导入结果中提示失败数量，失败原因校验正常
+
+### 4. 数据与测试样例
+
+已核对本轮补充的 4 条测试数据，且未重复插入：
+
+| account_id | owner_type | owner_id | account_no | account_type | bank_scope |
+|---|---|---|---|---|---|
+| 30 | RELATION | 330101199104010101 | ZQ330101199104010101 | SECURITIES | EXTERNAL |
+| 31 | INTERMEDIARY | 330101197901010055 | 13700000035 | PAYMENT | EXTERNAL |
+| 32 | EXTERNAL | 91330100EXT20260413 | wx-ext-20260413-001 | OTHER | EXTERNAL |
+| 33 | EMPLOYEE | 330101199001010001 | 622202440000010001 | BANK | EXTERNAL |
+
+补充说明：
+
+- `account_no` 维度未发现本轮测试数据重复插入
+- 页面中“看起来重复”的旧数据，主要来自历史库里原本存在的同人多卡记录
+
+### 5. 菜单与权限
+
+- 已补菜单 SQL：`sql/migration/2026-04-13-add-ccdi-account-info-menu.sql`
+- 前端已补按钮权限：
+  - `ccdi:accountInfo:add`
+  - `ccdi:accountInfo:edit`
+  - `ccdi:accountInfo:remove`
+  - `ccdi:accountInfo:import`
+  - `ccdi:accountInfo:export`
+
+### 6. 真实联调结果
+
+本次已在正式页完成真实联调，结果如下：
+
+- `/ccdi/accountInfo/list` 可正常返回真实库数据
+- 详情接口可用
+- 新增接口可用
+- 编辑接口可用
+- 删除接口可用
+- 导入模板接口可用
+- 导入接口可用
+- 导出接口可用
+- `ccdi_account_info` 与 `ccdi_account_result` 联表映射正确
+
+## 当前可查看页面
+
+当前正式页已可访问：
+
+- `http://localhost/maintain/accountInfo`
+
+说明：
+
+- 此地址为“真前端 + 真后端 + 真数据库”联调页
+- 页面当前显示的账户数据为开发库真实数据
+- 可继续用于业务验收
+
+## 最终判断
+
+- 页面功能验收：通过
+- 数据口径验收：通过
+- 批量维护验收：通过
+- 真实联调环境验收：通过
+
+## 建议下一步
+
+1. 由业务侧继续在线验收页面与数据口径
+2. 如后续确认需要，再继续补导入模板说明或批量校验规则优化