wanglei/EchoChat
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
224 Commits 1 Branch 0 Tags
c118ac43f503a2413e77c18de626b44831d5c59e
Commit Graph

224 Commits

This Branch
This Branch
All Branches
Author SHA1 Message Date
bujinyuan
7b1d061955 feat:修复聊天界面消息位置展示错误问题 2026-03-03 13:46:03 +08:00
bujinyuan
35788f6d2f style(frontend): ui-ux-pro-max 规范改造 — chat 页面 + CustomTabBar 
改造内容：
- 安装 @dcloudio/uni-ui + sass，配置 easycom 自动引入 uni-icons
- 4 个 chat 页面：emoji/HTML 实体 → uni-icons 组件（跨平台兼容）
- CustomTabBar：emoji → uni-icons（chatbubble/contact/videocam/person）
  - 选中态使用 filled 变体，未选中态使用轮廓图标
- 所有可交互元素添加 :active 按压反馈 + transition (150-200ms)
- 触控目标保证 ≥ 88rpx (44px)
- input-bar/tab-bar 适配 safe-area-inset-bottom

设计规范文件：
- MASTER.md 修正为项目蓝色色板 (#2563EB) + 移动聊天应用规范
- 新增 4 个页面覆盖规范：chat-index/conversation/settings/search.md
- Pre-Delivery Checklist 全部通过
- npm run build:h5 编译验证通过

Made-with: Cursor
 2026-03-03 11:23:11 +08:00
bujinyuan
143cb8aa5f docs: Task 9 - Phase 2b 文档更新 
- CURRENT_STATUS.md: 更新 Phase 2b 完成状态（10 个 Task）
  - 新增功能描述（IM/会话/WS事件/REST API/前端页面/数据库）
  - 更新目录结构、技术决策、测试指南
  - 下一阶段规划更新为 Phase 2c
- project-context.mdc: 更新当前进度和模块列表

Made-with: Cursor
 2026-03-03 11:04:19 +08:00
bujinyuan
0ea8c0d331 feat(frontend): Task 8 - 聊天设置页 + 消息搜索页 + 联系人改造 
pages/chat/settings.vue（聊天设置页）:
- 对方信息展示（头像+昵称）
- 置顶/取消置顶切换
- 清空聊天记录（确认弹窗）
- 删除会话（确认弹窗 + 双层返回）

pages/chat/search.vue（消息搜索页）:
- 全局消息搜索（关键词匹配）
- 搜索结果列表（发送者头像+昵称+内容+时间）
- 点击跳转到对应会话

联系人模块改造:
- contact/detail.vue "发消息"按钮改为跳转聊天页

Made-with: Cursor
 2026-03-03 11:02:30 +08:00
bujinyuan
565afb3149 feat(frontend): Task 7 - 会话列表页 + 聊天对话页 
pages/chat/index.vue（会话列表页）:
- 排序展示会话列表（置顶优先 → 时间降序）
- 未读 badge + 时间格式化（今天/昨天/日期）
- 长按操作菜单（置顶/删除）
- 正在输入状态提示
- 空状态 UI

pages/chat/conversation.vue（聊天页）:
- 消息气泡（自己蓝色/对方白色）
- 游标分页加载历史消息
- 发送消息 + 三态确认（sending/sent/failed）
- 长按撤回 + 重发失败消息
- 正在输入通知（发送 + 接收）
- 自定义导航栏 + 设置入口

pages.json:
- 新增 chat/conversation、chat/settings、chat/search 路由

Made-with: Cursor
 2026-03-03 11:01:15 +08:00
bujinyuan
780dea3c31 feat(frontend): Task 6 - Chat Store + API + WS 事件 + TabBar badge 
API (api/im.js):
- getConversations / getHistoryMessages / pinConversation
- deleteConversation / clearHistory / searchMessages / getTotalUnread

Chat Store (store/chat.js):
- 会话列表管理 + 排序（置顶优先）
- 消息缓存 + 三态确认（sending/sent/failed）
- 全局未读数管理（Redis 同步）
- WS 事件监听：im.message.new/recalled/send.ack/offline.sync/typing
- 工具方法：游标分页加载、typing 超时清除

CustomTabBar:
- 消息 Tab 显示全局未读 badge（>99 显示 99+）

Made-with: Cursor
 2026-03-03 10:58:35 +08:00
bujinyuan
2c7be494f2 feat(im): Task 5 - IM REST Controller + Router + Wire 集成 
IMController (REST API):
- GET /api/v1/im/conversations: 会话列表
- GET /api/v1/im/messages: 历史消息（游标分页）
- PUT /api/v1/im/conversations/:id/pin: 置顶/取消
- DELETE /api/v1/im/conversations/🆔 删除会话
- DELETE /api/v1/im/conversations/:id/messages: 清空记录
- GET /api/v1/im/messages/search: 全局搜索
- GET /api/v1/im/unread: 全局未读数

Wire 集成:
- IMSet Provider Set + wire.Bind 接口注入
- App struct 新增 IM 字段
- wire_gen.go 手动更新
- OfflinePusher 通过 SetOfflinePusher 注入 WS Handler

Made-with: Cursor
 2026-03-03 10:51:56 +08:00
bujinyuan
1e0c061e9d feat(im): Task 4 - WS 事件处理器 + 离线消息推送 
EventHandler:
- im.message.send: 发送消息（解析→业务→ACK+推送）
- im.message.recall: 撤回消息
- im.conversation.read: 标记已读
- im.typing: 正在输入通知（转发对方）
- 所有事件通过 Hub.RegisterEvent 注册到路由表

OfflinePusher:
- PushOfflineMessages: 推送未读会话摘要 + 全局未读总数
- 通过 OfflineMessagePusher 接口注入 WS Handler
- WebSocket 连接建立后自动触发离线推送

Made-with: Cursor
 2026-03-03 10:48:36 +08:00
bujinyuan
334d3d860b feat(im): Task 3 - IM Service 核心业务 + DTO + 接口定义 
IMService 核心方法:
- SendMessage: 发送消息（好友校验→查找/创建会话→幂等去重→写入→推送）
- RecallMessage: 2分钟撤回
- GetConversationList: 会话列表（含对方用户信息）
- GetHistoryMessages: 游标分页历史消息
- MarkRead / PinConversation / DeleteConversation / ClearHistory
- SearchMessages: 全局消息搜索
- GetTotalUnread: Redis 全局未读总数

DTO:
- SendMessageRequest / RecallMessageRequest
- ConversationDTO / HistoryMessageResponse
- SearchMessageRequest / MarkReadRequest / TypingRequest

接口:
- FriendChecker: 好友校验（contact 模块注入）
- UserInfoGetter: 用户信息批量查询（contact 模块注入）

Made-with: Cursor
 2026-03-03 10:46:57 +08:00
bujinyuan
e091fbccb3 feat(im): Task 2 - IM DAO 层（会话 + 消息） 
ConversationDAO:
- FindPrivateConversation: 单聊会话去重查询
- CreateWithMembers: 事务创建会话+成员
- GetUserConversations: 会话列表（含未读/置顶）
- UpdateLastMessage / IncrementUnread / ClearUnread
- SoftDeleteMember / RestoreMember / UpdateMemberPinned
- GetUnreadConversations: 离线消息推送用

MessageDAO:
- Create / GetByID / GetByConversation（游标分页）
- UpdateStatus（撤回） / DeleteByConversation（清空）
- SearchMessages（全局搜索，JOIN 权限校验）
- FindByClientMsgID（幂等去重）

Made-with: Cursor
 2026-03-03 10:44:34 +08:00
bujinyuan
c23b9087b8 feat(ws): Task 1 - Hub 事件路由表机制 
- Hub 新增 eventHandlers map + RegisterEvent / DispatchEvent 方法
- handler.go onMessage 优先查路由表，未命中走内置 fallback
- default 分支改为返回"未知事件"错误响应 + 警告日志

Made-with: Cursor
 2026-03-03 10:43:01 +08:00
bujinyuan
6ab04fb902 feat(im): Task 0 - IM 模型定义 + 数据库表迁移 + 常量定义 
- 新增 3 个 GORM 模型：Conversation / ConversationMember / Message
- 新增 IM 常量：会话类型、消息类型、消息状态、撤回时限
- main.go 添加 IM 表 AutoMigrate
- init.sql 追加 IM 模块 DDL（含索引和全文搜索 GIN 索引）

Made-with: Cursor
 2026-03-03 10:41:42 +08:00
bujinyuan
1f390fce56 docs: 补充 Phase 2b 设计文档和实施计划 
- 设计文档新增 Mermaid 消息收发时序图
- IMService 依赖注入补充 *redis.Client（未读数 HASH 操作）
- 实施计划同步更新 Redis 依赖和 unreadKeyPrefix

Made-with: Cursor
 2026-03-03 10:28:46 +08:00
bujinyuan
de9f9c1ee1 docs: Phase 2b 详细实施计划（10 个 Task） 
覆盖后端 IM 模块（model/dao/service/controller/handler）、
WS 事件路由表扩展、前端 4 页面 + Store + API、联系人联动改造。

Made-with: Cursor
 2026-03-03 10:24:01 +08:00
bujinyuan
2eeb8484fa docs: Phase 2b 即时通讯消息系统设计文档 
单聊核心设计：全双工 WS 消息收发、会话管理、离线消息推送、
消息撤回、正在输入、全局搜索、4 个前端页面。

Made-with: Cursor
 2026-03-03 10:19:55 +08:00
bujinyuan
c8ae70ef97 fix(phase2a): handleError 增强 + 代码格式化 + 测试报告归档 
- auth/contact Controller handleError 增加 fallbackMsg 可变参数，未知错误可返回更有语义的降级提示
- import 排序、变量对齐等 gofmt 格式规范化
- 新增管理端测试报告和路由验证报告

Made-with: Cursor
 2026-03-03 09:51:43 +08:00
bujinyuan
2c59500e27 fix(phase2a): 代码审查修复 - 8项关键/重要问题 
安全修复:
- WebSocket Token 增加 Redis 有效性校验（已登出用户无法建立 WS）

功能修复:
- GetRecommendFriends 改为批量查询，正确返回用户名/昵称/头像
- 上下线通知：OnlineService 通过接口注入获取好友列表推送状态变更
- 管理端在线用户 API 补充用户名信息

代码质量:
- 所有 json.Marshal/Redis 错误增加检查与日志
- ContactController 13 个 endpoint 统一走 handleError 业务错误映射
- 管理端 Controller 补全包注释、函数注释和结构化日志
- 前端 5 个联系人页面 avatar 工具函数抽取到 utils/avatar.js

Made-with: Cursor
 2026-03-02 18:48:28 +08:00
bujinyuan
8ec0261427 docs: 同步全部项目文档至 Phase 2a 完成状态 
- 架构设计文档：更新模块职责表（ws/contact 标记已完成）、路由架构、分层图
- 总体系统设计：联系人 API 扩展至 17 个、管理端 API 补充在线监控和好友管理
- Phase 2a 设计文档：状态标记为已完成
- API README：导航表 + 目录结构 + 联系人模块错误码
- 开发规范：新增 WebSocket 事件联动规范（第 8 节）
- 项目规则：新增「文档自动同步规则」，每个 Task 完成后自动检查更新文档

Made-with: Cursor
 2026-03-02 17:53:46 +08:00
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
618c3f4409 feat(frontend): WebSocket 客户端 + Contact Store + API 
- services/websocket.js: 单例 WS 连接管理（心跳/重连/事件分发）
- store/websocket.js: Pinia Store 管理连接状态
- store/contact.js: 联系人 Store（好友/申请/分组/黑名单/在线状态）
- api/contact.js: 联系人 REST API 封装（17 个接口）
- api/user.js: 用户搜索 API

Made-with: Cursor
 2026-03-02 17:15:21 +08:00
bujinyuan
a77669ee99 feat(admin): 管理端在线监控 + 好友关系管理后端 
- admin/service/online_service.go: 在线用户列表/计数
- admin/controller/online_controller.go: GET /admin/online/users|count
- admin/service/contact_manage_service.go: 好友关系分页查询/管理员删除
- admin/controller/contact_manage_controller.go: GET|DELETE /admin/contacts
- 更新 admin router/provider/wire 集成新控制器

Made-with: Cursor
 2026-03-02 17:13:06 +08:00
bujinyuan
1c87a466a1 feat(ws): 在线状态管理（Redis SET + TTL 心跳续期） 
- app/ws/online_service.go: 上线/下线/心跳续期/批量查询在线状态
- 集成到 WebSocket handler: 连接时写入 Redis, 断线时清除
- client.go: 添加 DisconnectHandler 回调
- Redis 键: echo:user:online (SET) + echo:user:status:{uid} (TTL 60s)

Made-with: Cursor
 2026-03-02 17:10:13 +08:00
bujinyuan
632e3b9a28 feat(contact): Controller、Router 与 Wire 集成 
- controller/contact_controller.go: 全部 17 个 REST API 端点处理器
- router.go: Contact 模块路由注册（JWT 中间件保护）
- provider.go: Wire Provider Set（DAO + Service + Controller）
- 更新全局 provider、wire.go、router.go 集成 Contact 模块

Made-with: Cursor
 2026-03-02 17:07:41 +08:00
bujinyuan
978037f085 feat(contact): Contact Service 业务逻辑 
- 好友申请：发送/接受/拒绝 + 前置校验（自加/已好友/重复申请/黑名单）
- 好友管理：删除好友/更新备注
- 黑名单：拉黑（同时解除好友）/取消拉黑/黑名单列表
- 搜索：用户搜索（含好友标识）/好友推荐（基于共同好友）
- 分组：CRUD + 移动好友到分组
- 实时通知：好友申请/接受通过 Redis Pub/Sub 推送

Made-with: Cursor
 2026-03-02 17:04:30 +08:00
bujinyuan
d4ab5af34e feat(contact): Contact 模型、DAO、常量与 DTO 
- model/friendship.go: 好友关系模型（双向存储，4 种状态）
- model/friend_group.go: 好友分组模型
- constants/contact.go: 好友关系状态常量
- dto/contact_dto.go: 联系人请求/响应 DTO
- dao/friendship_dao.go: 好友关系 CRUD + 搜索 + 共同好友
- dao/friend_group_dao.go: 好友分组 CRUD + 移动好友

Made-with: Cursor
 2026-03-02 17:03:13 +08:00
bujinyuan
bfb4fb0ccb feat(ws): WebSocket 核心模块（Hub + Client + PubSub + Handler） 
- pkg/ws/message.go: 统一消息协议（Message/Response/PushMessage）
- pkg/ws/hub.go: Hub 连接管理（注册/注销/按 userID 查找/在线计数）
- pkg/ws/client.go: 客户端连接封装（readPump/writePump/心跳 30s）
- pkg/ws/pubsub.go: Redis Pub/Sub 消息路由（按用户频道发布/订阅）
- app/ws/handler.go: WebSocket 升级处理（JWT 认证 + 消息分发）
- app/ws/router.go: GET /ws 路由注册
- app/ws/provider.go: Wire Provider Set
- 更新 provider/router 集成 WebSocket 模块

Made-with: Cursor
 2026-03-02 16:46:17 +08:00
bujinyuan
d392653446 feat(db): 添加 contact 模块表结构（好友关系 + 好友分组） 
- contact_friendships: 双向存储好友关系，支持申请/接受/拒绝/拉黑状态
- contact_groups: 用户自定义好友分组
- 添加 user_id + status 组合索引优化查询

Made-with: Cursor
 2026-03-02 16:41:06 +08:00
bujinyuan
c9e52d3895 docs: Phase 2a 设计文档（WebSocket + 联系人管理） 
- 架构方案：Redis Pub/Sub 全量消息总线
- WebSocket 连接管理：gorilla/websocket + Hub + 心跳 30s
- 联系人模块：好友申请/分组/黑名单/搜索/推荐
- 在线状态：混合推拉方案
- 文档管理策略：按模块拆分，单文件 300-500 行

Made-with: Cursor
 2026-03-02 16:40:28 +08:00
bujinyuan
fa6f1e5c58 feat: 角色等级体系与权限管控实施 
- 数据库：auth_roles 表新增 level 字段（1=超管, 10=管理员, 100=普通用户）
- 后端：新增 GetAllRoles/GetUserMaxLevel/SetUserRoles/FindByCodeList DAO 方法
- 后端：SetRolesRequest 替换 AssignRoleRequest，AdminUserInfo.Roles 改为 []RoleInfo
- 后端：所有管理操作（禁用/启用/角色分配/创建用户）强制层级权限校验
- 后端：PUT /users/:id/roles（批量设置角色）+ GET /roles（角色列表）
- 前端：角色管理改为 Checkbox Group 多选，高等级角色禁用
- 前端：禁用/启用按钮受角色层级约束，列表页操作按钮权限管控
- 前端：创建用户对话框角色选项根据操作者等级动态过滤
- 文档：API 文档、设计方案、集成规范、进度文档同步更新

Made-with: Cursor
 2026-03-02 15:40:02 +08:00
bujinyuan
dd84e50429 docs: 将前后台路由严格分离规则提升为最高优先级 
在 project-context.mdc 中明确：
- 前台 API 路径：/api/v1/auth/* 等
- 管理端 API 路径：/api/v1/admin/* 下
- 禁止任何混用，新增功能必须先确认归属

Made-with: Cursor
 2026-03-02 14:35:48 +08:00
bujinyuan
13c6b44352 fix: 管理端所有认证接口统一使用 /api/v1/admin/auth/* 路由 
后端：
- 新增管理端认证路由组 /api/v1/admin/auth/（JWT + admin 角色双重检查）
- 管理端登出：POST /api/v1/admin/auth/logout
- 管理端获取个人信息：GET /api/v1/admin/auth/profile
- 管理端更新个人信息：PUT /api/v1/admin/auth/profile
- 管理端修改密码：PUT /api/v1/admin/auth/password

前端：
- admin/src/api/auth.js 所有接口全部改为 /api/v1/admin/auth/*
- 登出和获取个人信息不再使用前台的 /api/v1/auth/ 路由

Made-with: Cursor
 2026-03-02 14:33:18 +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
cfb1651480 docs: 新增前后端集成开发规范，更新项目规则与进度文档 
- 创建 docs/conventions/frontend-backend-integration.md
  完整规范：API响应格式、HTTP状态码语义、前端错误处理、后端错误处理、
  前后端错误码对照表、安全约束、检查清单
- 更新 .cursor/rules/project-context.mdc 加入前后端联动规范6条
- 更新 CURRENT_STATUS.md 记录修复内容和规范引用

Made-with: Cursor
 2026-03-02 14:12:06 +08:00
bujinyuan
e1348f57f2 fix: 统一前后端错误提示处理，修复3个问题 
1. 管理端 request.js: 所有401均优先显示后端实际message，
   非登录页才清除Token并跳转
2. 前台用户端 request.js: 区分登录/注册请求与已认证请求，
   登录失败时只显示后端message，不清Token不跳转
3. 后端 auth_service: 登录时用户不存在统一返回"账号或密码错误"
   （防止用户枚举攻击，不再返回404"用户不存在"）

Made-with: Cursor
 2026-03-02 14:05:03 +08:00
bujinyuan
8a818f8035 fix(admin): 登录失败时显示后端实际错误信息而非"登录已过期" 
401 响应拦截器区分登录页和已登录页面：
- 登录页：显示后端返回的 message（如"账号或密码错误"）
- 其他页面：显示"登录已过期"并跳转登录页

Made-with: Cursor
 2026-03-02 14:00:12 +08:00
bujinyuan
cb08e1d621 fix: 超级管理员用户名改为 super_admin，统一区分 
系统预置唯一超管账号：super_admin / admin123456 / super_admin@echochat.com

Made-with: Cursor
 2026-03-02 13:49:26 +08:00
bujinyuan
436c494f94 fix: 修正超级管理员 bcrypt 密码 hash 
init.sql 中的 bcrypt hash 是占位值，与注释中的密码 admin123456 不匹配。
替换为 admin123456 真正对应的 bcrypt hash，确保超管账号可正常登录。

Made-with: Cursor
 2026-03-02 13:46:17 +08:00
bujinyuan
c6ffc07ca6 docs: 补充开发测试指南（启动命令 + 测试账号 + 可测试功能） 
Made-with: Cursor
 2026-03-02 11:52:58 +08:00
bujinyuan
60c49112b4 docs: 补充 gitignore 配置说明到进度文档 
Made-with: Cursor
 2026-03-02 11:47:40 +08:00
bujinyuan
4ae65d5956 fix: 将 .vite/ 缓存目录加入 gitignore 
Vite 依赖预构建缓存（.vite/deps/）是自动生成的，不应纳入版本控制。

Made-with: Cursor
 2026-03-02 11:46:41 +08:00
bujinyuan
883598d5fa docs: Phase 1 完成 — 同步更新全部文档至最新进度 
- system-architecture.md: 标注 Docker 部署架构实现状态
- phase1-foundation-and-auth.md: 添加 Phase 1 完成标记
- api/README.md: 添加各模块实现状态标注（Phase 1/2/3）
- api/admin/user.md: 修正角色分配权限、补充创建用户响应示例
- project-context.mdc: 更新当前进度为 Phase 1 完成

Made-with: Cursor
 2026-03-02 11:42:45 +08:00
bujinyuan
4d03215fe4 feat: Phase 1 完成 — 基础设施 + 用户认证 + 管理端 + 端到端验证 
Phase 1 (基础设施与用户认证) 全部 11 个 Task 开发完成：

后端 (Go)：
- Auth 模块: 注册/登录/JWT(有状态)/Profile/密码修改
- Admin 模块: 用户列表/详情/禁用/启用/角色分配/创建用户
- 中间件: JWT认证 + RBAC角色权限 + 请求日志 + CORS + Panic恢复
- Dockerfile 多阶段构建 + Docker Compose 全栈部署

前台 (uni-app)：
- 登录/注册页面 + 自定义 TabBar + 个人中心
- 请求封装 + 状态管理 (Pinia)

管理端 (Vue 3 + Element Plus)：
- 登录/仪表盘/用户列表/用户详情
- Axios 封装 + 路由守卫 + Pinia 状态管理

验证：
- 全流程 API 端到端测试通过
- Playwright 页面自动化验证通过
- code-reviewer 代码审查通过

Made-with: Cursor
 2026-03-02 11:31:24 +08:00
bujinyuan
e9bd4dd204 fix: 时间精度精确到秒 + 同步全部文档到最新状态 
时间字段修正：
- init.sql: 所有 TIMESTAMP 改为 TIMESTAMP(0)，精确到秒
- GORM 模型: 所有时间字段添加 type:timestamp(0) tag
- 已有数据库表通过 ALTER TABLE 修正列类型

文档同步（架构设计 + 实施步骤）：
- system-architecture.md:
  - auth 模块描述更新为"有状态 JWT Token 管理（Redis 存储）"
  - 开发环境端口 8080 → 8085
- phase1-foundation-and-auth.md:
  - Go 版本 1.22+ → 1.23+
  - 常量命名更新为驼峰风格（UserStatusActive / RoleUser 等）
  - Task 4 完整重写：增加 token_store.go、TokenValidator 接口、有状态 JWT
  - Task 5 端口号 8080 → 8085，测试命令增加登出失效验证
  - 依赖版本选择原则说明

Made-with: Cursor
 2026-02-28 17:04:47 +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
d975adaf2a feat(auth): 完整认证系统 — 注册/登录/JWT/路由（Task 4 + Task 5） 
Task 4 — 认证服务层：
- pkg/utils/password.go: bcrypt 密码加密与校验
- pkg/utils/jwt.go: Access/Refresh Token 生成与解析（jwt/v5@v5.2.1，兼容 Go 1.23）
- app/dto/auth_dto.go: 认证相关请求/响应 DTO（含参数校验 binding tag）
- app/auth/service/auth_service.go: 核心业务逻辑（注册、登录、管理员登录、Token 刷新、个人信息、改密码）
- pkg/middleware/auth.go: JWT 认证中间件 + 角色权限检查中间件

Task 5 — Controller 与路由注册：
- app/auth/controller/auth_controller.go: 前台认证接口（7 个 API）
- app/auth/controller/admin_auth_controller.go: 后台管理认证接口
- app/auth/router.go: auth 模块路由定义（模块自包含）
- router/router.go: 主路由汇总入口（仅做调度，不含具体路由定义）
- cmd/server/main.go: 路由注册迁移到 router.Setup()

已验证全部接口：注册 ✓ 登录 ✓ 获取 profile ✓ 错误密码 ✓ 未认证拒绝 ✓ 非管理员拒绝 ✓

Made-with: Cursor
 2026-02-28 16:42:28 +08:00
bujinyuan
4d3d486902 refactor(middleware): 精简请求日志 — 采用社区标准分层策略 
- 移除 Request Body 记录（交由 Controller 层以结构化参数形式记录）
- 移除正常响应 Body 的 DEBUG 记录（减少日志量）
- 保留 HTTP 元信息：method/path/handler/status/latency/ip/query
- 保留错误响应(4xx/5xx)的 Response Body 记录
- 导出 IsSensitivePath 供 Controller 层调用
- 重写架构文档 8.6 节：分层日志架构表、字段说明、分级策略
- 更新 phase1 实施计划中间件描述

Made-with: Cursor
 2026-02-28 16:10:07 +08:00
bujinyuan
a6ef49a3e0 feat(middleware): 请求日志新增 handler 字段定位实际处理函数 
- 通过 c.HandlerName() 获取处理请求的 handler 函数名
- 解决 caller 始终指向中间件文件无法定位业务代码的问题
- 同步更新架构文档日志示例，补充 caller/handler 说明

Made-with: Cursor
 2026-02-28 15:56:32 +08:00
bujinyuan
99c2f4f86a docs: 同步更新请求日志中间件文档（请求参数 + 响应数据记录策略） 
- system-architecture.md 8.6: 完整记录策略表、状态码分级、日志输出示例
- phase1 实施计划 Task 2: 更新 logger 中间件描述

Made-with: Cursor
 2026-02-28 15:51:27 +08:00
bujinyuan
8a023dfd87 feat(middleware): 请求日志增强 — 记录请求参数 + 响应数据 
- Query 参数：INFO 级别始终记录（所有环境生效）
- Request Body：INFO 级别始终记录（所有请求方式）
  - 文件上传自动跳过，仅标记 [file upload]
  - 敏感路径（登录/注册/改密码）自动脱敏 password 字段
  - Body 超过 4KB 自动截断
- Response Body：DEBUG 级别记录正常响应，4xx/5xx 错误在 INFO 也记录
  - 响应 Body 最大记录 2KB
- 状态码分级：5xx→ERROR / 4xx→WARN / 慢请求→WARN / 正常→INFO

Made-with: Cursor
 2026-02-28 15:49:19 +08:00