ChatRoom 教学文档从运行项目到理解实时聊天系统

面向个人练手与教学演示的 Go + React + WebSocket 聊天室文档站。

开始学习

手动测试实验

查看 API

🚀

先跑起来

用最短路径启动数据库、后端和前端，快速得到一个可用的聊天室演示环境。

🔍

再看原理

通过架构文档、设计文档和 API 文档，理解 REST、JWT 和 WebSocket 的协作方式。

🧪

最后做实验

按照手动测试实验清单，一步步验证注册、登录、房间、消息、在线人数和输入状态。

🔐

JWT 鉴权

Access Token + Refresh Token 双令牌体系，Gin 中间件统一校验，前端自动续期。

⚡

WebSocket 实时通信

房间级 Hub 广播、加入/离开事件、输入状态提示、消息持久化与分页查询。

📊

Prometheus 监控

内置 HTTP 请求、WebSocket 连接和业务指标采集，配套 Grafana 仪表盘模板。

技术栈

后端	前端	数据库	监控	自动化
Go 1.24 · Gin · GORM · gorilla/websocket	React 19 · TypeScript · Vite	PostgreSQL 16	Prometheus · Grafana	GitHub Actions

这份文档适合谁

想用一个小项目练习 Go 后端开发的人
想理解 React 前端如何接入 REST + WebSocket 的人
想把这个仓库当成课堂演示或自学教材的人

你将学到什么

后端部分

Gin 路由与中间件的组织方式
JWT / Refresh Token 的基本鉴权流程
GORM 与 PostgreSQL 的配合方式
WebSocket 房间广播的基本实现

前端部分

React 前端如何组织认证、房间、消息状态
本地存储与登录态恢复
WebSocket 连接状态与事件处理
frontend/ 与 web/ 两套界面的职责差异

工程化部分

如何运行后端与前端测试
如何阅读 Release 与 CI 流程
如何把 Markdown 文档演化为在线教学站

ChatRoom 教学文档从运行项目到理解实时聊天系统

先跑起来

再看原理

最后做实验

JWT 鉴权

WebSocket 实时通信

Prometheus 监控

技术栈 ​

这份文档适合谁 ​

推荐阅读顺序 ​

你将学到什么 ​

后端部分 ​

前端部分 ​

工程化部分 ​

技术栈

这份文档适合谁

推荐阅读顺序

你将学到什么

后端部分

前端部分

工程化部分