thedev.world

thedev.world 是一个开源的、极具创意的开发者社区可视化平台。它将枯燥的 GitHub 贡献数据转化为一个生动、动态的 3D 交互世界。在这里，代码不再是冰冷的文本，而是构建虚拟领土的砖石；每一次提交、每一个 Pull Request 都在塑造你在数字星球上的版图。

核心概念：代码即领土

• 主题岛屿：开发者根据技术栈被分配到不同的“专业岛屿”，如前端岛、后端岛、基础设施岛等，形成自然的社区聚类。
• 六边形领地：每个开发者占据一个或多个六边形单元格。单元格的大小和等级直接由你的 XP 分数（基于提交、PR、Code Review、Star 等活动的加权计算）决定。贡献越多，领地越广阔、越耀眼。
• 实时同步：星球是活的。随着全球开发者的持续贡献，地图会实时更新，反映最新的开源生态活力。
• 认领身份：使用 GitHub 账号登录后，你可以认领属于自己的单元格，查看自己的详细贡献统计，并探索其他开发者的领地。

本地开发与部署

thedev.world 采用前后端分离架构，支持完整的本地开发环境搭建。

前置要求

• 前端：Node.js v20+、npm 10+
• 后端：Docker、Docker Compose、Task (go-task)

快速启动指南

1. 克隆仓库

   git clone https://github.com/thedev-world/api
   git clone https://github.com/thedev-world/front
   

2. 配置并启动后端

   cd api
   cp .env.example .env   # 务必配置 GitHub OAuth 客户端 ID 和 Secret
   task build             # 构建后端服务
   task dev               # 启动开发服务器
   task migrate-up        # 执行数据库迁移
   

3. 填充测试数据（可选）
   为了在本地看到丰富的星球效果，可以生成虚拟开发者数据：

   task seed -- --count 150 --clear
   

4. 启动前端

   cd ../front
   cp .env.local.example .env.local
   npm install
   npm run dev
   

5. 访问应用
   打开浏览器访问 http://localhost:3000 即可看到属于你的 3D 开发者星球。

项目意义

thedev.world 不仅是一个炫酷的数据可视化工具，更是一种对开源贡献者的游戏化激励。它让抽象的代码贡献变得可见、可感、可比，增强了开发者社区的归属感和成就感。对于招聘者或技术领导者而言，这也是一个直观发现高活跃度、高影响力开发者的新颖视角。