001project_wildgrowth/backend

野成长 (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. 安装依赖

npm install

2. 配置环境变量

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

cp .env.example .env

3. 设置数据库

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

# 生成Prisma Client
npm run prisma:generate

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

4. 启动开发服务器

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登录配置