营销助手门店查询 Bug 修复评审会议纪要

会议时间：2026-06-17

发言人：张喜、王建朝、马奇、张建利、贾继伟

会议摘要：本次会议评审了营销助手门店查询因特殊字符过滤导致的编码匹配失效 Bug，确认了拆分处理逻辑的修复方案，并针对前端交互体验与后端性能优化提出了改进建议。

一、Bug 根因分析与修复方案

1.1 故障根因定位

问题	说明
特殊字符处理逻辑缺陷	为兼容门店名称中的特殊字符（如括号），后端使用 MongoDB 函数对输入参数进行统一过滤，导致传入的纯数字门店编码被误处理，无法精确匹配
业务场景掩盖问题	用户习惯使用门店名称模糊搜索，极少使用编码精确匹配，导致 Bug 在线上环境潜伏较久，直至近期内部测试才被发现

1.2 修复方案确认

逻辑拆分策略：将查询逻辑拆解。门店编码（Shop ID）采用精确匹配（等于查询），门店名称采用模糊匹配并使用函数包装以兼容特殊字符，避免相互干扰。
测试环境验证：确认测试环境已在 5 月份完成修复且验证通过，目前仅生产环境因未发版存在代码不一致问题。

二、交互体验与性能优化建议

2.1 前端交互改进建议

输入框功能解耦：建议前端将输入框改为仅支持门店名称模糊搜索，避免用户输入难以记忆的纯数字编码，提升易用性。
下拉列表优化：建议前端在输入关键词后，通过下拉列表展示匹配结果供用户选择，并将选中的固定门店 ID 传给后端，而非直接透传模糊关键词。

2.2 后端性能与限制

查询性能现状：目前接口因数据量不大且增加了经销商和时间范围限制，暂未出现明显性能问题，但需关注未来数据增长后的性能瓶颈。
时间范围强限制：目前后端未对时间范围做强制限制，主要依赖前端控制。若后续出现性能问题，后端将增加强限制逻辑。

三、待办事项

待办	负责人
修复生产环境 Bug 并发布上线	@张喜
将前端交互优化建议（取消编码匹配、增加下拉列表）反馈给产品经理（德智/小娜）	@张喜