From 657849a5f7efa354d1a3e750f4707245dc8a0aaf Mon Sep 17 00:00:00 2001 From: MSuMshk <173331402+msumshk@users.noreply.github.com> Date: Mon, 2 Feb 2026 11:13:46 +0800 Subject: [PATCH] =?UTF-8?q?docs:=20=E6=9B=B4=E6=96=B0=E5=8A=9F=E8=83=BD?= =?UTF-8?q?=E6=B8=85=E5=8D=95=E5=92=8C=E9=87=8C=E7=A8=8B=E7=A2=91=E6=96=87?= =?UTF-8?q?=E6=A1=A3?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - 修正功能完成状态，M1/M2已完成 - 新增M3前后端联调验证阶段 - 区分后端/前端完成状态 - 标记待验证模块（前端有页面，后端待验证） Co-Authored-By: Claude Opus 4.5 --- Roadmap/01-功能清单.md | 526 +++++++++++++++++++++------------------ Roadmap/02-开发里程碑.md | 196 ++++++--------- 2 files changed, 371 insertions(+), 351 deletions(-) diff --git a/Roadmap/01-功能清单.md b/Roadmap/01-功能清单.md index b33dfe8..2b3e6ee 100644 --- a/Roadmap/01-功能清单.md +++ b/Roadmap/01-功能清单.md @@ -12,252 +12,277 @@ ### 1. 身份认证与授权 -| 功能 | 状态 | 说明 | -|------|:----:|------| -| 平台用户登录 | ✅ | 账号密码登录 | -| JWT Token 刷新 | ✅ | 无感刷新 | -| 密码重置 | ✅ | 通过重置链接 | -| 用户信息获取 | ✅ | 当前登录用户 | -| 动态菜单加载 | ✅ | 基于权限过滤 | +| 功能 | 后端 | 前端 | 说明 | +|------|:----:|:----:|------| +| 平台用户登录 | ✅ | ✅ | 账号密码登录 | +| JWT Token 刷新 | ✅ | ✅ | 无感刷新 | +| 密码重置 | ✅ | ✅ | 通过重置链接 | +| 用户信息获取 | ✅ | ✅ | 当前登录用户 | +| 动态菜单加载 | ✅ | ✅ | 基于权限过滤 | ### 2. 用户管理 -| 功能 | 状态 | 说明 | -|------|:----:|------| -| 用户列表查询 | ✅ | 分页、筛选 | -| 用户详情 | ✅ | 查看用户信息 | -| 创建用户 | ✅ | 新增平台用户 | -| 编辑用户 | ✅ | 修改用户信息 | -| 删除/恢复用户 | ✅ | 软删除 | -| 用户状态变更 | ✅ | 启用/禁用/解锁 | -| 重置用户密码 | ✅ | 生成重置链接 | -| 批量操作 | ✅ | 批量启用/禁用/删除/导出 | -| 用户权限查询 | ✅ | 查看用户权限列表 | +| 功能 | 后端 | 前端 | 说明 | +|------|:----:|:----:|------| +| 用户列表查询 | ✅ | ✅ | 分页、筛选 | +| 用户详情 | ✅ | ✅ | 查看用户信息 | +| 创建用户 | ✅ | ✅ | 新增平台用户 | +| 编辑用户 | ✅ | ✅ | 修改用户信息 | +| 删除/恢复用户 | ✅ | ✅ | 软删除 | +| 用户状态变更 | ✅ | ✅ | 启用/禁用/解锁 | +| 重置用户密码 | ✅ | ✅ | 生成重置链接 | +| 批量操作 | ✅ | ✅ | 批量启用/禁用/删除/导出 | +| 用户权限查询 | ✅ | ✅ | 查看用户权限列表 | ### 3. 角色权限管理 -| 功能 | 状态 | 说明 | -|------|:----:|------| -| 平台角色列表 | ✅ | 分页查询 | -| 创建角色 | ✅ | 新增角色 | -| 编辑角色 | ✅ | 修改角色信息 | -| 删除角色 | ✅ | 删除角色 | -| 角色权限配置 | ✅ | 分配权限 | -| 克隆角色 | ✅ | 复制角色及权限 | -| 权限树查询 | ✅ | 按门户类型 | -| 菜单管理 | ✅ | 菜单CRUD | +| 功能 | 后端 | 前端 | 说明 | +|------|:----:|:----:|------| +| 平台角色列表 | ✅ | ✅ | 分页查询 | +| 创建角色 | ✅ | ✅ | 新增角色 | +| 编辑角色 | ✅ | ✅ | 修改角色信息 | +| 删除角色 | ✅ | ✅ | 删除角色 | +| 角色权限配置 | ✅ | ✅ | 分配权限 | +| 克隆角色 | ✅ | ✅ | 复制角色及权限 | +| 权限树查询 | ✅ | ✅ | 按门户类型 | +| 菜单管理 | ✅ | ✅ | 菜单CRUD | +| 角色模板 | ✅ | ✅ | 预设角色模板 | ### 4. 租户管理 -| 功能 | 状态 | 说明 | -|------|:----:|------| -| 租户列表 | ✅ | 分页、筛选 | -| 创建租户 | ✅ | 新增租户 | -| 编辑租户 | ✅ | 修改租户信息 | -| 租户详情 | ✅ | 查看租户详情 | -| 租户审核 | ✅ | 审核租户申请 | -| 租户角色管理 | ✅ | 管理租户内角色 | -| 租户菜单配置 | ✅ | 配置租户可用菜单 | -| 角色模板 | ✅ | 预设角色模板 | +| 功能 | 后端 | 前端 | 说明 | +|------|:----:|:----:|------| +| 租户列表 | ✅ | ✅ | 分页、筛选 | +| 创建租户 | ✅ | ✅ | 新增租户 | +| 编辑租户 | ✅ | ✅ | 修改租户信息 | +| 租户详情 | ✅ | ✅ | 查看租户详情 | +| 租户审核 | ✅ | ✅ | 审核租户申请 | +| 租户角色管理 | ✅ | ✅ | 管理租户内角色 | +| 租户菜单配置 | ✅ | ✅ | 配置租户可用菜单 | +| 租户冻结/解冻 | ✅ | ✅ | 冻结租户 | +| 重置租户管理员 | ✅ | ✅ | 重置管理员密码 | +| 租户模拟登录 | ✅ | ✅ | 模拟租户登录 | ### 5. 租户套餐 -| 功能 | 状态 | 说明 | -|------|:----:|------| -| 套餐列表 | ✅ | 分页查询 | -| 创建套餐 | ✅ | 定义套餐内容 | -| 编辑套餐 | ✅ | 修改套餐 | -| 套餐详情 | ✅ | 查看套餐配置 | -| 套餐发布/下架 | ✅ | 控制套餐可见性 | -| 功能策略配置 | ✅ | JSON配置功能开关 | +| 功能 | 后端 | 前端 | 说明 | +|------|:----:|:----:|------| +| 套餐列表 | ✅ | ✅ | 分页查询 | +| 创建套餐 | ✅ | ✅ | 定义套餐内容 | +| 编辑套餐 | ✅ | ✅ | 修改套餐 | +| 套餐详情 | ✅ | ✅ | 查看套餐配置 | +| 套餐发布/下架 | ✅ | ✅ | 控制套餐可见性 | +| 功能策略配置 | ✅ | ✅ | JSON配置功能开关 | +| 套餐配额配置 | ✅ | ✅ | 配额限制 | -### 6. 租户订阅计费 ⭐ +### 6. 租户订阅管理 -| 功能 | 状态 | 说明 | -|------|:----:|------| -| 租户订阅管理 | ❌ | 查看/管理租户订阅 | -| 订阅订单列表 | ❌ | 订阅支付订单 | -| 手动开通订阅 | ❌ | 后台开通 | -| 续费管理 | ❌ | 续费/到期处理 | -| 升降级处理 | ❌ | 套餐变更 | -| 账单管理 | ❌ | 账单记录 | +| 功能 | 后端 | 前端 | 说明 | +|------|:----:|:----:|------| +| 订阅列表 | ✅ | ✅ | 分页、多条件筛选 | +| 订阅详情 | ✅ | ✅ | 查看订阅详情 | +| 更新订阅 | ✅ | ✅ | 修改订阅信息 | +| 延期订阅 | ✅ | ✅ | 延长订阅期限 | +| 变更套餐 | ✅ | ✅ | 升级/降级套餐 | +| 更新订阅状态 | ✅ | ✅ | 状态变更 | +| 批量延期 | ✅ | ✅ | 批量操作 | +| 到期提醒 | ✅ | ✅ | 批量提醒 | -### 7. 商户管理 +### 7. 账单管理 -| 功能 | 状态 | 说明 | -|------|:----:|------| -| 商户列表 | ✅ | 分页、筛选 | -| 创建商户 | ✅ | 新增商户 | -| 编辑商户 | ✅ | 修改商户信息 | -| 商户详情 | ✅ | 查看商户详情 | -| 商户审核 | ✅ | 审核流程（认领/审批/驳回/撤销） | -| 商户文档管理 | ✅ | 上传/审核资质文档 | -| 商户合同管理 | ✅ | 合同CRUD | -| 审计历史 | ✅ | 操作记录 | -| 变更历史 | ✅ | 字段变更记录 | -| 导出PDF | ✅ | 商户资料导出 | -| 商户分类 | ✅ | 分类管理 | +| 功能 | 后端 | 前端 | 说明 | +|------|:----:|:----:|------| +| 账单列表 | ✅ | ✅ | 分页、多条件筛选 | +| 账单详情 | ✅ | ✅ | 查看账单详情 | +| 创建账单 | ✅ | ✅ | 手动创建账单 | +| 确认收款 | ✅ | ✅ | 一键确认收款 | +| 账单导出 | ✅ | ✅ | 导出账单 | +| 账单统计 | ✅ | ✅ | 统计页面 | -### 8. 门店管理 +### 8. 配额套餐 -| 功能 | 状态 | 说明 | -|------|:----:|------| -| 门店列表 | ✅ | 分页、筛选 | -| 创建门店 | ✅ | 新增门店 | -| 编辑门店 | ✅ | 修改门店信息 | -| 门店详情 | ✅ | 查看门店详情 | -| 门店审核 | ✅ | 提交审核 | -| 营业状态切换 | ✅ | 开业/歇业 | -| 门店资质管理 | ✅ | 资质CRUD、完整性检查 | -| 营业时间管理 | ✅ | 营业时间CRUD、批量更新 | -| 配送区域管理 | ✅ | 配送区域CRUD、覆盖检查 | -| 门店费用配置 | ✅ | 配送费、包装费等 | -| 节假日管理 | ✅ | 特殊营业时间 | -| 门店员工管理 | ✅ | 员工CRUD | -| 桌台区域管理 | ✅ | 堂食桌台 | -| 班次管理 | ✅ | 员工排班 | -| 自提配置 | ✅ | 自提点设置 | +| 功能 | 后端 | 前端 | 说明 | +|------|:----:|:----:|------| +| 配额套餐列表 | ✅ | ✅ | 套餐管理 | +| 配额套餐CRUD | ✅ | ✅ | 增删改查 | +| 租户配额使用 | ✅ | ✅ | 使用情况 | +| 购买配额 | ✅ | ✅ | 配额购买 | +| 配额告警配置 | ✅ | ✅ | 告警设置 | -### 9. 商品管理 +### 9. 商户管理 -| 功能 | 状态 | 说明 | -|------|:----:|------| -| 商品列表 | ✅ | 分页、筛选 | -| 创建商品 | ✅ | 新增商品 | -| 编辑商品 | ✅ | 修改商品信息 | -| 商品详情 | ✅ | 查看商品详情 | -| 商品上下架 | ✅ | 发布/下架 | -| SKU管理 | ✅ | 规格管理 | -| 商品属性 | ✅ | 属性管理 | -| 加料管理 | ✅ | 加料选项 | -| 商品媒体 | ✅ | 图片/视频 | -| 定价规则 | ✅ | 价格策略 | -| 商品分类 | ⚠️ | 基础完成，待完善 | +| 功能 | 后端 | 前端 | 说明 | +|------|:----:|:----:|------| +| 商户列表 | ✅ | ✅ | 分页、筛选 | +| 创建商户 | ✅ | ✅ | 新增商户 | +| 编辑商户 | ✅ | ✅ | 修改商户信息 | +| 商户详情 | ✅ | ✅ | 查看商户详情 | +| 商户审核 | ✅ | ✅ | 审核流程（认领/审批/驳回/撤销） | +| 商户文档管理 | ✅ | ✅ | 上传/审核资质文档 | +| 商户合同管理 | ✅ | ✅ | 合同CRUD | +| 审计历史 | ✅ | ✅ | 操作记录 | +| 变更历史 | ✅ | ✅ | 字段变更记录 | +| 导出PDF | ✅ | ✅ | 商户资料导出 | +| 商户分类 | ✅ | ✅ | 分类管理 | +| 商户员工 | ✅ | ✅ | 员工管理 | -### 10. 订单管理 +### 10. 门店管理 -| 功能 | 状态 | 说明 | -|------|:----:|------| -| 订单列表 | ✅ | 分页、筛选 | -| 订单详情 | ✅ | 查看订单详情 | -| 创建订单 | ✅ | 后台创建 | -| 编辑订单 | ✅ | 修改订单 | -| 删除订单 | ✅ | 删除订单 | -| 订单状态流转 | ❌ | 完整状态机 | -| 订单取消/退款 | ❌ | 取消退款流程 | -| 订单备注 | ❌ | 商家备注 | -| 订单打印 | ❌ | 小票打印 | +| 功能 | 后端 | 前端 | 说明 | +|------|:----:|:----:|------| +| 门店列表 | ✅ | ✅ | 分页、筛选 | +| 创建门店 | ✅ | ✅ | 新增门店 | +| 编辑门店 | ✅ | ✅ | 修改门店信息 | +| 门店详情 | ✅ | ✅ | 查看门店详情 | +| 门店审核 | ✅ | ✅ | 提交审核 | +| 营业状态切换 | ✅ | ✅ | 开业/歇业 | +| 门店资质管理 | ✅ | ✅ | 资质CRUD、完整性检查 | +| 营业时间管理 | ✅ | ✅ | 营业时间CRUD、批量更新 | +| 配送区域管理 | ✅ | ✅ | 配送区域CRUD、覆盖检查 | +| 门店费用配置 | ✅ | ✅ | 配送费、包装费等 | +| 节假日管理 | ✅ | ✅ | 特殊营业时间 | +| 门店员工管理 | ✅ | ✅ | 员工CRUD | +| 桌台区域管理 | ✅ | ✅ | 堂食桌台 | +| 班次管理 | ✅ | ✅ | 员工排班 | +| 自提配置 | ✅ | ✅ | 自提点设置 | +| 门店审计日志 | ✅ | ✅ | 操作记录 | -### 11. 配送管理 +### 11. 商品管理 -| 功能 | 状态 | 说明 | -|------|:----:|------| -| 配送单列表 | ✅ | 基础CRUD | -| 配送单详情 | ⚠️ | 待完善 | -| 骑手分配 | ❌ | 分配骑手 | -| 配送追踪 | ❌ | 实时位置 | -| 配送完成确认 | ❌ | 签收确认 | -| 配送异常处理 | ❌ | 异常流程 | +| 功能 | 后端 | 前端 | 说明 | +|------|:----:|:----:|------| +| 商品列表 | ✅ | ✅ | 分页、筛选 | +| 创建商品 | ✅ | ✅ | 新增商品 | +| 编辑商品 | ✅ | ✅ | 修改商品信息 | +| 商品详情 | ✅ | ✅ | 查看商品详情 | +| 商品上下架 | ✅ | ✅ | 发布/下架 | +| SKU管理 | ✅ | ✅ | 规格管理 | +| 商品属性 | ✅ | ✅ | 属性管理 | +| 加料管理 | ✅ | ✅ | 加料选项 | +| 商品媒体 | ✅ | ✅ | 图片/视频 | +| 定价规则 | ✅ | ✅ | 价格策略 | +| 商品分类 | ✅ | ✅ | 分类管理 | -### 12. 支付管理 +### 12. 订单管理 -| 功能 | 状态 | 说明 | -|------|:----:|------| -| 支付记录列表 | ✅ | 基础查询 | -| 支付详情 | ⚠️ | 待完善 | -| 退款处理 | ❌ | 退款流程 | -| 支付对账 | ❌ | 对账功能 | -| 支付渠道配置 | ⚠️ | 页面有，API待完善 | +| 功能 | 后端 | 前端 | 说明 | +|------|:----:|:----:|------| +| 订单列表 | ✅ | ✅ | 分页、筛选 | +| 订单详情 | ✅ | ✅ | 查看订单详情 | +| 创建订单 | ✅ | ✅ | 后台创建 | +| 编辑订单 | ✅ | ✅ | 修改订单 | +| 删除订单 | ✅ | ✅ | 删除订单 | +| 订单状态流转 | ⚠️ | ⚠️ | 基础完成，待完善状态机 | -### 13. 库存管理 +### 13. 配送管理 -| 功能 | 状态 | 说明 | -|------|:----:|------| -| 库存列表 | ✅ | 查询库存 | -| 库存锁定 | ✅ | 下单锁定 | -| 库存扣减 | ✅ | 支付扣减 | -| 库存调整 | ✅ | 手动调整 | -| 库存释放 | ✅ | 取消释放 | -| 库存预警 | ❌ | 低库存提醒 | -| 库存盘点 | ❌ | 盘点功能 | +| 功能 | 后端 | 前端 | 说明 | +|------|:----:|:----:|------| +| 配送单列表 | ✅ | ✅ | 分页查询 | +| 配送单详情 | ✅ | ✅ | 查看详情 | +| 创建配送单 | ✅ | ✅ | 创建配送 | +| 更新配送单 | ✅ | ✅ | 更新状态 | +| 删除配送单 | ✅ | ✅ | 删除配送 | -### 14. 字典与参数 +### 14. 支付管理 -| 功能 | 状态 | 说明 | -|------|:----:|------| -| 字典分组管理 | ✅ | 分组CRUD | -| 字典条目管理 | ✅ | 条目CRUD | -| 批量获取字典 | ✅ | 带缓存 | -| 标签覆盖 | ✅ | 多语言/租户定制 | -| 系统参数 | ✅ | 系统配置 | -| 缓存指标 | ✅ | 缓存监控 | +| 功能 | 后端 | 前端 | 说明 | +|------|:----:|:----:|------| +| 支付记录列表 | ✅ | ✅ | 分页查询 | +| 支付详情 | ✅ | ✅ | 查看详情 | +| 创建支付记录 | ✅ | ✅ | 创建记录 | +| 更新支付记录 | ✅ | ✅ | 更新状态 | +| 删除支付记录 | ✅ | ✅ | 删除记录 | -### 15. 文件管理 +### 15. 库存管理 -| 功能 | 状态 | 说明 | -|------|:----:|------| -| 文件上传 | ✅ | 图片/文档上传 | -| 文件分类 | ✅ | 按类型分类 | +| 功能 | 后端 | 前端 | 说明 | +|------|:----:|:----:|------| +| 库存列表 | ✅ | ✅ | 查询库存 | +| 库存锁定 | ✅ | ✅ | 下单锁定 | +| 库存扣减 | ✅ | ✅ | 支付扣减 | +| 库存调整 | ✅ | ✅ | 手动调整 | +| 库存释放 | ✅ | ✅ | 取消释放 | +| 库存批次 | ✅ | ✅ | 批次管理 | -### 16. 营销活动 +### 16. 字典与参数 -| 功能 | 状态 | 说明 | -|------|:----:|------| -| 优惠券管理 | ❌ | 优惠券CRUD | -| 满减活动 | ❌ | 满减规则 | -| 限时折扣 | ❌ | 折扣活动 | -| 新人专享 | ❌ | 新用户优惠 | -| 邀请有礼 | ❌ | 邀请奖励 | -| 活动数据统计 | ❌ | 活动效果 | +| 功能 | 后端 | 前端 | 说明 | +|------|:----:|:----:|------| +| 字典分组管理 | ✅ | ✅ | 分组CRUD | +| 字典条目管理 | ✅ | ✅ | 条目CRUD | +| 批量获取字典 | ✅ | ✅ | 带缓存 | +| 标签覆盖 | ✅ | ✅ | 多语言/租户定制 | +| 系统参数 | ✅ | ✅ | 系统配置 | +| 缓存指标 | ✅ | ✅ | 缓存监控 | -### 17. 财务结算 +### 17. 文件管理 -| 功能 | 状态 | 说明 | -|------|:----:|------| -| 商户佣金计算 | ❌ | 佣金规则 | -| 结算周期管理 | ❌ | 结算配置 | -| 结算单管理 | ❌ | 结算CRUD | -| 提现管理 | ❌ | 提现审核 | -| 发票管理 | ❌ | 发票申请 | -| 财务报表 | ❌ | 收入/支出报表 | +| 功能 | 后端 | 前端 | 说明 | +|------|:----:|:----:|------| +| 文件上传 | ✅ | ✅ | 图片/文档上传 | +| 文件分类 | ✅ | ✅ | 按类型分类 | -### 18. 内容管理 +### 18. 营销活动 -| 功能 | 状态 | 说明 | -|------|:----:|------| -| Banner管理 | ❌ | 轮播图CRUD | -| 公告管理 | ⚠️ | 页面有，API待完善 | -| 推送通知 | ❌ | 消息推送 | -| 版本管理 | ❌ | App版本 | -| 协议管理 | ❌ | 用户协议/隐私政策 | +| 功能 | 后端 | 前端 | 说明 | +|------|:----:|:----:|------| +| 活动管理 | ⚠️ | ✅ | 前端页面有，后端待验证 | +| 渠道管理 | ⚠️ | ✅ | 前端页面有，后端待验证 | +| 邀请管理 | ⚠️ | ✅ | 前端页面有，后端待验证 | -### 19. 风控管理 +### 19. 财务结算 -| 功能 | 状态 | 说明 | -|------|:----:|------| -| 黑名单管理 | ❌ | 用户/设备黑名单 | -| 风控规则 | ❌ | 规则配置 | -| 敏感词过滤 | ❌ | 敏感词库 | -| 异常行为检测 | ❌ | 风险识别 | +| 功能 | 后端 | 前端 | 说明 | +|------|:----:|:----:|------| +| 佣金管理 | ⚠️ | ✅ | 前端页面有，后端待验证 | +| 发票管理 | ⚠️ | ✅ | 前端页面有，后端待验证 | +| 对账管理 | ⚠️ | ✅ | 前端页面有，后端待验证 | +| 收入统计 | ⚠️ | ✅ | 前端页面有，后端待验证 | -### 20. 客服工单 +### 20. 内容管理 -| 功能 | 状态 | 说明 | -|------|:----:|------| -| FAQ管理 | ❌ | 常见问题 | -| 用户反馈 | ❌ | 反馈处理 | -| 工单系统 | ❌ | 工单CRUD | -| 在线客服 | ❌ | IM集成 | +| 功能 | 后端 | 前端 | 说明 | +|------|:----:|:----:|------| +| Banner管理 | ⚠️ | ✅ | 前端页面有，后端待验证 | +| 公告管理 | ✅ | ✅ | 租户公告 | +| 推送通知 | ⚠️ | ✅ | 前端页面有，后端待验证 | +| 版本管理 | ⚠️ | ✅ | 前端页面有，后端待验证 | -### 21. 数据统计 +### 21. 风控管理 -| 功能 | 状态 | 说明 | -|------|:----:|------| -| 概览Dashboard | ⚠️ | 页面有，数据待接入 | -| 订单统计 | ❌ | 订单数据分析 | -| 销售统计 | ❌ | 销售额分析 | -| 用户统计 | ❌ | 用户增长分析 | -| 商户统计 | ❌ | 商户数据分析 | +| 功能 | 后端 | 前端 | 说明 | +|------|:----:|:----:|------| +| 黑名单管理 | ⚠️ | ✅ | 前端页面有，后端待验证 | +| 风控规则 | ⚠️ | ✅ | 前端页面有，后端待验证 | +| 敏感词过滤 | ⚠️ | ✅ | 前端页面有，后端待验证 | + +### 22. 客服工单 + +| 功能 | 后端 | 前端 | 说明 | +|------|:----:|:----:|------| +| FAQ管理 | ⚠️ | ✅ | 前端页面有，后端待验证 | +| 用户反馈 | ⚠️ | ✅ | 前端页面有，后端待验证 | +| 工单系统 | ⚠️ | ✅ | 前端页面有，后端待验证 | + +### 23. 数据统计 + +| 功能 | 后端 | 前端 | 说明 | +|------|:----:|:----:|------| +| 概览Dashboard | ⚠️ | ✅ | 前端页面有，后端待验证 | +| 平台监控 | ⚠️ | ✅ | 前端页面有，后端待验证 | +| 操作日志 | ✅ | ✅ | 操作记录 | +| 资质告警 | ⚠️ | ✅ | 前端页面有，后端待验证 | + +### 24. 系统配置 + +| 功能 | 后端 | 前端 | 说明 | +|------|:----:|:----:|------| +| 邮件配置 | ⚠️ | ✅ | 前端页面有，后端待验证 | +| 短信配置 | ⚠️ | ✅ | 前端页面有，后端待验证 | +| 支付渠道配置 | ⚠️ | ✅ | 前端页面有，后端待验证 | +| 存储配置 | ⚠️ | ✅ | 前端页面有，后端待验证 | +| 用户中心 | ✅ | ✅ | 个人设置 | --- @@ -265,18 +290,18 @@ 商户/租户使用，管理自己的门店、商品、订单等。 -| 功能模块 | 状态 | 说明 | -|----------|:----:|------| -| 租户登录认证 | ❌ | 租户用户登录 | -| 门店管理 | ❌ | 管理自己的门店 | -| 商品管理 | ❌ | 管理自己的商品 | -| 订单管理 | ❌ | 处理订单 | -| 员工管理 | ❌ | 管理门店员工 | -| 营业设置 | ❌ | 营业时间、配送等 | -| 营销工具 | ❌ | 优惠券、活动 | -| 数据报表 | ❌ | 经营数据 | -| 财务管理 | ❌ | 收入、提现 | -| 消息通知 | ❌ | 订单提醒等 | +| 功能模块 | 后端 | 前端 | 说明 | +|----------|:----:|:----:|------| +| 租户登录认证 | ❌ | ❌ | 租户用户登录 | +| 门店管理 | ❌ | ❌ | 管理自己的门店 | +| 商品管理 | ❌ | ❌ | 管理自己的商品 | +| 订单管理 | ❌ | ❌ | 处理订单 | +| 员工管理 | ❌ | ❌ | 管理门店员工 | +| 营业设置 | ❌ | ❌ | 营业时间、配送等 | +| 营销工具 | ❌ | ❌ | 优惠券、活动 | +| 数据报表 | ❌ | ❌ | 经营数据 | +| 财务管理 | ❌ | ❌ | 收入、提现 | +| 消息通知 | ❌ | ❌ | 订单提醒等 | --- @@ -284,39 +309,68 @@ 消费者使用，浏览、下单、支付等。 -| 功能模块 | 状态 | 说明 | -|----------|:----:|------| -| 用户注册/登录 | ❌ | 手机号/微信登录 | -| 首页推荐 | ❌ | 门店/商品推荐 | -| 门店列表 | ❌ | 附近门店 | -| 门店详情 | ❌ | 门店信息、菜单 | -| 商品详情 | ❌ | 商品规格、加料 | -| 购物车 | ❌ | 购物车管理 | -| 下单支付 | ❌ | 订单创建、支付 | -| 订单列表 | ❌ | 我的订单 | -| 订单详情 | ❌ | 订单状态、配送 | -| 配送追踪 | ❌ | 骑手位置 | -| 评价系统 | ❌ | 订单评价 | -| 优惠券 | ❌ | 领券、用券 | -| 收货地址 | ❌ | 地址管理 | -| 个人中心 | ❌ | 用户信息 | -| 消息中心 | ❌ | 通知消息 | -| 客服入口 | ❌ | 在线客服 | +| 功能模块 | 后端 | 前端 | 说明 | +|----------|:----:|:----:|------| +| 用户注册/登录 | ❌ | ❌ | 手机号/微信登录 | +| 首页推荐 | ❌ | ❌ | 门店/商品推荐 | +| 门店列表 | ❌ | ❌ | 附近门店 | +| 门店详情 | ❌ | ❌ | 门店信息、菜单 | +| 商品详情 | ❌ | ❌ | 商品规格、加料 | +| 购物车 | ❌ | ❌ | 购物车管理 | +| 下单支付 | ❌ | ❌ | 订单创建、支付 | +| 订单列表 | ❌ | ❌ | 我的订单 | +| 订单详情 | ❌ | ❌ | 订单状态、配送 | +| 配送追踪 | ❌ | ❌ | 骑手位置 | +| 评价系统 | ❌ | ❌ | 订单评价 | +| 优惠券 | ❌ | ❌ | 领券、用券 | +| 收货地址 | ❌ | ❌ | 地址管理 | +| 个人中心 | ❌ | ❌ | 用户信息 | +| 消息中心 | ❌ | ❌ | 通知消息 | +| 客服入口 | ❌ | ❌ | 在线客服 | --- ## 状态说明 - ✅ 已完成 - 功能已开发完成，可正常使用 -- ⚠️ 部分完成 - 基础功能完成，需要完善 +- ⚠️ 待验证 - 前端页面存在，后端API需验证 - ❌ 未开始 - 功能尚未开发 --- ## 统计 -| 端 | 总功能数 | 已完成 | 部分完成 | 未开始 | -|----|:--------:|:------:|:--------:|:------:| -| 平台管理端 | ~100 | ~70 | ~8 | ~22 | +| 端 | 总功能数 | 已完成 | 待验证 | 未开始 | +|----|:--------:|:------:|:------:|:------:| +| 平台管理端 | ~120 | ~95 | ~20 | ~5 | | 租户管理端 | ~10 | 0 | 0 | 10 | | C端应用 | ~16 | 0 | 0 | 16 | + +--- + +## Domain 层已实现模块 + +- Analytics (数据分析) +- Billings (账单) +- Common (通用) +- Coupons (优惠券) +- CustomerService (客服) +- Deliveries (配送) +- Dictionary (字典) +- Distribution (分发) +- Engagement (互动) +- GroupBuying (团购) +- Identity (身份) +- Inventory (库存) +- Membership (会员) +- Merchants (商户) +- Navigation (导航) +- Ordering (订购) +- Orders (订单) +- Payments (支付) +- Products (产品) +- Queues (队列) +- Reservations (预订) +- Stores (门店) +- SystemParameters (系统参数) +- Tenants (租户) diff --git a/Roadmap/02-开发里程碑.md b/Roadmap/02-开发里程碑.md index 39ec5f7..6298b6c 100644 --- a/Roadmap/02-开发里程碑.md +++ b/Roadmap/02-开发里程碑.md @@ -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 里程碑 |