新增账户库管理设计方案文档

2026-04-09 19:42:21 +08:00
parent 03282c9b69
commit 9c22e8a3ce
1 changed files with 437 additions and 0 deletions
--- a/docs/plans/fullstack/2026-04-09-account-library-design.md
+++ b/docs/plans/fullstack/2026-04-09-account-library-design.md
@@ -0,0 +1,437 @@
+# 账户库管理设计方案
+
+## 1. 背景与目标
+
+当前系统在“信息维护”下已具备员工信息维护、员工亲属关系维护等基础档案能力，但尚未形成独立的“账户库管理”。现有员工表 `ccdi_base_staff` 与员工亲属关系表 `ccdi_staff_fmy_relation` 中均不承载完整账户信息，无法满足后续账户台账维护、手工补录、导入和账户分析展示的需要。
+
+本次设计目标如下：
+
+- 在“信息维护”菜单下新增“账户库管理”
+- 支持维护员工本人账户与员工亲属账户
+- 账户静态档案与分析结果分表存储
+- 页面风格沿用现有维护页交互方式
+- 第一版仅考虑当前有效账户分析结果，不保留多版本分析历史
+
+本次明确不做以下事项：
+
+- 不扩展朋友、同事、司机、秘书等非亲属关系
+- 不修改“员工亲属关系维护”现有业务命名
+- 不增加额外脱敏展示字段
+- 不展开后端实现设计
+
+## 2. 设计原则
+
+- 主表只描述“谁持有了什么账户”
+- 分析表只描述“该账户的交易画像和风险等级”
+- 员工本人账户依附员工表
+- 亲属账户依附员工亲属关系表
+- 页面录入时允许在一个弹窗中同时维护主表和分析表信息
+- 第一版以人工维护为主，分析字段允许手工录入或后续导入覆盖
+
+## 3. 数据模型
+
+### 3.1 关系说明
+
+- 员工主表：`ccdi_base_staff`
+- 员工亲属关系表：`ccdi_staff_fmy_relation`
+- 账户主表：`ccdi_account_info`
+- 账户分析表：`ccdi_account_analysis`
+
+关系约束如下：
+
+- 一个员工可有多个本人账户
+- 一个员工亲属关系记录可有多个账户
+- 一个账户仅归属于一个员工或一个亲属关系记录
+- 一个账户在第一版仅对应一条当前分析记录
+
+### 3.2 归属规则
+
+- 当 `is_self_account = 1` 时：
+  - `staff_id` 必填
+  - `relation_id` 为空
+- 当 `is_self_account = 0` 时：
+  - `staff_id` 必填
+  - `relation_id` 必填
+  - `relation_id` 对应的亲属记录应属于该 `staff_id`
+
+## 4. 表结构设计
+
+### 4.1 账户主表 `ccdi_account_info`
+
+用途：存储账户静态档案、开户信息、归属关系和生效状态。
+
+| 字段名 | 类型 | 必填 | 默认值 | 说明 |
+|------|------|------|------|------|
+| id | BIGINT | 是 | 自增 | 主键 |
+| staff_id | BIGINT | 是 | - | 员工ID，对应 `ccdi_base_staff.staff_id` |
+| relation_id | BIGINT | 否 | NULL | 亲属关系ID，对应 `ccdi_staff_fmy_relation.id` |
+| account_no | VARCHAR(200) | 是 | - | 账户号码，按业务要求加密存储 |
+| account_type | VARCHAR(30) | 是 | - | `BANK/SECURITIES/PAYMENT/OTHER` |
+| account_name | VARCHAR(100) | 是 | - | 账户名称 |
+| open_bank | VARCHAR(100) | 是 | - | 开户银行、证券公司或支付平台 |
+| bank_code | VARCHAR(20) | 否 | NULL | 金融机构代码 |
+| currency | CHAR(3) | 是 | `CNY` | 币种，ISO 4217 标准 |
+| is_self_account | BOOLEAN | 是 | TRUE | 是否本人账户 |
+| status | INT | 是 | 1 | 状态：1-有效，0-无效 |
+| effective_date | DATE | 是 | 当前日期 | 生效日期 |
+| invalid_date | DATE | 否 | NULL | 失效日期 |
+| data_source | VARCHAR(30) | 是 | `MANUAL` | 数据来源：MANUAL、IMPORT、SYNC |
+| remark | VARCHAR(500) | 否 | NULL | 备注 |
+| create_by | VARCHAR(64) | 是 | - | 创建人 |
+| create_time | DATETIME | 是 | 当前时间 | 创建时间 |
+| update_by | VARCHAR(64) | 否 | NULL | 更新人 |
+| update_time | DATETIME | 否 | 当前时间 | 更新时间 |
+
+说明：
+
+- `relation_id` 为空表示员工本人账户
+- `relation_id` 不为空表示员工亲属账户
+- 本次不增加账户号码 hash 字段与脱敏展示字段
+
+### 4.2 账户分析表 `ccdi_account_analysis`
+
+用途：存储账户交易画像、金额特征和风险等级。
+
+| 字段名 | 类型 | 必填 | 默认值 | 说明 |
+|------|------|------|------|------|
+| id | BIGINT | 是 | 自增 | 主键 |
+| account_id | BIGINT | 是 | - | 账户ID，对应 `ccdi_account_info.id` |
+| analysis_months | INT | 是 | 6 | 统计月数 |
+| stat_start_date | DATE | 否 | NULL | 统计开始日期 |
+| stat_end_date | DATE | 否 | NULL | 统计结束日期 |
+| avg_month_txn_count | INT | 否 | 0 | 月均交易笔数 |
+| avg_month_txn_amount | DECIMAL(18,2) | 否 | 0.00 | 月均交易金额 |
+| txn_frequency_level | VARCHAR(20) | 否 | `MEDIUM` | 交易频率：LOW、MEDIUM、HIGH |
+| debit_single_max_amount | DECIMAL(18,2) | 否 | NULL | 借方单笔交易最高额 |
+| credit_single_max_amount | DECIMAL(18,2) | 否 | NULL | 贷方单笔交易最高额 |
+| debit_daily_max_amount | DECIMAL(18,2) | 否 | NULL | 借方日累计交易最高额 |
+| credit_daily_max_amount | DECIMAL(18,2) | 否 | NULL | 贷方日累计交易最高额 |
+| txn_risk_level | VARCHAR(10) | 否 | `MEDIUM` | 交易风险等级 |
+| remark | VARCHAR(500) | 否 | NULL | 分析备注 |
+| create_by | VARCHAR(64) | 是 | - | 创建人 |
+| create_time | DATETIME | 是 | 当前时间 | 创建时间 |
+| update_by | VARCHAR(64) | 否 | NULL | 更新人 |
+| update_time | DATETIME | 否 | 当前时间 | 更新时间 |
+
+说明：
+
+- 第一版以“一户一条当前分析记录”为目标
+- 后续如果需要保留历史分析版本，可新增 `is_latest`、`analysis_batch_no` 或改造唯一约束
+
+## 5. 索引与约束建议
+
+### 5.1 `ccdi_account_info`
+
+- 主键：`PRIMARY KEY (id)`
+- 索引：`idx_staff_id (staff_id)`
+- 索引：`idx_relation_id (relation_id)`
+- 索引：`idx_account_type (account_type)`
+- 索引：`idx_open_bank (open_bank)`
+- 索引：`idx_is_self_account (is_self_account)`
+- 索引：`idx_status (status)`
+
+### 5.2 `ccdi_account_analysis`
+
+- 主键：`PRIMARY KEY (id)`
+- 唯一索引：`uk_account_id (account_id)`
+- 索引：`idx_txn_risk_level (txn_risk_level)`
+
+### 5.3 校验规则
+
+- `invalid_date` 不得早于 `effective_date`
+- `analysis_months` 应大于 0
+- 金额字段不得为负数
+- 若账户为本人账户，则不允许选择亲属
+- 若账户为亲属账户，则必须选定亲属关系记录
+
+## 6. DDL 草案
+
+```sql
+CREATE TABLE IF NOT EXISTS `ccdi_account_info` (
+  `id` BIGINT(20) NOT NULL AUTO_INCREMENT COMMENT '主键ID',
+  `staff_id` BIGINT(20) NOT NULL COMMENT '员工ID',
+  `relation_id` BIGINT(20) DEFAULT NULL COMMENT '员工亲属关系ID，员工本人账户为空',
+  `account_no` VARCHAR(200) NOT NULL COMMENT '账户号码（加密存储）',
+  `account_type` VARCHAR(30) NOT NULL COMMENT '账户类型：BANK/SECURITIES/PAYMENT/OTHER',
+  `account_name` VARCHAR(100) NOT NULL COMMENT '账户名称',
+  `open_bank` VARCHAR(100) NOT NULL COMMENT '开户银行/证券公司/支付平台',
+  `bank_code` VARCHAR(20) DEFAULT NULL COMMENT '金融机构代码',
+  `currency` CHAR(3) NOT NULL DEFAULT 'CNY' COMMENT '币种',
+  `is_self_account` TINYINT(1) NOT NULL DEFAULT 1 COMMENT '是否本人账户：1-是 0-否',
+  `status` INT(11) NOT NULL DEFAULT 1 COMMENT '状态：1-有效 0-无效',
+  `effective_date` DATE NOT NULL COMMENT '生效日期',
+  `invalid_date` DATE DEFAULT NULL COMMENT '失效日期',
+  `data_source` VARCHAR(30) NOT NULL DEFAULT 'MANUAL' COMMENT '数据来源',
+  `remark` VARCHAR(500) DEFAULT NULL COMMENT '备注',
+  `create_by` VARCHAR(64) NOT NULL COMMENT '创建人',
+  `create_time` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
+  `update_by` VARCHAR(64) DEFAULT NULL COMMENT '更新人',
+  `update_time` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
+  PRIMARY KEY (`id`),
+  KEY `idx_staff_id` (`staff_id`),
+  KEY `idx_relation_id` (`relation_id`),
+  KEY `idx_account_type` (`account_type`),
+  KEY `idx_open_bank` (`open_bank`),
+  KEY `idx_is_self_account` (`is_self_account`),
+  KEY `idx_status` (`status`)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='账户主表';
+```
+
+```sql
+CREATE TABLE IF NOT EXISTS `ccdi_account_analysis` (
+  `id` BIGINT(20) NOT NULL AUTO_INCREMENT COMMENT '主键ID',
+  `account_id` BIGINT(20) NOT NULL COMMENT '账户ID',
+  `analysis_months` INT(11) NOT NULL DEFAULT 6 COMMENT '统计月数',
+  `stat_start_date` DATE DEFAULT NULL COMMENT '统计开始日期',
+  `stat_end_date` DATE DEFAULT NULL COMMENT '统计结束日期',
+  `avg_month_txn_count` INT(11) DEFAULT 0 COMMENT '月均交易笔数',
+  `avg_month_txn_amount` DECIMAL(18,2) DEFAULT 0.00 COMMENT '月均交易金额',
+  `txn_frequency_level` VARCHAR(20) DEFAULT 'MEDIUM' COMMENT '交易频率等级',
+  `debit_single_max_amount` DECIMAL(18,2) DEFAULT NULL COMMENT '借方单笔最高额',
+  `credit_single_max_amount` DECIMAL(18,2) DEFAULT NULL COMMENT '贷方单笔最高额',
+  `debit_daily_max_amount` DECIMAL(18,2) DEFAULT NULL COMMENT '借方日累计最高额',
+  `credit_daily_max_amount` DECIMAL(18,2) DEFAULT NULL COMMENT '贷方日累计最高额',
+  `txn_risk_level` VARCHAR(10) DEFAULT 'MEDIUM' COMMENT '交易风险等级',
+  `remark` VARCHAR(500) DEFAULT NULL COMMENT '分析备注',
+  `create_by` VARCHAR(64) NOT NULL COMMENT '创建人',
+  `create_time` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
+  `update_by` VARCHAR(64) DEFAULT NULL COMMENT '更新人',
+  `update_time` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
+  PRIMARY KEY (`id`),
+  UNIQUE KEY `uk_account_id` (`account_id`),
+  KEY `idx_txn_risk_level` (`txn_risk_level`)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='账户分析表';
+```
+
+## 7. 页面原型设计
+
+### 7.1 菜单位置
+
+新增菜单：
+
+- 父级：信息维护
+- 名称：账户库管理
+- 建议顺序：放在“员工亲属关系维护”后、“招聘信息管理”前
+
+### 7.2 列表页
+
+#### 查询区
+
+- 员工姓名
+- 归属类型：本人 / 亲属
+- 关系类型
+- 关系人姓名
+- 账户类型
+- 开户机构
+- 风险等级
+- 状态
+
+#### 操作区
+
+- 新增
+- 导入
+- 导出
+
+#### 表格字段
+
+- 员工姓名
+- 归属类型
+- 关系类型
+- 关系人姓名
+- 账户号码
+- 账户名称
+- 账户类型
+- 开户机构
+- 币种
+- 是否本人账户
+- 月均交易笔数
+- 月均交易金额
+- 交易频率等级
+- 交易风险等级
+- 生效日期
+- 状态
+- 创建时间
+- 操作
+
+#### 列表页低保真线框
+
+```text
+----------------------------------------------------------------------------------+
+| 账户库管理                                                                       |
+----------------------------------------------------------------------------------+
+| 员工姓名 [________] 归属类型 [本人/亲属] 关系类型 [____] 关系人姓名 [________]   |
+| 账户类型 [____]    开户机构 [________]  风险等级 [____] 状态 [有效/无效]         |
+| [搜索] [重置]                                                                   |
+----------------------------------------------------------------------------------+
+| [新增] [导入] [导出]                                                             |
+----------------------------------------------------------------------------------+
+| 员工姓名 | 归属类型 | 关系类型 | 关系人姓名 | 账号 | 账户名称 | 账户类型 | ...   |
+|----------------------------------------------------------------------------------|
+| 张三     | 本人     | -        | -          | 6222 | 工资卡   | BANK     | ...   |
+| 张三     | 亲属     | 配偶     | 李四       | 6217 | 储蓄卡   | BANK     | ...   |
+| ...                                                                              |
+----------------------------------------------------------------------------------+
+| 分页                                                                             |
+----------------------------------------------------------------------------------+
+```
+
+### 7.3 新增/编辑弹窗
+
+#### 一、归属信息
+
+- 归属类型
+- 员工选择
+- 关系人选择
+- 关系类型
+- 是否本人账户
+
+交互规则：
+
+- 归属类型为“本人”时，关系人选择和关系类型隐藏
+- 归属类型为“亲属”时，先选员工，再加载该员工亲属列表
+- 是否本人账户根据归属类型自动带出，只读显示
+
+#### 二、账户信息
+
+- 账户号码
+- 账户类型
+- 账户名称
+- 开户机构
+- 银行代码
+- 币种
+- 生效日期
+- 失效日期
+- 状态
+- 备注
+
+#### 三、分析信息
+
+- 统计月数
+- 统计开始日期
+- 统计结束日期
+- 月均交易笔数
+- 月均交易金额
+- 交易频率等级
+- 借方单笔最高额
+- 贷方单笔最高额
+- 借方日累计最高额
+- 贷方日累计最高额
+- 交易风险等级
+- 分析备注
+
+#### 弹窗低保真线框
+
+```text
+--------------------------------------------------------------+
+| 新增账户                                               [X]   |
+--------------------------------------------------------------+
+| 一、归属信息                                                |
+| 归属类型   [本人/亲属]                                      |
+| 员工       [请选择员工____________________]                  |
+| 关系人     [请选择关系人__________________]                  |
+| 关系类型   [自动带出______________________]                  |
+| 是否本人   [是/否，只读]                                    |
+--------------------------------------------------------------+
+| 二、账户信息                                                |
+| 账户号码   [____________________________]                    |
+| 账户类型   [BANK/SECURITIES/PAYMENT/OTHER]                  |
+| 账户名称   [____________________________]                    |
+| 开户机构   [____________________________]                    |
+| 银行代码   [________________] 币种 [CNY]                    |
+| 生效日期   [yyyy-MM-dd] 失效日期 [yyyy-MM-dd]               |
+| 状态       [有效/无效]                                      |
+| 备注       [____________________________________________]    |
+--------------------------------------------------------------+
+| 三、分析信息                                                |
+| 统计月数   [6]                                              |
+| 开始日期   [yyyy-MM-dd] 结束日期 [yyyy-MM-dd]               |
+| 月均笔数   [____]         月均金额 [__________]             |
+| 频率等级   [LOW/MEDIUM/HIGH] 风险等级 [LOW/MEDIUM/HIGH]     |
+| 借方单笔最高 [________]    贷方单笔最高 [________]          |
+| 借方日累计最高 [________]  贷方日累计最高 [________]        |
+| 分析备注   [____________________________________________]    |
+--------------------------------------------------------------+
+|                                   [取消] [确定]             |
+--------------------------------------------------------------+
+```
+
+### 7.4 详情弹窗
+
+详情页建议与新增/编辑弹窗结构一致，全部字段只读展示，避免维护两套信息布局。
+
+## 8. 导入模板建议
+
+建议导入模板字段如下：
+
+- 员工柜员号
+- 员工姓名
+- 归属类型
+- 关系人姓名
+- 关系类型
+- 账户号码
+- 账户类型
+- 账户名称
+- 开户机构
+- 银行代码
+- 币种
+- 生效日期
+- 失效日期
+- 统计月数
+- 月均交易笔数
+- 月均交易金额
+- 交易频率等级
+- 借方单笔最高额
+- 贷方单笔最高额
+- 借方日累计最高额
+- 贷方日累计最高额
+- 交易风险等级
+- 备注
+
+导入校验建议：
+
+- 本人账户时，不允许填写关系人姓名
+- 亲属账户时，关系人姓名不能为空
+- 若员工不存在，则导入失败
+- 若亲属不存在，则导入失败
+
+## 9. 菜单 SQL 草案
+
+```sql
+SET @parent_menu_id = (
+  SELECT menu_id
+  FROM sys_menu
+  WHERE menu_name = '信息维护' AND parent_id = 0
+  LIMIT 1
+);
+
+INSERT INTO sys_menu (
+  menu_name, parent_id, order_num, path, component, is_frame, is_cache,
+  menu_type, visible, status, perms, icon, create_by, create_time, update_by, update_time, remark
+) VALUES (
+  '账户库管理', @parent_menu_id, 5, 'accountInfo', 'ccdiAccountInfo/index', 1, 0,
+  'C', '0', '0', 'ccdi:accountInfo:list', 'money', 'admin', NOW(), '', NULL, '账户库管理菜单'
+);
+
+SET @menu_id = LAST_INSERT_ID();
+
+INSERT INTO sys_menu (
+  menu_name, parent_id, order_num, path, component, is_frame, is_cache,
+  menu_type, visible, status, perms, icon, create_by, create_time, remark
+) VALUES
+('账户查询', @menu_id, 1, '', '', 1, 0, 'F', '0', '0', 'ccdi:accountInfo:query', '#', 'admin', NOW(), ''),
+('账户新增', @menu_id, 2, '', '', 1, 0, 'F', '0', '0', 'ccdi:accountInfo:add', '#', 'admin', NOW(), ''),
+('账户修改', @menu_id, 3, '', '', 1, 0, 'F', '0', '0', 'ccdi:accountInfo:edit', '#', 'admin', NOW(), ''),
+('账户删除', @menu_id, 4, '', '', 1, 0, 'F', '0', '0', 'ccdi:accountInfo:remove', '#', 'admin', NOW(), ''),
+('账户导入', @menu_id, 5, '', '', 1, 0, 'F', '0', '0', 'ccdi:accountInfo:import', '#', 'admin', NOW(), ''),
+('账户导出', @menu_id, 6, '', '', 1, 0, 'F', '0', '0', 'ccdi:accountInfo:export', '#', 'admin', NOW(), '');
+```
+
+## 10. 后续落地建议
+
+如果本方案确认，可按以下顺序实施：
+
+1. 先建两张表并补菜单 SQL
+2. 再补前端列表页与弹窗原型
+3. 最后对接后端接口与导入导出
+
+当前方案适合作为第一版基础模型，后续若需要接入自动打标或保留历史分析结果，可在 `ccdi_account_analysis` 上继续扩展，而不破坏 `ccdi_account_info` 主档结构。