81 lines
2.2 KiB
Markdown
81 lines
2.2 KiB
Markdown
|
# 后端工具目录
|
|||
|
|
|
|||
|
|
本目录包含用于开发、测试、数据管理和系统维护的各种工具脚本。
|
|||
|
|
|
|||
|
|
## 📂 目录结构
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
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月*
|