4、自助服务平台设计：平台架构概览、用户自助操作界面、后端服务与API网关

自助服务平台是蓝绿发布门禁体系的门户，它将底层复杂的发布策略、流量切换、安全校验与权限模型封装为直观的自助化能力。本章从平台架构总览出发，依次拆解用户自助操作界面、后端服务层与API网关三个核心层次，帮助读者建立从入口到后端的完整设计认知。

4.1 平台架构总览

自助服务平台采用经典的三层架构：用户界面层（Portal）、后端服务层（Backend Services）与API网关层（API Gateway）。各层职责清晰，通过标准化接口解耦，既保障了前端交互的灵活性，又实现了后端安全策略的统一管控。

4.2 用户自助操作界面

用户自助操作界面（Portal）面向开发人员、测试人员与运维人员，提供统一的蓝绿发布门禁操作入口。界面设计遵循任务驱动原则，将复杂的发布流程拆解为清晰的步骤向导。

4.2.1 核心功能模块

功能模块	面向角色	核心操作
发布申请	开发人员	选择应用、目标环境（蓝/绿）、提交发布请求
门禁审批	测试/运维人员	查看门禁检查项、手动审批/驳回、附加备注
流量切换	运维人员	一键切换蓝绿流量比例、查看实时监控
审计日志	安全/合规人员	查询操作记录、导出审计报告

4.2.2 界面交互流程

1. 身份认证：用户通过 SSO 登录 Portal，系统自动识别角色与权限范围。
2. 选择应用与环境：从下拉列表中选择目标应用，系统自动展示当前蓝绿环境状态（健康度、流量比例、版本号）。
3. 提交发布请求：填写发布说明、关联工单号，系统自动触发门禁预检查。
4. 查看门禁结果：界面以红/绿标签展示每项门禁检查结果，失败项可点击查看详情。
5. 执行发布或回滚：门禁全部通过后，用户可一键执行发布；若失败，可一键回滚至上一版本。

4.3 后端服务

后端服务层承载平台的核心业务逻辑，采用微服务架构部署。每个服务独立部署、独立扩展，通过 API 网关暴露接口。

4.3.1 核心服务清单

服务名称	职责描述	关键接口示例
发布管理服务	管理发布单生命周期（创建、审批、执行、回滚）	POST /api/v1/releases
门禁引擎服务	执行门禁检查规则（代码扫描、自动化测试、安全合规）	POST /api/v1/gates/check
权限服务	管理用户角色、资源权限、API 访问策略	GET /api/v1/permissions/users/{id}
审计服务	记录所有操作日志，支持查询与导出	GET /api/v1/audit/logs

4.3.2 服务间通信

后端服务之间采用同步 + 异步混合通信模式：

• 同步调用：门禁引擎服务通过 HTTP/REST 调用发布管理服务获取发布单上下文，用于实时检查。
• 异步消息：发布状态变更、门禁结果等事件通过消息队列（如 Kafka）广播，审计服务与监控服务订阅消费。

4.4 API 网关

API 网关是平台的安全边界与流量入口，承担着认证、鉴权、限流、审计与协议转换等关键职责。网关层直接决定了平台的安全防护能力与可观测性。

4.4.1 网关核心能力

能力维度	具体实现	安全价值
身份认证	OAuth2 / OIDC 协议，集成企业 SSO	确保请求来自合法用户
权限鉴权	基于 RBAC 的路径级与方法级权限校验	防止越权操作
流量限流	令牌桶算法，支持用户级与应用级限流	防止 DDoS 与资源耗尽
审计日志	记录请求来源、路径、参数、响应码与耗时	满足合规审计要求
请求/响应转换	协议转换（HTTP/gRPC）、请求头注入/过滤	统一后端接口规范

4.4.2 网关路由与安全策略配置示例

以下为基于 Kong API Gateway 的典型路由与安全策略配置片段：

# 路由配置：发布管理服务
routes:
  - name: release-service-route
    paths:
      - /api/v1/releases
    methods:
      - GET
      - POST
      - PUT
      - DELETE
    plugins:
      # 认证插件
      - name: oauth2
        config:
          scopes: ["release:read", "release:write"]
      # 限流插件
      - name: rate-limiting
        config:
          minute: 100
          hour: 1000
      # 日志插件
      - name: file-log
        config:
          path: /var/log/gateway/audit.log

4.5 架构设计要点总结

层次	核心关注点	安全要求
用户界面层	交互体验、任务引导、实时状态展示	前端输入校验、防 XSS/CSRF
API 网关层	统一入口、认证鉴权、限流审计	OAuth2 认证、RBAC 鉴权、请求限流
后端服务层	业务逻辑、门禁引擎、数据持久化	服务间 mTLS、最小权限原则