number/待实现功能清单.md

OpenClaw Skills 待实现功能清单

基于《产品功能架构设计.md》与当前系统实现的差距分析
更新日期：2026-03-21
当前状态：Phase 1 MVP 基本完成（~98%），Phase 2 大部分完成（~95%），Phase 3 推进中（~30%，会员等级+优惠券+促销系统已完成）

---

总览

阶段	完成度	说明
Phase 1 MVP 核心	~98%	用户注册登录、Skill商城、积分基础、支付充值、混合支付、后台管理（支付回调可靠性待确认）
Phase 2 核心完善	~95%	内容管理/发票/榜单/RBAC/操作日志/活动管理/帮助中心/反馈系统/积分冻结过期已完成，海报/手机号更换/分享待做
Phase 3 运营深化	~30%	会员等级体系+优惠券系统+促销系统（限时折扣/满减/秒杀）已完成；社区/埋点/风控待做

---

优先级 P0 — 补齐 MVP 缺口

1. 混合支付完善（积分+现金） ✅ 已完成

• 完成内容：后端 OrderPreviewVO + previewOrder API + 纯积分自动完成 + BigDecimal精度修复 + freezePoints原子SQL；前端 detail.vue 购买弹窗（积分滑块+实时预览+debounce）+ pay.vue 混合支付明细显示

2. 支付回调可靠性

• 模块：支付与充值
• 现状：payment module 有回调端点，但幂等性、签名验证、补偿机制需确认
• 需要做：
  • 后端：确认回调签名校验、幂等处理、超时补偿查询
  • 测试：模拟微信/支付宝回调场景
• 工作量：1-2天
• 影响：资金安全

---

优先级 P1-高 — Phase 2 核心缺失

3. 后台内容管理（轮播图 + 公告） ✅ 已完成

• 完成内容：BannerController + AnnouncementController 全套 CRUD，前端 admin/banners.vue + admin/announcements.vue 已实现

4. 发票管理 ✅ 已完成

• 完成内容：InvoiceController 全套（申请/审核/开具），前端 user/invoices.vue + admin/invoices.vue 已实现

5. 热门榜单页 ✅ 已完成

• 完成内容：SkillController 包含排行查询接口，前端 skill/ranking.vue 已实现，路由 /skill/ranking 已配置

---

优先级 P1-中

6. 邀请海报生成

• 模块：邀请与社区
• 现状：有邀请码和邀请链接，无海报功能
• 需要做：
  • 前端：Canvas 绘制带二维码的邀请海报，支持保存到相册/分享
  • 后端：（可选）服务端生成海报图片 API
• 工作量：2-3天
• 影响：提升社交传播效果和拉新转化率

7. RBAC 角色权限完善 ✅ 已完成

• 完成内容：RbacController 全套（角色/权限/管理员角色 CRUD），前端 admin/roles.vue + admin/admins.vue 已实现，@RequiresRole/@RequiresPermission 拦截器已就位

8. 操作日志 ✅ 已完成

• 完成内容：OperationLogAspect AOP 切面 + OperationLogController 查询 API，前端 admin/logs.vue 已实现

9. 积分过期 + 冻结机制 ✅ 已完成

• 完成内容：
  • 后端：积分批次表（points_batches）+ FIFO消费 + 定时过期清理（PointsExpireScheduler 每天2:00）；积分冻结/解冻/消费冻结积分原子SQL；积分规则表增加 expire_days 字段实现按来源可配置过期天数
  • 后端安全加固：MQ事务一致性（TransactionSynchronization afterCommit）；payOrder降级原子性（TransactionTemplate）；邀请积分幂等性（按userId+source+relatedId去重）；createPointsBatch amount≤0校验；永不过期硬编码提取为NEVER_EXPIRE常量
  • 后端补偿机制：通用补偿任务表（compensation_tasks）+ CompensationScheduler（每5分钟扫描，CAS抢占防多实例重复，指数退避1→5→30→120→720分钟，重试耗尽告警）；4处MQ发送失败自动写入补偿表（approveRefund/payOrder/cancelOrder/createOrder）
  • 前端：积分页 hover 展示冻结积分 + 即将过期积分详情（a-popover）

10. 手机号绑定/更换

• 模块：用户管理 > 账户安全
• 现状：settings.vue 有密码修改，无手机号更换
• 需要做：
  • 后端：验证旧手机号 + 绑定新手机号 API
  • 前端：settings.vue 增加手机号更换流程（旧号验证→新号验证→完成）
• 工作量：1-2天
• 影响：用户换号后无法操作账户

---

优先级 P1-低

11. 后台活动管理 ✅ 已完成

• 完成内容：后端 activity 模块全套 CRUD + 定时任务自动结束；前端 admin/activities.vue（新建/编辑/状态切换/删除/筛选）；首页活动展示区已集成

12. 帮助中心 / FAQ ✅ 已完成

• 完成内容：后端 help 模块（分类+文章 CRUD）；前端 admin/help.vue（左右分栏分类+文章管理）；前端 help/index.vue（分类浏览/搜索/文章详情）

13. 反馈建议系统 ✅ 已完成

• 完成内容：后端 feedback 模块（提交/查看/回复 API）；前端 user/feedback.vue（提交反馈、查看进度和管理员回复）；前端 admin/feedback.vue（反馈列表/筛选/查看/回复/状态管理）

14. 分享功能（社交分享 SDK）

• 模块：邀请与社区
• 现状：无分享功能
• 需要做：
  • 前端：集成微信 JS-SDK 分享接口
  • 后端：微信 JS-SDK 签名 API
  • 前端：Skill详情页/邀请页增加分享按钮
• 工作量：2-3天

---

优先级 P2 — Phase 3 运营深化

15. 会员等级 + 成长值体系 ✅ 已完成

• 完成内容：数据库（member_level_config + growth_records 表 + 4级初始数据）；后端 member 模块（Entity/Repository/Service/Controller）；业务集成（签到+1/注册+5/邀请+10/充值/评价+3 自动增加成长值）；会员权益（签到积分倍率：金卡1.5x/钻石2x、积分折扣：白银95折/金卡9折/钻石85折）；前端 profile 页等级卡片+进度条+等级体系一览；管理后台用户管理页成长值调整功能

16. 优惠券系统 ✅ 已完成

• 完成内容：满减券/折扣券/立减券，发放/使用/核销/过期，后台管理
• 后端：coupon 模块全套（CouponTemplate CRUD / UserCoupon 领取·使用·退回·过期 / 订单集成 previewOrder+createOrder+cancelOrder）；安全审计修复（IDOR越权校验·悲观锁防并发超领·状态机校验·分页上限·信息泄露防护·批量发券@Size限制）；零元支付边界修复（优惠券全额抵扣自动完成订单）
• 前端：管理端 admin/coupons.vue（券模板CRUD·状态切换·手动发券·券统计）；用户端 user/coupons.vue（优惠券中心·领券·我的优惠券）；detail.vue 下单选券集成（可用券查询·券抵扣预览·选券下单）；order store couponId 集成
• 代码审计修复：前后端枚举对齐（full_minus→full_reduce / direct_minus→fixed / duration→relative）；字段名修正（expireTime→validEnd / deductAmount→discountAmount）
• 待优化：N+1查询（getMyCoupons/listTemplates 循环查模板），非安全问题，后续批量查询重构

17. 活动系统（限时折扣/秒杀） ✅ 已完成

• 完成内容：促销模块全栈实现
• 后端：promotion 模块（Promotion/PromotionSkill/PromotionRecord 三表 Entity + Repository + PromotionService接口 + PromotionServiceImpl 完整业务逻辑 + PromotionController REST接口）；ErrorCode 9001-9008 促销错误码；支持限时折扣(time_discount)/满减(full_reduce)/秒杀(flash_sale)三种类型；活动状态管理（draft→active→paused→ended）；Skill关联促销价/折扣率/库存限量；按用户限购/活动总限量控制；促销使用记录与统计
• 前端：admin/promotions.vue 管理页面（活动CRUD/状态切换/关联Skill/促销统计/筛选分页）；apiService 促销API集成；AdminLayout侧边栏+router路由

18. 邮箱注册/登录

• 描述：邮箱+密码注册登录，邮箱验证码
• 工作量：2-3天

19. 实名认证

• 描述：身份证正反面上传、人脸识别、审核状态管理
• 工作量：5-7天（需对接第三方实名服务）

20. 创作者中心完善

• 描述：Skill上传完整流程、版本管理、收益统计、数据看板
• 现状：后端有 developer module，前端缺专门页面
• 工作量：7-10天

21. 微信模板消息推送

• 描述：公众号模板消息（订单通知、积分到账等）
• 工作量：3-5天

22. 在线客服系统

• 描述：智能客服自动回复、人工客服、工单系统
• 工作量：10-15天（或对接第三方客服SaaS）

23. 数据埋点 + 用户行为分析

• 描述：页面浏览、点击、购买、下载埋点，转化漏斗，留存分析
• 工作量：5-7天（或对接神策/GrowingIO）

24. A/B 测试框架

• 描述：实验配置、流量分割、数据对比
• 工作量：5-7天

25. 安全风控体系

• 描述：异常登录检测、支付风控、积分刷单检测、敏感词过滤、图片审核
• 工作量：10-15天

26. 积分转赠

• 描述：用户间积分转赠，手续费扣除
• 工作量：2-3天

27. 登录设备管理

• 描述：登录时间/设备/IP记录，异常登录提醒，多设备登录限制
• 工作量：3-5天

28. 用户标签系统

• 描述：手动打标签、自动标签规则、用于Skill推荐
• 工作量：3-5天

29. 财务报表 + 对账管理

• 描述：交易流水、对账管理、财务报表导出
• 工作量：5-7天

30. 积分规则后台配置

• 描述：各渠道积分获取/消耗/过期规则可视化配置
• 工作量：3-5天

---

工作量估算汇总

优先级	总计	已完成	剩余	预估剩余工时
P0 补齐	2项	1项	1项	1-2天
P1-高	3项	3项	0项	0天
P1-中	5项	3项	2项	4-5天
P1-低	4项	3项	1项	2-3天
P2	16项	3项	13项	68-100天
合计	30项	13项已完成	17项	~75-110天

---

建议实施路线

已完成 ✅
  → #1 混合支付完善
  → #3 后台内容管理（轮播图+公告）
  → #4 发票管理
  → #5 热门榜单页
  → #7 RBAC权限完善
  → #8 操作日志
  → #9 积分过期+冻结+MQ补偿机制
  → #11 后台活动管理
  → #12 帮助中心
  → #13 反馈建议系统

近期（1-2周）
  → #2 支付回调可靠性
  → #10 手机号绑定/更换

中期（3-6周）
  → #6 邀请海报
  → #14 分享功能

已完成 ✅（Phase 3）
  → #15 会员等级+成长值体系
  → #16 优惠券系统（后端+前端+审计修复）
  → #17 促销系统（限时折扣/满减/秒杀，前后端全栈）

长期（Phase 3 剩余）
  → #18-#30 按业务需求和数据反馈逐步推进

---

本文档将随开发进度持续更新