本项目面向传统批发零售行业的数字化订货转型场景，服务于同时开展零售与批发业务的商贸企业。线下批发长期依赖电话、微信留言和纸质目录，存在报价体系混乱、零售与批发价格易串货、合作商资质难管控、下单对账效率低等行业痛点。
项目构建"零售+批发"双轨并行的电商平台，实行差异化定价与准入机制：普通用户通过用户端小程序按零售价自助选购下单；合作商户须提交资质申请、经平台审核入驻后，方可登录批发端小程序，享受专属批发价进行批量采购。两端商品同源但价格体系严格隔离，确保批发价不对外泄露。平台方在管理后台统一完成合作商入驻审批、双轨价格配置、交易管理与数据分析，解决传统批零业务中价格管控难、合作商管理乱、协作效率低的核心问题。
项目基于开源商城框架二次开发，包含用户端小程序、批发端（合作商户）、平台管理后台三端，支持零售+批发双业态：
1、用户端小程序（零售）：首页DIY装修渲染、商品分类与搜索、多规格SKU联动选款、详情视频/评价/分享海报、购物车结算、快递/自提切换、微信/余额/货到付款多种支付方式、优惠券/满减等营销活动、退款售后与评价、物流轨迹查询、会员等级/钱包/资产体系；普通用户仅可见零售价，支持价格脱敏模式。
2、批发端（合作商户专属，小程序+商家后台双形态）：小程序端支持入驻申请提交（营业执照/身份证OCR识别、银行账户绑定）、审核状态查询；审核通过后解锁专属批发价与阶梯报价，价格体系与零售端严格隔离，防止批发价外泄；管理端支持商品SPU/SKU发布、批量上下架与导入导出、阶梯批发价与库存管理、新订单提醒、发货/改价/退款审核、优惠券营销配置、拖拽式页面装修（14类组件）、门店与店员管理及自提核销、结算明细与提现、ECharts多维销售统计看板、菜单与按钮级动态权限。
3、平台管理后台：商家入驻与合作申请审批、平台订单与商品监管、结算审核、地区与插件市场管理、多云存储/短信/打印机等全局配置与版本管理。
三端协同，覆盖"零售下单—批发采购—商家履约—平台监管"完整业务闭环。
项目采用Spring Cloud Alibaba微服务架构，按业务域拆分为用户、商品、订单、营销、结算等独立服务，Gateway统一网关路由鉴权，Nacos承担注册与配置中心，XXL-Job处理超时关单、自动确认收货、商家结算等定时任务。
核心亮点：
1、多端商品与价格隔离：商户端与用户端各自维护独立商品池及定价体系，商品表通过channel字段标识所属端，查询时按当前登录端过滤；商户端需入驻审核通过后方可访问专属商品列表，未审核或用户端请求无法触达商户端商品数据，从数据源层面杜绝价格交叉泄露。
2、订单状态机：单一状态字段驱动全生命周期（待付→已付→已发→已收→完成/退款），转移规则集中维护，流转写入审计日志，乐观锁防并发；退款支持原路退回与余额退回双通道，成功后自动回滚SKU库存，数据库事务保证状态变更与库存回滚原子性。
3、可视化装修引擎：服务端JSON协议描述页面结构，前端按type动态渲染banner、商品橱窗、优惠券等十余类组件；数据型组件独立请求避免JSON膨胀，version字段支持降级兼容，后台拖拽配置实时预览。
技术难点：
1、多端数据隔离边界：商户端与用户端商品池物理同库但逻辑隔离，查询层强制注入channel过滤条件，防止SQL遗漏导致跨端数据泄露；商户端接口额外校验审核状态，双重保障确保未入驻商户无法获取专属商品及价格。
2、退款链路数据一致性：涉及订单状态、库存、余额多表操作，本地事务+重试机制保障原子性，关键节点写审计日志追溯，避免分布式事务中间件额外复杂度。
3、超时关单幂等与并发：XXL-Job扫描超时未支付订单，Redis分布式锁防重复关单；关单前二次校验订单状态，防止与支付回调并发冲突；关单成功后触发库存回滚，全程写入审计日志。
评论