## 项目总体定位
这是一个对接上游供应链开放平台的分销型 H5 商城系统，由三部分组成：面向消费者的 H5 移动端商城、面向运营人员的管理后台、以及承担业务逻辑和供应链对接的服务端。商品、库存、物流、售后等能力来自上游供应链平台，本系统负责选品、加价销售、用户运营（积分、余额、分销）以及订单全流程的中转与管理。
## 一、H5 移动端商城功能
### 首页与内容展示
- 首页聚合展示轮播图、公告、分类快捷入口、品牌专区入口、精选好物商品流等内容，未登录也可浏览。
- 公告支持列表查看与弹窗展示；热门搜索词由后台配置下发。
### 商品浏览与搜索
- 分类页展示多级分类树，只显示后台设为可见且子树内有上架商品的分类，空分类自动剔除。
- 品牌专区按拼音首字母分组展示品牌，仅展示有上架商品的品牌，并附带每个品牌的真实商品数。
- 商品列表支持按分类（含全层级子分类）、品牌、价格区间筛选，支持综合、价格升降序、销量等排序方式。
- 商品详情页展示轮播图、SKU 规格、价格、图文详情，访问时会先向供应链平台同步最新数据再返回，并自动记录浏览记录；支持分享。
- 精选好物页展示后台选品库中的商品。
- 搜索功能包含关键词搜索、热门搜索词、个人搜索历史的查看与清空。
### 用户账户
- 通过微信授权登录，支持绑定手机号，查看个人信息。
- 收货地址管理：列表、新增、编辑、删除、设置默认地址，省市区数据来自供应链平台的区域接口。
- 我的收藏：收藏商品、单个删除、批量删除；收藏商品价格或上下架变动时会收到消息推送。
- 浏览记录：按日期查看、单条删除、一键清空。
- 消息中心：订单、商品等类型消息的列表、未读数、单条已读、全部已读。
### 积分与余额
- 双积分体系：A 积分与 B 积分，B 积分与外部 B 系统定时双向同步并有同步日志。
- 积分页展示积分总览与流水明细，积分有有效期，过期自动清零。
- 余额页展示余额总览与流水明细，余额由后台充值。
### 下单与支付
- 下单前先调用供应链平台做下单确认与运费试算（按收货地区和商品计算运费）。
- 提交订单时支持用 A 积分、B 积分、余额组合抵扣，创建本地待支付订单，并设置支付超时时间。
- 支付完成后扣减对应的积分与余额并记录流水，订单转为已支付，同时向供应链平台真实下单，并触发分销佣金记录的生成。
- 有支付结果页展示下单结果。
### 订单管理
- 我的订单：按状态分栏（各状态附数量角标）、订单列表、订单详情（含状态时间线日志）。
- 支持取消订单（同步取消供应链订单并原路退还积分、余额）、确认收货。
- 超时未支付订单由系统自动取消并退款。
### 售后
- 支持对订单申请售后（退款、退货等类型），可上传凭证图片（图片直传供应链平台）。
- 售后列表、售后详情、取消售后申请。
- 退货场景下用户填写快递公司与运单号寄回商品。
- 售后完成后退款自动入账（退回积分或余额）。
### 分销
- 分销中心展示个人分销概览（累计佣金、待结算、团队规模等）。
- 我的团队：查看直推和间推下级成员及各自贡献的佣金。
- 佣金明细：逐笔佣金记录，含来源用户、比例、状态。
- 通过邀请关系建立两级分销：直推按一档比例、间推按另一档比例计酬，比例由后台配置。
- 佣金以积分形式发放，先冻结一段可配置的天数，到期由系统自动结算入账。
## 二、管理后台功能
### 数据看板
- 展示销售额、订单量、用户数等核心经营数据的统计概览。
### 商品管理
- 商品列表与商品详情（含 SKU 明细、轮播图），支持本地上下架（独立于供应链平台的上下架状态）。
- 改价功能：单个改价与批量改价（按比例加价或固定加价），改价校验不得低于供应链的最低控价，所有价格变动记录留痕可查。
- 推荐标签管理：为商品打新品、热销、精选标签用于前台展示。
- 选品管理：查看选品库商品，调整排序、控制是否在商城展示。
- 分类管理：分类的显示与隐藏、排序调整、图标设置。
- 品牌管理：品牌的显示与隐藏、Logo 设置。
- 数据同步：手动触发商品、分类、品牌、选品库的全量同步，可补齐缺失分类。
### 订单与售后
- 订单列表（多条件筛选）、订单详情、添加商家备注、向供应链平台批量查询订单最新状态。
- 售后列表、售后详情、对退回商品执行确认收货。
### 用户管理
- 用户列表与用户详情（含消费、积分、余额、分销信息）。
- 手动调整用户积分、手动充值余额、启用或禁用用户账号。
### 分销管理
- 分销概览统计、佣金记录查询、按用户查看分销关系与团队结构、分销比例与佣金冻结天数等参数配置。
### 积分与余额管理
- 积分总览、积分流水查询、积分规则配置、B 系统同步日志查看与手动触发同步。
- 余额总览、余额流水查询、手动充值。
### 内容管理
- Banner 管理：增删改、排序、跳转目标配置。
- 公告管理：发布、编辑、删除，可设置是否弹窗。
- 热门搜索词管理：增删改与排序。
### 系统设置
- 基础配置、客服配置、订单配置（如支付超时时长）、消息推送配置，均以配置项形式集中管理。
- 全局定价规则配置与一键应用（按规则批量重算商品售价）。
- 管理员账号管理（新增、编辑、修改密码、角色区分）。
- 操作日志：记录管理员及系统定时任务的所有关键操作，供审计追溯。
- 图片上传能力供各管理页面使用。
## 三、服务端自动化与供应链对接
### 供应链平台对接
- 完整实现开放平台协议：访问令牌的获取、缓存与自动刷新，接口签名与验签，请求队列限流控制。
- 封装商品、分类、品牌、选品、区域、运费、下单、订单、售后、文件上传等全部上游接口调用。
### 回调处理
- 接收供应链平台的商品变动回调（价格、库存、上下架变化时更新本地数据，并通知收藏该商品的用户）。
- 接收订单状态回调（发货、完成、关闭等状态同步到本地订单，订单关闭时自动退还用户支付的积分与余额）。
- 所有回调均做签名校验和幂等去重，防止重复处理。
### 定时任务
- 访问令牌定期刷新。
- 每 5 分钟扫描并自动取消超时未支付订单，退还抵扣款项。
- 每天零点自动结算冻结期已满的分销佣金。
- 每 30 分钟轮询供应链平台的售后单状态并同步本地。
- 每 30 分钟执行 B 系统积分双向同步（可开关控制），结果落同步日志。
- 每天凌晨清理过期积分。
- 每天凌晨错峰执行商品、分类、品牌、选品库的全量同步，成功与失败均写入操作日志作为告警依据。
源码推广的SEO优化标题，按不同关键词侧重方向分组：
## 主打“供应链商城系统”方向
1. 供应链H5商城系统源码：对接上游供应链平台的一件代发分销商城完整解决方案
2. 供应链分销商城全套源码，商品同步、自动下单、售后回调全流程打通
3. 对接供应链开放平台的H5商城源码，选品加价一键上架，订单自动流转
4. 供应链代发商城系统源码：无货源模式开店，商品库存物流全部上游托管
5. 全开源供应链商城系统：选品库管理、控价改价、每日全量商品同步
## 主打“分销/佣金”方向
6. 二级分销H5商城源码：直推间推双层佣金、冻结期结算、团队管理完整实现
7. 分销裂变商城系统源码，邀请关系绑定、佣金自动结算、分销数据后台可视化
8. 带分销功能的移动端商城源码：佣金比例后台可配，佣金明细逐笔可查
9. 分销返佣商城完整源码：分销概览、我的团队、佣金流水三端联动
## 主打“积分/余额营销”方向
10. 双积分体系H5商城源码：AB积分组合抵扣、积分过期清零、外部系统积分互通
11. 积分余额混合支付商城系统源码，抵扣、退款、流水记录全链路闭环
12. 积分商城源码：积分抵现下单、积分流水管理、积分规则后台可配置
## 主打“功能完整性”方向
13. 前后台全套H5商城源码：用户端、管理后台、服务端三端齐全开箱即用
14. 功能完整的移动商城源码：商品、订单、售后、地址、收藏、消息中心一应俱全
15. 商城管理后台源码：数据看板、批量改价、内容管理、操作日志审计全覆盖
16. 带售后退货全流程的商城系统源码：申请售后、寄回快递、退款自动入账
17. 微信授权登录H5商城源码，绑定手机、消息推送、浏览收藏记录完整实现
## 主打“自动化运营”方向
18. 全自动化运营商城源码：超时订单自动取消、佣金定时结算、商品每日自动同步
19. 免人工值守的供应链商城系统：订单状态回调同步、售后状态自动轮询、库存价格实时更新
20. 智能化商城源码：控价保护、批量定价规则、价格变动留痕可追溯
## 长尾组合型标题
21. 供应链一件代发H5分销商城源码下载：双积分抵扣加余额支付，二级佣金自动结算
22. 无货源供应链商城系统完整源码：选品上架、加价销售、订单代发、售后代管
23. 企业级供应链分销商城源码：回调幂等处理、签名验签、操作审计安全可靠
24. H5移动商城加管理后台全套源码：品牌专区、分类导航、热搜词运营位齐全
25. 供应链商城二次开发首选源码：接口清晰、模块完整、含完整对接文档
以上标题覆盖了源码的核心卖点：供应链对接、二级分销、双积分余额体系、售后闭环、自动化运营和三端完整性，可根据发布平台（源码交易站、搜索引擎、软文推广）选择不同侧重方向组合使用。
