买课小程序产品系统Vibe Coding

赛道：知识付费 / 在化教育 × 微信小程序电商，SaaS 化卖课平台

┌──────────┬───────────────────────┬───────────────────────────────────────────────────┐
│ 角色 │ 是谁 │ 需求 │
├──────────┼───────────────────────┼───────────────────────────────────────────────────┤
│ B 端商户 │ 中小知识 IP、教培机构 │ 缺技术团队，难以自建「商城 + 支付 + 分销 + 客服」 │
├──────────┼───────────────────────┼───────────────────────────────────────────────────┤
│ C 端学员 │ 微信生态用户 │ 逛课、比价、买课、售后退款 │
└──────────┴───────────────────────┴───────────────────────────────────────────────────┘

商业模式（三重收入）：
1. 课程售卖 —— 商户卖课，平台提供交易全链路
2. 二级分销裂变 —— 老学员分享赚佣金，解决私域获客成本高的问题
3. 商家订阅收租（SaaS） —— 基础版/标准版/旗舰版按年订阅，未订阅拦截业务（SubscriptionService，续费顺延不亏天数，校验带 60s 内存缓存）

┌──────────┬────────────────────────────────────────────────────────────────────────────────┐
│ 模块 │ 功能 │
├──────────┼────────────────────────────────────────────────────────────────────────────────┤
│ 课程商城 │ 分类浏览 / 搜索 / 详情页 rich-text 图文，上下架管理 │
├──────────┼────────────────────────────────────────────────────────────────────────────────┤
│ 订单支付 │ 下单 → 微信支付 V3 JSAPI 收银台，30 分钟未支付自动关单 │
├──────────┼────────────────────────────────────────────────────────────────────────────────┤
│ 退款售后 │ 用户申请 → 人工审核 → 微信退款 API → 回调落地，审核期佣金自动冻结 │
├──────────┼────────────────────────────────────────────────────────────────────────────────┤
│ 二级分销 │ 分享绑定（首次锁定/防自绑/防环）、佣金明细

技术栈：Java 17 · Spring Boot 3 · MyBatis-Plus · MySQL 8（20 张表）· wechatpay-java（微信支付 V3 官方 SDK）· JJWT · 原生微信小程序（无构建链）· OpenAI 兼容 LLM Function Calling · JUnit5 + Mockito（32 个单测）

架构分层：controller（app/admin/callback/dev 四组）→ service（11 个业务服务）→ mapper，外加 wxpay / ai / security / job 四个专项模块

核心设计（拿去当面试亮点）

1. 支付可插拔，mock 与真实共用一条业务路径
WxPayClient 接口 + WxPayV3Client（真实）/ MockWxPayClient（dev）策略切换。支付/退款成功一律收敛到 PaymentCallbackHandler 落地，业务代码零分叉 → 本地零微信资质可跑通全流程，上生产不改一行业务代码。

2. 订单状态机全条件更新，天然幂等
CREATED →(支付回调)→ COMPLETED →(申请)→ REFUNDING →(回调)→ REFUNDED
CREATED →(超时Job)→ CLOSED REFUNDING →(驳回)→ 恢复快照状态
所有迁移用 UPDATE ... WHERE status = 旧状态 并检查影响行数，微信回调重复/乱序/并发都安全；佣金结算、回冲各有幂等标记。

3. 佣金生命周期（金额全程「分」，floor 取整防精度漏洞）
支付成功 → 快照结算(一级/二级, 课程级比例覆盖全局) → FROZEN
T+N 定时任务 → AVAILABLE 申请退款 → 重新 FROZEN(封堵审核期提现)
退款成功 →