多人在线聊天五子棋产品系统Vibe Coding

本项目面向多人在线实时互动与轻竞技场景，主要解决“实时通信稳定性、多人并发一致性、房间状态管理、账号会话安全”四类问题。传统单体或弱状态系统在多人对局、断线重连、跨服务协作时容易出现状态错乱、消息延迟、会话失效不一致等问题。
项目以“房间”为业务核心单元，围绕大厅、建房、对局、聊天、通知、账号治理形成完整业务闭环，适用于棋牌类、轻竞技类小游戏平台的后端能力建设，也可作为实时协同类产品的技术底座参考。

项目实现了“大厅-房间-对局-聊天-通知-会话治理”全链路功能。
核心功能包括：1）账号认证与会话治理：基于 Keycloak + JWT 实现登录鉴权、单设备在线、踢线与会话状态同步；2）实时对局：支持五子棋 PVP/PVE，具备建房、入房、准备、开始、落子、认输、重开等流程；3）实时通信：基于 WebSocket + STOMP 实现房间级消息广播与状态推送；4）状态恢复：房间状态、棋盘快照、回合计时落 Redis，支持断线重连及服务重启后恢复；5）社交与消息：支持大厅/房间聊天、私聊、系统通知，消息支持持久化与未读管理；6）用户能力：用户资料管理、好友关系维护、头像文件存储。
系统整体支持后续扩展更多小游戏类型和运营能力。

我担任项目整体设计与核心开发负责人，主导后端微服务架构设计、服务边界划分与关键链路落地。技术上采用 Java 21 + Spring Boot + Spring Cloud Gateway + WebSocket + Redis + Kafka + PostgreSQL + Keycloak。
我重点完成了三块：
1）并发一致性：围绕 roomId 设计房间级隔离，使用状态机约束操作合法性，并通过 Redis CAS 保证同回合并发写入只成功一次；
2）会话安全与实时连接治理：实现登录会话与 WebSocket 会话映射、单设备登录互踢、会话失效事件传播与连接清理；
3）状态恢复与跨服务协作：实现对局快照与回合状态持久化，支持断线重连/服务重启恢复，并通过事件机制降低服务耦合。
同时推进了接口规范、异常处理规范和一键启动文档，保证系统可复现、可演示、可扩展。