各端说明
spawn 的客户端与服务端现状一览。规划中的端只列状态，不写未实现的功能。
客户端
| 端 | 目录 | 技术栈 | 状态 |
|---|---|---|---|
| Web 主站 | apps/web-client | React 19 · Vite 8 · React Router 7 | 已落地 |
| 移动客户端 | apps/mobile-app | Expo 57 · React Native 0.86 · expo-router | 已落地（Android release 出包流程已就绪） |
| 小程序壳 | apps/mini-program | — | 规划中，尚未创建 |
| 运营后台 | apps/admin-console | — | 规划中，尚未创建 |
Web 端（web-client）
- 面向攻略、榜单、社区的主站入口，路由用 React Router 组织。
- 开发调试时直连各业务服务；经
api-gateway的聚合接口（/home/feed）可一次拿到首页四组数据。 - 「发现」页（
/discover）消费GET /home/feed聚合四区块（精选游戏/热帖/话题/攻略）， 网关侧降级分组顶部给提示条，对等 mobile 发现 Tab（2026-10-09 落地）。 - M3 关系功能 web 对等（2026-10-09 落地）：社区页帖子流加「关注」模式 （
GET /api/v1/posts/followed，未登录自动回退最新）；个人中心页（/profile， 登录后导航可达）聚合我的帖子（author_id 过滤）/我的攻略（author_id 过滤， 带 Bearer 可见自己草稿）/我的点赞（GET /api/v1/users/likes）。 - 站内通知（2026-10-09 落地）：导航铃铛带未读徽标（30s 轮询）+
/notifications通知中心（点赞/评论/回复/关注四类，未读圆点，全部已读；点赞/评论/回复点进原帖）。 - 常用脚本：
pnpm --dir apps/web-client run dev（开发）、build（tsc + vite 打包）、lint。
移动端（mobile-app）
- 基于 Expo 与 expo-router 的文件式路由，覆盖游戏库/攻略/社区/战绩等场景。
- 集成能力：expo-notifications（推送）、expo-linking（深链与分享卡）、expo-secure-store（凭据安全存储）。
- 首页数据走
api-gateway的GET /home/feed聚合消费点（发现 Tab）。 - 站内通知（2026-10-10 落地）：社区 Tab 铃铛未读徽标 +
/notifications通知中心（点赞/评论/回复点进原帖，全部已读）。 - 攻略创作与编辑（2026-10-10 落地）：
/guide-compose写攻略（纯文本/Markdown，创建即发布）；详情页作者本人可编辑（PUT 部分更新，游戏不可改）。 - Android 出包：
pnpm --dir apps/mobile-app run prebuild:android生成原生工程，build:android:release走 gradle assembleRelease。 - 真机回归项（本地推送、深链分享卡、通知中心）尚待设备验证，进度见[移动端计划]/mobile_plan.zh。
服务端（七个 go-zero 微服务 + 一个实时中枢）
| 服务 | 目录 | 职责 | 存储 |
|---|---|---|---|
| api-gateway | services/api-gateway | 接入层：JWT 认证、路由反代、BFF 聚合 | — |
| user-service | services/user-service | 账号、登录注册、用户信息与推荐 | SQLite / MySQL 双驱动 |
| game-catalog | services/game-catalog | 游戏库、标签、精选、推荐 | SQLite / MySQL 双驱动 + 进程内读缓存 |
| content-service | services/content-service | 攻略、评论、发布流、收藏 | SQLite / MySQL 双驱动 + 进程内读缓存 |
| community | services/community | 帖子、话题、关注、点赞、关注流、站内通知、私信、举报审核 | SQLite / MySQL 双驱动 |
| data-panel | services/data-panel | 战绩摄入（单调增量）与玩家战绩查询 | SQLite / MySQL 双驱动 + TTL/LRU 缓存 |
| user-service-rpc | services/user-service-rpc | 用户域 gRPC 内部接口（zrpc + etcd） | 复用 user-service 存储 |
| realtime-hub | services/realtime-hub | WebSocket 推送/在线状态/语音信令（8893，无 /metrics） | —（内存注册表，可选 Redis pub/sub 中继） |
端口表在快速上手，服务边界与认证数据流的现状记录在现状拓扑。
规划中的服务：matchmaking（组队匹配）、crawler-jobs（外部信息抓取）尚未创建（realtime-hub 已于 2026-10-11 落地，见上表），见仓库 README 的目录规划。