分店备货管理 v1.1.0 更新说明

发布日期：2026-04-27
影响文件：orders.php
数据变更：自动新增 keshapo_payments 表（首次访问时自动创建，无需手动执行 SQL）

✨ 新增功能

1. 付款记录自动追踪

系统现在会自动记录每一次金额变动，无需人工记账：

• 新增付款：点击「输入付款金额」时，自动记录本次付款金额与累计总额
• 修正总额：点击「累计已付」修改总金额时，自动记录差额与修正后总额
• 不可篡改：每笔记录包含变动前/后金额，形成完整审计链

2. 统计页时间轴

进入「查询备货单 → 统计功能」，新增 💰 付款记录 卡片：

🔧 技术实现

数据表结构（自动创建）

CREATE TABLE keshapo_payments (
    id INT AUTO_INCREMENT PRIMARY KEY,
    amount DECIMAL(10,2) NOT NULL COMMENT '变动金额',
    previous_total DECIMAL(10,2) NOT NULL COMMENT '变动前累计',
    new_total DECIMAL(10,2) NOT NULL COMMENT '变动后累计',
    type ENUM('add','set') NOT NULL COMMENT 'add=新增付款, set=修正总额',
    created_at DATETIME DEFAULT CURRENT_TIMESTAMP
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;

记录逻辑

• add_paid：写入正数金额，previous_total + amount = new_total
• set_paid：计算差额（new_total - previous_total），写入该差额

📱 界面预览

统计功能页新增区域：

💰 付款记录                              共 3 笔
─────────────────────────────────────────────
2026-04-27 14:30                    +500.00
[新增付款]                           累计 1500.00

2026-04-26 09:15                   +1000.00
[新增付款]                           累计 1000.00

🚀 升级方式

1. 备份现有 orders.php
2. 用新版 orders.php 直接覆盖
3. 访问一次「统计功能」页面，系统自动完成建表
4. 完成，之后所有付款操作会自动留痕

🐛 兼容性

• 向下兼容：不影响现有备货单数据
• 零配置：无需修改 lib.php 或其他核心文件
• 移动端适配：时间轴卡片已针对手机端优化排版