# 后端工具目录

本目录包含用于开发、测试、数据管理和系统维护的各种工具脚本。

## 📂 目录结构

```
tools/
├── data-management/     # 数据管理和维护脚本
├── testing/            # 测试相关脚本
├── verification/       # 数据验证和检查脚本
└── README.md          # 本文档
```

## 🔧 数据管理脚本 (`data-management/`)

包含用于数据库操作、数据导入导出、数据修复等的脚本：

- **创建和生成**: `create-*.js`, `generate-*.js`
- **导入和插入**: `import-*.js`, `insert-*.js`
- **修复和更新**: `fix-*.js`, `update-*.js`, `reset_*.js`
- **重新排序**: `reorder-*.js`, `simple-*.js`
- **数据恢复**: `restore-*.js`
- **清理操作**: `cleanup-*.js`

## 🧪 测试脚本 (`testing/`)

包含各种功能测试、API测试、集成测试脚本：

- **API测试**: `test-*-api.js`
- **数据库测试**: `test-db-*.js`, `test-simple-db.js`
- **功能测试**: `test-*-flow.js`, `test-*-binding.js`
- **工具测试**: `test_*.js`

## ✅ 验证脚本 (`verification/`)

包含数据验证、系统检查、分析工具：

- **数据检查**: `check-*.js`, `check_*.js`
- **数据验证**: `verify-*.js`
- **系统分析**: `analyze-*.js`
- **统计计数**: `count-*.js`

## 📝 使用说明

### 运行脚本
```bash
# 从backend目录运行
cd backend

# 运行数据管理脚本
node tools/data-management/import-farms-static-data.js

# 运行测试脚本
node tools/testing/test-db-connection.js

# 运行验证脚本
node tools/verification/check-current-data.js
```

### 环境要求
- Node.js 18.0+
- 正确配置的 .env 文件
- MySQL 数据库连接

### ⚠️ 注意事项

1. **生产环境谨慎**: 数据管理脚本可能会修改数据库，在生产环境使用前请务必备份
2. **依赖检查**: 运行前确保所有依赖已安装 (`npm install`)
3. **权限要求**: 某些脚本需要数据库管理员权限
4. **日志记录**: 重要操作会生成日志，请注意查看

### 🔗 相关文档

- [开发指南](../../DEVELOPMENT.md)
- [故障排除](../../TROUBLESHOOTING.md)
- [API文档](../../API.md)

---

*最后更新: 2025年1月*