# 开发node服务器

## 规则（Rules）

# 搭建Node服务端 - 规范

## 1. 目录结构规范
```
./project/{项目名}/server/
├── app.js              ← 应用入口
├── config/             ← 配置文件
├── middleware/          ← 中间件
├── routes/             ← 路由定义
├── controllers/        ← 控制器
├── models/             ← 数据模型
└── utils/              ← 工具函数
```

## 2. 代码规范
- 函数命名使用小驼峰（camelCase）
- 变量和参数命名使用小写蛇形（snake_case）
- 常量命名使用全大写蛇形（SCREAMING_SNAKE_CASE）
- 缩进统一使用2个空格
- 注释使用JSDoc格式

## 3. 安全规范
- 禁止将敏感信息（密码、密钥）硬编码在代码中
- 必须使用环境变量管理配置

## 方法（Methods）

# 搭建Node服务端 - 方法

## 流程概览
```
分析需求 → 初始化项目结构 → 编写应用入口 → 编写中间件 → 编写配置 → 编写工具函数 → 验证服务启动
```

## 步骤1：分析需求
读取需求文档和架构设计文档，了解服务端技术栈要求。

## 步骤2：初始化项目结构
创建server目录和子目录，生成package.json。

## 步骤3：编写应用入口
创建Express/Koa实例，注册全局中间件，导出app实例。

## 步骤4：编写中间件
编写认证鉴权、错误处理、请求日志等中间件。

## 步骤5：编写配置
编写配置聚合和数据库连接配置。

## 步骤6：编写工具函数
编写统一响应格式等工具函数。

## 步骤7：验证服务启动
确保app.js能正确导入所有中间件和配置。

## 技巧（Tips）

# 搭建Node服务端 - 技巧

## 1. 中间件顺序
错误处理中间件必须放在最后注册，否则无法捕获错误。

## 2. 环境配置
使用 `.env` 文件管理环境变量，区分开发/测试/生产环境。

## 3. 统一响应格式
封装统一的成功/失败响应函数，保持API响应格式一致。