组织项目摘要卡片墙（只读聚合）

GET /api/v1/orgs/{orgId}/project-summaries · listOrgProjectSummaries

中央面组织项目卡片墙：对组织下每个项目返回一张【只读摘要卡片】——需求数 / 完成率 / 里程碑健康（总数/有风险/已完成）/ 风险数。只聚合数字，绝不返回需求 / 工作项明细。对每个项目在其自己的 TenantTx/RLS 内聚合（不跨库裸 SQL、不建聚合表），有界并发 fan-out；某项目不可达时该卡片 failed=true + error 文案，不阻塞其它项目。鉴权：需 Org Admin（D4：未接管即可看摘要卡片，但点不进明细）；非本组织成员不可见。 PAT 不可调用本端点：本端点按定义跨组织下全部项目聚合，而 PAT 只绑定其中一个。

本接口要求浏览器会话。Bearer API Token 无法调用——Token 的生命周期管理必须在网页端完成。

参数

orgId（必填）: string

响应字段 · 200

items（必填）: OrgProjectSummary[]
items[].projectId（必填）: string
items[].orgId: string
items[].name（必填）: string
items[].subdomainPrefix（必填）: string
items[].status（必填）: string
items[].managed（必填）: boolean
items[].failed（必填）: boolean
items[].error: string
items[].requirementCount（必填）: integer
items[].requirementOpenCount（必填）: integer
items[].requirementCompletedCount（必填）: integer
items[].completionRate（必填）: integer
items[].milestoneTotal（必填）: integer
items[].milestoneAtRisk（必填）: integer
items[].milestoneCompleted（必填）: integer
items[].riskCount（必填）: integer

错误

403：Problem 错误响应

请求示例（curl）

curl -X GET "https://workflow.games/api/v1/orgs/{orgId}/project-summaries" \
  -H "Authorization: Bearer wfp_…"

响应示例

HTTP/1.1 200
{
  "items": [
    {
      "projectId": "018f3c2e-0000-7000-8000-000000000000",
      "name": "示例标题",
      "subdomainPrefix": "示例文本",
      "status": "示例文本",
      "managed": true,
      "failed": true,
      "requirementCount": 1,
      "requirementOpenCount": 1,
      "requirementCompletedCount": 1,
      "completionRate": 1,
      "milestoneTotal": 1,
      "milestoneAtRisk": 1,
      "milestoneCompleted": 1,
      "riskCount": 1
    }
  ]
}

合同真值：OpenAPI 3.1（0.1.0）。

相关：Agent 接入指南 · 使用指南 · API 参考索引