2026-07-06 工作日志

业务数据与项目进展周会

本次会议回顾了业务数据与项目进展，讨论了各模块问题及后续排期，并明确了多项待办事项。

小结

1. 业务数据与项目进展回顾

• 业务数据: 全国应用的回调率及出货率数据显示，整体呈下降趋势。
• 项目进展: 各模块同步了近期工作进展，包括活动中心、智慧门店、后端监控、数据一致性及云平台等。

2. 主要问题与风险

• 数据不一致: 合流中心数据显示，23 类数据中仅 2 类对齐，其余存在差异；SFA PDA 因扫码速度快于 1 秒导致数据错乱。
• 门店同步问题: 新增门店后，因与营销活动中心存在约 1 小时的同步间隔，导致前端无法获取门店信息。
• PDA 扫码问题: PDA 设备在短时间内连续扫码，因未校验单据号导致数据重复提交或丢失。
• 性能瓶颈: 大批量物码（超 500T）提交时存在性能瓶颈。

3. 后续规划与排期

• 7 月底版本: 计划于 7 月 7 日完成 PRD 封版，7 月 14 日完成开发。
• 门店中心服务切换: 长期方案将切换至门店中心服务，排期预计在 9 月或 10 月初。
• APM 监控: 将与原厂对比，评估引入新 APM 厂商的成本与必要性。

待办

1. 数据权限需求优化

• 李赵丹需在今天内再次组织内部会议，以确认方案。

2. 门店中心服务切换

• 任铭需向骄阳获取服务切换项目的排期。

3. APM 监控方案评估

• 张建利需在本周内安排演示，以便团队评估原厂 APM 方案。

4. PDA 扫码问题跟进

• 吴菊需将 PDA 连续扫码的极限场景补充到测试用例中。

5. 7 月底版本需求对齐

• 李亚洲需在今天内组织各端对齐 7 月底版本的需求。

6. 门店同步问题优化

• 刘晓娜需与吴菊沟通，确认是否需要前端传递更多辅助信息以解决门店同步问题。

7. 730 版本排期

• 各端需在今天内复核 730 版本范围，以便给出更准确的排期。

8. 代码检查标准统一

• 吴菊需组织相关同学对"before after"检查方式进行培训。

9. 门店分类分级改造评估

• 吴菊需与赵薇 Ivy 对齐，各端评估门店改造的系统改造点。

10. 物码性能瓶颈

• 吴菊需跟进并给出批量物码提交的性能瓶颈解决方案。

11. 问题监控与复盘

• 各端需从今天起对已上线的健康度规则进行密集监控。
• 李亚洲需在一周后组织复盘，总结本次发版的问题与数据表现。

12. 项目管理工具评估

• 吴菊与赵薇 Ivy 需评估 PM 系统是否能满足项目每日粒度的跟进需求。

13. 市场实测安排

• 李亚洲需跟进安排周二的市场实测。

查证明细表改造与电子围栏优化评审会

会议讨论了查证明细表改为主键表的技术方案、数据迁移策略及风险，并审阅了电子围栏功能的并发优化方案。

小结

1. 查证明细表改造方案

• 背景: 当前查证明细表为非主键表，存在历史数据重复问题，需改造为主键表。
• 方案: 创建一张新的主键表，将历史数据直接导入，无需手动去重。新表将使用订单 ID、追溯码和扫码时间作为主键，并采用按月分区。
• 数据迁移: 为确保数据一致性，将暂停写入服务，先将历史数据迁移至新表，再将增量数据同步，最后切换表名。
• 字段更新: 新建的主键表需增加 update_time 字段，以便中台服务后续根据时间戳同步增量数据。

2. 电子围栏功能并发优化

• 问题: 当前定时任务在处理过期单据时，缺乏二次校验，存在因并发操作导致误删单据的风险。
• 优化方案: 在定时任务中增加二次校验机制。任务执行时，先获取目标单据的最大过期时间，再进行二次查询确认，只有两次校验结果一致才执行后续的过期释放操作。
• 补充措施: 除了二次校验，还提出了增加延迟过期配置和任务休眠等手段，以进一步降低并发风险。

待办

1. 查证明细表改造

• 在建表语句中补充字段的中文注释。—— 粱健
• 在新表中增加 update_time 字段，并确保中台服务能根据此字段进行增量数据同步。—— 粱健
• 准备相关技术材料，以便在 7 月 9 日的版本发布中进行上线。—— 粱健

2. 电子围栏功能优化

• 整理并提交并发优化方案的相关材料，以便安排单独的发布窗口。—— 张喜

---

查证明细表改造与电子围栏优化评审会（详细记录）

会议主题：查证明细表改造与电子围栏优化评审会 发言人：粱健、张喜、贾继伟、朱学通、王建朝等7人 会议摘要：本次会议评审了查证明细表改造方案，确认了基于主键的自动去重逻辑及不停服迁移策略，优化了电子围栏的并发校验机制，并决定将相关代码修复提前至今日发布。

一、查证明细表改造方案评审

针对查证明细表（非主键表）存在的重复数据问题，会议对改造方案进行了详细评审，并确定了最终执行策略：

1. 表结构设计与字段规范

• 主键定义与分区策略：新表将采用“uid（订单ID）+ 追溯码 + 扫码时间”作为联合主键，利用表达式分区按月切分，副本数保持与原表一致（3个副本）。
• 字段长度与编码规范：针对字段长度定义（如 varchar(255)），朱学通指出在 StarRocks 中该长度代表字节数而非字符数，需注意中文字符占用问题。经确认，现有长度设计符合业务需求，无需修改。
• 新增字段与注释：为支持中台增量同步，新增 update_time 字段（初始值设为扫码时间），并要求补充所有字段的 comment 注释，以避免后续维护困难。

2. 数据迁移与去重策略

• 去重逻辑优化：原方案计划手动清洗历史重复数据。朱学通指出主键表具备自动去重特性，只需通过 INSERT INTO 语句一次性导入原表数据，数据库会自动根据主键剔除重复记录，无需编写复杂的去重逻辑。
• 不停服迁移方案：鉴于数据量约 1000 万且增长缓慢，决定采用不停服方案。先创建新表并同步全量数据，随后在极短时间内暂停 MQ 消费服务，切换表名后恢复服务，由程序自动处理切换期间的少量增量数据。

二、电子围栏定时任务优化

张喜汇报了电子围栏定时任务中存在的极端并发风险及修复方案：

1. 风险识别与根因分析

• 极端并发导致误删：原逻辑在 5 分钟定时任务中，仅根据单号最大时间直接执行过期释放，未做二次校验。在极端并发场景下（如查询后、删除前瞬间写入新数据），可能导致有效数据被误判为过期并释放。
• 业务影响：误释放会导致单号下码数量异常（如预期 100 个码，实际仅剩 1 个），影响前端展示与业务逻辑。

2. 防御机制升级

• 二次校验机制：新方案在查询到待过期单号后，增加一次数据库查询进行二次校验，确认数据状态未变更后再执行归档与删除操作。
• 延迟释放配置：结合现有的延迟过期配置（默认 10 分钟），进一步降低并发冲突概率。虽然无法做到 100% 防并发，但可将风险从 99% 提升至 99.9%。

三、其他业务对齐与澄清

1. 盘点明细表状态确认

• 无回补任务确认：经孙传熙与粱健核对，确认盘点明细表属于主键表，数据落表后即为最终状态，不存在定时回补或更新任务，仅需关注全量拉取。

2. 发布计划调整

• 紧急修复发布：鉴于电子围栏优化涉及潜在的数据丢失风险，决定不等待 7 月 9 日的统一发版窗口，计划于今日晚间单独发布修复代码。

四、待办事项

• 整理电子围栏优化的相关说明材料，准备今日晚间单独发版。 @张喜
• 补充查证明细表新表的字段 comment 注释。 @粱健
• 确认盘点明细表是否存在回补任务，以便后续优化近实时数据拉取。 @粱健

---

查证字段配置功能评审会

本次会议评审了查证字段配置功能，明确了出货与签收数量的展示逻辑、数据来源及不同签收类型的处理方式。

小结

1. 查证字段配置功能

• 背景: 为满足业务需求，需在营销活动中心后台配置“出货数量”和“签收数量”字段，以便在前端扫码查证页面展示，方便一线人员核对货量与签收情况。
• 配置方式: 后台将提供独立开关，用于控制“出货数量”和“签收数量”字段是否在前端工具（如巡查管家、营销助手等）的扫码查证页面展示。

2. 数据展示逻辑

• 出货流向: 仅展示“出货数量”，不展示“签收数量”。
• 签收流向: 仅展示“签收数量”，并将其拆分为“应签收数量”、“签收成功数量”和“签收失败数量”三个子项。
• 数据来源: 出货数量和签收数量均以扫码码对应的产品编码（SKU）为维度进行统计。

3. 签收类型处理

• 不展示的签收类型: “盘点签收”和“查证签收”产生的流向信息，不在前端工具的扫码查证页面进行展示。
• 包含的签收类型: “自主签收”和“代门店签收”产生的流向信息，将被纳入前端展示范围。

4. 历史数据处理

• 系统将实时计算并展示各流向的历史数据，无需进行数据刷新。对于历史数据中的签收状态，若当时系统未区分“成功”与“失败”，则默认展示为“成功”。

待办

1. 前端测试支持

• 测试同学在进行测试时，若需核对签收数量的具体数据，可联系技术同学协助查询数据库。—— 刘莉

2. 后端代码逻辑调整

• 后端需根据会议结论，调整现有逻辑，确保“盘点签收”和“查证签收”不被计入前端展示的签收数量中。—— 陈德智

3. 版本兼容性处理

• 后端需评估并确定在715版本中，如何兼容未来新增的“分享链接签收”等类型，倾向于采用“包含”而非“排除”的逻辑，以便于后续维护。—— 宋洋

---

7月底版本需求对齐会

本次会议对齐了7月底版本的需求范围，讨论了签收优化、盘点改造、前端兜底方案等核心内容，并明确了各模块的排期与风险。

小结

1. 7月底版本需求范围

• 签收链路优化: 包括扫码查证及签收、盘点及签收的优化，以及智慧门店与小智通过列表进行签收的功能。
• 盘点及提交: 各端将取消使用盘点单，改为扫码直接提交。
• 前端兜底方案: 在出货、退货、调拨、盘点等场景下，将隐藏OCR识别和手工录入功能，此为配置项。
• 前端必传字段: 需梳理并明确各场景下前端需要向后端传递的必传字段。

2. 版本排期与风险

• 整体排期: 后端版本计划7月30日上线，8月1日全国推广。
• 风险点: 各端需关注自身资源排布，特别是SFA出货端、营销活动中心等模块的开发排期紧张。
• 数据看板: 因渠道基建与物码看板的首页方案尚未达成共识，其上线时间存在不确定性。

3. 其他待办事项

• PDA翻拍作弊: SIV端已完成开发，需进行测试并向事业部通报。
• 调拨数据报表: SIV已有相关数据，但尚未制作报表。调拨功能因政策原因需保留，此项工作可延后至8月。

待办

1. 前端必传字段梳理

• 各端需梳理并明确前端需要向后端传递的必传字段，形成清单以便统一处理。—— 李亚洲
• 将梳理后的字段清单在今天内发出，供各方确认。—— 李亚洲

2. 数据看板方案

• 需尽快拿出数据看板的最终方案，并推动决策。—— 李亚洲

3. 排期协调

• 针对营销活动中心开发延期导致集成测试时间推迟的风险，需协调各方资源，争取将集成测试时间提前。—— 任铭、李亚洲

4. 电子围栏需求跟进

• 需跟进电子围栏新PRD的最终版，并与相关方对齐方案与时间节点。—— 李亚洲