架构与仓库边界
项目组成
| 仓库 | 职责 |
|---|---|
| happyro | 部署脚本、配置、本地化资源、文档和发布编排 |
| happyro-client | 浏览器客户端、PWA 与游戏内冒险工具 |
| happyro-server | rAthena 登录、角色、地图和 Web API 服务 |
| happyro-gateway | Node.js 网关、静态资源、HTTP 与 WebSocket 代理 |
| happyro-admin | 管理后台 React / Umi / Ant Design 前端 |
| happyro-api | Go / Gin 后端，为后台与游戏工具提供 API |
| happyro-doc | 公开文档站、玩家指南与安装说明 |
根仓库、五个应用仓库与文档仓库维护独立 Git 历史，长期中文产品分支均为 main。
运行关系
游戏与管理后台分别通过 Gateway 和 Admin 入口访问内部服务。Server 镜像运行 login、char、map、web-api 四个进程；Go API 为后台和冒险工具提供业务接口，通过 web-api 的受控接口请求 map 执行实时操作。
完整交互图、路由分工、端口与数据库关系见服务调用关系。
文档归属
玩家指南、攻略、后台操作和公开部署说明维护在本文档站；内部设计、实现计划、测试证据与发行构建流程维护在根仓库或对应应用仓库。对外文档引用实现入口，不复制内部进度和临时验收记录。
更新日志以根仓库为唯一内容源，通过 python3 tools/changelog/manage.py sync 同步本站，不在本站单独改写发布记录。