# TakeoutSaaS 开发里程碑

> 最后更新：2026-02-02

本文档定义整个 SaaS 外卖系统的开发里程碑，按优先级和依赖关系排序。

---

## 里程碑概览

```
M1 平台核心基础 ─────────────────────────────────────── ✅ 已完成
    │
M2 租户订阅计费 ─────────────────────────────────────── ✅ 已完成
    │
M3 前后端联调验证 ───────────────────────────────────── 🔄 进行中
    │
M4 订单交易闭环 ─────────────────────────────────────── ⏳ 待开始
    │
M5 租户管理端 ───────────────────────────────────────── ⏳ 待开始
    │
M6 C端小程序 ────────────────────────────────────────── ⏳ 待开始
    │
M7 营销与运营 ───────────────────────────────────────── ⏳ 待开始
    │
M8 财务结算 ─────────────────────────────────────────── ⏳ 待开始
    │
M9 数据与风控 ───────────────────────────────────────── ⏳ 待开始
```

---

## M1: 平台核心基础 ✅ 已完成

**目标**：搭建平台管理端基础框架，实现核心管理功能。

### 完成内容

| 模块 | 功能 | 后端 | 前端 |
|------|------|:----:|:----:|
| 身份认证 | 登录、Token刷新、密码重置 | ✅ | ✅ |
| 用户管理 | CRUD、批量操作、权限分配 | ✅ | ✅ |
| 角色权限 | 角色CRUD、权限配置、菜单管理 | ✅ | ✅ |
| 租户管理 | 租户CRUD、审核、角色模板 | ✅ | ✅ |
| 租户套餐 | 套餐CRUD、功能策略 | ✅ | ✅ |
| 商户管理 | 完整审核流程、文档、合同 | ✅ | ✅ |
| 门店管理 | 资质、营业时间、配送区域、费用 | ✅ | ✅ |
| 商品管理 | SKU、属性、加料、媒体、定价 | ✅ | ✅ |
| 订单管理 | 基础CRUD | ✅ | ✅ |
| 库存管理 | 锁定、扣减、调整、释放 | ✅ | ✅ |
| 字典参数 | 字典CRUD、系统参数 | ✅ | ✅ |
| 文件管理 | 文件上传 | ✅ | ✅ |

---

## M2: 租户订阅计费 ✅ 已完成

**目标**：实现 SaaS 变现核心，租户可订阅套餐、支付、续费。

### 完成内容

| 功能 | 后端 | 前端 | 说明 |
|------|:----:|:----:|------|
| 订阅列表 | ✅ | ✅ | 分页、多条件筛选 |
| 订阅详情 | ✅ | ✅ | 查看订阅详情 |
| 更新订阅 | ✅ | ✅ | 修改订阅信息 |
| 延期订阅 | ✅ | ✅ | 延长订阅期限 |
| 变更套餐 | ✅ | ✅ | 升级/降级套餐 |
| 更新订阅状态 | ✅ | ✅ | 状态变更 |
| 批量延期 | ✅ | ✅ | 批量操作 |
| 到期提醒 | ✅ | ✅ | 批量提醒 |
| 账单列表 | ✅ | ✅ | 分页、筛选 |
| 账单详情 | ✅ | ✅ | 查看详情 |
| 确认收款 | ✅ | ✅ | 一键确认 |
| 账单统计 | ✅ | ✅ | 统计页面 |
| 配额套餐 | ✅ | ✅ | 配额管理 |
| 配额购买 | ✅ | ✅ | 购买配额 |
| 配额告警 | ✅ | ✅ | 告警配置 |

---

## M3: 前后端联调验证 🔄 进行中

**目标**：验证前端页面与后端API的对接情况，补齐缺失的API。

### 待验证模块

以下模块前端页面已存在，需验证后端API是否完整：

| 模块 | 前端 | 后端 | 状态 |
|------|:----:|:----:|:----:|
| 营销活动 | ✅ | ⚠️ | 待验证 |
| 财务结算 | ✅ | ⚠️ | 待验证 |
| 内容管理 | ✅ | ⚠️ | 待验证 |
| 风控管理 | ✅ | ⚠️ | 待验证 |
| 客服工单 | ✅ | ⚠️ | 待验证 |
| 数据统计 | ✅ | ⚠️ | 待验证 |
| 系统配置 | ✅ | ⚠️ | 待验证 |

### 验证步骤

1. 逐个检查前端页面调用的API
2. 确认后端Controller是否存在
3. 补齐缺失的API
4. 联调测试

---

## M4: 订单交易闭环 ⏳ 待开始

**目标**：完善订单全生命周期，实现完整交易流程。

**依赖**：M3 完成

### 功能清单

| 功能 | 优先级 | 说明 |
|------|:------:|------|
| 订单状态机 | P0 | 完整状态流转 |
| 订单支付 | P0 | 支付状态处理 |
| 订单取消 | P0 | 取消流程 |
| 退款处理 | P0 | 退款流程 |
| 配送分配 | P1 | 骑手分配 |
| 配送追踪 | P1 | 配送状态 |
| 订单完成 | P1 | 完成确认 |
| 订单评价 | P2 | 评价入口 |
| 订单打印 | P2 | 小票打印 |

### 订单状态流转

```
待支付 → 已支付 → 商家接单 → 制作中 → 待配送 → 配送中 → 已完成
   ↓        ↓         ↓         ↓        ↓        ↓
 已取消   已退款    已取消    已取消   已取消   配送异常
```

---

## M5: 租户管理端 ⏳ 待开始

**目标**：为商户/租户提供独立管理后台。

**依赖**：M4 完成

### 功能清单

| 模块 | 功能 |
|------|------|
| 认证 | 租户用户登录、权限控制 |
| 门店 | 管理自己的门店 |
| 商品 | 管理自己的商品 |
| 订单 | 接单、处理订单 |
| 员工 | 管理门店员工 |
| 设置 | 营业时间、配送设置 |
| 报表 | 经营数据统计 |
| 财务 | 收入、提现 |

### 技术方案

- **后端**：TenantApi（新项目，复用 Domain/Infrastructure）
- **前端**：TenantUI（新项目，复用组件库）
- **认证**：独立 JWT，租户隔离

---

## M6: C端小程序 ⏳ 待开始

**目标**：消费者端小程序，实现浏览、下单、支付。

**依赖**：M5 完成

### 功能清单

| 模块 | 功能 |
|------|------|
| 认证 | 微信登录、手机号绑定 |
| 首页 | 门店推荐、搜索 |
| 门店 | 门店列表、详情、菜单 |
| 商品 | 商品详情、规格选择 |
| 购物车 | 购物车管理 |
| 订单 | 下单、支付、订单列表 |
| 配送 | 配送追踪 |
| 用户 | 地址管理、个人中心 |
| 优惠 | 优惠券、活动 |

### 技术方案

- **框架**：uni-app / Taro
- **后端**：CustomerApi（新项目）
- **支付**：微信支付

---

## M7: 营销与运营 ⏳ 待开始

**目标**：营销工具，提升订单转化。

**依赖**：M6 完成

### 功能清单

| 功能 | 说明 |
|------|------|
| 优惠券 | 创建、发放、核销 |
| 满减活动 | 满减规则配置 |
| 限时折扣 | 折扣活动 |
| 新人专享 | 新用户优惠 |
| 邀请有礼 | 邀请奖励 |
| Banner管理 | 轮播图配置 |
| 推送通知 | 消息推送 |

---

## M8: 财务结算 ⏳ 待开始

**目标**：商户结算、平台财务管理。

**依赖**：M6 完成

### 功能清单

| 功能 | 说明 |
|------|------|
| 佣金规则 | 佣金比例配置 |
| 结算周期 | 结算频率配置 |
| 结算单 | 结算单生成、审核 |
| 提现管理 | 提现申请、审核 |
| 发票管理 | 发票申请 |
| 财务报表 | 收支统计 |

---

## M9: 数据与风控 ⏳ 待开始

**目标**：数据分析、风险控制。

**依赖**：M7、M8 完成

### 功能清单

| 功能 | 说明 |
|------|------|
| Dashboard | 核心指标看板 |
| 订单统计 | 订单数据分析 |
| 销售统计 | 销售额分析 |
| 用户统计 | 用户增长分析 |
| 黑名单 | 用户/设备黑名单 |
| 风控规则 | 风险规则配置 |
| 敏感词 | 敏感词过滤 |

---

## 里程碑时间线（预估）

```
2026-02
├── M3: 前后端联调验证 (1周)

2026-02 ~ 2026-03
├── M4: 订单交易闭环 (3周)

2026-03 ~ 2026-04
├── M5: 租户管理端 (4周)

2026-04 ~ 2026-05
├── M6: C端小程序 (6周)

2026-06
├── M7: 营销与运营 (3周)
├── M8: 财务结算 (3周)

2026-07
├── M9: 数据与风控 (2周)
```

---

## 状态说明

- ✅ 已完成
- 🔄 进行中
- ⏳ 待开始
- ❌ 已取消

---

## 变更记录

| 日期 | 变更内容 |
|------|----------|
| 2026-02-02 | 更新文档，M1/M2已完成，新增M3联调验证阶段 |
| 2026-02-02 | 初始版本，定义 M1-M8 里程碑 |