438 lines
17 KiB
Markdown
438 lines
17 KiB
Markdown
# 账户库管理设计方案
|
||
|
||
## 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` 主档结构。
|