PartsInquiry/doc/数据库设计文档-辅助配置表.md

配件查询系统 - 数据库设计文档（辅助配置表）

版本: 1.0
更新时间: 2025-10-01
数据库: MySQL 8.0
字符集: utf8mb4 / utf8mb4_0900_ai_ci

---

一、VIP会员体系

1.1 vip_users（会员用户）

字段	类型	空值	默认值	说明
id	BIGINT UNSIGNED	NO	AUTO_INCREMENT	主键
shop_id	BIGINT UNSIGNED	NO		店铺ID
user_id	BIGINT UNSIGNED	NO		用户ID
is_vip	TINYINT(1)	NO	1	是否VIP（1是 0否）
status	TINYINT UNSIGNED	NO	0	启用状态：1启用 0停用
expire_at	DATETIME	YES	NULL	到期时间
remark	VARCHAR(255)	YES	NULL	备注/审核说明
reviewer_id	BIGINT UNSIGNED	YES	NULL	审核人
reviewed_at	DATETIME	YES	NULL	审核时间
created_at	TIMESTAMP	NO	CURRENT_TIMESTAMP	创建时间
updated_at	TIMESTAMP	NO	CURRENT_TIMESTAMP	更新时间

索引：

• PRIMARY KEY: id
• KEY: idx_vu_shop_user (shop_id, user_id)
• KEY: idx_vu_shop_status (shop_id, status)

外键：

• fk_vu_shop: shop_id → shops(id)
• fk_vu_user: user_id → users(id)
• fk_vu_reviewer: reviewer_id → users(id)

说明：

• VIP状态判定：status=1 AND is_vip=1 AND (expire_at IS NULL OR expire_at >= NOW())
• 非VIP用户数据可见性：最近60天（可配置）
• VIP用户：查看全部历史数据

---

1.2 vip_price（VIP价格）

字段	类型	空值	默认值	说明
price	DECIMAL(10,2)	NO		单月价格（元）

索引：无

说明：

• 全局配置表，仅一条记录
• 表示平台统一VIP单月价格
• 管理端可读取和修改

---

1.3 vip_recharges（VIP充值记录）

字段	类型	空值	默认值	说明
id	BIGINT UNSIGNED	NO	AUTO_INCREMENT	主键
shop_id	BIGINT UNSIGNED	NO		店铺ID
user_id	BIGINT UNSIGNED	NO		用户ID
price	DECIMAL(10,2)	NO		本次充值价格（元）
duration_days	INT	NO		本次续期天数
expire_from	DATETIME	YES	NULL	生效前到期时间
expire_to	DATETIME	NO		生效后到期时间
channel	VARCHAR(32)	NO	'oneclick'	渠道（oneclick/...）
created_at	TIMESTAMP	NO	CURRENT_TIMESTAMP	创建时间

索引：

• PRIMARY KEY: id
• KEY: idx_vr_shop (shop_id)
• KEY: idx_vr_user (user_id)

外键：

• fk_vr_shop: shop_id → shops(id)
• fk_vr_user: user_id → users(id)

说明：记录每次VIP开通/续费的历史，支持对账和查询。

---

二、普通管理员体系

2.1 normal_admin_audits（普通管理员审计）

字段	类型	空值	默认值	说明
id	BIGINT UNSIGNED	NO	AUTO_INCREMENT	主键
shop_id	BIGINT UNSIGNED	NO		店铺ID
user_id	BIGINT UNSIGNED	NO		用户ID
action	ENUM('apply','approve','reject','revoke','expire')	NO		操作类型
remark	VARCHAR(255)	YES	NULL	备注
operator_admin_id	BIGINT UNSIGNED	YES	NULL	平台管理员ID
previous_role	VARCHAR(32)	YES	NULL	变更前角色
new_role	VARCHAR(32)	YES	NULL	变更后角色
created_at	TIMESTAMP	NO	CURRENT_TIMESTAMP	创建时间

索引：

• PRIMARY KEY: id
• KEY: idx_naudit_shop_time (shop_id, created_at)
• KEY: idx_naudit_user_time (user_id, created_at)

外键：

• fk_naudit_shop: shop_id → shops(id)
• fk_naudit_user: user_id → users(id)
• fk_naudit_admin: operator_admin_id → admins(id)

说明：

• 普通管理员申请、审批、撤销的完整审计日志
• 当前状态 = 按user_id取最后一条记录的action
• VIP失效触发降级时写入expire审计

---

三、身份与认证

3.1 user_identities（第三方身份映射）

字段	类型	空值	默认值	说明
id	BIGINT UNSIGNED	NO	AUTO_INCREMENT	主键
shop_id	BIGINT UNSIGNED	NO		店铺ID
user_id	BIGINT UNSIGNED	NO		用户ID
provider	ENUM('wechat_mp','wechat_app')	NO		身份提供方
openid	VARCHAR(64)	NO		微信openid
unionid	VARCHAR(64)	YES	NULL	微信unionid
nickname	VARCHAR(64)	YES	NULL	昵称
avatar_url	VARCHAR(512)	YES	NULL	头像URL
last_login_at	DATETIME	YES	NULL	最后登录时间
created_at	TIMESTAMP	NO	CURRENT_TIMESTAMP	创建时间
updated_at	TIMESTAMP	NO	CURRENT_TIMESTAMP	更新时间

索引：

• PRIMARY KEY: id
• KEY: idx_identity_user (user_id)
• KEY: idx_identity_shop (shop_id)
• UNIQUE: ux_identity_provider_openid (provider, openid)
• UNIQUE: ux_identity_unionid (unionid)

外键：

• fk_identity_shop: shop_id → shops(id)
• fk_identity_user: user_id → users(id)

说明：

• 支持微信小程序和APP登录
• 短信登录使用users.phone作为全局唯一身份，不创建identity记录

---

3.2 wechat_sessions（微信会话）

字段	类型	空值	默认值	说明
id	BIGINT UNSIGNED	NO	AUTO_INCREMENT	主键
provider	ENUM('wechat_mp','wechat_app')	NO		提供方
openid	VARCHAR(64)	NO		微信openid
session_key	VARCHAR(128)	NO		会话密钥
expires_at	DATETIME	NO		过期时间
created_at	TIMESTAMP	NO	CURRENT_TIMESTAMP	创建时间

索引：

• PRIMARY KEY: id
• KEY: idx_wechat_session_expires (expires_at)
• UNIQUE: ux_wechat_session (provider, openid)

说明：临时存储微信会话密钥。

---

3.3 sms_codes（短信验证码）

字段	类型	空值	默认值	说明
id	BIGINT UNSIGNED	NO	AUTO_INCREMENT	主键
phone	VARCHAR(32)	NO		手机号
scene	VARCHAR(32)	NO	'login'	场景：login/register/...
code_hash	CHAR(64)	NO		验证码哈希（SHA-256）
salt	CHAR(32)	NO		加盐字符串
expire_at	DATETIME	NO		过期时间
status	TINYINT UNSIGNED	NO	0	0=active 1=used 2=expired 3=blocked
fail_count	TINYINT UNSIGNED	NO	0	错误次数
ip	VARCHAR(45)	YES	NULL	发送IP
created_at	TIMESTAMP	NO	CURRENT_TIMESTAMP	创建时间
updated_at	TIMESTAMP	NO	CURRENT_TIMESTAMP	更新时间

索引：

• PRIMARY KEY: id
• KEY: idx_phone_created_at (phone, created_at)
• KEY: idx_phone_scene_status (phone, scene, status)
• KEY: idx_expire_at (expire_at)
• KEY: idx_ip_created_at (ip, created_at)

说明：

• 验证码采用哈希+盐存储
• 支持多场景（登录、注册、重置密码等）
• 记录失败次数防止暴力破解

---

3.4 email_codes（邮箱验证码）

字段	类型	空值	默认值	说明
id	BIGINT UNSIGNED	NO	AUTO_INCREMENT	主键
email	VARCHAR(128)	NO		邮箱
scene	VARCHAR(32)	NO		场景：login/register/reset
code_hash	VARCHAR(64)	NO		验证码哈希（SHA-256）
salt	VARCHAR(64)	NO		加盐字符串
expire_at	DATETIME	NO		过期时间
status	TINYINT UNSIGNED	NO	0	0=unused 1=used 2=expired
fail_count	INT	NO	0	错误次数
ip	VARCHAR(64)	YES	NULL	发送IP
created_at	TIMESTAMP	NO	CURRENT_TIMESTAMP	创建时间
updated_at	TIMESTAMP	NO	CURRENT_TIMESTAMP	更新时间

索引：

• PRIMARY KEY: id
• KEY: idx_email_scene_created (email, scene, created_at)
• KEY: idx_email_expire (expire_at)

说明：与sms_codes类似，用于邮箱验证场景。

---

四、咨询与公告

4.1 consults（咨询）

字段	类型	空值	默认值	说明
id	BIGINT UNSIGNED	NO	AUTO_INCREMENT	主键
shop_id	BIGINT UNSIGNED	NO		所属店铺
user_id	BIGINT UNSIGNED	NO		提问用户
topic	VARCHAR(120)	NO		主题
message	TEXT	NO		咨询内容
status	ENUM('open','resolved','closed')	NO	'open'	状态
created_at	TIMESTAMP	NO	CURRENT_TIMESTAMP	创建时间
updated_at	TIMESTAMP	NO	CURRENT_TIMESTAMP	更新时间

索引：

• PRIMARY KEY: id
• KEY: idx_consult_shop_status (shop_id, status)
• KEY: fk_consult_user (user_id)

外键：

• fk_consult_shop: shop_id → shops(id)
• fk_consult_user: user_id → users(id)

说明：

• open=未解决，resolved=已解决，closed=关闭
• 触发器：有回复时自动标记为resolved

---

4.2 consult_replies（咨询回复）

字段	类型	空值	默认值	说明
id	BIGINT UNSIGNED	NO	AUTO_INCREMENT	主键
consult_id	BIGINT UNSIGNED	NO		所属咨询
user_id	BIGINT UNSIGNED	NO		回复人（管理员）
content	TEXT	NO		回复内容
created_at	TIMESTAMP	NO	CURRENT_TIMESTAMP	回复时间

索引：

• PRIMARY KEY: id
• KEY: idx_cr_consult (consult_id)
• KEY: fk_cr_user (user_id)

外键：

• fk_cr_consult: consult_id → consults(id)
• fk_cr_user: user_id → users(id)

说明：管理员对咨询的回复记录。

---

4.3 notices（公告）

字段	类型	空值	默认值	说明
id	BIGINT UNSIGNED	NO	AUTO_INCREMENT	主键
title	VARCHAR(120)	NO		标题
content	VARCHAR(500)	NO		内容（跑马灯）
tag	VARCHAR(32)	YES	NULL	标签（如"活动"）
is_pinned	TINYINT(1)	NO	0	是否置顶
starts_at	DATETIME	YES	NULL	生效开始时间
ends_at	DATETIME	YES	NULL	生效结束时间
status	ENUM('draft','published','offline')	NO	'published'	状态
created_at	TIMESTAMP	NO	CURRENT_TIMESTAMP	创建时间
updated_at	TIMESTAMP	NO	CURRENT_TIMESTAMP	更新时间
deleted_at	DATETIME	YES	NULL	软删除标记

索引：

• PRIMARY KEY: id
• KEY: idx_notices_time (starts_at, ends_at)

说明：

• 平台全局公告，与租户无关
• 前台仅显示status='published'且在有效期内的公告
• 排序：is_pinned DESC, created_at DESC

---

五、系统配置

5.1 system_parameters（系统参数）

字段	类型	空值	默认值	说明
id	BIGINT UNSIGNED	NO	AUTO_INCREMENT	主键
shop_id	BIGINT UNSIGNED	NO		店铺ID
user_id	BIGINT UNSIGNED	NO		创建/修改人
key	VARCHAR(64)	NO		参数键
value	JSON	NO		参数值（JSON）
created_at	TIMESTAMP	NO	CURRENT_TIMESTAMP	创建时间
updated_at	TIMESTAMP	NO	CURRENT_TIMESTAMP	更新时间

索引：

• PRIMARY KEY: id
• KEY: idx_sysparams_shop (shop_id)
• UNIQUE: ux_sysparams_shop_key (shop_id, key)

外键：

• fk_sysparams_shop: shop_id → shops(id)
• fk_sysparams_user: user_id → users(id)

说明：

• 租户级配置，支持JSON格式存储复杂配置
• 常用配置键：
  • vip.dataRetentionDaysForNonVip: 非VIP数据保留天数（默认60）
  • normalAdmin.autoApprove: 普通管理员自动审批（默认false）
  • normalAdmin.requiredVipActive: 要求VIP有效（默认true）

---

5.2 finance_categories（财务分类）

字段	类型	空值	默认值	说明
id	BIGINT UNSIGNED	NO	AUTO_INCREMENT	主键
shop_id	BIGINT UNSIGNED	NO		店铺ID（0=全局）
type	ENUM('income','expense')	NO		收入/支出
key	VARCHAR(64)	NO		分类key
label	VARCHAR(120)	NO		分类名称
sort_order	INT	NO	0	排序
status	TINYINT UNSIGNED	NO	1	1=启用 0=停用
created_at	TIMESTAMP	NO	CURRENT_TIMESTAMP	创建时间
updated_at	TIMESTAMP	NO	CURRENT_TIMESTAMP	更新时间

索引：

• PRIMARY KEY: id
• KEY: idx_fc_shop_type (shop_id, type)
• UNIQUE: ux_fc_shop_key (shop_id, key)

说明：

• 管理其他收入/支出的分类
• shop_id=0为平台默认分类
• 读取优先级：finance_categories表 → system_parameters → application.properties

---

六、附件管理

6.1 attachments（通用附件）

字段	类型	空值	默认值	说明
id	BIGINT UNSIGNED	NO	AUTO_INCREMENT	主键
shop_id	BIGINT UNSIGNED	YES	NULL	店铺ID（全局资源可空）
user_id	BIGINT UNSIGNED	YES	NULL	上传人
owner_type	VARCHAR(32)	NO		归属类型：product/part_submission/...
owner_id	BIGINT UNSIGNED	NO		归属ID
url	VARCHAR(512)	NO		文件URL
hash	VARCHAR(64)	YES	NULL	内容哈希（SHA-256）
meta	JSON	YES	NULL	元数据
created_at	TIMESTAMP	NO	CURRENT_TIMESTAMP	创建时间

索引：

• PRIMARY KEY: id
• KEY: idx_attachments_owner (owner_type, owner_id)
• UNIQUE: ux_attachments_hash (hash)

外键：

• fk_att_shop: shop_id → shops(id)
• fk_att_user: user_id → users(id)

说明：

• 通过hash实现文件去重
• 支持多种归属类型（商品、配件提交、全局SKU等）
• meta字段存储文件元信息（大小、类型等）

---

七、配件参数字典（扩展）

7.1 part_attribute_dictionary（参数字典）

字段	类型	空值	默认值	说明
id	BIGINT UNSIGNED	NO	AUTO_INCREMENT	主键
attribute_name	VARCHAR(64)	NO		参数名称
attribute_unit	VARCHAR(16)	YES	NULL	单位
attribute_type	ENUM('numeric','text','enum')	NO	'text'	类型
enum_values	JSON	YES	NULL	枚举值
is_searchable	TINYINT(1)	NO	1	是否可搜索
sort_order	INT	NO	0	排序
created_at	TIMESTAMP	NO	CURRENT_TIMESTAMP	创建时间
updated_at	TIMESTAMP	NO	CURRENT_TIMESTAMP	更新时间

索引：

• PRIMARY KEY: id
• UNIQUE: ux_pad_name (attribute_name)

说明：全局参数字典，定义可用的配件参数。

---

7.2 part_categories（配件分类）

字段	类型	空值	默认值	说明
id	BIGINT UNSIGNED	NO	AUTO_INCREMENT	主键
name	VARCHAR(64)	NO		分类名称
parent_id	BIGINT UNSIGNED	YES	NULL	父分类
sort_order	INT	NO	0	排序
created_at	TIMESTAMP	NO	CURRENT_TIMESTAMP	创建时间
updated_at	TIMESTAMP	NO	CURRENT_TIMESTAMP	更新时间

索引：

• PRIMARY KEY: id
• KEY: idx_pc_parent (parent_id)
• UNIQUE: ux_pc_name (name)

说明：配件专用分类，支持层级结构。

---

7.3 part_category_attributes（分类参数关联）

字段	类型	空值	默认值	说明
id	BIGINT UNSIGNED	NO	AUTO_INCREMENT	主键
category_id	BIGINT UNSIGNED	NO		分类ID
attribute_id	BIGINT UNSIGNED	NO		参数ID
is_required	TINYINT(1)	NO	0	是否必填
sort_order	INT	NO	0	排序

索引：

• PRIMARY KEY: id
• KEY: idx_pca_category (category_id)
• UNIQUE: ux_pca_cat_attr (category_id, attribute_id)

外键：

• fk_pca_category: category_id → part_categories(id) ON DELETE CASCADE
• fk_pca_attribute: attribute_id → part_attribute_dictionary(id) ON DELETE CASCADE

说明：定义每个配件分类应包含哪些参数。

---

7.4 part_attribute_templates（参数模板）

字段	类型	空值	默认值	说明
id	BIGINT UNSIGNED	NO	AUTO_INCREMENT	主键
template_name	VARCHAR(64)	NO		模板名称
category_id	BIGINT UNSIGNED	YES	NULL	关联分类
attributes	JSON	NO		参数定义JSON
created_at	TIMESTAMP	NO	CURRENT_TIMESTAMP	创建时间
updated_at	TIMESTAMP	NO	CURRENT_TIMESTAMP	更新时间

索引：

• PRIMARY KEY: id
• KEY: idx_pat_category (category_id)
• UNIQUE: ux_pat_name (template_name)

说明：预定义的参数模板，快速应用到配件。

---

八、配置参数说明

8.1 VIP相关配置

配置键	类型	默认值	说明
vip.dataRetentionDaysForNonVip	number	60	非VIP数据保留天数
vip.price	number	15	VIP单月价格（元）
vip.durationDays	number	30	开通时长（天）

8.2 普通管理员配置

配置键	类型	默认值	说明
normalAdmin.autoApprove	boolean	false	是否自动通过申请
normalAdmin.requiredVipActive	boolean	true	是否要求VIP有效

8.3 财务分类配置

收入分类（income_categories）：

• operation_income: 经营所得
• interest_income: 利息收入
• other_income: 其它收入
• deposit_ar_income: 收订金/欠款
• investment_income: 投资收入
• sale_income: 销售收入
• account_operation: 账户操作
• fund_transfer_in: 资金转账转入

支出分类（expense_categories）：

• operation_expense: 经营支出
• office_supplies: 办公用品
• rent: 房租
• interest_expense: 利息支出
• other_expense: 其它支出
• account_operation: 账户操作
• fund_transfer_out: 资金转账转出

---

九、数据安全与性能

9.1 敏感数据加密

• 密码：SHA-256哈希存储（password_hash）
• 验证码：SHA-256哈希+盐（code_hash + salt）
• 第三方token：加密存储（wechat_sessions.session_key）

9.2 索引策略

• 高频查询字段：shop_id, user_id, status, created_at
• 唯一性约束：email, phone, openid, hash
• 复合索引：(shop_id, status), (user_id, created_at)
• 全文索引：仅用于products.search_text

9.3 数据清理

定期清理：

• sms_codes/email_codes：清理7天前expired记录
• wechat_sessions：清理过期会话
• inventory_movements：归档6个月前数据（可选）

软删除：

• 业务表采用deleted_at标记
• 查询默认过滤deleted_at IS NULL
• 定期归档软删除数据

---

十、扩展性设计

10.1 JSON字段应用

• products.attributes_json: 扩展商品属性
• part_submissions.attributes/images/tags: 灵活配件数据
• attachments.meta: 文件元信息
• system_parameters.value: 动态配置

10.2 ENUM类型管理

• 新增枚举值需要ALTER TABLE
• 重要状态采用ENUM确保数据一致性
• 次要分类采用VARCHAR + 配置表

10.3 多语言支持预留

• 公告内容可扩展为JSON：{zh: "中文", en: "English"}
• 财务分类label可支持多语言
• 当前版本仅支持简体中文

---

文档维护说明：

• 辅助表主要用于系统配置、认证、审计和扩展功能
• 任何结构变更必须同步更新本文档和backend/db/db.sql
• 配置参数变更需同时更新application.properties默认值
• 新增表需评估是否属于核心业务表或辅助表，放入对应文档