585 lines
19 KiB
Markdown
585 lines
19 KiB
Markdown
# 配件查询系统 - 数据库设计文档（辅助配置表）
|
||
|
||
**版本**: 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默认值
|
||
- 新增表需评估是否属于核心业务表或辅助表，放入对应文档
|
||
|