Skip to content

2026年第37周工作周报(9.7-9.13) ​

本周(9.7-9.10,周四)截至目前共完成 10 场技术评审,其中 1 场(券中心ECC)文档正文因敏感内容审批超时未返回、待补。9.11-9.13 待补充。 本周工作全部为技术方案评审,无需求评审与测试用例评审。

一、营销活动中心 ​

本周营销活动中心共完成 7 场技术方案评审,主线集中在「保障码数据与报表的准确性、完整性」:一是新增采集与落库(B端扫码拦截明细 scan_error_info 落库、TTS 解析新增保质期字段 shelfLifeDate 落 code_info);二是数据修复与兜底(盘点失败消息重投 rocket_error_log、B端出货明细表退货地址修复、消费者中奖明细表产品信息修复 358 条空字段回填),延续「先堵漏再修数」的治理思路;三是 SFA 报表字段扩展(B端出货明细表新增 17 项、盘点明细表新增 13 项展示字段)。7 场中 3 场通过、4 场有条件通过——有条件通过项共性集中在:产品状态实时读取口径、签收类型数据生产方案尚未就绪,以及核销中奖链路根因(data 异常仍写空字段)未纳入本期修复,需在实施前对齐 PRD 口径并明确数据侧就绪节奏。

技术方案评审:

  • 09-07 扫码错误记录表(scan_error_info):通过。 新增 B 端扫码拦截明细落库(Mongo,自定义线程池异步写入、不阻塞主流程),支撑拦截原因分析、经销商行为分析与异常追责;采集数据供数据中台统计分析。跟进项:补充 Mongo UTC 时区说明、埋点采用侵入式而非解耦的评估结论、留存测试环境自测记录(@张喜)。风险:测试环境缺 TTS 中间表,关联分析需上线后验证;落库失败不重试,极端情况可能丢失少量拦截数据。

  • 09-08 盘点失败消息重投方案(rocket_error_log):有条件通过。 9 月初 SR 库资源不足致部分盘点消费链路超时,9/1 至今约 18000+ 条盘点明细未落报表库;方案为离线解析腾讯云失败日志 → 写入 Mongo rocket_error_log → XXL-Job 加分布式锁、按 _id 游标分批重投 RocketMQ → 消费端重走正常链路,落库前按 check_id + trace_code + take_stock_day 去重。前置条件:先在测试环境验证消息队列导入可行性,若可行则本次不发版、后续统一走导入方式(@李明非)。待办:确认 SR 库资源已恢复、输出重投结果(总/成功/失败条数)、统计 9/1-9/8 期间门店/经销商状态变更占比(@余勇军)。

  • 09-09 B端出货明细表退货地址修复:通过。 9/2 高德逆地理编码异常致 return_address 为空,新增第三个独立 XXL-Job fixShipmentReturnAddress(窗口 9.2-9.4,待修复 42031 条),复用既有基建(keyset 游标分批、令牌桶限流 QPS≤5、两级坐标缓存),经 StarRocks Stream Load 列模式仅覆盖 return_address。待办:云商报表产品状态读取由直连 Mongo 改 RPC、确认 PRD、建备份快照、按小时间片试跑后全量、手动注册 handler(@潘玉平)。

  • 09-09 TTS解析新增保质期字段:通过。 TTS 关系码解析链路新增 shelfLifeDate(箱码行第 7 列、提/内码块第 10 列),落 code_info;TTS 未传时按产品信息(生产时间 + 保质期时长 + 单位)预算兜底。待办:明确 Redis 缓存 key/过期/空值策略、TTS 未传兜底口径与历史 code_info 字段回填方案。

  • 09-09 消费者中奖明细表产品信息修复:有条件通过。 806 发版(8/6 上线)后 data 服务异常致 redemption_his 358 条 brand_name/product_no/product_name/product_date 为空;按 trace_code 匹配 code_info 回填四列并建备份表 redemption_his_bak_20260910。决议:SQL 加分区字段避免全表扫描、精简冗余 WHERE、改用"先入临时表再更新原表"。风险:根因(核销中奖链路在 data 异常时仍写入空字段)未纳入本次修复,同类异常再次发生仍会产生空字段数据。

  • 09-09 SFA-B端出货明细表优化:有条件通过。 B 端出货明细报表新增经销商签收/门店领奖/返利提现/活动等共 17 项展示字段;StarRocks 宽表 shipment_report_details_v2 除「产品状态」外相关列已就绪,改动集中在 SFA 导出与分页展示层(共用 SQL 片段 shipment_report_detail_clumns2 补 3 列 → ShipmentReportDetailV3Vo 新增 16 项 → 手机号解密脱敏、活动类型枚举转中文 → 导出与 /pro-flow-detail-v2 分页同步回填回归)。决议:产品状态改为实时展示,由直连 Mongo 改 RPC 调用(@潘玉平)。风险:产品状态实时读取(每次检索走 MongoDB)与整改 B 端出货明细表处理逻辑口径不一致,存在歧义,需更新 PRD 共识。

  • 09-09 SFA-盘点明细表优化:有条件通过。 ISV 盘点明细表分页(/isv/inventory-detailed)与异步导出(/isv/inventory-detailed-export)新增 13 个展示字段(货权经销商/盘点定位/门店仓库授权判定/B 端签收),其中 12 个盘点宽表 freshness_detail_report 已落库、仅展示导出层补齐;仅「签收类型」需补读取链路(DTO 加 signType、resultMap 与两条 SELECT 补 sign_type)。决议:依赖 freshness_detail_report.sign_type 字段数据处理方案(近期无计划推进),建议等字段处理与历史数据回补执行后再实施。风险:签收类型数据生产(加列/写库/历史回补)不在本方案范围,数据侧未就绪将导致读取为空或报错,存在上线节奏依赖。

需求评审: 本周无 测试用例评审: 本周无

二、活动计费管理 ​

技术方案评审:

  • 09-08 计费积分功能调整技术方案:通过。 积分体系新增门店维度(7 张表 6 张调整,其中 5 张在原有维度上新增门店维度、积分兑换单据表从积分池继承),支撑基于销售底座的门店级数据权限;数据权限统一新增销售五段做筛选隔离。对外接口同步调整:账户汇总余额/积分明细流水接口新增门店维度(非必填)、一阶段冻结积分接口门店编码由可选改必填;券核销回调新增"核销门店/人员与发放一致"校验,券列表展示维度由"仅人"改为"门店+人"。风险:门店归属主数据不准将直接影响核销与券展示;各相关端需逐项确认接口变更(@孔玮 等)。

需求评审: 本周无 测试用例评审: 本周无

三、渠道营销底座 ​

技术方案评审:

  • 09-08 门店地址层新增二级渠道类型:通过。 液奶新活动(PRD 5.2)需按门店二级渠道类型筛选/约束,shop_address 表新增 channel_sub_type / channel_sub_type_name 两列,主数据全量推送初始化(门店 1600 万+,无法指定更新),数据清洗完成后再加联合索引。决议:底座与老营销活动各维护一份技术方案(@郝梓斐);加索引前拉云平台 DBA 宗杨专项评估锁表影响(@李明非);字段长度(当前 varchar(100))与主数据确认后再定(@郝梓斐)。风险:全量推送叠加加索引数据库压力大、可能锁表(历史有故障);二级渠道类型约 200 种分布不均,索引区分度存疑;测试环境数据不全,索引效果需接入生产真实数据后验证。

需求评审: 本周无 测试用例评审: 本周无

四、券中心(ECC) ​

技术方案评审:

  • 09-09 券中心接口调整:⚠️ 待补充。 该评审文档正文本次读取因敏感内容审批超时未返回,按系统约束未做推断。建议重新授权读取后补全结论与风险项。(源文件:20260909-技术评审-券中心ECC-券中心接口调整.md)

需求评审: 本周无 测试用例评审: 本周无


附:本周评审清单(按日期) ​

日期项目评审主题结论
09-07营销活动中心扫码错误记录表(scan_error_info)通过
09-08营销活动中心盘点失败消息重投方案(rocket_error_log)有条件通过
09-08活动计费管理计费积分功能调整技术方案通过
09-08渠道营销底座门店地址层新增二级渠道类型通过
09-09营销活动中心B端出货明细表退货地址修复通过
09-09营销活动中心TTS解析新增保质期字段通过
09-09营销活动中心消费者中奖明细表产品信息修复有条件通过
09-09营销活动中心SFA-B端出货明细表优化有条件通过
09-09营销活动中心SFA-盘点明细表优化有条件通过
09-09券中心(ECC)券中心接口调整待补充(内容读取受限)

范围说明: 9/3 的 4 场技术评审(Job表新增 sub_type 字段、盘点明细报表仓库名称兜底、码流向解析顺序问题修复、销售区域与行政区域关系经销商经营围栏状态校验)属第 36 周(8.31-9.6),未纳入本周报;如需并入请告知。