datawhale/whale-town-end
3
4
Fork 2
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
182 Commits 4 Branches 0 Tags
f840d3e708cbc51a8f340a2333888da30ad79d69
Commit Graph

14 Commits

Author SHA1 Message Date
moyin
dd5cc48b49 docs：更新代码检查规范和API文档 
- 更新AI代码检查规范简洁版
- 完善开发者代码检查规范
- 扩展OpenAPI文档，添加新的接口定义
 2026-01-08 23:03:40 +08:00
moyin
946d328be6 docs：更新登录验证码邮件模板修复相关文档 
- 在API文档重要提醒中添加邮件模板修复说明
- 更新OpenAPI文档版本号至1.1.3
- 增强发送登录验证码接口的描述，明确说明使用专门的登录验证码模板
 2025-12-25 20:40:45 +08:00
moyin
d683f0d5da feat: 邮箱冲突检测优化 v1.1.1 
- 新增邮箱冲突检测：发送验证码前检查邮箱是否已被注册
- 优化用户体验：避免向已注册邮箱发送无用验证码
- 改进错误处理：返回409 Conflict状态码和明确错误信息
- 更新API文档：重新整理文档结构，突出前端开发要点
- 完善测试用例：添加邮箱冲突检测相关测试
- 版本升级：1.1.0  1.1.1

核心修改：
- src/core/login_core/login_core.service.ts: 在sendEmailVerification方法中添加邮箱存在性检查
- src/business/auth/controllers/login.controller.ts: 正确处理409冲突状态码
- docs/api/api-documentation.md: 重新整理为精简实用的前端开发文档
- docs/api/openapi.yaml: 更新版本和接口描述
- test-register-fix.ps1: 添加邮箱冲突检测测试用例
 2025-12-25 18:31:36 +08:00
moyin
aae77866ac docs: 更新API文档，反映HTTP状态码修复 
文档更新内容：
- 更新注册接口响应示例，区分400和409状态码
- 添加资源冲突响应示例（用户名、邮箱、手机号已存在）
- 完善OpenAPI文档，添加详细的响应示例
- 更新错误码表格，明确不同错误的状态码
- 添加HTTP状态码测试场景

 修复说明：
- 409 Conflict：用户名/邮箱/手机号已存在
- 400 Bad Request：验证码错误/参数格式错误
- 符合RESTful API规范

 测试验证：
- 邮箱冲突：HTTP 409
- 用户名冲突：HTTP 409
- 验证码错误：HTTP 400

 前端开发者现在可以：
- 根据HTTP状态码进行精确的错误处理
- 移除临时解决方案，使用标准状态码判断
- 提供更好的用户体验和错误提示
 2025-12-25 16:32:51 +08:00
moyin
9f606abbb2 chore: 升级版本到1.1.0 
版本升级：1.0.0  1.1.0

 新功能：
- 验证码登录功能完整实现
- 支持邮箱和手机号验证码登录
- 新增2个API接口（总计23个）

 文档更新：
- Swagger API文档版本更新
- OpenAPI规范文档更新
- 手动API文档版本更新
- 添加v1.1.0版本更新日志

 技术改进：
- 完善验证码相关错误处理
- 优化API响应格式一致性
- 增强测试覆盖率

 更新内容：
- package.json: 1.0.0  1.1.0
- Swagger配置: 1.0.0  1.1.0
- OpenAPI文档: 1.0.0  1.1.0
- 应用状态接口: 1.0.0  1.1.0
- API文档: 添加v1.1.0更新日志
 2025-12-25 16:15:52 +08:00
moyin
7385c63ffd feat(docs): 更新OpenAPI文档，添加验证码登录和完整接口定义 
- 添加验证码登录接口：/auth/verification-code-login
- 添加发送登录验证码接口：/auth/send-login-verification-code
- 添加邮箱验证相关接口：send/verify/resend-email-verification
- 添加调试接口：debug-verification-code, debug-clear-throttle
- 添加应用状态接口：GET /
- 完善所有Schema定义和响应格式
- 添加测试模式和限流错误响应
- 确保OpenAPI文档与实际API完全匹配
 2025-12-25 16:11:07 +08:00
moyin
d59e9531e2 fix(docs): 修正API文档中的错误码和验证码说明 
- 修正验证码登录错误码：VERIFICATION_CODE_INVALID -> VERIFICATION_CODE_LOGIN_FAILED
- 修正发送登录验证码错误码：USER_NOT_FOUND -> SEND_LOGIN_CODE_FAILED
- 添加验证码登录相关错误码到错误码表格
- 完善验证码使用说明和注意事项
- 确保文档与实际API响应完全一致
 2025-12-25 16:04:34 +08:00
moyin
68debdcb40 docs: 完善API文档，添加验证码登录功能说明 
- 新增验证码登录接口文档 (POST /auth/verification-code-login)
- 新增发送登录验证码接口文档 (POST /auth/send-login-verification-code)
- 更新接口列表和数量统计 (21个 -> 23个接口)
- 添加验证码登录测试场景和cURL示例
- 完善错误码说明和响应格式
- 确保文档与当前实现完全一致
 2025-12-25 15:44:37 +08:00
moyin
404ef5d3e0 fix：修复注册逻辑和HTTP状态码问题 
核心修复：
- 调整注册流程检查顺序，先验证用户存在性再验证验证码
- 修复HTTP状态码问题，业务失败时返回正确的错误状态码
- 优化错误处理逻辑，提供更准确的错误信息

主要变更：
- 登录核心服务：重构注册方法，优化检查顺序避免验证码无效消费
- 用户服务：分离用户创建和重复检查逻辑，提高代码复用性
- 登录控制器：修复HTTP状态码处理，根据业务结果返回正确状态码
- API文档：更新注册接口说明和错误响应示例
- 测试脚本：优化测试逻辑和注释说明

修复效果：
- 用户已存在时立即返回正确错误信息，不消费验证码
- API响应状态码准确反映业务执行结果
- 错误信息更加用户友好和准确
- 验证码使用更加合理和高效

测试验证：
- 所有核心功能测试通过
- 注册逻辑修复验证成功
- HTTP状态码修复验证成功
- 限流功能正常工作
 2025-12-24 20:39:23 +08:00
moyin
cb25703892 fix：修复API状态码和限流配置问题 
- 修复登录控制器HTTP状态码问题，现在根据业务结果返回正确状态码
- 调整注册接口限流配置，从3次/5分钟放宽至10次/5分钟（开发环境）
- 新增清除限流记录的调试接口，便于开发测试
- 更新API文档，反映状态码修复和限流调整
- 添加测试脚本验证修复效果

主要修复：
- 业务失败时返回400/401而非200/201状态码
- 注册、登录、GitHub OAuth等接口现在正确处理错误状态码
- 限流配置更适合开发环境测试需求
 2025-12-24 19:41:21 +08:00
moyin
85d488a508 docs: 重构文档结构和组织 
- 重新组织docs目录结构，按功能模块分类
- 新增deployment和development目录
- 更新API文档结构
- 添加客户端README文档
- 移除过时的文档文件
 2025-12-24 18:04:14 +08:00
moyin
032c97a1fc docs: 全面更新API接口文档 
- 重构文档结构，按功能模块分类
- 新增应用状态接口 (GET /)
- 完善用户认证接口，新增4个邮箱验证相关接口
- 新增管理员后台接口，包含用户管理和日志管理
- 更新错误代码说明和数据验证规则
- 完善使用示例和注意事项
- 更新版本日志至v1.0.0

涵盖后端所有API接口，提供完整的开发参考文档
 2025-12-23 19:51:34 +08:00
jianuo
dd4fb6edd3 feat：简单添加管理员后台功能 2025-12-19 19:17:47 +08:00
moyin
1e47c4db60 docs：创建完整的API接口文档 
- 创建详细的API接口说明文档
- 提供OpenAPI 3.0规范文件
- 创建Postman测试集合
- 添加API文档使用指南
 2025-12-17 15:16:27 +08:00