# 账户库管理交接记录

日期：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 联调，而不是继续只改静态原型。
