Home

ChatRoom Wiki

欢迎来到 ChatRoom 的开发 Wiki！

本 Wiki 用于记录项目的协议设计、部署配置、消息流转等内部开发文档。

项目概览

ChatRoom 是一个全栈实时聊天应用：

组件	技术栈	说明
Backend	Go 1.24, Gin, GORM, gorilla/websocket	REST API + WebSocket
Frontend	React 19, TypeScript, Vite	SPA 客户端
Database	PostgreSQL 16	数据持久化
Monitoring	Prometheus, Zerolog	指标采集与日志

核心功能模块

• 用户系统 — 注册、登录、JWT Token 刷新
• 房间管理 — 创建、列表、加入/退出
• 实时消息 — WebSocket 双向通信
• 状态指示 — 在线人数、输入状态、加入/离开事件
• 消息历史 — 分页查询

页面索引

• Protocol Design — WebSocket 消息协议与事件设计
• Deployment Guide — Docker Compose / 本地开发 / 生产部署配置
• Message Flow — 消息从发送到接收的完整流转路径
• Debug Notes — 常见问题与调试经验