主题
开发进度总览
版本：v3.0 ｜ 最后更新：2026-07 ｜ 文档状态：已同步代码
截至当前，Phase 1 和 Phase 2 全部完成。
完成度概览
| 阶段 | 状态 | 完成度 |
|---|---|---|
| Phase 1-1 后台权限系统 | ✅ 已完成 | ██████████ 100% |
| Phase 1-2 后台商品管理 | ✅ 已完成 | ██████████ 100% |
| Phase 1-3 后台订单管理 | ✅ 已完成 | ██████████ 100% |
| Phase 1-4 前台用户系统 | ✅ 已完成 | ██████████ 100% |
| Phase 1-5 前台购物 | ✅ 已完成 | ██████████ 100% |
| 前端重构 | ✅ 已完成 | ██████████ 100% |
| Phase 2-1 多规格商品 | ✅ 已完成 | ██████████ 100% |
| Phase 2-2 促销活动 | ✅ 已完成 | ██████████ 100% |
| Phase 2-3 内容管理 | ✅ 已完成 | ██████████ 100% |
| Phase 2-4 会员体系 | ✅ 已完成 | ██████████ 100% |
| Phase 2-5 前台增强 | ✅ 已完成 | ██████████ 100% |
各阶段交付详情
Phase 1-1 后台权限系统
- JWT Token 认证（7天有效期）
- 图形验证码（Redis 存储，5分钟过期）
- 账号锁定（连续5次失败锁定30分钟）
- RBAC 权限模型 + 动态权限控制
- 管理员/角色/菜单/资源 CRUD
Phase 1-2 后台商品管理
- 商品分类树（三级限制）
- 品牌管理（含删除保护）
- 属性/属性值管理
- 单规格商品 CRUD
- 运费模板 CRUD
Phase 1-3 后台订单管理
- 订单列表（日期范围搜索、商品信息展示）
- 发货操作（8家物流公司、操作日志）
- 退货申请审核流程
- 订单操作历史记录
Phase 1-4 前台用户系统
- 会员注册/登录（支持用户名或手机号）
- 个人信息管理（昵称/头像）
- 收货地址 CRUD（上限10个、自动默认切换）
Phase 1-5 前台购物
- 首页门户（轮播/推荐/品牌/专题）
- 商品浏览（分类/搜索/详情）
- 购物车（数量调整/选中切换）
- 下单支付（确认订单/模拟支付）
- 订单管理（列表/详情/售后申请）
- 前台 20 个页面路由全部实现（公开 8 + 需登录 12）
Phase 2-1 多规格商品
- SPU/SKU 数据模型
- 后台规格编辑器（多属性配置、SKU 批量设置）
- 前台 SKU 选择器（属性匹配、价格库存联动）
- 购物车多规格兼容
Phase 2-2 促销活动
- 秒杀活动（场次管理、商品配置、前台专区）
- 优惠券（创建/发放/领取/使用全流程）
- 满减促销（商品关联满减规则）
Phase 2-3 内容管理
- 专题管理（CRUD + 前台页面）
- 优选专区（CRUD + 前台页面）
- 话题管理（CRUD + 前台页面）
Phase 2-4 会员体系
- 后台会员列表管理
- 会员等级配置
- 积分/成长值手动调整
- 自动升降级（下单→成长值→匹配等级）
- 积分变动记录
Phase 2-5 前台增强
- 商品评论（评价列表、筛选、商家回复）
- 收藏功能（MongoDB 存储）
- 浏览历史（自动记录、按日期分组）
- 会员中心增强（成长值展示、收藏/历史入口）
前端重构
- 全站 shadcn/ui 风格统一
- TagsView 多标签页导航
- PageCard / PageHeader / ProductCard 通用组件
- useTableList 列表页通用 composable
- 30+ 页面全部重写
待开发项
阶段划分详见 开发路线图 的「Phase 3+」。
| 功能 | 优先级 | 说明 |
|---|---|---|
| Elasticsearch 搜索 | P1 | 需部署 ES 服务；mall-search 模块代码已完整，但尚未与业务接线，前台搜索当前走 MySQL LIKE |
| 微信支付 | P1 | 需商户号和支付证书；当前代码 0 实现（前台支付页的「微信支付」按钮是占位，点击同样直接调 paySuccess 模拟成功） |
| 支付宝真实支付 | P1 | 需配置 appId / 密钥（现为占位符）；后端 SDK 代码已完整，前端未接线；需补充回调地址配置 |
| 前台搜索升级 | P1 | 由 MySQL LIKE 升级为 ES 全文检索（与 ES 搜索同批） |
| 数据分析报表 | P2 | 需数据积累；16-admin-statistics.md 目前仅基础仪表盘 |
| 财务管理模块 | P2 | 17-admin-finance.md 标注「待启动」 |
| 移动端适配 | P2 | H5/小程序 |
| 第三方登录 | P3 | 微信/QQ OAuth |
| 框架补齐 | P2 | JTA、HTTPS、Docker、RestTemplate 均未实现（见 docs/dev/progress.md 框架搭建表） |
| 前端样式收尾 | P3 | 7 个文件仍未迁移到 PageCard（21 处 el-table 的 border 已清理） |
已在本轮清理的技术债：✅ 上传链路 404（
.env指向/api/minio/upload）；✅ 订单超时取消兜底定时器已启用；✅ 5 个文件 23 行重复 import + 5 处未使用 import；✅ 21 处el-table的border属性。