# 野成长 (Wild Growth) 后端API

## 技术栈

- **运行环境**: Node.js 24+
- **框架**: Express.js
- **语言**: TypeScript
- **数据库**: PostgreSQL
- **ORM**: Prisma
- **认证**: JWT
- **日志**: Winston

## 项目结构

```
backend/
├── src/
│   ├── controllers/    # 控制器（处理请求）
│   ├── services/       # 业务逻辑
│   ├── models/         # 数据模型
│   ├── middleware/     # 中间件
│   ├── routes/         # 路由定义
│   ├── utils/          # 工具函数
│   ├── types/          # TypeScript类型定义
│   └── index.ts        # 入口文件
├── prisma/
│   └── schema.prisma   # 数据库模型定义
├── logs/               # 日志文件
└── dist/               # 编译后的JavaScript文件
```

## 快速开始

### 1. 安装依赖

```bash
npm install
```

### 2. 配置环境变量

复制 `.env.example` 为 `.env` 并填写配置：

```bash
cp .env.example .env
```

### 3. 设置数据库

确保PostgreSQL已安装并运行，然后：

```bash
# 生成Prisma Client
npm run prisma:generate

# 运行数据库迁移
npm run prisma:migrate
```

### 4. 启动开发服务器

```bash
npm run dev
```

服务器将在 `http://localhost:3000` 启动

## 开发命令

- `npm run dev` - 启动开发服务器（热重载）
- `npm run build` - 编译TypeScript
- `npm run start` - 运行编译后的代码
- `npm run prisma:generate` - 生成Prisma Client
- `npm run prisma:migrate` - 运行数据库迁移
- `npm run prisma:studio` - 打开Prisma Studio（数据库可视化工具）

## API文档

详见 `BACKEND_DEVELOPMENT_PLAN.md`

## 环境变量说明

- `PORT`: 服务器端口（默认3000）
- `NODE_ENV`: 环境（development/production）
- `DATABASE_URL`: PostgreSQL连接字符串
- `JWT_SECRET`: JWT密钥
- `JWT_EXPIRES_IN`: JWT过期时间
- `SMS_*`: 短信服务配置
- `APPLE_*`: Apple登录配置