使用 Qoder 开发工业化WMS系统界面菜单角标功能的心得体会—— 基于精工IMS.JMOM 项目实战的工程化思考

一、引言菜单角标Badge是企业级应用中常见但容易被低估的小功能它要求在多用户、多节点、多业务并发的场景下对每一位用户、每一个菜单实时呈现待办数量。看似一个红点背后却串联起Redis 发布订阅、SignalR 实时推送、配置开关、后台服务条件注册、文档同步与日志规范化等多个工程层面。本文记录我在 IMS.JMOM 项目中使用 Qoder 完成这一功能从 0 到 1、再从功能到工程化重构的全过程心得。二、需求背景与技术方案2.1 业务诉求在“其他入库”等业务模块产生待处理任务时对应菜单实时显示数量。用户跨多节点登录时角标数据全局一致不丢推送。角标信息属于运行时状态不落库重启可重建。可通过配置开关一键关闭避免对未启用 Redis 的部署造成影响。2.2 关键设计存储Redis HashKey 为 User:Badge:{userId}Field 为菜单 IDValue 为数量。通道Redis 发布订阅频道承载“增量 / 覆盖 / 清除”三类 OpType 消息。推送RedisBadgeSubscribeHost 后台服务订阅频道命中本节点在线用户后通过 SignalR HubIMenuBadgeHub.RefreshBadge() 向前端广播。全局化ClearAllBadge 改为 HashGetAll 逐字段 HashDeleteAsync避免销毁 Hash 结构。开关appsettings 增加启用项未启用时跳过后台服务注册与发布订阅链路。三、Qoder 在开发过程中的具体作用3.1 高质量的语义检索让“破冰”变得轻松在面对一个不熟悉的单体仓库时最大的成本是“找”。Qoder 的语义搜索能直接回答“现有 SignalR Hub 是怎么注册的”“缓存服务在哪里抽象”“后台服务是如何托管的”这类高层问题让我可以在十几分钟内拼出完整的架构画像再基于既有约定去设计 IMenuBadgeHub、BadgeService、RedisBadgeSubscribeHost 这些新组件避免重复造轮子。3.2 工具并行调用把“调研 实现”压缩在同一个心流里Qoder 支持在一次回合中并行执行多个搜索/读取/编辑操作。在做菜单角标功能时我经常一次性发起 grep_code 找所有 Console.WriteLine、search_codebase 找现有日志样例、read_file 读关键 Service 文件再统一进行 search_replace。这种“并行查、集中改”的节奏把日志规范化5 个文件 25 处统一替换为 ILogger 的结构化日志这种重复劳动从“看着都累”变成“一气呵成”。3.3 上下文记忆让“今天接昨天”毫无负担菜单角标功能不是一次写完的先实现单业务场景再扩展到 WMS 单据按 BillType 分组初始化再做全局化重构、清除链路统一走发布订阅、再到配置开关化。Qoder 把每一步的关键决策、涉及文件、技术债务沉淀为可检索记忆下一次开口就能延续上下文不必反复粘贴目录树。3.4 自然语言驱动重构让规范真正落地把“反模式”改成“规范”往往是最容易被搁置的事情。借助 Qoder我用一句“把 BadgeService 等 5 个文件的 Console.WriteLine 全部替换为 ILogger 结构化日志并按错误/警告/信息分级”就把过去要写一篇手册的工作完成了它会自动补 using、改造构造函数、生成模板字符串参数化日志最后还能比对风格是否与 SysAppController 一致。3.5 文档同步让代码和说明书不再各说各话ClearAllBadge 改造之后《Redis 发布订阅推送方案》《菜单角标功能-使用说明》都需要更新。Qoder 能在一次任务里识别出所有受影响章节架构图、流程、数据结构、消息体、API、前端集成顺手把 SignalR Hub 接口与 HubIMenuBadgeHub 的关系也讲清楚避免“代码改了文档没改”的经典坑。四、印象深刻的两个细节4.1 ICache 抽象不能直接做发布订阅项目里早有一层 ICache 缓存抽象最初我想直接复用它做 Pub/Sub。Qoder 在阅读现有实现后明确指出ICache 仅暴露读写接口没有订阅 API必须新建 RedisService 直接持有ConnectionMultiplexer 才能调用 ISubscriber。这个判断帮我避开了一次错误的抽象渗透也让 RedisBadgeSubscribeHost 拥有了干净的依赖结构。4.2 配置开关与后台服务条件注册在做开关化时我希望未启用菜单角标的部署里完全不要起后台订阅服务。Qoder 提议用条件 AddHostedService 注册 在 BadgePublishService 入口做开关短路二者结合让“关掉就当没有”这件事变得彻底——既不占线程也不会因为缺 Redis 配置而启动失败。五、心得体会把 Qoder 当“架构同事”而不是“代码补全”先和它对齐方案再下手比让它“顺嘴写一段”有价值得多。“一次说清、一次到位”把约束不落库、可开关、文档同步、日志规范一次性讲明Qoder 的产出更接近可合并的 PR。信任它的检索能力少给提示多给目标它在大型仓库里跨模块定位的效率往往比我手敲 grep 高。保留人类的最终判断模型给出的方案是“候选”是否引入新依赖、是否破坏既有抽象仍由我决定。把记忆当资产每完成一个里程碑就让它记下来下一次做相邻功能时启动成本几乎为零。六、结语菜单角标功能从一个红点演变为全局化、可开关、可观测、文档完备的工程化模块这一过程离不开精工智能内部 AI 辅助开发工具的全程协作。它并未越俎代庖去做架构决策却将我从繁复的代码检索、文档撰写、日志比对中解脱出来让我能集中精力深耕WMS、MES、APS及智能物流系统的业务逻辑设计与架构优化。这正是精工智能软件开发日常的缩影——系统不止于上线诞生更在于持续维护与反复迭代。日复一日我们通过一次次看似细微的调整让软件功能更贴合车间现场年复一年我们通过一次次扎实的版本演进让数字化工厂的底座愈发稳固。AI 辅助开发的意义从不是替代人的思考而是让我们成为更专注、更深入业务本质的开发者从而让精工智能的每一套系统都在时间的打磨中沉淀出真正的生命力。