ChatRoom ​

一个全栈开发教学项目：Go + React + PostgreSQL + WebSocket

核心特性 ​

• JWT 双 Token 认证：短期 Access Token + 长期 Refresh Token，自动轮换
• WebSocket Ticket 认证：一次性票据，通过 Subprotocol 传递，防止重放
• 房间级实时广播：每个房间一个 RoomHub goroutine，连接与消息隔离
• 消息持久化：聊天记录存入 PostgreSQL，支持分页加载历史

快速导航 ​

推荐阅读路线 ​

建议按以下顺序通读源码，每一步都能在几分钟内读完：

1. cmd/server/main.go — 启动流程
2. internal/config/config.go — 配置与日志
3. internal/server/router.go — 路由全貌
4. internal/server/handler.go — HTTP Handler
5. internal/auth/auth.go — JWT 与票据认证
6. internal/service/user.go — 注册、登录、Token 轮换
7. internal/ws/hub.go — WebSocket 房间模型
8. internal/ws/conn.go — 连接管理与消息分发
9. frontend/src/App.tsx — 前端 Hooks 组合
10. frontend/src/hooks/useChatSocket.ts — WS 事件分发

架构预览 ​