在线商城管理端重构

01 / BACKGROUND

项目背景

随着商城业务持续扩展，商品管理逐步叠加了多规格、不同用户角色、佣金、限购、库存、赠品、媒体资源和多公司同步等能力。原有页面以功能追加为主，字段分散、状态口径不统一，商品、规格和角色之间的关系难以理解；同时，总服务器需要向大量公司服务器同步商品资料，但库存又必须集中管理并实时共享，进一步增加了规则复杂度。商品详情页还需要支持图片与视频混排，原有资源管理能力无法满足上传、选择、移动和同步等完整需求，因此需要在不破坏现有商品数据的前提下进行系统性重构。

02 / MY ROLE

我的职责

梳理商品新建、编辑、批量上下架、规格配置、角色状态、佣金、限购、库存调整、资源选择、赠品活动和同步任务等完整业务链路；重新定义商品、规格与店长、店员、绑定用户、散户四类角色之间的状态关系，明确商品列表汇总状态和规格角色级上下架规则；设计总服务器与各公司共用一套规格库存的集中管理方案，明确下单预扣、取消恢复、退款恢复和幂等要求；规划图片与视频资源管理、批量上传、跨页选择、资源移动、删除限制及同步失败反馈；补充轮播图片与视频混排、缩略图、放大浏览、自动轮播和声音状态恢复等详情媒体交互；同时参与原型评审、开发沟通、异常场景补充、测试用例设计和上线验收。

03 / CORE PROBLEMS

核心问题

第一，商品、规格和角色的上下架状态存在多层级关系，若同时保留商品级和规格级状态，容易出现真实状态来源不一致；第二，佣金、限购和库存原本与角色配置交叉，字段联动复杂，后台人员难以判断修改影响范围；第三，总服务器需要同步商品资料到多家公司，但库存不能被同步任务覆盖，必须保持集中、实时且支持并发下单；第四，库存增加、减少、清零、下单预扣、取消和退款恢复都可能被重复请求，需要统一幂等规则；第五，图片和视频在上传限制、选择范围、跨页保留、分组移动和同步结果上存在大量边界情况；第六，重构必须兼容现有商品和历史数据，不能因页面调整造成商品状态、库存或媒体内容异常。

04 / SOLUTION

解决方案

以商品、规格、角色配置、共享库存和媒体资源为核心业务对象重新组织管理端。商品级保留批量上下架入口，真实销售状态统一保存在每个规格的四角色配置中，商品列表再汇总展示为上架、部分上架或下架；取消规格独立上下架，避免多套状态相互冲突。佣金调整为跟随规格配置，限购拆分为独立模块，降低字段耦合。库存统一存放在中心服务器，由所有公司实时共用，商品同步仅传递商品资料、规格、价格和角色状态，不下发或覆盖库存；下单成功即预扣库存，取消和全额退款时恢复，并通过业务唯一标识保证幂等。资源管理统一支持图片和视频，明确文件格式、大小、数量和使用场景限制；上传、选择、移动和同步均提供清晰的失败结果和可恢复操作。详情媒体采用图片与视频混排结构，并补充自动轮播、缩略图、放大查看、播放控制和关闭后声音状态恢复等完整交互。

05 / PROCESS & RULES

关键流程或业务规则

06 / RESULT & REVIEW

项目结果与复盘

完成了在线商城管理端从商品资料到库存、资源和同步任务的整体重构方案。商品、规格与角色之间的状态关系更加清晰，后台人员可以从统一入口完成配置并快速识别商品当前销售状态；共享库存不再受商品同步任务影响，库存扣减与恢复具备明确的幂等规则；图片与视频资源的上传、选择和同步流程得到统一，商品详情媒体能力也具备完整的交互和技术约束。该方案为开发实现、数据迁移和回归测试提供了可直接执行的规则基础，并降低了多公司、多角色和多规格场景下的数据不一致风险。

复盘大型后台重构的核心并不是重新绘制页面，而是识别真实的数据归属和状态来源。只有先明确商品、规格、角色、库存和资源分别由谁维护，才能避免前端展示状态与后台数据相互矛盾。对于共享库存和多服务器同步场景，产品需求必须把数据边界、并发处理、幂等和失败恢复写清楚；对于复杂配置页面，则应优先减少状态层级和字段耦合，而不是继续增加提示文字。