easy-vibe 实战项目:用 Supabase + Stripe 从 0 到 1 交付一个 AI 营销文案 SaaS 平台
easy-vibe 实战项目:用 Supabase + Stripe 从 0 到 1 交付一个 AI 营销文案 SaaS 平台
本篇技术指南是 Datawhale「easy-vibe」项目制学习体系中第二阶段(stage-2)的综合实战任务:基于一份真实的产品需求文档(PRD),使用 AI 编程(vibe coding)逐步构建一个面向独立开发者与内容团队的 AI 营销文案 SaaS——以 Supabase 提供数据库与用户认证,以 Stripe 提供订阅支付,并打通"需求分析 → 前端搭建 → 后端集成 → 发布上线"的完整链路。读完本文,你将掌握:如何从 PRD 提炼开发任务、如何用提示词驱动 AI 生成三大入口的前端页面、如何接入 Supabase 认证/数据表/行级安全(RLS)、如何用 Stripe Checkout + Webhook 实现可靠的订阅闭环,以及如何搭建管理员后台并完成端到端验收与部署。
项目全景:这不是一次模型调用 Demo,而是一套完整产品
本任务要求你对照一份真实 PRD 开发一个可交付的 SaaS 产品,而不是做一个单次调用大模型的演示页面。项目定位是:支持注册登录、文案生成、历史管理、套餐付费和后台运营的 AI 营销文案工作台。参考仓库内的 PRD 文档,其技术选型建议为:
- 前端框架:
Next.js App Router - 用户鉴权:
Supabase Auth - 数据库:
Supabase Postgres - 支付:
Stripe - AI 能力:统一后端适配层对接第三方大模型 API
PRD 将整个系统定义为 3 套入口、10 个大页面,对应本文任务中的三个子系统:
| 子系统 | 职责 | 页面 |
|---|---|---|
| 公司官网 | 呈现产品、定价、FAQ、注册转化 | 首页 www:/ |
| 用户工作台 | 输入产品信息、生成文案、查看历史、升级套餐 | 登录 app:/login、注册 app:/register、生成工作台 app:/generate、历史记录 app:/history、套餐页 app:/billing |
| 管理后台 | 管理用户、生成记录、支付数据、运营概览 | 后台首页 admin:/、用户管理 admin:/users、生成记录 admin:/generations、支付与订阅 admin:/billing |
用一句话定义本项目:做一个支持注册登录、文案生成、历史管理、套餐付费和后台运营的 AI 营销文案工作台。整个开发过程分为四个阶段:分析需求 → 搭建结构 → 集成后端 → 集成上线。
第一部分:需求分析——先读懂 PRD,再写代码
项目的第一步不是写代码,而是阅读并消化 PRD。参考仓库中的 PRD.md,阅读时应重点回答以下问题:
- 系统有几个入口?每个入口覆盖哪些页面?
- 每个页面的核心功能是什么?
- 后端涉及哪些数据库模块与数据表?
- 套餐定价、支付流程与免费额度是如何设计的?
- MVP 的范围是什么?第一版做什么、不做什么?
任务文档对此给出了明确警告:如果对上述问题没有清晰答案,不要开始写代码——需求不明确是返工最常见的原因。
从 PRD 中还可以提取出关键的状态流转与用户链路,用于指导后续开发顺序:
- 游客 → 注册用户;免费用户 → 付费用户
- 生成中 → 生成成功 / 生成失败;订单处理中 → 支付成功 / 支付失败
PRD 给出的推荐开发顺序是:搭官网和登录注册页 → 实现生成工作台 → 接入鉴权和数据库 → 接入模型生成接口 → 实现历史记录 → 接入支付与套餐 → 实现后台运营页。
从 PRD 确认系统架构
基于 PRD 可推导出如下系统架构(本任务文档中的原图):
flowchart TD
prd["PRD"] --> web["公司官网"]
prd --> app["用户工作台"]
prd --> admin["管理后台"]
app --> auth["认证"]
app --> gen["文案生成任务"]
gen --> db["数据库"]
billing["支付与套餐"] --> db
admin --> analytics["用户 / 生成 / 支付看板"]
在技术实现上,官网、工作台、后台三个入口统一接入应用 API,API 层再分别调用 Supabase Auth、Supabase Postgres、Stripe 与第三方大模型 API。这一步决定了后续所有页面与接口的落点,务必在编码前先确认清楚。
第二部分:搭建项目结构——用 AI 生成前端页面
在需求明确后,进入前端搭建阶段。核心方法论是:先用 AI 生成页面骨架与假数据,让交互先跑起来,再逐步细化。
2.1 生成三大入口的前端结构
参考提示词(Prompt)如下,可直接复制给 AI 编程工具使用:
请基于我提供的 PRD,帮我生成一个 AI 营销文案 SaaS 的前端结构。
要求:
1. 三个入口:www、app、admin
2. 官网包含:首页、定价、FAQ
3. app 包含:登录、注册、工作台、历史记录、套餐页
4. admin 包含:管理首页、用户管理、生成记录、支付订单
5. 只生成页面结构和假数据,不接真实接口
6. 现代 SaaS 风格,不是课堂演示风
2.2 精细化打磨核心工作台页面
结构搭好后,重点打磨文案生成工作台(Dashboard)页面——这是产品最核心的交互界面:
帮我优化 /dashboard 页面。
这是一个 AI 营销文案生成工作台。
左侧表单字段:
- 产品名称
- 一句话简介
- 目标用户
- 3 个卖点
- 投放渠道(网站、朋友圈、小红书、抖音、邮件)
右侧「结果」区域预留展示:
- 主标题
- 副标题
- CTA
- 3 条短文案
- 长文案
先用假数据让交互跑起来。
要求:
- 点击「生成文案」后有 loading 状态
- 「结果」区域要有空状态设计
- 响应式布局,宽屏窄屏都要好看
2.3 结构自检清单
对照以下清单逐一核对,避免带着结构问题进入后端开发:
- [ ] 三个入口的路由是否相互独立
- [ ] 页面数量是否与 PRD 一致
- [ ] Dashboard 的表单与「结果」区布局是否合理
- [ ] 假数据是否能展示基本的 UI 状态(空态、加载态、错误态)
如果前端搭建阶段遇到困难,可回到这些先修章节复习:UI 设计、多产品 UI 页面设计、用 LLM 与 Skills 美化界面、从设计稿到代码、现代组件库刷新界面。
第三部分:集成后端——认证、生成接口、支付、管理后台
本阶段把前端的假数据替换为真实后端能力。任务文档为每个环节都给出了"把自己当小白、让 AI 分步带教"的提示词,同时仓库先修章节 从数据库到 Supabase 与 Stripe 支付集成 提供了底层原理支撑。
3.1 接入 Supabase 注册登录
参考提示词:
把我当成完全新手,分步教我接入 Supabase 登录。
帮我完成:
1. 项目连接 Supabase
2. 实现注册、登录、登出功能
3. 登录成功后跳转 /dashboard
4. 未登录用户访问 /dashboard、/billing、/admin 时自动跳转 /login
5. 创建 profiles 表
6. 用户注册成功后自动在 profiles 表创建一条记录
7. profiles 表需要包含 email、role、plan 字段
实现要求:
- 每一步说明修改了哪些文件
- 不要硬编码密钥
- 明确标注哪些操作需要在 Supabase 控制台手动完成
- 完成后说明如何验证注册登录
底层原理补充(对应 database-supabase 章节):Supabase 是新一代 BaaS,以 PostgreSQL 为核心,整合了 Auth、Storage、Realtime、Edge Functions 等能力。接入时需在 Project Settings → Data API 获取 Supabase URL,在 API Keys 中区分两类密钥:
| 密钥 | 用途 | 注意 |
|---|---|---|
anon(公开) |
前端使用,权限严格受 RLS 约束 | 只能访问授权给用户的数据 |
service_role(服务端) |
服务端高权限密钥,可绕过行级安全 | 严禁公开,泄露需立即轮换 |
注册登录本质是调用 Supabase Auth 提供的 signUp/signIn 等方法,用户数据自动同步到 auth.users 表。若希望"用户注册后自动在 profiles 建记录",可结合 RLS 策略与触发器实现。关于行级安全(RLS):开启后,所有对该表的 SELECT/INSERT/UPDATE/DELETE 都会触发策略校验;Supabase 提供 auth.uid() 函数返回当前登录用户的 UUID,可据此写出"只允许用户访问自己数据"的策略,例如让 generation_records.user_id 与 auth.uid() 匹配——这正是本项目"用户历史记录只能自己可见"的实现基础。
3.2 接入生成接口与数据库
参考提示词:
把我当成完全新手,帮我完成网站的核心功能:生成营销文案并保存。
期望效果:
1. 用户在 /dashboard 填写表单,点击「生成文案」
2. 后端接收到:产品名称、简介、目标用户、卖点、投放渠道
3. 后端调用模型生成「结果」
4. 页面展示生成的「结果」
5. 输入与输出都保存到数据库
6. 用户再次回来可以查看历史记录
需要完成:
- 创建生成接口 /api/generate
- 创建 generations 表
- 设计输入输出字段
- 在 Dashboard 页面读取当前用户的历史记录
用户体验:
- 按钮 loading 状态
- 生成失败的错误提示
- 无记录时的空状态
完成后说明:
- 前端页面文件位置
- 后端接口文件位置
- 写库逻辑的位置
- 如何测试完整的生成链路
数据模型参考(来自 PRD.md 的建议表结构):
profiles (
id uuid primary key,
email text,
role text,
plan text,
created_at timestamptz
)
generation_records (
id uuid primary key,
user_id uuid,
input_payload jsonb,
output_payload jsonb,
channel text,
tone text,
status text,
created_at timestamptz
)
billing_records (
id uuid primary key,
user_id uuid,
plan_code text,
billing_cycle text,
amount_cents int,
status text,
created_at timestamptz
)
注意 amount_cents 使用整数(分)表示金额、时间统一用 timestamptz、结构多变的输入输出用 jsonb——这些都是在 database-supabase 章节中反复强调的字段设计规范。PRD 还给出了完整的接口草案,可作为后端路由的对照清单:
| 方法 | 路径 | 说明 |
|---|---|---|
POST |
/api/auth/register |
注册 |
POST |
/api/auth/login |
登录 |
POST |
/api/generations |
创建文案生成任务 |
GET |
/api/generations/:id |
获取生成结果 |
GET |
/api/history |
获取历史记录 |
DELETE |
/api/history/:id |
删除历史记录 |
GET |
/api/billing/plans |
获取套餐 |
POST |
/api/billing/checkout |
创建支付会话 |
GET |
/api/admin/overview |
获取后台总览 |
GET |
/api/admin/users |
获取用户列表 |
GET |
/api/admin/generations |
获取生成记录列表 |
3.3 接入 Stripe 支付
参考提示词:
把我当成完全新手,帮我给 LaunchKit 加上一套能跑通的最简 Stripe 支付。
不需要复杂系统,只跑通最简支付链路即可。
需要完成:
1. /billing 页面展示 free 和 pro 两个套餐
2. 用户点击升级后跳转 Stripe Checkout
3. 支付成功后回到网站
4. 支付「结果」保存到 subscriptions 表
5. 同步更新 profile.plan 字段
6. free 用户每天限 3 次生成,pro 用户不限制
实现原则:
- 先跑通主链路,复杂的限额暂时不要纠结
- 明确标注哪些地方需要在 Stripe 控制台配置
- 完成后说明如何测试完整支付链路
支付闭环的底层原理(对应 stripe-payment 章节):先记住三条硬性原则——
- 价格必须由后端决定,不能信任前端传来的金额(否则可被篡改);
- 真正激活权限的是 Webhook,而不是 success 页面(用户直接访问
/success或中途关闭页面都可能导致误判); - 数据库必须保存支付状态,不能只依赖 Stripe 控制台。
最简支付链路为:前端点击购买 → 请求后端 → 后端用 price_id 创建 Checkout Session → 用户跳转 Stripe 付款 → Stripe 通过 Webhook 推送 checkout.session.completed → 后端验签并更新数据库 → 前端查询最新状态展示。关键环境变量包括 STRIPE_SECRET_KEY、STRIPE_WEBHOOK_SECRET、STRIPE_PRICE_PRO_MONTHLY、STRIPE_PRICE_PRO_YEARLY、APP_URL、SUPABASE_URL、SUPABASE_SERVICE_ROLE_KEY,其中 STRIPE_SECRET_KEY 与 SUPABASE_SERVICE_ROLE_KEY 只能存在于服务端。
需要重点监控的订阅事件有四个:checkout.session.completed(首次激活,本地建订阅记录)、invoice.paid(续费成功,延长有效期)、invoice.payment_failed(扣费失败,标记风险)、customer.subscription.deleted(取消订阅,回收权限)。常见的四个坑也要避免:把 success 页当成功依据、允许前端传金额、用 express.json() 提前解析导致 Webhook 验签失败、Webhook 重试未做幂等处理。
3.4 搭建管理后台
参考提示词:
把我当成完全新手,帮我做一个简洁可用的管理后台。
仅限管理员访问。
需要完成:
1. 只有 role = admin 的用户才能访问 /admin
2. 后台包含 3 个标签页:用户列表、生成记录、订阅状态
3. 用户列表展示:邮箱、套餐、创建时间
4. 生成记录展示:用户、产品名称、渠道、创建时间
5. 订阅状态展示:用户、套餐、支付状态
要求:
- 界面简洁清晰
- 使用现有组件库的表格、标签页、徽章
- 完成后说明如何把某个账号设置为管理员
管理后台的权限控制,本质是对 profiles.role 字段的判定,可结合 Supabase RLS 策略与中间件实现"普通用户禁止进入 admin 路由"。按照任务文档的约定,管理员只需能查看三类数据:用户、生成记录、支付数据。
后端阶段遇到困难时,可回头复习:从数据库到 Supabase、AI 辅助编写接口代码、Stripe 支付集成。
第四部分:集成与部署——端到端验收后上线
4.1 全链路联调测试
至少验证以下两条主链路:
- 注册 → 登录 → 生成文案 → 查看历史 → 升级套餐
- 管理员登录 → 查看用户数据 → 查看生成记录 → 查看支付状态
发布前可让 AI 协助做一次"上线体检":
把我当成完全新手,帮我检查项目是否具备上线条件。
主要检查点:
- 环境变量是否齐全
- 登录回调地址是否正确
- Stripe 支付回调地址是否正确
- 页面是否缺少 loading、空状态或错误提示
- README 是否包含运行与部署说明
需要你:
1. 按优先级列出需要修复的事项
2. 指出应该先修什么
3. 说明修复后的部署「步骤」
4.2 部署上线
将项目部署到公网环境,可参考 Git 与 GitHub 工作流 和 Zeabur 部署 Web 应用。部署时需再次核对:环境变量完整、登录与支付回调地址与线上域名一致、Stripe Webhook 端点已指向线上地址。
交付物与评价标准
完成本项目后,需要提交以下内容:
- [ ] 可访问的在线演示链接
- [ ] 源码仓库链接(含 README)
- [ ] PRD 文档
- [ ] 核心页面截图(首页、Dashboard、Billing、Admin)
- [ ] 60 秒演示视频(覆盖注册 → 生成 → 支付 → 管理后台)
README 至少包含:项目简介、核心页面说明、技术栈、本地运行步骤、环境变量清单。
对照以下评分标准(来自任务文档)自查:
| 维度 | 基础要求 | 进阶要求 |
|---|---|---|
| 产品完整度 | 首页、登录、Dashboard、Billing、Admin 均可访问 | 首页文案与视觉风格接近真实 SaaS |
| 业务闭环 | 注册 → 登录 → 生成 → 查看历史可完整跑通 | free 与 Pro 的权限差异清晰可见 |
| 数据正确性 | 生成「结果」与支付状态入库 | 错误提示、空状态、loading 状态齐全 |
| 权限与安全 | 未登录用户不能访问受保护页面,普通用户不能进 Admin | 有基础的输入校验与服务端认证 |
| 交付质量 | 可本地运行并可部署上线 | README 清晰,演示视频结构完整 |
提交前做最后一次检查:首页、登录、Dashboard、Billing、Admin 页面全部完成;用户可注册/登录/登出;生成结果确实写入数据库;支付主链路可用;管理员能查看用户、生成记录与支付状态;项目已部署到公网。
贯穿始终的一条原则
任务文档在结尾给了所有学习者一句最重要的提醒:"先保证'能跑通',再追求'做漂亮'。" 这既是本项目的验收哲学,也是 vibe coding 的核心心法——先打通"注册 → 登录 → 生成 → 历史 → 支付 → 后台"的完整闭环,让数据真实地流动起来,再逐步打磨视觉、交互与权限细节。当你感觉任务量太大时,回到这条原则,把"最小可运行闭环"作为唯一目标,其余都是增量优化。