Vom PRD zum lauffähigen Produkt: Ein KI-Marketing-Copywriting-SaaS mit Supabase und Stripe bauen(easy-vibe Stage-2 综合实战)

原创2026-09-21 17:12:001,605 阅读
文章标签:教程文档Vibe Coding

Vom PRD zum lauffähigen Produkt: Ein KI-Marketing-Copywriting-SaaS mit Supabase und Stripe bauen(easy-vibe Stage-2 综合实战)

本篇指南以 Datawhale easy-vibe 项目 Stage 2 的综合实战任务为蓝本,完整拆解如何围绕一份真实的 PRD,从零搭建一个面向独立开发者与内容团队的 AI 营销文案 SaaS 产品:用 Supabase 承担数据库与用户鉴权,用 Stripe 完成订阅收费,并用 AI 辅助生成三套前端(官网前台 / 用户工作台 / 后台管理台)。读完本文,你将掌握"需求分析 → 骨架搭建 → 后端集成 → 联调上线"的完整交付链路,并拿到可直接复用/改写的 AI 提示词与验收清单。

一、任务全景:这是一个什么样的实战项目

本实战是 easy-vibe Stage 2 的综合实战环节。在前面几章中,你分别学习了前端页面搭建、后端接口开发、数据库操作、支付集成等单项技能;本项目的核心要求是把这些能力全部串联起来,交付一个可运行的产品原型,而不是一次性的模型调用 Demo。

要交付的产品是 AI 营销文案 SaaS,由三个子系统组成:

子系统 职责
官网前台(www) 产品介绍、定价、FAQ、注册转化
用户工作台(app) 输入产品信息、生成文案、查看历史、升级套餐
后台管理台(admin) 用户管理、生成记录、支付数据、运营概览

后端使用 Supabase 提供数据库与鉴权能力,使用 Stripe 处理支付,使用 AI 大模型生成营销文案。

前置知识

动手之前,建议已经掌握以下内容(均可在本仓库对应章节找到):

学习目标

完成本实战后,你将能够:

  1. 阅读并理解一份真实的 PRD,从中提取开发任务清单;
  2. 使用 AI 辅助分步生成前端页面和后端接口;
  3. 使用 Supabase 实现用户鉴权与数据库操作;
  4. 集成 Stripe 实现付费订阅功能;
  5. 搭建管理后台并完成端到端联调。

二、第一部分:需求分析

2.1 阅读 PRD

本项目的需求文档在本仓库:查看 PRD。PRD 是开发的地基,打开后重点回答以下问题:

  • 系统有几个入口?各自覆盖哪些页面?
  • 每个页面的核心功能是什么?
  • 后端包含哪些模块和数据表?
  • 套餐定价、支付流程、免费额度如何设计?
  • MVP 范围是什么?第一版哪些做、哪些不做?

⚠️ 警告:如果以上问题没有明确答案,不要开始写代码。需求理解不清楚是导致返工的最常见原因。

从 PRD 中可以提取出的关键事实(这份 PRD 定义得非常具体):

  • 3 套入口、10 个大页面:官网前台 1 个(首页 www:/),用户工作台 5 个(app:/login、app:/register、app:/generate、app:/history、app:/billing),后台管理台 4 个(admin:/、admin:/users、admin:/generations、admin:/billing);
  • 角色与权限:游客可浏览官网、注册登录;注册用户可生成文案、查看历史、管理套餐;管理员可查看用户、生成数据、支付与运营数据;
  • MVP 范围:第一版必须包含官网首页、注册/登录、文案生成工作台、历史记录页、套餐页、支付/订阅能力、后台查看;第一版不做团队协作、多语言翻译链路、复杂工作流编排、模板市场;
  • 后端模块:auth、generation、history、billing、analytics、admin 六个模块;
  • 建议数据表:profiles(id、email、role、plan、created_at)、generation_records(id、user_id、input_payload jsonb、output_payload jsonb、channel、tone、status、created_at)、billing_records(id、user_id、plan_code、billing_cycle、amount_cents、status、created_at);
  • 开发顺序建议:搭官网和登录注册页 → 实现生成工作台 → 接入鉴权和数据库 → 接入模型生成接口 → 实现历史记录 → 接入支付与套餐 → 实现后台运营页。

这份 PRD 的页面设计思想也值得注意:它明确建议参考 Jasper 与 Copy.ai 的真实产品形态——首页负责转化、工作台负责结构化输入与输出管理、历史页负责内容复用、套餐页负责商业化、后台负责运营视角,而不是"一个输入框 + 一个结果框"的单页工具。

2.2 确认系统架构

根据 PRD 梳理出系统的整体架构:

flowchart TD
  prd["PRD"] --> web["官网前台"]
  prd --> app["用户工作台"]
  prd --> admin["后台管理台"]
  app --> auth["鉴权"]
  app --> gen["文案生成任务"]
  gen --> db["数据库"]
  billing["支付与套餐"] --> db
  admin --> analytics["用户 / 生成 / 支付看板"]

从源码结构看,这条链路与仓库中 从数据库到 Supabase 章节所述的 BaaS 架构一脉相承:Supabase 以 PostgreSQL 为核心,将 Auth、Database、Storage、Realtime、Edge Functions 打包成"Postgres 为中心的 All-in-One 后端平台",而 Stripe 承担支付闭环,大模型 API 承担生成能力。

三、第二部分:搭建项目骨架

3.1 用 AI 生成前端页面

使用 AI 先生成所有页面的基本结构和假数据。提示词参考(可直接复制):

请基于当前 PRD,帮我生成一个 AI 营销文案 SaaS 的前端骨架。

要求:
1. 分成三个入口:www、app、admin
2. 官网包括:首页、定价、FAQ
3. app 包括:登录、注册、生成工作台、历史记录、套餐页
4. admin 包括:后台首页、用户管理、生成记录、支付订单
5. 先只生成页面结构和假数据,不接真实接口
6. 风格要像现代 SaaS,不像课堂 demo

3.2 完善核心页面

骨架搭好后,重点完善文案生成工作台(Dashboard)页面:

请继续完善 /dashboard 页面。

这是一个 AI 营销文案工作台。

左侧表单字段:
- 产品名
- 一句话介绍
- 目标用户
- 3 个卖点
- 投放渠道(官网、朋友圈、小红书、抖音、邮件)

右侧结果区域预留:
- 主标题
- 副标题
- CTA
- 3 版短文案
- 长文案

先用 mock 数据跑通交互。

要求:
- 点击"生成文案"后有 loading 状态
- 结果区域设计空状态
- 响应式布局,宽屏窄屏都能正常显示

这里的表单字段与结果区域划分,直接对应 PRD 中"结构化文案输入 / 文案生成结果展示"的功能清单。注意 PRD 特别强调渠道预设(官网、朋友圈、小红书、抖音、邮件等)和语气选择是可选增强项,第一版以结构化输入为先。

3.3 验证页面结构

逐项检查:

  • [ ] 三个入口的路由是否独立
  • [ ] 页面数量是否与 PRD 一致(3 套入口、10 个大页面)
  • [ ] Dashboard 的表单和结果区域布局合理
  • [ ] 假数据展示了基本的 UI 状态(loading / 空状态 / 错误提示)

遇到阻碍?

如果你在前端搭建阶段卡住,可以回顾这些章节:

四、第三部分:后端集成

4.1 接入 Supabase 登录

使用以下提示词,让 AI 带你完成从 0 到 1 的登录接入:

请把我当成 0 基础,一步一步带我完成 Supabase 登录接入。

需要你帮我完成:
1. 项目接入 Supabase
2. 实现注册、登录、退出功能
3. 登录成功后跳转到 /dashboard
4. 未登录用户访问 /dashboard、/billing、/admin 时自动跳转 /login
5. 创建 profiles 表
6. 用户注册成功后自动在 profiles 表创建记录
7. profiles 表包含 email、role、plan 字段

实现要求:
- 每步都说明在修改哪些文件
- 密钥不要硬编码
- 需要在 Supabase 后台手动操作的地方请明确标注
- 完成后说明如何验证注册和登录

关于 Supabase 登录,仓库 从数据库到 Supabase 章节提供了关键实现细节,可直接作为提示词的补充上下文:

  • 连接方式:通过 .env 中的 NEXT_PUBLIC_SUPABASE_URL 与 NEXT_PUBLIC_SUPABASE_ANON_KEY 初始化客户端(createClient(url, anon)),或在项目设置中获取。anon key 可放前端,service_role key 只能留在后端;
  • 注册:supabase.auth.signUp({ email, password, options: { data: {...} } }),注册信息可携带 full_name 等元数据;所有用户数据自动落在 auth.users 表;
  • Schema 概念:public 是业务表默认容器,auth 是 Supabase 鉴权专属容器,profiles 这类业务表应建在 public 下;
  • "注册后自动创建 profiles 记录" 的推荐实现是数据库触发器 + auth.uid()。这正是 从数据库到 Supabase 中 RLS(Row Level Security)章节的核心逻辑:通过 auth.uid() 获取当前登录用户 ID,配合 RLS 策略(例如"用户只能读取自己的记录")实现行级数据隔离。

4.2 接入生成接口和数据库

请把我当成 0 基础,帮我完成网站的核心功能:生成营销文案并保存。

目标效果:
1. 用户在 /dashboard 填写表单,点击"生成文案"
2. 后端接收:产品名、介绍、目标用户、卖点、投放渠道
3. 后端调用模型生成结果
4. 页面展示生成结果
5. 输入和输出都保存到数据库
6. 用户下次进入可查看历史记录

需要你完成:
- 创建生成接口 /api/generate
- 创建 generations 表
- 设计输入和输出字段
- Dashboard 页面读取当前用户的历史记录

用户体验:
- 按钮 loading 状态
- 生成失败时的错误提示
- 无历史记录时的空状态

完成后请说明:
- 前端页面文件位置
- 后端接口文件位置
- 数据写入数据库的逻辑位置
- 如何测试完整生成链路

实现时,数据表结构可直接采用 PRD 中给出的 generation_records 设计:id、user_id、input_payload(jsonb,保存表单输入)、output_payload(jsonb,保存模型输出)、channel(投放渠道)、tone(语气)、status(生成中/成功/失败)、created_at。用 jsonb 保存输入输出,可以让字段演进时无需频繁改表。

关于后端接口的组织方式,仓库 接口代码编写 章节给出了一个值得沿用的分层结构:routes(路由层)/ controllers(控制器层)/ services(服务层)/ middlewares(中间件层),其中 service 层封装数据库交互与核心业务逻辑。例如向 Supabase 写入数据的基本形态是:

// services/generationService.js(示意,参考仓库章节的 menuService 模式)
const { createClient } = require('@supabase/supabase-js');
const supabase = createClient(process.env.SUPABASE_URL, process.env.SUPABASE_KEY);

exports.createGeneration = async (record) => {
  const { data, error } = await supabase
    .from('generation_records')
    .insert([record])
    .select();
  if (error) throw new Error(`Datenbank-Einfuegen fehlgeschlagen: ${error.message}`);
  return data[0];
};

该章节还强调了两点实战经验:给大模型完整上下文(表结构 + 约束)远比泛泛的"写个接口"有效;接口写完后可以让大模型基于代码反向生成 OpenAPI/Swagger 文档,降低前后端协作成本。

4.3 接入 Stripe 付费

请把我当成 0 基础,帮我给 LaunchKit 加上最简可用的 Stripe 付费。

不需要复杂系统,先跑通最基本的付费链路。

需要你完成:
1. /billing 页面展示 free 和 pro 两个套餐
2. 用户点击升级后跳转 Stripe Checkout
3. 支付成功后返回网站
4. 支付结果保存到 subscriptions 表
5. 同步更新 profile.plan 字段
6. free 用户每日限 3 次生成,pro 用户不限

实现原则:
- 先跑通主流程,暂不考虑复杂边界
- 需要在 Stripe 后台配置的地方请写清楚
- 完成后说明如何测试完整支付流程

支付是整个产品中"最容易踩坑"的部分。仓库 Stripe 收费系统 章节提炼了三条核心边界,建议先记住再动手:

  1. 价格必须由后端决定,不能信任前端传来的金额;
  2. 权限通过 Webhook 激活,而不是靠 success 页面;
  3. 自己的数据库必须保存支付状态,不能只依赖 Stripe 后台。

最小可用的支付链路

flowchart LR
  user["Benutzer"]
  frontend["Frontend"]
  backend["Dein Backend"]
  checkout["Stripe Checkout"]
  webhook["Stripe Webhook"]
  db["Supabase / Geschaeftsdatenbank"]

  user -->|"Kaufen klicken"| frontend
  frontend -->|"Zahlungs-Session anfordern"| backend
  backend -->|"Session mit Backend-Preis erstellen"| checkout
  frontend -->|"Zur Zahlungsseite weiterleiten"| checkout
  checkout -->|"Ereignis nach Zahlung senden"| webhook
  webhook -->|"Signatur pruefen und Status aktualisieren"| backend
  backend -->|"In orders / subscriptions schreiben"| db
  db -->|"Frontend liest neuen Status"| frontend

具体落地时,按 Stripe 收费系统 的五个步骤推进:

  1. 在 Stripe Dashboard 创建 Product 与 Price:先创建 Pro Plan 产品,再挂上 pro_monthly 与 pro_yearly 两个 Price。后端真正使用的是 price_id,务必记录;
  2. 准备环境变量: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 只能存在于后端;
  3. 后端创建 Checkout Session:前端只传 plan / userId / email,不传金额;后端根据 plan 映射 price_id 创建 Session,返回支付链接;
  4. 前端跳转:点击升级 → 请求后端接口 → 拿到 session.url 后跳转 Stripe;
  5. Webhook 更新数据库:监听 checkout.session.completed,校验签名后写入 subscriptions 表并同步更新 profile.plan。

Webhook 是支付系统的真相来源

最容易犯的错误是把 success 页面当成支付成功。success 只是"浏览器跳转成功"——用户可以伪造 URL、中途关掉页面、甚至付款了但没跳回来。Stripe 服务器通过 Webhook 发送的事件才是官方确认:

success 页面跳转 Webhook 通知
谁发起? 用户浏览器 Stripe 服务器
可伪造? 是,直接访问 URL 即可 否,有签名校验
保证支付成功? 不一定 一定
系统如何得知? 前端代码猜测 Stripe 官方通知

订阅相关的核心事件及典型处理:

事件 含义 典型动作
checkout.session.completed 首次激活成功 创建本地订阅记录
invoice.paid 自动续费成功 延长有效期
invoice.payment_failed 自动扣款失败 标记风险状态并提醒用户
customer.subscription.deleted 订阅已取消 到期后回收权限

免费额度(free 用户每日 3 次生成、pro 不限)的实现位置,建议放在生成接口 POST /api/generate 的 service 层:先读取 profiles.plan,再统计 generation_records 中当天的记录数做配额判断——这与 PRD 中"免费用户 -> 付费用户"的状态流一致。

4.4 搭建管理后台

请把我当成 0 基础,帮我做一个简洁可用的管理后台。

仅限管理员访问。

需要你完成:
1. 仅 role = admin 的用户可访问 /admin
2. 后台包含 3 个 Tab:用户列表、生成记录、订阅状态
3. 用户列表显示:email、plan、创建时间
4. 生成记录显示:用户、产品名、渠道、创建时间
5. 订阅状态显示:用户、套餐、支付状态

要求:
- 界面简洁清晰
- 使用现有组件库的表格、Tab、Badge
- 完成后说明如何将账号设为 admin

管理后台的数据来源与 PRD 的接口草案一一对应:GET /api/admin/overview(总览:用户总数、生成次数、付费收入、转化概览)、GET /api/admin/users、GET /api/admin/generations、GET /api/admin/billing。权限校验的注意点:前端隐藏路由不够,必须做服务端校验——这与评分标准中"未登录不能访问受保护页面,普通用户不能进 Admin(进阶:服务端角色校验)"的要求一致。将账号设为 admin 的常见做法是直接在 Supabase 的 profiles.role 字段中把值改为 admin(参见 从数据库到 Supabase 章节中修改用户权限字段的演示)。

遇到阻碍?

如果你在后端开发阶段卡住,可以回顾这些章节:

五、第四部分:联调与上线

5.1 端到端测试

至少验证以下场景:

  • 注册 → 登录 → 生成文案 → 查看历史 → 升级套餐
  • 管理员登录 → 查看用户数据 → 查看生成记录 → 查看支付状态

部署前检查提示词(可直接使用):

请把我当成 0 基础,帮我检查项目是否具备部署条件。

检查重点:
- 环境变量是否完整
- 登录回调地址是否正确
- Stripe 支付回调地址是否正确
- 页面是否缺少 loading、空状态、错误提示
- README 是否包含启动说明和部署说明

需要你:
1. 按优先级列出待修复事项
2. 标注哪些必须先修
3. 说明修复后的部署步骤

5.2 部署

将项目部署到公网环境。部署教程参考:Git 和 GitHub 工作流、如何部署 Web 应用。

仓库的 部署 Web 应用 章节展示了 PaaS 一键部署的典型路径:连接 GitHub 仓库 → 平台自动识别框架 → 配置环境变量 → 点击部署获得公网域名。对本项目而言,需要在部署平台完整填入 .env 中全部变量(Supabase URL/Key、Stripe 密钥、价格 ID、APP_URL),并确保 Supabase 的登录回调地址与 Stripe 的 Webhook 地址指向部署后的真实域名——这是联调阶段最容易遗漏的两处配置。

六、交付物与验收

交付物

完成本项目后,需要提交以下内容:

  • [ ] 可访问的线上演示链接
  • [ ] 源码仓库链接(含 README)
  • [ ] PRD 文档
  • [ ] 核心页面截图(首页、Dashboard、Billing、Admin)
  • [ ] 60 秒演示视频(覆盖注册 → 生成 → 支付 → 后台)

README 至少包含:项目简介、核心页面说明、技术栈、本地启动步骤、环境变量清单。

评分标准

维度 基本要求 进阶要求
产品完整度 首页、登录、Dashboard、Billing、Admin 都能访问 首页文案和视觉风格像真实 SaaS
业务闭环 注册 → 登录 → 生成 → 查看历史可以跑通 免费/Pro 权限差异清晰可见
数据正确性 生成结果和支付状态都写入数据库 有明确的错误提示、空状态和 loading
权限与安全 未登录不能访问受保护页面,普通用户不能进 Admin 有基本的输入校验和服务端鉴权
工程交付 项目可本地启动,也可部署到公网 README 清楚,演示视频结构完整

💡 如果你觉得任务太大,记住一个原则:先保证"能跑通",再去追求"做漂亮"。

提交前检查

  • [ ] 首页、登录页、Dashboard、Billing、Admin 均已完成
  • [ ] 用户可以注册、登录、退出
  • [ ] 生成结果真实写入数据库
  • [ ] 支付主流程已跑通
  • [ ] 管理员可查看用户、生成记录和支付状态
  • [ ] 项目已部署到公网

七、参考资料

登录后查看全文
easy-vibe