DeepSeek幫我設計的會員模塊

剪影AS

252人浏览 · 2026-06-29 16:45:31

剪影AS · 2026-06-29 16:45:31 发布

支持多商户·多门店·实物卡·储值消费·积分体系·余额重算 · 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会员卡主表

字段	类型	空	键	说明
id	BIGINT UNSIGNED	NO	PK	自增主键
key_id	VARCHAR(50)	NO	UK	业务主键ID
fk_company_id	VARCHAR(50)	NO	FK	🏢 所属公司ID
fk_store_id	VARCHAR(50)	NO	FK	🏪 所属门店ID
card_no	VARCHAR(20)	NO	UK	会员卡编号（自编号）
chip_id	VARCHAR(32)	NO	UK	芯片ID唯一码（实物卡）
phone	VARCHAR(11)	NO	INDEX	绑定手机号（无卡消费）
card_type	TINYINT	NO	-	1-储值卡，2-计次卡（预留）
status	TINYINT	NO	INDEX	0-冻结，1-正常，2-挂失，3-注销
total_recharge	BIGINT	NO	-	累计充值金额（不含赠送，分）
total_gift	BIGINT	NO	-	累计赠送金额（分）
total_consume	BIGINT	NO	-	累计消费本金（分）
total_gift_consume	BIGINT	NO	-	累计赠送消费（分）
current_balance	BIGINT	NO	-	当前可用总余额（本金+赠送）
current_principal	BIGINT	NO	-	当前本金余额
current_gift	BIGINT	NO	-	当前赠送余额
total_points	INT	NO	-	累计获得积分
used_points	INT	NO	-	已使用积分
current_points	INT	NO	-	当前可用积分
discount_rate	DECIMAL(5,2)	NO	-	折扣比例（100=不打折，90=9折）
open_date	DATETIME	NO	-	开卡日期
expire_date	DATETIME	YES	-	有效期（计次卡使用）
last_consume_time	DATETIME	YES	-	最后消费时间
sort_index	INT	YES	-	排序码
create_by	VARCHAR(50)	YES	-	创建人
create_time	DATETIME	NO	INDEX	创建时间
update_by	VARCHAR(50)	YES	-	修改人
update_time	DATETIME	NO	-	修改时间

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

2. member_recharge开卡/充值记录表

字段	类型	空	键	说明
id	BIGINT UNSIGNED	NO	PK	自增主键
key_id	VARCHAR(50)	NO	UK	业务主键ID
card_id	BIGINT UNSIGNED	NO	FK	会员卡自增ID
card_key_id	VARCHAR(50)	NO	FK	会员卡业务ID
recharge_no	VARCHAR(32)	NO	UK	充值流水号
recharge_type	TINYINT	NO	-	1-开卡，2-充值，3-赠送活动，4-手动调账
amount	BIGINT	NO	-	充值金额（本金，分）
gift_amount	BIGINT	NO	-	赠送金额（分）
pay_method	TINYINT	YES	-	1-现金，2-微信，3-支付宝，4-银行卡
operator_id	VARCHAR(50)	YES	-	操作人员ID
remark	VARCHAR(255)	YES	-	备注
recharge_time	DATETIME	NO	INDEX	充值时间
sort_index	INT	YES	-	排序码
create_by	VARCHAR(50)	YES	-	创建人
create_time	DATETIME	NO	INDEX	创建时间
update_by	VARCHAR(50)	YES	-	修改人
update_time	DATETIME	NO	-	修改时间

3. member_consume消费明细表

字段	类型	空	键	说明
id	BIGINT UNSIGNED	NO	PK	自增主键
key_id	VARCHAR(50)	NO	UK	业务主键ID
card_id	BIGINT UNSIGNED	NO	FK	会员卡自增ID
card_key_id	VARCHAR(50)	NO	FK	会员卡业务ID
consume_no	VARCHAR(32)	NO	UK	消费流水号
order_id	VARCHAR(32)	YES	INDEX	关联订单号
total_amount	BIGINT	NO	-	消费总金额（原始金额，分）
actual_amount	BIGINT	NO	-	实际扣款金额（折扣后）
principal_amount	BIGINT	NO	-	扣本金金额
gift_amount	BIGINT	NO	-	扣赠送金额
discount_amount	BIGINT	NO	-	优惠金额
earned_points	INT	NO	-	获得积分
consume_time	DATETIME	NO	INDEX	消费时间
operator_id	VARCHAR(50)	YES	-	操作人员ID
remark	VARCHAR(255)	YES	-	备注
sort_index	INT	YES	-	排序码
create_by	VARCHAR(50)	YES	-	创建人
create_time	DATETIME	NO	INDEX	创建时间
update_by	VARCHAR(50)	YES	-	修改人
update_time	DATETIME	NO	-	修改时间

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

字段	类型	空	键	说明
id	BIGINT UNSIGNED	NO	PK	自增主键
key_id	VARCHAR(50)	NO	UK	业务主键ID
card_id	BIGINT UNSIGNED	NO	FK	会员卡自增ID
card_key_id	VARCHAR(50)	NO	FK	会员卡业务ID
log_no	VARCHAR(32)	NO	UK	日志流水号
change_type	TINYINT	NO	-	1-开卡，2-充值，3-消费，4-退款，5-手动调整，6-积分兑换，7-余额重算修正
change_amount	BIGINT	NO	-	变动金额（正数增加，负数减少，分）
before_principal	BIGINT	NO	-	变动前本金余额
after_principal	BIGINT	NO	-	变动后本金余额
before_gift	BIGINT	NO	-	变动前赠送余额
after_gift	BIGINT	NO	-	变动后赠送余额
before_total	BIGINT	NO	-	变动前总余额
after_total	BIGINT	NO	-	变动后总余额
source_type	VARCHAR(30)	YES	INDEX	来源类型：recharge/consume/refund/adjust
source_id	VARCHAR(50)	YES	INDEX	来源表KeyId
operator_id	VARCHAR(50)	YES	-	操作人ID
remark	VARCHAR(255)	YES	-	备注
is_recalculated	TINYINT	NO	-	是否被重算修正：0-否，1-是
sort_index	INT	YES	-	排序码
create_by	VARCHAR(50)	YES	-	创建人
create_time	DATETIME	NO	INDEX	创建时间
update_by	VARCHAR(50)	YES	-	修改人
update_time	DATETIME	NO	-	修改时间

5. member_points_exchange积分兑换记录表

字段	类型	空	键	说明
id	BIGINT UNSIGNED	NO	PK	自增主键
key_id	VARCHAR(50)	NO	UK	业务主键ID
card_id	BIGINT UNSIGNED	NO	FK	会员卡自增ID
card_key_id	VARCHAR(50)	NO	FK	会员卡业务ID
exchange_no	VARCHAR(32)	NO	UK	兑换流水号
points_used	INT	NO	-	使用的积分
exchange_type	TINYINT	NO	-	1-抵现，2-兑换礼品，3-兑换优惠券
exchange_value	BIGINT	NO	-	兑换价值（抵现金额或礼品价值，分）
consume_id	BIGINT UNSIGNED	YES	-	关联消费自增ID
consume_key_id	VARCHAR(50)	YES	-	关联消费业务ID
status	TINYINT	NO	-	1-成功，2-取消，3-失效
exchange_time	DATETIME	NO	INDEX	兑换时间
operator_id	VARCHAR(50)	YES	-	操作人ID
remark	VARCHAR(255)	YES	-	备注
sort_index	INT	YES	-	排序码
create_by	VARCHAR(50)	YES	-	创建人
create_time	DATETIME	NO	INDEX	创建时间
update_by	VARCHAR(50)	YES	-	修改人
update_time	DATETIME	NO	-	修改时间

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

字段	类型	空	键	说明
id	BIGINT UNSIGNED	NO	PK	自增主键
key_id	VARCHAR(50)	NO	UK	业务主键ID
card_id	BIGINT UNSIGNED	NO	FK	会员卡自增ID
card_key_id	VARCHAR(50)	NO	FK	会员卡业务ID
recalc_no	VARCHAR(32)	NO	UK	重算流水号
old_principal	BIGINT	NO	-	重算前本金余额
new_principal	BIGINT	NO	-	重算后本金余额
old_gift	BIGINT	NO	-	重算前赠送余额
new_gift	BIGINT	NO	-	重算后赠送余额
old_total	BIGINT	NO	-	重算前总余额
new_total	BIGINT	NO	-	重算后总余额
diff_principal	BIGINT	NO	-	本金差异
diff_gift	BIGINT	NO	-	赠送差异
recalc_reason	VARCHAR(255)	NO	-	重算原因
operator_id	VARCHAR(50)	NO	-	操作人ID
recalc_time	DATETIME	NO	INDEX	重算时间
sort_index	INT	YES	-	排序码
create_by	VARCHAR(50)	YES	-	创建人
create_time	DATETIME	NO	INDEX	创建时间
update_by	VARCHAR(50)	YES	-	修改人
update_time	DATETIME	NO	-	修改时间

7. member_merchant_config🆕 商户会员卡配置表

字段	类型	空	键	说明
id	BIGINT UNSIGNED	NO	PK	自增主键
key_id	VARCHAR(50)	NO	UK	业务主键ID
fk_company_id	VARCHAR(50)	NO	FK	🏢 所属公司ID
fk_store_id	VARCHAR(50)	YES	FK	🏪 所属门店ID（NULL表示公司级配置）
config_type	TINYINT	NO	-	配置类型：1-公司级，2-门店级
gift_consume_ratio	INT	NO	-	赠送金额消费比例（百分比）
points_rate	INT	NO	-	积分获得比例（每消费1元得N积分）
points_exchange_rate	INT	NO	-	积分兑换比例（N积分=1元）
min_recharge_amount	BIGINT	YES	-	最低充值金额（分）
max_gift_amount	BIGINT	YES	-	单次最大赠送金额（分）
is_enabled	TINYINT	NO	-	是否启用：0-禁用，1-启用
sort_index	INT	YES	-	排序码
create_by	VARCHAR(50)	YES	-	创建人
create_time	DATETIME	NO	INDEX	创建时间
update_by	VARCHAR(50)	YES	-	修改人
update_time	DATETIME	NO	-	修改时间

⚙️ 配置优先级： 门店配置（fk_store_id 有值）> 公司配置（fk_store_id 为 NULL）> 系统默认配置

8. member_operation_log🆕 会员卡操作日志表（审计）

字段	类型	空	键	说明
id	BIGINT UNSIGNED	NO	PK	自增主键
key_id	VARCHAR(50)	NO	UK	业务主键ID
card_id	BIGINT UNSIGNED	NO	FK	会员卡自增ID
card_key_id	VARCHAR(50)	NO	FK	会员卡业务ID
operation_type	TINYINT	NO	INDEX	操作类型：1-开卡，2-充值，3-消费，4-冻结，5-解冻，6-挂失，7-解挂，8-注销，9-余额调整，10-积分调整
operation_content	TEXT	YES	-	操作内容（JSON）
before_data	TEXT	YES	-	操作前数据（JSON）
after_data	TEXT	YES	-	操作后数据（JSON）
ip_address	VARCHAR(50)	YES	-	操作IP
user_agent	VARCHAR(255)	YES	-	用户代理
operator_id	VARCHAR(50)	YES	-	操作人ID
operator_name	VARCHAR(100)	YES	-	操作人姓名
remark	VARCHAR(255)	YES	-	备注
operation_time	DATETIME	NO	INDEX	操作时间
sort_index	INT	YES	-	排序码
create_by	VARCHAR(50)	YES	-	创建人
create_time	DATETIME	NO	INDEX	创建时间
update_by	VARCHAR(50)	YES	-	修改人
update_time	DATETIME	NO	-	修改时间

9. system_consume_config系统配置表

字段	类型	空	键	说明
id	INT UNSIGNED	NO	PK	自增主键
key_id	VARCHAR(50)	NO	UK	业务主键ID
config_key	VARCHAR(50)	NO	UK	配置键
config_value	VARCHAR(100)	NO	-	配置值
description	VARCHAR(255)	YES	-	描述
sort_index	INT	YES	-	排序码
create_by	VARCHAR(50)	YES	-	创建人
create_time	DATETIME	NO	-	创建时间
update_by	VARCHAR(50)	YES	-	修改人
update_time	DATETIME	NO	-	修改时间

10. v_member_card_full📊 会员卡完整信息视图

-- 关联商户和门店信息的完整视图 CREATE OR REPLACE VIEW v_member_card_full AS SELECT mc.key_id, mc.card_no, mc.chip_id, mc.phone, mc.card_type, mc.status, mc.current_balance, mc.current_principal, mc.current_gift, mc.current_points, mc.discount_rate, mc.open_date, mc.expire_date, mc.last_consume_time, -- 商户信息 sm.company_fullname AS company_name, sm.company_shortname AS company_shortname, sm.contact_info AS company_contact, sm.contact_phone AS company_phone, -- 门店信息 sms.name AS store_name, sms.store_no, sms.phone AS store_phone, sms.address AS store_address, sms.contact AS store_contact, -- 配置信息 COALESCE(mmc_store.gift_consume_ratio, mmc_company.gift_consume_ratio, sys1.config_value) AS gift_consume_ratio, COALESCE(mmc_store.points_rate, mmc_company.points_rate, sys2.config_value) AS points_rate, COALESCE(mmc_store.points_exchange_rate, mmc_company.points_exchange_rate, sys3.config_value) AS points_exchange_rate FROM member_card mc LEFT JOIN sauna_merchant sm ON mc.fk_company_id = sm.key_id LEFT JOIN sauna_merchant_store sms ON mc.fk_store_id = sms.key_id LEFT JOIN member_merchant_config mmc_store ON mc.fk_store_id = mmc_store.fk_store_id AND mmc_store.is_enabled = 1 LEFT JOIN member_merchant_config mmc_company ON mc.fk_company_id = mmc_company.fk_company_id AND mmc_company.fk_store_id IS NULL AND mmc_company.is_enabled = 1 LEFT JOIN system_consume_config sys1 ON sys1.config_key = 'gift_consume_ratio' LEFT JOIN system_consume_config sys2 ON sys2.config_key = 'points_rate' LEFT JOIN system_consume_config sys3 ON sys3.config_key = 'points_exchange_rate';

⚙️ 核心建表SQL（完整）

-- ====================================================== -- 1. 会员卡主表（支持多商户多门店） -- ====================================================== CREATE TABLE member_card ( id BIGINT UNSIGNED NOT NULL AUTO_INCREMENT COMMENT '主键ID', key_id VARCHAR(50) NOT NULL COMMENT '业务主键ID', card_no VARCHAR(20) NOT NULL COMMENT '会员卡编号', chip_id VARCHAR(32) NOT NULL COMMENT '芯片ID唯一码', phone VARCHAR(11) NOT NULL COMMENT '绑定手机号', fk_company_id VARCHAR(50) NOT NULL COMMENT '所属公司ID', fk_store_id VARCHAR(50) NOT NULL COMMENT '所属门店ID', card_type TINYINT NOT NULL DEFAULT 1 COMMENT '卡类型:1-储值卡,2-计次卡', status TINYINT NOT NULL DEFAULT 1 COMMENT '状态:0-冻结,1-正常,2-挂失,3-注销', total_recharge BIGINT NOT NULL DEFAULT 0 COMMENT '累计充值金额', total_gift BIGINT NOT NULL DEFAULT 0 COMMENT '累计赠送金额', total_consume BIGINT NOT NULL DEFAULT 0 COMMENT '累计消费本金', total_gift_consume BIGINT NOT NULL DEFAULT 0 COMMENT '累计赠送消费', current_balance BIGINT NOT NULL DEFAULT 0 COMMENT '当前可用总余额', current_principal BIGINT NOT NULL DEFAULT 0 COMMENT '当前本金余额', current_gift BIGINT NOT NULL DEFAULT 0 COMMENT '当前赠送余额', total_points INT NOT NULL DEFAULT 0 COMMENT '累计获得积分', used_points INT NOT NULL DEFAULT 0 COMMENT '已使用积分', current_points INT NOT NULL DEFAULT 0 COMMENT '当前可用积分', discount_rate DECIMAL(5,2) NOT NULL DEFAULT 100.00 COMMENT '折扣比例', open_date DATETIME NOT NULL COMMENT '开卡日期', expire_date DATETIME DEFAULT NULL COMMENT '有效期', last_consume_time DATETIME DEFAULT NULL COMMENT '最后消费时间', sort_index INT DEFAULT 0 COMMENT '排序码', create_by VARCHAR(50) DEFAULT NULL COMMENT '创建人', create_time DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间', update_by VARCHAR(50) DEFAULT NULL COMMENT '修改人', update_time DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '修改时间', PRIMARY KEY (id), UNIQUE KEY uk_key_id (key_id), UNIQUE KEY uk_card_no (card_no), UNIQUE KEY uk_chip_id (chip_id), KEY idx_phone (phone), KEY idx_company_store (fk_company_id, fk_store_id), KEY idx_status (status), KEY idx_create_time (create_time) ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='会员卡主表'; -- ====================================================== -- 2. 会员开卡/充值记录表 -- ====================================================== CREATE TABLE member_recharge ( id BIGINT UNSIGNED NOT NULL AUTO_INCREMENT, key_id VARCHAR(50) NOT NULL COMMENT '业务主键ID', card_id BIGINT UNSIGNED NOT NULL COMMENT '会员卡自增ID', card_key_id VARCHAR(50) NOT NULL COMMENT '会员卡业务ID', recharge_no VARCHAR(32) NOT NULL COMMENT '充值流水号', recharge_type TINYINT NOT NULL COMMENT '类型:1-开卡,2-充值,3-赠送活动,4-手动调账', amount BIGINT NOT NULL DEFAULT 0 COMMENT '充值金额(本金)', gift_amount BIGINT NOT NULL DEFAULT 0 COMMENT '赠送金额', pay_method TINYINT DEFAULT NULL COMMENT '支付方式', operator_id VARCHAR(50) DEFAULT NULL COMMENT '操作人员ID', remark VARCHAR(255) DEFAULT NULL COMMENT '备注', recharge_time DATETIME NOT NULL COMMENT '充值时间', sort_index INT DEFAULT 0 COMMENT '排序码', create_by VARCHAR(50) DEFAULT NULL COMMENT '创建人', create_time DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间', update_by VARCHAR(50) DEFAULT NULL COMMENT '修改人', update_time DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '修改时间', PRIMARY KEY (id), UNIQUE KEY uk_key_id (key_id), UNIQUE KEY uk_recharge_no (recharge_no), KEY idx_card_id (card_id), KEY idx_card_key_id (card_key_id), KEY idx_recharge_time (recharge_time), KEY idx_create_time (create_time) ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='充值/开卡记录表'; -- ... 其余表结构请参见文档上方详细字段说明 ...

🧠 核心业务逻辑

💰 消费扣款流程

1 获取商户/门店配置的 gift_consume_ratio
2 根据比例计算赠送扣款金额
3 优先扣除赠送金额，不足时从本金补扣
4 按实际扣款金额计算积分
5 记录 member_consume 明细
6 同步更新 member_card 余额
7 写入 member_balance_log 变动日志

🔄 余额重算流程

1 根据 recharge + consume 重新计算
2 对比当前余额，计算差异
3 更新 member_card 为正确余额
4 记录 member_balance_recalc 重算审计
5 在 member_balance_log 中插入修正记录
6 标记相关日志 is_recalculated = 1

🏢 多商户数据隔离

• 所有查询必须带 fk_company_id
• 门店级查询额外带 fk_store_id
• 配置优先级：门店 > 公司 > 系统
• 支持跨门店会员（公司级统一管理）
• 每个商户独立积分/折扣规则

📱 无卡消费 + 审计

• 通过 phone 字段查询会员
• 支持手机号+验证码身份验证
• 所有操作记录 member_operation_log
• 记录操作前后数据快照（JSON）
• 支持操作追溯和问题排查

🚀 扩展性设计

AI编程社区

汇聚全球AI编程工具，助力开发者即刻编程。

更多推荐

码道 · 寻艺——从零构建“非遗交互式对话平台“的完整实践

AI编程社区

码道：用 Python + FastAPI 快速构建一个学生信息管理接口：从零到 Swagger 在线文档

在日常开发和教学中，我们经常需要一套简单、可控、能快速上手的后端接口来演示"前后端分离"、练习 Restful API 设计，或者作为前端联调的 Mock 服务。传统做法往往是搭一套完整的 Web 工程：配置数据库、编写 DAO、引入 ORM、做请求分发……一套流程下来，光环境搭建就要花去不少时间，对于想快速验证想法、或者刚入门 API 开发的同学来说，显得过于沉重。

AI编程社区

码道：从零构建学生信息管理系统 API：FastAPI 内存版 CRUD 项目全解析

FastAPI 的强大，很大程度上来自 Pydantic 的校验能力。我们写下类型声明，FastAPI 在运行时自动把它变成边界检查器。name：字符串，长度限制 1 到 50；age：整数，限制在 6 到 120 之间（ge大于等于、le小于等于）；gender：字符串，用正则限定只能是"男"“女”“其他”；email：邮箱格式字符串；grade与major：可选字段，代表班级和专业方向。