用途:把 Stripe 集成的设计文档转化为可运行代码,而非仅生成模板。默认技术栈为 Next.js + Convex,Stripe 相关逻辑保持一致,框架部分可按需适配。
主要能力:生成后端组件,包括 Stripe 客户端初始化、Checkout 会话创建、Webhook 接收与签名验证、Webhook 事件处理、订阅状态管理、账单查询与 Portal 会话创建、schema 订阅字段更新及 .env.example 变量说明;同时生成订阅管理界面组件,如当前套餐卡片、计费周期信息、支付方式展示、账单历史、管理订阅按钮和试用横幅,并在设置页加入订阅管理区块。
使用方式:假定从 master/main 开始,先执行 git checkout -b feat/stripe-integration-$(date +%Y%m%d) 创建分支。先阅读 stripe-design 设计文档,理解结账流程、Webhook 事件、状态管理与访问控制;再用 Gemini 调研当前 Stripe SDK 用法与官方文档,避免依赖过时知识。随后按组件用 Codex 委派实现,例如 codex exec --full-auto "Implement Stripe webhook handler for [events]. ..." --output-last-message /tmp/codex-webhook.md 2>/dev/null,之后运行 git diff --stat && pnpm typecheck && pnpm test。
质量门禁:pnpm typecheck、pnpm lint、pnpm test 通过,并人工审查生成代码。
注意事项:Webhook 处理器必须先验证签名;处理出错也应返回 200 以避免 Stripe 重试;用户试用期内升级需传 trial_end;受控功能前检查订阅状态。订阅管理 UX 为必需项。若使用 Express/Fastify、Supabase/Postgres 或无 Convex,路由与 ORM 不同,但 Stripe 逻辑与状态管理概念相同。具体收费、价格与平台支持暂未提供。