平台工程团队建设

阶段 1：集中式（0-6 个月）
    → 建立核心平台能力
    → 证明平台价值

阶段 2：集中式 + Guild（6-12 个月）
    → 引入平台工程 Guild
    → 开始知识共享

阶段 3：联邦式（12+ 个月）
    → 拆分域平台团队
    → 核心团队聚焦基础设施

# platform-team-capabilities.yaml - 平台团队能力模型
apiVersion: platform.acme.com/v1
kind: PlatformTeamCapability
metadata:
  name: platform-team-capabilities
spec:
  capabilityDomains:

    - name: 基础设施
      description: 计算、存储、网络等基础设施管理
      skills:
        - Kubernetes 管理（EKS/GKE/AKS）
        - Terraform / Pulumi 基础设施即代码
        - 网络与安全（VPC、防火墙、mTLS）
        - 成本管理与优化
      responsibilities:
        - 集群生命周期管理
        - 节点自动扩缩容
        - 基础设施变更审批
        - 成本预算与告警
      maturityLevel: 3  # 1-5 级

    - name: CI/CD
      description: 持续集成与持续交付流水线
      skills:
        - GitHub Actions / GitLab CI
        - ArgoCD / Flux GitOps
        - 容器镜像构建与扫描
        - 制品管理与版本控制
      responsibilities:
        - 流水线模板维护
        - GitOps 配置管理
        - 发布策略（蓝绿、金丝雀、滚动）
        - 制品仓库运维
      maturityLevel: 4

    - name: 可观测性
      description: 日志、指标、链路追踪
      skills:
        - Prometheus + Grafana
        - Loki / Elasticsearch
        - Jaeger / Tempo
        - OpenTelemetry
      responsibilities:
        - 可观测性栈部署与维护
        - 仪表盘模板管理
        - 告警规则治理
        - SLO 框架建设
      maturityLevel: 3

    - name: 安全
      description: 安全策略与合规
      skills:
        - Vault 密钥管理
        - OPA/Gatekeeper 策略引擎
        - SAST/DAST 安全扫描
        - 证书管理（cert-manager）
      responsibilities:
        - 密钥轮转与分发
        - 安全策略定义与执行
        - 漏洞扫描与修复追踪
        - 合规审计支持
      maturityLevel: 2

    - name: 开发者体验
      description: 开发者门户与自助服务
      skills:
        - Backstage 开发者门户
        - 开发环境（DevSpace / Tilt）
        - CLI 工具开发
        - 文档与培训
      responsibilities:
        - 开发者门户维护与迭代
        - 黄金路径模板管理
        - 开发者反馈收集与响应
        - 平台文档与培训
      maturityLevel: 3

# scripts/developer_survey.py - 开发者调研自动化
import datetime
import json
from dataclasses import dataclass, field
from typing import List, Optional

@dataclass
class SurveyResponse:
    """开发者调研响应"""
    developer_id: str
    team: str
    nps_score: int  # 0-10
    cognitive_load: int  # 1-5，认知负荷
    feedback_speed: int  # 1-5，反馈速度
    flow_efficiency: int  # 1-5，流动效率
    pain_points: List[str] = field(default_factory=list)
    feature_requests: List[str] = field(default_factory=list)
    free_text: Optional[str] = None
    timestamp: str = field(
        default_factory=lambda: datetime.datetime.now().isoformat()
    )


class PlatformNPS:
    """平台 NPS 计算器"""

    def __init__(self, responses: List[SurveyResponse]):
        self.responses = responses

    def calculate_nps(self) -> dict:
        """计算 NPS 及各维度得分"""
        if not self.responses:
            return {"error": "No responses"}

        # NPS 分类
        promoters = [r for r in self.responses if r.nps_score >= 9]
        passives = [r for r in self.responses if 7 <= r.nps_score <= 8]
        detractors = [r for r in self.responses if r.nps_score <= 6]

        total = len(self.responses)
        nps = (len(promoters) - len(detractors)) / total * 100

        # 各维度平均分
        avg_cognitive_load = sum(
            r.cognitive_load for r in self.responses
        ) / total
        avg_feedback_speed = sum(
            r.feedback_speed for r in self.responses
        ) / total
        avg_flow_efficiency = sum(
            r.flow_efficiency for r in self.responses
        ) / total

        # 痛点统计
        pain_point_counts = {}
        for r in self.responses:
            for pp in r.pain_points:
                pain_point_counts[pp] = pain_point_counts.get(pp, 0) + 1

        # 功能请求统计
        feature_request_counts = {}
        for r in self.responses:
            for fr in r.feature_requests:
                feature_request_counts[fr] = (
                    feature_request_counts.get(fr, 0) + 1
                )

        return {
            "nps": round(nps, 1),
            "total_responses": total,
            "promoters": len(promoters),
            "passives": len(passives),
            "detractors": len(detractors),
            "avg_cognitive_load": round(avg_cognitive_load, 2),
            "avg_feedback_speed": round(avg_feedback_speed, 2),
            "avg_flow_efficiency": round(avg_flow_efficiency, 2),
            "top_pain_points": sorted(
                pain_point_counts.items(),
                key=lambda x: x[1],
                reverse=True,
            )[:5],
            "top_feature_requests": sorted(
                feature_request_counts.items(),
                key=lambda x: x[1],
                reverse=True,
            )[:5],
        }


# 使用示例
if __name__ == "__main__":
    responses = [
        SurveyResponse(
            developer_id="dev-001",
            team="order-team",
            nps_score=9,
            cognitive_load=2,
            feedback_speed=4,
            flow_efficiency=3,
            pain_points=["部署等待时间过长"],
            feature_requests=["支持金丝雀发布自助配置"],
        ),
        SurveyResponse(
            developer_id="dev-002",
            team="payment-team",
            nps_score=7,
            cognitive_load=3,
            feedback_speed=3,
            flow_efficiency=3,
            pain_points=[
                "文档不完整",
                "环境配置复杂",
            ],
            feature_requests=["更好的文档搜索", "环境一键克隆"],
        ),
        SurveyResponse(
            developer_id="dev-003",
            team="user-team",
            nps_score=6,
            cognitive_load=4,
            feedback_speed=2,
            flow_efficiency=2,
            pain_points=[
                "CI 流水线太慢",
                "调试困难",
                "环境不稳定",
            ],
            feature_requests=["增量构建", "远程调试支持"],
        ),
    ]

    calculator = PlatformNPS(responses)
    result = calculator.calculate_nps()
    print(json.dumps(result, indent=2, ensure_ascii=False))

# platform-roadmap.yaml - 平台产品路线图
apiVersion: platform.acme.com/v1
kind: PlatformRoadmap
metadata:
  name: idp-roadmap-2024
spec:
  quarters:

    - quarter: Q1
      theme: 基础自助服务
      objectives:
        - name: 服务创建自助化
          metric: 新服务上线时间从 5 天缩短到 30 分钟
          status: completed
        - name: CI/CD 模板化
          metric: 80% 的服务使用标准流水线模板
          status: completed
        - name: 环境自助申请
          metric: 环境申请工单减少 70%
          status: completed

    - quarter: Q2
      theme: 可观测性集成
      objectives:
        - name: 统一监控面板
          metric: 所有服务拥有标准化监控面板
          status: in-progress
        - name: 日志自助查询
          metric: 日志查询不再依赖运维团队
          status: in-progress
        - name: 链路追踪集成
          metric: 关键链路追踪覆盖率 > 80%
          status: pending

    - quarter: Q3
      theme: 发布质量保障
      objectives:
        - name: 金丝雀发布自助化
          metric: 金丝雀发布不再需要 SRE 介入
          status: pending
        - name: 发布质量门禁
          metric: 发布回滚率降低 50%
          status: pending
        - name: 发布监控仪表盘
          metric: 发布过程可视化
          status: pending

    - quarter: Q4
      theme: 开发者体验升级
      objectives:
        - name: 开发环境云化
          metric: 本地环境配置时间减少 80%
          status: pending
        - name: 平台 NPS 提升
          metric: NPS 从 35 提升到 55
          status: pending

# platform-release.yaml - 平台发布记录
apiVersion: platform.acme.com/v1
kind: PlatformRelease
metadata:
  name: idp-v2.3.0
  date: 2024-03-15
spec:
  version: 2.3.0
  releaseNotes: |
    ## 新功能
    - Scaffolder 支持自定义步骤插件
    - 服务目录支持依赖关系可视化图谱
    - 新增成本分析插件（Cost Insights）

    ## 改进
    - 搜索性能优化，响应时间降低 40%
    - TechDocs 支持 Mermaid 图表渲染
    - Kubernetes 插件支持多集群视图

    ## 修复
    - 修复 SSO 登录偶发失败的问题
    - 修复服务目录实体缓存不一致的问题

  breakingChanges: []
  migrationGuide: |
    本次发布无破坏性变更，直接升级即可。

  rollbackPlan: |
    1. 回滚 Helm Chart 版本到 v2.2.1
    2. 回滚数据库 Migration（如有）
    3. 验证核心功能正常