后端：公告√

注意数据库新建notice表
2025-09-16 20:03:17 +08:00
parent 158b3e65b6
commit 562ec4abf9
26 changed files with 1468 additions and 35 deletions
--- a/doc/database_documentation.md
+++ b/doc/database_documentation.md
@@ -0,0 +1,401 @@
+## partsinquiry 数据库文档
+
+更新日期：2025-09-16
+
+说明：本文件根据远程库 mysql.tonaspace.com 中 `partsinquiry` 的实际结构生成，字段/索引/外键信息以线上为准。
+
+### shops
+| Column Name | Data Type | Nullable | Default | Comment |
+| ----------- | --------- | -------- | ------- | ------- |
+| id | BIGINT UNSIGNED | NOT NULL | AUTO_INCREMENT | 店铺/租户ID |
+| name | VARCHAR(100) | NOT NULL |  | 店铺名称 |
+| 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` - KEY: `idx_shops_status` (`status`)
+
+### users
+| Column Name | Data Type | Nullable | Default | Comment |
+| ----------- | --------- | -------- | ------- | ------- |
+| id | BIGINT UNSIGNED | NOT NULL | AUTO_INCREMENT | 用户ID |
+| shop_id | BIGINT UNSIGNED | NOT NULL |  | 所属店铺 |
+| phone | VARCHAR(32) | 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 | 是否店主 |
+| 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: `ux_users_shop_phone` (`shop_id`,`phone`)
+**Foreign Keys**: - `fk_users_shop`: `shop_id` → `shops(id)` ON UPDATE NO ACTION ON DELETE NO ACTION
+
+### user_identities
+| 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 |  |  |
+| provider | ENUM('wechat_mp','wechat_app') | NOT NULL |  | 身份提供方：小程序/APP |
+| openid | VARCHAR(64) | NOT NULL |  |  |
+| unionid | VARCHAR(64) | YES |  |  |
+| nickname | VARCHAR(64) | YES |  |  |
+| avatar_url | VARCHAR(512) | YES |  |  |
+| last_login_at | DATETIME | YES |  |  |
+| created_at | TIMESTAMP | NOT NULL | CURRENT_TIMESTAMP |  |
+| updated_at | TIMESTAMP | NOT NULL | CURRENT_TIMESTAMP |  |
+
+**Indexes**: - PRIMARY KEY: `id` - KEY: `idx_identity_shop` (`shop_id`) - KEY: `idx_identity_user` (`user_id`) - UNIQUE: `ux_identity_provider_openid` (`provider`,`openid`) - UNIQUE: `ux_identity_unionid` (`unionid`)
+**Foreign Keys**: - `fk_identity_shop`: `shop_id` → `shops(id)` ON UPDATE NO ACTION ON DELETE NO ACTION - `fk_identity_user`: `user_id` → `users(id)` ON UPDATE NO ACTION ON DELETE NO ACTION
+
+### wechat_sessions
+| Column Name | Data Type | Nullable | Default | Comment |
+| ----------- | --------- | -------- | ------- | ------- |
+| id | BIGINT UNSIGNED | NOT NULL | AUTO_INCREMENT |  |
+| provider | ENUM('wechat_mp','wechat_app') | NOT NULL |  |  |
+| openid | VARCHAR(64) | NOT NULL |  |  |
+| session_key | VARCHAR(128) | NOT NULL |  |  |
+| expires_at | DATETIME | NOT NULL |  |  |
+| created_at | TIMESTAMP | NOT NULL | CURRENT_TIMESTAMP |  |
+
+**Indexes**: - PRIMARY KEY: `id` - KEY: `idx_wechat_session_expires` (`expires_at`) - UNIQUE: `ux_wechat_session` (`provider`,`openid`)
+
+### system_parameters
+| 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 |  | 创建/最后修改人 |
+| key | VARCHAR(64) | NOT NULL |  | 参数键 |
+| value | JSON | NOT NULL |  | 参数值（JSON） |
+| created_at | TIMESTAMP | NOT NULL | CURRENT_TIMESTAMP |  |
+| updated_at | TIMESTAMP | NOT NULL | CURRENT_TIMESTAMP |  |
+
+**Indexes**: - PRIMARY KEY: `id` - KEY: `idx_sysparams_shop` (`shop_id`) - UNIQUE: `ux_sysparams_shop_key` (`shop_id`,`key`)
+**Foreign Keys**: - `fk_sysparams_shop`: `shop_id` → `shops(id)` ON UPDATE NO ACTION ON DELETE NO ACTION - `fk_sysparams_user`: `user_id` → `users(id)` ON UPDATE NO ACTION ON DELETE NO ACTION
+
+### product_units
+| 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 |  |  |
+| name | VARCHAR(16) | NOT NULL |  |  |
+| created_at | TIMESTAMP | NOT NULL | CURRENT_TIMESTAMP |  |
+| updated_at | TIMESTAMP | NOT NULL | CURRENT_TIMESTAMP |  |
+| deleted_at | DATETIME | YES |  |  |
+
+**Indexes**: - PRIMARY KEY: `id` - KEY: `idx_units_shop` (`shop_id`) - UNIQUE: `ux_units_shop_name` (`shop_id`,`name`)
+**Foreign Keys**: - `fk_units_shop`: `shop_id` → `shops(id)` ON UPDATE NO ACTION ON DELETE NO ACTION - `fk_units_user`: `user_id` → `users(id)` ON UPDATE NO ACTION ON DELETE NO ACTION
+
+### global_skus
+| Column Name | Data Type | Nullable | Default | Comment |
+| ----------- | --------- | -------- | ------- | ------- |
+| id | BIGINT UNSIGNED | NOT NULL | AUTO_INCREMENT |  |
+| name | VARCHAR(120) | NOT NULL |  | SKU名称 |
+| brand | VARCHAR(64) | YES |  |  |
+| model | VARCHAR(64) | YES |  |  |
+| spec | VARCHAR(128) | YES |  |  |
+| barcode | VARCHAR(32) | YES |  |  |
+| unit_id | BIGINT UNSIGNED | YES |  |  |
+| tags | JSON | YES |  |  |
+| status | ENUM('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_global_skus_brand_model` (`brand`,`model`) - UNIQUE: `ux_global_skus_barcode` (`barcode`)
+**Foreign Keys**: - `fk_globalsku_unit`: `unit_id` → `product_units(id)` ON UPDATE NO ACTION ON DELETE NO ACTION
+
+### product_categories
+| 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 |  |  |
+| name | VARCHAR(64) | NOT NULL |  |  |
+| parent_id | BIGINT UNSIGNED | YES |  |  |
+| sort_order | INT | NOT NULL | 0 |  |
+| created_at | TIMESTAMP | NOT NULL | CURRENT_TIMESTAMP |  |
+| updated_at | TIMESTAMP | NOT NULL | CURRENT_TIMESTAMP |  |
+| deleted_at | DATETIME | YES |  |  |
+
+**Indexes**: - PRIMARY KEY: `id` - KEY: `idx_categories_shop` (`shop_id`) - KEY: `idx_categories_parent` (`parent_id`) - UNIQUE: `ux_categories_shop_name` (`shop_id`,`name`)
+**Foreign Keys**: - `fk_categories_shop`: `shop_id` → `shops(id)` ON UPDATE NO ACTION ON DELETE NO ACTION - `fk_categories_user`: `user_id` → `users(id)` ON UPDATE NO ACTION ON DELETE NO ACTION - `fk_categories_parent`: `parent_id` → `product_categories(id)` ON UPDATE NO ACTION ON DELETE NO ACTION
+
+### products
+| 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 |  |  |
+| name | VARCHAR(120) | NOT NULL |  | 供全文检索 |
+| category_id | BIGINT UNSIGNED | YES |  |  |
+| unit_id | BIGINT UNSIGNED | NOT NULL |  |  |
+| brand | VARCHAR(64) | YES |  |  |
+| model | VARCHAR(64) | YES |  |  |
+| spec | VARCHAR(128) | YES |  |  |
+| origin | VARCHAR(64) | YES |  |  |
+| barcode | VARCHAR(32) | YES |  |  |
+| alias | VARCHAR(120) | YES |  |  |
+| description | TEXT | YES |  |  |
+| global_sku_id | BIGINT UNSIGNED | YES |  |  |
+| safe_min | DECIMAL(18,3) | YES |  |  |
+| safe_max | DECIMAL(18,3) | YES |  |  |
+| search_text | TEXT | 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_products_shop` (`shop_id`) - KEY: `idx_products_category` (`category_id`) - KEY: `idx_products_unit` (`unit_id`) - 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)`
+
+### product_aliases
+| 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 |  |  |
+| alias | VARCHAR(120) | NOT NULL |  |  |
+| created_at | TIMESTAMP | NOT NULL | CURRENT_TIMESTAMP |  |
+| updated_at | TIMESTAMP | NOT NULL | CURRENT_TIMESTAMP |  |
+| deleted_at | DATETIME | YES |  |  |
+
+**Indexes**: - PRIMARY KEY: `id` - KEY: `idx_product_alias_product` (`product_id`) - UNIQUE: `ux_product_alias` (`product_id`,`alias`)
+**Foreign Keys**: - `fk_alias_shop`: `shop_id` → `shops(id)` - `fk_alias_user`: `user_id` → `users(id)` - `fk_alias_product`: `product_id` → `products(id)`
+
+### product_images
+| 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 |  |  |
+| url | VARCHAR(512) | NOT NULL |  |  |
+| hash | VARCHAR(64) | YES |  | 内容哈希（去重） |
+| sort_order | INT | NOT NULL | 0 |  |
+| created_at | TIMESTAMP | NOT NULL | CURRENT_TIMESTAMP |  |
+
+**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
+
+### product_prices
+| Column Name | Data Type | Nullable | Default | Comment |
+| ----------- | --------- | -------- | ------- | ------- |
+| product_id | BIGINT UNSIGNED | NOT NULL |  |  |
+| shop_id | BIGINT UNSIGNED | NOT NULL |  |  |
+| user_id | BIGINT UNSIGNED | NOT NULL |  |  |
+| purchase_price | DECIMAL(18,2) | NOT NULL | 0.00 |  |
+| retail_price | DECIMAL(18,2) | NOT NULL | 0.00 |  |
+| distribution_price | DECIMAL(18,2) | NOT NULL | 0.00 |  |
+| wholesale_price | DECIMAL(18,2) | NOT NULL | 0.00 |  |
+| big_client_price | DECIMAL(18,2) | NOT NULL | 0.00 |  |
+| updated_at | TIMESTAMP | NOT NULL | CURRENT_TIMESTAMP |  |
+
+**Indexes**: - PRIMARY KEY: `product_id` - KEY: `idx_prices_shop` (`shop_id`)
+**Foreign Keys**: - `fk_prices_product`: `product_id` → `products(id)` ON DELETE CASCADE - `fk_prices_shop`: `shop_id` → `shops(id)` - `fk_prices_user`: `user_id` → `users(id)`
+
+### inventories
+| Column Name | Data Type | Nullable | Default | Comment |
+| ----------- | --------- | -------- | ------- | ------- |
+| product_id | BIGINT UNSIGNED | NOT NULL |  |  |
+| shop_id | BIGINT UNSIGNED | NOT NULL |  |  |
+| user_id | BIGINT UNSIGNED | NOT NULL |  |  |
+| quantity | DECIMAL(18,3) | NOT NULL | 0.000 |  |
+| updated_at | TIMESTAMP | NOT NULL | CURRENT_TIMESTAMP |  |
+
+**Indexes**: - PRIMARY KEY: `product_id` - KEY: `idx_inventories_shop` (`shop_id`)
+**Foreign Keys**: - `fk_inv_product`: `product_id` → `products(id)` ON DELETE CASCADE - `fk_inv_shop`: `shop_id` → `shops(id)` - `fk_inv_user`: `user_id` → `users(id)`
+
+### customers
+| 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 |  |  |
+| name | VARCHAR(120) | NOT NULL |  |  |
+| phone | VARCHAR(32) | YES |  |  |
+| level | VARCHAR(32) | YES |  | 客户等级标签 |
+| price_level | ENUM('retail','distribution','wholesale','big_client') | NOT NULL | retail | 默认售价列 |
+| status | TINYINT UNSIGNED | NOT NULL | 1 |  |
+| 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_customers_shop` (`shop_id`) - KEY: `idx_customers_phone` (`phone`)
+**Foreign Keys**: - `fk_customers_shop`: `shop_id` → `shops(id)` - `fk_customers_user`: `user_id` → `users(id)`
+
+### suppliers
+| 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 |  |  |
+| name | VARCHAR(120) | NOT NULL |  |  |
+| phone | VARCHAR(32) | YES |  |  |
+| status | TINYINT UNSIGNED | NOT NULL | 1 |  |
+| 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_suppliers_shop` (`shop_id`) - KEY: `idx_suppliers_phone` (`phone`)
+**Foreign Keys**: - `fk_suppliers_shop`: `shop_id` → `shops(id)` - `fk_suppliers_user`: `user_id` → `users(id)`
+
+### accounts
+| 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 |  |  |
+| name | VARCHAR(64) | NOT NULL |  |  |
+| type | ENUM('cash','bank','alipay','wechat','other') | NOT NULL | cash |  |
+| balance | DECIMAL(18,2) | NOT NULL | 0.00 |  |
+| status | TINYINT UNSIGNED | NOT NULL | 1 |  |
+| created_at | TIMESTAMP | NOT NULL | CURRENT_TIMESTAMP |  |
+| updated_at | TIMESTAMP | NOT NULL | CURRENT_TIMESTAMP |  |
+| deleted_at | DATETIME | YES |  |  |
+
+**Indexes**: - PRIMARY KEY: `id` - KEY: `idx_accounts_shop` (`shop_id`) - UNIQUE: `ux_accounts_shop_name` (`shop_id`,`name`)
+**Foreign Keys**: - `fk_accounts_shop`: `shop_id` → `shops(id)` - `fk_accounts_user`: `user_id` → `users(id)`
+
+### sales_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('draft','approved','returned','void') | NOT NULL | draft |  |
+| 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` - KEY: `idx_sales_shop_time` (`shop_id`,`order_time`) - KEY: `idx_sales_customer` (`customer_id`) - UNIQUE: `ux_sales_order_no` (`shop_id`,`order_no`)
+**Foreign Keys**: - `fk_sales_shop`: `shop_id` → `shops(id)` - `fk_sales_user`: `user_id` → `users(id)` - `fk_sales_customer`: `customer_id` → `customers(id)`
+
+### sales_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 |
+| amount | DECIMAL(18,2) | NOT NULL |  |  |
+
+**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)`
+
+### purchase_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('draft','approved','void') | NOT NULL | draft |  |
+| 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` - KEY: `idx_purchase_shop_time` (`shop_id`,`order_time`) - KEY: `idx_purchase_supplier` (`supplier_id`) - UNIQUE: `ux_purchase_order_no` (`shop_id`,`order_no`)
+**Foreign Keys**: - `fk_purchase_shop`: `shop_id` → `shops(id)` - `fk_purchase_user`: `user_id` → `users(id)` - `fk_purchase_supplier`: `supplier_id` → `suppliers(id)`
+
+### purchase_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_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)`
+
+### payments
+| 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 |  |  |
+| biz_type | ENUM('sale','purchase','other') | NOT NULL |  |  |
+| biz_id | BIGINT UNSIGNED | YES |  | 业务表ID：sales_orders/purchase_orders/other_transactions |
+| account_id | BIGINT UNSIGNED | NOT NULL |  |  |
+| direction | ENUM('in','out') | NOT NULL |  | 收款/付款 |
+| amount | DECIMAL(18,2) | NOT NULL |  |  |
+| pay_time | DATETIME | NOT NULL |  |  |
+| remark | VARCHAR(255) | YES |  |  |
+| created_at | TIMESTAMP | NOT NULL | CURRENT_TIMESTAMP |  |
+
+**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)`
+
+### other_transactions
+| 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 |  |  |
+| type | ENUM('income','expense') | NOT NULL |  |  |
+| category | VARCHAR(64) | NOT NULL |  |  |
+| counterparty_type | VARCHAR(32) | YES |  | customer/supplier/other |
+| counterparty_id | BIGINT UNSIGNED | YES |  |  |
+| account_id | BIGINT UNSIGNED | NOT NULL |  |  |
+| amount | DECIMAL(18,2) | NOT NULL |  |  |
+| tx_time | DATETIME | NOT NULL |  |  |
+| 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_ot_shop_time` (`shop_id`,`tx_time`) - KEY: `idx_ot_account` (`account_id`)
+**Foreign Keys**: - `fk_ot_shop`: `shop_id` → `shops(id)` - `fk_ot_user`: `user_id` → `users(id)` - `fk_ot_account`: `account_id` → `accounts(id)`
+
+### product_images 触发器
+- `trg_products_ai`: AFTER INSERT ON `products` → 更新 `products.search_text`
+- `trg_products_au`: BEFORE UPDATE ON `products` → 维护 `products.search_text`
+- `trg_palias_ai`: AFTER INSERT ON `product_aliases` → 重建 `products.search_text`
+- `trg_palias_au`: AFTER UPDATE ON `product_aliases` → 重建 `products.search_text`
+- `trg_palias_ad`: AFTER DELETE ON `product_aliases` → 重建 `products.search_text`
+
+
+### notices
+| 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 |  |  |
+| 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_shop` (`shop_id`,`status`,`is_pinned`,`created_at`) - KEY: `idx_notices_time` (`starts_at`,`ends_at`)
+**Foreign Keys**: - `fk_notices_shop`: `shop_id` → `shops(id)` ON UPDATE NO ACTION ON DELETE NO ACTION - `fk_notices_user`: `user_id` → `users(id)` ON UPDATE NO ACTION ON DELETE NO ACTION
+
--- a/doc/openapi.yaml
+++ b/doc/openapi.yaml
@@ -0,0 +1,67 @@
+openapi: 3.0.3
+info:
+  title: PartsInquiry API
+  version: 0.1.0
+  description: >-
+    所有接口定义集中于此文件。每个 path 在 summary/description 中标注实现状态。
+servers:
+  - url: /
+paths:
+  /api/notices:
+    get:
+      summary: 公告列表（✅ Fully Implemented）
+      description: 返回当前店铺可见的公告列表。后端与前端均已接入。
+      parameters:
+        - in: header
+          name: X-Shop-Id
+          required: false
+          schema:
+            type: integer
+          description: 店铺ID，缺省为 1
+      responses:
+        '200':
+          description: 成功
+          content:
+            application/json:
+              schema:
+                type: array
+                items:
+                  $ref: '#/components/schemas/Notice'
+components:
+  schemas:
+    Notice:
+      type: object
+      properties:
+        id:
+          type: integer
+          format: int64
+        shopId:
+          type: integer
+          format: int64
+        userId:
+          type: integer
+          format: int64
+        title:
+          type: string
+        content:
+          type: string
+        tag:
+          type: string
+        pinned:
+          type: boolean
+        startsAt:
+          type: string
+          format: date-time
+        endsAt:
+          type: string
+          format: date-time
+        status:
+          type: string
+          enum: [DRAFT, PUBLISHED, OFFLINE]
+        createdAt:
+          type: string
+          format: date-time
+        updatedAt:
+          type: string
+          format: date-time
+