当前位置： 首页 > news >正文

DeepSeek幫我設計的會員模塊

news 2026/6/29 18:50:34

🏷️ 会员模块数据库设计文档

支持多商户·多门店·实物卡·储值消费·积分体系·余额重算 · MySQL 8.0+

📅 版本：v3.0 (多商户版)📁 数据库：MySQL 8.0🧩 字符集：utf8mb4📐 金额精度：分 (BIGINT)📋 表数量：10 张🏢 支持：多商户 + 多门店

📖 概述

本数据库设计面向多商户多门店会员卡管理系统，支持实物卡（芯片ID）与无卡消费（手机号）两种场景。 核心能力包括：储值充值、折扣消费、积分累积与兑换、余额变动全链路日志、余额重算机制，以及多商户/门店数据隔离。 设计时已预留计次卡扩展能力。

🏢 多商户多门店支持：所有会员表已增加fk_company_id和fk_store_id字段，实现数据隔离。 每个商户/门店可独立配置积分规则、折扣比例、充值策略等。

🔗 实体关系图 (ER)

╔═══════════════════════════════════════════════════════════════════════════════════════════════════════╗ ║ 📦 多商户会员系统 ER 图 ║ ╠═══════════════════════════════════════════════════════════════════════════════════════════════════════╣ ║ ║ ║ ┌─────────────────────────────┐ ┌─────────────────────────────────┐ ║ ║ │ sauna_merchant │ │ sauna_merchant_store │ ║ ║ │ (商户公司表-已有) │ │ (门店表-已有) │ ║ ║ │─────────────────────────────│ │─────────────────────────────────│ ║ ║ │ key_id (PK) │◄─────────│ fk_company_id (FK) │ ║ ║ │ company_fullname │ 1 n │ key_id (PK) │ ║ ║ │ company_shortname │ │ name │ ║ ║ └─────────────────────────────┘ └─────────────────────────────────┘ ║ ║ │ │ ║ ║ │ 1 │ 1 ║ ║ ├───────────────────────┬──────────────────┘ ║ ║ │ │ ║ ║ ▼ ▼ ║ ║ ┌──────────────────────────────────────────────────────────────────────────────┐ ║ ║ │ member_card (会员卡主表) │ ║ ║ │──────────────────────────────────────────────────────────────────────────────│ ║ ║ │ key_id (PK) │ card_no (UK) │ chip_id (UK) │ phone (idx) │ ║ ║ │ fk_company_id (FK) │ fk_store_id (FK) │ status │ card_type │ ║ ║ │ current_principal │ current_gift │ current_points │ discount_rate │ ║ ║ └──────────────────────────────────────────────────────────────────────────────┘ ║ ║ │ ║ ║ │ 1 ║ ║ ├─────────────────────────────────────────────────────────────────┐ ║ ║ │ │ ║ ║ ▼ ▼ ║ ║ ┌─────────────────────────┐ ┌─────────────────────────────────────┐ ║ ║ │ member_recharge │ │ member_consume │ ║ ║ │ (充值记录表) │ │ (消费明细表) │ ║ ║ │─────────────────────────│ │─────────────────────────────────────│ ║ ║ │ key_id (PK) │ │ key_id (PK) │ ║ ║ │ card_key_id (FK) │ │ card_key_id (FK) │ ║ ║ │ recharge_no (UK) │ │ consume_no (UK) │ ║ ║ │ amount, gift_amount │ │ principal_amount, gift_amount │ ║ ║ └─────────────────────────┘ └─────────────────────────────────────┘ ║ ║ │ │ ║ ║ └───────────────────┬───────────────────┘ ║ ║ │ ║ ║ ▼ ║ ║ ┌─────────────────────────────────────────────────────────────────────────────┐ ║ ║ │ member_balance_log (余额变动日志-核心) │ ║ ║ │─────────────────────────────────────────────────────────────────────────────│ ║ ║ │ key_id (PK) │ card_key_id (FK) │ log_no (UK) │ change_type │ ║ ║ │ before_principal │ after_principal │ before_gift │ after_gift │ ║ ║ │ is_recalculated │ source_type │ source_id │ ║ ║ └─────────────────────────────────────────────────────────────────────────────┘ ║ ║ ║ ║ ┌─────────────────────────┐ ┌─────────────────────────────────────┐ ║ ║ │ member_points_exchange │ │ member_balance_recalc │ ║ ║ │ (积分兑换记录表) │ │ (余额重算记录表) │ ║ ║ │─────────────────────────│ │─────────────────────────────────────│ ║ ║ │ key_id (PK) │ │ key_id (PK) │ ║ ║ │ card_key_id (FK) │ │ card_key_id (FK) │ ║ ║ │ points_used │ │ old_principal, new_principal │ ║ ║ │ exchange_type │ │ diff_principal, diff_gift │ ║ ║ └─────────────────────────┘ └─────────────────────────────────────┘ ║ ║ ║ ║ ┌─────────────────────────────┐ ┌─────────────────────────────────┐ ║ ║ │ member_merchant_config │ │ member_operation_log │ ║ ║ │ (商户配置-新增) │ │ (操作审计日志-新增) │ ║ ║ │─────────────────────────────│ │─────────────────────────────────│ ║ ║ │ key_id (PK) │ │ key_id (PK) │ ║ ║ │ fk_company_id (FK) │ │ card_key_id (FK) │ ║ ║ │ fk_store_id (FK) │ │ operation_type │ ║ ║ │ gift_consume_ratio │ │ before_data, after_data │ ║ ║ │ points_rate │ │ ip_address, user_agent │ ║ ║ └─────────────────────────────┘ └─────────────────────────────────┘ ║ ║ ║ ║ ┌─────────────────────────────────────────────────────────────────────────────┐ ║ ║ │ system_consume_config (系统配置) │ ║ ║ │ config_key (UK) │ config_value │ description │ ║ ║ └─────────────────────────────────────────────────────────────────────────────┘ ║ ║ ║ ╚═══════════════════════════════════════════════════════════════════════════════════════════════════════╝

🆕 本次新增/变更：

  • 新增fk_company_id、fk_store_id字段到所有会员表
  • 新增member_merchant_config表 - 商户/门店级别配置
  • 新增member_operation_log表 - 操作审计日志
  • 统一所有表增加公用字段：key_id、sort_index、create_by、create_time、update_by、update_time
  • 新增v_member_card_full视图 - 关联商户门店信息

📋 表结构详细设计

1. member_card会员卡主表

字段类型空键说明
idBIGINT UNSIGNEDNOPK自增主键
key_idVARCHAR(50)NOUK业务主键ID
fk_company_idVARCHAR(50)NOFK🏢 所属公司ID
fk_store_idVARCHAR(50)NOFK🏪 所属门店ID
card_noVARCHAR(20)NOUK会员卡编号（自编号）
chip_idVARCHAR(32)NOUK芯片ID唯一码（实物卡）
phoneVARCHAR(11)NOINDEX绑定手机号（无卡消费）
card_typeTINYINTNO-1-储值卡，2-计次卡（预留）
statusTINYINTNOINDEX0-冻结，1-正常，2-挂失，3-注销
total_rechargeBIGINTNO-累计充值金额（不含赠送，分）
total_giftBIGINTNO-累计赠送金额（分）
total_consumeBIGINTNO-累计消费本金（分）
total_gift_consumeBIGINTNO-累计赠送消费（分）
current_balanceBIGINTNO-当前可用总余额（本金+赠送）
current_principalBIGINTNO-当前本金余额
current_giftBIGINTNO-当前赠送余额
total_pointsINTNO-累计获得积分
used_pointsINTNO-已使用积分
current_pointsINTNO-当前可用积分
discount_rateDECIMAL(5,2)NO-折扣比例（100=不打折，90=9折）
open_dateDATETIMENO-开卡日期
expire_dateDATETIMEYES-有效期（计次卡使用）
last_consume_timeDATETIMEYES-最后消费时间
sort_indexINTYES-排序码
create_byVARCHAR(50)YES-创建人
create_timeDATETIMENOINDEX创建时间
update_byVARCHAR(50)YES-修改人
update_timeDATETIMENO-修改时间

🏢 多商户关键字段：fk_company_id和fk_store_id实现数据隔离， 查询时务必带上这两个条件，确保不同商户/门店数据互不干扰。

2. member_recharge开卡/充值记录表

字段类型空键说明
idBIGINT UNSIGNEDNOPK自增主键
key_idVARCHAR(50)NOUK业务主键ID
card_idBIGINT UNSIGNEDNOFK会员卡自增ID
card_key_idVARCHAR(50)NOFK会员卡业务ID
recharge_noVARCHAR(32)NOUK充值流水号
recharge_typeTINYINTNO-1-开卡，2-充值，3-赠送活动，4-手动调账
amountBIGINTNO-充值金额（本金，分）
gift_amountBIGINTNO-赠送金额（分）
pay_methodTINYINTYES-1-现金，2-微信，3-支付宝，4-银行卡
operator_idVARCHAR(50)YES-操作人员ID
remarkVARCHAR(255)YES-备注
recharge_timeDATETIMENOINDEX充值时间
sort_indexINTYES-排序码
create_byVARCHAR(50)YES-创建人
create_timeDATETIMENOINDEX创建时间
update_byVARCHAR(50)YES-修改人
update_timeDATETIMENO-修改时间

3. member_consume消费明细表

字段类型空键说明
idBIGINT UNSIGNEDNOPK自增主键
key_idVARCHAR(50)NOUK业务主键ID
card_idBIGINT UNSIGNEDNOFK会员卡自增ID
card_key_idVARCHAR(50)NOFK会员卡业务ID
consume_noVARCHAR(32)NOUK消费流水号
order_idVARCHAR(32)YESINDEX关联订单号
total_amountBIGINTNO-消费总金额（原始金额，分）
actual_amountBIGINTNO-实际扣款金额（折扣后）
principal_amountBIGINTNO-扣本金金额
gift_amountBIGINTNO-扣赠送金额
discount_amountBIGINTNO-优惠金额
earned_pointsINTNO-获得积分
consume_timeDATETIMENOINDEX消费时间
operator_idVARCHAR(50)YES-操作人员ID
remarkVARCHAR(255)YES-备注
sort_indexINTYES-排序码
create_byVARCHAR(50)YES-创建人
create_timeDATETIMENOINDEX创建时间
update_byVARCHAR(50)YES-修改人
update_timeDATETIMENO-修改时间

4. member_balance_log⭐ 余额变动日志表（核心）

字段类型空键说明
idBIGINT UNSIGNEDNOPK自增主键
key_idVARCHAR(50)NOUK业务主键ID
card_idBIGINT UNSIGNEDNOFK会员卡自增ID
card_key_idVARCHAR(50)NOFK会员卡业务ID
log_noVARCHAR(32)NOUK日志流水号
change_typeTINYINTNO-1-开卡，2-充值，3-消费，4-退款，5-手动调整，6-积分兑换，7-余额重算修正
change_amountBIGINTNO-变动金额（正数增加，负数减少，分）
before_principalBIGINTNO-变动前本金余额
after_principalBIGINTNO-变动后本金余额
before_giftBIGINTNO-变动前赠送余额
after_giftBIGINTNO-变动后赠送余额
before_totalBIGINTNO-变动前总余额
after_totalBIGINTNO-变动后总余额
source_typeVARCHAR(30)YESINDEX来源类型：recharge/consume/refund/adjust
source_idVARCHAR(50)YESINDEX来源表KeyId
operator_idVARCHAR(50)YES-操作人ID
remarkVARCHAR(255)YES-备注
is_recalculatedTINYINTNO-是否被重算修正：0-否，1-是
sort_indexINTYES-排序码
create_byVARCHAR(50)YES-创建人
create_timeDATETIMENOINDEX创建时间
update_byVARCHAR(50)YES-修改人
update_timeDATETIMENO-修改时间

5. member_points_exchange积分兑换记录表

字段类型空键说明
idBIGINT UNSIGNEDNOPK自增主键
key_idVARCHAR(50)NOUK业务主键ID
card_idBIGINT UNSIGNEDNOFK会员卡自增ID
card_key_idVARCHAR(50)NOFK会员卡业务ID
exchange_noVARCHAR(32)NOUK兑换流水号
points_usedINTNO-使用的积分
exchange_typeTINYINTNO-1-抵现，2-兑换礼品，3-兑换优惠券
exchange_valueBIGINTNO-兑换价值（抵现金额或礼品价值，分）
consume_idBIGINT UNSIGNEDYES-关联消费自增ID
consume_key_idVARCHAR(50)YES-关联消费业务ID
statusTINYINTNO-1-成功，2-取消，3-失效
exchange_timeDATETIMENOINDEX兑换时间
operator_idVARCHAR(50)YES-操作人ID
remarkVARCHAR(255)YES-备注
sort_indexINTYES-排序码
create_byVARCHAR(50)YES-创建人
create_timeDATETIMENOINDEX创建时间
update_byVARCHAR(50)YES-修改人
update_timeDATETIMENO-修改时间

6. member_balance_recalc余额重算记录表（审计）

字段类型空键说明
idBIGINT UNSIGNEDNOPK自增主键
key_idVARCHAR(50)NOUK业务主键ID
card_idBIGINT UNSIGNEDNOFK会员卡自增ID
card_key_idVARCHAR(50)NOFK会员卡业务ID
recalc_noVARCHAR(32)NOUK重算流水号
old_principalBIGINTNO-重算前本金余额
new_principalBIGINTNO-重算后本金余额
old_giftBIGINTNO-重算前赠送余额
new_giftBIGINTNO-重算后赠送余额
old_totalBIGINTNO-重算前总余额
new_totalBIGINTNO-重算后总余额
diff_principalBIGINTNO-本金差异
diff_giftBIGINTNO-赠送差异
recalc_reasonVARCHAR(255)NO-重算原因
operator_idVARCHAR(50)NO-操作人ID
recalc_timeDATETIMENOINDEX重算时间
sort_indexINTYES-排序码
create_byVARCHAR(50)YES-创建人
create_timeDATETIMENOINDEX创建时间
update_byVARCHAR(50)YES-修改人
update_timeDATETIMENO-修改时间
http://www.jsqmd.com/news/1091157/

相关文章：

  • OBS-ASIO插件深度解析：专业音频采集的技术实现与架构设计
  • Steam成就管理器完整指南：如何安全解锁与重置游戏成就
  • 刹那.相位宇宙
  • 渗透测试实战入门：从零到精通DC-1靶场攻防全流程解析
  • SuperMap GIS 三维性能优化实战：从数据处理到流畅体验的全链路解析
  • 如何用图像识别技术让原神日常任务效率提升3倍？
  • 电商详情页AI生成有哪些注意事项？最全AI生图工具实操指南来了
  • PCIe拓扑探秘：从Root Complex到Switch，构建高效数据通路
  • Icarus Verilog：开源硬件设计的编译器思维革命
  • Codex++安全边界探秘的技术文章大纲
  • Web自动化测试核心：DOM操作原理、定位策略与实战技巧
  • Selenium 八大元素定位方式详解
  • 5分钟快速上手：手机号逆向查询QQ号完整指南
  • 从零构建边缘音频终端：基于 ESP32-S3 软硬解耦的全栈闭环实践
  • 积累 自我信任积分的庖丁解牛
  • WPF 四轴上机位开发笔记：限值参数、JSON 持久化、XAML 绑定与校验
  • 学术会议全流程实战指南：从投稿到社交的研究生进阶手册
  • Groove音乐播放器：用Python打造的跨平台音乐体验新方式
  • 26.16-26
  • Cookies 是最早的客户端存储机制，每次请求都会自动携带，适合服务器端识别用户身份或维持会话；
  • 从零构建Web漏洞扫描器：架构设计与工程实践指南
  • AMD Ryzen处理器调试完全指南：免费开源工具SMUDebugTool终极教程
  • 写论文的神助攻！全能一键生成论文工具，秒出初稿不费力
  • Python QQ机器人实战指南：5分钟构建智能消息处理系统
  • 让每个命令都能精准路由：HagiCode Preset Task 的多技能支持实战
  • 如何实现网易云音乐自动化打卡：技术方案与实战指南
  • 信息学奥赛经典算法精讲：从“冒泡排序”例题看降序排列的实现与优化
  • llamafactory sft微调坑 继续训练 ,为什么 `save_steps: 40` 没有生效，实际 100 步才保存
  • AI驱动测试：技术路径、工具链与落地实践全解析
  • 滑档了还想走师范/教育方向，征集志愿该怎么填