olons_admin/docs/admin_reference_prd/后台功能与数据库表映射.md

后台功能与数据库表映射

更新时间：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. 核心数据关系

会员 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 的表使用软删除，不直接物理删除历史业务记录。