2
This commit is contained in:
@@ -1,8 +1,12 @@
|
||||
## partsinquiry 数据库文档
|
||||
|
||||
更新日期：2025-09-23（已插入演示数据；新增演示店B/演示店C与其默认账户、两名用户）
|
||||
更新日期：2025-09-27（对齐远程线上库结构；提醒：`backend/db/db.sql` 尚未覆盖 VIP 相关表，请勿直接依赖本地脚本）
|
||||
|
||||
说明：本文件根据远程库 mysql.tonaspace.com 中 `partsinquiry` 的实际结构生成，字段/索引/外键信息以线上为准。
|
||||
说明：本文件根据远程库 mysql.tonaspace.com 中 `partsinquiry` 的实际结构生成，字段/索引/外键信息以线上为准。如需执行结构变更，请通过 MysqlMCP，并在成功后更新此文档和 `backend/db/db.sql`。差异概览：
|
||||
- ✅ 线上已存在 `vip_users`、`vip_price`、`vip_recharges`、`attachments` 表；`backend/db/db.sql` 仍缺少对应建表语句。
|
||||
- ✅ 线上 `admins` 表存储平台管理员，管理端接口通过 `AdminAuthInterceptor` 校验。
|
||||
- ❌ `global_skus` 及配件审核体系仅部分表有数据，审批流程仍在试运行阶段。
|
||||
- ✅ 新增“模板化配件参数”相关结构：`part_templates`、`part_template_params`；为 `products` 与 `part_submissions` 增加 `template_id` 与 `dedupe_key`，并建立唯一与辅助索引。
|
||||
|
||||
### shops
|
||||
| Column Name | Data Type | Nullable | Default | Comment |
|
||||
@@ -27,23 +31,39 @@
|
||||
| id | BIGINT UNSIGNED | NOT NULL | AUTO_INCREMENT | 用户ID |
|
||||
| shop_id | BIGINT UNSIGNED | NOT NULL | | 所属店铺 |
|
||||
| phone | VARCHAR(32) | YES | | 手机号 |
|
||||
| email | VARCHAR(128) | YES | | 邮箱 |
|
||||
| name | VARCHAR(64) | NOT NULL | | 姓名 |
|
||||
| role | VARCHAR(32) | NOT NULL | staff | 角色：owner/staff/finance/... |
|
||||
| password_hash | VARCHAR(255) | YES | | 密码哈希（若采用短信登录可为空） |
|
||||
| status | TINYINT UNSIGNED | NOT NULL | 1 | 状态：1启用 0停用 |
|
||||
| is_owner | TINYINT(1) | NOT NULL | 0 | 是否店主 |
|
||||
| is_platform_admin | TINYINT(1) | NOT NULL | 0 | 是否平台管理员 |
|
||||
（字段已调整：移除 `is_platform_admin`，平台管理员改为独立表 `admins`）
|
||||
| created_at | TIMESTAMP | NOT NULL | CURRENT_TIMESTAMP | |
|
||||
| updated_at | TIMESTAMP | NOT NULL | CURRENT_TIMESTAMP | |
|
||||
| deleted_at | DATETIME | YES | | |
|
||||
|
||||
**Indexes**: - PRIMARY KEY: `id` - KEY: `idx_users_shop` (`shop_id`) - UNIQUE: `uk_users_phone` (`phone`) - UNIQUE: `ux_users_shop_phone` (`shop_id`,`phone`)
|
||||
**Indexes**: - PRIMARY KEY: `id` - KEY: `idx_users_shop` (`shop_id`) - UNIQUE: `uk_users_phone` (`phone`) - UNIQUE: `ux_users_shop_phone` (`shop_id`,`phone`) - UNIQUE: `ux_users_email` (`email`)
|
||||
|
||||
字段说明：
|
||||
- shop_id: 归属店铺
|
||||
- role: 角色标识字符串
|
||||
- is_owner: 是否店主标记
|
||||
- is_platform_admin: 是否平台管理员（平台级权限）
|
||||
- 平台管理员：请参见 `admins` 表
|
||||
### admins
|
||||
| Column Name | Data Type | Nullable | Default | Comment |
|
||||
| ----------- | --------- | -------- | ------- | ------- |
|
||||
| id | BIGINT UNSIGNED | NOT NULL | AUTO_INCREMENT | 管理员ID |
|
||||
| username | VARCHAR(64) | NOT NULL | | 登录名/展示名 |
|
||||
| phone | VARCHAR(32) | YES | | 手机号 |
|
||||
| password_hash | VARCHAR(255) | YES | | 密码哈希 |
|
||||
| status | TINYINT UNSIGNED | NOT NULL | 1 | 状态：1启用 0停用 |
|
||||
| created_at | TIMESTAMP | NOT NULL | CURRENT_TIMESTAMP | |
|
||||
| updated_at | TIMESTAMP | NOT NULL | CURRENT_TIMESTAMP | |
|
||||
| deleted_at | DATETIME | YES | | |
|
||||
|
||||
说明：平台管理员不隶属店铺，不具备店铺资源（店铺/配件）归属，仅用于管理端功能。
|
||||
|
||||
**Indexes**: - PRIMARY KEY: `id` - UNIQUE: `ux_admins_username` (`username`) - UNIQUE: `ux_admins_phone` (`phone`)
|
||||
- 其余同名含义
|
||||
|
||||
### user_identities
|
||||
@@ -109,6 +129,38 @@
|
||||
|
||||
说明：该表为全局配置表，仅包含一条记录用于表示当前 VIP 单月价格。
|
||||
|
||||
### vip_recharges
|
||||
| Column Name | Data Type | Nullable | Default | Comment |
|
||||
| ----------- | --------- | -------- | ------- | ------- |
|
||||
| id | BIGINT UNSIGNED | NOT NULL | AUTO_INCREMENT | 充值记录ID |
|
||||
| shop_id | BIGINT UNSIGNED | NOT NULL | | 店铺ID |
|
||||
| user_id | BIGINT UNSIGNED | NOT NULL | | 用户ID |
|
||||
| price | DECIMAL(10,2) | NOT NULL | | 本次充值价格（元） |
|
||||
| duration_days | INT | NOT NULL | | 本次续期天数 |
|
||||
| expire_from | DATETIME | YES | | 生效前到期时间（可空） |
|
||||
| expire_to | DATETIME | NOT NULL | | 生效后到期时间 |
|
||||
| channel | VARCHAR(32) | NOT NULL | oneclick | 渠道（oneclick/…） |
|
||||
| created_at | TIMESTAMP | NOT NULL | CURRENT_TIMESTAMP | 创建时间 |
|
||||
|
||||
**Indexes**: - PRIMARY KEY: `id` - KEY: `idx_vr_shop` (`shop_id`) - KEY: `idx_vr_user` (`user_id`)
|
||||
**Foreign Keys**: - `fk_vr_shop`: `shop_id` → `shops(id)` - `fk_vr_user`: `user_id` → `users(id)`
|
||||
### normal_admin_audits（普通管理员申请/审批审计日志）
|
||||
| Column Name | Data Type | Nullable | Default | Comment |
|
||||
| ----------- | --------- | -------- | ------- | ------- |
|
||||
| id | BIGINT UNSIGNED | NOT NULL | AUTO_INCREMENT | |
|
||||
| shop_id | BIGINT UNSIGNED | NOT NULL | | 店铺 |
|
||||
| user_id | BIGINT UNSIGNED | NOT NULL | | 用户 |
|
||||
| action | ENUM('apply','approve','reject','revoke','expire') | NOT NULL | | 操作类型 |
|
||||
| remark | VARCHAR(255) | YES | | 备注 |
|
||||
| operator_admin_id | BIGINT UNSIGNED | YES | | 平台管理员ID（apply时可空） |
|
||||
| previous_role | VARCHAR(32) | YES | | 变更前角色 |
|
||||
| new_role | VARCHAR(32) | YES | | 变更后角色 |
|
||||
| created_at | TIMESTAMP | NOT NULL | CURRENT_TIMESTAMP | 创建时间 |
|
||||
|
||||
**Indexes**: - PRIMARY KEY: `id` - KEY: `idx_naudit_shop_time` (`shop_id`,`created_at`) - KEY: `idx_naudit_user_time` (`user_id`,`created_at`)
|
||||
**Foreign Keys**: - `fk_naudit_shop`: `shop_id` → `shops(id)` - `fk_naudit_user`: `user_id` → `users(id)` - `fk_naudit_admin`: `operator_admin_id` → `admins(id)`
|
||||
|
||||
|
||||
### wechat_sessions
|
||||
| Column Name | Data Type | Nullable | Default | Comment |
|
||||
| ----------- | --------- | -------- | ------- | ------- |
|
||||
@@ -216,11 +268,13 @@
|
||||
| name | VARCHAR(120) | NOT NULL | | 供全文检索 |
|
||||
| category_id | BIGINT UNSIGNED | YES | | |
|
||||
| unit_id | BIGINT UNSIGNED | NOT NULL | | |
|
||||
| template_id | BIGINT UNSIGNED | YES | | 关联的模板 |
|
||||
| brand | VARCHAR(64) | YES | | |
|
||||
| model | VARCHAR(64) | YES | | |
|
||||
| spec | VARCHAR(128) | YES | | |
|
||||
| origin | VARCHAR(64) | YES | | |
|
||||
| barcode | VARCHAR(32) | YES | | |
|
||||
| dedupe_key | VARCHAR(512) | YES | | 去重键（规范化后计算） |
|
||||
| alias | VARCHAR(120) | YES | | |
|
||||
| is_blacklisted | TINYINT(1) | NOT NULL | 0 | 黑名单标记（管理端可控） |
|
||||
| description | TEXT | YES | | |
|
||||
@@ -237,8 +291,43 @@
|
||||
- safe_min/safe_max: 安全库存上下限
|
||||
- search_text: 聚合检索字段（触发器维护）
|
||||
|
||||
**Indexes**: - PRIMARY KEY: `id` - KEY: `idx_products_shop` (`shop_id`) - KEY: `idx_products_category` (`category_id`) - KEY: `idx_products_unit` (`unit_id`) - 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`)
|
||||
**Foreign Keys**: - `fk_products_shop`: `shop_id` → `shops(id)` - `fk_products_user`: `user_id` → `users(id)` - `fk_products_category`: `category_id` → `product_categories(id)` - `fk_products_unit`: `unit_id` → `product_units(id)` - `fk_products_globalsku`: `global_sku_id` → `global_skus(id)`
|
||||
**Indexes**: - PRIMARY KEY: `id` - KEY: `idx_products_shop` (`shop_id`) - KEY: `idx_products_category` (`category_id`) - KEY: `idx_products_unit` (`unit_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`)
|
||||
**Foreign Keys**: - `fk_products_shop`: `shop_id` → `shops(id)` - `fk_products_user`: `user_id` → `users(id)` - `fk_products_category`: `category_id` → `product_categories(id)` - `fk_products_unit`: `unit_id` → `product_units(id)` - `fk_products_template`: `template_id` → `part_templates(id)` - `fk_products_globalsku`: `global_skus(id)`
|
||||
|
||||
### part_submissions（配件提交与审核）
|
||||
| Column Name | Data Type | Nullable | Default | Comment |
|
||||
| ----------- | --------- | -------- | ------- | ------- |
|
||||
| id | BIGINT UNSIGNED | NOT NULL | AUTO_INCREMENT | 提交ID |
|
||||
| shop_id | BIGINT UNSIGNED | NOT NULL | | 店铺 |
|
||||
| user_id | BIGINT UNSIGNED | NOT NULL | | 提交用户 |
|
||||
| name | VARCHAR(255) | YES | | 配件名称 |
|
||||
| external_code | VARCHAR(255) | YES | | 外部编码 |
|
||||
| model_unique | VARCHAR(255) | NOT NULL | | 规范化型号（唯一校验） |
|
||||
| brand | VARCHAR(64) | YES | | 品牌 |
|
||||
| spec | VARCHAR(128) | YES | | 规格 |
|
||||
| unit_id | BIGINT UNSIGNED | YES | | 单位 |
|
||||
| category_id | BIGINT UNSIGNED | YES | | 分类 |
|
||||
| template_id | BIGINT UNSIGNED | YES | | 模板 |
|
||||
| attributes | JSON | YES | | 参数JSON |
|
||||
| images | JSON | YES | | 图片URL数组JSON |
|
||||
| size | VARCHAR(64) | YES | | 兼容历史字段 |
|
||||
| aperture | VARCHAR(64) | YES | | 兼容历史字段 |
|
||||
| compatible | VARCHAR(255) | YES | | 兼容机型文本 |
|
||||
| barcode | VARCHAR(32) | YES | | 条码 |
|
||||
| dedupe_key | VARCHAR(512) | YES | | 去重键 |
|
||||
| remark | TEXT | YES | | 备注 |
|
||||
| status | ENUM('pending','approved','rejected') | NOT NULL | | 审核状态 |
|
||||
| reviewer_id | BIGINT UNSIGNED | YES | | 审核人 |
|
||||
| product_id | BIGINT UNSIGNED | YES | | 关联生成的商品ID |
|
||||
| global_sku_id | BIGINT UNSIGNED | YES | | 关联全局SKU |
|
||||
| reviewed_at | DATETIME | YES | | 审核时间 |
|
||||
| review_remark | VARCHAR(255) | YES | | 审核备注 |
|
||||
| created_at | TIMESTAMP | NOT NULL | CURRENT_TIMESTAMP | |
|
||||
| updated_at | TIMESTAMP | NOT NULL | CURRENT_TIMESTAMP | |
|
||||
| deleted_at | DATETIME | YES | | |
|
||||
|
||||
**Indexes**: - PRIMARY KEY: `id` - KEY: `idx_ps_template` (`template_id`) - KEY: `idx_ps_dedupe` (`dedupe_key`) - UNIQUE: `ux_ps_template_name_model` (`template_id`,`name`,`model_unique`)
|
||||
**Foreign Keys**: - `fk_ps_template`: `template_id` → `part_templates(id)`
|
||||
|
||||
### product_aliases
|
||||
| Column Name | Data Type | Nullable | Default | Comment |
|
||||
@@ -277,6 +366,41 @@
|
||||
**Indexes**: - PRIMARY KEY: `id` - KEY: `idx_product_images_product` (`product_id`) - UNIQUE: `ux_product_image_hash` (`product_id`,`hash`)
|
||||
**Foreign Keys**: - `fk_pimg_shop`: `shop_id` → `shops(id)` - `fk_pimg_user`: `user_id` → `users(id)` - `fk_pimg_product`: `product_id` → `products(id)` ON DELETE CASCADE
|
||||
|
||||
### part_templates（配件模板）
|
||||
| Column Name | Data Type | Nullable | Default | Comment |
|
||||
| ----------- | --------- | -------- | ------- | ------- |
|
||||
| id | BIGINT UNSIGNED | NOT NULL | AUTO_INCREMENT | 模板ID |
|
||||
| category_id | BIGINT UNSIGNED | NOT NULL | | 绑定分类 |
|
||||
| name | VARCHAR(120) | NOT NULL | | 配件名 |
|
||||
| model_rule | VARCHAR(255) | YES | | 型号规则（说明/正则，可空） |
|
||||
| status | TINYINT UNSIGNED | NOT NULL | 1 | 1启用 0停用 |
|
||||
| created_by_admin_id | BIGINT UNSIGNED | YES | | 创建管理员 |
|
||||
| created_at | TIMESTAMP | NOT NULL | CURRENT_TIMESTAMP | |
|
||||
| updated_at | TIMESTAMP | NOT NULL | CURRENT_TIMESTAMP | |
|
||||
|
||||
**Indexes**: - PRIMARY KEY: `id` - KEY: `idx_pt_category` (`category_id`) - KEY: `idx_pt_status` (`status`) - KEY: `idx_pt_admin` (`created_by_admin_id`)
|
||||
**Foreign Keys**: - `fk_pt_category`: `category_id` → `product_categories(id)` - `fk_pt_admin`: `created_by_admin_id` → `admins(id)`
|
||||
|
||||
### part_template_params（模板参数字段）
|
||||
| Column Name | Data Type | Nullable | Default | Comment |
|
||||
| ----------- | --------- | -------- | ------- | ------- |
|
||||
| id | BIGINT UNSIGNED | NOT NULL | AUTO_INCREMENT | |
|
||||
| template_id | BIGINT UNSIGNED | NOT NULL | | 所属模板 |
|
||||
| field_key | VARCHAR(64) | NOT NULL | | 参数键（字母/下划线） |
|
||||
| field_label | VARCHAR(120) | NOT NULL | | 参数名（展示） |
|
||||
| type | ENUM('string','number','boolean','enum','date') | NOT NULL | | 参数类型 |
|
||||
| required | TINYINT(1) | NOT NULL | 0 | 是否必填 |
|
||||
| unit | VARCHAR(32) | YES | | 单位（文本） |
|
||||
| enum_options | JSON | YES | | 枚举项（type=enum） |
|
||||
| searchable | TINYINT(1) | NOT NULL | 0 | 参与检索 |
|
||||
| dedupe_participate | TINYINT(1) | NOT NULL | 0 | 参与去重键 |
|
||||
| sort_order | INT | NOT NULL | 0 | |
|
||||
| created_at | TIMESTAMP | NOT NULL | CURRENT_TIMESTAMP | |
|
||||
| updated_at | TIMESTAMP | NOT NULL | CURRENT_TIMESTAMP | |
|
||||
|
||||
**Indexes**: - 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`)
|
||||
**Foreign Keys**: - `fk_ptp_template`: `template_id` → `part_templates(id)` ON DELETE CASCADE
|
||||
|
||||
### product_prices
|
||||
| Column Name | Data Type | Nullable | Default | Comment |
|
||||
| ----------- | --------- | -------- | ------- | ------- |
|
||||
@@ -321,7 +445,6 @@
|
||||
| phone | VARCHAR(32) | YES | | 座机 |
|
||||
| address | VARCHAR(255) | YES | | 送货地址 |
|
||||
| mobile | VARCHAR(32) | YES | | 手机 |
|
||||
| level | VARCHAR(32) | YES | | 客户等级标签 |
|
||||
| contact_name | VARCHAR(64) | YES | | 联系人 |
|
||||
| price_level | ENUM('零售价','批发价','大单报价') | NOT NULL | 零售价 | 默认售价列（中文存储） |
|
||||
| status | TINYINT UNSIGNED | NOT NULL | 1 | |
|
||||
@@ -332,7 +455,6 @@
|
||||
| deleted_at | DATETIME | YES | | |
|
||||
|
||||
字段说明（customers）：
|
||||
- level: 等级标签
|
||||
- price_level: 默认售价列（中文存储：零售价/批发价/大单报价）
|
||||
- ar_opening: 期初应收
|
||||
|
||||
@@ -420,10 +542,13 @@
|
||||
| quantity | DECIMAL(18,3) | NOT NULL | | |
|
||||
| unit_price | DECIMAL(18,2) | NOT NULL | | |
|
||||
| discount_rate | DECIMAL(5,2) | NOT NULL | 0.00 | 折扣百分比0-100 |
|
||||
| cost_price | DECIMAL(18,2) | NOT NULL | 0.00 | 记录生成单据时的成本单价 |
|
||||
| cost_amount | DECIMAL(18,2) | NOT NULL | 0.00 | 成本金额 = 数量×成本单价 |
|
||||
| amount | DECIMAL(18,2) | NOT NULL | | |
|
||||
|
||||
字段说明（sales_order_items）：
|
||||
- quantity/unit_price/discount_rate/amount: 数量/单价/折扣%/行金额
|
||||
- cost_price/cost_amount: 记录生成单据时的成本（用于利润分析）
|
||||
|
||||
**Indexes**: - PRIMARY KEY: `id` - KEY: `idx_soi_order` (`order_id`) - KEY: `idx_soi_product` (`product_id`)
|
||||
**Foreign Keys**: - `fk_soi_order`: `order_id` → `sales_orders(id)` ON DELETE CASCADE - `fk_soi_product`: `product_id` → `products(id)`
|
||||
@@ -463,7 +588,7 @@
|
||||
|
||||
**Indexes**: - PRIMARY KEY: `id` - KEY: `idx_poi_order` (`order_id`) - KEY: `idx_poi_product` (`product_id`)
|
||||
**Foreign Keys**: - `fk_poi_order`: `order_id` → `purchase_orders(id)` ON DELETE CASCADE - `fk_poi_product`: `product_id` → `products(id)`
|
||||
image.png
|
||||
|
||||
### payments
|
||||
| Column Name | Data Type | Nullable | Default | Comment |
|
||||
| ----------- | --------- | -------- | ------- | ------- |
|
||||
@@ -477,16 +602,107 @@ image.png
|
||||
| amount | DECIMAL(18,2) | NOT NULL | | |
|
||||
| pay_time | DATETIME | NOT NULL | | |
|
||||
| remark | VARCHAR(255) | YES | | |
|
||||
| category | VARCHAR(64) | YES | | 分类 key（主要用于其他收支） |
|
||||
| created_at | TIMESTAMP | NOT NULL | CURRENT_TIMESTAMP | |
|
||||
|
||||
字段说明（payments）：
|
||||
- biz_type/biz_id: 业务来源及关联主键
|
||||
- direction: in 收款 / out 付款
|
||||
- account_id: 使用的结算账户
|
||||
- category: 分类 key（主要用于其他收支；用于台账明细展示与统计）
|
||||
|
||||
**Indexes**: - PRIMARY KEY: `id` - KEY: `idx_payments_shop_time` (`shop_id`,`pay_time`) - KEY: `idx_payments_biz` (`biz_type`,`biz_id`)
|
||||
**Foreign Keys**: - `fk_payments_shop`: `shop_id` → `shops(id)` - `fk_payments_user`: `user_id` → `users(id)` - `fk_payments_account`: `account_id` → `accounts(id)`
|
||||
|
||||
### inventory_movements
|
||||
| Column Name | Data Type | Nullable | Default | Comment |
|
||||
| ----------- | --------- | -------- | ------- | ------- |
|
||||
| id | BIGINT UNSIGNED | NOT NULL | AUTO_INCREMENT | |
|
||||
| shop_id | BIGINT UNSIGNED | NOT NULL | | |
|
||||
| user_id | BIGINT UNSIGNED | NOT NULL | | |
|
||||
| product_id | BIGINT UNSIGNED | NOT NULL | | |
|
||||
| source_type | VARCHAR(32) | NOT NULL | | 来源：sale/purchase/sale_return/purchase_return/adjust/audit |
|
||||
| source_id | BIGINT UNSIGNED | YES | | 来源表ID（可空） |
|
||||
| qty_delta | DECIMAL(18,3) | NOT NULL | | 数量增减，出库为负，入库为正 |
|
||||
| amount_delta | DECIMAL(18,2) | YES | | 金额增减（可空） |
|
||||
| cost_price | DECIMAL(18,2) | YES | | 业务发生时的成本单价（可空） |
|
||||
| cost_amount | DECIMAL(18,2) | YES | | 成本金额（可空） |
|
||||
| reason | VARCHAR(64) | YES | | 原因/类别 |
|
||||
| tx_time | DATETIME | NOT NULL | | 业务时间 |
|
||||
| remark | VARCHAR(255) | YES | | |
|
||||
| created_at | TIMESTAMP | NOT NULL | CURRENT_TIMESTAMP | |
|
||||
|
||||
**Indexes**: - PRIMARY KEY: `id` - KEY: `idx_im_shop_time` (`shop_id`,`tx_time`) - KEY: `idx_im_product` (`product_id`)
|
||||
|
||||
### sales_return_orders
|
||||
| Column Name | Data Type | Nullable | Default | Comment |
|
||||
| ----------- | --------- | -------- | ------- | ------- |
|
||||
| id | BIGINT UNSIGNED | NOT NULL | AUTO_INCREMENT | |
|
||||
| shop_id | BIGINT UNSIGNED | NOT NULL | | |
|
||||
| user_id | BIGINT UNSIGNED | NOT NULL | | |
|
||||
| customer_id | BIGINT UNSIGNED | YES | | |
|
||||
| order_no | VARCHAR(32) | NOT NULL | | |
|
||||
| order_time | DATETIME | NOT NULL | | |
|
||||
| status | ENUM('approved','void') | NOT NULL | approved | |
|
||||
| amount | DECIMAL(18,2) | NOT NULL | 0.00 | 退货金额合计 |
|
||||
| paid_amount | DECIMAL(18,2) | NOT NULL | 0.00 | 已退/已收合计 |
|
||||
| remark | VARCHAR(255) | YES | | |
|
||||
| created_at | TIMESTAMP | NOT NULL | CURRENT_TIMESTAMP | |
|
||||
| updated_at | TIMESTAMP | NOT NULL | CURRENT_TIMESTAMP | |
|
||||
| deleted_at | DATETIME | YES | | |
|
||||
|
||||
**Indexes**: - PRIMARY KEY: `id` - UNIQUE: `ux_sr_order_no` (`shop_id`,`order_no`) - KEY: `idx_sr_shop_time` (`shop_id`,`order_time`)
|
||||
**Foreign Keys**: - `fk_sr_customer`: `customer_id` → `customers(id)` - `fk_sr_user`: `user_id` → `users(id)`
|
||||
|
||||
### sales_return_order_items
|
||||
| Column Name | Data Type | Nullable | Default | Comment |
|
||||
| ----------- | --------- | -------- | ------- | ------- |
|
||||
| id | BIGINT UNSIGNED | NOT NULL | AUTO_INCREMENT | |
|
||||
| order_id | BIGINT UNSIGNED | NOT NULL | | |
|
||||
| product_id | BIGINT UNSIGNED | NOT NULL | | |
|
||||
| quantity | DECIMAL(18,3) | NOT NULL | | |
|
||||
| unit_price | DECIMAL(18,2) | NOT NULL | | |
|
||||
| discount_rate | DECIMAL(5,2) | NOT NULL | 0.00 | 折扣百分比0-100 |
|
||||
| cost_price | DECIMAL(18,2) | NOT NULL | 0.00 | 退货时对应的成本单价 |
|
||||
| cost_amount | DECIMAL(18,2) | NOT NULL | 0.00 | 成本金额 = 数量×成本单价 |
|
||||
| amount | DECIMAL(18,2) | NOT NULL | | 行金额 |
|
||||
|
||||
**Indexes**: - PRIMARY KEY: `id` - KEY: `idx_sroi_order` (`order_id`) - KEY: `idx_sroi_product` (`product_id`)
|
||||
**Foreign Keys**: - `fk_sroi_order`: `order_id` → `sales_return_orders(id)` - `fk_sroi_product`: `product_id` → `products(id)`
|
||||
|
||||
### purchase_return_orders
|
||||
| Column Name | Data Type | Nullable | Default | Comment |
|
||||
| ----------- | --------- | -------- | ------- | ------- |
|
||||
| id | BIGINT UNSIGNED | NOT NULL | AUTO_INCREMENT | |
|
||||
| shop_id | BIGINT UNSIGNED | NOT NULL | | |
|
||||
| user_id | BIGINT UNSIGNED | NOT NULL | | |
|
||||
| supplier_id | BIGINT UNSIGNED | YES | | |
|
||||
| order_no | VARCHAR(32) | NOT NULL | | |
|
||||
| order_time | DATETIME | NOT NULL | | |
|
||||
| status | ENUM('approved','void') | NOT NULL | approved | |
|
||||
| amount | DECIMAL(18,2) | NOT NULL | 0.00 | 退货金额合计 |
|
||||
| paid_amount | DECIMAL(18,2) | NOT NULL | 0.00 | 已付合计（退款/扣减） |
|
||||
| remark | VARCHAR(255) | YES | | |
|
||||
| created_at | TIMESTAMP | NOT NULL | CURRENT_TIMESTAMP | |
|
||||
| updated_at | TIMESTAMP | NOT NULL | CURRENT_TIMESTAMP | |
|
||||
| deleted_at | DATETIME | YES | | |
|
||||
|
||||
**Indexes**: - PRIMARY KEY: `id` - UNIQUE: `ux_pr_order_no` (`shop_id`,`order_no`) - KEY: `idx_pr_shop_time` (`shop_id`,`order_time`)
|
||||
**Foreign Keys**: - `fk_pr_supplier`: `supplier_id` → `suppliers(id)` - `fk_pr_user`: `user_id` → `users(id)`
|
||||
|
||||
### purchase_return_order_items
|
||||
| Column Name | Data Type | Nullable | Default | Comment |
|
||||
| ----------- | --------- | -------- | ------- | ------- |
|
||||
| id | BIGINT UNSIGNED | NOT NULL | AUTO_INCREMENT | |
|
||||
| order_id | BIGINT UNSIGNED | NOT NULL | | |
|
||||
| product_id | BIGINT UNSIGNED | NOT NULL | | |
|
||||
| quantity | DECIMAL(18,3) | NOT NULL | | |
|
||||
| unit_price | DECIMAL(18,2) | NOT NULL | | |
|
||||
| amount | DECIMAL(18,2) | NOT NULL | | 行金额 |
|
||||
|
||||
**Indexes**: - PRIMARY KEY: `id` - KEY: `idx_proi_order` (`order_id`) - KEY: `idx_proi_product` (`product_id`)
|
||||
**Foreign Keys**: - `fk_proi_order`: `order_id` → `purchase_return_orders(id)` - `fk_proi_product`: `product_id` → `products(id)`
|
||||
|
||||
### other_transactions
|
||||
| Column Name | Data Type | Nullable | Default | Comment |
|
||||
| ----------- | --------- | -------- | ------- | ------- |
|
||||
@@ -509,4 +725,74 @@ image.png
|
||||
- type/category: 收入/支出与分类
|
||||
- counterparty_type/id: 往来单位（可空）
|
||||
|
||||
**Indexes**: - PRIMARY KEY: `id` - KEY: `idx_ot_shop_time`
|
||||
**Indexes**: - PRIMARY KEY: `id` - KEY: `idx_ot_shop_time` (`shop_id`,`tx_time`)
|
||||
|
||||
### consults
|
||||
| Column Name | Data Type | Nullable | Default | Comment |
|
||||
| ----------- | --------- | -------- | ------- | ------- |
|
||||
| id | BIGINT UNSIGNED | NOT NULL | AUTO_INCREMENT | 咨询ID |
|
||||
| shop_id | BIGINT UNSIGNED | NOT NULL | | 所属店铺 |
|
||||
| user_id | BIGINT UNSIGNED | NOT NULL | | 提问用户 |
|
||||
| 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 | 更新时间 |
|
||||
|
||||
**Indexes**: - PRIMARY KEY: `id` - KEY: `idx_consult_shop_status` (`shop_id`,`status`) - KEY: `fk_consult_user` (`user_id`)
|
||||
**Foreign Keys**: - `fk_consult_shop`: `shop_id` → `shops(id)` - `fk_consult_user`: `user_id` → `users(id)`
|
||||
|
||||
### consult_replies
|
||||
| Column Name | Data Type | Nullable | Default | Comment |
|
||||
| ----------- | --------- | -------- | ------- | ------- |
|
||||
| id | BIGINT UNSIGNED | NOT NULL | AUTO_INCREMENT | 回复ID |
|
||||
| consult_id | BIGINT UNSIGNED | NOT NULL | | 所属咨询 |
|
||||
| user_id | BIGINT UNSIGNED | NOT NULL | | 回复人（管理员） |
|
||||
| content | TEXT | NOT NULL | | 回复内容 |
|
||||
| created_at | TIMESTAMP | NOT NULL | CURRENT_TIMESTAMP | 回复时间 |
|
||||
|
||||
**Indexes**: - PRIMARY KEY: `id` - KEY: `idx_cr_consult` (`consult_id`) - KEY: `fk_cr_user` (`user_id`)
|
||||
**Foreign Keys**: - `fk_cr_consult`: `consult_id` → `consults(id)` - `fk_cr_user`: `user_id` → `users(id)`
|
||||
|
||||
```
|
||||
**触发器**:
|
||||
- `trg_consult_replies_ai`: AFTER INSERT ON `consult_replies` → 更新 `consults.status='resolved'` 且 `updated_at=NOW()`
|
||||
```
|
||||
|
||||
### notices
|
||||
| Column Name | Data Type | Nullable | Default | Comment |
|
||||
| ----------- | --------- | -------- | ------- | ------- |
|
||||
| id | BIGINT UNSIGNED | NOT NULL | AUTO_INCREMENT | |
|
||||
| title | VARCHAR(120) | NOT NULL | | 标题 |
|
||||
| content | VARCHAR(500) | NOT NULL | | 内容（跑马灯/简讯） |
|
||||
| tag | VARCHAR(32) | YES | | 标签（如“活动”） |
|
||||
| is_pinned | TINYINT(1) | NOT NULL | 0 | 是否置顶 |
|
||||
| starts_at | DATETIME | YES | | 生效开始时间（为空立即生效） |
|
||||
| ends_at | DATETIME | YES | | 生效结束时间（为空长期） |
|
||||
| status | ENUM('draft','published','offline') | NOT NULL | published | 状态 |
|
||||
| created_at | TIMESTAMP | NOT NULL | CURRENT_TIMESTAMP | |
|
||||
| updated_at | TIMESTAMP | NOT NULL | CURRENT_TIMESTAMP | |
|
||||
| deleted_at | DATETIME | YES | | 逻辑删除 |
|
||||
|
||||
**Indexes**: - PRIMARY KEY: `id` - KEY: `idx_notices_time` (`starts_at`,`ends_at`)
|
||||
|
||||
字段说明：
|
||||
- 生效窗口：仅当 `status='published'` 且当前时间处于 `[starts_at, ends_at]` 区间（空表示不限制）时，前台 `/api/notices` 会返回；排序 `is_pinned DESC, created_at DESC`。
|
||||
- 数据范围：平台全局公告（与租户无关）。如需“店铺公告”，需在该表增加 `shop_id` 并调整接口逻辑。
|
||||
|
||||
### email_codes
|
||||
| Column Name | Data Type | Nullable | Default | Comment |
|
||||
| ----------- | --------- | -------- | ------- | ------- |
|
||||
| id | BIGINT UNSIGNED | NOT NULL | AUTO_INCREMENT | |
|
||||
| email | VARCHAR(128) | NOT NULL | | 邮箱 |
|
||||
| scene | VARCHAR(32) | NOT NULL | | 场景（login/register/…） |
|
||||
| code_hash | VARCHAR(64) | NOT NULL | | 验证码哈希（SHA-256） |
|
||||
| salt | VARCHAR(64) | NOT NULL | | 加盐字符串 |
|
||||
| expire_at | DATETIME | NOT NULL | | 过期时间 |
|
||||
| status | TINYINT UNSIGNED | NOT NULL | 0 | 0=unused,1=used,2=expired |
|
||||
| fail_count | INT | NOT NULL | 0 | 错误次数 |
|
||||
| ip | VARCHAR(64) | YES | | 发送IP |
|
||||
| created_at | TIMESTAMP | NOT NULL | CURRENT_TIMESTAMP | |
|
||||
| updated_at | TIMESTAMP | NOT NULL | CURRENT_TIMESTAMP | |
|
||||
|
||||
**Indexes**: - PRIMARY KEY: `id` - KEY: `idx_email_scene_created` (`email`,`scene`,`created_at`) - KEY: `idx_email_expire` (`expire_at`)
|
||||
|
||||
Reference in New Issue
Block a user