whale-town-front/docs/CONTRIBUTORS.md

# 贡献者名单

感谢所有为 Whale Town 项目做出贡献的开发者！

## 🏆 核心团队

### 项目负责人
- **[moyin](https://gitea.xinghangee.icu/moyin)** - 项目架构师 & 核心开发者
  - 负责项目整体架构设计
  - 用户认证系统开发
  - 代码审查和质量控制

### 核心开发者
- **[jianuo](https://gitea.xinghangee.icu/jianuo)** - 前端开发专家
  - Godot引擎集成和优化
  - UI/UX设计和实现
  - 游戏核心功能开发

- **[angjustinl](https://gitea.xinghangee.icu/ANGJustinl)** - 系统架构师
  - 模块化架构设计
  - 性能优化和调试
  - 测试框架建设

## 🌟 贡献统计

### 代码贡献
| 贡献者 | 提交数 | 代码行数 | 主要贡献领域 |
|--------|--------|----------|--------------|
| moyin | 50+ | 5000+ | 架构设计、认证系统 |
| jianuo | 40+ | 4000+ | UI开发、游戏逻辑 |
| angjustinl | 30+ | 3000+ | 系统优化、测试 |

### 文档贡献
- **项目文档**: moyin, jianuo, angjustinl
- **API文档**: moyin
- **开发规范**: 全体核心团队
- **用户指南**: jianuo

### 测试贡献
- **单元测试**: angjustinl, moyin
- **集成测试**: 全体核心团队
- **性能测试**: angjustinl
- **用户测试**: jianuo

## 🎯 贡献领域

### 🔧 技术贡献
- **架构设计** - 模块化系统设计和实现
- **前端开发** - Godot场景和UI组件开发
- **后端集成** - API接口集成和网络通信
- **性能优化** - 游戏性能调优和资源管理
- **测试开发** - 自动化测试和质量保证

### 📚 文档贡献
- **技术文档** - API文档、架构文档
- **开发指南** - 编码规范、最佳实践
- **用户文档** - 使用说明、教程指南
- **项目管理** - 需求分析、项目规划

### 🎨 设计贡献
- **UI/UX设计** - 界面设计和用户体验优化
- **游戏设计** - 游戏机制和玩法设计
- **视觉设计** - 图标、插画、动画设计
- **音频设计** - 音效、音乐制作

## 🚀 里程碑贡献

### v1.0.0 - 基础框架 (2025-12)
- **moyin**: 项目初始化和架构设计
- **jianuo**: Godot项目搭建和基础场景
- **angjustinl**: 核心系统和管理器实现

### v1.1.0 - 用户认证 (2025-12)
- **moyin**: 认证系统后端集成
- **jianuo**: 认证界面设计和实现
- **angjustinl**: 验证码系统优化

### v1.2.0 - 模块化重构 (规划中)
- **全体团队**: 模块化架构重构
- **社区贡献者**: 新功能模块开发

## 🤝 如何成为贡献者

### 贡献方式
1. **代码贡献** - 提交Bug修复和新功能
2. **文档贡献** - 完善项目文档和教程
3. **测试贡献** - 编写测试用例和质量保证
4. **设计贡献** - UI/UX设计和游戏设计
5. **社区贡献** - 帮助其他开发者和用户

### 贡献流程
1. **Fork项目** - 创建项目副本
2. **创建分支** - 为新功能创建专门分支
3. **开发功能** - 遵循项目规范进行开发
4. **提交PR** - 创建Pull Request
5. **代码审查** - 核心团队进行代码审查
6. **合并代码** - 审查通过后合并到主分支

### 贡献要求
- 遵循项目的[代码规范](./naming_convention.md)
- 添加适当的[测试用例](../tests/)
- 更新相关[文档](./README.md)
- 使用规范的[提交信息](./git_commit_guide.md)

## 🏅 贡献者权益

### 认可和奖励
- **贡献者徽章** - 在项目中展示贡献者身份
- **技术分享** - 优先参与技术分享和讨论
- **项目决策** - 参与重要功能的设计讨论
- **学习机会** - 接触最新技术和最佳实践

### 成长路径
1. **新手贡献者** - 修复简单Bug，完善文档
2. **活跃贡献者** - 开发新功能，参与设计讨论
3. **核心贡献者** - 负责重要模块，指导新人
4. **维护者** - 项目管理，技术决策

## 📊 贡献统计

### 月度活跃贡献者 (2025-12)
1. moyin - 15 commits
2. jianuo - 12 commits  
3. angjustinl - 10 commits

### 累计贡献排行
1. moyin - 120+ commits, 10000+ lines
2. jianuo - 95+ commits, 8000+ lines
3. angjustinl - 80+ commits, 6000+ lines

### 贡献类型分布
- 代码贡献: 70%
- 文档贡献: 20%
- 测试贡献: 10%

## 🎉 特别感谢

### 技术支持
- **Godot社区** - 提供优秀的游戏引擎和技术支持
- **开源社区** - 提供各种优秀的开源工具和库

### 测试反馈
- **内测用户** - 提供宝贵的测试反馈和建议
- **社区用户** - 报告Bug和提出改进建议

### 设计灵感
- **像素游戏社区** - 提供设计灵感和创意想法
- **独立游戏开发者** - 分享开发经验和最佳实践

## 📞 联系贡献者

### 核心团队联系方式
- **项目讨论**: [Gitea Discussions](https://gitea.xinghangee.icu/datawhale/whale-town/discussions)
- **技术交流**: [Issues](https://gitea.xinghangee.icu/datawhale/whale-town/issues)
- **即时沟通**: 项目内部群组

### 贡献者社区
- **新手指导** - 核心团队提供一对一指导
- **技术分享** - 定期举办技术分享会
- **代码审查** - 专业的代码审查和反馈

## 🔮 未来规划

### 团队扩展
- 招募更多前端开发者
- 寻找游戏设计专家
- 欢迎UI/UX设计师加入

### 技术发展
- 探索新的游戏技术
- 优化性能和用户体验
- 扩展平台支持

### 社区建设
- 建立贡献者激励机制
- 完善新手指导体系
- 加强社区交流和合作

---

## 📝 贡献者协议

通过向本项目贡献代码，您同意：

1. **开源协议** - 您的贡献将遵循项目的MIT开源协议
2. **代码质量** - 遵循项目的代码规范和质量标准
3. **知识产权** - 确保贡献的代码不侵犯第三方知识产权
4. **持续维护** - 对您贡献的代码承担一定的维护责任

---

<div align="center">

**🙏 感谢每一位贡献者的付出！**

**让我们一起打造更好的 Whale Town！**

[🚀 开始贡献](../README.md#🤝-贡献指南) | [📖 开发指南](./module_development.md) | [💬 加入讨论](https://gitea.xinghangee.icu/datawhale/whale-town/discussions)

</div>