Easy-Vibe 阶段二综合实战:用 AI 从 PRD 到上线,构建 Supabase + Stripe 的 AI 营销文案 SaaS

原创2026-09-13 13:38:071,881 阅读
文章标签:文档教程Vibe Coding人工智能

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 生成营销文案。

前置知识与学习目标

开始前,应已掌握阶段二以下章节的内容(对应仓库路径):

完成本项目后,你将能够:

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

本文所依据的 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 支付系统 章节,接入时务必守住三条支付铁律:

  1. 价格必须由后端确定,不能信任前端传来的金额——浏览器请求可以被任意篡改;
  2. 真正激活权益的是 Webhook,而不是 success 页面——用户跳转到成功页不代表数据库已同步;
  3. 数据库必须保存支付状态,不能只依赖 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 页面全部完成
  • [ ] 用户可注册、登录、退出
  • [ ] 生成「结果」确实保存到数据库
  • [ ] 支付主链路可用
  • [ ] 管理员可查看用户、生成记录、支付状态
  • [ ] 项目已部署到公网

延伸阅读

本文基于的实战任务与配套资料,均可继续深入仓库中的对应章节:

本项目的完整需求定义,始终以 PRD.md 为准——页面架构、数据表、接口草案、MVP 边界与开发顺序建议都在其中,实战时请以它为唯一事实来源。

登录后查看全文
easy-vibe