在这次团队项目中,我先后提交了账户管理页和财务页按品牌识别广告账户的两次改动。
问题来自一类广告账户的展示:不同账户可能使用相同的上游名称,业务人员却按品牌区分正在处理谁。账户页改好了,切到财务页仍然看到旧名称,这项操作就还没接上。
我把改动从单页标签推进到品牌关系、共用展示逻辑、财务搜索和接口返回,借助 AI 完成代码与测试,在团队审查后交付。这篇记录其中两次重要修正:一次发生在服务端,一次发生在新旧版本交替时。
先让两个入口认出同一个账户
账户页已有品牌关联信息。到了财务页,我需要把有效的品牌关系补进接口,再让页面按同一规则展示。
实现时沿用稳定的账户标识连接数据,品牌名只负责展示。服务端按账户查找当前有效的品牌关联;前端把标签逻辑提取成共用方法,账户页和财务页都使用它。品牌改名可以改变标签,不会把金额连接到另一个账户上。
页面换了,账户身份不变
按品牌找到要操作的账户
按同样的名称识别与搜索
展示名称可以变;金额仍按稳定的账户标识关联。
没有有效品牌时显示未分配;关联多个品牌时,按固定顺序展示。已经失效的品牌或关联,不再作为当前归属返回。其他平台原本适用的名称与管理关系保持原有行为。
这次采用的是按品牌展示、不追加账户编号的格式。它有一个明确限制:不同品牌如果重名,标签仍可能相同。我在交付说明中保留了这个限制,没有为了让结果看起来全都解决了,擅自增加另一套编号格式。
搜索也要使用屏幕上的名字
财务页显示品牌标签以后,搜索不能仍然只认旧名称。
我让财务搜索使用同一份展示结果,并按平台保留原本需要的搜索信息。这样,用户输入刚刚看到的品牌,可以找回对应账户;后续改标签格式,也不必再去另一个位置补搜索规则。
验证时,有一个用例很关键:给两个上游名称相同的账户分别关联不同品牌,把接口实际返回的结果交给前端展示和搜索方法。检查它们是否得到各自的品牌标签,以及搜索一个品牌时是否混进另一个账户。
这比只给标签函数传两组手写数据多走了一段,能查到接口与页面之间有没有把关系接错。
初版审查发现,隐藏还不够
这类账户还有一项要求:某些上游身份信息不能提供给客户。初版已经把它们从页面和搜索中隐藏,审查却发现,接口响应里仍然带着这些值。
我随后把修正扩展到服务端返回和前后端的数据定义。相关身份字段在这一类账户的响应中返回空值,其他平台仍保留原有信息。测试除了看页面标签,也检查响应里是否还存在不应提供的值。
这次验收提出的反例,确实改变了实现范围。最初的展示处理解决了“画面上看不见”,接口修正才解决“数据没有送到客户浏览器”。两步不能互相替代。
新页面也可能收到旧响应
另一项检查发现了发布顺序的问题:新前端已经读取品牌列表,旧后端的响应可能还没有这个字段。
我在前端补了兼容处理,把缺失或空值按空列表处理,并加入旧响应的测试。页面可以继续显示,也不会回退到不该公开的上游身份。
这个版本把“旧响应没有品牌字段”和“没有有效品牌关联”都显示为未分配。回看这里,兼容处理保住了页面,但标签没有区分“信息未返回”与“确实没分配”。因此,不能只凭这个显示结果判断账户的真实分配状态。
这项局限需要和兼容结果一起讲清楚;它没有因为页面不再报错,就自动消失。
验收沿数据进入页面的路径检查
最后的检查覆盖了从有效品牌关系,到接口返回,再到页面展示和搜索的路径。除了正常情况,还包括失效关联、多品牌顺序、旧格式响应,以及其他平台的行为是否受到影响。
当时存档的验收记录中,接口集成、前端单元检查和跨层数据检查均通过。两个账户原名相同、分别属于不同品牌的用例,也验证到了展示与搜索结果。
这次交付的具体内容,是一份共用标签逻辑、一组财务品牌关系与返回调整,以及搜索、兼容和测试的配套修改。以后再调整名称,可以沿这条路径检查,不必只在两个页面各改一处文字。
本文复盘 当时的团队项目,个人提交包含 AI 辅助实现与团队审查。图中品牌及编号为合成示意;验收结果来自当时存档,不是本次重新测试线上产品。
相关工作与笔记
看另一个产品实现案例:把版本、状态和账户范围带进操作条件。