msumshk/TakeoutSaaS.Docs
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs: 更新功能清单和里程碑文档

Browse Source 
- 修正功能完成状态，M1/M2已完成
- 新增M3前后端联调验证阶段
- 区分后端/前端完成状态
- 标记待验证模块（前端有页面，后端待验证）

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
This commit is contained in:
MSuMshk
2026-02-02 11:13:46 +08:00
parent 935fd7a997
commit 657849a5f7
2 changed files with 371 additions and 351 deletions
Download Patch File Download Diff File Expand all files Collapse all files

196
Roadmap/02-开发里程碑.md
View File

@@ -9,21 +9,23 @@
## 里程碑概览
```
M1 平台核心 ──────────────────────────────────────────── ✅ 已完成
M1 平台核心基础 ─────────────────────────────────────── ✅ 已完成
│
M2 租户订阅计费 ─────────────────────────────────────── 🔄 进行中
M2 租户订阅计费 ─────────────────────────────────────── ✅ 已完成
│
M3 订单交易闭环 ─────────────────────────────────────── ⏳ 待开始
M3 前后端联调验证 ───────────────────────────────────── 🔄 进行中
│
M4 租户管理端 ───────────────────────────────────────── ⏳ 待开始
M4 订单交易闭环 ─────────────────────────────────────── ⏳ 待开始
│
M5 C端小程序 ────────────────────────────────────────── ⏳ 待开始
M5 租户管理端 ───────────────────────────────────────── ⏳ 待开始
│
M6 营销与运营 ───────────────────────────────────────── ⏳ 待开始
M6 C端小程序 ────────────────────────────────────────── ⏳ 待开始
│
M7 财务结算 ─────────────────────────────────────────── ⏳ 待开始
M7 营销与运营 ───────────────────────────────────────── ⏳ 待开始
│
M8 数据与风控 ───────────────────────────────────────── ⏳ 待开始
M8 财务结算 ─────────────────────────────────────────── ⏳ 待开始
│
M9 数据与风控 ───────────────────────────────────────── ⏳ 待开始
```
---
@@ -51,91 +53,64 @@ M8 数据与风控 ────────────────────
---
## M2: 租户订阅计费 🔄 进行中
## 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: 订单交易闭环 ⏳ 待开始
## M3: 前后端联调验证 🔄 进行中
**目标**：验证前端页面与后端API的对接情况，补齐缺失的API。
### 待验证模块
以下模块前端页面已存在，需验证后端API是否完整：
| 模块 | 前端 | 后端 | 状态 |
|------|:----:|:----:|:----:|
| 营销活动 | ✅ | ⚠️ | 待验证 |
| 财务结算 | ✅ | ⚠️ | 待验证 |
| 内容管理 | ✅ | ⚠️ | 待验证 |
| 风控管理 | ✅ | ⚠️ | 待验证 |
| 客服工单 | ✅ | ⚠️ | 待验证 |
| 数据统计 | ✅ | ⚠️ | 待验证 |
| 系统配置 | ✅ | ⚠️ | 待验证 |
### 验证步骤
1. 逐个检查前端页面调用的API
2. 确认后端Controller是否存在
3. 补齐缺失的API
4. 联调测试
---
## M4: 订单交易闭环 ⏳ 待开始
**目标**：完善订单全生命周期，实现完整交易流程。
**预计周期**：3 周
**依赖**：M2 完成
**依赖**：M3 完成
### 功能清单
@@ -161,13 +136,11 @@ PUT /api/admin/v1/subscription-orders/{orderId}/confirm-payment
---
## M4: 租户管理端 ⏳ 待开始
## M5: 租户管理端 ⏳ 待开始
**目标**：为商户/租户提供独立管理后台。
**预计周期**：4 周
**依赖**：M3 完成
**依赖**：M4 完成
### 功能清单
@@ -190,13 +163,11 @@ PUT /api/admin/v1/subscription-orders/{orderId}/confirm-payment
---
## M5: C端小程序 ⏳ 待开始
## M6: C端小程序 ⏳ 待开始
**目标**：消费者端小程序，实现浏览、下单、支付。
**预计周期**：6 周
**依赖**：M4 完成
**依赖**：M5 完成
### 功能清单
@@ -220,13 +191,11 @@ PUT /api/admin/v1/subscription-orders/{orderId}/confirm-payment
---
## M6: 营销与运营 ⏳ 待开始
## M7: 营销与运营 ⏳ 待开始
**目标**：营销工具，提升订单转化。
**预计周期**：3 周
**依赖**：M5 完成
**依赖**：M6 完成
### 功能清单
@@ -242,13 +211,11 @@ PUT /api/admin/v1/subscription-orders/{orderId}/confirm-payment
---
## M7: 财务结算 ⏳ 待开始
## M8: 财务结算 ⏳ 待开始
**目标**：商户结算、平台财务管理。
**预计周期**：3 周
**依赖**：M5 完成
**依赖**：M6 完成
### 功能清单
@@ -263,13 +230,11 @@ PUT /api/admin/v1/subscription-orders/{orderId}/confirm-payment
---
## M8: 数据与风控 ⏳ 待开始
## M9: 数据与风控 ⏳ 待开始
**目标**：数据分析、风险控制。
**预计周期**：2 周
**依赖**：M6、M7 完成
**依赖**：M7、M8 完成
### 功能清单
@@ -289,23 +254,23 @@ PUT /api/admin/v1/subscription-orders/{orderId}/confirm-payment
```
2026-02
├── M2: 租户订阅计费 (2周)
├── M3: 前后端联调验证 (1周)
2026-03
├── M3: 订单交易闭环 (3周)
2026-02 ~ 2026-03
├── M4: 订单交易闭环 (3周)
2026-04
├── M4: 租户管理端 (4周)
2026-03 ~ 2026-04
├── M5: 租户管理端 (4周)
2026-05 ~ 2026-06
├── M5: C端小程序 (6周)
2026-04 ~ 2026-05
├── M6: C端小程序 (6周)
2026-06
├── M7: 营销与运营 (3周)
├── M8: 财务结算 (3周)
2026-07
├── M6: 营销与运营 (3周)
├── M7: 财务结算 (3周)
2026-08
├── M8: 数据与风控 (2周)
├── M9: 数据与风控 (2周)
```
---
@@ -323,4 +288,5 @@ PUT /api/admin/v1/subscription-orders/{orderId}/confirm-payment
| 日期 | 变更内容 |
|------|----------|
| 2026-02-02 | 更新文档，M1/M2已完成，新增M3联调验证阶段 |
| 2026-02-02 | 初始版本，定义 M1-M8 里程碑 |