init：代码初始化

docs/QUICK_START.md

@@ -0,0 +1,141 @@
+# 快速开始指南
+
+## 🚀 快速启动
+
+### 1. 配置环境变量
+
+复制 `.env.example` 到 `.env` 并配置数据库连接：
+
+```bash
+cp .env.example .env
+```
+
+编辑 `.env` 文件，填入你的数据库信息：
+
+```env
+# 服务器配置
+NODE_ENV=development
+PORT=3000
+
+# 数据库配置
+DB_HOST=localhost
+DB_PORT=3306
+DB_NAME=steel_prices
+DB_USER=root
+DB_PASSWORD=your_password
+
+# 日志配置
+LOG_LEVEL=info
+```
+
+### 2. 创建数据库
+
+确保 MySQL 已安装并运行，然后执行：
+
+```bash
+# 方式 1: 使用 npm 脚本（推荐）
+npm run db:init
+
+# 方式 2: 手动创建
+mysql -u root -p -e "CREATE DATABASE steel_prices CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;"
+```
+
+### 3. 导入数据
+
+导入钢材价格数据：
+
+```bash
+npm run db:import
+```
+
+这将导入 `data/` 目录下的所有 JSON 数据文件（约 31,098 条记录）。
+
+### 4. 启动服务
+
+```bash
+# 开发模式
+npm run dev
+
+# 或生产模式
+npm start
+```
+
+服务将在 `http://localhost:3000` 启动。
+
+### 5. 测试 API
+
+打开浏览器或使用 curl 测试：
+
+```bash
+# 健康检查
+curl http://localhost:3000/api/health
+
+# 按地区查询价格
+curl "http://localhost:3000/api/prices/region?region=昆明"
+
+# 搜索价格数据
+curl "http://localhost:3000/api/prices/search?material=HPB300&startDate=2026-01-01&endDate=2026-01-05"
+
+# 获取价格统计
+curl "http://localhost:3000/api/prices/stats?region=昆明&days=30"
+
+# 获取价格趋势
+curl "http://localhost:3000/api/prices/trend?material=HPB300&days=30"
+```
+
+## 📚 API 端点
+
+| 方法 | 端点 | 描述 |
+|------|------|------|
+| GET | `/api/health` | 健康检查 |
+| GET | `/` | API 信息 |
+| GET | `/api/prices/region` | 按地区查询价格 |
+| GET | `/api/prices/search` | 搜索价格数据 |
+| GET | `/api/prices/stats` | 获取价格统计 |
+| GET | `/api/prices/trend` | 获取价格趋势 |
+| POST | `/api/prices/import` | 导入价格数据 |
+
+## 🔧 常见问题
+
+### 数据库连接失败
+
+1. 检查 MySQL 服务是否运行
+2. 确认 `.env` 中的数据库配置正确
+3. 确保数据库用户有足够的权限
+
+### 端口被占用
+
+如果 3000 端口被占用，可以修改 `.env` 中的 `PORT` 配置：
+
+```env
+PORT=3001
+```
+
+### 数据导入失败
+
+1. 确保 `data/` 目录下的 JSON 文件存在
+2. 检查数据库表是否已创建
+3. 查看控制台错误日志
+
+## 📊 数据统计
+
+导入完成后，可以查看数据库统计信息：
+
+```bash
+npm run db:import
+```
+
+脚本会自动显示：
+- 总记录数
+- 平均价格
+- 最低/最高价格
+
+## 🎯 下一步
+
+- 查看 [README.md](../README.md) 了解项目详情
+- 查看 [API 文档](./api.md) 了解完整的 API 使用方法
+- 查看项目 [CLAUDE.md](../CLAUDE.md) 了解项目架构
+
+---
+
+有问题？查看 [GitHub Issues](https://github.com/your-username/steel_prices_service/issues)