Files

Losita b08ee17893 Version: 0.9.66.dev.260504

后端：
1. 阶段 2 user/auth 服务边界落地，新增 `cmd/userauth` go-zero zrpc 服务、`services/userauth` 核心实现、gateway user API/zrpc client 与 shared contracts/ports，迁移注册、登录、刷新 token、登出、JWT、黑名单和 token 额度治理
2. gateway 与启动装配切流，`cmd/all` 只保留边缘路由、鉴权和轻量组合，通过 userauth zrpc 访问核心用户能力；拆分 MySQL/Redis 初始化与 AutoMigrate 边界，`userauth` 自迁 `users` 和 token 记账幂等表，`all` 不再迁用户表
3. 清退 Gin 单体旧 user/auth DAO、model、service、router、middleware 和 JWT handler，并同步调整 agent/schedule/cache/outbox 相关调用依赖
4. 补齐 refresh token 防并发重放、MySQL 幂等 token 记账、额度 `>=` 拦截和 RPC 错误映射，避免重复记账与内部错误透出

文档：
1. 新增《学习计划论坛与Token商店PRD》

2026-05-04 15:20:47 +08:00

7.7 KiB

Raw Permalink Blame History

学习计划论坛与 Token 商店 PRD

1. 文档定位

本文只记录当前需要讨论和快速推进的核心产品口径，不展开完整交互稿、运营后台和支付细节。

本轮目标是新增两个终态服务模块：

taskclass-forum：支持用户分享 TaskClass 学习计划，并让其他用户一键导入。
token-store：支持 Token 商品购买、活动奖励和发放账本。

两个模块后续都放在 backend/services 下，以独立服务为目标设计；当前仓库工作区未干净前只讨论 PRD，不进入代码实现。

2. 背景与目标

当前产品已经具备用户自建 TaskClass、智能排程和 Token 额度门禁能力。下一阶段希望补上社区化与商业化闭环：

用户可以把自己的复习计划分享出去，形成可浏览、可点赞、可评论、可复用的学习计划论坛。
其他用户可以一键导入计划模板，快速生成自己的 TaskClass。
被点赞、被导入等社区行为可以转化为 Token 激励。
用户可以通过 Token 商店购买或领取 Token，为后续高频 Agent 使用建立基础商业闭环。

3. 模块一：学习计划论坛

3.1 产品定位

学习计划论坛不是普通帖子论坛，而是“帖子 + TaskClass 模板快照”的社区。

用户发布时，系统从用户自己的 TaskClass 复制一份模板快照。其他用户导入时，再从快照生成自己的 TaskClass 副本。

快照原则：

发布后不直接引用原作者的 task_classes / task_items。
原作者后续修改自己的计划，不影响已发布模板。
导入用户拿到的是自己的 TaskClass 副本，后续可自由编辑。
不分享 embedded_time、schedule 绑定、用户私有排程状态。

3.2 P0 功能

发布学习计划：用户选择一个 TaskClass，填写标题、简介、标签后发布。
浏览列表：支持分页查看公开计划，按最新、点赞数、导入数排序。
查看详情：展示计划说明、TaskClass 配置摘要和任务条目预览。
点赞：同一用户对同一帖子只能点赞一次，可取消点赞。
评论：支持基础评论列表和发表评论，P0 不做楼中楼。
一键导入：从论坛模板复制出当前用户自己的 TaskClass。
基础激励：模板获得点赞或导入后，可触发 Token 奖励事件。

3.3 P0 不做

不做复杂推荐算法。
不做关注、私信、用户主页。
不做富文本编辑器，先用纯文本简介。
不做审核后台，先预留状态字段。
不直接把模板应用进 schedule；导入后由用户走现有 TaskClass / 排程链路。

3.4 核心实体

forum_posts：帖子主体，记录作者、标题、简介、状态、点赞数、评论数、导入数。
forum_post_templates：TaskClass 快照，记录模式、日期范围、策略、约束配置等。
forum_post_template_items：TaskClassItem 快照，只记录 order/content 等模板信息。
forum_likes：点赞幂等记录。
forum_comments：评论记录。
forum_imports：导入记录，记录从哪个帖子导入到哪个用户和新 TaskClass ID。

3.5 关键流程

发布流程：

用户选择自己的 TaskClass。
taskclass-forum 通过 TaskClass 读取端口拿到完整模板。
服务过滤私有字段，生成论坛快照。
写入帖子和模板快照。

导入流程：

用户点击一键导入。
taskclass-forum 读取帖子模板快照。
通过 TaskClass 写入端口为当前用户创建 TaskClass 副本。
写入导入记录并增加导入计数。
可异步发布 Token 奖励事件。

4. 模块二：Token 商店

4.1 产品定位

Token 商店负责 Token 的购买、奖励、发放和账本，不负责登录鉴权，也不直接承载 Agent 消耗统计。

user/auth 继续负责用户 Token quota 的权威判断；token-store 只负责产生“发放 Token”的业务事实，并通过跨服务契约通知 user/auth 增加用户额度。

4.2 P0 功能

商品列表：展示可购买 Token 包。
创建订单：用户选择商品生成订单。
支付确认：P0 先支持 mock paid 或管理端确认 paid，不接真实支付网关。
Token 发放：订单支付成功后发放 Token。
奖励发放：支持论坛点赞、导入等事件触发奖励。
发放账本：所有发放必须有幂等 event_id，避免重复加额度。

4.3 P0 不做

不接真实微信 / 支付宝 / Stripe。
不做退款、发票、优惠券。
不做复杂会员体系。
不直接改 users.token_usage，避免和消费统计混淆。

4.4 核心实体

token_products：Token 商品。
token_orders：订单。
token_grants：Token 发放账本，记录购买、奖励、补偿等来源。
token_reward_rules：奖励规则，P0 可先用配置或简单表。

4.5 关键流程

购买流程：

用户选择商品并创建订单。
订单进入 pending。
P0 通过 mock paid 或管理端确认，把订单置为 paid。
token-store 写入 token grant 账本。
token-store 调用 user/auth 的额度发放能力。
发放成功后订单进入 granted。

奖励流程：

论坛产生点赞或导入事件。
token-store 按奖励规则判断是否发放。
写入 token grant 账本。
调用 user/auth 增加额度。

5. 服务边界

5.1 `taskclass-forum`

负责：

论坛帖子、点赞、评论、导入记录。
TaskClass 模板快照。
导入时的模板复制编排。
发布社区行为事件，供 Token 激励消费。

不负责：

TaskClass 原始表所有权。
schedule 写入和排程应用。
Token 额度发放。
用户登录鉴权。

5.2 `token-store`

负责：

商品、订单、发放账本。
社区奖励规则。
幂等发放。
调用 user/auth 增加 Token 额度。