Vom PRD zum lauffähigen Produkt: Ein KI-Marketing-Copywriting-SaaS mit Supabase und Stripe bauen(easy-vibe Stage-2 综合实战)
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 大模型生成营销文案。
前置知识
动手之前,建议已经掌握以下内容(均可在本仓库对应章节找到):
- 前端页面设计与组件库使用:UI 设计、现代组件库
- 后端接口设计与开发:接口代码编写
- 数据库基础与 Supabase:从数据库到 Supabase
- 支付集成:Stripe 收费系统
- Git 工作流与部署:Git 和 GitHub、部署 Web 应用
学习目标
完成本实战后,你将能够:
- 阅读并理解一份真实的 PRD,从中提取开发任务清单;
- 使用 AI 辅助分步生成前端页面和后端接口;
- 使用 Supabase 实现用户鉴权与数据库操作;
- 集成 Stripe 实现付费订阅功能;
- 搭建管理后台并完成端到端联调。
二、第一部分:需求分析
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_rolekey 只能留在后端; - 注册:
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 收费系统 章节提炼了三条核心边界,建议先记住再动手:
- 价格必须由后端决定,不能信任前端传来的金额;
- 权限通过 Webhook 激活,而不是靠
success页面; - 自己的数据库必须保存支付状态,不能只依赖 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 收费系统 的五个步骤推进:
- 在 Stripe Dashboard 创建 Product 与 Price:先创建
Pro Plan产品,再挂上pro_monthly与pro_yearly两个 Price。后端真正使用的是price_id,务必记录; - 准备环境变量:
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:前端只传
plan / userId / email,不传金额;后端根据 plan 映射price_id创建 Session,返回支付链接; - 前端跳转:点击升级 → 请求后端接口 → 拿到
session.url后跳转 Stripe; - 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 均已完成
- [ ] 用户可以注册、登录、退出
- [ ] 生成结果真实写入数据库
- [ ] 支付主流程已跑通
- [ ] 管理员可查看用户、生成记录和支付状态
- [ ] 项目已部署到公网