forked from datawhale/whale-town-end
8f9a6e7f9d
### 详细变更描述 * **修复 JWT 签名冲突**：重构 `LoginService.generateTokenPair()`，移除载荷（Payload）中的 `iss` (issuer) 与 `aud` (audience) 字段，解决签名校验失败的问题。 * **统一验证逻辑**：更新 `ZulipService` 以调用 `LoginService.verifyToken()`，消除重复的 JWT 校验代码，确保逻辑单一职责化（Single Responsibility）。 * **修复硬编码 API 密钥问题**：消息发送功能不再依赖静态配置，改为从 Redis 动态读取用户真实的 API 密钥。 * **解耦依赖注入**：在 `ZulipModule` 中注入 `AuthModule` 依赖，以支持标准的 Token 验证流程。 * **完善技术文档**：补充了关于 JWT 验证流程及 API 密钥管理逻辑的详细文档。 * **新增测试工具**：添加 `test-get-messages.js` 脚本，用于验证通过 WebSocket 接收消息的功能。 * **更新自动化脚本**：同步更新了 API 密钥验证及用户注册校验的快速测试脚本。 * **端到端功能验证**：确保消息发送逻辑能够正确映射并调用用户真实的 Zulip API 密钥。
📚 Pixel Game Server 文档中心
欢迎来到 Whale Town 项目文档中心！这里包含了项目的完整文档，帮助你快速了解和使用项目。
📖 文档导航
🚀 快速开始
🔌 API文档
💻 开发指南
- 后端开发指南 - 后端开发规范和最佳实践
- NestJS指南 - NestJS框架使用指南
- 命名规范 - 代码命名规范
- Git提交规范 - Git提交消息规范
- AI辅助开发规范 - AI辅助开发最佳实践
- 测试指南 - 测试策略和规范
🚀 部署运维
- 部署指南 - 生产环境部署说明
📋 项目管理
🏗️ 文档结构说明
docs/
├── README.md # 📚 文档中心首页
├── ARCHITECTURE.md # 🏗️ 架构文档
├── API_STATUS_CODES.md # 📋 API状态码
├── CONTRIBUTORS.md # 🤝 贡献指南
├── DOCUMENT_CLEANUP.md # 📝 文档清理说明
│
├── api/ # 🔌 API文档
│ ├── api-documentation.md # API接口文档
│ ├── openapi.yaml # OpenAPI规范
│ ├── postman-collection.json # Postman测试集合
│ └── README.md # API文档说明
│
├── development/ # 💻 开发指南
│ ├── backend_development_guide.md
│ ├── nestjs_guide.md
│ ├── naming_convention.md
│ ├── git_commit_guide.md
│ ├── AI辅助开发规范指南.md
│ └── TESTING.md
│
└── deployment/ # 🚀 部署文档
└── DEPLOYMENT.md
🎯 文档特色
✨ 业务功能模块化
文档结构与代码架构保持一致，按业务功能组织：
- 用户认证模块 - 登录、注册、密码管理
- 用户管理模块 - 状态管理、批量操作
- 管理员模块 - 后台管理、权限控制
- 安全模块 - 频率限制、维护模式
📊 完整API覆盖
- 17个API接口 - 涵盖所有业务功能
- 交互式文档 - Swagger UI实时测试
- 标准化规范 - OpenAPI 3.0标准
- 测试集合 - Postman一键导入
🔧 开发者友好
- 规范指导 - 命名、提交、开发规范
- AI辅助 - 提升开发效率的AI使用指南
- 测试覆盖 - 140个测试用例全覆盖
- 部署就绪 - 生产环境部署指南
📝 文档维护原则
✅ 保留的文档类型
- 长期有用：对整个项目生命周期都有价值的文档
- 参考价值：开发、部署、维护时需要查阅的文档
- 规范指南：团队协作和代码质量保证的规范
❌ 不保留的文档类型
- 阶段性文档：只在特定开发阶段有用的文档
- 临时记录：会议记录、临时决策等
- 过时信息：已经不适用的旧版本文档
🔄 文档更新策略
- 及时更新：功能变更时同步更新相关文档
- 版本控制：重要变更记录版本历史
- 定期审查：定期检查文档的准确性和有效性
🤝 如何贡献文档
- 发现问题：发现文档错误或缺失时，请提交Issue
- 改进文档：按照项目规范提交Pull Request
- 新增文档：新功能开发时同步编写相关文档
- 审查文档：参与文档审查，确保质量和准确性
📧 联系我们：如有文档相关问题，请通过项目Issue或邮件联系维护团队。