TakeoutSaaS.Docs/Roadmap/02-开发里程碑.md

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 里程碑