快速开始

本指南将帮助你快速启动 Fullstack Pack 项目。

前置要求

• Node.js >= 18.0.0
• pnpm >= 8.0.0
• PostgreSQL 数据库（或使用 Prisma Accelerate）

安装步骤

1. 克隆项目

git clone <repository-url>
cd fullstackpack

2. 安装依赖

pnpm install

3. 配置环境变量

复制 .env.example 到 .env 并填写配置：

cp .env.example .env

必需配置：

• DATABASE_URL - PostgreSQL 数据库连接字符串
• JWT_SECRET - JWT 密钥（至少 32 字符）

可选配置：

• ACCELERATE_URL - Prisma Accelerate URL（Cloudflare Workers 推荐）
• CORS_ORIGIN - CORS 允许的源
• JWT_EXPIRES_IN - JWT 过期时间（默认：7d）

4. 初始化数据库

# 推送 schema 到数据库
pnpm db:push

# 或使用 migrations（生产环境推荐）
cd apps/server
npx prisma migrate dev

5. 启动开发服务器

# 同时启动所有应用（推荐）
pnpm dev:all

# 单独启动
pnpm dev:server    # 后端：http://localhost:8787
pnpm dev:web       # Web 应用：http://localhost:8000
pnpm dev:auth-portal  # 认证门户：http://localhost:7777
pnpm docs:dev      # 文档站点：http://localhost:9000

验证安装

1. 访问 http://localhost:8000 - 应该看到 Web 应用
2. 访问 http://localhost:7777 - 应该看到认证门户
3. 访问 http://localhost:9000 - 应该看到文档站点
4. 访问 http://localhost:8787/api/v1/health - 应该看到 API 响应

下一步

• 开发指南 - 了解开发流程
• 项目结构 - 了解项目组织
• 开发规范 - 遵循开发规范