chore: seed migration objects batch 8

2026-10-18 13:24:49 +08:00
parent 9a7f9ece7e
commit 97a0b33ba0
22 changed files with 3808 additions and 0 deletions
@@ -0,0 +1,130 @@
+# 后台功能与数据库表映射
+
+> 更新时间：2026-10-09  
+> 范围：当前 HotGo 后台、已实现业务模块及数据库 `olons_admin` 现有表  
+> 说明：一个页面可能关联多张表；部分公共表会被多个业务模块共同使用。
+
+## 1. 当前业务菜单
+
+| 一级菜单 | 功能 | 核心表 | 关联表 | 说明 |
+| --- | --- | --- | --- | --- |
+| 主页 | 首页数据看板 | `hg_dashboard_daily_stat` | `hg_app_member`、`hg_trade_order`、`hg_recharge_order`、`hg_withdrawal_order`、`hg_task_submission` | 展示会员、订单、充值、提现、任务等汇总数据；部分指标实时统计，日指标可落汇总表。 |
+| 主页 | 网站设置 | `hg_site_config_version` | — | 站点名称、Logo、隐私网址、交易限制、佣金、时间段、功能开关、自动派单等整份保存在 `config_json`；当前页面直接保存并生效。 |
+| 主页 | 文本管理 | `hg_content` | `hg_content_version` | `hg_content` 保存内容主档，`hg_content_version` 保存正文版本。 |
+| 主页 | Banner 设置 | `hg_banner` | `hg_sys_attachment` | 管理 Banner 图片、位置、跳转方式、展示时间和排序。 |
+| 主页 | 手工商城 | `hg_product` | `hg_sys_attachment` | 与商品管理共用商品表，以 `product_type=2` 区分手工商城商品；当前只维护名称、价格和展示图片。 |
+| 会员管理 | 会员列表 | `hg_app_member` | `hg_app_member_profile`、`hg_app_member_address`、`hg_app_member_payment_account`、`hg_app_member_status_log` | 会员主档、实名/扩展资料、地址、银行卡或收款账户、状态变更记录。 |
+| 会员管理 | 会员列表—余额与账变 | `hg_wallet_account` | `hg_wallet_ledger`、`hg_wallet_adjustment_request` | 钱包余额保存在账户表，所有变动写入不可变流水；人工账变入口保留在会员列表操作栏。 |
+| 会员管理 | 会员等级 | `hg_app_member_level` | `hg_app_member_level_version`、`hg_app_member` | 等级规则及等级版本；会员主档关联当前等级。 |
+| 会员管理 | 任务大厅 | `hg_task_hall` | `hg_task_hall_level`、`hg_app_member_level` | 配置大厅入口及允许参与的会员等级。 |
+| 交易管理 | 订单列表 | `hg_trade_order` | `hg_app_member`、`hg_product`、`hg_task`、`hg_wallet_ledger` | 交易订单主档及会员、商品、任务、资金流水关联。 |
+| 交易管理 | 充值管理 | `hg_recharge_order` | `hg_payment_channel`、`hg_wallet_account`、`hg_wallet_ledger`、`hg_finance_review` | 充值申请、渠道信息、审核结果和入账流水。 |
+| 交易管理 | 提现管理 | `hg_withdrawal_order` | `hg_wallet_account`、`hg_wallet_ledger`、`hg_finance_review`、`hg_app_member_payment_account` | 提现申请、余额冻结/扣减/退回、审核以及收款账户信息。 |
+| 交易管理 | 客服管理 | `hg_customer_service` | — | 客服名称、联系方式、工作时间、在线状态和排序。 |
+| 商品管理 | 商品列表 | `hg_product` | `hg_product_category`、`hg_sys_attachment` | 正式商品主档，以 `product_type=1` 区分；分类保存在商品分类表。 |
+| 任务管理 | 任务列表 | `hg_task` | `hg_task_level`、`hg_product`、`hg_app_member_level` | 任务主体、关联商品、适用会员等级及佣金规则。 |
+| 任务管理 | 会员任务审核 | `hg_task_submission` | `hg_task`、`hg_app_member`、`hg_app_member_level`、`hg_wallet_account`、`hg_wallet_ledger` | 审核会员提交的任务；通过后结算佣金并生成钱包流水。 |
+
+## 2. 已隐藏菜单但保留的业务能力
+
+| 原菜单 | 保留表 | 当前入口/处理方式 |
+| --- | --- | --- |
+| 资金调账 | `hg_wallet_adjustment_request`、`hg_wallet_account`、`hg_wallet_ledger` | 独立菜单已隐藏；相关权限和接口保留，由会员列表中的“账变”操作进入。 |
+| 会员通知 | `hg_app_member_notice` | 独立菜单已隐藏；通知/弹幕相关能力和接口保留，可从会员列表操作或后续 C 端消息中心复用。 |
+| 审批中心 | `hg_approval_request`、`hg_approval_action` | 独立治理菜单已移除；表和服务仍可供高风险业务复用。 |
+| 业务审计 | `hg_biz_audit_log` | 独立菜单已移除；重要操作仍可写入审计记录。 |
+
+## 3. HotGo 原生后台功能
+
+### 3.1 组织与权限
+
+| 功能 | 核心表 | 说明 |
+| --- | --- | --- |
+| 后台用户 | `hg_admin_member` | 后台管理员账号。 |
+| 部门管理 | `hg_admin_dept` | 组织部门树。 |
+| 岗位管理 | `hg_admin_post`、`hg_admin_member_post` | 岗位定义及管理员岗位关系。 |
+| 角色权限 | `hg_admin_role`、`hg_admin_member_role` | 角色树、管理员角色关系。子角色可选菜单不得超过直接父角色范围。 |
+| 菜单权限 | `hg_admin_menu`、`hg_admin_role_menu` | 菜单、页面、按钮权限及角色菜单关系。 |
+| 接口鉴权 | `hg_admin_role_casbin` | Casbin 接口权限规则。 |
+| 第三方登录 | `hg_admin_oauth` | 后台账号第三方授权关系。 |
+
+### 3.2 系统设置与运维
+
+| 功能 | 核心表 | 说明 |
+| --- | --- | --- |
+| 配置管理 | `hg_sys_config` | HotGo 系统配置。网站业务配置不写入此表，而写入 `hg_site_config_version`。 |
+| 字典管理 | `hg_sys_dict_type`、`hg_sys_dict_data` | 动态字典类型和选项数据；代码枚举通过 HotGo 字典注册机制提供。 |
+| 定时任务 | `hg_sys_cron_group`、`hg_sys_cron` | 定时任务分组、执行策略及状态。 |
+| 黑名单 | `hg_sys_blacklist` | IP 等访问黑名单。 |
+| 通知公告 | `hg_admin_notice`、`hg_admin_notice_read` | 面向后台管理员的公告及阅读状态，与会员通知不是同一张表。 |
+| 附件管理 | `hg_sys_attachment` | 上传文件和图片元数据。 |
+| 地区编码 | `hg_sys_provinces` | 省市区层级数据。 |
+| 操作日志 | `hg_sys_log` | 后台接口操作日志。 |
+| 登录日志 | `hg_sys_login_log` | 后台登录记录。 |
+| 短信/邮件日志 | `hg_sys_sms_log`、`hg_sys_ems_log` | 短信和邮件发送记录。 |
+| 服务日志 | `hg_sys_serve_log` | 服务运行日志。 |
+| 服务授权/监控 | `hg_sys_serve_license` | 服务连接与授权状态；在线用户主要依赖会话/缓存，不单独落业务表。 |
+
+### 3.3 HotGo 资金与支付基础能力
+
+| 功能 | 核心表 | 说明 |
+| --- | --- | --- |
+| 后台资金账户 | `hg_admin_cash`、`hg_admin_credits_log` | HotGo 原生后台账户资金及积分/余额变动。与 C 端会员钱包表分离。 |
+| HotGo 订单 | `hg_admin_order` | HotGo 原生支付订单，与业务交易订单 `hg_trade_order` 分离。 |
+| 支付与退款日志 | `hg_pay_log`、`hg_pay_refund` | 支付请求、回调及退款记录。 |
+
+### 3.4 插件与开发工具
+
+| 功能 | 核心表 | 说明 |
+| --- | --- | --- |
+| 插件管理 | `hg_sys_addons_install`、`hg_sys_addons_config` | 插件安装状态及插件配置。 |
+| 代码生成 | `hg_sys_gen_codes` | 代码生成配置。 |
+| 示例插件 | `hg_addon_hgexample_table`、`hg_addon_hgexample_tenant_order` | HotGo 示例数据，不属于正式业务。 |
+| 生成示例 | `hg_sys_gen_curd_demo`、`hg_sys_gen_tree_demo`、`hg_test_category` | CRUD/树表/分类演示，不属于正式业务。 |
+
+## 4. 公共支撑表
+
+| 表 | 用途 | 典型使用模块 |
+| --- | --- | --- |
+| `hg_approval_request` | 审批请求主表 | 会员状态、资金调账、充值、提现等高风险操作。 |
+| `hg_approval_action` | 审批动作流水 | 记录提交、通过、拒绝等动作。 |
+| `hg_biz_audit_log` | 业务审计日志 | 资金、任务审核、状态变化等重要操作。 |
+| `hg_sensitive_access_log` | 敏感数据查看记录 | 会员手机号、实名、银行卡等完整信息查看。 |
+| `hg_idempotency_record` | 幂等控制 | 支付、审核执行、钱包入账等不可重复操作。 |
+| `hg_outbox_event` | 事务消息/事件出站箱 | 业务提交后异步通知或跨模块事件。 |
+| `hg_dashboard_daily_stat` | 每日统计快照 | 首页看板。 |
+
+## 5. 核心数据关系
+
+```text
+会员 hg_app_member
+├── 扩展资料 hg_app_member_profile
+├── 地址 hg_app_member_address
+├── 收款账户 hg_app_member_payment_account
+├── 等级 hg_app_member_level
+├── 钱包 hg_wallet_account
+│   ├── 账变流水 hg_wallet_ledger
+│   └── 人工调账 hg_wallet_adjustment_request
+├── 交易订单 hg_trade_order
+├── 充值订单 hg_recharge_order
+├── 提现订单 hg_withdrawal_order
+└── 任务提交 hg_task_submission
+
+商品 hg_product
+├── 分类 hg_product_category
+├── 交易订单 hg_trade_order
+└── 任务 hg_task
+    ├── 等级投放 hg_task_level
+    └── 会员提交 hg_task_submission
+```
+
+## 6. 数据存储约定
+
+- 业务金额统一以“分”存入 `bigint` 字段，页面负责格式化为元。
+- 会员敏感信息采用密文、检索哈希和脱敏展示值分离保存。
+- 钱包余额以 `hg_wallet_account` 为当前值，`hg_wallet_ledger` 为不可变账变依据。
+- 网站设置字段集中保存在 `hg_site_config_version.config_json`，因此新增配置项通常无需增加数据库列。
+- 商品管理和手工商城共用 `hg_product`，通过 `product_type` 区分。
+- 后台管理员资金表与 C 端会员钱包表完全分离，禁止混用。
+- 带 `tenant_id` 的业务表通过 HotGo 多租户过滤器隔离数据。
+- 带 `deleted_at` 的表使用软删除，不直接物理删除历史业务记录。