bujinyuan
|
a508a4cfbc
|
feat(phase2a): 前台联系人页面 + 管理端在线监控/好友管理 + API 文档
前台联系人模块（ui-ux-pro-max 规范）：
- contact/index.vue: 好友列表（搜索/在线状态/骨架屏）
- contact/request.vue: 好友申请列表（接受/拒绝/防重复提交）
- contact/detail.vue: 好友详情（备注/分组/拉黑/删除）
- contact/search.vue: 搜索添加好友 + 好友推荐
- contact/groups.vue: 好友分组管理（CRUD）
- contact/blacklist.vue: 黑名单管理
管理端前端：
- views/monitor/online.vue: 在线监控（统计卡片/用户表格/30s 自动刷新）
- views/contact/list.vue: 好友关系管理（分页表格/强制删除）
- api/monitor.js + api/contact.js: 管理端 API 封装
- 路由 + 侧边栏导航更新
API 文档（4 份）：
- docs/api/frontend/contact.md: 17 个接口完整文档
- docs/api/frontend/websocket.md: 前端 WS 事件协议
- docs/api/admin/online.md: 在线监控 API
- docs/api/admin/contact.md: 好友管理 API
进度文档更新至 Phase 2a 全部完成
Made-with: Cursor
|
2026-03-02 17:32:52 +08:00 |
|
bujinyuan
|
c3e8600b24
|
fix: 前后台 Token Redis 存储隔离，修复同账号互相覆盖问题
核心变更：
- Redis key 加入 clientType 前缀：echo:auth:token:{frontend|admin}:{user_id}
- JWT Claims 新增 client_type 字段区分前台/管理端
- 新增 constants/client_type.go 定义 ClientTypeFrontend / ClientTypeAdmin
- 全链路传递 clientType：Controller → Service → TokenStore → Redis
- 中间件从 JWT Claims 提取 clientType 做 Redis 校验
- 登出只删除当前端 Token，不影响另一端
前端变更：
- 管理端 login API 改为调用 POST /api/v1/admin/auth/login（之前错误调用了前台接口）
文档更新：
- 系统设计文档、实施计划、API文档、开发规范、项目进度全部同步
Made-with: Cursor
|
2026-03-02 14:28:45 +08:00 |
|
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 |
|