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