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

docs/plans/fullstack/2026-04-10-account-library-handoff.md

@@ -0,0 +1,96 @@
+# 账户库管理交接记录
+
+日期：2026-04-10
+
+## 当前状态
+
+- 前端原型页：`ruoyi-ui/src/views/ccdiAccountInfoPrototype/index.vue`
+- 本地预览路由：`/ccdiAccountInfo`
+- 原型页入口路由：`/prototype/account-library`
+- 当前截图：`docs/plans/fullstack/account-library-preview-2026-04-10.png`
+- 真实数据库：`ccdi.ccdi_account_info`、`ccdi.ccdi_account_result`
+- 当前实现仍是前端静态原型，尚未接真实后端接口。
+
+## 本次已落地
+
+1. `ccdi_account_info` 已新增字段：
+   - 字段名：`bank_scope`
+   - 类型：`VARCHAR(20) NOT NULL DEFAULT 'INTERNAL'`
+   - 含义：`INTERNAL-行内，EXTERNAL-行外`
+   - 当前已有 21 条账户数据均为 `INTERNAL`
+
+2. `ccdi_account_result.trans_risk_level` 默认值已改为 `LOW`。
+
+3. 前端原型已恢复“账户范围”：
+   - 查询区支持按“行内/行外”筛选
+   - 表格展示“账户范围”
+   - 新增/编辑弹窗可选择“账户范围”
+   - 行内账户的分析信息默认只展示，语义上由 T+1 自动同步维护
+   - 行外账户的分析信息允许手工维护
+
+4. 前端原型兼容当前数据库 `account_type = DEBIT` 的老数据：
+   - `DEBIT` 展示为“借记卡账户”
+   - 仍保留 `BANK`、`SECURITIES`、`PAYMENT`、`OTHER` 作为后续扩展选项
+
+5. 关系类型口径已按员工亲属关系统一为：
+   - 配偶、父亲、母亲、子女、兄弟姐妹、朋友、同事、其他
+
+## 字段对应
+
+### `ccdi_account_info`
+
+| 页面字段 | 前端字段 | 数据库字段 | 说明 |
+| --- | --- | --- | --- |
+| 账户号码 | `accountNo` | `account_no` | 账号 |
+| 账户类型 | `accountType` | `account_type` | 当前库里有 `DEBIT` |
+| 账户范围 | `bankScope` | `bank_scope` | `INTERNAL` 行内，`EXTERNAL` 行外 |
+| 账户姓名 | `accountName` | `account_name` | 账户户名/所属姓名 |
+| 所属人类型 | `ownerType` | `owner_type` | 员工、员工关系人、外部人员 |
+| 所属人标识 | `staffId` / `relationId` | `owner_id` | 后续接口需按类型取值 |
+| 开户机构 | `openBank` | `bank` | 开户行/机构 |
+| 银行代码 | `bankCode` | `bank_code` | 机构代码 |
+| 币种 | `currency` | `currency` | 默认 `CNY` |
+| 状态 | `status` | `status` | `1` 正常，`2` 已销户 |
+| 生效日期 | `effectiveDate` | `effective_date` | 开户/生效日期 |
+| 失效日期 | `invalidDate` | `invalid_date` | 销户/失效日期 |
+
+### `ccdi_account_result`
+
+| 页面字段 | 前端字段 | 数据库字段 | 说明 |
+| --- | --- | --- | --- |
+| 是否实控账户 | `isActualControl` | `is_self_account` | `1` 是，`0` 否 |
+| 月均交易笔数 | `avgMonthTxnCount` | `monthly_avg_trans_count` | 交易画像 |
+| 月均交易金额 | `avgMonthTxnAmount` | `monthly_avg_trans_amount` | 交易画像 |
+| 频率等级 | `txnFrequencyLevel` | `trans_freq_type` | `LOW`、`MEDIUM`、`HIGH` |
+| 借方单笔最高额 | `debitSingleMaxAmount` | `dr_max_single_amount` | 交易画像 |
+| 贷方单笔最高额 | `creditSingleMaxAmount` | `cr_max_single_amount` | 交易画像 |
+| 借方日累计最高额 | `debitDailyMaxAmount` | `dr_max_daily_amount` | 交易画像 |
+| 贷方日累计最高额 | `creditDailyMaxAmount` | `cr_max_daily_amount` | 交易画像 |
+| 风险等级 | `txnRiskLevel` | `trans_risk_level` | 默认 `LOW` |
+
+## 后端同步判断
+
+仓库里当前没有找到已成型的 `CcdiAccountInfo` 后端 Controller、Entity、Mapper、Service 或前端 API 文件，所以本次没有强行新建完整后端 CRUD。
+
+后续如果正式接后端接口，需要同步增加：
+
+- Entity/DTO/VO 字段：`bankScope`
+- Mapper XML 或 MyBatis Plus 查询条件：支持 `bank_scope`
+- 新增/编辑接口：写入 `bank_scope`
+- 列表接口：返回 `bank_scope`
+- 行内账户：分析结果从同步任务/T+1结果表维护
+- 行外账户：允许页面写入或更新 `ccdi_account_result`
+
+## 本地启动说明
+
+前端可以在 `ruoyi-ui` 下启动：
+
+```bash
+npm run dev
+```
+
+当前环境里没有检测到 `java`、`mvn`、`mvnw`，所以这台机器不能直接用命令启动后端。后端正常需要 Java 21 和 Maven，然后启动端口按配置是 `62318`。
+
+## 明天切换对话可以这样说
+
+继续做 `C:\Users\20696\Desktop\初核\ccdi` 这个仓库的“账户库管理”。请先阅读 `docs/plans/fullstack/2026-04-10-account-library-handoff.md`，然后检查以下本地改动：前端原型 `ruoyi-ui/src/views/ccdiAccountInfoPrototype/index.vue`、路由 `ruoyi-ui/src/router/index.js`、白名单 `ruoyi-ui/src/permission.js`、关系枚举 `ccdi-info-collection/src/main/java/com/ruoyi/info/collection/enums/RelationType.java`、SQL 脚本 `sql/migration/2026-04-10-split-ccdi-account-info.sql`。数据库 `ccdi_account_info` 已新增 `bank_scope`，`ccdi_account_result.trans_risk_level` 默认值已是 `LOW`。下一步优先判断是否要做真实后端 CRUD/API 联调，而不是继续只改静态原型。

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. 如后续确认需要，再继续补导入模板说明或批量校验规则优化