docs: 添加项目功能清单和开发里程碑文档
- 01-功能清单.md: 列出平台端/租户端/C端所有功能及完成状态 - 02-开发里程碑.md: 定义M1-M8共8个开发里程碑 Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
This commit is contained in:
326
Roadmap/02-开发里程碑.md
Normal file
326
Roadmap/02-开发里程碑.md
Normal file
@@ -0,0 +1,326 @@
|
||||
# TakeoutSaaS 开发里程碑
|
||||
|
||||
> 最后更新:2026-02-02
|
||||
|
||||
本文档定义整个 SaaS 外卖系统的开发里程碑,按优先级和依赖关系排序。
|
||||
|
||||
---
|
||||
|
||||
## 里程碑概览
|
||||
|
||||
```
|
||||
M1 平台核心 ──────────────────────────────────────────── ✅ 已完成
|
||||
│
|
||||
M2 租户订阅计费 ─────────────────────────────────────── 🔄 进行中
|
||||
│
|
||||
M3 订单交易闭环 ─────────────────────────────────────── ⏳ 待开始
|
||||
│
|
||||
M4 租户管理端 ───────────────────────────────────────── ⏳ 待开始
|
||||
│
|
||||
M5 C端小程序 ────────────────────────────────────────── ⏳ 待开始
|
||||
│
|
||||
M6 营销与运营 ───────────────────────────────────────── ⏳ 待开始
|
||||
│
|
||||
M7 财务结算 ─────────────────────────────────────────── ⏳ 待开始
|
||||
│
|
||||
M8 数据与风控 ───────────────────────────────────────── ⏳ 待开始
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## M1: 平台核心基础 ✅ 已完成
|
||||
|
||||
**目标**:搭建平台管理端基础框架,实现核心管理功能。
|
||||
|
||||
### 完成内容
|
||||
|
||||
| 模块 | 功能 | 后端 | 前端 |
|
||||
|------|------|:----:|:----:|
|
||||
| 身份认证 | 登录、Token刷新、密码重置 | ✅ | ✅ |
|
||||
| 用户管理 | CRUD、批量操作、权限分配 | ✅ | ✅ |
|
||||
| 角色权限 | 角色CRUD、权限配置、菜单管理 | ✅ | ✅ |
|
||||
| 租户管理 | 租户CRUD、审核、角色模板 | ✅ | ✅ |
|
||||
| 租户套餐 | 套餐CRUD、功能策略 | ✅ | ✅ |
|
||||
| 商户管理 | 完整审核流程、文档、合同 | ✅ | ✅ |
|
||||
| 门店管理 | 资质、营业时间、配送区域、费用 | ✅ | ✅ |
|
||||
| 商品管理 | SKU、属性、加料、媒体、定价 | ✅ | ✅ |
|
||||
| 订单管理 | 基础CRUD | ✅ | ✅ |
|
||||
| 库存管理 | 锁定、扣减、调整、释放 | ✅ | ✅ |
|
||||
| 字典参数 | 字典CRUD、系统参数 | ✅ | ✅ |
|
||||
| 文件管理 | 文件上传 | ✅ | ✅ |
|
||||
|
||||
---
|
||||
|
||||
## M2: 租户订阅计费 🔄 进行中
|
||||
|
||||
**目标**:实现 SaaS 变现核心,租户可订阅套餐、支付、续费。
|
||||
|
||||
**预计周期**:2 周
|
||||
|
||||
### 功能清单
|
||||
|
||||
| 功能 | 优先级 | 说明 |
|
||||
|------|:------:|------|
|
||||
| 租户订阅实体 | P0 | 订阅数据模型设计 |
|
||||
| 订阅订单实体 | P0 | 订单数据模型设计 |
|
||||
| 创建订阅 | P0 | 新租户开通订阅 |
|
||||
| 订阅状态管理 | P0 | 生效/过期/取消 |
|
||||
| 订阅订单管理 | P0 | 订单CRUD |
|
||||
| 手动确认支付 | P0 | 后台确认收款 |
|
||||
| 续费处理 | P1 | 续费逻辑 |
|
||||
| 升降级处理 | P1 | 套餐变更 |
|
||||
| 到期提醒 | P1 | 到期前通知 |
|
||||
| 过期处理 | P1 | 过期后降级/停用 |
|
||||
| 账单记录 | P2 | 账单历史 |
|
||||
| 配额检查 | P2 | 套餐配额限制 |
|
||||
|
||||
### 数据模型
|
||||
|
||||
```
|
||||
tenant_subscriptions (租户订阅)
|
||||
├── id
|
||||
├── tenant_id
|
||||
├── package_id
|
||||
├── subscription_type (月付/年付)
|
||||
├── status (待支付/生效中/已过期/已取消)
|
||||
├── start_date
|
||||
├── end_date
|
||||
├── auto_renew
|
||||
├── price_locked
|
||||
├── created_at
|
||||
└── updated_at
|
||||
|
||||
subscription_orders (订阅订单)
|
||||
├── id
|
||||
├── tenant_id
|
||||
├── subscription_id
|
||||
├── package_id
|
||||
├── order_type (新购/续费/升级/降级)
|
||||
├── subscription_type
|
||||
├── amount
|
||||
├── payment_status
|
||||
├── payment_method
|
||||
├── paid_at
|
||||
├── transaction_id
|
||||
└── created_at
|
||||
```
|
||||
|
||||
### API 设计
|
||||
|
||||
```
|
||||
# 订阅管理
|
||||
GET /api/admin/v1/tenants/{tenantId}/subscription
|
||||
POST /api/admin/v1/tenants/{tenantId}/subscription
|
||||
PUT /api/admin/v1/tenants/{tenantId}/subscription
|
||||
DELETE /api/admin/v1/tenants/{tenantId}/subscription
|
||||
|
||||
# 订阅订单
|
||||
GET /api/admin/v1/subscription-orders
|
||||
GET /api/admin/v1/subscription-orders/{orderId}
|
||||
POST /api/admin/v1/subscription-orders
|
||||
PUT /api/admin/v1/subscription-orders/{orderId}/confirm-payment
|
||||
```
|
||||
|
||||
### 前端页面
|
||||
|
||||
- 租户订阅管理页
|
||||
- 订阅订单列表页
|
||||
- 租户详情-订阅Tab
|
||||
|
||||
---
|
||||
|
||||
## M3: 订单交易闭环 ⏳ 待开始
|
||||
|
||||
**目标**:完善订单全生命周期,实现完整交易流程。
|
||||
|
||||
**预计周期**:3 周
|
||||
|
||||
**依赖**:M2 完成
|
||||
|
||||
### 功能清单
|
||||
|
||||
| 功能 | 优先级 | 说明 |
|
||||
|------|:------:|------|
|
||||
| 订单状态机 | P0 | 完整状态流转 |
|
||||
| 订单支付 | P0 | 支付状态处理 |
|
||||
| 订单取消 | P0 | 取消流程 |
|
||||
| 退款处理 | P0 | 退款流程 |
|
||||
| 配送分配 | P1 | 骑手分配 |
|
||||
| 配送追踪 | P1 | 配送状态 |
|
||||
| 订单完成 | P1 | 完成确认 |
|
||||
| 订单评价 | P2 | 评价入口 |
|
||||
| 订单打印 | P2 | 小票打印 |
|
||||
|
||||
### 订单状态流转
|
||||
|
||||
```
|
||||
待支付 → 已支付 → 商家接单 → 制作中 → 待配送 → 配送中 → 已完成
|
||||
↓ ↓ ↓ ↓ ↓ ↓
|
||||
已取消 已退款 已取消 已取消 已取消 配送异常
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## M4: 租户管理端 ⏳ 待开始
|
||||
|
||||
**目标**:为商户/租户提供独立管理后台。
|
||||
|
||||
**预计周期**:4 周
|
||||
|
||||
**依赖**:M3 完成
|
||||
|
||||
### 功能清单
|
||||
|
||||
| 模块 | 功能 |
|
||||
|------|------|
|
||||
| 认证 | 租户用户登录、权限控制 |
|
||||
| 门店 | 管理自己的门店 |
|
||||
| 商品 | 管理自己的商品 |
|
||||
| 订单 | 接单、处理订单 |
|
||||
| 员工 | 管理门店员工 |
|
||||
| 设置 | 营业时间、配送设置 |
|
||||
| 报表 | 经营数据统计 |
|
||||
| 财务 | 收入、提现 |
|
||||
|
||||
### 技术方案
|
||||
|
||||
- **后端**:TenantApi(新项目,复用 Domain/Infrastructure)
|
||||
- **前端**:TenantUI(新项目,复用组件库)
|
||||
- **认证**:独立 JWT,租户隔离
|
||||
|
||||
---
|
||||
|
||||
## M5: C端小程序 ⏳ 待开始
|
||||
|
||||
**目标**:消费者端小程序,实现浏览、下单、支付。
|
||||
|
||||
**预计周期**:6 周
|
||||
|
||||
**依赖**:M4 完成
|
||||
|
||||
### 功能清单
|
||||
|
||||
| 模块 | 功能 |
|
||||
|------|------|
|
||||
| 认证 | 微信登录、手机号绑定 |
|
||||
| 首页 | 门店推荐、搜索 |
|
||||
| 门店 | 门店列表、详情、菜单 |
|
||||
| 商品 | 商品详情、规格选择 |
|
||||
| 购物车 | 购物车管理 |
|
||||
| 订单 | 下单、支付、订单列表 |
|
||||
| 配送 | 配送追踪 |
|
||||
| 用户 | 地址管理、个人中心 |
|
||||
| 优惠 | 优惠券、活动 |
|
||||
|
||||
### 技术方案
|
||||
|
||||
- **框架**:uni-app / Taro
|
||||
- **后端**:CustomerApi(新项目)
|
||||
- **支付**:微信支付
|
||||
|
||||
---
|
||||
|
||||
## M6: 营销与运营 ⏳ 待开始
|
||||
|
||||
**目标**:营销工具,提升订单转化。
|
||||
|
||||
**预计周期**:3 周
|
||||
|
||||
**依赖**:M5 完成
|
||||
|
||||
### 功能清单
|
||||
|
||||
| 功能 | 说明 |
|
||||
|------|------|
|
||||
| 优惠券 | 创建、发放、核销 |
|
||||
| 满减活动 | 满减规则配置 |
|
||||
| 限时折扣 | 折扣活动 |
|
||||
| 新人专享 | 新用户优惠 |
|
||||
| 邀请有礼 | 邀请奖励 |
|
||||
| Banner管理 | 轮播图配置 |
|
||||
| 推送通知 | 消息推送 |
|
||||
|
||||
---
|
||||
|
||||
## M7: 财务结算 ⏳ 待开始
|
||||
|
||||
**目标**:商户结算、平台财务管理。
|
||||
|
||||
**预计周期**:3 周
|
||||
|
||||
**依赖**:M5 完成
|
||||
|
||||
### 功能清单
|
||||
|
||||
| 功能 | 说明 |
|
||||
|------|------|
|
||||
| 佣金规则 | 佣金比例配置 |
|
||||
| 结算周期 | 结算频率配置 |
|
||||
| 结算单 | 结算单生成、审核 |
|
||||
| 提现管理 | 提现申请、审核 |
|
||||
| 发票管理 | 发票申请 |
|
||||
| 财务报表 | 收支统计 |
|
||||
|
||||
---
|
||||
|
||||
## M8: 数据与风控 ⏳ 待开始
|
||||
|
||||
**目标**:数据分析、风险控制。
|
||||
|
||||
**预计周期**:2 周
|
||||
|
||||
**依赖**:M6、M7 完成
|
||||
|
||||
### 功能清单
|
||||
|
||||
| 功能 | 说明 |
|
||||
|------|------|
|
||||
| Dashboard | 核心指标看板 |
|
||||
| 订单统计 | 订单数据分析 |
|
||||
| 销售统计 | 销售额分析 |
|
||||
| 用户统计 | 用户增长分析 |
|
||||
| 黑名单 | 用户/设备黑名单 |
|
||||
| 风控规则 | 风险规则配置 |
|
||||
| 敏感词 | 敏感词过滤 |
|
||||
|
||||
---
|
||||
|
||||
## 里程碑时间线(预估)
|
||||
|
||||
```
|
||||
2026-02
|
||||
├── M2: 租户订阅计费 (2周)
|
||||
|
||||
2026-03
|
||||
├── M3: 订单交易闭环 (3周)
|
||||
|
||||
2026-04
|
||||
├── M4: 租户管理端 (4周)
|
||||
|
||||
2026-05 ~ 2026-06
|
||||
├── M5: C端小程序 (6周)
|
||||
|
||||
2026-07
|
||||
├── M6: 营销与运营 (3周)
|
||||
├── M7: 财务结算 (3周)
|
||||
|
||||
2026-08
|
||||
├── M8: 数据与风控 (2周)
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 状态说明
|
||||
|
||||
- ✅ 已完成
|
||||
- 🔄 进行中
|
||||
- ⏳ 待开始
|
||||
- ❌ 已取消
|
||||
|
||||
---
|
||||
|
||||
## 变更记录
|
||||
|
||||
| 日期 | 变更内容 |
|
||||
|------|----------|
|
||||
| 2026-02-02 | 初始版本,定义 M1-M8 里程碑 |
|
||||
Reference in New Issue
Block a user