提交架構審計檢查

POST /v1/architecture/assessments — 發起系統拓撲、技術債與組件耦合度評審。

提交企業微服務或雲端基礎設施拓撲，發起架構健康度、技術債與合規脆弱性評審。

接口基本資訊

POST/v1/architecture/assessments

上傳以 JSON 定義的系統微服務拓撲圖與依賴清單，Pinnacle 架構審核引擎將自動檢驗循環依賴、單點故障 (SPOF) 與多雲數據隔離合規性。

請求參數規格

參數規格 (Parameters)

參數名稱	位置	類型	必填	說明
`system_name`	body	string	必填	待評審的系統或業務線名稱示例: Pinnacle-Global-Payment-Mesh
`topology_spec`	body	object	必填	微服務節點 (nodes) 與依賴邊 (edges) 定義結構示例: {"nodes": [{"id":"svc_auth"},{"id":"svc_ledger"}], "edges": [{"from":"svc_auth","to":"svc_ledger"}]}
`compliance_standards`	body	array	選填	要求驗證的合規架構標準: ["TOGAF", "ISO27001", "BVI_DPA"]示例: ["TOGAF", "ISO27001"]
`auto_remediation`	body	boolean	選填	是否生成自動消債重構建議示例: true

多語言發起審查代碼示例

發起架構健康審查 (POST /v1/architecture/assessments)

curl -X POST "https://api.pinnacle-advisory.vg/v1/architecture/assessments" \
  -H "Authorization: Bearer sec_live_9a8b7c6d5e4f" \
  -H "Content-Type: application/json" \
  -d '{
    "system_name": "Pinnacle-Global-Payment-Mesh",
    "compliance_standards": ["TOGAF", "ISO27001"],
    "topology_spec": {
      "nodes": [
        {"id": "auth-gateway", "type": "api_gateway", "redundancy": 3},
        {"id": "payment-core", "type": "microservice", "redundancy": 2},
        {"id": "offshore-db", "type": "aurora_postgresql", "multi_az": true}
      ],
      "edges": [
        {"from": "auth-gateway", "to": "payment-core", "protocol": "gRPC"},
        {"from": "payment-core", "to": "offshore-db", "protocol": "TCP/TLS"}
      ]
    }
  }'

評審結果載荷範例 (201 Created)

HTTP 201 Created 評審結果報告

{
  "status": "created",
  "data": {
    "assessment_id": "asm_arch_20260929_1102",
    "system_name": "Pinnacle-Global-Payment-Mesh",
    "health_score": 92.4,
    "grade": "A-",
    "metrics": {
      "spof_count": 0,
      "cyclic_dependencies": 0,
      "max_depth_hops": 4,
      "estimated_tech_debt_hours": 36
    },
    "findings": [
      {
        "severity": "medium",
        "category": "resilience",
        "description": "Component 'payment-core' has redundancy of 2, recommended minimum is 3 for cross-region HA.",
        "remediation": "Increase minimum replica count to 3 and enable horizontal pod autoscaling."
      }
    ]
  }
}