Work for YILI

Appearance

2026-10-09 工作日志 ​

物码早会 ​

主题：聚焦营销助手与营销中心 UAT 前的测试问题排查、进度评估及上线排期，明确多端并发扫码异常处理方案、活动模板改动评估，敲定 14 日启动业务方参与 UAT。

小结 ​

1. 营销助手测试问题

  • 双设备并发扫码异常：A 设备参加盘点任务后暂停，B 设备结束任务时 A 设备仍可扫码；需前端在每次扫码时调用任务完成状态接口，待拉技术监理与活动中心共同评估。
  • 后端兜底方案变更：原前端兜底方案改为由后端报错接口拦截，前端仅在开始任务时调用接口检查是否报错，无需每次选择任务时调接口。
  • 测试人员配合调整：因前期部分测试人员支援奶酪活动集成导致延期，目前需协调新入场测试人员优先紧着夜奶进行测试。

2. 营销活动与测试进度

  • 活动售卖触发方式偏差：活动模板实现方式与 PRD 要求存在较大差异，爱创团队今日评估并计划今天调完改动，具体改动大小待评估后决定 UAT 时间。
  • UAT 时间初步定档：当前 UAT 初步定于 12 月 14 日（疑为 10 月 14 日，与开头摘要「14 日启动业务方参与 UAT」一致），待今日整体测试反馈后最终确认并邀请业务方参与。

3. 系统数据一致性修复

  • 门店及经销商数据：门店与经销商关系数据一致性问题已推动，预计 10 月 15 日上线解决；门店人员角色差异的数据清洗工作已安排系统资源推进。
  • 小智系统与内部基础数据：小智系统产品与导购一致性问题已确认排期，预计 10 月 15 日完成功能上线；涉及 3 个接口的内部人员基础数据关系数据新增需求按计划在推，预计 10 月 29 日上线。

4. 监控问题分析及其他事项

  • 线上监控问题跟进：7 号三（疑为周三）和 7 号六（疑为周六）的线上监控问题正在做原因分析，需安排在今日排期分析并同步调整方案。
  • 营销围栏需求实施：营销活动中心关于 5 段围栏及经销商围栏放开限制的需求在实施中，计划 10 月完成开发联调和上线；今日将与建新沟通 P1/P2 级数据一致性问题的处理计划。

待办 ​

  • 将营销助手后端兜底方案的结论发至群内同步 — @郑然
  • 针对双设备并发扫码问题，拉技术监理并与活动中心一块讨论评估前后端处理方案 — @郑然
  • 验证双设备扫码问题是两个不同账号还是一个账号的问题 — @王琪
  • 上午拉会确定活动售卖触发方式的改动方案，并于今天调完 — @陈娜娜
  • 内部协调新入场的测试人员，明确如何配合后续测试任务 — @陈娜娜
  • 对 7 号三和 7 号六两个线上监控问题进行原因分析，并排期调整方案 — @陈娜娜 @建新
  • 今日与建新沟通营销活动中心 P1/P2 级数据一致性问题的处理计划 — @陈娜娜

BRD 评审模块 MCP 能力建设（个人交付） ​

围绕「把 BRD 评审能力开放给 AI 工具（Tool Hub / workbuddy 等）」完成从 MCP 化到规范合规、再到稳定性修复的整体交付。

完成的功能与优化 ​

1. BRD 评审模块 MCP 化 ✅

  • 挂载 MCP Server（Streamable HTTP，/api/mcp），把评审能力封装为 5 个语义化工具：brd_review_submit / wait / result / items / list；涉及文件 McpServerConfig.java、BrdReviewMcpTools.java。

2. MCP 接入凭证自助签发（PAT） ✅

  • 解耦「MCP 接入凭证」与「登录 JWT」：mcp_ 前缀 + 32 字节随机 Base64URL，仅存 SHA-256 哈希；多来源令牌提取（Authorization: Bearer → X-API-Key → ?token=），PAT 优先、回落 JWT；新增 /mcp-access 自助签发页。解决小白用户拿不到 JWT、AI 工具难配置的问题。

3. AI 模型枚举治理 ✅

  • 提交评审的 aiModel 改为枚举 + 运行时校验，默认模型配置化，并通过 5 分钟定时任务刷新工具 schema，保证系统配置模型变更后自动同步。

4. Tool Hub 接入规范合规改造 ✅

  • 通读《Tool Hub 接入规范 V1.0》产出合规分析报告并落库 docs/；实施错误处理分层（协议层 McpError + 核心错误码）、GET /mcp/health 健康检查、工具描述三要素、统一 {success,data} 返回包装。

5. 评审报告解析降级修复 ✅

  • 定位「blockerCount/warningCount=0 但正文有 6+6+3」根因：ReviewReportParser 硬编码严重程度标题为 ###，模型输出 ## 层级漂移导致整体解析失效并静默降级为单条 NOTICE。改为按标题语义识别（兼容 #{1,6} 任意层级 + 中英文 + emoji）并排除条目级编号标题；新增解析质量标记 brd_task.parse_status（OK/DEGRADED）经 MCP/接口透出，消除静默降级；prompt 增加标题层级硬约束。

6. MCP 双通道身份解析 ✅

  • 支持平台在工具参数中注入身份（oaCode 优先、userInnerNum 兜底 → 本系统 username＝工号），HTTP 令牌（PAT/JWT）作为回落；5 个工具 schema 声明身份字段（不 required）；冲突时以参数为准并告警。实测 5 项 MCP 回归全部通过。

小结 ​

  • 交付合入分支 mcp-wjc-260929，提交 60ee0d7（BRD 评审 MCP 对齐 Tool Hub 规范并修复报告解析降级）。
  • 配套文档：docs/AI工具接入BRD评审MCP操作手册.md、docs/MCP能力生产发版手册.md、docs/BRD-MCP-ToolHub接入规范合规分析报告.md。
  • 关键认知：解析器不能硬编码模型输出的格式层级，应按语义识别并显式暴露解析质量；MCP 身份应支持「平台注入优先 + HTTP 令牌回落」双通道以兼容不同接入方。