开发路线图

版本：v3.0 ｜最后更新：2026-07 ｜文档状态：已同步代码

Mall 电商系统采用分阶段迭代开发，每个阶段聚焦一个业务领域。

整体规划

Phase 1 (MVP)                    Phase 2 (增强)                 Phase 3+ (未来)
┌─────────────────────┐    ┌─────────────────────┐    ┌─────────────────────┐
│ 后台权限系统    ✅    │    │ 多规格商品      ✅    │    │ ES 全文搜索         │
│ 后台商品管理    ✅    │    │ 促销活动        ✅    │    │ 微信支付            │
│ 后台订单管理    ✅    │    │ 内容管理        ✅    │    │ 数据分析报表        │
│ 前台用户系统    ✅    │    │ 会员体系        ✅    │    │ 多商户支持          │
│ 前台购物        ✅    │    │ 前台增强        ✅    │    │ 移动端适配          │
│ 前端重构        ✅    │    │                     │    │ 第三方登录          │
└─────────────────────┘    └─────────────────────┘    └─────────────────────┘

Phase 1 — MVP（已完成）

最小可用产品，覆盖电商核心链路。

阶段	内容	状态
1-1 后台权限系统	登录/验证码/管理员/角色/菜单/资源/仪表盘	✅
1-2 后台商品管理	分类/品牌/属性/单规格商品/运费模板	✅
1-3 后台订单管理	订单列表/详情/发货/退货审核/操作日志	✅
1-4 前台用户系统	注册/登录/个人信息/收货地址	✅
1-5 前台购物	首页/搜索/详情/购物车/下单/支付/售后	✅
前端重构	后台管理全站 shadcn/ui 风格重写	✅

Phase 1 交付成果：一个可以完成"浏览→下单→发货→退货"全流程的电商系统。

Phase 2 — 功能增强（已完成）

在 MVP 基础上增强商品能力、营销工具和会员体系。

阶段	内容	状态
2-1 多规格商品	SPU/SKU 模型、规格选择器、价格库存联动	✅
2-2 促销活动	秒杀活动、优惠券、满减促销	✅
2-3 内容管理	专题管理、优选专区、话题管理	✅
2-4 会员体系	会员等级、积分/成长值、自动升降级	✅
2-5 前台增强	商品评论、收藏/浏览历史、会员中心增强	✅

Phase 2 交付成果：多规格商品支持、完整促销工具链、会员成长体系。

Phase 3+ — 未来规划（待定）

功能	说明	依赖
Elasticsearch 搜索	商品全文搜索、分词、高亮。`mall-search` 模块代码已完整（287 行 ES 逻辑），但尚未与 mall-portal / mall-admin / 前端接线，当前前台搜索走 MySQL LIKE	需部署 ES 服务 + 打通调用链
微信支付	真实支付接入。当前代码 0 实现；前台支付页的「微信支付」按钮是占位	需商户号 + 支付证书
支付宝真实支付	后端 SDK 代码已完整（`AlipayController` / `AlipayServiceImpl`），但 `appId` / 密钥均为占位符，前端未接线	需配置商户凭据 + 回调地址
数据分析	销售报表、用户分析、商品分析。目前 `16-admin-statistics.md` 仅基础仪表盘	数据积累
财务管理	支付流水、退款管理、对账、财务报表。`17-admin-finance.md` 标注「待启动」	—
多商户	商家入驻模式	架构改造
移动端	H5 / 小程序适配	前端重构
第三方登录	微信/QQ 登录	OAuth 接入

Phase 3+ 前置：技术债清理

以下项目在文档中曾被标记为已完成，实际未实现或未生效。已处理项标注 ✅：

项目	现状
图片上传链路	✅ 已修复：`.env` 的 `VITE_MINIO_UPLOAD_URL` 原误配为 `/minio/upload`（不匹配代理、后端也 404），已改为 `/api/minio/upload`
订单超时取消	✅ 已补兜底：主路径仍为 RabbitMQ 延迟队列；`OrderTimeOutCancelTask` 已启用，每 10 分钟扫描 `status = 0` 的超时订单，并发安全
SpringTask 定时任务	✅ 已启用（`@Component` 恢复，方法改为 public）
前端样式收尾	⚠️ 部分完成：21 处 `el-table` 的 `border` 已清理；仍余 7 个文件未迁移到 `PageCard`
代码卫生	✅ 已清理 5 个文件 23 行重复 import + 5 处未使用 import
ELK 日志收集	⚠️ appender 已配但 `logstash.enableInnerLog: false`，永不生效
单元测试	⚠️ 仅 3 个测试类，且根 pom `skipTests=true`
JTA / HTTPS / Docker / RestTemplate	❌ 均未实现（文档曾虚假打勾）
闲置代码	⚠️ `useTableList` / `PageHeader` 零引用；`mall-search` 未接线
支付真实性	⚠️ 支付宝有代码未接线（凭据占位）；微信 0 实现

迭代节奏

每个阶段的开发遵循：

需求文档(PRD) → 页面设计 → 后端开发 → 前端开发 → 联调测试 → 交付

每个功能模块都有明确的验收标准（AC 格式），确保交付质量。

开发路线图 ​

整体规划 ​

Phase 1 — MVP（已完成） ​

Phase 2 — 功能增强（已完成） ​

Phase 3+ — 未来规划（待定） ​

Phase 3+ 前置：技术债清理 ​

迭代节奏 ​