Easy-Vibe 阶段二综合实战:用 AI 从 PRD 到上线,构建 Supabase + Stripe 的 AI 营销文案 SaaS
Easy-Vibe 阶段二综合实战:用 AI 从 PRD 到上线,构建 Supabase + Stripe 的 AI 营销文案 SaaS
本篇指南对应 Easy-Vibe 课程第二阶段(Stage-2)的综合实战项目——在 docs/ar-sa/stage-2/assignments/copywriting-platform-supabase/index.md 中定义的 AI 营销文案 SaaS 平台。你将基于一份真实的 PRD,从需求分析、前端结构生成、Supabase 后端集成、Stripe 支付闭环,一路走到部署上线,完整交付一个可运行的 SaaS 原型。读完本文,你将掌握"用 AI 助手(如 Trae / Claude Code)按 PRD 驱动全栈开发"的完整工作流,并能把阶段二此前学过的前端设计、后端接口、数据库、支付、部署等单项技能串联成一条可交付的产品闭环。
项目总览:一个包含三套子系统的 AI 营销文案 SaaS
本项目的目标用户是独立开发者、小团队和内容运营者。它不是单次调用大模型的 Demo,而是一套带登录、生成、历史、套餐、后台管理的完整产品。整个系统划分为三个子系统:
| 子系统 | 职责 |
|---|---|
| 官网前台(www) | 产品介绍、定价、FAQ、注册转化 |
| 用户工作台(app) | 录入产品信息、生成文案、查看历史、升级套餐 |
| 后台管理台(admin) | 管理用户、生成记录、支付数据、运营概览 |
后端采用 Supabase 提供数据库与用户认证,Stripe 处理支付,另接一个第三方大模型 API 生成营销文案。
前置知识与学习目标
开始前,应已掌握阶段二以下章节的内容(对应仓库路径):
- 界面设计与组件库:UI 设计、现代组件库
- 后端接口开发:AI 辅助编写接口代码
- 数据库与 Supabase:从数据库到 Supabase
- 支付集成:Stripe 支付系统
- Git 与部署:Git 与 GitHub 工作流、部署 Web 应用
完成本项目后,你将能够:
- 读懂真实 PRD,并从中提取开发任务清单;
- 用 AI 分步生成前端页面与后端接口;
- 用 Supabase 实现用户认证与数据库操作;
- 集成 Stripe 实现付费订阅功能;
- 搭建管理后台,完成从零到一的端到端集成。
本文所依据的 PRD 全文位于仓库 docs/zh-cn/stage-2/assignments/copywriting-platform-supabase/PRD.md,状态为 Draft v0.1,是理解本项目的权威依据。
第一部分:需求分析(Part 1)
1.1 阅读 PRD,回答五个关键问题
打开 PRD 后,先不要写代码,集中回答以下问题:
- 系统有几个入口?每个入口覆盖哪些页面?
- 每个页面的核心功能是什么?
- 后端涉及哪些数据库模块与表?
- 套餐定价、支付流程和免费额度是如何设计的?
- MVP 范围是什么?第一版做什么、明确不做什么?
警告: 如果对上述问题还没有清晰答案,不要开始写代码。需求不明确是返工最常见的原因。
以仓库中的 PRD.md 为例,答案可以归纳为:
- 三套入口、十张大页面:官网前台 1 张(首页
www:/),用户工作台 5 张(登录app:/login、注册app:/register、生成工作台app:/generate、历史记录app:/history、套餐页app:/billing),后台管理台 4 张(首页admin:/、用户管理admin:/users、生成记录admin:/generations、支付与订阅admin:/billing)。 - MVP 边界:第一版必须包含官网首页、注册/登录、文案生成工作台、历史记录页、套餐页、支付/订阅、后台查看数据;第一版明确不做团队协作、多语言翻译链路、复杂工作流编排和模板市场。
- 角色权限:游客可浏览官网与注册登录;注册用户可生成文案、查看历史、管理套餐;管理员可查看用户、生成数据、支付与运营数据。
- 技术选型建议:前端
Next.js App Router,鉴权Supabase Auth,数据库Supabase Postgres,支付Stripe,AI 能力通过统一后端适配层对接第三方大模型 API;站点入口约定为www.xxx.com、app.xxx.com、admin.xxx.com。
1.2 确认系统架构
基于 PRD 提炼出整体架构:
flowchart TD
prd["PRD"] --> web["官网前台"]
prd --> app["用户工作台"]
prd --> admin["后台管理台"]
app --> auth["认证"]
app --> gen["文案生成任务"]
gen --> db["数据库"]
billing["支付与套餐"] --> db
admin --> analytics["用户 / 生成 / 支付面板"]
PRD 中的系统总览进一步明确了前后端与基础设施的关系:官网前台、用户工作台、后台管理台三套入口统一接入应用 API / 管理 API,再由 API 层分别调用 Supabase Auth、Supabase Postgres、Stripe 与第三方大模型 API。
1.3 从 PRD 继承的数据模型与接口草案
这份实战文档要求你从 PRD 中自行推导数据库与接口,而 PRD 给出的建议表结构(可以直接转化为 Supabase SQL)是:
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
)
配套的接口草案包括: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。
第二部分:构建项目结构(Part 2)
2.1 用 AI 生成前端页面
先用 AI 生成基础结构,全部页面先用假数据(mock data),不接真实接口。参考提示词:
请根据当前 PRD 帮我生成一个 AI 营销文案 SaaS 的前端结构。
要求:
1. 三个入口:www、app、admin
2. 官网包括:首页、定价、FAQ
3. app 包括:登录、注册、工作台、历史记录、套餐页
4. admin 包括:管理首页、用户管理、生成记录、支付订单
5. 只生成页面结构和假数据,不接真实接口
6. 是现代 SaaS 风格,不是课堂演示风
PRD 在产品形态上建议参考 Jasper 与 Copy.ai 的做法:官网强调 Hero、品牌价值、工作流与 CTA 转化;工作台让"生成"成为一个带上下文、多产出类型的工作空间;套餐页与后台页都要像真实营销 SaaS 而不是单页工具。首页负责转化,工作台负责结构化输入与输出管理,历史页负责内容复用,套餐页负责商业化,后台负责运营视角。
2.2 优化核心页面:生成工作台(Dashboard)
结构搭好后,聚焦打磨文案生成工作台页 /dashboard:
请帮我优化 /dashboard 页面。
这是一个 AI 营销文案生成工作台。
左侧表单字段:
- 产品名称
- 一句话简介
- 目标用户
- 3 个卖点
- 投放渠道(官网、微信朋友圈、小红书、抖音、邮件)
右侧「结果区」预留:
- 主标题
- 副标题
- CTA
- 3 条短文案
- 长文案
先用假数据跑通交互。
要求:
- 点击"生成文案"后有加载状态
- 「结果区」设计空状态
- 响应式布局,宽屏窄屏都正常
2.3 校验页面结构
逐项核对:
- [ ] 三个入口的路由是否独立
- [ ] 页面数量是否与 PRD 一致
- [ ] Dashboard 表单与「结果区」布局是否合理
- [ ] 假数据是否覆盖了基本 UI 状态(空、加载、正常)
前端阶段卡住了?
可回看这些章节:UI 设计、多产品 UI 设计与按钮规范、用 LLM 和 Skills 让界面变好看、从设计稿到项目代码、用现代组件库更新界面。
第三部分:后端集成(Part 3)
3.1 接入 Supabase 登录
把下列需求完整交给 AI 助手(它应该每一步都说明改动了哪些文件):
把我当作完全新手,一步步帮我接入 Supabase 登录。
我需要你帮我:
1. 把项目连接到 Supabase
2. 实现注册、登录、退出登录
3. 登录成功后跳转到 /dashboard
4. 未登录用户访问 /dashboard、/billing、/admin 时自动重定向到 /login
5. 创建 profiles 表
6. 用户注册成功后自动在 profiles 表创建一条记录
7. profiles 表必须包含 email、role、plan 字段
实现要求:
- 每一步说明改动的文件
- 不要硬编码密钥
- 明确标出哪些地方需要在 Supabase 控制台手动操作
- 完成后说明如何验证注册与登录
结合 从数据库到 Supabase 章节的要点,这里有几个需要你在 Supabase 控制台手动完成的动作:
- 创建项目并拿到连接参数:在 Supabase 控制台创建项目后,进入 Project Settings → Data API 获取
Supabase URL(形如https://xxx.supabase.co),在 API Keys 中获取anon public密钥。anon key 的权限严格受 RLS 约束,只能访问授权给用户的数据;service_role密钥属于服务端高权限密钥,可以绕过行级安全,严禁公开分享。前端通常通过环境变量注入,参考NEXT_PUBLIC_SUPABASE_URL与NEXT_PUBLIC_SUPABASE_ANON_KEY的方式。 - 关闭强制邮箱确认(可选):如果希望注册后立刻能登录,可在 Authentication → Sign In / Providers 中取消
Confirm email的强制确认。 - Schema 约定:日常开发只需关注两个 schema——
public(业务表所在)与auth(Supabase 内置的用户表auth.users,不建议手动改动)。 - RLS(行级安全):
profiles、generation_records等业务表一定要开启 RLS,并利用auth.uid()编写策略,实现"每个用户只能读写自己的数据"的隔离。这也是本项目评估标准中"权限与安全"维度的核心。
3.2 接入生成接口与数据库
完成网站的核心功能——生成营销文案并保存:
把我当作完全新手,帮我完成网站核心功能:生成营销文案并保存。
期望效果:
1. 用户在 /dashboard 填写表单并点击"生成文案"
2. 后端收到:产品名称、简介、目标用户、卖点、投放渠道
3. 后端调用模型生成「结果」
4. 页面展示生成的「结果」
5. 输入和输出保存到数据库
6. 用户再次回来可以查看历史记录
我需要你完成:
- 创建 /api/generate 生成接口
- 创建 generations 表
- 设计输入输出字段
- 在 Dashboard 页面读取当前用户的历史记录
用户体验:
- 按钮加载状态
- 生成失败时的错误提示
- 无记录时的空状态
完成后说明:
- 前端页面文件位置
- 后端接口文件位置
- 数据库写入逻辑位置
- 如何测试完整生成链路
对照 PRD,generation_records 表用 input_payload jsonb 保存输入、output_payload jsonb 保存输出,并记录 channel、tone、status、created_at,正是为了支撑这条"生成 → 落库 → 历史回看"的链路。从实现角度看,模型 API 的密钥不应出现在浏览器端,建议放到后端适配层或 Supabase Edge Function 中,通过 Deno.env.get 读取 secrets 并配合 auth.uid() 完成权限判定。
3.3 接入 Stripe 支付
为 LaunchKit 接入一套最简单的可用 Stripe 支付:
把我当作完全新手,帮 LaunchKit 添加一套最简单的可用 Stripe 支付。
我们不需要复杂系统,只要跑通最简支付链路。
我需要你完成:
1. /billing 页面展示 free 和 pro 两个套餐
2. 用户点击升级后跳转 Stripe Checkout
3. 支付成功后跳回网站
4. 支付「结果」保存到 subscriptions 表
5. 同步更新 profile.plan 字段
6. free 用户每天限 3 次生成,pro 用户不限
实现原则:
- 先跑通主链路,暂时不用纠结复杂限制
- 明确标出哪些地方需要你在 Stripe 控制台配置
- 完成后说明如何测试完整支付链路
结合 Stripe 支付系统 章节,接入时务必守住三条支付铁律:
- 价格必须由后端确定,不能信任前端传来的金额——浏览器请求可以被任意篡改;
- 真正激活权益的是 Webhook,而不是
success页面——用户跳转到成功页不代表数据库已同步; - 数据库必须保存支付状态,不能只依赖 Stripe 控制台。
最简支付链路为:用户点击购买 → 前端向后端请求创建支付会话(POST /api/billing/checkout)→ 后端用 Stripe 密钥按 price_id 创建 Checkout Session(价格由后端指定)→ 用户跳转 Stripe 支付 → Stripe 通过 Webhook 通知"支付成功" → 后端更新数据库(subscriptions 表与 profiles.plan)→ 前端读取最新状态。
Stripe 控制台需要你手动完成:在 Test mode 下创建 Product(如 Pro Plan)与 Price(如 pro_monthly、pro_yearly),记录对应的 price_id;配置支付成功后的回调地址与 Webhook 端点。
3.4 构建后台管理台
做一个简单可用的管理后台:
把我当作完全新手,帮我做一个简单可用的后台管理台。
仅限管理员使用。
我需要你完成:
1. 只有 role = admin 的用户能访问 /admin
2. 后台有 3 个标签页:用户列表、生成记录、订阅状态
3. 用户列表展示:邮箱、套餐、创建时间
4. 生成记录展示:用户、产品名称、渠道、创建时间
5. 订阅状态展示:用户、套餐、支付状态
要求:
- 界面简洁清晰
- 使用现有组件库的表格、标签页、徽章组件
- 完成后说明如何把账号设为管理员
role = admin 的判定依赖 profiles.role 字段,在开发阶段可以直接在 Supabase Table Editor 中手动把某个账号的 role 改为 admin。后台数据天然是跨用户的,因此这套数据读取通常需要走服务端或具有更高级别权限的路径,避免被普通用户的 RLS 策略挡住。
后端阶段卡住了?
可回看:从数据库到 Supabase、AI 辅助编写接口代码与文档、如何集成 Stripe 等支付系统。
第四部分:集成与部署(Part 4)
4.1 端到端全链路测试
至少验证以下两条主链路:
- 注册 → 登录 → 生成文案 → 查看历史 → 升级套餐
- 管理员登录 → 查看用户数据 → 查看生成记录 → 查看支付状态
上线前检查,把这段需求交给 AI:
把我当作完全新手,帮我检查项目是否具备上线条件。
检查要点:
- 环境变量是否齐全
- 登录回调地址是否正确
- Stripe 支付回调地址是否正确
- 页面是否缺少加载态、空状态或错误提示
- README 是否有运行与部署说明
我需要你:
1. 按优先级列出需要修复的项
2. 说明先修什么
3. 说明修复后的「部署步骤」
对应 PRD 的非功能要求:生成过程要有清晰加载与失败反馈;用户历史记录只能自己可见;支付状态与套餐状态要一致;后台能按日查看生成量与付费数据;首页与工作台移动端可用。同时参考 PRD 的监控建议(模型调用成功率、接口平均耗时、支付回调成功率、数据库慢查询、关键任务错误日志)自查基础观测是否到位。
4.2 部署上线
把项目部署到公网。可参考部署章节:Git 与 GitHub 工作流、部署 Web 应用。部署前确认环境变量(Supabase URL、anon key、Stripe 密钥、模型 API 密钥等)已完整注入,回调地址与线上域名一致。
交付物清单
完成后需提交:
- [ ] 可访问的在线演示链接
- [ ] 源码仓库链接(含 README)
- [ ] PRD 文档
- [ ] 核心页面截图(首页、Dashboard、Billing、Admin)
- [ ] 60 秒演示视频(覆盖 注册 → 生成 → 支付 → 后台管理)
README 至少包含:项目介绍、核心页面说明、技术栈、本地运行步骤、环境变量清单。
评估标准
| 维度 | 基础要求 | 进阶要求 |
|---|---|---|
| 产品完整度 | 首页、登录、Dashboard、Billing、Admin 均可访问 | 首页文案与视觉风格接近真实 SaaS |
| 业务闭环 | 注册 → 登录 → 生成 → 查看历史 全链路可跑通 | free 与 Pro 的权限差异清晰可见 |
| 数据正确性 | 生成「结果」与支付状态确实落库 | 有明确的错误提示、空状态、加载状态 |
| 权限与安全 | 未登录用户无法访问受保护页面,普通用户进不了 Admin | 有基础输入校验与服务端认证 |
| 交付质量 | 项目本地可跑、可部署上线 | README 清晰,演示视频结构完整 |
提示: 如果觉得任务量太大,记住一条原则:先保证"能跑通",再追求"做得好看"。
提交前最终检查
- [ ] 首页、登录、Dashboard、Billing、Admin 页面全部完成
- [ ] 用户可注册、登录、退出
- [ ] 生成「结果」确实保存到数据库
- [ ] 支付主链路可用
- [ ] 管理员可查看用户、生成记录、支付状态
- [ ] 项目已部署到公网
延伸阅读
本文基于的实战任务与配套资料,均可继续深入仓库中的对应章节:
- UI 设计、多产品 UI 设计、LLM 与 Skills 美化界面、从设计稿到代码、现代组件库
- 从数据库到 Supabase(含 RLS、
auth.uid()、anon / service_role 密钥、Edge Functions 等原理细节) - AI 辅助编写接口代码
- Git 与 GitHub 工作流、部署 Web 应用
- 集成 Stripe 支付系统(含 Webhook、订阅事件与各地区支付方案附录)
本项目的完整需求定义,始终以 PRD.md 为准——页面架构、数据表、接口草案、MVP 边界与开发顺序建议都在其中,实战时请以它为唯一事实来源。