# 贡献者名单

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

## 核心贡献者

### � 项目维护者

**moyin** - 项目维护者
- Gitea: [@moyin](https://gitea.xinghangee.icu/moyin)
- Email: xinghang_a@proton.me
- 提交数: **166 commits** (不含合并提交)
- 主要贡献：
  - 🚀 **项目架构设计** - 四层架构（Gateway-Business-Core-Data）设计与实现
  - � **用户认证系统** - 完整的登录、注册、JWT认证、验证码登录
  - 📧 **邮箱验证系统** - 邮件服务、验证码服务、冷却时间机制
  - �️ **双模式架构** - Redis缓存（文件/真实）、用户服务（内存/数据库）
  - � **API文档系统** - Swagger UI、OpenAPI规范、WebSocket文档
  - 🧪 **测试框架** - Jest配置、507+测试用例、集成测试、E2E测试
  - � **日志系统** - Pino高性能日志、结构化日志、日志管理
  - 🏗️ **架构重构** - Zulip模块重构、认证模块分层、安全模块迁移
  - 📚 **文档体系** - 架构文档、开发规范、AI代码检查指南、部署文档
  - 🎮 **游戏功能** - 位置广播系统、通知系统、地图房间管理
  - 🔧 **项目配置** - TypeScript配置、构建配置、环境配置、Docker部署
  - 🐛 **问题修复** - 验证码TTL重置、依赖注入、HTTP状态码、数据库管理

### 🌟 核心开发者

**jianuo** - 核心开发者
- Gitea: [@jianuo](https://gitea.xinghangee.icu/jianuo)
- Email: 32106500027@e.gzhu.edu.cn
- 提交数: **10 commits** (不含合并提交)
- 主要贡献：
  - 🎛️ **管理员后台系统** - React前端界面、Ant Design组件、完整CRUD功能
  - 📊 **日志管理功能** - 运行时日志查看、日志下载、日志分析
  - � **管理员认证** - 独立Token认证、权限控制、会话管理
  - 🧪 **单元测试** - 管理员功能测试用例、测试覆盖率提升
  - ⚙️ **TypeScript配置** - Node16模块解析、编译配置优化
  - 🐳 **Docker部署** - 容器化部署问题修复、部署脚本优化
  - 📖 **文档维护** - 技术栈文档、部署文档、错误修复文档

**angjustinl** - 核心开发者
- Gitea: [@ANGJustinl](https://gitea.xinghangee.icu/ANGJustinl)
- GitHub: [@ANGJustinl](https://github.com/ANGJustinl)
- Email: 96008766+ANGJustinl@users.noreply.github.com
- 提交数: **9 commits** (不含合并提交)
- 主要贡献：
  - � **Zulip集成系统** - 完整的Zulip实时通信系统、WebSocket连接、消息同步
  - 🔑 **JWT认证重构** - JWT验证机制、API密钥管理、Token刷新
  - � **邮箱验证重构** - 验证流程优化、内存用户服务、API响应改进
  - � **验证码登录** - 验证码登录功能实现、测试用例编写
  - 🧪 **测试优化** - E2E测试修复、测试断言更新、测试覆盖完善
  - 🏗️ **Zulip账户管理** - Zulip账户创建、绑定、同步机制

## 贡献统计

| 贡献者 | 提交数 | 主要领域 | 贡献占比 |
|--------|--------|----------|----------|
| moyin | 166 | 架构设计、核心功能、文档、测试、重构 | 89.7% |
| jianuo | 10 | 管理员后台、日志系统、部署优化 | 5.4% |
| angjustinl | 9 | Zulip集成、JWT认证、验证码登录 | 4.9% |

## 🌟 最新重要贡献

### 🏗️ 四层架构重构与规范化 (2026年1月)
**主要贡献者**: moyin

项目完成了重大的架构升级和代码规范化工作：

- **认证模块重构** (1月14日): 将Gateway层组件从Business层分离，实现清晰的四层架构
- **依赖注入优化** (1月14日): 修复AuthGatewayModule依赖注入问题，完善NestJS模块系统
- **AI代码检查体系** (1月14日): 建立完整的AI辅助代码检查流程和规范文档
- **架构文档完善** (1月14日): 新增架构重构文档、Gateway层规范、NestJS命名规范
- **代码规范优化** (1月12日): 完善多个核心模块的代码规范和测试覆盖

### 📚 代码质量与测试提升 (2026年1月)
**主要贡献者**: moyin

- **测试覆盖完善** (1月12日): 完善users、zulip、verification等模块测试覆盖
- **文档体系建设** (1月12日): 添加开发者代码检查规范、AI代码检查执行指南
- **性能优化** (1月12日): 集成高性能缓存系统和结构化日志
- **模块功能扩展** (1月12日): 添加Zulip动态配置控制器和账户业务服务

### 🎮 游戏功能扩展 (2026年1月)
**主要贡献者**: moyin

- **通知系统** (1月10日): 实现完整的通知系统核心功能和数据库支持
- **WebSocket优化** (1月9日): 统一WebSocket网关配置、增强测试页面用户体验
- **原生WebSocket** (1月9日): 移除Socket.IO依赖，实现原生WebSocket支持
- **位置广播系统** (1月8日): 实现位置广播系统和端到端测试
- **管理员系统** (1月8日): 完善管理员系统核心功能和用户管理模块

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

- **架构重构** (12月31日): 实现业务功能模块化架构，清晰分离业务层和核心层
- **Zulip集成** (12月25日): angjustinl开发完整的Zulip实时通信系统
- **JWT认证** (1月6日): angjustinl引入JWT验证并重构API密钥管理
- **账户管理** (1月5日): angjustinl添加Zulip账户管理和认证系统集成

## 项目里程碑

### 2026年1月
- **1月14日**: 🏗️ 认证模块四层架构重构，Gateway层与Business层清晰分离
- **1月14日**: 🔧 修复AuthGatewayModule依赖注入问题，完善模块系统
- **1月14日**: 📚 建立AI代码检查体系，添加完整的规范文档
- **1月14日**: 📖 新增架构重构文档和NestJS框架规范说明
- **1月12日**: ✨ 完善多个核心模块的代码规范和测试覆盖
- **1月12日**: 🧪 添加Zulip业务模块完整测试覆盖
- **1月12日**: 📝 添加开发者代码检查规范和AI检查执行指南
- **1月12日**: ⚡ 集成高性能缓存系统和结构化日志
- **1月10日**: 🔔 实现通知系统核心功能和数据库支持
- **1月10日**: 🐛 修复数据库管理服务的关键问题
- **1月9日**: 🌐 统一WebSocket网关配置，增强测试页面
- **1月9日**: 🔄 移除Socket.IO依赖，实现原生WebSocket支持
- **1月8日**: 📍 实现位置广播系统和端到端测试
- **1月8日**: 👑 完善管理员系统核心功能
- **1月8日**: 🏗️ 项目架构重构和命名规范化
- **1月7日**: 📦 升级到v2.0.0版本
- **1月6日**: 🔑 angjustinl引入JWT验证并重构API密钥管理
- **1月5日**: 👤 angjustinl添加Zulip账户管理和认证系统集成
- **1月4日**: 🛡️ 重构安全模块架构，迁移至core层

### 2025年12月
- **12月31日**: 🏗️ Zulip模块业务功能模块化架构重构
- **12月31日**: 📚 项目文档结构化整理和架构文档重写
- **12月25日**: 💬 angjustinl开发完整的Zulip集成系统
- **12月25日**: 🔄 实现验证码冷却时间自动清除机制
- **12月25日**: 📧 完成邮箱冲突检测优化v1.1.1
- **12月25日**: 🎯 angjustinl实现验证码登录功能
- **12月25日**: 📈 升级项目版本到v1.1.0
- **12月24日**: 🐛 修复注册逻辑和HTTP状态码问题
- **12月24日**: 🔧 修复API状态码和限流配置问题
- **12月24日**: 🏗️ 重构项目结构和业务模块架构
- **12月23日**: 📖 全面更新API接口文档
- **12月22日**: 🎛️ jianuo的管理员后台功能合并到主分支
- **12月19日**: 👑 jianuo开发管理员后台系统
- **12月19日**: 📊 jianuo完善日志管理功能
- **12月19日**: 🧪 jianuo添加管理员后台单元测试
- **12月19日**: ⚙️ jianuo优化TypeScript配置
- **12月18日**: 🔄 angjustinl重构邮箱验证流程，引入内存用户服务
- **12月18日**: 🐳 jianuo修复Docker部署问题
- **12月18日**: 🧪 完成测试用例修复和优化
- **12月17日**: 🐛 修复验证码TTL重置关键问题
- **12月17日**: 📧 实现完整的邮箱验证系统
- **12月17日**: 🗄️ 实现Redis缓存服务（双模式）
- **12月17日**: 📝 完成API文档系统集成
- **12月17日**: 🔐 实现完整的用户认证系统
- **12月17日**: 🚀 项目初始化，完成基础架构搭建

## 如何成为贡献者

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

- 🐛 **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

### 贡献规范

请在贡献前阅读：
- [开发者代码检查规范](./开发者代码检查规范.md)
- [后端开发规范](./development/backend_development_guide.md)
- [Git提交规范](./development/git_commit_guide.md)
- [AI代码检查指南](./ai-reading/README.md)

---

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

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