1、立项原因：公司商品资料此前分散在各业务系统和 Excel 表格中维护，上新依赖线下沟通与人工录入，存在品名、规格口径不一，审批无留痕，ERP 同步靠手工重导等问题，错码漏码频发，直接影响发货与售后体验。为解决商品数据"多头维护、口径不一、无法追溯"的痛点，立项建设商品主数据管理（MDM）系统，实现商品资料"一处建档、统一审批、多方分发"。
2、行业场景与业务背景：系统服务于品牌零售电商行业，公司通过天猫、京东、抖音、自营商城等多个渠道销售商品，后端使用聚水潭 ERP 管理订单与仓储。商品主数据是电商业务的核心基础数据，需要向 ERP、商城、物流计费等下游系统提供统一、准确、及时的商品资料，本系统即定位为企业级的商品数据中台。
系统主要功能模块如下：
1、商品主数据管理：SPU/SKU 全生命周期管理，支持商品新建、编辑、上下架；商品类目与商城类目映射管理；尺码组与尺码项维护；套装（组合装）商品组件管理；货号规则配置与自动生成预览。
2、商品申请审批：商品新建、变更加入申请单，支持草稿、审批中、已通过、已驳回等状态流转，提供任务冲突检测、Excel 批量导入与操作日志留痕。
3、飞书审批集成：审批流程对接飞书审批，支持审批表单、字段映射、控件与取值映射的可视化配置，审批实例状态双向同步与回调处理。
4、聚水潭 ERP 对接：审批通过的商品批量上传聚水潭，含同步状态跟踪、失败重试与结果回写。
5、物流报价：运费费率规则配置与在线试算引擎，按重量、区域等维度快速计算运费报价。
6、商城商品视图：面向自营商城的商品列表、详情查询与商品评论管理。
7、系统管理：用户、角色、菜单权限、数据字典等基础能力。
1、本人负责系统整体的设计与前后端开发：包括需求梳理、数据库建模、接口设计、后台服务与前端页面实现、联调测试及 Linux 环境部署上线。
2、技术栈与架构：后端基于 Spring Boot + MyBatis-Plus + MySQL + Redis 的模块化架构，前端采用 Vue3 + TypeScript + Vite + Element Plus + Pinia，RBAC 权限控制到按钮级。
3、实现亮点与难点：（1）设计 SPU/SKU/套装/尺码组的商品领域模型，申请单采用"任务快照"暂存变更并配合冲突检测，解决多人同时编辑同一商品的相互覆盖问题；（2）封装飞书开放平台审批 API，将审批表单字段、控件、取值做成映射配置，新增审批字段无需改代码；（3）对接聚水潭商品上传接口，实现批量上传、失败重试与状态回写的可靠同步；（4）实现基于费率规则的物流报价试算引擎；（5）商品 Excel 批量导入的字段校验与错误行反馈。
评论