跳转到内容
Product Factory Docs

快速开始

前置要求

  • Node.js 20+
  • pnpm 9+
  • Cloudflare 账户（用于 D1 数据库和 Workers 部署）

1. 克隆与安装

Terminal window
git clone <your-repo-url>
cd product-factory
pnpm install

2. 配置环境

复制仓库中已提供的示例文件，再按需修改：

Terminal window
cp apps/worker-auth/.dev.vars.example apps/worker-auth/.dev.vars
cp apps/worker-billing/.dev.vars.example apps/worker-billing/.dev.vars
cp apps/worker-support/.dev.vars.example apps/worker-support/.dev.vars
cp apps/web/.env.example apps/web/.env

前端应用会读取 GATEWAY_URL、PUBLIC_SUPPORT_API、PUBLIC_APP_KEY 等构建期变量。apps/admin/.env.example、apps/platform/.env.example 和 apps/docs/.env.example 里也提供了对应模板。

完整清单可参考 环境变量 和 docs/deployment/environment-variable-inventory.md。

如果要本地联调支付，建议继续执行：

Terminal window
pnpm billing:setup:stripe-cli
pnpm billing:setup:creem-cli
pnpm billing:check-env

每个 Worker 需要独立的环境配置。常见变量包括：

变量用途
JWT_SECRETBetter Auth 运行时会话签名密钥
AUTH_BASE_URL认证服务基础 URL
RESEND_API_KEY发送事务性邮件的 API 密钥
TURNSTILE_SECRETCloudflare Turnstile 人机验证密钥
OPS_WEBHOOK_URLDiscord/飞书运维通知 Webhook

3. 设置数据库

为每个服务域创建 D1 数据库：

Terminal window
npx wrangler d1 create auth-db
npx wrangler d1 create billing-db
npx wrangler d1 create content-db
npx wrangler d1 create support-db
npx wrangler d1 create ai-db
npx wrangler d1 create admin-db

运行迁移脚本：

Terminal window
pnpm db:migrate

4. 启动开发环境

以开发模式运行所有应用和 Workers：

Terminal window
pnpm dev

启动后的服务：

应用URL
Web（营销 + 博客）http://localhost:4322
管理控制台http://localhost:4321
文档http://localhost:4323
网关 Workerhttp://localhost:8787
Billing Workerhttp://localhost:8803

日常应用请求请通过网关地址访问，这样会自动附带会话和角色上下文。Billing Worker 地址只用于本地 Worker 调试、健康检查和签名 webhook 测试。

5. 验证安装

  1. 打开 http://localhost:4322 — 营销首页应正常加载。
  2. 点击 注册 创建测试账户。
  3. 登录并验证仪表盘加载所有部分（个人资料、积分、工单等）。
  4. 打开 http://localhost:4321 访问管理控制台。
  5. 如需直接验证 Billing Worker，可访问 http://localhost:8803/health。

下一步