OneZoom项目代码仓库清理与模块化重构

OneZoom项目代码仓库清理与模块化重构

OZtree OneZoom Tree of Life Explorer 项目地址: https://gitcode.com/gh_mirrors/oz/OZtree

项目背景

OneZoom是一个开源的生物多样性可视化项目，旨在以交互式树状图展示生命之树。随着项目发展，代码库经历了多次迭代和重构，其中部分功能模块被提取到专门的子仓库中管理。

代码冗余问题

在项目演进过程中，部分原本属于主仓库(OZtree)的功能被迁移到了专门的tree-build子仓库中。然而，主仓库中仍保留了一些已迁移功能的旧代码文件，例如make_js_treefiles.py等脚本。这种冗余不仅增加了维护成本，还可能导致开发者混淆，不清楚应该在哪个仓库中进行修改。

清理工作

经过开发团队讨论，决定对主仓库进行清理，移除已被tree-build仓库替代的冗余文件。清理工作主要关注以下几个方面的文件：

1. 树构建相关脚本：如make_js_treefiles.py等树文件生成脚本，这些功能现在完全由tree-build仓库处理
2. 数据库索引创建脚本：保留在OZtree仓库中，因为与主项目数据库直接相关
3. 部分安装脚本：如partial_install.py，这些脚本仍需在主仓库中维护
4. 服务器端专用脚本：包括图像和名称查询脚本、IUCN数据提取和处理脚本等，这些需要直接访问OZ服务器数据库的功能保留在主仓库

技术决策与考量

在清理过程中，团队做出了以下技术决策：

1. 功能边界划分：将树构建相关的核心逻辑完全迁移到tree-build仓库，实现功能模块化
2. 依赖关系管理：确保主仓库不再包含已迁移功能的任何残留依赖
3. 版本控制策略：通过Pull Request进行渐进式清理，确保不会意外删除必要文件
4. 文档更新：虽然没有在issue中明确提及，但这类重构通常需要同步更新相关文档

实施效果

通过这次清理工作，项目实现了：

• 更清晰的代码组织结构
• 减少重复代码带来的维护负担
• 明确的模块职责划分
• 降低新贡献者的学习成本

未来工作

虽然主要清理工作已完成，但团队注意到可能仍有少量文件需要进一步审查和迁移，特别是位于ServerScripts/Utilities目录下的工具脚本。这些将在后续工作中逐步处理，确保项目架构保持整洁和高效。

这种模块化重构不仅提升了OneZoom项目的可维护性，也为未来功能扩展奠定了更好的基础架构。

OZtree OneZoom Tree of Life Explorer 项目地址: https://gitcode.com/gh_mirrors/oz/OZtree