easy-vibe 实战项目:用 Supabase + Stripe 从 0 到 1 交付一个 AI 营销文案 SaaS 平台

原创2026-09-20 16:17:401,815 阅读
文章标签:教程文档Vibe Coding

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 章节):先记住三条硬性原则——

  1. 价格必须由后端决定,不能信任前端传来的金额(否则可被篡改);
  2. 真正激活权限的是 Webhook,而不是 success 页面(用户直接访问 /success 或中途关闭页面都可能导致误判);
  3. 数据库必须保存支付状态,不能只依赖 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 的核心心法——先打通"注册 → 登录 → 生成 → 历史 → 支付 → 后台"的完整闭环,让数据真实地流动起来,再逐步打磨视觉、交互与权限细节。当你感觉任务量太大时,回到这条原则,把"最小可运行闭环"作为唯一目标,其余都是增量优化。

登录后查看全文
easy-vibe