nxxmdata/backend/tools/README.md

后端工具目录

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

📂 目录结构

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

📝 使用说明

运行脚本

# 从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. 日志记录: 重要操作会生成日志，请注意查看

🔗 相关文档

• 开发指南
• 故障排除
• API文档

---

最后更新: 2025年1月