DBErp 进销存系统 v3.0.4 正式发布。本次版本围绕经营分析、库存成本和系统运维补齐了几块关键能力：销售毛利分析、库存移动平均成本、SMTP 系统邮件，以及本地部署授权。同时，版本继续加强库存并发安全、主数据引用保护、采购与销售退货结算、核销一致性和查询报表体验。
对于正在使用 DBErp 3.x 的团队，库存成本、销售毛利、退货结算或高频库存操作都属于高影响业务，升级前应把数据口径和业务流程一起纳入验证范围。
毛利分析不只是多一张报表
销售毛利的核心不是展示一个百分比，而是让销售收入与库存成本使用同一套可追溯口径。实际使用中，至少需要确认以下数据是否一致：
- 销售收入采用含税还是未税金额。
- 销售折扣、整单优惠和促销分摊如何处理。
- 销售退货如何冲减收入和成本。
- 库存成本按批次、先进先出，还是移动平均计算。
- 期末库存成本变更后，历史单据是否需要重新核算。
可以这样理解毛利：
销售毛利 = 销售收入 - 销售成本
毛利率 = 销售毛利 / 销售收入
但在系统中，销售成本必须绑定出库明细和对应的成本计算结果。否则，同一商品在采购入库、销售出库和退货之后，报表很容易出现收入看起来正确、成本却无法解释的问题。
用 SQL 做一轮口径核对
下面是一个可改造的示例。假设系统中存在 sales_outbound_detail 销售出库明细表，字段包括 quantity、unit_price 和 unit_cost，实际表名和字段需要按本地部署版本调整：
SELECT
product_id,
SUM(quantity * unit_price) AS sales_amount,
SUM(quantity * unit_cost) AS sales_cost,
SUM(quantity * (unit_price - unit_cost)) AS gross_profit,
CASE
WHEN SUM(quantity * unit_price) = 0 THEN 0
ELSE SUM(quantity * (unit_price - unit_cost))
/ SUM(quantity * unit_price)
END AS gross_margin
FROM sales_outbound_detail
WHERE outbound_date >= '2024-01-01'
AND outbound_date < '2024-02-01'
AND status = 'COMPLETED'
GROUP BY product_id
ORDER BY gross_profit DESC;
这类查询适合用于升级后的抽样核对，不应直接替代 DBErp 内置报表。验证时可以选取高销量商品、发生过退货的商品和多次采购价格变化的商品，逐笔对比出库单、退货单、库存成本和毛利结果。
移动平均成本让库存成本更贴近实时变化
移动平均成本会随着新的采购入库或其他影响库存价值的业务更新。典型计算方式是：
新平均成本 =（原库存数量 × 原平均成本 + 本次入库数量 × 本次入库成本）
/（原库存数量 + 本次入库数量）
举例来说，库存中有 100 件商品，平均成本为 10 元；随后以 12 元采购入库 50 件，则新的平均成本为：
(100 × 10 + 50 × 12) / (100 + 50) = 10.67 元
移动平均成本的价值在于，它能将多次采购价格变化反映到后续销售成本中。不过，这也意味着库存更新必须具备清晰的事务边界。高频入库、出库或盘点同时发生时，如果数量和成本更新不是原子操作，就可能造成库存数量正确但成本错误，或出现负库存成本等异常。
升级后建议重点压测这些场景：
- 同一商品被多个用户同时销售出库。
- 采购入库与销售出库在同一时间段处理。
- 退货单引用原销售单，并重新影响库存成本。
- 盘点、调拨和库存调整与正常出入库并发执行。
- 业务单据重复提交或网络重试。
SMTP 邮件服务降低系统通知接入成本
v3.0.4 新增 SMTP 系统邮件能力后，可以把审批通知、业务提醒或系统异常通知接入企业现有邮件服务。部署时需要向邮件管理员确认 SMTP 主机、端口、加密方式、发件账号和认证策略。
下面是一个可改造的环境变量示例，具体配置键名以实际部署包提供的配置说明为准：
export DBERP_SMTP_HOST='smtp.example.com'
export DBERP_SMTP_PORT='587'
export DBERP_SMTP_USER='erp@example.com'
export DBERP_SMTP_PASSWORD='replace-with-app-password'
export DBERP_SMTP_FROM='erp@example.com'
export DBERP_SMTP_TLS='true'
如果邮件服务使用 465 端口，通常采用隐式 TLS；587 端口则通常使用 STARTTLS。不要把真实密码直接写入镜像、Git 仓库或公开的部署脚本中，生产环境应使用密钥管理服务或受限权限的环境变量。
上线前可以用以下命令检查 SMTP 端口是否可达：
nc -vz smtp.example.com 587
端口可达不代表认证一定成功。还应发送一封测试邮件，检查发件人地址、收件人地址、TLS 协商、失败重试和日志中是否泄露认证信息。
本地部署与升级检查清单
本地部署授权能力适合需要在自有服务器运行系统的团队，但授权信息、服务器标识和备份恢复流程应由管理员统一管理。升级前建议完成一次可恢复的数据库备份，并在测试环境先走完整业务链路：采购入库、销售出库、销售退货、采购退货、核销和毛利查询。
可以按下面的顺序执行升级前检查：
- 记录当前 DBErp 版本、数据库版本和部署参数。
- 备份数据库，并在隔离环境验证备份能够恢复。
- 抽取一批代表性商品，记录库存数量、库存金额和平均成本。
- 选择包含折扣、退货和多次采购的销售单，记录升级前毛利结果。
- 在测试环境执行并发出入库和重复提交测试。
- 配置 SMTP 测试账号，验证成功、失败和超时场景。
- 确认主数据被业务单据引用时仍受到保护，避免升级后产生孤立引用。
- 生产升级后重新核对库存余额、退货结算、核销结果和关键报表。
是否值得升级
如果系统主要用于简单开单，v3.0.4 的收益可能集中在邮件通知和部署管理；如果企业依赖库存金额、销售毛利或高频库存操作，本次版本涉及的能力就更接近日常经营数据的基础设施。
升级判断不应只看版本号，而应看三组结果：库存数量与成本能否对上，销售与退货结算能否闭环，系统通知和本地授权能否稳定运行。对 DBErp 3.x 用户而言，建议先在测试环境完成数据抽样、并发验证和邮件联调，再安排生产升级窗口。