Gateway 会话设计

这篇文档解决的是 Gateway 这一层的边界问题：

Apollo 的 Gateway 到底应该持有什么，不应该持有什么。

当前如果不把这层收住，系统会很容易变成：

Login 持有一部分 session
Gateway 持有一部分玩家状态
BaseApp 再持有一部分在线归属

这样后面做重连、切图、踢号时一定会打架。

一、先说结论

Gateway 应该是公网连接入口和会话接入层，不应该是玩家在线主状态宿主。

也就是说：

GatewaySession 很重要
但 GatewaySession != PlayerAnchor

合理边界应该是：

Gateway 持有连接态
BaseApp(PlayerAnchor Host) 持有在线主状态
WorldHost 持有世界表现态
DBMgr / PersistenceService 持有持久化执行职责

二、当前代码状态

从当前代码看：

session_manager.hpp
- SessionManager 管理 ClientConnection
- ClientConnection 里同时持有 sessionId
- playerId
- assignedCellApp
gateway_server.hpp
- GatewayServer 持有 SessionManager
- MessageRouter 负责转发给 base/chat/cell
gateway_server.cpp
- 心跳超时由 Gateway 自己检查
- 断线时通知 CellApp 和 BaseApp
- forwardToCellApp 仍然有“按 cell 直接路由”的原型思路

这说明当前 gateway-app 已经有两种语义混在一起：

正常的连接入口语义
一部分玩家归属与 world 路由语义

后者需要逐步收回到 BaseApp。

三、`Gateway` 应该负责什么

建议 Gateway 只负责下面 5 类事情。

1. 公网连接

accept client socket
建立连接
读写消息
关闭连接

2. 协议编解码

登录票据校验请求
客户端消息解包
下行消息封包

3. 会话状态

会话创建
心跳更新时间
连接超时检测
断开原因记录

4. 上下行转发

客户端到后端
后端到客户端

5. 连接事件通知

登录成功绑定
主动断开
超时断开
重连替换

四、`Gateway` 不应该负责什么

1. 不应该成为玩家权威归属中心

Gateway 不应该独自决定：

这个玩家是否真的已经上线
这个玩家当前属于哪个 world
这个玩家断线后是否保留 world 归属

2. 不应该直接决定 world 分配

当前 ClientConnection 里有 assignedCellApp，这更像原型期做法。

后续更合理的方式应该是：

Gateway 只保存当前已绑定的路由快照
真正权威的 world assignment 在 PlayerAnchor

3. 不应该持有玩家长期业务状态

例如：

背包
属性
切图状态机
长期在线恢复状态

这些都不应该进 GatewaySession。

五、推荐对象关系

建议后续收成下面这组对象关系：

GatewayServer
    ├── GatewayConnectionManager
    ├── GatewaySessionManager
    ├── SessionAuthenticator
    ├── UpstreamRouter
    └── DisconnectNotifier

`GatewayConnectionManager`

职责：

socket 生命周期
连接接入
读写缓冲

`GatewaySessionManager`

职责：

会话创建和回收
心跳状态
将连接和 sessionId 绑定

`SessionAuthenticator`

职责：

向 BaseApp 校验登录票据
校验 sessionId -> playerId 绑定是否合法

`UpstreamRouter`

职责：

按照 BaseApp 下发的路由快照转发消息
不直接掌握长期归属权威

`DisconnectNotifier`

职责：

把断线事件上报给 BaseApp
必要时通知当前 world

六、当前 `SessionManager` 应该怎么演进

当前 SessionManager 是可以保留的，但要降语义。

当前结构的问题

ClientConnection 现在混了三类信息：

连接信息
玩家信息
world 路由信息

这会导致 Gateway 越写越像在线中心。

更合理的拆法

建议把当前 ClientConnection 的内容拆成：

GatewayConnection
    └── socket / ip / port / heartbeat

GatewaySession
    └── sessionId / playerId / auth state

RouteSnapshot
    └── worldId / route target / version

这样职责更清楚：