准备上传

2025-10-08 19:15:20 +08:00
parent 0aa7d55a23
commit 0e14a5fa1c
193 changed files with 14697 additions and 2461 deletions
--- a/doc/数据库设计文档-核心业务表.md
+++ b/doc/数据库设计文档-核心业务表.md
@@ -0,0 +1,997 @@
+# 配件查询系统 - 数据库设计文档（核心业务表）
+
+**版本**: 1.0  
+**更新时间**: 2025-10-01  
+**数据库**: MySQL 8.0  
+**字符集**: utf8mb4 / utf8mb4_0900_ai_ci  
+
+---
+
+## 一、租户与用户体系
+
+### 1.1 shops（店铺/租户）
+
+| 字段 | 类型 | 空值 | 默认值 | 说明 |
+|------|------|------|--------|------|
+| id | BIGINT UNSIGNED | NO | AUTO_INCREMENT | 主键 |
+| name | VARCHAR(100) | NO | | 店铺名称 |
+| status | TINYINT UNSIGNED | NO | 1 | 1=启用 0=停用 |
+| created_at | TIMESTAMP | NO | CURRENT_TIMESTAMP | 创建时间 |
+| updated_at | TIMESTAMP | NO | CURRENT_TIMESTAMP | 更新时间 |
+| deleted_at | DATETIME | YES | NULL | 软删除标记 |
+
+**索引**：
+- PRIMARY KEY: `id`
+- KEY: `idx_shops_status` (`status`)
+
+**说明**：多租户隔离的核心表，所有业务数据必须关联shop_id。
+
+---
+
+### 1.2 users（用户）
+
+| 字段 | 类型 | 空值 | 默认值 | 说明 |
+|------|------|------|--------|------|
+| id | BIGINT UNSIGNED | NO | AUTO_INCREMENT | 主键 |
+| shop_id | BIGINT UNSIGNED | NO | | 所属店铺 |
+| phone | VARCHAR(32) | YES | NULL | 手机号（全局唯一） |
+| email | VARCHAR(128) | YES | NULL | 邮箱（全局唯一） |
+| avatar_url | VARCHAR(512) | YES | NULL | 头像URL |
+| name | VARCHAR(64) | NO | | 用户姓名 |
+| role | VARCHAR(32) | NO | 'staff' | 角色：owner/staff/normal_admin |
+| password_hash | VARCHAR(255) | YES | NULL | 密码哈希 |
+| status | TINYINT UNSIGNED | NO | 1 | 1=启用 0=停用 |
+| is_owner | TINYINT(1) | NO | 0 | 是否店主 |
+| created_at | TIMESTAMP | NO | CURRENT_TIMESTAMP | 创建时间 |
+| updated_at | TIMESTAMP | NO | CURRENT_TIMESTAMP | 更新时间 |
+| deleted_at | DATETIME | YES | NULL | 软删除标记 |
+
+**索引**：
+- PRIMARY KEY: `id`
+- KEY: `idx_users_shop` (`shop_id`)
+- UNIQUE: `uk_users_phone` (`phone`)
+- UNIQUE: `ux_users_email` (`email`)
+
+**外键**：
+- `fk_users_shop`: `shop_id` → `shops(id)`
+
+**说明**：支持手机号、邮箱双登录方式；role字段支持普通管理员权限标识。
+
+---
+
+### 1.3 admins（平台管理员）
+
+| 字段 | 类型 | 空值 | 默认值 | 说明 |
+|------|------|------|--------|------|
+| id | BIGINT UNSIGNED | NO | AUTO_INCREMENT | 主键 |
+| username | VARCHAR(64) | NO | | 登录名 |
+| phone | VARCHAR(32) | YES | NULL | 手机号 |
+| password_hash | VARCHAR(255) | YES | NULL | 密码哈希 |
+| status | TINYINT UNSIGNED | NO | 1 | 1=启用 0=停用 |
+| created_at | TIMESTAMP | NO | CURRENT_TIMESTAMP | 创建时间 |
+| updated_at | TIMESTAMP | NO | CURRENT_TIMESTAMP | 更新时间 |
+| deleted_at | DATETIME | YES | NULL | 软删除标记 |
+
+**索引**：
+- PRIMARY KEY: `id`
+- UNIQUE: `ux_admins_username` (`username`)
+- UNIQUE: `ux_admins_phone` (`phone`)
+
+**说明**：平台管理员不归属任何店铺，可跨租户管理数据。
+
+---
+
+## 二、商品与库存体系
+
+### 2.1 products（商品）
+
+| 字段 | 类型 | 空值 | 默认值 | 说明 |
+|------|------|------|--------|------|
+| id | BIGINT UNSIGNED | NO | AUTO_INCREMENT | 主键 |
+| shop_id | BIGINT UNSIGNED | NO | | 所属店铺 |
+| user_id | BIGINT UNSIGNED | NO | | 创建人 |
+| name | VARCHAR(120) | NO | | 商品名称 |
+| category_id | BIGINT UNSIGNED | YES | NULL | 类别ID |
+| template_id | BIGINT UNSIGNED | YES | NULL | 配件模板ID |
+| brand | VARCHAR(64) | YES | NULL | 品牌 |
+| model | VARCHAR(64) | YES | NULL | 型号 |
+| spec | VARCHAR(128) | YES | NULL | 规格 |
+| origin | VARCHAR(64) | YES | NULL | 产地 |
+| barcode | VARCHAR(32) | YES | NULL | 条码 |
+| dedupe_key | VARCHAR(512) | YES | NULL | 去重键 |
+| alias | VARCHAR(120) | YES | NULL | 别名 |
+| is_blacklisted | TINYINT(1) | NO | 0 | 黑名单标记 |
+| description | TEXT | YES | NULL | 描述 |
+| global_sku_id | BIGINT UNSIGNED | YES | NULL | 全局SKU ID |
+| source_submission_id | BIGINT UNSIGNED | YES | NULL | 来源提交ID |
+| attributes_json | JSON | YES | NULL | 扩展属性JSON |
+| safe_min | DECIMAL(18,3) | YES | NULL | 安全库存下限 |
+| safe_max | DECIMAL(18,3) | YES | NULL | 安全库存上限 |
+| search_text | TEXT | YES | NULL | 全文检索聚合字段 |
+| created_at | TIMESTAMP | NO | CURRENT_TIMESTAMP | 创建时间 |
+| updated_at | TIMESTAMP | NO | CURRENT_TIMESTAMP | 更新时间 |
+| deleted_at | DATETIME | YES | NULL | 软删除标记 |
+| is_active | TINYINT | YES | | 计算字段：deleted_at IS NULL |
+
+**索引**：
+- PRIMARY KEY: `id`
+- KEY: `idx_products_shop` (`shop_id`)
+- KEY: `idx_products_category` (`category_id`)
+- KEY: `idx_products_template` (`template_id`)
+- KEY: `idx_products_dedupe` (`dedupe_key`)
+- KEY: `idx_products_shop_blacklist` (`shop_id`, `is_blacklisted`)
+- FULLTEXT: `ft_products_search` (`name`, `brand`, `model`, `spec`, `search_text`)
+- UNIQUE: `ux_products_shop_barcode` (`shop_id`, `barcode`)
+- UNIQUE: `ux_products_template_name_model` (`template_id`, `name`, `model`)
+
+**外键**：
+- `fk_products_shop`: `shop_id` → `shops(id)`
+- `fk_products_user`: `user_id` → `users(id)`
+- `fk_products_category`: `category_id` → `product_categories(id)`
+- `fk_products_template`: `template_id` → `part_templates(id)`
+- `fk_products_globalsku`: `global_sku_id` → `global_skus(id)`
+
+**说明**：核心商品表，支持模板化参数、全文检索、去重和黑名单管理。
+
+---
+
+### 2.2 product_prices（商品价格）
+
+| 字段 | 类型 | 空值 | 默认值 | 说明 |
+|------|------|------|--------|------|
+| product_id | BIGINT UNSIGNED | NO | | 商品ID（主键） |
+| shop_id | BIGINT UNSIGNED | NO | | 店铺ID |
+| user_id | BIGINT UNSIGNED | NO | | 最后修改人 |
+| purchase_price | DECIMAL(18,2) | NO | 0.00 | 进货价 |
+| retail_price | DECIMAL(18,2) | NO | 0.00 | 零售价 |
+| wholesale_price | DECIMAL(18,2) | NO | 0.00 | 批发价 |
+| big_client_price | DECIMAL(18,2) | NO | 0.00 | 大客户价 |
+| updated_at | TIMESTAMP | NO | CURRENT_TIMESTAMP | 更新时间 |
+
+**索引**：
+- PRIMARY KEY: `product_id`
+- KEY: `idx_prices_shop` (`shop_id`)
+
+**外键**：
+- `fk_prices_product`: `product_id` → `products(id)` ON DELETE CASCADE
+- `fk_prices_shop`: `shop_id` → `shops(id)`
+- `fk_prices_user`: `user_id` → `users(id)`
+
+**约束**：所有价格字段 >= 0
+
+**说明**：四列销售价格支持不同客户等级定价策略。
+
+---
+
+### 2.3 inventories（库存）
+
+| 字段 | 类型 | 空值 | 默认值 | 说明 |
+|------|------|------|--------|------|
+| product_id | BIGINT UNSIGNED | NO | | 商品ID（主键） |
+| shop_id | BIGINT UNSIGNED | NO | | 店铺ID |
+| user_id | BIGINT UNSIGNED | NO | | 最后修改人 |
+| quantity | DECIMAL(18,3) | NO | 0.000 | 库存数量 |
+| updated_at | TIMESTAMP | NO | CURRENT_TIMESTAMP | 更新时间 |
+
+**索引**：
+- PRIMARY KEY: `product_id`
+- KEY: `idx_inventories_shop` (`shop_id`)
+
+**外键**：
+- `fk_inv_product`: `product_id` → `products(id)` ON DELETE CASCADE
+- `fk_inv_shop`: `shop_id` → `shops(id)`
+- `fk_inv_user`: `user_id` → `users(id)`
+
+**约束**：quantity >= 0
+
+**说明**：支持小数精度(3位)，适配多种计量单位。
+
+---
+
+### 2.4 product_categories（商品类别）
+
+| 字段 | 类型 | 空值 | 默认值 | 说明 |
+|------|------|------|--------|------|
+| id | BIGINT UNSIGNED | NO | AUTO_INCREMENT | 主键 |
+| shop_id | BIGINT UNSIGNED | NO | | 店铺ID（0=全局） |
+| user_id | BIGINT UNSIGNED | NO | | 创建人 |
+| name | VARCHAR(64) | NO | | 类别名称 |
+| parent_id | BIGINT UNSIGNED | YES | NULL | 父类别ID |
+| sort_order | INT | NO | 0 | 排序 |
+| created_at | TIMESTAMP | NO | CURRENT_TIMESTAMP | 创建时间 |
+| updated_at | TIMESTAMP | NO | CURRENT_TIMESTAMP | 更新时间 |
+| deleted_at | DATETIME | YES | NULL | 软删除标记 |
+
+**索引**：
+- PRIMARY KEY: `id`
+- KEY: `idx_categories_shop` (`shop_id`)
+- KEY: `idx_categories_parent` (`parent_id`)
+- UNIQUE: `ux_categories_shop_name` (`shop_id`, `name`)
+
+**外键**：
+- `fk_categories_shop`: `shop_id` → `shops(id)`
+- `fk_categories_user`: `user_id` → `users(id)`
+- `fk_categories_parent`: `parent_id` → `product_categories(id)`
+
+**说明**：shop_id=0为全局字典，所有租户共享。
+
+---
+
+### 2.5 product_units（商品单位）
+
+| 字段 | 类型 | 空值 | 默认值 | 说明 |
+|------|------|------|--------|------|
+| id | BIGINT UNSIGNED | NO | AUTO_INCREMENT | 主键 |
+| shop_id | BIGINT UNSIGNED | NO | | 店铺ID（0=全局） |
+| user_id | BIGINT UNSIGNED | NO | | 创建人 |
+| name | VARCHAR(16) | NO | | 单位名称 |
+| created_at | TIMESTAMP | NO | CURRENT_TIMESTAMP | 创建时间 |
+| updated_at | TIMESTAMP | NO | CURRENT_TIMESTAMP | 更新时间 |
+| deleted_at | DATETIME | YES | NULL | 软删除标记 |
+
+**索引**：
+- PRIMARY KEY: `id`
+- KEY: `idx_units_shop` (`shop_id`)
+- UNIQUE: `ux_units_shop_name` (`shop_id`, `name`)
+
+**外键**：
+- `fk_units_shop`: `shop_id` → `shops(id)`
+- `fk_units_user`: `user_id` → `users(id)`
+
+**说明**：shop_id=0为全局字典，所有租户共享。
+
+---
+
+### 2.6 product_images（商品图片）
+
+| 字段 | 类型 | 空值 | 默认值 | 说明 |
+|------|------|------|--------|------|
+| id | BIGINT UNSIGNED | NO | AUTO_INCREMENT | 主键 |
+| shop_id | BIGINT UNSIGNED | NO | | 店铺ID |
+| user_id | BIGINT UNSIGNED | NO | | 上传人 |
+| product_id | BIGINT UNSIGNED | NO | | 商品ID |
+| url | VARCHAR(512) | NO | | 图片URL |
+| hash | VARCHAR(64) | YES | NULL | 内容哈希（去重） |
+| sort_order | INT | NO | 0 | 排序 |
+| created_at | TIMESTAMP | NO | CURRENT_TIMESTAMP | 创建时间 |
+
+**索引**：
+- PRIMARY KEY: `id`
+- KEY: `idx_product_images_product` (`product_id`)
+- UNIQUE: `ux_product_image_hash` (`product_id`, `hash`)
+
+**外键**：
+- `fk_pimg_shop`: `shop_id` → `shops(id)`
+- `fk_pimg_user`: `user_id` → `users(id)`
+- `fk_pimg_product`: `product_id` → `products(id)` ON DELETE CASCADE
+
+**说明**：通过hash实现图片去重。
+
+---
+
+### 2.7 product_aliases（商品别名）
+
+| 字段 | 类型 | 空值 | 默认值 | 说明 |
+|------|------|------|--------|------|
+| id | BIGINT UNSIGNED | NO | AUTO_INCREMENT | 主键 |
+| shop_id | BIGINT UNSIGNED | NO | | 店铺ID |
+| user_id | BIGINT UNSIGNED | NO | | 创建人 |
+| product_id | BIGINT UNSIGNED | NO | | 商品ID |
+| alias | VARCHAR(120) | NO | | 别名 |
+| created_at | TIMESTAMP | NO | CURRENT_TIMESTAMP | 创建时间 |
+| updated_at | TIMESTAMP | NO | CURRENT_TIMESTAMP | 更新时间 |
+| deleted_at | DATETIME | YES | NULL | 软删除标记 |
+
+**索引**：
+- PRIMARY KEY: `id`
+- KEY: `idx_product_alias_product` (`product_id`)
+- UNIQUE: `ux_product_alias` (`product_id`, `alias`)
+
+**外键**：
+- `fk_alias_shop`: `shop_id` → `shops(id)`
+- `fk_alias_user`: `user_id` → `users(id)`
+- `fk_alias_product`: `product_id` → `products(id)`
+
+**说明**：支持商品多别名检索，触发器自动同步到search_text。
+
+---
+
+## 三、配件审核与模板体系
+
+### 3.1 part_submissions（配件提交）
+
+| 字段 | 类型 | 空值 | 默认值 | 说明 |
+|------|------|------|--------|------|
+| id | BIGINT UNSIGNED | NO | AUTO_INCREMENT | 主键 |
+| shop_id | BIGINT UNSIGNED | NO | | 提交店铺 |
+| user_id | BIGINT UNSIGNED | NO | | 提交用户 |
+| name | VARCHAR(120) | YES | NULL | 配件名称 |
+| external_code | VARCHAR(64) | YES | NULL | 外部编码 |
+| model_unique | VARCHAR(128) | NO | | 规范化型号（唯一） |
+| brand | VARCHAR(64) | YES | NULL | 品牌 |
+| spec | VARCHAR(128) | YES | NULL | 规格 |
+| unit_id | BIGINT UNSIGNED | YES | NULL | 单位 |
+| category_id | BIGINT UNSIGNED | YES | NULL | 类别 |
+| template_id | BIGINT UNSIGNED | YES | NULL | 模板 |
+| tags | JSON | YES | NULL | 标签 |
+| attributes | JSON | YES | NULL | 参数JSON |
+| images | JSON | YES | NULL | 图片URL数组 |
+| size | VARCHAR(64) | YES | NULL | 尺寸（兼容） |
+| aperture | VARCHAR(64) | YES | NULL | 孔径（兼容） |
+| compatible | TEXT | YES | NULL | 适配信息 |
+| barcode | VARCHAR(64) | YES | NULL | 条码 |
+| dedupe_key | VARCHAR(512) | YES | NULL | 去重键 |
+| remark | TEXT | YES | NULL | 备注 |
+| status | ENUM('pending','approved','rejected') | NO | 'pending' | 审核状态 |
+| reviewer_id | BIGINT UNSIGNED | YES | NULL | 审核人 |
+| product_id | BIGINT UNSIGNED | YES | NULL | 关联商品ID |
+| global_sku_id | BIGINT UNSIGNED | YES | NULL | 关联全局SKU |
+| reviewed_at | DATETIME | YES | NULL | 审核时间 |
+| review_remark | VARCHAR(255) | YES | NULL | 审核备注 |
+| created_at | TIMESTAMP | NO | CURRENT_TIMESTAMP | 创建时间 |
+| updated_at | TIMESTAMP | NO | CURRENT_TIMESTAMP | 更新时间 |
+| deleted_at | DATETIME | YES | NULL | 软删除标记 |
+
+**索引**：
+- PRIMARY KEY: `id`
+- KEY: `idx_ps_shop` (`shop_id`)
+- KEY: `idx_ps_user` (`user_id`)
+- KEY: `idx_ps_brand` (`brand`)
+- KEY: `idx_ps_status` (`status`)
+- KEY: `idx_ps_template` (`template_id`)
+- KEY: `idx_ps_dedupe` (`dedupe_key`)
+- KEY: `idx_ps_created_at` (`created_at`)
+- UNIQUE: `ux_part_model_unique` (`model_unique`)
+- UNIQUE: `ux_ps_template_name_model` (`template_id`, `name`, `model_unique`)
+
+**外键**：
+- `fk_ps_shop`: `shop_id` → `shops(id)`
+- `fk_ps_user`: `user_id` → `users(id)`
+- `fk_ps_reviewer`: `reviewer_id` → `admins(id)`
+- `fk_ps_product`: `product_id` → `products(id)`
+- `fk_ps_global_sku`: `global_sku_id` → `global_skus(id)`
+- `fk_ps_template`: `template_id` → `part_templates(id)`
+
+**说明**：用户提交配件数据，审核通过后生成products记录。model_unique全局唯一。
+
+---
+
+### 3.2 part_templates（配件模板）
+
+| 字段 | 类型 | 空值 | 默认值 | 说明 |
+|------|------|------|--------|------|
+| id | BIGINT UNSIGNED | NO | AUTO_INCREMENT | 主键 |
+| category_id | BIGINT UNSIGNED | NO | | 绑定类别 |
+| name | VARCHAR(120) | NO | | 配件名 |
+| model_rule | VARCHAR(255) | YES | NULL | 型号规则说明 |
+| status | TINYINT UNSIGNED | NO | 1 | 1=启用 0=停用 |
+| created_by_admin_id | BIGINT UNSIGNED | YES | NULL | 创建管理员 |
+| created_at | TIMESTAMP | NO | CURRENT_TIMESTAMP | 创建时间 |
+| updated_at | TIMESTAMP | NO | CURRENT_TIMESTAMP | 更新时间 |
+| deleted_at | DATETIME | YES | NULL | 软删除标记 |
+
+**索引**：
+- PRIMARY KEY: `id`
+- KEY: `idx_pt_category` (`category_id`)
+- KEY: `idx_pt_status` (`status`)
+- KEY: `idx_pt_admin` (`created_by_admin_id`)
+- KEY: `idx_part_templates_deleted_at` (`deleted_at`)
+
+**外键**：
+- `fk_pt_category`: `category_id` → `product_categories(id)`
+- `fk_pt_admin`: `created_by_admin_id` → `admins(id)`
+
+**说明**：配件模板定义，关联多个参数字段。
+
+---
+
+### 3.3 part_template_params（模板参数）
+
+| 字段 | 类型 | 空值 | 默认值 | 说明 |
+|------|------|------|--------|------|
+| id | BIGINT UNSIGNED | NO | AUTO_INCREMENT | 主键 |
+| template_id | BIGINT UNSIGNED | NO | | 所属模板 |
+| field_key | VARCHAR(64) | NO | | 参数键 |
+| field_label | VARCHAR(120) | NO | | 参数名（展示） |
+| type | ENUM('string','number','boolean','enum','date') | NO | | 参数类型 |
+| required | TINYINT(1) | NO | 0 | 是否必填 |
+| unit | VARCHAR(32) | YES | NULL | 单位 |
+| enum_options | JSON | YES | NULL | 枚举选项 |
+| searchable | TINYINT(1) | NO | 0 | 参与检索 |
+| fuzzy_searchable | TINYINT(1) | NO | 0 | 可模糊查询（数值） |
+| fuzzy_tolerance | DECIMAL(18,6) | YES | NULL | 容差（NULL=平台默认） |
+| dedupe_participate | TINYINT(1) | NO | 0 | 参与去重 |
+| sort_order | INT | NO | 0 | 排序 |
+| created_at | TIMESTAMP | NO | CURRENT_TIMESTAMP | 创建时间 |
+| updated_at | TIMESTAMP | NO | CURRENT_TIMESTAMP | 更新时间 |
+
+**索引**：
+- PRIMARY KEY: `id`
+- KEY: `idx_ptp_template` (`template_id`)
+- KEY: `idx_ptp_sort` (`template_id`, `sort_order`)
+- UNIQUE: `ux_ptp_field_key` (`template_id`, `field_key`)
+
+**外键**：
+- `fk_ptp_template`: `template_id` → `part_templates(id)` ON DELETE CASCADE
+
+**说明**：定义模板的参数字段，支持类型化、验证和模糊搜索。
+
+---
+
+### 3.4 global_skus（全局SKU）
+
+| 字段 | 类型 | 空值 | 默认值 | 说明 |
+|------|------|------|--------|------|
+| id | BIGINT UNSIGNED | NO | AUTO_INCREMENT | 主键 |
+| name | VARCHAR(120) | NO | | SKU名称 |
+| brand | VARCHAR(64) | YES | NULL | 品牌 |
+| model | VARCHAR(64) | YES | NULL | 型号 |
+| spec | VARCHAR(128) | YES | NULL | 规格 |
+| barcode | VARCHAR(32) | YES | NULL | 条码 |
+| unit_id | BIGINT UNSIGNED | YES | NULL | 单位 |
+| tags | JSON | YES | NULL | 标签 |
+| status | ENUM('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_global_skus_brand_model` (`brand`, `model`)
+- UNIQUE: `ux_global_skus_barcode` (`barcode`)
+
+**外键**：
+- `fk_globalsku_unit`: `unit_id` → `product_units(id)`
+
+**说明**：全局共享的商品库，供各租户引用。
+
+---
+
+## 四、客户与供应商
+
+### 4.1 customers（客户）
+
+| 字段 | 类型 | 空值 | 默认值 | 说明 |
+|------|------|------|--------|------|
+| id | BIGINT UNSIGNED | NO | AUTO_INCREMENT | 主键 |
+| shop_id | BIGINT UNSIGNED | NO | | 店铺ID |
+| user_id | BIGINT UNSIGNED | NO | | 创建人 |
+| name | VARCHAR(120) | NO | | 客户名称 |
+| contact_name | VARCHAR(64) | YES | NULL | 联系人 |
+| mobile | VARCHAR(32) | YES | NULL | 手机 |
+| phone | VARCHAR(32) | YES | NULL | 座机 |
+| address | VARCHAR(255) | YES | NULL | 送货地址 |
+| price_level | ENUM('零售价','批发价','大单报价') | NO | '零售价' | 默认价格等级 |
+| status | TINYINT UNSIGNED | NO | 1 | 1=启用 0=停用 |
+| ar_opening | DECIMAL(18,2) | NO | 0.00 | 期初应收 |
+| remark | VARCHAR(255) | YES | NULL | 备注 |
+| created_at | TIMESTAMP | NO | CURRENT_TIMESTAMP | 创建时间 |
+| updated_at | TIMESTAMP | NO | CURRENT_TIMESTAMP | 更新时间 |
+| deleted_at | DATETIME | YES | NULL | 软删除标记 |
+
+**索引**：
+- PRIMARY KEY: `id`
+- KEY: `idx_customers_shop` (`shop_id`)
+- KEY: `idx_customers_phone` (`phone`)
+- KEY: `idx_customers_mobile` (`mobile`)
+
+**外键**：
+- `fk_customers_shop`: `shop_id` → `shops(id)`
+- `fk_customers_user`: `user_id` → `users(id)`
+
+**说明**：price_level关联product_prices的四列价格之一。
+
+---
+
+### 4.2 suppliers（供应商）
+
+| 字段 | 类型 | 空值 | 默认值 | 说明 |
+|------|------|------|--------|------|
+| id | BIGINT UNSIGNED | NO | AUTO_INCREMENT | 主键 |
+| shop_id | BIGINT UNSIGNED | NO | | 店铺ID |
+| user_id | BIGINT UNSIGNED | NO | | 创建人 |
+| name | VARCHAR(120) | NO | | 供应商名称 |
+| contact_name | VARCHAR(64) | YES | NULL | 联系人 |
+| mobile | VARCHAR(32) | YES | NULL | 手机 |
+| phone | VARCHAR(32) | YES | NULL | 电话 |
+| address | VARCHAR(255) | YES | NULL | 经营地址 |
+| status | TINYINT UNSIGNED | NO | 1 | 1=启用 0=停用 |
+| ap_opening | DECIMAL(18,2) | NO | 0.00 | 期初应付 |
+| ap_payable | DECIMAL(18,2) | NO | 0.00 | 当前应付（实时） |
+| remark | VARCHAR(255) | YES | NULL | 备注 |
+| created_at | TIMESTAMP | NO | CURRENT_TIMESTAMP | 创建时间 |
+| updated_at | TIMESTAMP | NO | CURRENT_TIMESTAMP | 更新时间 |
+| deleted_at | DATETIME | YES | NULL | 软删除标记 |
+
+**索引**：
+- PRIMARY KEY: `id`
+- KEY: `idx_suppliers_shop` (`shop_id`)
+- KEY: `idx_suppliers_phone` (`phone`)
+- KEY: `idx_suppliers_mobile` (`mobile`)
+
+**外键**：
+- `fk_suppliers_shop`: `shop_id` → `shops(id)`
+- `fk_suppliers_user`: `user_id` → `users(id)`
+
+**说明**：ap_payable由订单和付款记录联动维护。
+
+---
+
+### 4.3 accounts（结算账户）
+
+| 字段 | 类型 | 空值 | 默认值 | 说明 |
+|------|------|------|--------|------|
+| id | BIGINT UNSIGNED | NO | AUTO_INCREMENT | 主键 |
+| shop_id | BIGINT UNSIGNED | NO | | 店铺ID |
+| user_id | BIGINT UNSIGNED | NO | | 创建人 |
+| name | VARCHAR(64) | NO | | 账户名称 |
+| type | ENUM('cash','bank','alipay','wechat','other') | NO | 'cash' | 账户类型 |
+| bank_name | VARCHAR(64) | YES | NULL | 银行名称 |
+| bank_account | VARCHAR(64) | YES | NULL | 银行账号 |
+| balance | DECIMAL(18,2) | NO | 0.00 | 账户余额 |
+| status | TINYINT UNSIGNED | NO | 1 | 1=启用 0=停用 |
+| created_at | TIMESTAMP | NO | CURRENT_TIMESTAMP | 创建时间 |
+| updated_at | TIMESTAMP | NO | CURRENT_TIMESTAMP | 更新时间 |
+| deleted_at | DATETIME | YES | NULL | 软删除标记 |
+
+**索引**：
+- PRIMARY KEY: `id`
+- KEY: `idx_accounts_shop` (`shop_id`)
+- UNIQUE: `ux_accounts_shop_name` (`shop_id`, `name`)
+
+**外键**：
+- `fk_accounts_shop`: `shop_id` → `shops(id)`
+- `fk_accounts_user`: `user_id` → `users(id)`
+
+**说明**：支持现金、银行、支付宝、微信等多种结算方式。
+
+---
+
+## 五、订单与财务
+
+### 5.1 sales_orders（销售单）
+
+| 字段 | 类型 | 空值 | 默认值 | 说明 |
+|------|------|------|--------|------|
+| id | BIGINT UNSIGNED | NO | AUTO_INCREMENT | 主键 |
+| shop_id | BIGINT UNSIGNED | NO | | 店铺ID |
+| user_id | BIGINT UNSIGNED | NO | | 创建人 |
+| customer_id | BIGINT UNSIGNED | YES | NULL | 客户ID |
+| order_no | VARCHAR(32) | NO | | 订单号 |
+| order_time | DATETIME | NO | | 订单时间 |
+| status | ENUM('draft','approved','returned','void') | NO | 'draft' | 单据状态 |
+| amount | DECIMAL(18,2) | NO | 0.00 | 应收合计 |
+| paid_amount | DECIMAL(18,2) | NO | 0.00 | 已收合计 |
+| remark | VARCHAR(255) | YES | NULL | 备注 |
+| created_at | TIMESTAMP | NO | CURRENT_TIMESTAMP | 创建时间 |
+| updated_at | TIMESTAMP | NO | CURRENT_TIMESTAMP | 更新时间 |
+| deleted_at | DATETIME | YES | NULL | 软删除标记 |
+
+**索引**：
+- PRIMARY KEY: `id`
+- KEY: `idx_sales_shop_time` (`shop_id`, `order_time`)
+- KEY: `idx_sales_customer` (`customer_id`)
+- UNIQUE: `ux_sales_order_no` (`shop_id`, `order_no`)
+
+**外键**：
+- `fk_sales_shop`: `shop_id` → `shops(id)`
+- `fk_sales_user`: `user_id` → `users(id)`
+- `fk_sales_customer`: `customer_id` → `customers(id)`
+
+**说明**：approved后自动扣减库存；付款记录关联payments表。
+
+---
+
+### 5.2 sales_order_items（销售单明细）
+
+| 字段 | 类型 | 空值 | 默认值 | 说明 |
+|------|------|------|--------|------|
+| id | BIGINT UNSIGNED | NO | AUTO_INCREMENT | 主键 |
+| order_id | BIGINT UNSIGNED | NO | | 订单ID |
+| product_id | BIGINT UNSIGNED | NO | | 商品ID |
+| quantity | DECIMAL(18,3) | NO | | 数量 |
+| unit_price | DECIMAL(18,2) | NO | | 单价 |
+| discount_rate | DECIMAL(5,2) | NO | 0.00 | 折扣率(0-100) |
+| cost_price | DECIMAL(18,2) | NO | 0.00 | 成本单价 |
+| cost_amount | DECIMAL(18,2) | NO | 0.00 | 成本金额 |
+| amount | DECIMAL(18,2) | NO | | 行金额 |
+
+**索引**：
+- PRIMARY KEY: `id`
+- KEY: `idx_soi_order` (`order_id`)
+- KEY: `idx_soi_product` (`product_id`)
+
+**外键**：
+- `fk_soi_order`: `order_id` → `sales_orders(id)` ON DELETE CASCADE
+- `fk_soi_product`: `product_id` → `products(id)`
+
+**约束**：
+- quantity > 0
+- unit_price >= 0
+- discount_rate >= 0 AND <= 100
+
+**说明**：记录开单时的成本价，用于利润分析。
+
+---
+
+### 5.3 purchase_orders（进货单）
+
+| 字段 | 类型 | 空值 | 默认值 | 说明 |
+|------|------|------|--------|------|
+| id | BIGINT UNSIGNED | NO | AUTO_INCREMENT | 主键 |
+| shop_id | BIGINT UNSIGNED | NO | | 店铺ID |
+| user_id | BIGINT UNSIGNED | NO | | 创建人 |
+| supplier_id | BIGINT UNSIGNED | YES | NULL | 供应商ID |
+| order_no | VARCHAR(32) | NO | | 订单号 |
+| order_time | DATETIME | NO | | 订单时间 |
+| status | ENUM('draft','approved','void','returned') | NO | 'draft' | 单据状态 |
+| amount | DECIMAL(18,2) | NO | 0.00 | 应付合计 |
+| paid_amount | DECIMAL(18,2) | NO | 0.00 | 已付合计 |
+| remark | VARCHAR(255) | YES | NULL | 备注 |
+| created_at | TIMESTAMP | NO | CURRENT_TIMESTAMP | 创建时间 |
+| updated_at | TIMESTAMP | NO | CURRENT_TIMESTAMP | 更新时间 |
+| deleted_at | DATETIME | YES | NULL | 软删除标记 |
+
+**索引**：
+- PRIMARY KEY: `id`
+- KEY: `idx_purchase_shop_time` (`shop_id`, `order_time`)
+- KEY: `idx_purchase_supplier` (`supplier_id`)
+- UNIQUE: `ux_purchase_order_no` (`shop_id`, `order_no`)
+
+**外键**：
+- `fk_purchase_shop`: `shop_id` → `shops(id)`
+- `fk_purchase_user`: `user_id` → `users(id)`
+- `fk_purchase_supplier`: `supplier_id` → `suppliers(id)`
+
+**说明**：approved后自动增加库存。
+
+---
+
+### 5.4 purchase_order_items（进货单明细）
+
+| 字段 | 类型 | 空值 | 默认值 | 说明 |
+|------|------|------|--------|------|
+| id | BIGINT UNSIGNED | NO | AUTO_INCREMENT | 主键 |
+| order_id | BIGINT UNSIGNED | NO | | 订单ID |
+| product_id | BIGINT UNSIGNED | NO | | 商品ID |
+| quantity | DECIMAL(18,3) | NO | | 数量 |
+| unit_price | DECIMAL(18,2) | NO | | 单价 |
+| amount | DECIMAL(18,2) | NO | | 行金额 |
+
+**索引**：
+- PRIMARY KEY: `id`
+- KEY: `idx_poi_order` (`order_id`)
+- KEY: `idx_poi_product` (`product_id`)
+
+**外键**：
+- `fk_poi_order`: `order_id` → `purchase_orders(id)` ON DELETE CASCADE
+- `fk_poi_product`: `product_id` → `products(id)`
+
+**约束**：
+- quantity > 0
+- unit_price >= 0
+
+---
+
+### 5.5 payments（收付款记录）
+
+| 字段 | 类型 | 空值 | 默认值 | 说明 |
+|------|------|------|--------|------|
+| id | BIGINT UNSIGNED | NO | AUTO_INCREMENT | 主键 |
+| shop_id | BIGINT UNSIGNED | NO | | 店铺ID |
+| user_id | BIGINT UNSIGNED | NO | | 操作人 |
+| biz_type | ENUM('sale','purchase','other') | NO | | 业务类型 |
+| biz_id | BIGINT UNSIGNED | YES | NULL | 业务单据ID |
+| account_id | BIGINT UNSIGNED | NO | | 结算账户 |
+| direction | ENUM('in','out') | NO | | 收款/付款 |
+| amount | DECIMAL(18,2) | NO | | 金额 |
+| pay_time | DATETIME | NO | | 付款时间 |
+| category | VARCHAR(64) | YES | NULL | 分类key（其他收支） |
+| remark | VARCHAR(255) | YES | NULL | 备注 |
+| created_at | TIMESTAMP | NO | CURRENT_TIMESTAMP | 创建时间 |
+
+**索引**：
+- PRIMARY KEY: `id`
+- KEY: `idx_payments_shop_time` (`shop_id`, `pay_time`)
+- KEY: `idx_payments_biz` (`biz_type`, `biz_id`)
+
+**外键**：
+- `fk_payments_shop`: `shop_id` → `shops(id)`
+- `fk_payments_user`: `user_id` → `users(id)`
+- `fk_payments_account`: `account_id` → `accounts(id)`
+
+**约束**：amount > 0
+
+**说明**：统一管理销售收款、进货付款和其他收支。
+
+---
+
+### 5.6 other_transactions（其他收支）
+
+| 字段 | 类型 | 空值 | 默认值 | 说明 |
+|------|------|------|--------|------|
+| id | BIGINT UNSIGNED | NO | AUTO_INCREMENT | 主键 |
+| shop_id | BIGINT UNSIGNED | NO | | 店铺ID |
+| user_id | BIGINT UNSIGNED | NO | | 创建人 |
+| type | ENUM('income','expense') | NO | | 收入/支出 |
+| category | VARCHAR(64) | NO | | 分类key |
+| counterparty_type | VARCHAR(32) | YES | NULL | customer/supplier/other |
+| counterparty_id | BIGINT UNSIGNED | YES | NULL | 往来单位ID |
+| account_id | BIGINT UNSIGNED | NO | | 结算账户 |
+| amount | DECIMAL(18,2) | NO | | 金额 |
+| tx_time | DATETIME | NO | | 交易时间 |
+| remark | VARCHAR(255) | YES | NULL | 备注 |
+| created_at | TIMESTAMP | NO | CURRENT_TIMESTAMP | 创建时间 |
+| updated_at | TIMESTAMP | NO | CURRENT_TIMESTAMP | 更新时间 |
+| deleted_at | DATETIME | YES | NULL | 软删除标记 |
+
+**索引**：
+- PRIMARY KEY: `id`
+- KEY: `idx_ot_shop_time` (`shop_id`, `tx_time`)
+- KEY: `idx_ot_account` (`account_id`)
+
+**外键**：
+- `fk_ot_shop`: `shop_id` → `shops(id)`
+- `fk_ot_user`: `user_id` → `users(id)`
+- `fk_ot_account`: `account_id` → `accounts(id)`
+
+**约束**：amount > 0
+
+**说明**：记录非进销业务的其他收入和支出。
+
+---
+
+### 5.7 inventory_movements（库存流水）
+
+| 字段 | 类型 | 空值 | 默认值 | 说明 |
+|------|------|------|--------|------|
+| id | BIGINT UNSIGNED | NO | AUTO_INCREMENT | 主键 |
+| shop_id | BIGINT UNSIGNED | NO | | 店铺ID |
+| user_id | BIGINT UNSIGNED | NO | | 操作人 |
+| product_id | BIGINT UNSIGNED | NO | | 商品ID |
+| source_type | VARCHAR(32) | NO | | 来源：sale/purchase/return/adjust/audit |
+| source_id | BIGINT UNSIGNED | YES | NULL | 来源单据ID |
+| qty_delta | DECIMAL(18,3) | NO | | 数量增减（+/-） |
+| amount_delta | DECIMAL(18,2) | YES | NULL | 金额增减 |
+| cost_price | DECIMAL(18,2) | YES | NULL | 成本单价 |
+| cost_amount | DECIMAL(18,2) | YES | NULL | 成本金额 |
+| reason | VARCHAR(64) | YES | NULL | 原因/类别 |
+| tx_time | DATETIME | NO | | 业务时间 |
+| remark | VARCHAR(255) | YES | NULL | 备注 |
+| created_at | TIMESTAMP | NO | CURRENT_TIMESTAMP | 创建时间 |
+
+**索引**：
+- PRIMARY KEY: `id`
+- KEY: `idx_im_shop_time` (`shop_id`, `tx_time`)
+- KEY: `idx_im_product` (`product_id`)
+
+**说明**：所有库存变动的审计日志，出库为负，入库为正。
+
+---
+
+## 六、销售退货
+
+### 6.1 sales_return_orders（销售退货单）
+
+| 字段 | 类型 | 空值 | 默认值 | 说明 |
+|------|------|------|--------|------|
+| id | BIGINT UNSIGNED | NO | AUTO_INCREMENT | 主键 |
+| shop_id | BIGINT UNSIGNED | NO | | 店铺ID |
+| user_id | BIGINT UNSIGNED | NO | | 创建人 |
+| customer_id | BIGINT UNSIGNED | YES | NULL | 客户ID |
+| order_no | VARCHAR(32) | NO | | 订单号 |
+| order_time | DATETIME | NO | | 订单时间 |
+| status | ENUM('approved','void') | NO | 'approved' | 单据状态 |
+| amount | DECIMAL(18,2) | NO | 0.00 | 退货金额合计 |
+| paid_amount | DECIMAL(18,2) | NO | 0.00 | 已退/已收合计 |
+| remark | VARCHAR(255) | YES | NULL | 备注 |
+| created_at | TIMESTAMP | NO | CURRENT_TIMESTAMP | 创建时间 |
+| updated_at | TIMESTAMP | NO | CURRENT_TIMESTAMP | 更新时间 |
+| deleted_at | DATETIME | YES | NULL | 软删除标记 |
+
+**索引**：
+- PRIMARY KEY: `id`
+- KEY: `idx_sr_shop_time` (`shop_id`, `order_time`)
+- UNIQUE: `ux_sr_order_no` (`shop_id`, `order_no`)
+
+**外键**：
+- `fk_sr_shop`: `shop_id` → `shops(id)`
+- `fk_sr_user`: `user_id` → `users(id)`
+- `fk_sr_customer`: `customer_id` → `customers(id)`
+
+**说明**：approved后增加库存。
+
+---
+
+### 6.2 sales_return_order_items（销售退货明细）
+
+| 字段 | 类型 | 空值 | 默认值 | 说明 |
+|------|------|------|--------|------|
+| id | BIGINT UNSIGNED | NO | AUTO_INCREMENT | 主键 |
+| order_id | BIGINT UNSIGNED | NO | | 订单ID |
+| product_id | BIGINT UNSIGNED | NO | | 商品ID |
+| quantity | DECIMAL(18,3) | NO | | 数量 |
+| unit_price | DECIMAL(18,2) | NO | | 单价 |
+| discount_rate | DECIMAL(5,2) | NO | 0.00 | 折扣率 |
+| cost_price | DECIMAL(18,2) | NO | 0.00 | 成本单价 |
+| cost_amount | DECIMAL(18,2) | NO | 0.00 | 成本金额 |
+| amount | DECIMAL(18,2) | NO | | 行金额 |
+
+**索引**：
+- PRIMARY KEY: `id`
+- KEY: `idx_sroi_order` (`order_id`)
+- KEY: `idx_sroi_product` (`product_id`)
+
+**外键**：
+- `fk_sroi_order`: `order_id` → `sales_return_orders(id)` ON DELETE CASCADE
+- `fk_sroi_product`: `product_id` → `products(id)`
+
+---
+
+### 6.3 purchase_return_orders（进货退货单）
+
+| 字段 | 类型 | 空值 | 默认值 | 说明 |
+|------|------|------|--------|------|
+| id | BIGINT UNSIGNED | NO | AUTO_INCREMENT | 主键 |
+| shop_id | BIGINT UNSIGNED | NO | | 店铺ID |
+| user_id | BIGINT UNSIGNED | NO | | 创建人 |
+| supplier_id | BIGINT UNSIGNED | YES | NULL | 供应商ID |
+| order_no | VARCHAR(32) | NO | | 订单号 |
+| order_time | DATETIME | NO | | 订单时间 |
+| status | ENUM('approved','void') | NO | 'approved' | 单据状态 |
+| amount | DECIMAL(18,2) | NO | 0.00 | 退货金额合计 |
+| paid_amount | DECIMAL(18,2) | NO | 0.00 | 已付合计 |
+| remark | VARCHAR(255) | YES | NULL | 备注 |
+| created_at | TIMESTAMP | NO | CURRENT_TIMESTAMP | 创建时间 |
+| updated_at | TIMESTAMP | NO | CURRENT_TIMESTAMP | 更新时间 |
+| deleted_at | DATETIME | YES | NULL | 软删除标记 |
+
+**索引**：
+- PRIMARY KEY: `id`
+- KEY: `idx_pr_shop_time` (`shop_id`, `order_time`)
+- UNIQUE: `ux_pr_order_no` (`shop_id`, `order_no`)
+
+**外键**：
+- `fk_pr_shop`: `shop_id` → `shops(id)`
+- `fk_pr_user`: `user_id` → `users(id)`
+- `fk_pr_supplier`: `supplier_id` → `suppliers(id)`
+
+**说明**：approved后减少库存。
+
+---
+
+### 6.4 purchase_return_order_items（进货退货明细）
+
+| 字段 | 类型 | 空值 | 默认值 | 说明 |
+|------|------|------|--------|------|
+| id | BIGINT UNSIGNED | NO | AUTO_INCREMENT | 主键 |
+| order_id | BIGINT UNSIGNED | NO | | 订单ID |
+| product_id | BIGINT UNSIGNED | NO | | 商品ID |
+| quantity | DECIMAL(18,3) | NO | | 数量 |
+| unit_price | DECIMAL(18,2) | NO | | 单价 |
+| amount | DECIMAL(18,2) | NO | | 行金额 |
+
+**索引**：
+- PRIMARY KEY: `id`
+- KEY: `idx_proi_order` (`order_id`)
+- KEY: `idx_proi_product` (`product_id`)
+
+**外键**：
+- `fk_proi_order`: `order_id` → `purchase_return_orders(id)` ON DELETE CASCADE
+- `fk_proi_product`: `product_id` → `products(id)`
+
+---
+
+## 七、触发器
+
+### 7.1 products.search_text 维护触发器
+
+**trg_products_ai** (AFTER INSERT)
+```sql
+UPDATE products
+SET search_text = CONCAT_WS(' ', NEW.name, NEW.brand, NEW.model, NEW.spec)
+WHERE id = NEW.id;
+```
+
+**trg_products_au** (BEFORE UPDATE)
+```sql
+SET NEW.search_text = CONCAT_WS(' ', NEW.name, NEW.brand, NEW.model, NEW.spec);
+```
+
+### 7.2 product_aliases 同步触发器
+
+**trg_palias_ai** (AFTER INSERT)
+```sql
+-- 聚合所有别名到products.search_text
+UPDATE products p
+JOIN (
+  SELECT pa.product_id, GROUP_CONCAT(pa.alias SEPARATOR ' ') AS aliases
+  FROM product_aliases pa
+  WHERE pa.product_id = NEW.product_id AND pa.deleted_at IS NULL
+  GROUP BY pa.product_id
+) a ON a.product_id = p.id
+SET p.search_text = CONCAT_WS(' ', p.name, p.brand, p.model, p.spec, a.aliases)
+WHERE p.id = NEW.product_id;
+```
+
+**trg_palias_au** (AFTER UPDATE)、**trg_palias_ad** (AFTER DELETE) - 类似逻辑
+
+### 7.3 consults 回复状态触发器
+
+**trg_consult_replies_ai** (AFTER INSERT)
+```sql
+UPDATE consults
+SET status = 'resolved', updated_at = NOW()
+WHERE id = NEW.consult_id;
+```
+
+---
+
+## 八、数据完整性约束
+
+### 8.1 CHECK约束
+
+- `products`: `safe_min <= safe_max`
+- `product_prices`: 所有价格 >= 0
+- `inventories`: `quantity >= 0`
+- `sales_order_items`: `quantity > 0, unit_price >= 0, discount_rate BETWEEN 0 AND 100`
+- `purchase_order_items`: `quantity > 0, unit_price >= 0`
+- `payments`: `amount > 0`
+- `other_transactions`: `amount > 0`
+
+### 8.2 唯一性约束
+
+- `shops`: 无业务层面唯一约束
+- `users`: `phone` 全局唯一、`email` 全局唯一
+- `products`: `(shop_id, barcode)` 唯一、`(template_id, name, model)` 唯一
+- `part_submissions`: `model_unique` 全局唯一、`(template_id, name, model_unique)` 唯一
+- `customers/suppliers`: 无强制唯一约束（允许同名）
+- `accounts`: `(shop_id, name)` 唯一
+- `sales_orders/purchase_orders`: `(shop_id, order_no)` 唯一
+
+---
+
+## 九、设计说明
+
+### 9.1 多租户隔离
+
+- 所有业务表必须包含 `shop_id`
+- 全局字典表（单位、类别）使用 `shop_id=0` 表示平台共享
+- 查询必须强制按 `shop_id` 过滤
+- VIP数据可见性：非VIP用户仅显示最近60天（可配置）数据
+
+### 9.2 软删除策略
+
+- 主要业务表使用 `deleted_at` 字段标记软删除
+- 查询默认过滤 `deleted_at IS NULL`
+- 部分关联表（如订单明细）采用级联删除
+
+### 9.3 审计与追踪
+
+- 所有表包含 `created_at`, `updated_at` 时间戳
+- 审核表（part_submissions、vip_users）记录审核人和审核时间
+- 库存变动通过 `inventory_movements` 完整留痕
+- 普通管理员申请通过 `normal_admin_audits` 留痕
+
+### 9.4 性能优化
+
+- 高频查询字段建立复合索引（如 `shop_id + order_time`）
+- `products.search_text` 使用FULLTEXT索引支持全文检索
+- 价格和库存表采用主键为业务主键（product_id）的设计
+- 合理使用外键约束，但不过度使用以避免性能损失
+
+### 9.5 扩展性设计
+
+- 商品属性通过 `attributes_json` 支持动态扩展
+- 配件模板系统支持类型化参数定义
+- 财务分类通过配置表 `finance_categories` 动态管理
+- 预留 `global_sku_id` 支持平台级商品库
+
+---
+
+**文档维护说明**：
+- 任何数据库结构变更必须同步更新本文档
+- 执行DDL操作后需标注更新时间
+- 新增表需补充完整的字段说明和索引信息
+- 变更需同步更新 `backend/db/db.sql` 脚本
+