更新日期：2026-04-25
涉及模块：进货单、销售单修改、柯沙坡备货单（创建/修改/通知配置）

一、数据库表结构变更

1.1 keshapo_purchase_items 增加 product_id 字段

用于关联 products 表，实现库存扣减与商品同步。

ALTER TABLE keshapo_purchase_items
ADD COLUMN product_id INT DEFAULT NULL AFTER order_id,
ADD KEY idx_product_id (product_id);

1.2 确保 inventory_stock_moves 表存在（由 inventory_lib.php 自动维护）

若手动创建，语句如下：

CREATE TABLE IF NOT EXISTS inventory_stock_moves (
    id INT AUTO_INCREMENT PRIMARY KEY,
    ref_type VARCHAR(30) NOT NULL,
    ref_id INT NOT NULL,
    product_id INT NOT NULL,
    direction ENUM('IN','OUT') NOT NULL,
    quantity INT NOT NULL,
    created_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
    KEY idx_ref (ref_type, ref_id),
    KEY idx_product (product_id)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;

二、进货单（kd.php）商品入库逻辑

改动说明

• 新增商品自动插入 products 表，单价写入 stock_price（进价）。
• 已有商品若新单价不在历史列表中，以 / 追加到 stock_price。
• 事务写入 sales_stock 主表 + stock_items 明细表。
• 调用 inventoryApplyPurchase() 增加库存。

核心逻辑

三、销售单修改（xg.php）批发价同步逻辑

改动说明

• 销售单单价为批发价，追加到 products.price 字段。
• 不改动 stock_price（进价）字段。
• 新增商品自动插入 products，price 写入批发价。

核心逻辑

四、柯沙坡备货单 lib.php 改动

4.1 引入 inventory_lib.php 库存函数

4.2 数量强制整数

keshapoBuildItemsFromPost() 中：

$quantity = (int)($product['quantity'] ?? 0);

4.3 商品同步到 products 表

新增 keshapoSyncProducts() 函数：

4.4 创建备货单（keshapoCreateOrder）

4.5 修改备货单（keshapoUpdateOrder）

4.6 删除备货单（keshapoDeleteOrder）

五、前端页面改动

5.1 柯沙坡创建备货单（create.php）

5.2 柯沙坡修改备货单（edit.php）

5.3 柯沙坡通知配置（settings.php）

六、文件对应关系

七、SQL 变更汇总（可直接执行）

-- 1. 给 keshapo_purchase_items 增加 product_id 字段
ALTER TABLE keshapo_purchase_items
ADD COLUMN product_id INT DEFAULT NULL AFTER order_id,
ADD KEY idx_product_id (product_id);

-- 2. 确保库存流水表存在（如 inventory_lib.php 未自动创建）
CREATE TABLE IF NOT EXISTS inventory_stock_moves (
    id INT AUTO_INCREMENT PRIMARY KEY,
    ref_type VARCHAR(30) NOT NULL,
    ref_id INT NOT NULL,
    product_id INT NOT NULL,
    direction ENUM('IN','OUT') NOT NULL,
    quantity INT NOT NULL,
    created_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
    KEY idx_ref (ref_type, ref_id),
    KEY idx_product (product_id)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;

文档结束