加分笔记

ERP 开发

报工数据只留一个入口:POST /api/erp/work-reports

小程序、车间终端、后台补录,如果各写各的接口,账迟早对不上。

报工数据只留一个入口:POST /api/erp/work-reports

(先说清:报工属于制造那套 ERP,和管销售的那套不是一个系统。)车间报工这件事,最危险的做法是"谁方便谁自己写一套接口"。小程序写一个、终端写一个、后台再补一个——三条路进同一个账,迟早对不上。

做法:只留一个入口

把报工统一收口到一个接口上(我们用的是 POST /api/erp/work-reports),所有来源都打这一个口:小程序是它,车间设备是它,后台补录也是它。

好处很直接

  • 校验只写一遍。数量、工单、人员、时间的规则集中在一处,不会出现"这个入口能过、那个入口过不去"。
  • 可追溯。所有报工记录在一个地方,来源标记清楚,查问题不用满世界找。
  • 改规则安全。以后要加字段或加限制,只改一处,不会漏掉某个客户端。

配套要做的两件事

  • 幂等:车间网络不稳,同一条报工可能重复提交。要有唯一键或去重逻辑,否则会重复计数。
  • 可回退:报错了要能撤。撤单不是删记录,是走一条反向流程(红冲思路),留下痕迹。
一个入口,一套校验,一条可追溯的线——报工数据才敢拿去考核。