数据库设计文档

项目名称: 麦瓣健康康护到家平台 - 数据库设计方案 数据库类型: MySQL 8.0 + MongoDB 5.0 设计模式: 关系型数据库 + 文档型数据库 + JSON字段 表数量: 181张表 (MySQL 180张 + MongoDB 1张) 最后更新: 2025-11-19

设计说明: 本文档基于280个功能点需求（用户端165+技师端88+后台52），设计了181张数据表，按24个业务领域划分（用户、技师、支付、健康、营销、活动、消息、商城、服务配置、内容社区、拼团、激励成就、CRM、营销管理、培训、调查、页面装修、投诉申诉、帮助文档、权限管理、安全记录、系统配置、运营管理、分布式事务），全面支撑9个微服务架构。权限管理体系v2.0支持多租户数据隔离、RBAC权限模型、操作审计等核心功能。技师端新增7张核心账户系统表（实名认证、服务类别、营业执照、健康证明、归属关系、商户信息、团队信息），确保准入机制和归属管理的完整性。

一、数据库架构概览

1.1 技术栈

1.2 数据库部署架构

主从复制架构:

• 主库(Master): 处理所有写操作(INSERT、UPDATE、DELETE)
• 从库(Slave): 处理所有读操作(SELECT)
• 主从延迟: <1秒,binlog异步复制
• 故障切换: 从库自动提升为主库

服务架构演进策略:

• V1.0阶段：
  • 采用直接数据库查询方式，简化架构复杂度
  • 订单服务通过数据库表关联查询用户、技师数据
  • 减少跨服务依赖，加速开发和上线
• V2.0阶段：
  • 引入微服务架构，maiban-order独立部署
  • 通过HTTP/gRPC调用maiban-nurse、maiban-user等微服务
  • 使用RabbitMQ实现与maiban-nurse的异步通信
  • 采用Outbox模式保证分布式事务一致性
  • 实现服务解耦和独立扩展

分库分表策略(未来扩展):

• 订单表不分区（当前阶段不需要）
• 护理日志表按用户ID分表
• 支持水平扩展至多个数据库实例

1.3 数据安全策略

二、核心数据表设计(148张)

表结构说明

• 本文档采用简洁设计原则，使用表格列出表名+关键字段
• 敏感字段统一采用AES-256加密存储
• 所有表默认包含id(主键)、created_at、updated_at字段

2.1 用户体系(18张表)

2.2 技师体系(22张表)

2.4 支付财务体系(5张表)

2.5 健康管理体系(12张表)

2.6 营销体系(26张表)

2.7 活动任务体系(已合并到营销体系)

本节内容已合并到2.6营销体系，包括：

• 活动表 (mbn_activities)
• 用户任务表 (ums_member_task)
• 签到记录表 (mbn_user_sign_records)
• 拼团活动表 (mbn_group_buy_activities)
• 拼团参与表 (mbn_group_buy_participants)

2.8 消息通知体系(3张表 - 1张MongoDB)

2.9 商城体系(25张表)

2.10 服务配置体系(已合并到商城体系)

本节内容已合并到2.9商城体系，包括：

• 服务项目表 (mbn_service_items)
• 服务分类表 (mbn_service_categories)
• Banner表/首页广告表 (sms_home_advertise)
• 系统配置表 (mbn_system_configs)

2.11 内容社区体系(16张表)

2.12 拼团活动体系(已合并到营销体系)

本节内容已合并到2.6营销体系，包括：

• 拼团活动表 (mbn_group_buy_activities)
• 拼团参与表 (mbn_group_buy_participants)

2.13 激励成就体系(7张表)

2.14 CRM客户关系管理(7张表)

2.15 营销管理体系(8张表)

2.16 培训学习体系(3张表)

2.17 满意度调查体系(2张表)

2.18 页面装修体系(4张表-预留)

2.19 运营管理体系(3张表)

2.20 帮助文档体系(5张表)

2.21 权限管理体系(13张表)

2.22 安全记录体系(4张表)

2.23 系统配置体系(3张表)

2.24 运营审核体系(4张表)

2.25 分布式事务体系(3张表)

设计说明:

• local_message_table 采用 Outbox 模式，在业务事务中同步插入消息记录，通过定时扫描+RabbitMQ实现跨服务最终一致性
• event_dedup 提供持久化幂等保证，避免消息重复消费
• dlq_records 记录所有消费失败的消息，支持排查和批量回放
• 详细设计参见《麦瓣健康-微服务分布式事务一致性设计方案》

三、DDL建表语句（统一规范）

3.1 DDL编写规范

命名规范

• 表名: 小写+下划线，前缀表示业务领域（如：ums_用户、mbn_麦瓣业务、pms_商品、oms_订单）
• 字段名: 小写+下划线，语义清晰
• 索引名:
  • 普通索引：idx_表名_字段名
  • 唯一索引：uk_表名_字段名
  • 联合索引：idx_表名_字段1_字段2
• 外键名: fk_表名_关联表名

字段规范

• 主键: 统一使用id BIGINT UNSIGNED AUTO_INCREMENT
• 时间字段:
  • created_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间'
  • updated_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间'
• 软删除: deleted_at DATETIME DEFAULT NULL COMMENT '删除时间'
• 状态字段: 使用TINYINT或VARCHAR(20)，必须有注释说明所有可能值
• 金额字段: DECIMAL(10,2)，单位为元
• 手机号: VARCHAR(20)
• JSON字段: 使用MySQL 8.0的JSON类型

表属性规范

ENGINE=InnoDB 
DEFAULT CHARSET=utf8mb4 
COLLATE=utf8mb4_unicode_ci 
COMMENT='表功能说明';

索引设计原则

• 主键自动创建聚簇索引
• 外键字段创建普通索引
• 高频查询字段创建索引
• 唯一性字段创建唯一索引
• 复合查询创建联合索引（注意最左前缀原则）

3.2 DDL示例（用户表）

以下是一个完整的DDL示例，展示了如何遵循上述规范创建数据表：

CREATE TABLE `ums_member` (
  `id` BIGINT UNSIGNED NOT NULL AUTO_INCREMENT COMMENT '用户ID',
  `username` VARCHAR(64) DEFAULT NULL COMMENT '用户名',
  `password` VARCHAR(64) NOT NULL COMMENT '密码(BCrypt加密)',
  `nickname` VARCHAR(64) DEFAULT NULL COMMENT '昵称',
  `phone` VARCHAR(20) NOT NULL COMMENT '手机号',
  `icon` VARCHAR(500) DEFAULT NULL COMMENT '头像URL',
  `gender` TINYINT DEFAULT 0 COMMENT '性别(0未知/1男/2女)',
  `birthday` DATE DEFAULT NULL COMMENT '生日',
  `city` VARCHAR(64) DEFAULT NULL COMMENT '所在城市',
  `job` VARCHAR(100) DEFAULT NULL COMMENT '职业',
  `personalized_signature` VARCHAR(200) DEFAULT NULL COMMENT '个性签名',
  `source_type` TINYINT DEFAULT 1 COMMENT '用户来源(1APP/2H5/3后台添加)',
  `integration` INT DEFAULT 0 COMMENT '当前积分',
  `growth` INT DEFAULT 0 COMMENT '成长值',
  `lucky_count` INT DEFAULT 0 COMMENT '剩余抽奖次数',
  `history_integration` INT DEFAULT 0 COMMENT '历史总积分',
  `status` TINYINT DEFAULT 1 COMMENT '账号状态(0禁用/1正常/2注销)',
  `real_name` VARCHAR(64) DEFAULT NULL COMMENT '真实姓名',
  `id_card` VARCHAR(256) DEFAULT NULL COMMENT '身份证号(AES加密)',
  `id_card_verified` TINYINT DEFAULT 0 COMMENT '实名认证状态(0未认证/1已认证)',
  `balance` DECIMAL(10,2) DEFAULT 0.00 COMMENT '账户余额(元)',
  `created_at` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
  `updated_at` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
  `deleted_at` DATETIME DEFAULT NULL COMMENT '删除时间',
  PRIMARY KEY (`id`),
  UNIQUE KEY `uk_phone` (`phone`),
  UNIQUE KEY `uk_username` (`username`),
  KEY `idx_city` (`city`),
  KEY `idx_status` (`status`),
  KEY `idx_source_type` (`source_type`),
  KEY `idx_created_at` (`created_at`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='用户表(会员)-用户基本信息、实名认证、账户余额';

说明：

• ✅ 表名采用ums_业务前缀
• ✅ 所有字段都有中文COMMENT注释
• ✅ 主键使用BIGINT UNSIGNED AUTO_INCREMENT
• ✅ 时间字段created_at、updated_at自动维护
• ✅ 软删除字段deleted_at
• ✅ 唯一索引uk_phone、uk_username
• ✅ 普通索引针对高频查询字段
• ✅ 表注释说明表的功能
• ✅ 其他194张表均遵循相同规范

3.3 DDL使用说明

批量导入顺序

1. 基础表: 用户表、技师表、会员等级表
2. 关系表: 地址表、家庭成员表、证书表
3. 业务表: 订单表、支付表、健康档案表
4. 配置表: 系统配置表、数据字典表
5. 日志表: 登录日志表、审核日志表

初始化数据

-- 插入默认会员等级
INSERT INTO `ums_member_level` (`name`, `growth_point`, `default_status`) VALUES
('普通会员', 0, 1),
('银卡会员', 1000, 0),
('金卡会员', 5000, 0),
('钻石会员', 10000, 0);

-- 插入系统配置
INSERT INTO `mbn_system_configs` (`config_key`, `config_value`, `config_type`, `description`) VALUES
('order_payment_timeout', '1800', '订单', '待支付订单超时时间(秒)'),
('order_accept_timeout', '600', '订单', '待接单超时时间(秒)'),
('order_start_timeout', '1800', '订单', '待服务超时时间(秒)');

索引优化建议

• 定期分析慢查询日志，优化索引
• 对于大表（>100万行）考虑分区表
• 使用EXPLAIN分析查询计划
• 避免在VARCHAR类型上创建过长索引

四、数据表分布与微服务映射

3.1 服务与表的对应关系

架构演进说明：

V1.0阶段（直接数据库查询）：

• 订单服务（maiban-order）独立数据库，包含完整的订单、支付、健康档案等业务数据
• 用户服务（maiban-user）、技师服务（maiban-nurse）作为辅助数据源
• 通过数据库表关联查询获取用户、技师信息，无需跨服务调用
• 优势：开发简单、部署容易、性能高

V2.0阶段（微服务架构）：

• 订单服务（maiban-order）保持独立，但仅保留订单核心数据
• 用户、技师信息通过HTTP/gRPC调用对应微服务获取
• 引入RabbitMQ实现与maiban-nurse的异步通信
• 优势：服务解耦、独立演进、技术栈灵活

数据隔离策略：

• V1.0：订单服务拥有完整业务数据，自给自足
• V2.0：各服务拥有核心数据，通过接口共享辅助数据

总计: 181张表 (MySQL 180张 + MongoDB 1张)

表分类统计:

• 核心业务表: 181张数据表
• 用户体系相关: 18张
• 护理师相关: 28张（+7张新增：实名认证、服务类别、营业执照、健康证明、归属关系、商户信息、团队信息）
• 订单体系相关: 9张（+4张新增：订单表、团体订单表、支付记录表、订单状态日志表）
• 健康管理相关: 12张
• 支付财务相关: 5张
• 营销体系相关: 26张
• IM消息相关: 3张
• 商城体系相关: 25张
• 权限管理相关: 13张（+2张新增：租户表、审计日志表）
• 分布式事务相关: 3张
• 其他业务表: 39张

文档维护: 麦瓣健康产品团队 项目名称: 麦瓣健康康护到家平台 最后更新: 2025-11-19

变更记录:

• 2025-11-19 v3.4: ✅ 订单体系表同步：
  • 新增订单体系表：同步PRD中的4张订单表（mbn_orders、mbn_group_orders、mbn_payments、mbn_order_status_logs）
  • 订单服务调整：订单服务从负责5张表调整为9张表
  • 表分类统计更新：在表分类统计中新增"订单体系相关: 9张"分类
  • 设计规范统一：所有表均采用mbn_前缀命名，支持多租户隔离和软删除
• 2025-11-19 v3.3: 🗑️ 删除订单体系表：
  • 删除订单体系章节：移除订单相关17张表（oms_order、oms_order_item、oms_order_operate_history、oms_cart_item、oms_order_return_apply、oms_order_return_reason、oms_order_setting、oms_company_address、mbn_service_orders、mbn_order_checkins、mbn_order_tracks、mbn_nursing_packages、mbn_user_packages、mbn_order_delay_records、mbn_order_cancel_records、mbn_long_term_appointments、mbn_mileage_records、mbn_assessment_forms）
  • 表总数调整：从198张减少至181张，业务领域从25个减少至24个
  • 订单服务调整：订单服务从负责16张表调整为5张表
  • 数据迁移：订单相关数据迁移至PRD独立文档管理
• 2025-11-17 v3.2: 🔄 管理端权限系统数据库脚本整合 (Issue #72)：
  • 整合V1.0-V1.7所有变更：创建统一脚本文件 backend/init-database-complete.sql，整合了所有版本的表结构变更和初始化数据
  • 资源表字段优化：ums_resource表新增method(HTTP方法)和sort(排序值)字段，支持更精确的权限控制
  • 关系表租户隔离：ums_admin_role_relation、ums_role_menu_relation、ums_role_resource_relation新增tenant_id字段
  • 密码历史表：新增ums_admin_password_history表，记录管理员密码修改历史，防止密码重复使用
  • 初始化数据优化：超级管理员默认密码Admin@123，基础菜单优化为9个（移除资源分类管理菜单）
  • 脚本完善：补充外键约束设置，SET FOREIGN_KEY_CHECKS = 0/1 确保建表顺序正确
• 2025-11-05 v3.1: 🔧 权限管理系统软删除支持完善 (Issue #44)：
  • 升级表(6张)：
    • ums_role：新增deleted_at字段、idx_tenant_deleted索引(tenant_id, deleted_at)
    • ums_menu：新增deleted_at字段、idx_tenant_deleted索引
    • ums_resource：新增deleted_at字段、idx_tenant_deleted索引
    • ums_resource_category：新增deleted_at字段、idx_tenant_deleted索引
    • ums_admin_login_log：新增deleted_at字段、idx_tenant_deleted索引
    • mbn_audit_logs：新增deleted_at字段、idx_tenant_deleted索引
  • 初始化数据优化：
    • 超级管理员密码更新为Admin@123（BCrypt: $2b$10$2JTvgSinYh.R6XlRgoMd3uUKXaIu25Uw8iWLGtvr44yyRZZGSofKC）
    • 基础菜单扩充至10个（新增：租户管理、资源分类管理、登录日志、审计日志）
  • 模块化脚本：创建backend/database/sql/maiban-admin/模块脚本（V1.0表结构、V1.1初始化数据、V1.0回滚）
  • 核心改进：所有管理端核心表统一支持软删除和租户隔离索引优化
• 2025-11-04 v3.0: 🔐 权限管理系统v2.0-多租户隔离升级：
  • 新增表(2张)：ums_tenant(租户表)、mbn_audit_logs(审计日志表)
  • 升级表(7张)：
    • ums_admin：新增tenant_id、real_name、phone、last_login_ip、password_update_time、deleted_at字段，调整为BIGINT UNSIGNED主键
    • ums_role：新增tenant_id字段，支持租户级角色隔离
    • ums_menu：新增tenant_id字段，支持平台通用菜单(tenant_id=0)和租户自定义菜单
    • ums_resource：新增tenant_id字段，支持平台通用资源(tenant_id=0)和租户自定义资源
    • ums_resource_category：新增tenant_id字段，支持租户级分类隔离
    • ums_admin_login_log：新增tenant_id、login_result、fail_reason字段
    • ums_admin_role_relation/ums_role_menu_relation/ums_role_resource_relation：新增created_at字段，调整主键为BIGINT UNSIGNED
  • 核心特性：完整支持多租户数据隔离、RBAC权限模型、操作审计、细粒度权限控制
  • 表总数：196→198张
• 2025-10-29 v2.3: 📝 优化用户账户系统字段：
  • ums_member表：新增id_card_expire_date(身份证有效期)、real_name_fail_reason(认证失败原因)、auth_time(认证通过时间)、deleted_at(软删除)字段
  • ums_member_login_log表：新增device_model(设备型号)、device_system(iOS/Android)字段
  • mbn_account_cancel_records表：新增cancel_feedback(详细反馈)、cooldown_days(冷静期天数)、operator_note(操作备注)字段
  • 所有调整遵循DDL规范：BIGINT UNSIGNED主键、TINYINT状态字段、VARCHAR(20)手机号、完整中文注释
• 2025-10-29 v2.2: 🎯 完善用户端账户系统：更新ums_member表（新增微信授权和实名认证字段），新增mbn_account_cancel_records表（账号注销记录），表总数195→196张
• 2025-10-29 v2.1: 📝 新增DDL建表语句章节：新增统一规范和DDL示例，包含命名规范、字段规范、索引设计原则，提供用户表完整DDL示例（含中文注释）、批量导入顺序、初始化数据示例
• 2025-10-24 v2.0: 🎯 新增技师归属关系管理：新增3张表（mbn_nurse_affiliation、mbn_merchants、mbn_nurse_teams），支持平台技师/商户技师/团队技师三种归属类型，表总数192→195张
• 2025-10-24 v1.1: 新增技师端账户系统4张表（实名认证、服务类别、营业执照、健康证明），表总数188→192张
• 2025-10-21 v1.0: 初始版本，188张表