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

4.9 KiB
Raw Blame History

账户库管理交接记录

日期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_infoccdi.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 展示为“借记卡账户”
    • 仍保留 BANKSECURITIESPAYMENTOTHER 作为后续扩展选项
  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 LOWMEDIUMHIGH
借方单笔最高额 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 下启动:

npm run dev

当前环境里没有检测到 javamvnmvnw,所以这台机器不能直接用命令启动后端。后端正常需要 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_scopeccdi_account_result.trans_risk_level 默认值已是 LOW。下一步优先判断是否要做真实后端 CRUD/API 联调,而不是继续只改静态原型。