网关设计

重构后，gateway 不是一个带中间件策略的独立框架层，而是推荐的 Lua 服务模式。

目标

• net 负责连接监听、session 管理和原始收发。
• transport 负责可选解帧、解密、私有协议适配。
• Lua gateway 服务负责登录、会话绑定、消息路由和业务策略。
• 鉴权、限流、踢线、心跳等逻辑优先放在 Lua gateway 中。

目标回调

local M = {}

function M.on_init()
    shield.log.info("gateway started")
end

function M.on_connect(session)
end

function M.on_disconnect(session, reason)
end

function M.on_client_message(session, payload)
end

return M

消息流

client socket
  → net
  → optional transport
  → Lua gateway service (`on_client_message`)
  → shield.send / shield.call
  → Lua business service

非目标

以下能力不再作为 core gateway 设计：

• 跨协议 HTTP middleware chain。
• 内置 CORS / auth middleware。
• 内置 /health、/status、/metrics 管理端点。
• 框架级路由 DSL。

如果项目需要 HTTP 管理接口或复杂认证链，应在业务层或独立扩展中实现。