商城支付功能开发清单
一、商品管理模块
1. 商品信息管理
| 功能点 | 前端需求 | 后端需求 | 技术要点 |
|---|---|---|---|
| 商品创建 | 表单页面(标题/描述/价格/库存等) | RESTful API 设计 | 富文本编辑器集成 |
| 商品编辑 | 数据回显与实时保存 | 事务性更新保证数据一致性 | 图片压缩处理(<200KB) |
| 批量上下架 | 表格操作组件 | 批量状态更新接口 | Redis 缓存商品状态 |
| 分类管理 | 树形组件展示 | 无限级分类数据结构 | 分类路径缓存优化 |
| 搜索筛选 | 组合查询组件 | Elasticsearch 索引构建 | 中文分词优化 |
二、购买流程模块
1. 购物车系统
| 功能点 | 前端需求 | 后端需求 | 技术要点 |
|---|---|---|---|
| 添加商品 | 动画反馈 | 并发控制防止超卖 | Redis 原子操作 |
| 批量操作 | 全选/删除组件 | 事务性处理 | Lua 脚本执行 |
| 实时计算 | 金额自动更新 | 促销规则引擎 | Groovy 脚本支持 |
2. 结算流程
mermaid
graph LR
A[购物车] --> B{登录校验}
B -->|已登录| C[地址管理]
B -->|未登录| D[快速注册]
C --> E[支付方式选择]
E --> F[订单确认]
F --> G[支付跳转]
G --> H[支付结果回调]3. 支付集成
TODO: 待补充
三、订单管理模块
1. 订单状态机
mermaid
stateDiagram-v2
[*] --> 待付款
待付款 --> 已取消: 超时/手动取消
待付款 --> 已支付: 支付成功
已支付 --> 待发货: 库存预占
待发货 --> 已发货: 物流出库
已发货 --> 已签收: 物流妥投
已签收 --> 已完成: 超时自动确认
已完成 --> [*]2. 核心功能
| 功能点 | 前端需求 | 后端需求 | 技术要点 |
|---|---|---|---|
| 订单详情 | 时间线组件展示状态 | 多表关联查询 | 读写分离优化 |
| 订单取消 | 原因选择弹窗 | 库存回退逻辑 | 幂等性设计 |
| 超时处理 | - | 定时任务扫描 | Quartz 分布式调度 |
| 退款处理 | 流程进度可视化 | 资金逆向操作 | 对账文件生成 |
四、物流管理模块
| 功能点 | 前端需求 | 后端需求 | 技术要点 |
|---|---|---|---|
| 电子面单 | 打印模板配置 | 物流 API 对接(顺丰/中通) | 热敏打印机兼容 |
| 批量发货 | Excel 导入组件 | 异步任务处理 | 线程池控制 |
| 物流跟踪 | 地图轨迹组件 | 物流订阅接口 | Webhook 回调处理 |
五、财务模块
| 功能点 | 前端需求 | 后端需求 | 技术要点 |
|---|---|---|---|
| 交易报表 | 数据可视化图表 | 多支付渠道对账文件解析 | POI 大数据量导出 |
| 手续费计算 | 公式配置器 | 动态规则引擎 | Groovy 脚本执行 |
| 分账处理 | 比例设置组件 | 资金账户拆分 | 银行 API 对接 |
六、扩展功能
TODO: 待补充。
七、测试清单
1. 核心场景验证
markdown
1. [ ] 商品超卖测试:模拟 100 并发下单库存 10 的商品
2. [ ] 支付回调测试:
- 模拟重复回调
- 模拟延迟回调(>5 分钟)
- 模拟签名异常回调
3. [ ] 物流异常测试:
- 快递单号无效
- 物流长时间无更新
4. [ ] 数据一致性检查:
- 订单金额 = 商品总额 - 优惠 + 运费
- 资金流水闭环验证2. 性能指标
| 场景 | 要求指标 | 测试工具 |
|---|---|---|
| 下单接口 | QPS > 500 (4 核 8G) | JMeter |
| 支付回调 | 处理延迟 < 200ms | SkyWalking 监控 |
| 订单查询 | 响应时间 < 1s (1000 万数据) | Explain 分析优化 |