ERP系统中库存与财务模块必须实时联动，以单据为纽带构建状态流和记账链路：出入库操作对应唯一单据并严格控制状态，库存台账记录完整动作信息，可用库存仅由已执行单据更新；财务模块基于业务单据自动生成应收应付明细，所有流水关联原始单据ID，余额动态计算；关键联动点需事务包裹、统一时间戳、负数拦截及单据溯源；ThinkPHP开发应利用事件系统解耦、模型作用域简化查询、统一控制器封装通用逻辑，并规范字段类型与参数校验。
用ThinkPHP搭ERP进销存系统，库存和财务两个模块不能分开建——它们的数据必须实时联动。比如一笔销售出库，既要扣减库存数量，也要生成应收单；采购入库不仅要增加库存，还要挂应付账款。脱离业务闭环去写代码，后期改起来成本极高。
库存管理：从“加减法”到“状态流”
真正可用的库存模块，核心不是“商品表里改个数字”，而是围绕单据建立可追溯的状态链路：
- 每笔出入库操作都必须对应唯一单据（如入库单ID、出库单ID），单据状态要严格控制（草稿→已审核→已执行）
- 库存台账表（inventory_log）需记录动作类型（IN/OUT/ADJUST/TRANSFER）、关联单据ID、仓库ID、商品SKU、批次号、有效期、操作人、时间戳
- 可用库存字段（available_qty）只由已执行的入库、出库、调拨、盘点盈亏等单据触发更新，不接受直接修改
- 支持预占库存：销售订单审核通过后，在库存台账中插入一条 type=LOCK 的记录，同时减少 available_qty；出库完成再转为 type=OUT
- 多仓库场景下，库存查询必须带 warehouse_id 条件，避免跨仓混算；总库存应是各仓汇总，而非单独一个“总库位”字段
财务统计：以单据为源头驱动记账
财务模块不是独立报表工具，而是对业务单据的二次归集与映射：
- 采购入库单 → 自动生成应付明细（供应商+金额+预计付款日），并关联原始入库单ID
- 销售出库单 → 自动生成应收明细（客户+金额+预计收款日），同步更新销售毛利（售价-采购价）
- 所有财务流水表（finance_ledger）必须有 business_type（purchase/sale/return/adjust）和 business_id 字段，确保可反查原始业务
- 应收账款/应付账款余额 = 对应明细表中 status=valid 的未结清金额之和，禁止用汇总字段缓存，防止数据漂移
- 月度利润表不是靠“销售额-成本”硬算，而是按销售出库单的实际出库日期、对应采购入库单的入库日期和单价动态匹配计算
库存与财务的数据联动关键点
这两个模块的咬合处最容易出错，开发时要重点加固：
立即学习“PHP免费学习笔记（深入）”；
- 事务必须包裹完整链路：例如审核销售单时，要同时更新库存台账（LOCK）、生成应收明细、记录操作日志——任一环节失败则全部回滚
- 库存变动和财务记账使用同一时间戳（如 Carbon::now()），避免因微秒级差异导致对账偏差
- 提供“单据溯源”功能：在任意一笔应收明细页面，能一键跳转查看对应的销售出库单及所含商品的原始采购入库单
- 设置库存负数拦截：出库前校验 available_qty ≥ 出库数量，若不满足则拒绝提交，并提示“可用库存不足”，而不是强行扣成负值
- 财务统计报表默认按“单据发生日期”聚合，而非“创建日期”或“审核日期”，确保经营周期逻辑一致
ThinkPHP落地建议
利用框架特性提升开发效率与稳定性：
- 用 ThinkPHP 的事件系统（event）解耦：例如监听 OrderApproved 事件，触发库存锁定 + 应收生成 + 邮件通知等多个动作
- 数据库模型中定义 scope 方法，如 scopeValid() 过滤有效单据，scopeByDate($start, $end) 支持时间范围筛选，让统计查询更简洁
- 财务类控制器统一继承 FinanceController，内置通用导出方法（Excel）、对账差异高亮逻辑、凭证号自动生成规则
- 库存操作接口强制要求传 warehouse_id 和 batch_no（如启用批次管理），前端不可省略，后端不做默认填充
- 所有金额字段统一用 decimal(10,2)，避免 float 类型精度丢失；库存数量用 int 或 bigint，禁用 float 存 qty
