奥印ERP

成都奥印商贸有限公司内部系统

线上验收报告

服务器部署、HTTPS、服务隔离、业务流、POS和渠道接口验收结果。

奥印ERP线上部署与验收报告

验收时间：2026-06-10 17:06（Asia/Shanghai）

补充验收：2026-06-10 20:03（Asia/Shanghai），完成开放平台账号制库存锁定、确认扣减、POS离线默认关闭复验。

一、部署结论

奥印ERP已独立部署到阿里云服务器 8.222.231.204，域名为：

最终结论：通过。官网、ERP前端、后端API、数据库、Redis、HTTPS、文档、进销存业务流、小程序货盘API、POS收银、渠道订单转ERP均已验收通过。

二、独立部署边界

本次部署全部放在独立目录：

已确认没有改动旧项目：

三、部署与加固结果

运行环境：

端口与暴露面：

权限：

四、线上功能验收

基础访问：

节点 结果
https://aolaierp.com/ 官网 200 OK
http://aolaierp.com/ 自动跳 HTTPS 301 OK
https://aolaierp.com/erp/ ERP前端 200 OK
https://aolaierp.com/jshERP-boot/doc.html API文档 200 OK
https://aolaierp.com/docs/api-guide.html API对接教程 200 OK，在线教程页
https://aoyingroup.com/ 旧站 200 OK，未受影响

业务流验收：

验收项 结果 关键凭据
登录获取Token 通过 用户 aoyin
采购入库 通过 CGRK00000000673
销售出库 通过 XSCK00000000674
库存回写 通过 商品条码 1001，库存从 0 到 1 再回到 0
小程序货盘保存标题/图片/价格/详情 通过 商品ID 568，图片数量 3
小程序公开列表/详情/库存/分类 通过 companyId=63
自动上下架 通过 下架隐藏、上架恢复
POS扫码 通过 条码 1003
POS收银生成零售出库 通过 LSCK00000000675
渠道订单接收 通过 渠道 douyin-live，外部单号 AUTO-20260610165916
渠道订单转ERP单据 通过 LSCK00000000676
开放平台API账号创建 通过 独立 appKey/appSecret，按渠道授权
签名商品库存查询 通过 /open/material/stock，HMAC-SHA256
下单锁库存 通过 RESERVED 后可售库存 1 -> 0
取消释放库存 通过 CANCELLED 后可售库存 0 -> 1
确认扣库存 通过 CONFIRMED，生成 LSCK00000000680，库存 1 -> 0
POS离线默认关闭 通过 /pos/config.offlineModeEnabled=false，/open/pos/mode.offlinePosEnabled=false

五、发现并处理的问题

1. Windows zip包路径问题 现象：Linux解压后静态目录没有完整释放。 处理：改用 tar.gz 打包，并重新同步官网、前端、文档。

2. 线上登录验证码阻塞自动验收 现象：登录接口返回“验证码不能为空”。 处理：将 jsh_platform_config.checkcode_flag 改为 0，并同步修改初始化SQL，内部系统默认不再启用验证码。

3. POS验收并发抢单据号 现象：三组脚本并发运行时，POS生成单据号偶发失败。 处理：POS/渠道脚本改为单独顺序验收，已通过。

4. 文档链接下载而不是预览 现象：Markdown返回 application/octet-stream。 处理：Nginx /docs/ 增加 Markdown 文本类型，现可直接打开阅读。

5. 未来重部署可能覆盖HTTPS 现象：初版部署脚本会写HTTP版Nginx配置。 处理：部署脚本已改为证书感知模式；如果证书存在，会写 HTTPS + 80跳转配置。

6. 离线收银与负库存风险 现象：门店离线时不能实时扣减服务器库存，如果其他渠道同时销售，恢复网络后可能出现库存冲突。 处理：新增 POS 离线单同步表和外部单号幂等校验；收银台离线时本地暂存，联网后同步到 /pos/checkout；后端关闭负库存开关，并按 ERP 单据流水实时校验库存，不再依赖可能滞后的库存缓存。 线上复验：/pos/scan 条码 1001 成功返回商品；库存为 0 时提交离线同步单，接口返回“库存不足，已阻止出库”，未生成出库单，未留下待同步脏数据。

7. 开放平台签名与库存口径不一致 现象：签名验收脚本误用本地时区时间戳会被 10 分钟窗口拒绝；同时商品库存展示曾使用缓存库存，而锁库存使用单据流水实时库存。 处理：签名校验兼容公网完整路径和应用内路径；POST 签名改为按原始 HTTP body 校验；开放平台库存接口统一改为 ERP 单据流水实时库存。 线上复验：真实签名请求 /open/material/stock 返回 200，库存口径与锁库存一致。

8. POS渠道字段长度不足 现象：较长开放平台渠道名在确认扣库存时写入 jsh_pos_order.channel 被数据库拦截。 处理：jsh_pos_order.channel 从 varchar(32) 扩为 varchar(64)，并在启动建表校验中加入自动修复。 线上复验：渠道 verify-open-confirm-final-20260610200313 确认扣库存成功，生成 LSCK00000000680。

六、交付物

七、上线后建议