Gateway 20 分钟宣贯 PPT 大纲
使用说明
- 建议总页数：12 页
- 目标时长：20 分钟（讲解 17 分钟 + QA 3 分钟）
- 受众：研发（RD）/测试（QA）/运维（SRE）
第 1 页：标题页（0.5 分钟）
标题建议：Gateway 架构与接入实践宣贯
副标题建议：统一接入、插件扩展、配置驱动
讲述重点：
- 本次宣贯关注“能做什么、怎么接、如何验证”
第 2 页：为什么需要 Gateway（1.5 分钟）
建议内容：
- 现状痛点：协议处理分散、接入周期长、联调复杂
- 建设目标：统一入口、解耦业务、可扩展、可运维
讲述重点：
- 不只是“加一个转发层”，而是统一工程能力底座
第 3 页：Gateway 的核心价值（1.5 分钟）
建议内容：
- 多协议接入（HTTP/TCP/MQTT）
- 统一
Context/Message - 插件化扩展（Access + Business）
- 配置驱动（YAML）
- 高性能处理（事件驱动 + ThreadPool）
讲述重点：
- “新增能力优先通过插件和配置实现”，减少主干改动
第 4 页：总体架构图（2 分钟）
建议内容：
- 三层架构：Access Layer / Core Framework / Business Layer
- 核心组件：
Gateway、ConfigManager、PluginManager、Router - 与后端服务关系：DataCenter 服务集成
讲述重点：
- 强调层间边界和职责，不跨层写逻辑
第 5 页：请求全链路（2 分钟）
建议内容（流程箭头）：
- AccessPlugin 接收协议请求
- 转为
Context - Router 路由匹配 + 参数提取
- BusinessPlugin 执行业务
- Context 按协议回包
讲述重点：
- 所有协议最终都收敛到统一处理路径
第 6 页：配置体系（2 分钟）
建议内容：
serveraccess_pluginsroutesbusiness_plugins
讲述重点：
- 路由优先级、命名一致性、规则冲突是配置评审关键点
第 7 页：插件扩展机制（2 分钟）
建议内容：
- 动态库加载 +
createPlugin工厂导出 - 新增 Access Plugin 的最小步骤
- 新增 Business Plugin 的最小步骤
讲述重点：
- 扩展靠接口契约，不改核心路径
第 8 页：协议差异与注意事项（1.5 分钟）
建议内容：
- HTTP：短连接响应为主
- TCP：长度头 + protobuf 体，
message_id关联请求响应 is_last：单次响应与流式响应的边界语义
讲述重点：
- 联调问题大多来自协议细节理解不一致
第 9 页：测试工具与验证策略（2 分钟）
建议内容：
tcp_access_test_tool支持 Service/Action/Topic- 并发、频率、消息量可配置
- 统计指标：发送、接收、错误、速率
讲述重点：
- 宣贯后要能“立即验证”，不是只停留在架构层
第 10 页：常见问题与排查（1.5 分钟）
建议内容：
- 路由不匹配
- 插件加载失败
- TCP 回包异常
讲述重点：
- 给出“一看配置、二看日志、三看协议字段”的排障顺序
第 11 页：能力边界与规划（1 分钟）
建议内容：
- 现状：FilterChain、部分限流/热更新为预留或未完整落地
- 规划：鉴权、限流、可观测性、灰度能力
讲述重点：
- 讲清“现在能做什么，后续什么时候做”
第 12 页：落地行动项 + QA（2.5 分钟）
建议内容：
- 行动项 1：输出标准配置模板
- 行动项 2：建立接入评审清单
- 行动项 3：固化回归与压测基线
- 预留 QA 时间
讲述重点：
- 宣贯结束后要有明确 owner、时间点和产出物
附：演讲节奏建议
- 每页 1 个主结论，不堆砌细节
- 架构页讲边界，流程页讲闭环，配置页讲规则，测试页讲标准
- 术语统一：
Context、Route、Plugin、Service/Action/Topic
附：可复用素材清单
- 详细设计文档中的系统架构图、初始化流程图、请求处理时序图
- 配置指南中的
gateway.yaml样例 - 测试工具指南中的 Service/Action/Topic 配置示例