# 贡献者名单

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

## 核心贡献者

### 🏆 主要维护者

**moyin** -  主要维护者
- Gitea: [@moyin](https://gitea.xinghangee.icu/moyin)
- Email: xinghang_a@proton.me
- 提交数: **112 commits**
- 主要贡献：
  - 🚀 项目架构设计与初始化
  - 🔐 完整用户认证系统实现
  - 📧 邮箱验证系统设计与开发
  - 🗄️ Redis缓存服务（文件存储+真实Redis双模式）
  - 📝 完整的API文档系统（Swagger UI + OpenAPI）
  - 🧪 测试框架搭建与507个测试用例编写
  - 📊 高性能日志系统集成（Pino）
  - 🔧 项目配置优化与部署方案
  - 🐛 验证码TTL重置关键问题修复
  - 📚 完整的项目文档体系建设
  - 🏗️ **Zulip模块架构重构** - 业务功能模块化架构设计与实现
  - 📖 **架构文档重写** - 详细的架构设计文档和开发者指南
  - 🔄 **验证码冷却时间优化** - 自动清除机制设计与实现
  - 📋 **文档清理优化** - 项目文档结构化整理和维护体系建立

### 🌟 核心开发者

**angjustinl** - 核心开发者
- Gitea: [@ANGJustinl](https://gitea.xinghangee.icu/ANGJustinl)
- GitHub: [@ANGJustinl](https://github.com/ANGJustinl)
- Email: 96008766+ANGJustinl@users.noreply.github.com
- 提交数: **7 commits**
- 主要贡献：
  - 🔄 邮箱验证流程重构与优化
  - 💾 基于内存的用户服务实现
  - 🛠️ API响应处理改进
  - 🧪 测试用例完善与错误修复
  - 📚 系统架构优化
  - 💬 **Zulip集成系统** - 完整的Zulip实时通信系统开发
  - 🔧 **E2E测试修复** - Zulip集成的端到端测试优化
  - 🎯 **验证码登录测试** - 验证码登录功能测试用例编写

**jianuo** - 核心开发者
- Gitea: [@jianuo](https://gitea.xinghangee.icu/jianuo)
- Email: 32106500027@e.gzhu.edu.cn
- 提交数: **11 commits**
- 主要贡献：
  - 🎛️ **管理员后台系统** - 完整的前后端管理界面开发
  - 📊 **日志管理功能** - 运行时日志查看与下载系统
  - 🔐 **管理员认证系统** - 独立Token认证与权限控制
  - 🧪 **单元测试完善** - 管理员功能测试用例编写
  - ⚙️ **TypeScript配置优化** - Node16模块解析配置
  - 🐳 **Docker部署优化** - 容器化部署问题修复
  - 📖 **技术栈文档更新** - 项目技术栈说明完善
  - 🔧 **项目配置优化** - 构建和开发环境配置改进

## 贡献统计

| 贡献者 | 提交数 | 主要领域 | 贡献占比 |
|--------|--------|----------|----------|
| moyin | 112 | 架构设计、核心功能、文档、测试、Zulip重构 | 86% |
| jianuo | 11 | 管理员后台、日志系统、部署优化、配置管理 | 8% |
| angjustinl | 7 | Zulip集成、功能优化、测试、重构 | 5% |

## 🌟 最新重要贡献

### 🏗️ Zulip模块架构重构 (2025年12月31日)
**主要贡献者**: moyin, angjustinl

这是项目历史上最重要的架构重构之一：

- **架构重构**: 实现业务功能模块化架构，将Zulip模块按照业务层和核心层进行清晰分离
- **代码迁移**: 36个文件的重构和迁移，涉及2773行代码的新增和125行的删除
- **依赖注入**: 通过接口抽象实现业务层与核心层的完全解耦
- **测试完善**: 所有507个测试用例通过，确保重构的安全性

### 📚 项目文档体系优化 (2025年12月31日)
**主要贡献者**: moyin

- **架构文档重写**: `docs/ARCHITECTURE.md` 从简单架构图扩展为800+行的完整架构设计文档
- **README优化**: 采用总分结构设计，详细的文件结构总览
- **文档清理**: 新增 `docs/DOCUMENT_CLEANUP.md` 记录文档维护过程
- **开发者体验**: 建立完整的文档导航体系，提升开发者上手体验

### 💬 Zulip集成系统 (2025年12月25日)
**主要贡献者**: angjustinl

- **完整集成**: 实现与Zulip的完整集成，支持实时通信功能
- **WebSocket支持**: 建立稳定的WebSocket连接和消息处理机制
- **测试覆盖**: 完善的E2E测试确保集成功能的稳定性

## 项目里程碑

### 2025年12月
- **12月17日**: 项目初始化，完成基础架构搭建
- **12月17日**: 实现完整的用户认证系统
- **12月17日**: 完成API文档系统集成
- **12月17日**: 实现邮箱验证系统
- **12月17日**: 修复验证码TTL重置关键问题
- **12月18日**: angjustinl重构邮箱验证流程，引入内存用户服务
- **12月18日**: jianuo修复Docker部署问题
- **12月18日**: 完成测试用例修复和优化
- **12月19日**: jianuo开发管理员后台系统
- **12月20日**: jianuo完善日志管理功能
- **12月21日**: jianuo添加管理员后台单元测试
- **12月22日**: 管理员后台功能合并到主分支
- **12月25日**: angjustinl开发完整的Zulip集成系统
- **12月25日**: 实现验证码冷却时间自动清除机制
- **12月25日**: 完成邮箱冲突检测优化v1.1.1
- **12月25日**: 升级项目版本到v1.1.0
- **12月31日**: **重大架构重构** - 完成Zulip模块业务功能模块化架构重构
- **12月31日**: **文档体系优化** - 项目文档结构化整理和架构文档重写
- **12月31日**: **测试覆盖完善** - 所有507个测试用例通过，测试覆盖率达到新高

## 如何成为贡献者

我们欢迎所有形式的贡献！无论是：

- 🐛 **Bug修复** - 发现并修复问题
- ✨ **新功能** - 添加有价值的功能
- 📚 **文档改进** - 完善项目文档
- 🧪 **测试用例** - 提高代码覆盖率
- 🎨 **代码优化** - 改进代码质量
- 💡 **建议反馈** - 提出改进建议

### 贡献流程

1. Fork 项目到你的Gitea账户
2. 创建功能分支：`git checkout -b feature/your-feature`
3. 提交你的更改：`git commit -m "feat：添加新功能"`
4. 推送到分支：`git push origin feature/your-feature`
5. 创建Pull Request

### 贡献规范

请在贡献前阅读：
- [AI辅助开发规范指南](./docs/AI辅助开发规范指南.md)
- [后端开发规范](./docs/backend_development_guide.md)
- [Git提交规范](./docs/git_commit_guide.md)

---

**再次感谢所有贡献者的辛勤付出！** 🙏

*如果你的名字没有出现在列表中，请联系我们或提交PR更新此文件。*