Skip to content
Are you an LLM? You can read better optimized documentation at /chatroom/en.md for this page in Markdown format
ChatRoom Technical Whitepaper
A real-time full-stack system architecture reference implementation
Go 1.24React 19WebSocketPostgreSQL
A teaching-oriented real-time chat application demonstrating core design patterns of modern full-stack systems
Core Features
🔐 JWT Dual Token Auth
Short-lived Access Token + long-lived Refresh Token with automatic rotation to minimize leak risks
🎫 WebSocket Ticket Auth
One-time ticket authentication via Subprotocol, 60-second validity, prevents replay attacks
🌐 Distributed Sync
Cross-instance broadcast via PostgreSQL LISTEN/NOTIFY, no Redis required, keeping architecture simple
📊 Prometheus Observability
Built-in metrics for connections, throughput, latency distribution, Grafana-ready
Quick Navigation
📖
Whitepaper
Complete technical analysis
🏗️
Architecture
System layers & components
🚀
Getting Started
Run the project in minutes