spawnGame community platform

Four capabilities — game catalog, guides, community, realtime — across two clients, web and mobile; seven go-zero microservices plus a WebSocket realtime hub, in one repository.

Getting Started

Architecture

Development Guide

简体中文

Game catalog & leaderboards

game-catalog manages games, tags, featured and recommended lists. SQLite/MySQL dual driver; filtering, sorting and pagination all finish server-side.

Guides & content

content-service manages guides and comments, with draft and published states, keyword/tag filtering, sorting and favourites. A guide's game info is pulled across services from game-catalog to fill it in.

Community interaction

community has posts, topics, follows, likes, in-app notifications, direct messages and report moderation. The follow feed is time-descending with id as the tie-break inside one second; likes live in their own relation table; notifications deduplicate on (recipient, actor, type, target).

Access & aggregation

api-gateway owns the login/registration proxy plus five proxy routes; JWT issuing lives in user-service. /home/feed pulls featured games, hot posts, topics and guides in one request; if one upstream fails only that group degrades, the rest return normally.

Realtime channel

realtime-hub provides WebSocket long connections (JWT verified), /internal/publish fanout, presence and voice signalling passthrough, with Redis pub/sub relay across instances; the gateway /ws tunnel passes straight through.

Multi-client apps

web-client on React 19 + Vite; mobile-app on Expo, with local push, deep-link share cards, a notification center and guide authoring/editing, Android builds via gradle. The mini-program and the admin console have not started.

Observability

each of the seven services exposes one Prometheus /metrics port (9091–9097); logs are structured JSON into Loki, and deploy/ ships compose files for Prometheus, Loki and Grafana.