BeaverPass Server 是一个基于 Node.js 和 GraphQL 的后端服务，提供用户认证、订单管理等功能。

项目依赖于多个环境变量来正确运行。请按照以下步骤设置环境变量：

1. 复制 .env.example 文件并重命名为 .env：

   cp .env.example .env

2. 编辑 .env 文件，填入实际的环境变量值：

   • 必需的环境变量：
     • DATABASE_URL: 数据库连接 URL
     • SESSION_SECRET: 会话密钥
     • NODE_ENV: 运行环境 (development/production)

3. 运行环境变量检查脚本确保所有必需的环境变量都已设置：

   npm run check-env

1. 安装依赖：

   npm install

2. 生成 Prisma 客户端（如果使用 Prisma）：

   npm run prisma:generate

3. 运行开发服务器：

   npm run dev

4. 运行生产服务器：

   npm start

beaverpass-server/
├── src/                  # 源代码
│   ├── config/           # 配置文件
│   ├── graphql/          # GraphQL 相关文件
│   │   ├── resolvers/    # 解析器
│   │   ├── typeDefs/     # 类型定义
│   │   └── index.js      # GraphQL 服务器设置
│   ├── middlewares/      # 中间件
│   ├── models/           # 数据模型
│   ├── routes/           # REST API 路由
│   ├── scripts/          # 实用脚本
│   └── index.js          # 应用入口点
├── prisma/               # Prisma 配置和迁移
└── .env.example          # 环境变量示例

• 用户认证: 提供用户注册、登录和会话管理
• 订单管理: 订单的创建、查询和状态更新
• 实时订阅: 通过 GraphQL 订阅提供实时更新

• 架构迁移说明

如果遇到与环境变量相关的错误，请确保：

1. 所有必需的环境变量都已正确设置
2. 数据库连接 URL 格式正确且可访问

1. 一个 Vercel 账户
2. 一个 PostgreSQL 数据库（可以使用 Supabase、Neon、Railway 等）
3. 一个 Supabase 项目（用于身份验证）
4. 一个 AWS S3 存储桶（用于文件上传）

1. 在 Vercel 上导入你的 GitHub 仓库
2. 配置以下环境变量：
   • DATABASE_URL: PostgreSQL 数据库连接字符串
   • DIRECT_URL: PostgreSQL 数据库直接连接字符串（如果使用连接池）
   • SUPABASE_URL: Supabase 项目 URL
   • SUPABASE_SERVICE_KEY: Supabase 服务密钥
   • AWS_REGION: AWS 区域
   • AWS_S3_BUCKET_NAME: S3 存储桶名称
   • AWS_ACCESS_KEY_ID: AWS 访问密钥 ID
   • AWS_SECRET_ACCESS_KEY: AWS 秘密访问密钥
   • NODE_ENV: 设置为 production
3. 部署项目

1. 克隆仓库
2. 安装依赖：npm install
3. 创建 .env 文件并配置环境变量
4. 运行开发服务器：npm run dev

Vercel 部署时会自动运行 prisma generate 和 prisma migrate deploy 命令。

• GraphQL API: /graphql

• Apollo Server
• Prisma ORM
• PostgreSQL
• Supabase 身份验证
• AWS S3 文件存储