bujinyuan
|
b607434c57
|
fix(auth): 有状态 JWT + 统一响应格式，严格遵循设计方案
1. 有状态 JWT（Token 存 Redis）：
- 新增 token_store.go: Token 的 Redis 存取管理
- echo:auth:token:{user_id} → Access Token (TTL = access_expire_min)
- echo:auth:refresh:{user_id} → Refresh Token (TTL = refresh_expire_day)
- 登录/注册时自动将 Token 存入 Redis（覆盖旧 Token，实现单设备登录）
- JWT 中间件增加 Redis 有效性校验（TokenValidator 接口解耦）
- 登出时从 Redis 删除 Token，使其立即失效
- 刷新 Token 时校验 Redis 中的 Refresh Token
2. 统一成功响应为 "success" + 200：
- 注册接口改用 ResponseOK（原 ResponseCreated/201）
- 所有成功响应统一为 {"code": 0, "message": "success"}
3. API 文档同步更新：
- frontend/auth.md: 登出说明改为 Redis 方案、注册响应统一
- README.md: 移除 "created" 示例
已验证：登出后 Token 立即失效 ✓ 重新登录后新 Token 有效 ✓
Made-with: Cursor
|
2026-02-28 16:57:46 +08:00 |
|
bujinyuan
|
5a65716d10
|
docs(api): 同步 API 文档与实际实现一致
README.md:
- 开发环境端口 8080 → 8085
- 统一响应格式添加 trace_id 字段
- 成功消息 "ok" → "success"，创建 "created"
frontend/auth.md（全面更新）:
- 注册响应：201 状态码 + message="created" + expires_in=7200
- 所有响应示例：添加 trace_id 和 time 字段
- user 对象：添加 gender 字段
- 退出登录：更新为无状态 JWT 说明（非 Redis）
- 刷新 Token：添加 user 字段到响应
- profile：添加 phone + created_at 字段
- 错误码：统一使用 HTTP 状态码说明表
代码同步:
- dto.UserInfo: 添加 Phone + CreatedAt 字段
- auth_service.buildUserInfo: 填充新字段
Made-with: Cursor
|
2026-02-28 16:48:17 +08:00 |
|
bujinyuan
|
7dcd89c7fc
|
docs: API 文档按端+模块二级目录重组
- 前台用户端 API 迁移到 frontend/ 目录（auth/contact/im/meeting/notify）
- 后台管理端 admin.md 拆分为 admin/ 目录下 4 个文档（auth/user/meeting/system）
- WebSocket 协议保留在根目录（跨端通用）
- 更新 README 导航为两级结构，补充目录结构说明
- 更新所有文档间的交叉引用路径
Made-with: Cursor
|
2026-02-28 09:52:52 +08:00 |
|
bujinyuan
|
44fa5a3830
|
docs: 统一时间格式为亚洲友好的日期时间字符串
所有文档中的时间字段统一为 yyyy-MM-dd HH:mm:ss 格式（Asia/Shanghai）：
- 移除 ISO 8601 格式（2026-02-27T10:00:00Z）
- 移除 Unix 时间戳（1740700000）
- 响应字段从 timestamp(int64) 改为 time(string)
- API README 新增「时间格式规范」章节
- 涉及 10 个文档文件
Made-with: Cursor
|
2026-02-28 09:47:42 +08:00 |
|
bujinyuan
|
4458f40025
|
docs: 完善项目文档体系
- 数据库 SQL 所有字段添加 COMMENT 注释，枚举字段详细标注各值含义
- 新增 docs/architecture/ 系统架构文档（分层架构、数据流、演进路径）
- API 文档按模块拆分为 8 个独立文档（auth/contact/im/meeting/notify/admin/websocket）
- 补充 README.md 项目说明（技术栈、架构、快速开始、功能规划、文档导航）
Made-with: Cursor
|
2026-02-27 16:27:07 +08:00 |
|