业务需求
需求描述

业务背景

。源文档说明当前该表最大 ID 已达到 17 亿以上,已经接近 int 类型最大值上限。如果继续使用 int 类型作为 ID 字段,后续新增日志可能触发自增溢出、写入失败、接口异常或日志链路中断,进而影响产品库操作追踪、问题排查和审计。

本次需求将 RB_Product_Log 表 ID 字段从 int 调整为 bigint,并同步更新 ERP、ErpApi、ErpWorker 中相关字段类型,确保数据库、服务端接口、后台任务和调用方字段类型一致。该调整是一次技术优化,但影响范围覆盖数据库结构、代码字段类型、接口序列化、任务处理、日志查询和发布回滚,需要按可验证步骤完成上线,避免字段类型不一致导致线上运行异常。

业务价值

提高人效:1.5/8*600*2人*30天=6750元/月

需求概述

文档地址:https://alidocs.dingtalk.com/i/nodes/m9bN7RYPWdlQ5DLZujynEZ7oWZd1wyK0?utm_scene=team_space

项目

内容

需求目标

将产品库日志表 RB_Product_Log 的 ID 字段从 int 调整为 bigint,并同步更新 ERP、ErpApi、ErpWorker 中相关字段类型;同时在智能备货 2.2 中排除产品库开发类型为“敏捷开品”的 SKU,仅允许其在 ERP 加载分析中产生订单需求。

目标用户

技术研发中心、产品库维护人员、智能备货业务人员、需要依赖产品库日志排查问题的研发和测试人员。

使用场景

系统持续写入产品库日志时,ID 不因 int 上限溢出而失败;ERP、ErpApi、ErpWorker 读写日志 ID 时字段类型一致;智能备货 2.2 执行分析时跳过“敏捷开品”SKU,ERP 加载分析仍可生成客户订单关联所需订单需求。

本期范围

1. RB_Product_Log 表 ID 字段 int 转 bigint;2. ERP、ErpApi、ErpWorker 相关字段类型同步调整;3. 字段调整前后数据校验、发布、回滚和监控;4. 智能备货 2.2 排除开发类型为“敏捷开品”的 SKU;5. ERP 加载分析保留敏捷开品订单需求生成。

非本期范围

不重构产品库日志业务逻辑;不清理历史日志数据;不变更 RB_Product_Log 之外的日志表字段,除非确认存在直接关联字段;不调整智能备货 2.2 除“敏捷开品”排除外的其他备货规则。

成功标准

RB_Product_Log 可继续写入 ID 超过 int 上限的日志数据;ERP、ErpApi、ErpWorker 不出现字段类型转换异常;智能备货 2.2 不为“敏捷开品”SKU 产生常规备货需求;ERP 加载分析仍可为敏捷开品 SKU 产生可关联客户订单的订单需求;上线后 5 天内完成验收。


验收标准

编号

验收项

前置条件

操作步骤

预期结果

异常校验

AC1

RB_Product_Log ID 字段类型调整完成

发布前已备份,DDL 已执行

查询 RB_Product_Log 表结构

ID 字段类型为 bigint

字段仍为 int 时验收不通过

AC2

存量数据无丢失

字段调整前已记录行数和最大 ID

对比调整前后行数和最大 ID

行数一致,最大 ID 不小于调整前记录值

行数不一致需暂停发布并排查

AC3

索引和自增配置正常

字段调整完成

检查 ID 相关索引、自增或主键配置

索引和自增配置可正常使用

索引缺失或自增异常验收不通过

AC4

ERP 支持 bigint 日志 ID

ERP 字段类型已发布

在 ERP 中写入或查询日志 ID 超过 2147483647 的数据

ERP 不出现类型溢出或转换异常

出现 int 溢出异常验收不通过

AC5

ErpApi 支持 bigint 日志 ID

API 字段类型已发布

调用包含 bigint 日志 ID 的接口

接口返回和调用方解析成功

序列化、反序列化或调用失败需记录缺陷

AC6

ErpWorker 支持 bigint 日志 ID

Worker 字段类型已发布

构造或等待包含 bigint 日志 ID 的任务

Worker 消费和处理成功

Worker 日志出现类型转换异常时验收不通过

AC7

日志写入链路正常

应用和数据库均发布完成

执行一次会产生产品库日志的业务操作

RB_Product_Log 新增日志成功

写入失败需记录业务操作、ID 值和异常堆栈

AC8

日志查询链路正常

存在 bigint 范围日志数据

查询产品库日志或相关后台数据

查询结果可展示或返回

查询失败或数据显示异常时验收不通过

AC9

回滚方案可执行

发布前已准备回滚脚本和应用回滚包

发布评审中检查回滚材料

回滚步骤、负责人和触发条件明确

无回滚方案不得上线

AC10

智能备货 2.2 排除敏捷开品

测试 SKU 的产品库开发类型为“敏捷开品”

执行智能备货 2.2 分析

常规订单需求中不生成该 SKU 的需求

若生成常规订单需求则验收不通过

AC11

非敏捷开品 SKU 不受影响

测试 SKU 的开发类型不是“敏捷开品”

执行智能备货 2.2 分析

按原有规则判断是否生成订单需求

非敏捷 SKU 被错误排除时验收不通过

AC12

ERP 加载分析生成敏捷开品订单需求

敏捷开品 SKU 具备客户订单关联数据

执行 ERP 加载分析

生成订单需求,采购单可关联对应客户订单

采购单无法关联客户订单时验收不通过

AC13

开发类型读取异常有记录

模拟 SKU 开发类型读取失败

执行智能备货 2.2 分析

系统记录读取失败原因

无日志或静默跳过时验收不通过

AC14

上线后 5 天内完成验收

功能上线

上线后第 5 天内执行验收清单

输出验收结果和问题清单

未完成验收需记录延期原因

价值描述
提高人效:1.5/8*600*2人*30天=6750元/月
历史记录  
  1. 2026-09-17 15:21:36, 由 曾翔 创建。
  2. 2026-09-17 15:21:49, 由 曾翔 编辑。
    修改了 所属计划,旧值为 "",新值为 "2784"。
    修改了 所处阶段,旧值为 "wait",新值为 "planned"。
  3. 2026-09-17 15:23:42, 由 杨林军 记录评审结果,结果为 确认通过。
    修改了 评审时间,旧值为 "0000-00-00",新值为 "2026-09-17"。
    修改了 指派给 ,旧值为 "yanglinjun",新值为 "ZengXiang"。
    修改了 当前状态,旧值为 "draft",新值为 "active"。
    修改了 由谁评审,旧值为 "",新值为 "yanglinjun"。
  4. 2026-09-17 15:31:48, 由 周杰 关联到迭代 主干_10月V1版本_20261008 。
  5. 2026-09-17 15:44:23, 由 何建宝 编辑。
    修改了 预计工时,旧值为 "1",新值为 "26"。
    修改了 成本 ,旧值为 "500",新值为 "13000"。
    修改了 ROI ,旧值为 "81.00",新值为 "3.12"。
  6. 2026-09-17 17:56:48, 由 何建宝 编辑。
    修改了 预计工时,旧值为 "26",新值为 "28"。
    修改了 成本 ,旧值为 "13000",新值为 "14000"。
    修改了 ROI ,旧值为 "3.12",新值为 "2.89"。
  7. 2026-09-20 09:37:57, 由 周杰 编辑。
    修改了 计划验收时间,旧值为 "0000-00-00",新值为 "2026-10-10"。
  8. 2026-09-20 17:22:35, 由 刘超 编辑。
    修改了 测试人员,旧值为 "",新值为 "nongjiwang"。
  9. 2026-09-21 16:08:40, 由 何建宝 编辑。
    修改了 预计工时,旧值为 "28",新值为 "32"。
    修改了 成本 ,旧值为 "14000",新值为 "16000"。
    修改了 ROI ,旧值为 "2.89",新值为 "2.53"。
  10. 2026-10-09 09:36:25, 由 农基望 编辑。
    修改了 所处阶段 ,旧值为 "tested",新值为 "released"。
    修改了 设置阶段者,旧值为 "",新值为 "nongjiwang"。
  11. 2026-10-09 09:37:02, 由 周杰 编辑。
    修改了 所处阶段 ,旧值为 "released",新值为 "bepending"。
    修改了 设置阶段者,旧值为 "nongjiwang",新值为 "zhoujie"。
  12. 2026-10-10 13:55:02, 由 杨林军 编辑。
    修改了 所处阶段,旧值为 "业务验收中",新值为 "业务验收通过"。
    功能验收:验收通过
    满意度:满意
    价值验收:基本达成
    原因备注:无
  13. 2026-10-19 09:14:16, 由 周杰 关闭,原因为 已完成 。
    修改了 由谁关闭,旧值为 "",新值为 "zhoujie"。
    修改了 关闭日期,旧值为 "0000-00-00 00:00:00",新值为 "2026-10-19 09:14:12"。
    修改了 指派给 ,旧值为 "hejianbao",新值为 "closed"。
    修改了 当前状态,旧值为 "active",新值为 "closed"。
    修改了 所处阶段,旧值为 "verified",新值为 "closed"。
    修改了 关闭原因,旧值为 "",新值为 "done"。
迭代版本
提报业务部门 技术研发中心
提报人员 何建宝
需求来源 技术自主提报需求
所属项目 技术中心-需求池
所属模块 供应链   产品采购   产品库
所属计划
业务价值
开发组 产品采购开发组
受益业务部门 技术研发中心
验收人员 杨林军
业务目标类型
中心业务目标
业务价值 提升人效
每月价值量 6750
每月节省人数 14
优先级 P2
价值类型 长期价值
预计工时 32
成本 16000
ROI 2.53
操作手册 否
高价值 -
主被动 被动接收
复杂度 一般性
工作流ID
工作流创建时间 0000-00-00 00:00:00
更新点
是否高危 否
评分 59.3
当前状态 已关闭
所处阶段 已关闭
关键词
评审次数 一次
计划上线 0000-00-00
上线时间 2026-10-08
计划验收时间 2026-10-10
业务验收时间 2026-10-10 13:55:02
满意度 满意
价值验收 基本达成
满意度分值 80
业务回填价值
验收达成价值 32400.0
验收达成ROI 2.02
抄送给
由谁创建 曾翔 于 2026-09-17 15:21:36
指派给 Closed 于 2026-10-19 09:14:12
由谁评审 杨林军
评审时间 2026-09-17
由谁关闭 周杰 于 2026-10-19 09:14:12
关闭原因 已完成
最后修改 周杰 于 2026-10-19 09:14:12
相关Bug
相关用例
相关需求
细分需求