{
  "openapi": "3.1.0",
  "info": {
    "title": "AbleFlow Public API",
    "version": "1.0.0",
    "description": "같은 메이저 안에서는 요청한 마이너와 상관없이 그 메이저의 최신 마이너로 응답한다. 그래서 마이너 · 패치에는 이미 쓰는 클라이언트를 깨지 않는 변경만 들어간다\n- 응답의 모르는 칸은 무시한다\n- 응답 열거 값(문자열 리터럴 합집합)은 열려 있다: 모르는 값이 와도 깨지지 않게 처리한다(예: 기타로 표시)\n- 모르는 오류 코드는 HTTP 상태로 처리한다"
  },
  "servers": [
    {
      "url": "/"
    }
  ],
  "tags": [
    {
      "name": "projects",
      "description": "프로젝트"
    },
    {
      "name": "screens",
      "description": "화면"
    },
    {
      "name": "diagnoses",
      "description": "진단"
    },
    {
      "name": "results",
      "description": "진단 결과"
    },
    {
      "name": "issues",
      "description": "개선 과제"
    },
    {
      "name": "labels",
      "description": "레이블"
    },
    {
      "name": "schedules",
      "description": "반복 진단 일정"
    },
    {
      "name": "members",
      "description": "구성원"
    },
    {
      "name": "tokens",
      "description": "API 토큰"
    }
  ],
  "paths": {
    "/api/projects/{projectId}/diagnosis-defaults": {
      "get": {
        "operationId": "projects.diagnosisDefaults.get",
        "summary": "진단 기본값(진단 실행 때 미리 골라 둘 뷰포트 · 기준). 저장한 적이 없으면 서버 기본값(PC · MOBILE, 다섯 기준 전부)",
        "tags": [
          "projects"
        ],
        "security": [
          {
            "bearer": [
              "projects:read"
            ]
          }
        ],
        "x-ableflow-scope": "projects:read",
        "x-ableflow-since": "1.0.0",
        "x-ableflow-personal-data": false,
        "x-ableflow-demo": true,
        "parameters": [
          {
            "name": "projectId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "AbleFlow-Version",
            "in": "header",
            "required": false,
            "description": "1.0.0 · v1.0.0 · 1.0 · 1. 없으면 토큰 고정 버전 → 최신",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "진단 기본값(진단 실행 때 미리 골라 둘 뷰포트 · 기준). 저장한 적이 없으면 서버 기본값(PC · MOBILE, 다섯 기준 전부)",
            "headers": {
              "AbleFlow-Version": {
                "description": "실제로 적용한 버전",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/GetDiagnosisDefaultsResponse"
                },
                "example": {
                  "criteria": [
                    "COLOR_DEPENDENCY",
                    "LOW_CONTRAST",
                    "INFORMATION_DENSITY"
                  ],
                  "isDefault": false,
                  "viewports": [
                    "PC",
                    "MOBILE"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "UNSUPPORTED_API_VERSION: AbleFlow-Version(또는 토큰 고정 버전)을 맞출 수 없다. detail { requested, supported }",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "401": {
            "description": "UNAUTHORIZED: Authorization 머리글이 없다(토큰 없음). 공개 API 요청으로 보지 않아 응답에 AbleFlow-Version 머리글이 없다\nINVALID_TOKEN: 토큰이 틀렸거나 폐기됐다(발급자가 워크스페이스를 나가 폐기된 토큰 포함)\nTOKEN_EXPIRED: 토큰이 만료됐다",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "403": {
            "description": "INSUFFICIENT_SCOPE: 토큰 범위가 모자란다. detail { required }\nDEMO_READ_ONLY: 데모 토큰은 GET · HEAD 만 부를 수 있다\nPLAN_FEATURE_REQUIRED: 워크스페이스 요금제에 공개 API 가 없거나 체험이 끝났다(요금제로 막을 때, 데모 토큰 제외). detail { target: PUBLIC_API, reason: PLAN_FEATURE | TRIAL_ENDED, suggestedPlan? }",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "404": {
            "description": "RESOURCE_NOT_FOUND: 자원이 없거나 토큰이 묶인 워크스페이스 밖이다",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "429": {
            "description": "API_RATE_LIMITED: 호출 한도를 넘었다. Retry-After(초)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          }
        }
      }
    },
    "/api/projects/{projectId}": {
      "get": {
        "operationId": "projects.get",
        "summary": "프로젝트 상세",
        "tags": [
          "projects"
        ],
        "security": [
          {
            "bearer": [
              "projects:read"
            ]
          }
        ],
        "x-ableflow-scope": "projects:read",
        "x-ableflow-since": "1.0.0",
        "x-ableflow-personal-data": false,
        "x-ableflow-demo": true,
        "parameters": [
          {
            "name": "projectId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "AbleFlow-Version",
            "in": "header",
            "required": false,
            "description": "1.0.0 · v1.0.0 · 1.0 · 1. 없으면 토큰 고정 버전 → 최신",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "프로젝트 상세",
            "headers": {
              "AbleFlow-Version": {
                "description": "실제로 적용한 버전",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/GetProjectResponse"
                },
                "example": {
                  "baseUrl": "https://example.ableflow.kr",
                  "createdAt": "2026-11-01T00:00:00Z",
                  "createdBy": "0af1de00-0000-4000-8000-0000000000aa",
                  "description": "컬러 니트 · 데님 · 신발까지 색이 다채로운 의류 온라인몰입니다. 구매 흐름 화면을 매주 점검합니다.",
                  "id": "0af1de00-0000-4000-8000-000000000101",
                  "latestDiagnosis": {
                    "analysisCount": 2,
                    "completedCount": 2,
                    "createdAt": "2026-11-09T01:00:00Z",
                    "finishedAt": "2026-11-09T01:02:30Z",
                    "grade": "CAUTION",
                    "id": "0af1de00-0000-4000-8000-000000000502",
                    "seq": 2,
                    "status": "COMPLETED",
                    "uxRiskScore": 31
                  },
                  "name": "에이블 몰 온라인몰",
                  "screenCount": 2,
                  "thumbnails": [
                    {
                      "captureImage": null,
                      "screenName": "메인",
                      "screenResultId": "0af1de00-0000-4000-8000-000000000603",
                      "viewport": "PC"
                    },
                    {
                      "captureImage": null,
                      "screenName": "장바구니",
                      "screenResultId": "0af1de00-0000-4000-8000-000000000604",
                      "viewport": "PC"
                    }
                  ],
                  "updatedAt": "2026-11-01T00:00:00Z",
                  "workspaceId": "0af1de00-0000-4000-8000-000000000001"
                }
              }
            }
          },
          "400": {
            "description": "UNSUPPORTED_API_VERSION: AbleFlow-Version(또는 토큰 고정 버전)을 맞출 수 없다. detail { requested, supported }",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "401": {
            "description": "UNAUTHORIZED: Authorization 머리글이 없다(토큰 없음). 공개 API 요청으로 보지 않아 응답에 AbleFlow-Version 머리글이 없다\nINVALID_TOKEN: 토큰이 틀렸거나 폐기됐다(발급자가 워크스페이스를 나가 폐기된 토큰 포함)\nTOKEN_EXPIRED: 토큰이 만료됐다",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "403": {
            "description": "INSUFFICIENT_SCOPE: 토큰 범위가 모자란다. detail { required }\nDEMO_READ_ONLY: 데모 토큰은 GET · HEAD 만 부를 수 있다\nPLAN_FEATURE_REQUIRED: 워크스페이스 요금제에 공개 API 가 없거나 체험이 끝났다(요금제로 막을 때, 데모 토큰 제외). detail { target: PUBLIC_API, reason: PLAN_FEATURE | TRIAL_ENDED, suggestedPlan? }",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "404": {
            "description": "RESOURCE_NOT_FOUND: 자원이 없거나 토큰이 묶인 워크스페이스 밖이다",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "429": {
            "description": "API_RATE_LIMITED: 호출 한도를 넘었다. Retry-After(초)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          }
        }
      }
    },
    "/api/workspaces/{workspaceId}/projects": {
      "get": {
        "operationId": "projects.list",
        "summary": "프로젝트 페이지 조회(기본 정렬: 만든 시각 최신순)",
        "tags": [
          "projects"
        ],
        "security": [
          {
            "bearer": [
              "projects:read"
            ]
          }
        ],
        "x-ableflow-scope": "projects:read",
        "x-ableflow-since": "1.0.0",
        "x-ableflow-personal-data": false,
        "x-ableflow-demo": true,
        "parameters": [
          {
            "name": "workspaceId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "시작 오프셋",
            "schema": {
              "type": "number"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "조회 개수",
            "schema": {
              "type": "number"
            }
          },
          {
            "name": "sort",
            "in": "query",
            "required": false,
            "description": "정렬 조건. 콤마로 구분하며 각 항목은 property 또는 property:ASC|DESC 형식",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "keyword",
            "in": "query",
            "required": false,
            "description": "이름 · 설명 · 기본 주소 검색어(대소문자 무시)",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "mine",
            "in": "query",
            "required": false,
            "description": "true 면 내가 만든 프로젝트만",
            "schema": {
              "type": "boolean"
            }
          },
          {
            "name": "AbleFlow-Version",
            "in": "header",
            "required": false,
            "description": "1.0.0 · v1.0.0 · 1.0 · 1. 없으면 토큰 고정 버전 → 최신",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "프로젝트 페이지 조회(기본 정렬: 만든 시각 최신순)",
            "headers": {
              "AbleFlow-Version": {
                "description": "실제로 적용한 버전",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/GetProjectPaginationResponse"
                },
                "example": {
                  "count": 2,
                  "prev": null,
                  "next": null,
                  "results": [
                    {
                      "baseUrl": "https://example.ableflow.kr/en",
                      "createdAt": "2026-11-01T00:00:30Z",
                      "createdBy": "0af1de00-0000-4000-8000-0000000000aa",
                      "description": "에이블 몰 영문 사이트입니다. 최근 회차에서 모바일 분석 하나가 시간 안에 끝나지 않았습니다.",
                      "id": "0af1de00-0000-4000-8000-000000000102",
                      "latestDiagnosis": {
                        "analysisCount": 2,
                        "completedCount": 2,
                        "createdAt": "2026-11-05T01:00:00Z",
                        "finishedAt": "2026-11-05T01:04:00Z",
                        "grade": "SAFE",
                        "id": "0af1de00-0000-4000-8000-000000000503",
                        "seq": 1,
                        "status": "PARTIAL",
                        "uxRiskScore": 22
                      },
                      "name": "에이블 몰 영문 사이트",
                      "screenCount": 1,
                      "thumbnails": [
                        {
                          "captureImage": null,
                          "screenName": "상품 목록",
                          "screenResultId": "0af1de00-0000-4000-8000-000000000605",
                          "viewport": "PC"
                        }
                      ],
                      "updatedAt": "2026-11-01T00:00:30Z"
                    },
                    {
                      "baseUrl": "https://example.ableflow.kr",
                      "createdAt": "2026-11-01T00:00:00Z",
                      "createdBy": "0af1de00-0000-4000-8000-0000000000aa",
                      "description": "컬러 니트 · 데님 · 신발까지 색이 다채로운 의류 온라인몰입니다. 구매 흐름 화면을 매주 점검합니다.",
                      "id": "0af1de00-0000-4000-8000-000000000101",
                      "latestDiagnosis": {
                        "analysisCount": 2,
                        "completedCount": 2,
                        "createdAt": "2026-11-09T01:00:00Z",
                        "finishedAt": "2026-11-09T01:02:30Z",
                        "grade": "CAUTION",
                        "id": "0af1de00-0000-4000-8000-000000000502",
                        "seq": 2,
                        "status": "COMPLETED",
                        "uxRiskScore": 31
                      },
                      "name": "에이블 몰 온라인몰",
                      "screenCount": 2,
                      "thumbnails": [
                        {
                          "captureImage": null,
                          "screenName": "메인",
                          "screenResultId": "0af1de00-0000-4000-8000-000000000603",
                          "viewport": "PC"
                        },
                        {
                          "captureImage": null,
                          "screenName": "장바구니",
                          "screenResultId": "0af1de00-0000-4000-8000-000000000604",
                          "viewport": "PC"
                        }
                      ],
                      "updatedAt": "2026-11-01T00:00:00Z"
                    }
                  ]
                }
              }
            }
          },
          "400": {
            "description": "UNSUPPORTED_API_VERSION: AbleFlow-Version(또는 토큰 고정 버전)을 맞출 수 없다. detail { requested, supported }",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "401": {
            "description": "UNAUTHORIZED: Authorization 머리글이 없다(토큰 없음). 공개 API 요청으로 보지 않아 응답에 AbleFlow-Version 머리글이 없다\nINVALID_TOKEN: 토큰이 틀렸거나 폐기됐다(발급자가 워크스페이스를 나가 폐기된 토큰 포함)\nTOKEN_EXPIRED: 토큰이 만료됐다",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "403": {
            "description": "INSUFFICIENT_SCOPE: 토큰 범위가 모자란다. detail { required }\nDEMO_READ_ONLY: 데모 토큰은 GET · HEAD 만 부를 수 있다\nPLAN_FEATURE_REQUIRED: 워크스페이스 요금제에 공개 API 가 없거나 체험이 끝났다(요금제로 막을 때, 데모 토큰 제외). detail { target: PUBLIC_API, reason: PLAN_FEATURE | TRIAL_ENDED, suggestedPlan? }",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "404": {
            "description": "RESOURCE_NOT_FOUND: 자원이 없거나 토큰이 묶인 워크스페이스 밖이다",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "429": {
            "description": "API_RATE_LIMITED: 호출 한도를 넘었다. Retry-After(초)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          }
        }
      }
    },
    "/api/screens/{screenId}": {
      "get": {
        "operationId": "screens.get",
        "summary": "화면 상세",
        "tags": [
          "screens"
        ],
        "security": [
          {
            "bearer": [
              "screens:read"
            ]
          }
        ],
        "x-ableflow-scope": "screens:read",
        "x-ableflow-since": "1.0.0",
        "x-ableflow-personal-data": false,
        "x-ableflow-demo": true,
        "parameters": [
          {
            "name": "screenId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "AbleFlow-Version",
            "in": "header",
            "required": false,
            "description": "1.0.0 · v1.0.0 · 1.0 · 1. 없으면 토큰 고정 버전 → 최신",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "화면 상세",
            "headers": {
              "AbleFlow-Version": {
                "description": "실제로 적용한 버전",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/GetScreenResponse"
                },
                "example": {
                  "createdAt": "2026-11-01T00:02:00Z",
                  "id": "0af1de00-0000-4000-8000-000000000302",
                  "labels": [
                    {
                      "color": "BLUE",
                      "id": "0af1de00-0000-4000-8000-000000000201",
                      "name": "구매 흐름",
                      "scope": "WORKSPACE"
                    }
                  ],
                  "name": "장바구니",
                  "priority": 2,
                  "projectId": "0af1de00-0000-4000-8000-000000000101",
                  "requiresAuth": false,
                  "source": "URL",
                  "updatedAt": "2026-11-01T00:02:00Z",
                  "url": "https://example.ableflow.kr/ko/cart",
                  "viewport": "BOTH"
                }
              }
            }
          },
          "400": {
            "description": "UNSUPPORTED_API_VERSION: AbleFlow-Version(또는 토큰 고정 버전)을 맞출 수 없다. detail { requested, supported }",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "401": {
            "description": "UNAUTHORIZED: Authorization 머리글이 없다(토큰 없음). 공개 API 요청으로 보지 않아 응답에 AbleFlow-Version 머리글이 없다\nINVALID_TOKEN: 토큰이 틀렸거나 폐기됐다(발급자가 워크스페이스를 나가 폐기된 토큰 포함)\nTOKEN_EXPIRED: 토큰이 만료됐다",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "403": {
            "description": "INSUFFICIENT_SCOPE: 토큰 범위가 모자란다. detail { required }\nDEMO_READ_ONLY: 데모 토큰은 GET · HEAD 만 부를 수 있다\nPLAN_FEATURE_REQUIRED: 워크스페이스 요금제에 공개 API 가 없거나 체험이 끝났다(요금제로 막을 때, 데모 토큰 제외). detail { target: PUBLIC_API, reason: PLAN_FEATURE | TRIAL_ENDED, suggestedPlan? }",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "404": {
            "description": "RESOURCE_NOT_FOUND: 자원이 없거나 토큰이 묶인 워크스페이스 밖이다",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "429": {
            "description": "API_RATE_LIMITED: 호출 한도를 넘었다. Retry-After(초)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          }
        }
      }
    },
    "/api/projects/{projectId}/screens": {
      "get": {
        "operationId": "screens.list",
        "summary": "화면 페이지 조회(기본 정렬: priority 오름차순 → 넣은 순). 파일 연결까지 끝난 화면만",
        "tags": [
          "screens"
        ],
        "security": [
          {
            "bearer": [
              "screens:read"
            ]
          }
        ],
        "x-ableflow-scope": "screens:read",
        "x-ableflow-since": "1.0.0",
        "x-ableflow-personal-data": false,
        "x-ableflow-demo": true,
        "parameters": [
          {
            "name": "projectId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "시작 오프셋",
            "schema": {
              "type": "number"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "조회 개수",
            "schema": {
              "type": "number"
            }
          },
          {
            "name": "sort",
            "in": "query",
            "required": false,
            "description": "정렬 조건. 콤마로 구분하며 각 항목은 property 또는 property:ASC|DESC 형식",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "keyword",
            "in": "query",
            "required": false,
            "description": "이름 · 주소 · 경로 검색어(대소문자 무시, 100자 이하)",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "labelIds",
            "in": "query",
            "required": false,
            "description": "콤마 구분. 하나라도 붙은 화면(OR)",
            "schema": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "style": "form",
            "explode": false
          },
          {
            "name": "unlabeled",
            "in": "query",
            "required": false,
            "description": "true 면 레이블 없는 화면만",
            "schema": {
              "type": "boolean"
            }
          },
          {
            "name": "source",
            "in": "query",
            "required": false,
            "description": "콤마 구분",
            "schema": {
              "type": "array",
              "items": {
                "$ref": "#/components/schemas/AbleflowScreenSource"
              }
            },
            "style": "form",
            "explode": false
          },
          {
            "name": "viewport",
            "in": "query",
            "required": false,
            "description": "PC 를 주면 PC · BOTH 화면",
            "schema": {
              "$ref": "#/components/schemas/AbleflowViewport"
            }
          },
          {
            "name": "AbleFlow-Version",
            "in": "header",
            "required": false,
            "description": "1.0.0 · v1.0.0 · 1.0 · 1. 없으면 토큰 고정 버전 → 최신",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "화면 페이지 조회(기본 정렬: priority 오름차순 → 넣은 순). 파일 연결까지 끝난 화면만",
            "headers": {
              "AbleFlow-Version": {
                "description": "실제로 적용한 버전",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/GetScreenPaginationResponse"
                },
                "example": {
                  "count": 2,
                  "prev": null,
                  "next": null,
                  "results": [
                    {
                      "createdAt": "2026-11-01T00:02:00Z",
                      "id": "0af1de00-0000-4000-8000-000000000301",
                      "labels": [],
                      "name": "메인",
                      "priority": 1,
                      "requiresAuth": false,
                      "source": "URL",
                      "updatedAt": "2026-11-01T00:02:00Z",
                      "url": "https://example.ableflow.kr/ko",
                      "viewport": "BOTH"
                    },
                    {
                      "createdAt": "2026-11-01T00:02:00Z",
                      "id": "0af1de00-0000-4000-8000-000000000302",
                      "labels": [
                        {
                          "color": "BLUE",
                          "id": "0af1de00-0000-4000-8000-000000000201",
                          "name": "구매 흐름",
                          "scope": "WORKSPACE"
                        }
                      ],
                      "name": "장바구니",
                      "priority": 2,
                      "requiresAuth": false,
                      "source": "URL",
                      "updatedAt": "2026-11-01T00:02:00Z",
                      "url": "https://example.ableflow.kr/ko/cart",
                      "viewport": "BOTH"
                    }
                  ]
                }
              }
            }
          },
          "400": {
            "description": "UNSUPPORTED_API_VERSION: AbleFlow-Version(또는 토큰 고정 버전)을 맞출 수 없다. detail { requested, supported }",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "401": {
            "description": "UNAUTHORIZED: Authorization 머리글이 없다(토큰 없음). 공개 API 요청으로 보지 않아 응답에 AbleFlow-Version 머리글이 없다\nINVALID_TOKEN: 토큰이 틀렸거나 폐기됐다(발급자가 워크스페이스를 나가 폐기된 토큰 포함)\nTOKEN_EXPIRED: 토큰이 만료됐다",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "403": {
            "description": "INSUFFICIENT_SCOPE: 토큰 범위가 모자란다. detail { required }\nDEMO_READ_ONLY: 데모 토큰은 GET · HEAD 만 부를 수 있다\nPLAN_FEATURE_REQUIRED: 워크스페이스 요금제에 공개 API 가 없거나 체험이 끝났다(요금제로 막을 때, 데모 토큰 제외). detail { target: PUBLIC_API, reason: PLAN_FEATURE | TRIAL_ENDED, suggestedPlan? }",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "404": {
            "description": "RESOURCE_NOT_FOUND: 자원이 없거나 토큰이 묶인 워크스페이스 밖이다",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "429": {
            "description": "API_RATE_LIMITED: 호출 한도를 넘었다. Retry-After(초)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          }
        }
      }
    },
    "/api/workspaces/{workspaceId}/diagnoses/counts": {
      "get": {
        "operationId": "diagnoses.counts",
        "summary": "진단 기록 필터 칩 숫자(상태별 · 프로젝트별 회차 수). 페이지 조회와 같은 필터에서 페이지 · status 만 뺀다",
        "tags": [
          "diagnoses"
        ],
        "security": [
          {
            "bearer": [
              "diagnoses:read"
            ]
          }
        ],
        "x-ableflow-scope": "diagnoses:read",
        "x-ableflow-since": "1.0.0",
        "x-ableflow-personal-data": false,
        "x-ableflow-demo": true,
        "parameters": [
          {
            "name": "workspaceId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "projectIds",
            "in": "query",
            "required": false,
            "description": "프로젝트 UUID(콤마 구분). 다른 워크스페이스 프로젝트는 그냥 걸리지 않는다",
            "schema": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "style": "form",
            "explode": false
          },
          {
            "name": "trigger",
            "in": "query",
            "required": false,
            "schema": {
              "type": "array",
              "items": {
                "$ref": "#/components/schemas/AbleflowDiagnosisTrigger"
              }
            },
            "style": "form",
            "explode": false
          },
          {
            "name": "from",
            "in": "query",
            "required": false,
            "description": "만든 시각 범위(ISO-8601, from 포함 · to 미포함)",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "to",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "requestedBy",
            "in": "query",
            "required": false,
            "description": "실행한 사람 memberId(콤마 구분)",
            "schema": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "style": "form",
            "explode": false
          },
          {
            "name": "AbleFlow-Version",
            "in": "header",
            "required": false,
            "description": "1.0.0 · v1.0.0 · 1.0 · 1. 없으면 토큰 고정 버전 → 최신",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "진단 기록 필터 칩 숫자(상태별 · 프로젝트별 회차 수). 페이지 조회와 같은 필터에서 페이지 · status 만 뺀다",
            "headers": {
              "AbleFlow-Version": {
                "description": "실제로 적용한 버전",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/GetWorkspaceDiagnosisCountsResponse"
                },
                "example": {
                  "byStatus": {
                    "QUEUED": 0,
                    "RUNNING": 0,
                    "COMPLETED": 2,
                    "PARTIAL": 1,
                    "FAILED": 0,
                    "CANCELED": 0
                  },
                  "byProject": [
                    {
                      "count": 2,
                      "projectId": "0af1de00-0000-4000-8000-000000000101",
                      "projectName": "에이블 몰 온라인몰"
                    },
                    {
                      "count": 1,
                      "projectId": "0af1de00-0000-4000-8000-000000000102",
                      "projectName": "에이블 몰 영문 사이트"
                    }
                  ],
                  "total": 3
                }
              }
            }
          },
          "400": {
            "description": "UNSUPPORTED_API_VERSION: AbleFlow-Version(또는 토큰 고정 버전)을 맞출 수 없다. detail { requested, supported }",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "401": {
            "description": "UNAUTHORIZED: Authorization 머리글이 없다(토큰 없음). 공개 API 요청으로 보지 않아 응답에 AbleFlow-Version 머리글이 없다\nINVALID_TOKEN: 토큰이 틀렸거나 폐기됐다(발급자가 워크스페이스를 나가 폐기된 토큰 포함)\nTOKEN_EXPIRED: 토큰이 만료됐다",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "403": {
            "description": "INSUFFICIENT_SCOPE: 토큰 범위가 모자란다. detail { required }\nDEMO_READ_ONLY: 데모 토큰은 GET · HEAD 만 부를 수 있다\nPLAN_FEATURE_REQUIRED: 워크스페이스 요금제에 공개 API 가 없거나 체험이 끝났다(요금제로 막을 때, 데모 토큰 제외). detail { target: PUBLIC_API, reason: PLAN_FEATURE | TRIAL_ENDED, suggestedPlan? }",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "404": {
            "description": "RESOURCE_NOT_FOUND: 자원이 없거나 토큰이 묶인 워크스페이스 밖이다",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "429": {
            "description": "API_RATE_LIMITED: 호출 한도를 넘었다. Retry-After(초)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          }
        }
      }
    },
    "/api/projects/{projectId}/diagnoses": {
      "post": {
        "operationId": "diagnoses.create",
        "summary": "진단 실행(회차 생성). 대상 = screenIds ∪ labelIds 로 고른 화면, 분석 = 화면마다 (화면 viewport ∩ viewports).",
        "description": "분석(ScreenResult)을 QUEUED 로 만들고 진단 일꾼이 가져간다. 201 + Location: /api/diagnoses/{id}",
        "tags": [
          "diagnoses"
        ],
        "security": [
          {
            "bearer": [
              "diagnoses:write"
            ]
          }
        ],
        "x-ableflow-scope": "diagnoses:write",
        "x-ableflow-since": "1.0.0",
        "x-ableflow-personal-data": false,
        "x-ableflow-demo": false,
        "parameters": [
          {
            "name": "projectId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "AbleFlow-Version",
            "in": "header",
            "required": false,
            "description": "1.0.0 · v1.0.0 · 1.0 · 1. 없으면 토큰 고정 버전 → 최신",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateDiagnosisRequestBody"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "진단 실행(회차 생성). 대상 = screenIds ∪ labelIds 로 고른 화면, 분석 = 화면마다 (화면 viewport ∩ viewports).",
            "headers": {
              "AbleFlow-Version": {
                "description": "실제로 적용한 버전",
                "schema": {
                  "type": "string"
                }
              },
              "Location": {
                "description": "만든 회차의 경로(/api/diagnoses/{diagnosisId})",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "UNSUPPORTED_API_VERSION: AbleFlow-Version(또는 토큰 고정 버전)을 맞출 수 없다. detail { requested, supported }\nVALIDATION_FAILED: 대상 화면이 0개\nBAD_REQUEST: 다른 프로젝트 화면 · 쓸 수 없는 레이블\nSCREEN_LIMIT_EXCEEDED: 한 회차 화면 수 초과",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "401": {
            "description": "UNAUTHORIZED: Authorization 머리글이 없다(토큰 없음). 공개 API 요청으로 보지 않아 응답에 AbleFlow-Version 머리글이 없다\nINVALID_TOKEN: 토큰이 틀렸거나 폐기됐다(발급자가 워크스페이스를 나가 폐기된 토큰 포함)\nTOKEN_EXPIRED: 토큰이 만료됐다",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "403": {
            "description": "INSUFFICIENT_SCOPE: 토큰 범위가 모자란다. detail { required }\nDEMO_READ_ONLY: 데모 토큰은 GET · HEAD 만 부를 수 있다\nPLAN_FEATURE_REQUIRED: 워크스페이스 요금제에 공개 API 가 없거나 체험이 끝났다(요금제로 막을 때, 데모 토큰 제외). detail { target: PUBLIC_API, reason: PLAN_FEATURE | TRIAL_ENDED, suggestedPlan? }\nWORKSPACE_SUSPENDED: 워크스페이스가 정지됐다(요금제로 막을 때). detail { target: NEW_DIAGNOSIS, reason: SUSPENDED }",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "404": {
            "description": "RESOURCE_NOT_FOUND: 자원이 없거나 토큰이 묶인 워크스페이스 밖이다",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "409": {
            "description": "DIAGNOSIS_ALREADY_RUNNING: 진행 중 회차가 있다\nPLAN_LIMIT_REACHED: 이번 기간 분석 수 + 이번 회차 분석 수, 또는 이번 기간 진단 회차 + 1 이 요금제 한도를 넘는다(요금제로 막을 때). detail { target: NEW_DIAGNOSIS, reason: LIMIT_REACHED, limitKey: monthlyAnalyses | monthlyDiagnoses, used, limit, requested, suggestedPlan? }",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "429": {
            "description": "API_RATE_LIMITED: 호출 한도를 넘었다. Retry-After(초)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          }
        }
      },
      "get": {
        "operationId": "diagnoses.list",
        "summary": "프로젝트 회차 이력 페이지 조회(기본 정렬: seq 내림차순)",
        "tags": [
          "diagnoses"
        ],
        "security": [
          {
            "bearer": [
              "diagnoses:read"
            ]
          }
        ],
        "x-ableflow-scope": "diagnoses:read",
        "x-ableflow-since": "1.0.0",
        "x-ableflow-personal-data": true,
        "x-ableflow-demo": true,
        "parameters": [
          {
            "name": "projectId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "시작 오프셋",
            "schema": {
              "type": "number"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "조회 개수",
            "schema": {
              "type": "number"
            }
          },
          {
            "name": "sort",
            "in": "query",
            "required": false,
            "description": "정렬 조건. 콤마로 구분하며 각 항목은 property 또는 property:ASC|DESC 형식",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "status",
            "in": "query",
            "required": false,
            "description": "콤마 구분",
            "schema": {
              "type": "array",
              "items": {
                "$ref": "#/components/schemas/AbleflowDiagnosisStatus"
              }
            },
            "style": "form",
            "explode": false
          },
          {
            "name": "trigger",
            "in": "query",
            "required": false,
            "schema": {
              "type": "array",
              "items": {
                "$ref": "#/components/schemas/AbleflowDiagnosisTrigger"
              }
            },
            "style": "form",
            "explode": false
          },
          {
            "name": "from",
            "in": "query",
            "required": false,
            "description": "만든 시각 범위(ISO-8601, from 포함 · to 미포함)",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "to",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "requestedBy",
            "in": "query",
            "required": false,
            "description": "실행한 사람 memberId(콤마 구분)",
            "schema": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "style": "form",
            "explode": false
          },
          {
            "name": "AbleFlow-Version",
            "in": "header",
            "required": false,
            "description": "1.0.0 · v1.0.0 · 1.0 · 1. 없으면 토큰 고정 버전 → 최신",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "프로젝트 회차 이력 페이지 조회(기본 정렬: seq 내림차순)",
            "headers": {
              "AbleFlow-Version": {
                "description": "실제로 적용한 버전",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/GetDiagnosisPaginationResponse"
                },
                "example": {
                  "count": 2,
                  "prev": null,
                  "next": null,
                  "results": [
                    {
                      "previousUxRiskScore": 48,
                      "requestedBy": {
                        "memberId": "0af1de00-0000-4000-8000-0000000000aa",
                        "name": "에이블 몰 운영팀"
                      },
                      "analysisCount": 2,
                      "completedCount": 2,
                      "createdAt": "2026-11-09T01:00:00Z",
                      "failedCount": 0,
                      "finishedAt": "2026-11-09T01:02:30Z",
                      "grade": "CAUTION",
                      "id": "0af1de00-0000-4000-8000-000000000502",
                      "screenCount": 2,
                      "seq": 2,
                      "startedAt": "2026-11-09T01:00:00Z",
                      "status": "COMPLETED",
                      "trigger": "MANUAL",
                      "uxRiskScore": 31
                    },
                    {
                      "requestedBy": {
                        "memberId": "0af1de00-0000-4000-8000-0000000000aa",
                        "name": "에이블 몰 운영팀"
                      },
                      "analysisCount": 2,
                      "completedCount": 2,
                      "createdAt": "2026-11-02T01:00:00Z",
                      "failedCount": 0,
                      "finishedAt": "2026-11-02T01:03:00Z",
                      "grade": "CAUTION",
                      "id": "0af1de00-0000-4000-8000-000000000501",
                      "screenCount": 2,
                      "seq": 1,
                      "startedAt": "2026-11-02T01:00:00Z",
                      "status": "COMPLETED",
                      "trigger": "MANUAL",
                      "uxRiskScore": 48
                    }
                  ]
                }
              }
            }
          },
          "400": {
            "description": "UNSUPPORTED_API_VERSION: AbleFlow-Version(또는 토큰 고정 버전)을 맞출 수 없다. detail { requested, supported }",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "401": {
            "description": "UNAUTHORIZED: Authorization 머리글이 없다(토큰 없음). 공개 API 요청으로 보지 않아 응답에 AbleFlow-Version 머리글이 없다\nINVALID_TOKEN: 토큰이 틀렸거나 폐기됐다(발급자가 워크스페이스를 나가 폐기된 토큰 포함)\nTOKEN_EXPIRED: 토큰이 만료됐다",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "403": {
            "description": "INSUFFICIENT_SCOPE: 토큰 범위가 모자란다. detail { required }\nDEMO_READ_ONLY: 데모 토큰은 GET · HEAD 만 부를 수 있다\nPLAN_FEATURE_REQUIRED: 워크스페이스 요금제에 공개 API 가 없거나 체험이 끝났다(요금제로 막을 때, 데모 토큰 제외). detail { target: PUBLIC_API, reason: PLAN_FEATURE | TRIAL_ENDED, suggestedPlan? }",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "404": {
            "description": "RESOURCE_NOT_FOUND: 자원이 없거나 토큰이 묶인 워크스페이스 밖이다",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "429": {
            "description": "API_RATE_LIMITED: 호출 한도를 넘었다. Retry-After(초)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          }
        }
      }
    },
    "/api/diagnoses/{diagnosisId}": {
      "get": {
        "operationId": "diagnoses.get",
        "summary": "회차 요약. 진행 중이면 분석 진행 화면, 끝나면 결과 대시보드가 쓴다",
        "tags": [
          "diagnoses"
        ],
        "security": [
          {
            "bearer": [
              "diagnoses:read"
            ]
          }
        ],
        "x-ableflow-scope": "diagnoses:read",
        "x-ableflow-since": "1.0.0",
        "x-ableflow-personal-data": true,
        "x-ableflow-demo": true,
        "parameters": [
          {
            "name": "diagnosisId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "AbleFlow-Version",
            "in": "header",
            "required": false,
            "description": "1.0.0 · v1.0.0 · 1.0 · 1. 없으면 토큰 고정 버전 → 최신",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "회차 요약. 진행 중이면 분석 진행 화면, 끝나면 결과 대시보드가 쓴다",
            "headers": {
              "AbleFlow-Version": {
                "description": "실제로 적용한 버전",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/GetDiagnosisResponse"
                },
                "example": {
                  "requestedBy": {
                    "memberId": "0af1de00-0000-4000-8000-0000000000aa",
                    "name": "에이블 몰 운영팀"
                  },
                  "analysisCount": 2,
                  "completedCount": 2,
                  "createdAt": "2026-11-02T01:00:00Z",
                  "criteria": [
                    "COLOR_DEPENDENCY",
                    "LOW_CONTRAST",
                    "INFORMATION_DENSITY"
                  ],
                  "failedCount": 0,
                  "findingCount": 3,
                  "finishedAt": "2026-11-02T01:03:00Z",
                  "id": "0af1de00-0000-4000-8000-000000000501",
                  "projectId": "0af1de00-0000-4000-8000-000000000101",
                  "scores": {
                    "grade": "CAUTION",
                    "criteria": [
                      {
                        "criterion": "COLOR_DEPENDENCY",
                        "findingCount": 1,
                        "score": 40
                      },
                      {
                        "criterion": "LOW_CONTRAST",
                        "findingCount": 2,
                        "score": 62
                      },
                      {
                        "criterion": "INFORMATION_DENSITY",
                        "findingCount": 0,
                        "score": 41
                      }
                    ],
                    "cognitionScore": 52,
                    "uxRiskScore": 48
                  },
                  "scoringVersion": "2026.11-r2",
                  "screenCount": 2,
                  "seq": 1,
                  "startedAt": "2026-11-02T01:00:00Z",
                  "status": "COMPLETED",
                  "trigger": "MANUAL",
                  "viewports": [
                    "PC"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "UNSUPPORTED_API_VERSION: AbleFlow-Version(또는 토큰 고정 버전)을 맞출 수 없다. detail { requested, supported }",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "401": {
            "description": "UNAUTHORIZED: Authorization 머리글이 없다(토큰 없음). 공개 API 요청으로 보지 않아 응답에 AbleFlow-Version 머리글이 없다\nINVALID_TOKEN: 토큰이 틀렸거나 폐기됐다(발급자가 워크스페이스를 나가 폐기된 토큰 포함)\nTOKEN_EXPIRED: 토큰이 만료됐다",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "403": {
            "description": "INSUFFICIENT_SCOPE: 토큰 범위가 모자란다. detail { required }\nDEMO_READ_ONLY: 데모 토큰은 GET · HEAD 만 부를 수 있다\nPLAN_FEATURE_REQUIRED: 워크스페이스 요금제에 공개 API 가 없거나 체험이 끝났다(요금제로 막을 때, 데모 토큰 제외). detail { target: PUBLIC_API, reason: PLAN_FEATURE | TRIAL_ENDED, suggestedPlan? }",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "404": {
            "description": "RESOURCE_NOT_FOUND: 자원이 없거나 토큰이 묶인 워크스페이스 밖이다",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "429": {
            "description": "API_RATE_LIMITED: 호출 한도를 넘었다. Retry-After(초)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          }
        }
      }
    },
    "/api/workspaces/{workspaceId}/diagnoses": {
      "get": {
        "operationId": "diagnoses.listByWorkspace",
        "summary": "진단 기록: 워크스페이스 전체 프로젝트의 회차 페이지 조회(기본 정렬: 만든 시각 최신순). 프로젝트를 조인해 읽는다(Diagnosis 에 workspaceId 를 두지 않음)",
        "tags": [
          "diagnoses"
        ],
        "security": [
          {
            "bearer": [
              "diagnoses:read"
            ]
          }
        ],
        "x-ableflow-scope": "diagnoses:read",
        "x-ableflow-since": "1.0.0",
        "x-ableflow-personal-data": true,
        "x-ableflow-demo": true,
        "parameters": [
          {
            "name": "workspaceId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "시작 오프셋",
            "schema": {
              "type": "number"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "조회 개수",
            "schema": {
              "type": "number"
            }
          },
          {
            "name": "sort",
            "in": "query",
            "required": false,
            "description": "정렬 조건. 콤마로 구분하며 각 항목은 property 또는 property:ASC|DESC 형식",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "projectIds",
            "in": "query",
            "required": false,
            "description": "프로젝트 UUID(콤마 구분). 다른 워크스페이스 프로젝트는 그냥 걸리지 않는다",
            "schema": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "style": "form",
            "explode": false
          },
          {
            "name": "status",
            "in": "query",
            "required": false,
            "description": "콤마 구분",
            "schema": {
              "type": "array",
              "items": {
                "$ref": "#/components/schemas/AbleflowDiagnosisStatus"
              }
            },
            "style": "form",
            "explode": false
          },
          {
            "name": "trigger",
            "in": "query",
            "required": false,
            "schema": {
              "type": "array",
              "items": {
                "$ref": "#/components/schemas/AbleflowDiagnosisTrigger"
              }
            },
            "style": "form",
            "explode": false
          },
          {
            "name": "from",
            "in": "query",
            "required": false,
            "description": "만든 시각 범위(ISO-8601, from 포함 · to 미포함)",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "to",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "requestedBy",
            "in": "query",
            "required": false,
            "description": "실행한 사람 memberId(콤마 구분)",
            "schema": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "style": "form",
            "explode": false
          },
          {
            "name": "AbleFlow-Version",
            "in": "header",
            "required": false,
            "description": "1.0.0 · v1.0.0 · 1.0 · 1. 없으면 토큰 고정 버전 → 최신",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "진단 기록: 워크스페이스 전체 프로젝트의 회차 페이지 조회(기본 정렬: 만든 시각 최신순). 프로젝트를 조인해 읽는다(Diagnosis 에 workspaceId 를 두지 않음)",
            "headers": {
              "AbleFlow-Version": {
                "description": "실제로 적용한 버전",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/GetWorkspaceDiagnosisPaginationResponse"
                },
                "example": {
                  "count": 3,
                  "prev": null,
                  "next": null,
                  "results": [
                    {
                      "previousUxRiskScore": 48,
                      "requestedBy": {
                        "memberId": "0af1de00-0000-4000-8000-0000000000aa",
                        "name": "에이블 몰 운영팀"
                      },
                      "analysisCount": 2,
                      "completedCount": 2,
                      "createdAt": "2026-11-09T01:00:00Z",
                      "failedCount": 0,
                      "finishedAt": "2026-11-09T01:02:30Z",
                      "grade": "CAUTION",
                      "id": "0af1de00-0000-4000-8000-000000000502",
                      "projectId": "0af1de00-0000-4000-8000-000000000101",
                      "projectName": "에이블 몰 온라인몰",
                      "screenCount": 2,
                      "seq": 2,
                      "startedAt": "2026-11-09T01:00:00Z",
                      "status": "COMPLETED",
                      "trigger": "MANUAL",
                      "uxRiskScore": 31
                    },
                    {
                      "requestedBy": {
                        "memberId": "0af1de00-0000-4000-8000-0000000000aa",
                        "name": "에이블 몰 운영팀"
                      },
                      "analysisCount": 2,
                      "completedCount": 2,
                      "createdAt": "2026-11-05T01:00:00Z",
                      "failedCount": 1,
                      "finishedAt": "2026-11-05T01:04:00Z",
                      "grade": "SAFE",
                      "id": "0af1de00-0000-4000-8000-000000000503",
                      "projectId": "0af1de00-0000-4000-8000-000000000102",
                      "projectName": "에이블 몰 영문 사이트",
                      "screenCount": 1,
                      "seq": 1,
                      "startedAt": "2026-11-05T01:00:00Z",
                      "status": "PARTIAL",
                      "trigger": "MANUAL",
                      "uxRiskScore": 22
                    },
                    {
                      "requestedBy": {
                        "memberId": "0af1de00-0000-4000-8000-0000000000aa",
                        "name": "에이블 몰 운영팀"
                      },
                      "analysisCount": 2,
                      "completedCount": 2,
                      "createdAt": "2026-11-02T01:00:00Z",
                      "failedCount": 0,
                      "finishedAt": "2026-11-02T01:03:00Z",
                      "grade": "CAUTION",
                      "id": "0af1de00-0000-4000-8000-000000000501",
                      "projectId": "0af1de00-0000-4000-8000-000000000101",
                      "projectName": "에이블 몰 온라인몰",
                      "screenCount": 2,
                      "seq": 1,
                      "startedAt": "2026-11-02T01:00:00Z",
                      "status": "COMPLETED",
                      "trigger": "MANUAL",
                      "uxRiskScore": 48
                    }
                  ]
                }
              }
            }
          },
          "400": {
            "description": "UNSUPPORTED_API_VERSION: AbleFlow-Version(또는 토큰 고정 버전)을 맞출 수 없다. detail { requested, supported }",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "401": {
            "description": "UNAUTHORIZED: Authorization 머리글이 없다(토큰 없음). 공개 API 요청으로 보지 않아 응답에 AbleFlow-Version 머리글이 없다\nINVALID_TOKEN: 토큰이 틀렸거나 폐기됐다(발급자가 워크스페이스를 나가 폐기된 토큰 포함)\nTOKEN_EXPIRED: 토큰이 만료됐다",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "403": {
            "description": "INSUFFICIENT_SCOPE: 토큰 범위가 모자란다. detail { required }\nDEMO_READ_ONLY: 데모 토큰은 GET · HEAD 만 부를 수 있다\nPLAN_FEATURE_REQUIRED: 워크스페이스 요금제에 공개 API 가 없거나 체험이 끝났다(요금제로 막을 때, 데모 토큰 제외). detail { target: PUBLIC_API, reason: PLAN_FEATURE | TRIAL_ENDED, suggestedPlan? }",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "404": {
            "description": "RESOURCE_NOT_FOUND: 자원이 없거나 토큰이 묶인 워크스페이스 밖이다",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "429": {
            "description": "API_RATE_LIMITED: 호출 한도를 넘었다. Retry-After(초)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          }
        }
      }
    },
    "/api/diagnoses/{diagnosisId}/progress": {
      "get": {
        "operationId": "diagnoses.progress",
        "summary": "화면별 진행 단계(폴링 3초 권장, 끝나면 멈춤). 창을 닫아도 서버에서 계속된다",
        "tags": [
          "diagnoses"
        ],
        "security": [
          {
            "bearer": [
              "diagnoses:read"
            ]
          }
        ],
        "x-ableflow-scope": "diagnoses:read",
        "x-ableflow-since": "1.0.0",
        "x-ableflow-personal-data": false,
        "x-ableflow-demo": true,
        "parameters": [
          {
            "name": "diagnosisId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "AbleFlow-Version",
            "in": "header",
            "required": false,
            "description": "1.0.0 · v1.0.0 · 1.0 · 1. 없으면 토큰 고정 버전 → 최신",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "화면별 진행 단계(폴링 3초 권장, 끝나면 멈춤). 창을 닫아도 서버에서 계속된다",
            "headers": {
              "AbleFlow-Version": {
                "description": "실제로 적용한 버전",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/GetDiagnosisProgressResponse"
                },
                "example": {
                  "analysisCount": 2,
                  "completedCount": 2,
                  "failedCount": 0,
                  "items": [
                    {
                      "topFinding": {
                        "criterion": "COLOR_DEPENDENCY",
                        "title": "링크가 색으로만 구분됩니다",
                        "titleKey": "linkColorOnly"
                      },
                      "screenId": "0af1de00-0000-4000-8000-000000000301",
                      "screenName": "메인",
                      "screenResultId": "0af1de00-0000-4000-8000-000000000601",
                      "source": "URL",
                      "status": "COMPLETED",
                      "url": "https://example.ableflow.kr/ko",
                      "uxRiskScore": 44,
                      "viewport": "PC"
                    },
                    {
                      "topFinding": {
                        "criterion": "LOW_CONTRAST",
                        "title": "글자 대비가 낮습니다(2.86:1)",
                        "titleKey": "textContrastLow",
                        "titleArgs": {
                          "ratio": "2.86"
                        }
                      },
                      "screenId": "0af1de00-0000-4000-8000-000000000302",
                      "screenName": "장바구니",
                      "screenResultId": "0af1de00-0000-4000-8000-000000000602",
                      "source": "URL",
                      "status": "COMPLETED",
                      "url": "https://example.ableflow.kr/ko/cart",
                      "uxRiskScore": 52,
                      "viewport": "PC"
                    }
                  ],
                  "status": "COMPLETED"
                }
              }
            }
          },
          "400": {
            "description": "UNSUPPORTED_API_VERSION: AbleFlow-Version(또는 토큰 고정 버전)을 맞출 수 없다. detail { requested, supported }",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "401": {
            "description": "UNAUTHORIZED: Authorization 머리글이 없다(토큰 없음). 공개 API 요청으로 보지 않아 응답에 AbleFlow-Version 머리글이 없다\nINVALID_TOKEN: 토큰이 틀렸거나 폐기됐다(발급자가 워크스페이스를 나가 폐기된 토큰 포함)\nTOKEN_EXPIRED: 토큰이 만료됐다",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "403": {
            "description": "INSUFFICIENT_SCOPE: 토큰 범위가 모자란다. detail { required }\nDEMO_READ_ONLY: 데모 토큰은 GET · HEAD 만 부를 수 있다\nPLAN_FEATURE_REQUIRED: 워크스페이스 요금제에 공개 API 가 없거나 체험이 끝났다(요금제로 막을 때, 데모 토큰 제외). detail { target: PUBLIC_API, reason: PLAN_FEATURE | TRIAL_ENDED, suggestedPlan? }",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "404": {
            "description": "RESOURCE_NOT_FOUND: 자원이 없거나 토큰이 묶인 워크스페이스 밖이다",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "429": {
            "description": "API_RATE_LIMITED: 호출 한도를 넘었다. Retry-After(초)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          }
        }
      }
    },
    "/api/diagnoses/{diagnosisId}/retry-failed": {
      "post": {
        "operationId": "diagnoses.retryFailed",
        "summary": "실패한 분석만 다시(같은 회차, seq 그대로). PARTIAL · FAILED 회차만. 권한은 실행과 같다(구성원 누구나). 204",
        "tags": [
          "diagnoses"
        ],
        "security": [
          {
            "bearer": [
              "diagnoses:write"
            ]
          }
        ],
        "x-ableflow-scope": "diagnoses:write",
        "x-ableflow-since": "1.0.0",
        "x-ableflow-personal-data": false,
        "x-ableflow-demo": false,
        "parameters": [
          {
            "name": "diagnosisId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "AbleFlow-Version",
            "in": "header",
            "required": false,
            "description": "1.0.0 · v1.0.0 · 1.0 · 1. 없으면 토큰 고정 버전 → 최신",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/RetryFailedDiagnosisRequestBody"
              }
            }
          }
        },
        "responses": {
          "204": {
            "description": "실패한 분석만 다시(같은 회차, seq 그대로). PARTIAL · FAILED 회차만. 권한은 실행과 같다(구성원 누구나). 204",
            "headers": {
              "AbleFlow-Version": {
                "description": "실제로 적용한 버전",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "UNSUPPORTED_API_VERSION: AbleFlow-Version(또는 토큰 고정 버전)을 맞출 수 없다. detail { requested, supported }",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "401": {
            "description": "UNAUTHORIZED: Authorization 머리글이 없다(토큰 없음). 공개 API 요청으로 보지 않아 응답에 AbleFlow-Version 머리글이 없다\nINVALID_TOKEN: 토큰이 틀렸거나 폐기됐다(발급자가 워크스페이스를 나가 폐기된 토큰 포함)\nTOKEN_EXPIRED: 토큰이 만료됐다",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "403": {
            "description": "INSUFFICIENT_SCOPE: 토큰 범위가 모자란다. detail { required }\nDEMO_READ_ONLY: 데모 토큰은 GET · HEAD 만 부를 수 있다\nPLAN_FEATURE_REQUIRED: 워크스페이스 요금제에 공개 API 가 없거나 체험이 끝났다(요금제로 막을 때, 데모 토큰 제외). detail { target: PUBLIC_API, reason: PLAN_FEATURE | TRIAL_ENDED, suggestedPlan? }",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "404": {
            "description": "RESOURCE_NOT_FOUND: 자원이 없거나 토큰이 묶인 워크스페이스 밖이다",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "409": {
            "description": "DIAGNOSIS_NOTHING_TO_RETRY: 다시 할 실패 분석이 없다\nDIAGNOSIS_ALREADY_RUNNING: 다른 진행 중 회차가 있다",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "429": {
            "description": "API_RATE_LIMITED: 호출 한도를 넘었다. Retry-After(초)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          }
        }
      }
    },
    "/api/diagnoses/compare": {
      "get": {
        "operationId": "diagnoses.compare",
        "summary": "두 회차 전후 비교. 같은 프로젝트의 끝난(COMPLETED · PARTIAL) 회차 아무 둘(회차 띠에서 기준 · 비교를 바꾼다, 순서 제한 없음).",
        "description": "위험도는 높을수록 위험이라 delta(target - base)가 음수면 좋아진 것이다",
        "tags": [
          "results"
        ],
        "security": [
          {
            "bearer": [
              "results:read"
            ]
          }
        ],
        "x-ableflow-scope": "results:read",
        "x-ableflow-since": "1.0.0",
        "x-ableflow-personal-data": false,
        "x-ableflow-demo": true,
        "parameters": [
          {
            "name": "base",
            "in": "query",
            "required": true,
            "description": "기준(앞) 회차 UUID",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "target",
            "in": "query",
            "required": true,
            "description": "비교(뒤) 회차 UUID",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "AbleFlow-Version",
            "in": "header",
            "required": false,
            "description": "1.0.0 · v1.0.0 · 1.0 · 1. 없으면 토큰 고정 버전 → 최신",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "두 회차 전후 비교. 같은 프로젝트의 끝난(COMPLETED · PARTIAL) 회차 아무 둘(회차 띠에서 기준 · 비교를 바꾼다, 순서 제한 없음).",
            "headers": {
              "AbleFlow-Version": {
                "description": "실제로 적용한 버전",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/GetDiagnosisCompareResponse"
                },
                "example": {
                  "base": {
                    "finishedAt": "2026-11-02T01:03:00Z",
                    "id": "0af1de00-0000-4000-8000-000000000501",
                    "scores": {
                      "grade": "CAUTION",
                      "criteria": [
                        {
                          "criterion": "COLOR_DEPENDENCY",
                          "findingCount": 1,
                          "score": 40
                        },
                        {
                          "criterion": "LOW_CONTRAST",
                          "findingCount": 2,
                          "score": 62
                        },
                        {
                          "criterion": "INFORMATION_DENSITY",
                          "findingCount": 0,
                          "score": 41
                        }
                      ],
                      "cognitionScore": 52,
                      "uxRiskScore": 48
                    },
                    "scoringVersion": "2026.11-r2",
                    "seq": 1
                  },
                  "target": {
                    "finishedAt": "2026-11-09T01:02:30Z",
                    "id": "0af1de00-0000-4000-8000-000000000502",
                    "scores": {
                      "grade": "CAUTION",
                      "criteria": [
                        {
                          "criterion": "COLOR_DEPENDENCY",
                          "findingCount": 0,
                          "score": 20
                        },
                        {
                          "criterion": "LOW_CONTRAST",
                          "findingCount": 1,
                          "score": 45
                        },
                        {
                          "criterion": "INFORMATION_DENSITY",
                          "findingCount": 0,
                          "score": 28
                        }
                      ],
                      "cognitionScore": 69,
                      "uxRiskScore": 31
                    },
                    "scoringVersion": "2026.11-r2",
                    "seq": 2
                  },
                  "criteria": [
                    {
                      "criterion": "COLOR_DEPENDENCY",
                      "baseScore": 40,
                      "delta": -20,
                      "targetScore": 20
                    },
                    {
                      "criterion": "LOW_CONTRAST",
                      "baseScore": 62,
                      "delta": -17,
                      "targetScore": 45
                    },
                    {
                      "criterion": "INFORMATION_DENSITY",
                      "baseScore": 41,
                      "delta": -13,
                      "targetScore": 28
                    }
                  ],
                  "findings": {
                    "added": 0,
                    "items": [
                      {
                        "change": "RESOLVED",
                        "baseFindingId": "0af1de00-0000-4000-8000-000000000702",
                        "baseSeverity": "HIGH",
                        "criterion": "LOW_CONTRAST",
                        "fingerprint": "e55c9705e283d92de45f6a027cbb9fede67120b410f27d2943853943bb7a3dce",
                        "screenId": "0af1de00-0000-4000-8000-000000000302",
                        "screenName": "장바구니",
                        "title": "글자 대비가 낮습니다(2.86:1)",
                        "titleArgs": {
                          "ratio": "2.86"
                        },
                        "titleKey": "textContrastLow",
                        "viewport": "PC",
                        "worsened": false
                      },
                      {
                        "change": "RESOLVED",
                        "baseFindingId": "0af1de00-0000-4000-8000-000000000701",
                        "baseSeverity": "MEDIUM",
                        "criterion": "COLOR_DEPENDENCY",
                        "fingerprint": "69913c1213330ed732503b54eece3ac4ecb51ef19516661bbc8e021de4202dff",
                        "screenId": "0af1de00-0000-4000-8000-000000000301",
                        "screenName": "메인",
                        "title": "링크가 색으로만 구분됩니다",
                        "titleKey": "linkColorOnly",
                        "viewport": "PC",
                        "worsened": false
                      },
                      {
                        "change": "REMAINING",
                        "baseFindingId": "0af1de00-0000-4000-8000-000000000703",
                        "baseSeverity": "MEDIUM",
                        "criterion": "LOW_CONTRAST",
                        "fingerprint": "09a8f432fb9acee9213611be299a45675f1988c5421b01db7dba4e85271187af",
                        "screenId": "0af1de00-0000-4000-8000-000000000302",
                        "screenName": "장바구니",
                        "targetFindingId": "0af1de00-0000-4000-8000-000000000704",
                        "targetSeverity": "MEDIUM",
                        "title": "글자 대비가 낮습니다(3.90:1)",
                        "titleArgs": {
                          "ratio": "3.90"
                        },
                        "titleKey": "textContrastLow",
                        "viewport": "PC",
                        "worsened": false
                      }
                    ],
                    "remaining": 1,
                    "resolved": 2,
                    "worsened": 0
                  },
                  "sameScoringVersion": true,
                  "screens": [
                    {
                      "change": "IMPROVED",
                      "baseScreenResultId": "0af1de00-0000-4000-8000-000000000601",
                      "baseUxRiskScore": 44,
                      "screenId": "0af1de00-0000-4000-8000-000000000301",
                      "screenName": "메인",
                      "targetScreenResultId": "0af1de00-0000-4000-8000-000000000603",
                      "targetUxRiskScore": 28,
                      "viewport": "PC"
                    },
                    {
                      "change": "IMPROVED",
                      "baseScreenResultId": "0af1de00-0000-4000-8000-000000000602",
                      "baseUxRiskScore": 52,
                      "screenId": "0af1de00-0000-4000-8000-000000000302",
                      "screenName": "장바구니",
                      "targetScreenResultId": "0af1de00-0000-4000-8000-000000000604",
                      "targetUxRiskScore": 34,
                      "viewport": "PC"
                    }
                  ]
                }
              }
            }
          },
          "400": {
            "description": "UNSUPPORTED_API_VERSION: AbleFlow-Version(또는 토큰 고정 버전)을 맞출 수 없다. detail { requested, supported }\nBAD_REQUEST: base · target 이 없거나 같거나 다른 프로젝트 회차",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "401": {
            "description": "UNAUTHORIZED: Authorization 머리글이 없다(토큰 없음). 공개 API 요청으로 보지 않아 응답에 AbleFlow-Version 머리글이 없다\nINVALID_TOKEN: 토큰이 틀렸거나 폐기됐다(발급자가 워크스페이스를 나가 폐기된 토큰 포함)\nTOKEN_EXPIRED: 토큰이 만료됐다",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "403": {
            "description": "INSUFFICIENT_SCOPE: 토큰 범위가 모자란다. detail { required }\nDEMO_READ_ONLY: 데모 토큰은 GET · HEAD 만 부를 수 있다\nPLAN_FEATURE_REQUIRED: 워크스페이스 요금제에 공개 API 가 없거나 체험이 끝났다(요금제로 막을 때, 데모 토큰 제외). detail { target: PUBLIC_API, reason: PLAN_FEATURE | TRIAL_ENDED, suggestedPlan? }\nPLAN_FEATURE_REQUIRED: 요금제에 전후 비교가 없거나 체험이 끝났다(요금제로 막을 때). detail { target: COMPARE, reason: PLAN_FEATURE | TRIAL_ENDED, suggestedPlan? }",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "404": {
            "description": "RESOURCE_NOT_FOUND: 자원이 없거나 토큰이 묶인 워크스페이스 밖이다",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "409": {
            "description": "DIAGNOSIS_NOT_FINISHED: 끝나지 않은 회차",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "429": {
            "description": "API_RATE_LIMITED: 호출 한도를 넘었다. Retry-After(초)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          }
        }
      }
    },
    "/api/diagnoses/{diagnosisId}/report": {
      "get": {
        "operationId": "diagnoses.report",
        "summary": "리포트 데이터(뷰어용 JSON, 한 번에 그리는 묶음). PDF 도 같은 데이터로 프론트 인쇄 페이지를 그린다.",
        "description": "끝난(COMPLETED · PARTIAL) 회차만. 구성원 누구나",
        "tags": [
          "results"
        ],
        "security": [
          {
            "bearer": [
              "results:read"
            ]
          }
        ],
        "x-ableflow-scope": "results:read",
        "x-ableflow-since": "1.0.0",
        "x-ableflow-personal-data": true,
        "x-ableflow-demo": true,
        "parameters": [
          {
            "name": "diagnosisId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "tier",
            "in": "query",
            "required": false,
            "description": "기본 SUMMARY. FULL 은 요금제로 막을 때 전체 리포트가 있는 요금제 · 건당 구매한 회차만(막지 않으면 누구나)",
            "schema": {
              "$ref": "#/components/schemas/AbleflowReportTier"
            }
          },
          {
            "name": "AbleFlow-Version",
            "in": "header",
            "required": false,
            "description": "1.0.0 · v1.0.0 · 1.0 · 1. 없으면 토큰 고정 버전 → 최신",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "리포트 데이터(뷰어용 JSON, 한 번에 그리는 묶음). PDF 도 같은 데이터로 프론트 인쇄 페이지를 그린다.",
            "headers": {
              "AbleFlow-Version": {
                "description": "실제로 적용한 버전",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/GetReportResponse"
                },
                "example": {
                  "appendix": {
                    "scoringVersion": "2026.11-r2",
                    "criteria": [
                      {
                        "criterion": "COLOR_DEPENDENCY"
                      },
                      {
                        "criterion": "LOW_CONTRAST"
                      },
                      {
                        "criterion": "INFORMATION_DENSITY"
                      }
                    ]
                  },
                  "diagnosis": {
                    "requestedBy": {
                      "memberId": "0af1de00-0000-4000-8000-0000000000aa",
                      "name": "에이블 몰 운영팀"
                    },
                    "criteria": [
                      "COLOR_DEPENDENCY",
                      "LOW_CONTRAST",
                      "INFORMATION_DENSITY"
                    ],
                    "finishedAt": "2026-11-02T01:03:00Z",
                    "id": "0af1de00-0000-4000-8000-000000000501",
                    "scoringVersion": "2026.11-r2",
                    "seq": 1,
                    "viewports": [
                      "PC"
                    ]
                  },
                  "findingCount": 3,
                  "priorities": [
                    {
                      "criterion": "LOW_CONTRAST",
                      "elementHint": "p.shipping-notice",
                      "findingIds": [
                        "0af1de00-0000-4000-8000-000000000702"
                      ],
                      "groupKey": "fa0b896ca379e1e8cdaa6ad89122eb824175de32be125a52f1a34c42dee7511c",
                      "impact": 26,
                      "rank": 1,
                      "screens": [
                        {
                          "screenName": "장바구니",
                          "screenResultId": "0af1de00-0000-4000-8000-000000000602",
                          "viewport": "PC"
                        }
                      ],
                      "severity": "HIGH",
                      "title": "글자 대비가 낮습니다(2.86:1)",
                      "titleArgs": {
                        "ratio": "2.86"
                      },
                      "titleKey": "textContrastLow"
                    },
                    {
                      "issue": {
                        "id": "0af1de00-0000-4000-8000-000000000802",
                        "status": "IN_PROGRESS"
                      },
                      "criterion": "LOW_CONTRAST",
                      "elementHint": "p.coupon-hint",
                      "findingIds": [
                        "0af1de00-0000-4000-8000-000000000703"
                      ],
                      "groupKey": "03dc34df4946dff6a52e56dda6bd5fc33ce1d06d106b8b31562b0751f887401f",
                      "impact": 26,
                      "rank": 2,
                      "screens": [
                        {
                          "screenName": "장바구니",
                          "screenResultId": "0af1de00-0000-4000-8000-000000000602",
                          "viewport": "PC"
                        }
                      ],
                      "severity": "MEDIUM",
                      "title": "글자 대비가 낮습니다(3.42:1)",
                      "titleArgs": {
                        "ratio": "3.42"
                      },
                      "titleKey": "textContrastLow"
                    },
                    {
                      "criterion": "COLOR_DEPENDENCY",
                      "elementHint": "a.event-more",
                      "findingIds": [
                        "0af1de00-0000-4000-8000-000000000701"
                      ],
                      "groupKey": "3bba2589e94a9a3d52a33d341e21346c233a3fc5d0a18a1f060ab441ce505a11",
                      "impact": 22,
                      "rank": 3,
                      "screens": [
                        {
                          "screenName": "메인",
                          "screenResultId": "0af1de00-0000-4000-8000-000000000601",
                          "viewport": "PC"
                        }
                      ],
                      "severity": "MEDIUM",
                      "title": "링크가 색으로만 구분됩니다",
                      "titleKey": "linkColorOnly"
                    }
                  ],
                  "project": {
                    "id": "0af1de00-0000-4000-8000-000000000101",
                    "name": "에이블 몰 온라인몰",
                    "baseUrl": "https://example.ableflow.kr"
                  },
                  "scores": {
                    "grade": "CAUTION",
                    "criteria": [
                      {
                        "criterion": "COLOR_DEPENDENCY",
                        "findingCount": 1,
                        "score": 40
                      },
                      {
                        "criterion": "LOW_CONTRAST",
                        "findingCount": 2,
                        "score": 62
                      },
                      {
                        "criterion": "INFORMATION_DENSITY",
                        "findingCount": 0,
                        "score": 41
                      }
                    ],
                    "cognitionScore": 52,
                    "uxRiskScore": 48
                  },
                  "screens": [
                    {
                      "findings": [
                        {
                          "criterion": "COLOR_DEPENDENCY",
                          "region": {
                            "x": 0.3969,
                            "y": 0.1482,
                            "width": 0.0718,
                            "height": 0.005
                          },
                          "severity": "MEDIUM",
                          "title": "링크가 색으로만 구분됩니다",
                          "titleKey": "linkColorOnly"
                        }
                      ],
                      "analysisPrecision": "DOM",
                      "scores": {
                        "grade": "CAUTION",
                        "criteria": [
                          {
                            "criterion": "COLOR_DEPENDENCY",
                            "findingCount": 1,
                            "score": 40
                          },
                          {
                            "criterion": "LOW_CONTRAST",
                            "findingCount": 0,
                            "score": 50
                          },
                          {
                            "criterion": "INFORMATION_DENSITY",
                            "findingCount": 0,
                            "score": 42
                          }
                        ],
                        "cognitionScore": 56,
                        "uxRiskScore": 44
                      },
                      "screenName": "메인",
                      "screenResultId": "0af1de00-0000-4000-8000-000000000601",
                      "url": "https://example.ableflow.kr/ko",
                      "viewport": "PC"
                    },
                    {
                      "findings": [
                        {
                          "criterion": "LOW_CONTRAST",
                          "region": {
                            "x": 0.1333,
                            "y": 0.4522,
                            "width": 0.43,
                            "height": 0.0133
                          },
                          "severity": "HIGH",
                          "title": "글자 대비가 낮습니다(2.86:1)",
                          "titleArgs": {
                            "ratio": "2.86"
                          },
                          "titleKey": "textContrastLow"
                        },
                        {
                          "criterion": "LOW_CONTRAST",
                          "region": {
                            "x": 0.5911,
                            "y": 0.3736,
                            "width": 0.2644,
                            "height": 0.0133
                          },
                          "severity": "MEDIUM",
                          "title": "글자 대비가 낮습니다(3.42:1)",
                          "titleArgs": {
                            "ratio": "3.42"
                          },
                          "titleKey": "textContrastLow"
                        }
                      ],
                      "analysisPrecision": "DOM",
                      "scores": {
                        "grade": "RISK",
                        "criteria": [
                          {
                            "criterion": "COLOR_DEPENDENCY",
                            "findingCount": 0,
                            "score": 40
                          },
                          {
                            "criterion": "LOW_CONTRAST",
                            "findingCount": 2,
                            "score": 74
                          },
                          {
                            "criterion": "INFORMATION_DENSITY",
                            "findingCount": 0,
                            "score": 40
                          }
                        ],
                        "cognitionScore": 48,
                        "uxRiskScore": 52
                      },
                      "screenName": "장바구니",
                      "screenResultId": "0af1de00-0000-4000-8000-000000000602",
                      "url": "https://example.ableflow.kr/ko/cart",
                      "viewport": "PC"
                    }
                  ],
                  "tier": "SUMMARY",
                  "workspaceName": "에이블 몰"
                }
              }
            }
          },
          "400": {
            "description": "UNSUPPORTED_API_VERSION: AbleFlow-Version(또는 토큰 고정 버전)을 맞출 수 없다. detail { requested, supported }",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "401": {
            "description": "UNAUTHORIZED: Authorization 머리글이 없다(토큰 없음). 공개 API 요청으로 보지 않아 응답에 AbleFlow-Version 머리글이 없다\nINVALID_TOKEN: 토큰이 틀렸거나 폐기됐다(발급자가 워크스페이스를 나가 폐기된 토큰 포함)\nTOKEN_EXPIRED: 토큰이 만료됐다",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "403": {
            "description": "INSUFFICIENT_SCOPE: 토큰 범위가 모자란다. detail { required }\nDEMO_READ_ONLY: 데모 토큰은 GET · HEAD 만 부를 수 있다\nPLAN_FEATURE_REQUIRED: 워크스페이스 요금제에 공개 API 가 없거나 체험이 끝났다(요금제로 막을 때, 데모 토큰 제외). detail { target: PUBLIC_API, reason: PLAN_FEATURE | TRIAL_ENDED, suggestedPlan? }\nPLAN_FEATURE_REQUIRED: tier=FULL 인데 요금제에 전체 리포트가 없거나 체험이 끝났다(요금제로 막을 때, 건당 구매한 회차는 열린다). detail { target: REPORT_FULL, reason: PLAN_FEATURE | TRIAL_ENDED, suggestedPlan? }",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "404": {
            "description": "RESOURCE_NOT_FOUND: 자원이 없거나 토큰이 묶인 워크스페이스 밖이다",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "409": {
            "description": "DIAGNOSIS_NOT_FINISHED: 끝나지 않은 회차",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "429": {
            "description": "API_RATE_LIMITED: 호출 한도를 넘었다. Retry-After(초)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          }
        }
      }
    },
    "/api/projects/{projectId}/diagnoses/trend": {
      "get": {
        "operationId": "diagnoses.trend",
        "summary": "회차별 위험도 추세(실제 끝난 COMPLETED · PARTIAL 회차만, 예측 없음). 오래된 순.",
        "description": "전체(uxRiskScore)와 기준별(criteria[].score) 점수를 한 점에 함께 둬 화면이 \"전체 · 기준별\" 보기 모드를 바꿔 그린다(새 요청 없이)",
        "tags": [
          "results"
        ],
        "security": [
          {
            "bearer": [
              "results:read"
            ]
          }
        ],
        "x-ableflow-scope": "results:read",
        "x-ableflow-since": "1.0.0",
        "x-ableflow-personal-data": false,
        "x-ableflow-demo": true,
        "parameters": [
          {
            "name": "projectId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "from",
            "in": "query",
            "required": false,
            "description": "만든 시각 범위(ISO-8601, from 포함 · to 미포함 — 진단 기록 목록과 같은 기준). 둘 다 없으면 최근 12회차, 있으면 최대 10000",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "to",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "trigger",
            "in": "query",
            "required": false,
            "description": "콤마 구분, 없으면 전부",
            "schema": {
              "type": "array",
              "items": {
                "$ref": "#/components/schemas/AbleflowDiagnosisTrigger"
              }
            },
            "style": "form",
            "explode": false
          },
          {
            "name": "AbleFlow-Version",
            "in": "header",
            "required": false,
            "description": "1.0.0 · v1.0.0 · 1.0 · 1. 없으면 토큰 고정 버전 → 최신",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "회차별 위험도 추세(실제 끝난 COMPLETED · PARTIAL 회차만, 예측 없음). 오래된 순.",
            "headers": {
              "AbleFlow-Version": {
                "description": "실제로 적용한 버전",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/GetDiagnosisTrendResponse"
                },
                "example": {
                  "points": [
                    {
                      "alerted": false,
                      "criteria": [
                        {
                          "score": 40,
                          "criterion": "COLOR_DEPENDENCY"
                        },
                        {
                          "score": 62,
                          "criterion": "LOW_CONTRAST"
                        },
                        {
                          "score": 41,
                          "criterion": "INFORMATION_DENSITY"
                        }
                      ],
                      "diagnosisId": "0af1de00-0000-4000-8000-000000000501",
                      "finishedAt": "2026-11-02T01:03:00Z",
                      "scoringVersion": "2026.11-r2",
                      "seq": 1,
                      "status": "COMPLETED",
                      "trigger": "MANUAL",
                      "uxRiskScore": 48
                    },
                    {
                      "alerted": false,
                      "criteria": [
                        {
                          "score": 20,
                          "criterion": "COLOR_DEPENDENCY"
                        },
                        {
                          "score": 45,
                          "criterion": "LOW_CONTRAST"
                        },
                        {
                          "score": 28,
                          "criterion": "INFORMATION_DENSITY"
                        }
                      ],
                      "diagnosisId": "0af1de00-0000-4000-8000-000000000502",
                      "finishedAt": "2026-11-09T01:02:30Z",
                      "scoringVersion": "2026.11-r2",
                      "seq": 2,
                      "status": "COMPLETED",
                      "trigger": "MANUAL",
                      "uxRiskScore": 31
                    }
                  ]
                }
              }
            }
          },
          "400": {
            "description": "UNSUPPORTED_API_VERSION: AbleFlow-Version(또는 토큰 고정 버전)을 맞출 수 없다. detail { requested, supported }\nBAD_REQUEST: 잘못된 시각 · 계기",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "401": {
            "description": "UNAUTHORIZED: Authorization 머리글이 없다(토큰 없음). 공개 API 요청으로 보지 않아 응답에 AbleFlow-Version 머리글이 없다\nINVALID_TOKEN: 토큰이 틀렸거나 폐기됐다(발급자가 워크스페이스를 나가 폐기된 토큰 포함)\nTOKEN_EXPIRED: 토큰이 만료됐다",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "403": {
            "description": "INSUFFICIENT_SCOPE: 토큰 범위가 모자란다. detail { required }\nDEMO_READ_ONLY: 데모 토큰은 GET · HEAD 만 부를 수 있다\nPLAN_FEATURE_REQUIRED: 워크스페이스 요금제에 공개 API 가 없거나 체험이 끝났다(요금제로 막을 때, 데모 토큰 제외). detail { target: PUBLIC_API, reason: PLAN_FEATURE | TRIAL_ENDED, suggestedPlan? }",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "404": {
            "description": "RESOURCE_NOT_FOUND: 자원이 없거나 토큰이 묶인 워크스페이스 밖이다",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "429": {
            "description": "API_RATE_LIMITED: 호출 한도를 넘었다. Retry-After(초)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          }
        }
      }
    },
    "/api/diagnoses/{diagnosisId}/findings": {
      "get": {
        "operationId": "findings.list",
        "summary": "회차의 위험 구간 페이지 조회(기본 정렬: 심각도 높은 순 → priorityRank). 진행 중 회차도 끝난 분석의 위험 구간은 보인다(순위 없이).",
        "description": "캡처 이미지 · 픽셀 크기는 GET /api/screen-results/{screenResultId}(captureImage · captureWidth · captureHeight)",
        "tags": [
          "results"
        ],
        "security": [
          {
            "bearer": [
              "results:read"
            ]
          }
        ],
        "x-ableflow-scope": "results:read",
        "x-ableflow-since": "1.0.0",
        "x-ableflow-personal-data": false,
        "x-ableflow-demo": true,
        "parameters": [
          {
            "name": "diagnosisId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "시작 오프셋",
            "schema": {
              "type": "number"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "조회 개수",
            "schema": {
              "type": "number"
            }
          },
          {
            "name": "sort",
            "in": "query",
            "required": false,
            "description": "정렬 조건. 콤마로 구분하며 각 항목은 property 또는 property:ASC|DESC 형식",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "screenResultId",
            "in": "query",
            "required": false,
            "description": "화면 결과 하나만(형식이 UUID 가 아니면 400)",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "criterion",
            "in": "query",
            "required": false,
            "description": "콤마 구분",
            "schema": {
              "type": "array",
              "items": {
                "$ref": "#/components/schemas/AbleflowCriterion"
              }
            },
            "style": "form",
            "explode": false
          },
          {
            "name": "severity",
            "in": "query",
            "required": false,
            "schema": {
              "type": "array",
              "items": {
                "$ref": "#/components/schemas/AbleflowSeverity"
              }
            },
            "style": "form",
            "explode": false
          },
          {
            "name": "AbleFlow-Version",
            "in": "header",
            "required": false,
            "description": "1.0.0 · v1.0.0 · 1.0 · 1. 없으면 토큰 고정 버전 → 최신",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "회차의 위험 구간 페이지 조회(기본 정렬: 심각도 높은 순 → priorityRank). 진행 중 회차도 끝난 분석의 위험 구간은 보인다(순위 없이).",
            "headers": {
              "AbleFlow-Version": {
                "description": "실제로 적용한 버전",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/GetFindingPaginationResponse"
                },
                "example": {
                  "count": 3,
                  "prev": null,
                  "next": null,
                  "results": [
                    {
                      "priorityRank": 1,
                      "alsoOn": [],
                      "criterion": "LOW_CONTRAST",
                      "elementHint": "p.shipping-notice",
                      "evidence": {
                        "actual": "2.86",
                        "expected": "4.5",
                        "metric": "contrastRatio",
                        "note": "글자 크기 15px · 굵기 700",
                        "noteArgs": {
                          "fontSize": 15,
                          "fontWeight": 700
                        },
                        "noteKey": "textContrastLowNote"
                      },
                      "fingerprint": "e55c9705e283d92de45f6a027cbb9fede67120b410f27d2943853943bb7a3dce",
                      "id": "0af1de00-0000-4000-8000-000000000702",
                      "region": {
                        "x": 0.1333,
                        "y": 0.4522,
                        "width": 0.43,
                        "height": 0.0133
                      },
                      "screenResultId": "0af1de00-0000-4000-8000-000000000602",
                      "severity": "HIGH",
                      "title": "글자 대비가 낮습니다(2.86:1)",
                      "titleArgs": {
                        "ratio": "2.86"
                      },
                      "titleKey": "textContrastLow"
                    },
                    {
                      "priorityRank": 2,
                      "alsoOn": [],
                      "criterion": "LOW_CONTRAST",
                      "elementHint": "p.coupon-hint",
                      "evidence": {
                        "actual": "3.42",
                        "expected": "4.5",
                        "metric": "contrastRatio",
                        "note": "글자 크기 13px · 굵기 400",
                        "noteArgs": {
                          "fontSize": 13,
                          "fontWeight": 400
                        },
                        "noteKey": "textContrastLowNote"
                      },
                      "fingerprint": "09a8f432fb9acee9213611be299a45675f1988c5421b01db7dba4e85271187af",
                      "id": "0af1de00-0000-4000-8000-000000000703",
                      "region": {
                        "x": 0.5911,
                        "y": 0.3736,
                        "width": 0.2644,
                        "height": 0.0133
                      },
                      "screenResultId": "0af1de00-0000-4000-8000-000000000602",
                      "severity": "MEDIUM",
                      "title": "글자 대비가 낮습니다(3.42:1)",
                      "titleArgs": {
                        "ratio": "3.42"
                      },
                      "titleKey": "textContrastLow"
                    },
                    {
                      "priorityRank": 3,
                      "alsoOn": [],
                      "criterion": "COLOR_DEPENDENCY",
                      "elementHint": "a.event-more",
                      "evidence": {
                        "actual": "1.21",
                        "expected": "3.0",
                        "metric": "linkTextContrast",
                        "note": "밑줄 · 굵기 등 색 말고 다른 표시가 없습니다",
                        "noteKey": "linkColorOnlyNote"
                      },
                      "fingerprint": "69913c1213330ed732503b54eece3ac4ecb51ef19516661bbc8e021de4202dff",
                      "id": "0af1de00-0000-4000-8000-000000000701",
                      "region": {
                        "x": 0.3969,
                        "y": 0.1482,
                        "width": 0.0718,
                        "height": 0.005
                      },
                      "screenResultId": "0af1de00-0000-4000-8000-000000000601",
                      "severity": "MEDIUM",
                      "title": "링크가 색으로만 구분됩니다",
                      "titleKey": "linkColorOnly"
                    }
                  ]
                }
              }
            }
          },
          "400": {
            "description": "UNSUPPORTED_API_VERSION: AbleFlow-Version(또는 토큰 고정 버전)을 맞출 수 없다. detail { requested, supported }",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "401": {
            "description": "UNAUTHORIZED: Authorization 머리글이 없다(토큰 없음). 공개 API 요청으로 보지 않아 응답에 AbleFlow-Version 머리글이 없다\nINVALID_TOKEN: 토큰이 틀렸거나 폐기됐다(발급자가 워크스페이스를 나가 폐기된 토큰 포함)\nTOKEN_EXPIRED: 토큰이 만료됐다",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "403": {
            "description": "INSUFFICIENT_SCOPE: 토큰 범위가 모자란다. detail { required }\nDEMO_READ_ONLY: 데모 토큰은 GET · HEAD 만 부를 수 있다\nPLAN_FEATURE_REQUIRED: 워크스페이스 요금제에 공개 API 가 없거나 체험이 끝났다(요금제로 막을 때, 데모 토큰 제외). detail { target: PUBLIC_API, reason: PLAN_FEATURE | TRIAL_ENDED, suggestedPlan? }",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "404": {
            "description": "RESOURCE_NOT_FOUND: 자원이 없거나 토큰이 묶인 워크스페이스 밖이다",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "429": {
            "description": "API_RATE_LIMITED: 호출 한도를 넘었다. Retry-After(초)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          }
        }
      }
    },
    "/api/diagnoses/{diagnosisId}/priorities/list": {
      "get": {
        "operationId": "priorities.list",
        "summary": "개선 우선순위: 위험 구간을 같은 문제(groupKey)로 묶은 개선 항목(페이지 없음, rank 순). 결과 대시보드 \"먼저 고칠 것\"은 limit 3.",
        "description": "저장하지 않고 읽을 때 계산한다. 끝난(COMPLETED · PARTIAL) 회차만",
        "tags": [
          "results"
        ],
        "security": [
          {
            "bearer": [
              "results:read"
            ]
          }
        ],
        "x-ableflow-scope": "results:read",
        "x-ableflow-since": "1.0.0",
        "x-ableflow-personal-data": true,
        "x-ableflow-demo": true,
        "parameters": [
          {
            "name": "diagnosisId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "위에서 몇 개(없으면 전부, 1~10000, 공통 목록 상한)",
            "schema": {
              "type": "number"
            }
          },
          {
            "name": "labelIds",
            "in": "query",
            "required": false,
            "description": "레이블 범위(콤마 구분, OR). 영향 화면 중 하나라도 그 레이블이 붙은 묶음만",
            "schema": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "style": "form",
            "explode": false
          },
          {
            "name": "AbleFlow-Version",
            "in": "header",
            "required": false,
            "description": "1.0.0 · v1.0.0 · 1.0 · 1. 없으면 토큰 고정 버전 → 최신",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "개선 우선순위: 위험 구간을 같은 문제(groupKey)로 묶은 개선 항목(페이지 없음, rank 순). 결과 대시보드 \"먼저 고칠 것\"은 limit 3.",
            "headers": {
              "AbleFlow-Version": {
                "description": "실제로 적용한 버전",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/GetPrioritiesResponse"
                },
                "example": [
                  {
                    "criterion": "LOW_CONTRAST",
                    "elementHint": "p.shipping-notice",
                    "findingIds": [
                      "0af1de00-0000-4000-8000-000000000702"
                    ],
                    "groupKey": "fa0b896ca379e1e8cdaa6ad89122eb824175de32be125a52f1a34c42dee7511c",
                    "impact": 26,
                    "rank": 1,
                    "screens": [
                      {
                        "screenName": "장바구니",
                        "screenResultId": "0af1de00-0000-4000-8000-000000000602",
                        "viewport": "PC"
                      }
                    ],
                    "severity": "HIGH",
                    "title": "글자 대비가 낮습니다(2.86:1)",
                    "titleArgs": {
                      "ratio": "2.86"
                    },
                    "titleKey": "textContrastLow"
                  },
                  {
                    "issue": {
                      "id": "0af1de00-0000-4000-8000-000000000802",
                      "status": "IN_PROGRESS"
                    },
                    "criterion": "LOW_CONTRAST",
                    "elementHint": "p.coupon-hint",
                    "findingIds": [
                      "0af1de00-0000-4000-8000-000000000703"
                    ],
                    "groupKey": "03dc34df4946dff6a52e56dda6bd5fc33ce1d06d106b8b31562b0751f887401f",
                    "impact": 26,
                    "rank": 2,
                    "screens": [
                      {
                        "screenName": "장바구니",
                        "screenResultId": "0af1de00-0000-4000-8000-000000000602",
                        "viewport": "PC"
                      }
                    ],
                    "severity": "MEDIUM",
                    "title": "글자 대비가 낮습니다(3.42:1)",
                    "titleArgs": {
                      "ratio": "3.42"
                    },
                    "titleKey": "textContrastLow"
                  },
                  {
                    "criterion": "COLOR_DEPENDENCY",
                    "elementHint": "a.event-more",
                    "findingIds": [
                      "0af1de00-0000-4000-8000-000000000701"
                    ],
                    "groupKey": "3bba2589e94a9a3d52a33d341e21346c233a3fc5d0a18a1f060ab441ce505a11",
                    "impact": 22,
                    "rank": 3,
                    "screens": [
                      {
                        "screenName": "메인",
                        "screenResultId": "0af1de00-0000-4000-8000-000000000601",
                        "viewport": "PC"
                      }
                    ],
                    "severity": "MEDIUM",
                    "title": "링크가 색으로만 구분됩니다",
                    "titleKey": "linkColorOnly"
                  }
                ]
              }
            }
          },
          "400": {
            "description": "UNSUPPORTED_API_VERSION: AbleFlow-Version(또는 토큰 고정 버전)을 맞출 수 없다. detail { requested, supported }",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "401": {
            "description": "UNAUTHORIZED: Authorization 머리글이 없다(토큰 없음). 공개 API 요청으로 보지 않아 응답에 AbleFlow-Version 머리글이 없다\nINVALID_TOKEN: 토큰이 틀렸거나 폐기됐다(발급자가 워크스페이스를 나가 폐기된 토큰 포함)\nTOKEN_EXPIRED: 토큰이 만료됐다",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "403": {
            "description": "INSUFFICIENT_SCOPE: 토큰 범위가 모자란다. detail { required }\nDEMO_READ_ONLY: 데모 토큰은 GET · HEAD 만 부를 수 있다\nPLAN_FEATURE_REQUIRED: 워크스페이스 요금제에 공개 API 가 없거나 체험이 끝났다(요금제로 막을 때, 데모 토큰 제외). detail { target: PUBLIC_API, reason: PLAN_FEATURE | TRIAL_ENDED, suggestedPlan? }",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "404": {
            "description": "RESOURCE_NOT_FOUND: 자원이 없거나 토큰이 묶인 워크스페이스 밖이다",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "409": {
            "description": "DIAGNOSIS_NOT_FINISHED: 끝나지 않은 회차",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "429": {
            "description": "API_RATE_LIMITED: 호출 한도를 넘었다. Retry-After(초)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          }
        }
      }
    },
    "/api/screen-results/{screenResultId}": {
      "get": {
        "operationId": "screenResults.get",
        "summary": "화면 결과 하나(위험 구간 상세의 스크린샷 · 크기). 위험 구간 목록은 findings(3b)",
        "tags": [
          "results"
        ],
        "security": [
          {
            "bearer": [
              "results:read"
            ]
          }
        ],
        "x-ableflow-scope": "results:read",
        "x-ableflow-since": "1.0.0",
        "x-ableflow-personal-data": false,
        "x-ableflow-demo": true,
        "parameters": [
          {
            "name": "screenResultId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "AbleFlow-Version",
            "in": "header",
            "required": false,
            "description": "1.0.0 · v1.0.0 · 1.0 · 1. 없으면 토큰 고정 버전 → 최신",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "화면 결과 하나(위험 구간 상세의 스크린샷 · 크기). 위험 구간 목록은 findings(3b)",
            "headers": {
              "AbleFlow-Version": {
                "description": "실제로 적용한 버전",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/GetScreenResultResponse"
                },
                "example": {
                  "analysisPrecision": "DOM",
                  "captureHeight": 1349,
                  "captureWidth": 1440,
                  "capturedAt": "2026-11-02T01:02:00Z",
                  "diagnosisId": "0af1de00-0000-4000-8000-000000000501",
                  "findingCount": 2,
                  "id": "0af1de00-0000-4000-8000-000000000602",
                  "labels": [
                    {
                      "color": "BLUE",
                      "id": "0af1de00-0000-4000-8000-000000000201",
                      "name": "구매 흐름",
                      "scope": "WORKSPACE"
                    }
                  ],
                  "scores": {
                    "grade": "RISK",
                    "criteria": [
                      {
                        "criterion": "COLOR_DEPENDENCY",
                        "findingCount": 0,
                        "score": 40
                      },
                      {
                        "criterion": "LOW_CONTRAST",
                        "findingCount": 2,
                        "score": 74
                      },
                      {
                        "criterion": "INFORMATION_DENSITY",
                        "findingCount": 0,
                        "score": 40
                      }
                    ],
                    "cognitionScore": 48,
                    "uxRiskScore": 52
                  },
                  "screenDeleted": false,
                  "screenId": "0af1de00-0000-4000-8000-000000000302",
                  "screenName": "장바구니",
                  "source": "URL",
                  "status": "COMPLETED",
                  "url": "https://example.ableflow.kr/ko/cart",
                  "viewport": "PC"
                }
              }
            }
          },
          "400": {
            "description": "UNSUPPORTED_API_VERSION: AbleFlow-Version(또는 토큰 고정 버전)을 맞출 수 없다. detail { requested, supported }",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "401": {
            "description": "UNAUTHORIZED: Authorization 머리글이 없다(토큰 없음). 공개 API 요청으로 보지 않아 응답에 AbleFlow-Version 머리글이 없다\nINVALID_TOKEN: 토큰이 틀렸거나 폐기됐다(발급자가 워크스페이스를 나가 폐기된 토큰 포함)\nTOKEN_EXPIRED: 토큰이 만료됐다",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "403": {
            "description": "INSUFFICIENT_SCOPE: 토큰 범위가 모자란다. detail { required }\nDEMO_READ_ONLY: 데모 토큰은 GET · HEAD 만 부를 수 있다\nPLAN_FEATURE_REQUIRED: 워크스페이스 요금제에 공개 API 가 없거나 체험이 끝났다(요금제로 막을 때, 데모 토큰 제외). detail { target: PUBLIC_API, reason: PLAN_FEATURE | TRIAL_ENDED, suggestedPlan? }",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "404": {
            "description": "RESOURCE_NOT_FOUND: 자원이 없거나 토큰이 묶인 워크스페이스 밖이다",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "429": {
            "description": "API_RATE_LIMITED: 호출 한도를 넘었다. Retry-After(초)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          }
        }
      }
    },
    "/api/diagnoses/{diagnosisId}/screen-results/list": {
      "get": {
        "operationId": "screenResults.list",
        "summary": "회차의 화면별 결과 전체(페이지 없음, 한 회차 분석 수가 한도 안이라)",
        "tags": [
          "results"
        ],
        "security": [
          {
            "bearer": [
              "results:read"
            ]
          }
        ],
        "x-ableflow-scope": "results:read",
        "x-ableflow-since": "1.0.0",
        "x-ableflow-personal-data": false,
        "x-ableflow-demo": true,
        "parameters": [
          {
            "name": "diagnosisId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "labelIds",
            "in": "query",
            "required": false,
            "description": "레이블 범위(콤마, OR. 지금 화면에 붙은 레이블 기준)",
            "schema": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "style": "form",
            "explode": false
          },
          {
            "name": "viewport",
            "in": "query",
            "required": false,
            "schema": {
              "$ref": "#/components/schemas/AbleflowViewport"
            }
          },
          {
            "name": "status",
            "in": "query",
            "required": false,
            "description": "콤마 구분",
            "schema": {
              "type": "array",
              "items": {
                "$ref": "#/components/schemas/AbleflowScreenResultStatus"
              }
            },
            "style": "form",
            "explode": false
          },
          {
            "name": "sort",
            "in": "query",
            "required": false,
            "description": "uxRiskScore:DESC(기본, 점수 없는 분석은 뒤) · priority:ASC(프로젝트 화면 순서)",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "AbleFlow-Version",
            "in": "header",
            "required": false,
            "description": "1.0.0 · v1.0.0 · 1.0 · 1. 없으면 토큰 고정 버전 → 최신",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "회차의 화면별 결과 전체(페이지 없음, 한 회차 분석 수가 한도 안이라)",
            "headers": {
              "AbleFlow-Version": {
                "description": "실제로 적용한 버전",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/GetScreenResultsResponse"
                },
                "example": [
                  {
                    "analysisPrecision": "DOM",
                    "findingCount": 2,
                    "id": "0af1de00-0000-4000-8000-000000000602",
                    "labels": [
                      {
                        "color": "BLUE",
                        "id": "0af1de00-0000-4000-8000-000000000201",
                        "name": "구매 흐름",
                        "scope": "WORKSPACE"
                      }
                    ],
                    "scores": {
                      "grade": "RISK",
                      "criteria": [
                        {
                          "criterion": "COLOR_DEPENDENCY",
                          "findingCount": 0,
                          "score": 40
                        },
                        {
                          "criterion": "LOW_CONTRAST",
                          "findingCount": 2,
                          "score": 74
                        },
                        {
                          "criterion": "INFORMATION_DENSITY",
                          "findingCount": 0,
                          "score": 40
                        }
                      ],
                      "cognitionScore": 48,
                      "uxRiskScore": 52
                    },
                    "screenDeleted": false,
                    "screenId": "0af1de00-0000-4000-8000-000000000302",
                    "screenName": "장바구니",
                    "source": "URL",
                    "status": "COMPLETED",
                    "url": "https://example.ableflow.kr/ko/cart",
                    "viewport": "PC"
                  },
                  {
                    "analysisPrecision": "DOM",
                    "findingCount": 1,
                    "id": "0af1de00-0000-4000-8000-000000000601",
                    "labels": [],
                    "scores": {
                      "grade": "CAUTION",
                      "criteria": [
                        {
                          "criterion": "COLOR_DEPENDENCY",
                          "findingCount": 1,
                          "score": 40
                        },
                        {
                          "criterion": "LOW_CONTRAST",
                          "findingCount": 0,
                          "score": 50
                        },
                        {
                          "criterion": "INFORMATION_DENSITY",
                          "findingCount": 0,
                          "score": 42
                        }
                      ],
                      "cognitionScore": 56,
                      "uxRiskScore": 44
                    },
                    "screenDeleted": false,
                    "screenId": "0af1de00-0000-4000-8000-000000000301",
                    "screenName": "메인",
                    "source": "URL",
                    "status": "COMPLETED",
                    "url": "https://example.ableflow.kr/ko",
                    "viewport": "PC"
                  }
                ]
              }
            }
          },
          "400": {
            "description": "UNSUPPORTED_API_VERSION: AbleFlow-Version(또는 토큰 고정 버전)을 맞출 수 없다. detail { requested, supported }",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "401": {
            "description": "UNAUTHORIZED: Authorization 머리글이 없다(토큰 없음). 공개 API 요청으로 보지 않아 응답에 AbleFlow-Version 머리글이 없다\nINVALID_TOKEN: 토큰이 틀렸거나 폐기됐다(발급자가 워크스페이스를 나가 폐기된 토큰 포함)\nTOKEN_EXPIRED: 토큰이 만료됐다",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "403": {
            "description": "INSUFFICIENT_SCOPE: 토큰 범위가 모자란다. detail { required }\nDEMO_READ_ONLY: 데모 토큰은 GET · HEAD 만 부를 수 있다\nPLAN_FEATURE_REQUIRED: 워크스페이스 요금제에 공개 API 가 없거나 체험이 끝났다(요금제로 막을 때, 데모 토큰 제외). detail { target: PUBLIC_API, reason: PLAN_FEATURE | TRIAL_ENDED, suggestedPlan? }",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "404": {
            "description": "RESOURCE_NOT_FOUND: 자원이 없거나 토큰이 묶인 워크스페이스 밖이다",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "429": {
            "description": "API_RATE_LIMITED: 호출 한도를 넘었다. Retry-After(초)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          }
        }
      }
    },
    "/api/workspaces/{workspaceId}/issues/counts": {
      "get": {
        "operationId": "issues.counts",
        "summary": "과제 상태 탭 숫자. 페이지 조회와 같은 필터에서 페이지 · status 만 뺀다",
        "tags": [
          "issues"
        ],
        "security": [
          {
            "bearer": [
              "issues:read"
            ]
          }
        ],
        "x-ableflow-scope": "issues:read",
        "x-ableflow-since": "1.0.0",
        "x-ableflow-personal-data": false,
        "x-ableflow-demo": true,
        "parameters": [
          {
            "name": "workspaceId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "keyword",
            "in": "query",
            "required": false,
            "description": "제목 검색어(대소문자 무시). 한국어 원문 제목과 요청 언어(?locale= en · ja · zh-CN · zh-Hant)의 AI 제목 번역에서 찾는다(OR)",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "titleKeys",
            "in": "query",
            "required": false,
            "description": "제목 문구 키(콤마 구분, 예: textContrastLow — 키 목록은 AbleflowFindingMessageArgs 설명). keyword 와 함께 오면 제목에 keyword 가 들어 있거나 제목 문구 키가 이 중 하나인 과제(OR).\n규칙 제목 원문은 한국어라 다른 언어 화면의 검색어는 원문에 없다 — 화면 언어 메시지에서 검색어가 들어간 키를 찾아 같이 보낸다\n(AI 제목은 서버가 요청 언어 번역에서 찾는다). 모르는 키는 무시한다(형식이 틀리면 400)",
            "schema": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "style": "form",
            "explode": false
          },
          {
            "name": "projectIds",
            "in": "query",
            "required": false,
            "description": "콤마 구분",
            "schema": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "style": "form",
            "explode": false
          },
          {
            "name": "criterion",
            "in": "query",
            "required": false,
            "schema": {
              "type": "array",
              "items": {
                "$ref": "#/components/schemas/AbleflowCriterion"
              }
            },
            "style": "form",
            "explode": false
          },
          {
            "name": "severity",
            "in": "query",
            "required": false,
            "schema": {
              "type": "array",
              "items": {
                "$ref": "#/components/schemas/AbleflowSeverity"
              }
            },
            "style": "form",
            "explode": false
          },
          {
            "name": "assignee",
            "in": "query",
            "required": false,
            "description": "담당 memberId(콤마 구분) · \"me\" 는 나 · \"none\" 은 담당 없음. 그 밖의 값은 400",
            "schema": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "style": "form",
            "explode": false
          },
          {
            "name": "AbleFlow-Version",
            "in": "header",
            "required": false,
            "description": "1.0.0 · v1.0.0 · 1.0 · 1. 없으면 토큰 고정 버전 → 최신",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "과제 상태 탭 숫자. 페이지 조회와 같은 필터에서 페이지 · status 만 뺀다",
            "headers": {
              "AbleFlow-Version": {
                "description": "실제로 적용한 버전",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/GetIssueCountsResponse"
                },
                "example": {
                  "byStatus": {
                    "TODO": 0,
                    "IN_PROGRESS": 1,
                    "IN_REVIEW": 0,
                    "DONE": 1,
                    "ON_HOLD": 0,
                    "DISMISSED": 0
                  },
                  "total": 2
                }
              }
            }
          },
          "400": {
            "description": "UNSUPPORTED_API_VERSION: AbleFlow-Version(또는 토큰 고정 버전)을 맞출 수 없다. detail { requested, supported }",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "401": {
            "description": "UNAUTHORIZED: Authorization 머리글이 없다(토큰 없음). 공개 API 요청으로 보지 않아 응답에 AbleFlow-Version 머리글이 없다\nINVALID_TOKEN: 토큰이 틀렸거나 폐기됐다(발급자가 워크스페이스를 나가 폐기된 토큰 포함)\nTOKEN_EXPIRED: 토큰이 만료됐다",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "403": {
            "description": "INSUFFICIENT_SCOPE: 토큰 범위가 모자란다. detail { required }\nDEMO_READ_ONLY: 데모 토큰은 GET · HEAD 만 부를 수 있다\nPLAN_FEATURE_REQUIRED: 워크스페이스 요금제에 공개 API 가 없거나 체험이 끝났다(요금제로 막을 때, 데모 토큰 제외). detail { target: PUBLIC_API, reason: PLAN_FEATURE | TRIAL_ENDED, suggestedPlan? }",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "404": {
            "description": "RESOURCE_NOT_FOUND: 자원이 없거나 토큰이 묶인 워크스페이스 밖이다",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "429": {
            "description": "API_RATE_LIMITED: 호출 한도를 넘었다. Retry-After(초)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          }
        }
      }
    },
    "/api/issues/{issueId}": {
      "get": {
        "operationId": "issues.get",
        "summary": "과제 상세(최근 회차 위험 구간 스크린샷 · 담당 · 메모 · 기록)",
        "tags": [
          "issues"
        ],
        "security": [
          {
            "bearer": [
              "issues:read"
            ]
          }
        ],
        "x-ableflow-scope": "issues:read",
        "x-ableflow-since": "1.0.0",
        "x-ableflow-personal-data": true,
        "x-ableflow-demo": true,
        "parameters": [
          {
            "name": "issueId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "AbleFlow-Version",
            "in": "header",
            "required": false,
            "description": "1.0.0 · v1.0.0 · 1.0 · 1. 없으면 토큰 고정 버전 → 최신",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "과제 상세(최근 회차 위험 구간 스크린샷 · 담당 · 메모 · 기록)",
            "headers": {
              "AbleFlow-Version": {
                "description": "실제로 적용한 버전",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/GetIssueResponse"
                },
                "example": {
                  "latestDiagnosisEvaluated": true,
                  "findings": [
                    {
                      "findingId": "0af1de00-0000-4000-8000-000000000704",
                      "region": {
                        "x": 0.5911,
                        "y": 0.3736,
                        "width": 0.2644,
                        "height": 0.0133
                      },
                      "screenName": "장바구니",
                      "screenResultId": "0af1de00-0000-4000-8000-000000000604",
                      "severity": "MEDIUM",
                      "viewport": "PC"
                    }
                  ],
                  "history": [],
                  "createdAt": "2026-11-02T02:00:00Z",
                  "criterion": "LOW_CONTRAST",
                  "elementHint": "p.coupon-hint",
                  "findingCount": 1,
                  "id": "0af1de00-0000-4000-8000-000000000802",
                  "projectId": "0af1de00-0000-4000-8000-000000000101",
                  "projectName": "에이블 몰 온라인몰",
                  "screenCount": 1,
                  "seq": 2,
                  "severity": "MEDIUM",
                  "source": {
                    "rank": 2,
                    "diagnosisId": "0af1de00-0000-4000-8000-000000000501",
                    "finishedAt": "2026-11-02T01:03:00Z",
                    "seq": 1
                  },
                  "status": "IN_PROGRESS",
                  "title": "글자 대비가 낮습니다(3.42:1)",
                  "titleArgs": {
                    "ratio": "3.42"
                  },
                  "titleKey": "textContrastLow",
                  "updatedAt": "2026-11-02T02:00:00Z"
                }
              }
            }
          },
          "400": {
            "description": "UNSUPPORTED_API_VERSION: AbleFlow-Version(또는 토큰 고정 버전)을 맞출 수 없다. detail { requested, supported }",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "401": {
            "description": "UNAUTHORIZED: Authorization 머리글이 없다(토큰 없음). 공개 API 요청으로 보지 않아 응답에 AbleFlow-Version 머리글이 없다\nINVALID_TOKEN: 토큰이 틀렸거나 폐기됐다(발급자가 워크스페이스를 나가 폐기된 토큰 포함)\nTOKEN_EXPIRED: 토큰이 만료됐다",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "403": {
            "description": "INSUFFICIENT_SCOPE: 토큰 범위가 모자란다. detail { required }\nDEMO_READ_ONLY: 데모 토큰은 GET · HEAD 만 부를 수 있다\nPLAN_FEATURE_REQUIRED: 워크스페이스 요금제에 공개 API 가 없거나 체험이 끝났다(요금제로 막을 때, 데모 토큰 제외). detail { target: PUBLIC_API, reason: PLAN_FEATURE | TRIAL_ENDED, suggestedPlan? }",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "404": {
            "description": "RESOURCE_NOT_FOUND: 자원이 없거나 토큰이 묶인 워크스페이스 밖이다",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "429": {
            "description": "API_RATE_LIMITED: 호출 한도를 넘었다. Retry-After(초)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          }
        }
      }
    },
    "/api/workspaces/{workspaceId}/issues": {
      "get": {
        "operationId": "issues.list",
        "summary": "개선 과제 페이지 조회(기본 정렬: 심각도 높은 순 → 만든 시각)",
        "tags": [
          "issues"
        ],
        "security": [
          {
            "bearer": [
              "issues:read"
            ]
          }
        ],
        "x-ableflow-scope": "issues:read",
        "x-ableflow-since": "1.0.0",
        "x-ableflow-personal-data": true,
        "x-ableflow-demo": true,
        "parameters": [
          {
            "name": "workspaceId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "시작 오프셋",
            "schema": {
              "type": "number"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "조회 개수",
            "schema": {
              "type": "number"
            }
          },
          {
            "name": "sort",
            "in": "query",
            "required": false,
            "description": "정렬 조건. 콤마로 구분하며 각 항목은 property 또는 property:ASC|DESC 형식",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "keyword",
            "in": "query",
            "required": false,
            "description": "제목 검색어(대소문자 무시). 한국어 원문 제목과 요청 언어(?locale= en · ja · zh-CN · zh-Hant)의 AI 제목 번역에서 찾는다(OR)",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "titleKeys",
            "in": "query",
            "required": false,
            "description": "제목 문구 키(콤마 구분, 예: textContrastLow — 키 목록은 AbleflowFindingMessageArgs 설명). keyword 와 함께 오면 제목에 keyword 가 들어 있거나 제목 문구 키가 이 중 하나인 과제(OR).\n규칙 제목 원문은 한국어라 다른 언어 화면의 검색어는 원문에 없다 — 화면 언어 메시지에서 검색어가 들어간 키를 찾아 같이 보낸다\n(AI 제목은 서버가 요청 언어 번역에서 찾는다). 모르는 키는 무시한다(형식이 틀리면 400)",
            "schema": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "style": "form",
            "explode": false
          },
          {
            "name": "projectIds",
            "in": "query",
            "required": false,
            "description": "콤마 구분",
            "schema": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "style": "form",
            "explode": false
          },
          {
            "name": "criterion",
            "in": "query",
            "required": false,
            "schema": {
              "type": "array",
              "items": {
                "$ref": "#/components/schemas/AbleflowCriterion"
              }
            },
            "style": "form",
            "explode": false
          },
          {
            "name": "severity",
            "in": "query",
            "required": false,
            "schema": {
              "type": "array",
              "items": {
                "$ref": "#/components/schemas/AbleflowSeverity"
              }
            },
            "style": "form",
            "explode": false
          },
          {
            "name": "status",
            "in": "query",
            "required": false,
            "schema": {
              "type": "array",
              "items": {
                "$ref": "#/components/schemas/AbleflowIssueStatus"
              }
            },
            "style": "form",
            "explode": false
          },
          {
            "name": "assignee",
            "in": "query",
            "required": false,
            "description": "담당 memberId(콤마 구분) · \"me\" 는 나 · \"none\" 은 담당 없음. 그 밖의 값은 400",
            "schema": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "style": "form",
            "explode": false
          },
          {
            "name": "AbleFlow-Version",
            "in": "header",
            "required": false,
            "description": "1.0.0 · v1.0.0 · 1.0 · 1. 없으면 토큰 고정 버전 → 최신",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "개선 과제 페이지 조회(기본 정렬: 심각도 높은 순 → 만든 시각)",
            "headers": {
              "AbleFlow-Version": {
                "description": "실제로 적용한 버전",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/GetIssuePaginationResponse"
                },
                "example": {
                  "count": 2,
                  "prev": null,
                  "next": null,
                  "results": [
                    {
                      "latestDiagnosisEvaluated": true,
                      "createdAt": "2026-11-02T02:00:00Z",
                      "criterion": "LOW_CONTRAST",
                      "findingCount": 0,
                      "id": "0af1de00-0000-4000-8000-000000000801",
                      "projectId": "0af1de00-0000-4000-8000-000000000101",
                      "projectName": "에이블 몰 온라인몰",
                      "screenCount": 0,
                      "seq": 1,
                      "severity": "HIGH",
                      "source": {
                        "rank": 1,
                        "diagnosisId": "0af1de00-0000-4000-8000-000000000501",
                        "finishedAt": "2026-11-02T01:03:00Z",
                        "seq": 1
                      },
                      "status": "DONE",
                      "title": "글자 대비가 낮습니다(2.86:1)",
                      "titleArgs": {
                        "ratio": "2.86"
                      },
                      "titleKey": "textContrastLow",
                      "updatedAt": "2026-11-02T02:00:00Z"
                    },
                    {
                      "latestDiagnosisEvaluated": true,
                      "createdAt": "2026-11-02T02:00:00Z",
                      "criterion": "LOW_CONTRAST",
                      "elementHint": "p.coupon-hint",
                      "findingCount": 1,
                      "id": "0af1de00-0000-4000-8000-000000000802",
                      "projectId": "0af1de00-0000-4000-8000-000000000101",
                      "projectName": "에이블 몰 온라인몰",
                      "screenCount": 1,
                      "seq": 2,
                      "severity": "MEDIUM",
                      "source": {
                        "rank": 2,
                        "diagnosisId": "0af1de00-0000-4000-8000-000000000501",
                        "finishedAt": "2026-11-02T01:03:00Z",
                        "seq": 1
                      },
                      "status": "IN_PROGRESS",
                      "title": "글자 대비가 낮습니다(3.42:1)",
                      "titleArgs": {
                        "ratio": "3.42"
                      },
                      "titleKey": "textContrastLow",
                      "updatedAt": "2026-11-02T02:00:00Z"
                    }
                  ]
                }
              }
            }
          },
          "400": {
            "description": "UNSUPPORTED_API_VERSION: AbleFlow-Version(또는 토큰 고정 버전)을 맞출 수 없다. detail { requested, supported }",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "401": {
            "description": "UNAUTHORIZED: Authorization 머리글이 없다(토큰 없음). 공개 API 요청으로 보지 않아 응답에 AbleFlow-Version 머리글이 없다\nINVALID_TOKEN: 토큰이 틀렸거나 폐기됐다(발급자가 워크스페이스를 나가 폐기된 토큰 포함)\nTOKEN_EXPIRED: 토큰이 만료됐다",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "403": {
            "description": "INSUFFICIENT_SCOPE: 토큰 범위가 모자란다. detail { required }\nDEMO_READ_ONLY: 데모 토큰은 GET · HEAD 만 부를 수 있다\nPLAN_FEATURE_REQUIRED: 워크스페이스 요금제에 공개 API 가 없거나 체험이 끝났다(요금제로 막을 때, 데모 토큰 제외). detail { target: PUBLIC_API, reason: PLAN_FEATURE | TRIAL_ENDED, suggestedPlan? }",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "404": {
            "description": "RESOURCE_NOT_FOUND: 자원이 없거나 토큰이 묶인 워크스페이스 밖이다",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "429": {
            "description": "API_RATE_LIMITED: 호출 한도를 넘었다. Retry-After(초)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          }
        }
      }
    },
    "/api/issues/{issueId}/status": {
      "put": {
        "operationId": "issues.status.update",
        "summary": "과제 상태 바꾸기(구성원 누구나). 무시하기 = DISMISSED 로, 무시 해제 = 다른 상태로. 닫힌 상태(DONE · DISMISSED)에서 열린 상태로 바꿀 때",
        "description": "같은 groupKey 의 열린 과제가 있으면 409 DUPLICATED_ISSUE. 204",
        "tags": [
          "issues"
        ],
        "security": [
          {
            "bearer": [
              "issues:write"
            ]
          }
        ],
        "x-ableflow-scope": "issues:write",
        "x-ableflow-since": "1.0.0",
        "x-ableflow-personal-data": false,
        "x-ableflow-demo": false,
        "parameters": [
          {
            "name": "issueId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "AbleFlow-Version",
            "in": "header",
            "required": false,
            "description": "1.0.0 · v1.0.0 · 1.0 · 1. 없으면 토큰 고정 버전 → 최신",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateIssueStatusRequestBody"
              }
            }
          }
        },
        "responses": {
          "204": {
            "description": "과제 상태 바꾸기(구성원 누구나). 무시하기 = DISMISSED 로, 무시 해제 = 다른 상태로. 닫힌 상태(DONE · DISMISSED)에서 열린 상태로 바꿀 때",
            "headers": {
              "AbleFlow-Version": {
                "description": "실제로 적용한 버전",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "UNSUPPORTED_API_VERSION: AbleFlow-Version(또는 토큰 고정 버전)을 맞출 수 없다. detail { requested, supported }\nBAD_REQUEST: 모르는 상태 값",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "401": {
            "description": "UNAUTHORIZED: Authorization 머리글이 없다(토큰 없음). 공개 API 요청으로 보지 않아 응답에 AbleFlow-Version 머리글이 없다\nINVALID_TOKEN: 토큰이 틀렸거나 폐기됐다(발급자가 워크스페이스를 나가 폐기된 토큰 포함)\nTOKEN_EXPIRED: 토큰이 만료됐다",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "403": {
            "description": "INSUFFICIENT_SCOPE: 토큰 범위가 모자란다. detail { required }\nDEMO_READ_ONLY: 데모 토큰은 GET · HEAD 만 부를 수 있다\nPLAN_FEATURE_REQUIRED: 워크스페이스 요금제에 공개 API 가 없거나 체험이 끝났다(요금제로 막을 때, 데모 토큰 제외). detail { target: PUBLIC_API, reason: PLAN_FEATURE | TRIAL_ENDED, suggestedPlan? }",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "404": {
            "description": "RESOURCE_NOT_FOUND: 자원이 없거나 토큰이 묶인 워크스페이스 밖이다",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "409": {
            "description": "DUPLICATED_ISSUE: 닫힌 과제(DONE · DISMISSED)를 열린 상태로 바꾸는데 같은 문제(groupKey)의 열린 과제가 이미 있다",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "429": {
            "description": "API_RATE_LIMITED: 호출 한도를 넘었다. Retry-After(초)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          }
        }
      }
    },
    "/api/projects/{projectId}/labels/list": {
      "get": {
        "operationId": "labels.listByProject",
        "summary": "이 프로젝트에서 쓸 수 있는 레이블 전체(공통 먼저, 이름순, 페이지 없음). screenCount 는 이 프로젝트 화면 기준",
        "tags": [
          "labels"
        ],
        "security": [
          {
            "bearer": [
              "labels:read"
            ]
          }
        ],
        "x-ableflow-scope": "labels:read",
        "x-ableflow-since": "1.0.0",
        "x-ableflow-personal-data": false,
        "x-ableflow-demo": true,
        "parameters": [
          {
            "name": "projectId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "scope",
            "in": "query",
            "required": false,
            "description": "하나만 고를 때. 없으면 둘 다",
            "schema": {
              "$ref": "#/components/schemas/AbleflowLabelScope"
            }
          },
          {
            "name": "AbleFlow-Version",
            "in": "header",
            "required": false,
            "description": "1.0.0 · v1.0.0 · 1.0 · 1. 없으면 토큰 고정 버전 → 최신",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "이 프로젝트에서 쓸 수 있는 레이블 전체(공통 먼저, 이름순, 페이지 없음). screenCount 는 이 프로젝트 화면 기준",
            "headers": {
              "AbleFlow-Version": {
                "description": "실제로 적용한 버전",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/GetProjectLabelsResponse"
                },
                "example": [
                  {
                    "screenCount": 1,
                    "color": "BLUE",
                    "createdAt": "2026-11-01T00:01:00Z",
                    "description": "장바구니 · 주문서처럼 결제로 이어지는 화면",
                    "id": "0af1de00-0000-4000-8000-000000000201",
                    "name": "구매 흐름",
                    "scope": "WORKSPACE",
                    "updatedAt": "2026-11-01T00:01:00Z"
                  },
                  {
                    "screenCount": 0,
                    "color": "GREEN",
                    "createdAt": "2026-11-01T00:01:00Z",
                    "id": "0af1de00-0000-4000-8000-000000000202",
                    "name": "회원",
                    "scope": "WORKSPACE",
                    "updatedAt": "2026-11-01T00:01:00Z"
                  }
                ]
              }
            }
          },
          "400": {
            "description": "UNSUPPORTED_API_VERSION: AbleFlow-Version(또는 토큰 고정 버전)을 맞출 수 없다. detail { requested, supported }",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "401": {
            "description": "UNAUTHORIZED: Authorization 머리글이 없다(토큰 없음). 공개 API 요청으로 보지 않아 응답에 AbleFlow-Version 머리글이 없다\nINVALID_TOKEN: 토큰이 틀렸거나 폐기됐다(발급자가 워크스페이스를 나가 폐기된 토큰 포함)\nTOKEN_EXPIRED: 토큰이 만료됐다",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "403": {
            "description": "INSUFFICIENT_SCOPE: 토큰 범위가 모자란다. detail { required }\nDEMO_READ_ONLY: 데모 토큰은 GET · HEAD 만 부를 수 있다\nPLAN_FEATURE_REQUIRED: 워크스페이스 요금제에 공개 API 가 없거나 체험이 끝났다(요금제로 막을 때, 데모 토큰 제외). detail { target: PUBLIC_API, reason: PLAN_FEATURE | TRIAL_ENDED, suggestedPlan? }",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "404": {
            "description": "RESOURCE_NOT_FOUND: 자원이 없거나 토큰이 묶인 워크스페이스 밖이다",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "429": {
            "description": "API_RATE_LIMITED: 호출 한도를 넘었다. Retry-After(초)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          }
        }
      }
    },
    "/api/workspaces/{workspaceId}/labels/list": {
      "get": {
        "operationId": "labels.listByWorkspace",
        "summary": "공통 레이블 전체 목록(페이지 없음, 이름순)",
        "tags": [
          "labels"
        ],
        "security": [
          {
            "bearer": [
              "labels:read"
            ]
          }
        ],
        "x-ableflow-scope": "labels:read",
        "x-ableflow-since": "1.0.0",
        "x-ableflow-personal-data": false,
        "x-ableflow-demo": true,
        "parameters": [
          {
            "name": "workspaceId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "AbleFlow-Version",
            "in": "header",
            "required": false,
            "description": "1.0.0 · v1.0.0 · 1.0 · 1. 없으면 토큰 고정 버전 → 최신",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "공통 레이블 전체 목록(페이지 없음, 이름순)",
            "headers": {
              "AbleFlow-Version": {
                "description": "실제로 적용한 버전",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/GetWorkspaceLabelsResponse"
                },
                "example": [
                  {
                    "screenCount": 1,
                    "projectCount": 1,
                    "color": "BLUE",
                    "createdAt": "2026-11-01T00:01:00Z",
                    "description": "장바구니 · 주문서처럼 결제로 이어지는 화면",
                    "id": "0af1de00-0000-4000-8000-000000000201",
                    "name": "구매 흐름",
                    "scope": "WORKSPACE",
                    "updatedAt": "2026-11-01T00:01:00Z"
                  },
                  {
                    "screenCount": 0,
                    "projectCount": 0,
                    "color": "GREEN",
                    "createdAt": "2026-11-01T00:01:00Z",
                    "id": "0af1de00-0000-4000-8000-000000000202",
                    "name": "회원",
                    "scope": "WORKSPACE",
                    "updatedAt": "2026-11-01T00:01:00Z"
                  }
                ]
              }
            }
          },
          "400": {
            "description": "UNSUPPORTED_API_VERSION: AbleFlow-Version(또는 토큰 고정 버전)을 맞출 수 없다. detail { requested, supported }",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "401": {
            "description": "UNAUTHORIZED: Authorization 머리글이 없다(토큰 없음). 공개 API 요청으로 보지 않아 응답에 AbleFlow-Version 머리글이 없다\nINVALID_TOKEN: 토큰이 틀렸거나 폐기됐다(발급자가 워크스페이스를 나가 폐기된 토큰 포함)\nTOKEN_EXPIRED: 토큰이 만료됐다",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "403": {
            "description": "INSUFFICIENT_SCOPE: 토큰 범위가 모자란다. detail { required }\nDEMO_READ_ONLY: 데모 토큰은 GET · HEAD 만 부를 수 있다\nPLAN_FEATURE_REQUIRED: 워크스페이스 요금제에 공개 API 가 없거나 체험이 끝났다(요금제로 막을 때, 데모 토큰 제외). detail { target: PUBLIC_API, reason: PLAN_FEATURE | TRIAL_ENDED, suggestedPlan? }",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "404": {
            "description": "RESOURCE_NOT_FOUND: 자원이 없거나 토큰이 묶인 워크스페이스 밖이다",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "429": {
            "description": "API_RATE_LIMITED: 호출 한도를 넘었다. Retry-After(초)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          }
        }
      }
    },
    "/api/projects/{projectId}/monitor-schedules/list": {
      "get": {
        "operationId": "schedules.list",
        "summary": "프로젝트의 반복 진단 일정 목록(페이지 없음, 만든 순). 구성원 누구나",
        "tags": [
          "schedules"
        ],
        "security": [
          {
            "bearer": [
              "schedules:read"
            ]
          }
        ],
        "x-ableflow-scope": "schedules:read",
        "x-ableflow-since": "1.0.0",
        "x-ableflow-personal-data": true,
        "x-ableflow-demo": true,
        "parameters": [
          {
            "name": "projectId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "AbleFlow-Version",
            "in": "header",
            "required": false,
            "description": "1.0.0 · v1.0.0 · 1.0 · 1. 없으면 토큰 고정 버전 → 최신",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "프로젝트의 반복 진단 일정 목록(페이지 없음, 만든 순). 구성원 누구나",
            "headers": {
              "AbleFlow-Version": {
                "description": "실제로 적용한 버전",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/GetMonitorSchedulesResponse"
                },
                "example": [
                  {
                    "nextRunAts": [],
                    "createdBy": {
                      "memberId": "0af1de00-0000-4000-8000-0000000000aa",
                      "name": "에이블 몰 운영팀"
                    },
                    "alertDelta": 5,
                    "alertMemberIds": [],
                    "createdAt": "2026-11-01T00:05:00Z",
                    "criteria": [
                      "LOW_CONTRAST"
                    ],
                    "days": [
                      1
                    ],
                    "enabled": false,
                    "id": "0af1de00-0000-4000-8000-000000000901",
                    "labelIds": [
                      "0af1de00-0000-4000-8000-000000000201"
                    ],
                    "name": "매주 월요일 점검",
                    "screenIds": [],
                    "time": "09:00",
                    "timeZone": "Asia/Seoul",
                    "type": "WEEKLY",
                    "updatedAt": "2026-11-01T00:05:00Z",
                    "viewports": [
                      "PC"
                    ]
                  }
                ]
              }
            }
          },
          "400": {
            "description": "UNSUPPORTED_API_VERSION: AbleFlow-Version(또는 토큰 고정 버전)을 맞출 수 없다. detail { requested, supported }",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "401": {
            "description": "UNAUTHORIZED: Authorization 머리글이 없다(토큰 없음). 공개 API 요청으로 보지 않아 응답에 AbleFlow-Version 머리글이 없다\nINVALID_TOKEN: 토큰이 틀렸거나 폐기됐다(발급자가 워크스페이스를 나가 폐기된 토큰 포함)\nTOKEN_EXPIRED: 토큰이 만료됐다",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "403": {
            "description": "INSUFFICIENT_SCOPE: 토큰 범위가 모자란다. detail { required }\nDEMO_READ_ONLY: 데모 토큰은 GET · HEAD 만 부를 수 있다\nPLAN_FEATURE_REQUIRED: 워크스페이스 요금제에 공개 API 가 없거나 체험이 끝났다(요금제로 막을 때, 데모 토큰 제외). detail { target: PUBLIC_API, reason: PLAN_FEATURE | TRIAL_ENDED, suggestedPlan? }",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "404": {
            "description": "RESOURCE_NOT_FOUND: 자원이 없거나 토큰이 묶인 워크스페이스 밖이다",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "429": {
            "description": "API_RATE_LIMITED: 호출 한도를 넘었다. Retry-After(초)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          }
        }
      }
    },
    "/api/workspaces/{workspaceId}/members/list": {
      "get": {
        "operationId": "members.list",
        "summary": "구성원 전체 목록(페이지 없음, 역할 → 이름순. 구성원 누구나)",
        "tags": [
          "members"
        ],
        "security": [
          {
            "bearer": [
              "members:read"
            ]
          }
        ],
        "x-ableflow-scope": "members:read",
        "x-ableflow-since": "1.0.0",
        "x-ableflow-personal-data": true,
        "x-ableflow-demo": false,
        "parameters": [
          {
            "name": "workspaceId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "keyword",
            "in": "query",
            "required": false,
            "description": "이름 · 이메일 검색어(대소문자 무시)",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "AbleFlow-Version",
            "in": "header",
            "required": false,
            "description": "1.0.0 · v1.0.0 · 1.0 · 1. 없으면 토큰 고정 버전 → 최신",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "구성원 전체 목록(페이지 없음, 역할 → 이름순. 구성원 누구나)",
            "headers": {
              "AbleFlow-Version": {
                "description": "실제로 적용한 버전",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/GetWorkspaceMembersResponse"
                },
                "example": [
                  {
                    "projectCount": 2,
                    "email": "demo@ableflow.invalid",
                    "joinedAt": "2026-11-01T00:00:00Z",
                    "lastActiveAt": null,
                    "me": true,
                    "memberId": "0af1de00-0000-4000-8000-0000000000aa",
                    "name": "에이블 몰 운영팀",
                    "role": "OWNER"
                  }
                ]
              }
            }
          },
          "400": {
            "description": "UNSUPPORTED_API_VERSION: AbleFlow-Version(또는 토큰 고정 버전)을 맞출 수 없다. detail { requested, supported }",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "401": {
            "description": "UNAUTHORIZED: Authorization 머리글이 없다(토큰 없음). 공개 API 요청으로 보지 않아 응답에 AbleFlow-Version 머리글이 없다\nINVALID_TOKEN: 토큰이 틀렸거나 폐기됐다(발급자가 워크스페이스를 나가 폐기된 토큰 포함)\nTOKEN_EXPIRED: 토큰이 만료됐다",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "403": {
            "description": "INSUFFICIENT_SCOPE: 토큰 범위가 모자란다. detail { required }\nDEMO_READ_ONLY: 데모 토큰은 GET · HEAD 만 부를 수 있다\nPLAN_FEATURE_REQUIRED: 워크스페이스 요금제에 공개 API 가 없거나 체험이 끝났다(요금제로 막을 때, 데모 토큰 제외). detail { target: PUBLIC_API, reason: PLAN_FEATURE | TRIAL_ENDED, suggestedPlan? }",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "404": {
            "description": "RESOURCE_NOT_FOUND: 자원이 없거나 토큰이 묶인 워크스페이스 밖이다",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "429": {
            "description": "API_RATE_LIMITED: 호출 한도를 넘었다. Retry-After(초)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          }
        }
      }
    },
    "/api/api-tokens/current": {
      "get": {
        "operationId": "tokens.current",
        "summary": "지금 부른 토큰 자기 정보(토큰이 묶인 워크스페이스 · 이름 · 범위 · 만료 · 고정 버전). 범위 없이 부른다(데모 토큰 포함).",
        "description": "토큰을 넣고 처음 확인할 때 쓴다. 로그인(JWT)으로 부르면 404 NOT_FOUND(공개 API 토큰 요청에만 있는 정보)",
        "tags": [
          "tokens"
        ],
        "security": [
          {
            "bearer": []
          }
        ],
        "x-ableflow-scope": null,
        "x-ableflow-since": "1.0.0",
        "x-ableflow-personal-data": false,
        "x-ableflow-demo": true,
        "parameters": [
          {
            "name": "AbleFlow-Version",
            "in": "header",
            "required": false,
            "description": "1.0.0 · v1.0.0 · 1.0 · 1. 없으면 토큰 고정 버전 → 최신",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "지금 부른 토큰 자기 정보(토큰이 묶인 워크스페이스 · 이름 · 범위 · 만료 · 고정 버전). 범위 없이 부른다(데모 토큰 포함).",
            "headers": {
              "AbleFlow-Version": {
                "description": "실제로 적용한 버전",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/GetCurrentApiTokenResponse"
                },
                "example": {
                  "demo": true,
                  "name": "에이블 몰 운영팀 토큰",
                  "scopes": [
                    "projects:read",
                    "screens:read",
                    "diagnoses:read",
                    "results:read",
                    "issues:read",
                    "labels:read",
                    "schedules:read"
                  ],
                  "workspaceId": "0af1de00-0000-4000-8000-000000000001",
                  "workspaceName": "에이블 몰"
                }
              }
            }
          },
          "400": {
            "description": "UNSUPPORTED_API_VERSION: AbleFlow-Version(또는 토큰 고정 버전)을 맞출 수 없다. detail { requested, supported }",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "401": {
            "description": "UNAUTHORIZED: Authorization 머리글이 없다(토큰 없음). 공개 API 요청으로 보지 않아 응답에 AbleFlow-Version 머리글이 없다\nINVALID_TOKEN: 토큰이 틀렸거나 폐기됐다(발급자가 워크스페이스를 나가 폐기된 토큰 포함)\nTOKEN_EXPIRED: 토큰이 만료됐다",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "403": {
            "description": "INSUFFICIENT_SCOPE: 토큰 범위가 모자란다. detail { required }\nDEMO_READ_ONLY: 데모 토큰은 GET · HEAD 만 부를 수 있다\nPLAN_FEATURE_REQUIRED: 워크스페이스 요금제에 공개 API 가 없거나 체험이 끝났다(요금제로 막을 때, 데모 토큰 제외). detail { target: PUBLIC_API, reason: PLAN_FEATURE | TRIAL_ENDED, suggestedPlan? }",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "404": {
            "description": "RESOURCE_NOT_FOUND: 자원이 없거나 토큰이 묶인 워크스페이스 밖이다",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "429": {
            "description": "API_RATE_LIMITED: 호출 한도를 넘었다. Retry-After(초)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "ErrorResponse": {
        "type": "object",
        "required": [
          "code",
          "message"
        ],
        "properties": {
          "code": {
            "type": "string"
          },
          "message": {
            "type": "string"
          },
          "detail": {},
          "errorId": {
            "type": "string"
          }
        }
      },
      "AbleflowAnalysisPrecision": {
        "enum": [
          "DOM",
          "PIXEL"
        ],
        "description": "AbleFlow - 분석 정확도: URL · 확장 프로그램은 요소 정보(DOM), 이미지는 픽셀(PIXEL)"
      },
      "AbleflowApiTokenScope": {
        "enum": [
          "projects:read",
          "projects:write",
          "screens:read",
          "screens:write",
          "diagnoses:read",
          "diagnoses:write",
          "results:read",
          "results:write",
          "issues:read",
          "issues:write",
          "labels:read",
          "labels:write",
          "schedules:read",
          "schedules:write",
          "members:read"
        ],
        "description": "AbleFlow - 공개 API 토큰 범위(자원 × 읽기/쓰기). 쓰기는 같은 자원의 읽기를 포함한다. 구성원은 읽기만"
      },
      "AbleflowCriterion": {
        "enum": [
          "COLOR_DEPENDENCY",
          "LOW_CONTRAST",
          "INFORMATION_DENSITY",
          "LAYOUT_COMPLEXITY",
          "STATUS_COMMUNICATION"
        ],
        "description": "AbleFlow - 진단 기준"
      },
      "AbleflowCriterionNote": {
        "type": "object",
        "properties": {
          "criterion": {
            "$ref": "#/components/schemas/AbleflowCriterion"
          },
          "reason": {
            "$ref": "#/components/schemas/AbleflowCriterionNoteReason"
          },
          "unevaluated": {
            "type": "boolean"
          }
        },
        "required": [
          "criterion",
          "reason",
          "unevaluated"
        ],
        "description": "AbleFlow - 기준 평가 메모 한 줄"
      },
      "AbleflowCriterionNoteReason": {
        "enum": [
          "AI_DISABLED",
          "TIMEOUT",
          "CALL_FAILED",
          "FORMAT_ERROR",
          "TRUNCATED",
          "MISSING_IN_REPLY",
          "IMAGE_UNREADABLE",
          "IMAGE_TOO_LARGE",
          "BUDGET_EXCEEDED",
          "TILE_LIMIT",
          "TILE_FAILED",
          "EMPTY_REPLY"
        ],
        "description": "AbleFlow - 기준 평가 메모 이유. 앞 9개는 점수에서 빠짐(unevaluated), TILE_LIMIT · TILE_FAILED 는 일부만 평가, EMPTY_REPLY 는 평가함(0점 · 확인 권장)"
      },
      "AbleflowDiagnosisStatus": {
        "enum": [
          "QUEUED",
          "RUNNING",
          "COMPLETED",
          "PARTIAL",
          "FAILED",
          "CANCELED"
        ],
        "description": "AbleFlow - 회차 상태. 진행 중(QUEUED · RUNNING)은 프로젝트에 하나"
      },
      "AbleflowDiagnosisTrigger": {
        "enum": [
          "MANUAL",
          "FREE_TRIAL",
          "SCHEDULED",
          "PRE_DEPLOY"
        ],
        "description": "AbleFlow - 회차를 만든 계기. 사용자 실행은 MANUAL"
      },
      "AbleflowEffort": {
        "enum": [
          "EASY",
          "MEDIUM",
          "HARD"
        ],
        "description": "AbleFlow - 고치는 데 드는 품(화면 표기 쉬움 · 보통 · 손이 많이 감)"
      },
      "AbleflowEvidence": {
        "type": "object",
        "properties": {
          "metric": {
            "type": "string",
            "description": "예: \"contrastRatio\" · \"linkTextContrast\" · \"firstViewDensity\""
          },
          "actual": {
            "type": [
              "string",
              "null"
            ],
            "description": "엔진 규칙 위험 구간은 글자로 남긴다. AI 판단 위험 구간은 없음(근거는 note)"
          },
          "expected": {
            "type": [
              "string",
              "null"
            ]
          },
          "note": {
            "type": [
              "string",
              "null"
            ],
            "description": "근거 설명. 규칙 위험 구간은 한국어 원문(noteKey 로 옮긴다), AI 판단 위험 구간은 판단 이유 — 요청 언어(?locale=) 번역이 있으면 그 글, 없으면 한국어 원문"
          },
          "noteKey": {
            "type": [
              "string",
              "null"
            ],
            "description": "규칙 근거 설명의 문구 키(키 목록은 AbleflowFindingMessageArgs 설명). AI 판단 이유 · 키가 없는 옛 행은 빠진다 — 그때는 note 를 그대로 보인다"
          },
          "noteArgs": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/AbleflowFindingMessageArgs"
              },
              {
                "type": "null"
              }
            ],
            "description": "문구 키의 이름 붙은 값(값 자리가 없는 문구 · 키가 없으면 빠진다)"
          }
        },
        "required": [
          "metric"
        ],
        "description": "AbleFlow - 위험 구간 근거 수치 하나. 엔진 규칙은 글자로 남긴다(예: actual \"2.32\" · expected \"4.5\")"
      },
      "AbleflowFailureMessageArgs": {
        "type": "object",
        "properties": {
          "status": {
            "type": [
              "number",
              "null"
            ],
            "description": "사이트가 돌려준 HTTP 상태. pageNotFound · pageAccessDenied · siteError"
          },
          "maxSide": {
            "type": [
              "number",
              "null"
            ],
            "description": "올릴 수 있는 이미지의 가로 · 세로 상한(px) · 화소 수 상한. imageTooLarge"
          },
          "maxPixels": {
            "type": [
              "number",
              "null"
            ]
          }
        },
        "description": "AbleFlow - 실패 문구의 이름 붙은 값(진행 failureArgs). 값이 있는 칸만 나간다.\n분석 · 회차 실패 상세는 언어별로 내려 주지 않는다: failureDetail · 회차 failureReason 은 늘 한국어 원문이고, 서버가 만든 실패 문구면 문구 키(failureCode)와\n이 값이 함께 나간다. 화면 언어 문장은 받는 쪽이 키를 메시지 키로, 이 객체를 ICU 메시지 값으로 써서 만든다(AbleFlow 웹이 그렇게 한다).\n모르는 키 · 키가 없는 항목(키를 쓰기 전 옛 행)은 원문을 그대로 보인다. AI 판단 비용 상한(aiBudgetExceeded) · 장부 오류(aiCallFailed)는 원문이 사용량 장부의 원인 글이다.\n키는 바꾸거나 지우지 않고 실패 원인이 늘면 더한다(응답 타입은 string). 키와 한국어 문장({이름} 은 이 객체의 칸):\n- 주소 확인: invalidUrl 주소 형식이 올바르지 않습니다. · urlCheckBusy 지금 주소 확인이 밀려 있습니다. 잠시 후 다시 해 주세요. ·\n  hostLookupTimeout 주소의 서버를 시간 안에 찾지 못했습니다. · urlCheckInterrupted 주소 확인이 중단됐습니다. · hostNotFound 주소의 서버를 찾지 못했습니다. ·\n  addressBlocked 열 수 없는 주소입니다(내부망 · 허용되지 않은 형식).\n- 페이지 열기: pageNotFound 페이지가 없습니다({status}). · pageAccessDenied 접근 권한이 필요한 페이지입니다({status}). · siteError 사이트가 오류를 돌려줬습니다({status}). ·\n  loginRedirect 로그인 화면으로 넘어갔습니다. 스크린샷을 올려 진단해 주세요. · pageTimeout 시간 안에 페이지가 열리지 않았습니다. · captureError 캡처 중 오류가 났습니다. ·\n  pageAnalysisFailed 페이지를 분석하지 못했습니다. · pageErrorResponse 페이지가 오류 응답을 돌려줬습니다(없는 주소 · 서버 오류). · connectionFailed 사이트에 연결하지 못했습니다. ·\n  navigationBlocked 열 수 없는 주소입니다. · pageOpenFailed 페이지를 열지 못했습니다. · extractionUnreadable 추출 결과를 읽지 못했습니다. ·\n  captureImageMissing 캡처 이미지를 받지 못했습니다. · screenUrlMissing 화면 주소가 없습니다.\n- 이미지 화면: imageNotFound 화면 이미지를 찾을 수 없습니다. · imageStorageOff 화면 이미지를 읽을 수 없습니다(파일 저장소가 꺼져 있습니다). ·\n  imageUnreadable 화면 이미지를 읽을 수 없습니다(PNG · JPEG · WebP 로 올려 주세요). · imageTooLarge 화면 이미지가 너무 큽니다(가로 · 세로 {maxSide}px · {maxPixels} 화소 이하로 올려 주세요). ·\n  imageTooLargeToRead 화면 이미지가 너무 커서 읽지 못했습니다. 이미지를 나눠 올려 주세요.\n- AI 판단: aiTimeout AI 판단 답이 늦어 받지 못했습니다. 잠시 뒤 실패만 다시 해 주세요. · aiCallFailed AI 판단을 받지 못했습니다. 잠시 뒤 실패만 다시 해 주세요. ·\n  aiTruncated AI 판단 답이 길어 끊겼습니다. 기준을 나눠 다시 진단해 주세요. · aiFormatError AI 판단 답을 읽지 못했습니다. 잠시 뒤 실패만 다시 해 주세요. ·\n  aiBudgetExceeded AI 판단 비용 한도에 닿아 분석하지 못했습니다. · aiDisabled 고른 기준을 평가할 수 없습니다(AI 판단이 꺼져 있습니다). ·\n  aiMissingCriteria AI 판단 답에 고른 기준이 없었습니다. 잠시 뒤 실패만 다시 해 주세요.\n- 진단 일꾼: analysisError 분석 중 오류가 났습니다. · noCriteria 진단 기준이 없어 분석하지 못했습니다. · diagnosisClosed 진단이 끝나거나 취소되어 분석을 멈췄습니다. ·\n  analysisTimeout 분석이 시간 안에 끝나지 않았습니다. · analysisNotStarted 분석을 시작하지 못했습니다.\n- 회차(failureCode of 회차): allAnalysesFailed 모든 화면을 분석하지 못했습니다."
      },
      "AbleflowFailureReason": {
        "enum": [
          "NOT_FOUND",
          "TIMEOUT",
          "LOGIN_REQUIRED",
          "BLOCKED",
          "UNKNOWN"
        ],
        "description": "AbleFlow - 분석 실패 이유"
      },
      "AbleflowFindingMessageArgs": {
        "type": "object",
        "properties": {
          "ratio": {
            "type": [
              "string",
              "null"
            ],
            "description": "대비(소수 둘째 자리 글자, 예: \"3.88\"). textContrastLow"
          },
          "fontSize": {
            "type": [
              "number",
              "null"
            ],
            "description": "글자 크기(px) · 굵기. textContrastLowNote"
          },
          "fontWeight": {
            "type": [
              "number",
              "null"
            ]
          },
          "textBlocks": {
            "type": [
              "number",
              "null"
            ],
            "description": "첫 화면 글 덩어리 수 · 누를 수 있는 요소 수. firstViewDenseNote"
          },
          "interactiveElements": {
            "type": [
              "number",
              "null"
            ]
          }
        },
        "description": "AbleFlow - 규칙 위험 구간 문구의 이름 붙은 값(titleArgs · evidence.noteArgs). 값이 있는 칸만 나간다.\n규칙이 만든 제목 · 근거 설명은 언어별로 내려 주지 않는다: title · note 는 한국어 원문이고 문구 키(titleKey · evidence.noteKey)와\n이 값이 함께 나간다. 화면 언어 문장은 받는 쪽이 키를 메시지 키로, 이 객체를 ICU 메시지 값으로 써서 만든다(AbleFlow 웹이 그렇게 한다).\n키가 없는 항목은 title · note 를 그대로 보인다: AI 판단 문구(제목 · 판단 이유 · 요소 단서 · guide.ai.fix)는 서버가 저장 직후 AI 로 번역해 두어\n요청 언어(?locale= en · ja · zh-CN · zh-Hant, zh-TW · zh-HK 는 zh-Hant 의 별칭) 번역이 있으면 그 글을, 번역 전 · 실패 · 한국어 요청이면 한국어 원문을 준다(응답 모양은 같다).\n키는 바꾸거나 지우지 않고 규칙이 늘면 더한다(응답 타입은 string).\n키와 한국어 문장({이름} 은 이 객체의 칸):\n- textContrastLow: 글자 대비가 낮습니다({ratio}:1) · textContrastLowNote: 글자 크기 {fontSize}px · 굵기 {fontWeight}\n- linkColorOnly: 링크가 색으로만 구분됩니다 · linkColorOnlyNote: 밑줄 · 굵기 등 색 말고 다른 표시가 없습니다\n- firstViewDense: 첫 화면에 정보가 많습니다 · firstViewDenseNote: 글 덩어리 {textBlocks}개 · 누를 수 있는 요소 {interactiveElements}개"
      },
      "AbleflowGrade": {
        "enum": [
          "SAFE",
          "CAUTION",
          "RISK",
          "CRITICAL"
        ],
        "description": "AbleFlow - 대표 위험도 구간: 0~29 SAFE · 30~49 CAUTION · 50~69 RISK · 70~100 CRITICAL"
      },
      "AbleflowGuide": {
        "type": "object",
        "properties": {
          "expert": {
            "type": "object",
            "properties": {
              "criterion": {
                "$ref": "#/components/schemas/AbleflowCriterion"
              },
              "effort": {
                "$ref": "#/components/schemas/AbleflowEffort"
              },
              "component": {
                "$ref": "#/components/schemas/AbleflowGuideComponent"
              },
              "evidence": {
                "type": "string",
                "description": "근거 한 줄"
              },
              "fix": {
                "type": "string",
                "description": "고치는 방법"
              },
              "impact": {
                "type": "string",
                "description": "영향 설명 한 줄"
              }
            },
            "required": [
              "criterion",
              "effort",
              "component",
              "evidence",
              "fix",
              "impact"
            ]
          },
          "ai": {
            "type": [
              "object",
              "null"
            ],
            "properties": {
              "fix": {
                "type": [
                  "string",
                  "null"
                ]
              }
            }
          }
        },
        "required": [
          "expert"
        ],
        "description": "AbleFlow - 고치는 방법. expert 는 운영 콘솔이 관리하는 기준별 전문가 고정표,\nai 는 AI 판단이 고정표를 참고해 위험 구간마다 낸 고치는 방법 제안(AI 위험 구간에 제안이 있을 때만. 규칙 위험 구간 · 지난 회차는 없다).\nexpert 의 evidence · fix · impact 와 ai.fix 는 요청 언어(?locale= en · ja · zh-CN · zh-Hant, zh-TW · zh-HK 는 zh-Hant 의 별칭) 번역이 있으면 그 글,\n없으면 한국어 원문이다(expert 번역은 운영 콘솔에서 언어별로 쓴다 — 검수 전 초안도 나간다, ai.fix 번역은 저장 직후 AI 가 만든다)"
      },
      "AbleflowGuideComponent": {
        "enum": [
          "ERROR_MESSAGE",
          "BUTTON",
          "INPUT",
          "CARD_TABLE",
          "TEXT",
          "TAB_STATUS"
        ],
        "description": "AbleFlow - 고칠 부품 종류(오류 메시지 · 버튼 · 입력 칸 · 카드, 표 · 글 영역 · 탭, 상태 표시)"
      },
      "AbleflowIssueStatus": {
        "enum": [
          "TODO",
          "IN_PROGRESS",
          "IN_REVIEW",
          "DONE",
          "ON_HOLD",
          "DISMISSED"
        ],
        "description": "AbleFlow - 개선 과제 상태(화면 표기 할 일 · 진행 중 · 확인 대기 · 완료 · 보류 · 무시됨). DONE · DISMISSED 가 닫힌 과제(ON_HOLD 도 열린 과제). DISMISSED 는 다음 회차 확인 · 자동 다시 열기에서 빠진다"
      },
      "AbleflowLabelColor": {
        "enum": [
          "GRAY",
          "BLUE",
          "TEAL",
          "GREEN",
          "AMBER",
          "RED",
          "PINK",
          "VIOLET"
        ],
        "description": "AbleFlow - 레이블 색(다른 enum 처럼 대문자)"
      },
      "AbleflowLabelRef": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "color": {
            "$ref": "#/components/schemas/AbleflowLabelColor"
          },
          "scope": {
            "$ref": "#/components/schemas/AbleflowLabelScope"
          }
        },
        "required": [
          "id",
          "name",
          "color",
          "scope"
        ],
        "description": "AbleFlow - 화면에 붙은 레이블"
      },
      "AbleflowLabelScope": {
        "enum": [
          "WORKSPACE",
          "PROJECT"
        ],
        "description": "AbleFlow - 레이블 범위: 공통(워크스페이스) · 프로젝트 전용"
      },
      "AbleflowMemberRef": {
        "type": "object",
        "properties": {
          "memberId": {
            "type": "string"
          },
          "name": {
            "type": [
              "string",
              "null"
            ]
          },
          "email": {
            "type": [
              "string",
              "null"
            ]
          }
        },
        "required": [
          "memberId"
        ],
        "description": "AbleFlow - 사람 표시. 이름 · 이메일은 계정 DB 에서 채운다(찾지 못하면 name 없음). 공개 API 토큰에 members:read 가 없으면 email 이 빠진다"
      },
      "AbleflowMonitorSkipReason": {
        "enum": [
          "NO_TARGET",
          "SCREEN_LIMIT",
          "IN_PROGRESS",
          "PLAN_LIMIT",
          "FAILED"
        ],
        "description": "일정이 회차를 만들지 않고 건너뛴 까닭.\nNO_TARGET 대상 화면 없음(레이블에 화면 없음 · 지워짐 · 뷰포트에 맞는 화면 없음) · SCREEN_LIMIT 한 회차 화면 수 한도 초과 ·\nIN_PROGRESS 진행 중 회차 있음 · PLAN_LIMIT 요금제 한도(분석 수 · 진단 회차) 또는 정지 · FAILED 만들다 오류"
      },
      "AbleflowRegion": {
        "type": "object",
        "properties": {
          "x": {
            "type": "number"
          },
          "y": {
            "type": "number"
          },
          "width": {
            "type": "number"
          },
          "height": {
            "type": "number"
          }
        },
        "required": [
          "x",
          "y",
          "width",
          "height"
        ],
        "description": "AbleFlow - 캡처 이미지 대비 0~1 비율"
      },
      "AbleflowReportTier": {
        "enum": [
          "SUMMARY",
          "FULL"
        ],
        "description": "AbleFlow - 리포트 등급. SUMMARY 는 화면마다 위험 구간 3개 · 개선 우선순위 5개, FULL 은 전부(요금제는 P2)"
      },
      "AbleflowScoreSet": {
        "type": "object",
        "properties": {
          "uxRiskScore": {
            "type": "number"
          },
          "cognitionScore": {
            "type": "number"
          },
          "grade": {
            "$ref": "#/components/schemas/AbleflowGrade"
          },
          "criteria": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "criterion": {
                  "$ref": "#/components/schemas/AbleflowCriterion"
                },
                "score": {
                  "type": "number"
                },
                "findingCount": {
                  "type": "number"
                }
              },
              "required": [
                "criterion",
                "score",
                "findingCount"
              ]
            }
          }
        },
        "required": [
          "uxRiskScore",
          "cognitionScore",
          "grade",
          "criteria"
        ],
        "description": "AbleFlow - 점수 묶음. 위험도 0~100(높을수록 위험) · 이해도 = 100 - 위험도. criteria 는 평가한 기준만(AI 판단이 꺼져 있거나 답을 받지 못한 기준은 빠진다)"
      },
      "AbleflowScreenResultStatus": {
        "enum": [
          "QUEUED",
          "CAPTURING",
          "EXTRACTING",
          "ANALYZING",
          "SCORING",
          "COMPLETED",
          "FAILED"
        ],
        "description": "AbleFlow - 분석 하나의 단계(IMAGE 화면은 EXTRACTING 을 건너뛴다)"
      },
      "AbleflowScreenSource": {
        "enum": [
          "URL",
          "IMAGE",
          "EXTENSION"
        ],
        "description": "AbleFlow - 화면을 넣은 방식(구분 칸). EXTENSION 은 확장 프로그램(P1, 만드는 API 없음)"
      },
      "AbleflowScreenViewport": {
        "anyOf": [
          {
            "$ref": "#/components/schemas/AbleflowViewport"
          },
          {
            "const": "BOTH"
          }
        ]
      },
      "AbleflowSeverity": {
        "enum": [
          "HIGH",
          "MEDIUM",
          "LOW"
        ],
        "description": "AbleFlow - 위험 구간 심각도(화면 표기 높음 · 보통 · 낮음)"
      },
      "AbleflowViewport": {
        "enum": [
          "PC",
          "MOBILE"
        ],
        "description": "AbleFlow - 분석 뷰포트(진단 기본값). 화면은 BOTH 까지"
      },
      "AbleflowWorkspaceRole": {
        "enum": [
          "OWNER",
          "ADMIN",
          "MEMBER"
        ],
        "description": "AbleFlow - 워크스페이스 안 역할. OWNER · ADMIN 은 프로젝트 삭제 · 구성원 관리 가능"
      },
      "CreateDiagnosisRequestBody": {
        "type": "object",
        "properties": {
          "screenIds": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "직접 고른 화면(모두 이 프로젝트 화면이어야 한다, 아니면 400 BAD_REQUEST)"
          },
          "labelIds": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "레이블로 고른 화면(공통 · 이 프로젝트 전용, 실행 시점의 화면 목록으로 고정)"
          },
          "viewports": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/components/schemas/AbleflowViewport"
            },
            "description": "없거나 비면 프로젝트 진단 기본값"
          },
          "criteria": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/components/schemas/AbleflowCriterion"
            },
            "description": "없거나 비면 프로젝트 진단 기본값"
          },
          "excludeRequiresAuth": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "true 면 로그인이 필요한 URL 화면은 빼고 만든다(기본 false = 넣고 열리지 않으면 LOGIN_REQUIRED 실패)"
          }
        }
      },
      "CreateDiagnosisRequestPath": {
        "type": "object",
        "properties": {
          "projectId": {
            "type": "string"
          }
        },
        "required": [
          "projectId"
        ]
      },
      "CreateDiagnosisResponse": {
        "description": "trigger 는 MANUAL 고정. 실행 권한은 구성원 누구나(화면 관리와 같다)"
      },
      "DiagnosisCompareSide": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "seq": {
            "type": "number"
          },
          "finishedAt": {
            "type": "string"
          },
          "scores": {
            "$ref": "#/components/schemas/AbleflowScoreSet"
          },
          "scoringVersion": {
            "type": "string"
          }
        },
        "required": [
          "id",
          "seq",
          "finishedAt",
          "scores",
          "scoringVersion"
        ],
        "description": "한 회차 쪽 요약(끝난 회차만)"
      },
      "DiagnosisResponseItem": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "seq": {
            "type": "number",
            "description": "프로젝트 안 표시 번호(#1, #2 …)"
          },
          "trigger": {
            "$ref": "#/components/schemas/AbleflowDiagnosisTrigger"
          },
          "status": {
            "$ref": "#/components/schemas/AbleflowDiagnosisStatus"
          },
          "screenCount": {
            "type": "number"
          },
          "analysisCount": {
            "type": "number",
            "description": "분석 수(화면 × 뷰포트)"
          },
          "completedCount": {
            "type": "number",
            "description": "끝난(COMPLETED · FAILED) 분석 수"
          },
          "failedCount": {
            "type": "number"
          },
          "uxRiskScore": {
            "type": [
              "number",
              "null"
            ],
            "description": "끝난 회차(COMPLETED · PARTIAL)만"
          },
          "grade": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/AbleflowGrade"
              },
              {
                "type": "null"
              }
            ]
          },
          "previousUxRiskScore": {
            "type": [
              "number",
              "null"
            ],
            "description": "바로 앞 끝난 회차의 대표 위험도(변화 ▲▼)"
          },
          "failureReason": {
            "type": [
              "string",
              "null"
            ],
            "description": "FAILED 일 때 한 줄 이유(한국어 원문)"
          },
          "failureCode": {
            "type": [
              "string",
              "null"
            ],
            "description": "회차 실패 문구 키(예: allAnalysesFailed, 키 목록은 AbleflowFailureMessageArgs 설명). 키를 쓰기 전 행은 빠진다 — 그때는 failureReason 을 그대로 보인다"
          },
          "requestedBy": {
            "$ref": "#/components/schemas/AbleflowMemberRef"
          },
          "createdAt": {
            "type": "string"
          },
          "startedAt": {
            "type": [
              "string",
              "null"
            ]
          },
          "finishedAt": {
            "type": [
              "string",
              "null"
            ]
          }
        },
        "required": [
          "id",
          "seq",
          "trigger",
          "status",
          "screenCount",
          "analysisCount",
          "completedCount",
          "failedCount",
          "requestedBy",
          "createdAt"
        ],
        "description": "회차 목록 한 줄"
      },
      "FileInfoResponse": {
        "type": "object",
        "properties": {
          "objectKey": {
            "type": "string",
            "description": "파일 object key"
          },
          "fileName": {
            "type": "string",
            "description": "파일명"
          },
          "getUrl": {
            "type": "string",
            "description": "파일 다운로드 URL"
          },
          "alt": {
            "type": [
              "string",
              "null"
            ],
            "description": "대체 텍스트(요청 언어로 저장된 것이 있을 때만)"
          },
          "createdAt": {
            "type": [
              "string",
              "null"
            ],
            "description": "올린 시각(응답에서는 대개 빠진다 — 파일 응답 변환이 비운다)"
          }
        },
        "required": [
          "objectKey",
          "fileName",
          "getUrl"
        ],
        "description": "API 공통 - 파일 응답"
      },
      "GetCurrentApiTokenResponse": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string",
            "description": "발급할 때 정한 이름"
          },
          "tokenPrefix": {
            "type": [
              "string",
              "null"
            ],
            "description": "토큰을 알아보는 앞부분(afk_ + 4자). 데모 토큰 · 이 칸이 생기기 전에 만든 토큰은 빠진다"
          },
          "scopes": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/AbleflowApiTokenScope"
            }
          },
          "expiresAt": {
            "type": [
              "string",
              "null"
            ],
            "description": "없으면 만료되지 않는다(빠진다)"
          },
          "pinnedVersion": {
            "type": [
              "string",
              "null"
            ],
            "description": "AbleFlow-Version 헤더가 없을 때 쓸 버전. 없으면 늘 최신(빠진다)"
          },
          "demo": {
            "type": "boolean",
            "description": "데모 토큰(문서 사이트용 · 읽기 전용)이면 true"
          },
          "workspaceId": {
            "type": "string",
            "description": "토큰이 묶인 워크스페이스. 다른 워크스페이스의 자원은 404"
          },
          "workspaceName": {
            "type": "string"
          }
        },
        "required": [
          "name",
          "scopes",
          "demo",
          "workspaceId",
          "workspaceName"
        ]
      },
      "GetDiagnosisCompareRequestParams": {
        "type": "object",
        "properties": {
          "base": {
            "type": "string",
            "description": "기준(앞) 회차 UUID"
          },
          "target": {
            "type": "string",
            "description": "비교(뒤) 회차 UUID"
          }
        },
        "required": [
          "base",
          "target"
        ]
      },
      "GetDiagnosisCompareResponse": {
        "type": "object",
        "properties": {
          "base": {
            "$ref": "#/components/schemas/DiagnosisCompareSide"
          },
          "target": {
            "$ref": "#/components/schemas/DiagnosisCompareSide"
          },
          "sameScoringVersion": {
            "type": "boolean",
            "description": "산식 버전이 다르면 false(화면에 안내)"
          },
          "criteria": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "criterion": {
                  "$ref": "#/components/schemas/AbleflowCriterion"
                },
                "baseScore": {
                  "type": [
                    "number",
                    "null"
                  ]
                },
                "targetScore": {
                  "type": [
                    "number",
                    "null"
                  ]
                },
                "delta": {
                  "type": [
                    "number",
                    "null"
                  ]
                }
              },
              "required": [
                "criterion"
              ]
            },
            "description": "한쪽이라도 점수가 난 기준(기준 순서). 한쪽에만 있으면 그쪽 점수만 있고 delta 는 빠진다"
          },
          "screens": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "screenId": {
                  "type": "string"
                },
                "screenName": {
                  "type": "string"
                },
                "viewport": {
                  "$ref": "#/components/schemas/AbleflowViewport"
                },
                "change": {
                  "enum": [
                    "IMPROVED",
                    "WORSENED",
                    "SAME",
                    "ADDED",
                    "REMOVED"
                  ]
                },
                "baseScreenResultId": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "targetScreenResultId": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "baseUxRiskScore": {
                  "type": [
                    "number",
                    "null"
                  ]
                },
                "targetUxRiskScore": {
                  "type": [
                    "number",
                    "null"
                  ]
                },
                "baseCapture": {
                  "anyOf": [
                    {
                      "$ref": "#/components/schemas/FileInfoResponse"
                    },
                    {
                      "type": "null"
                    }
                  ],
                  "description": "비교 슬라이더(캡처가 있을 때만)"
                },
                "targetCapture": {
                  "anyOf": [
                    {
                      "$ref": "#/components/schemas/FileInfoResponse"
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "baseFailed": {
                  "anyOf": [
                    {
                      "const": true
                    },
                    {
                      "type": "null"
                    }
                  ],
                  "description": "그 회차에 분석이 있었지만 실패했다(ADDED · REMOVED 가 화면이 없던 것이 아님). 실패일 때만 true, 아니면 빠진다"
                },
                "targetFailed": {
                  "anyOf": [
                    {
                      "const": true
                    },
                    {
                      "type": "null"
                    }
                  ]
                }
              },
              "required": [
                "screenId",
                "screenName",
                "viewport",
                "change"
              ]
            },
            "description": "화면 · 뷰포트별(화면 순서 → 뷰포트). 위험도가 있는(COMPLETED) 분석끼리 견주고, 한쪽에만 있으면(다른 쪽이 없거나 실패) ADDED · REMOVED"
          },
          "findings": {
            "type": "object",
            "properties": {
              "resolved": {
                "type": "number"
              },
              "added": {
                "type": "number"
              },
              "remaining": {
                "type": "number"
              },
              "worsened": {
                "type": "number",
                "description": "남은 것 중 심각도가 올라간 것(악화)"
              },
              "items": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "fingerprint": {
                      "type": "string"
                    },
                    "title": {
                      "type": "string",
                      "description": "비교 회차의 제목(해소된 것은 기준 회차의 제목)"
                    },
                    "titleKey": {
                      "type": [
                        "string",
                        "null"
                      ],
                      "description": "규칙 위험 구간에서 온 제목의 문구 키(키 목록은 AbleflowFindingMessageArgs 설명). AI 판단 제목 · 키가 없는 옛 행은 빠진다 — 그때는 title 을 그대로 보인다"
                    },
                    "titleArgs": {
                      "anyOf": [
                        {
                          "$ref": "#/components/schemas/AbleflowFindingMessageArgs"
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "문구 키의 이름 붙은 값(값 자리가 없는 문구 · 키가 없으면 빠진다)"
                    },
                    "criterion": {
                      "$ref": "#/components/schemas/AbleflowCriterion"
                    },
                    "change": {
                      "enum": [
                        "RESOLVED",
                        "ADDED",
                        "REMAINING"
                      ]
                    },
                    "screenId": {
                      "type": "string",
                      "description": "레이블 탭으로 거를 때 쓰는 화면 id"
                    },
                    "screenName": {
                      "type": "string"
                    },
                    "viewport": {
                      "$ref": "#/components/schemas/AbleflowViewport"
                    },
                    "baseSeverity": {
                      "anyOf": [
                        {
                          "$ref": "#/components/schemas/AbleflowSeverity"
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "그 회차에서 같은 fingerprint 의 가장 높은 심각도(없는 쪽은 빠진다)"
                    },
                    "targetSeverity": {
                      "anyOf": [
                        {
                          "$ref": "#/components/schemas/AbleflowSeverity"
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "worsened": {
                      "type": "boolean",
                      "description": "남았는데 심각도가 올라감"
                    },
                    "baseFindingId": {
                      "type": [
                        "string",
                        "null"
                      ],
                      "description": "그 회차에서 이 fingerprint 를 대표하는 위험 구간 id(baseSeverity · targetSeverity 를 낸 것, 없는 쪽은 빠진다).\nRESOLVED 는 baseFindingId 만, ADDED 는 targetFindingId 만, REMAINING 은 둘 다. 위험 구간 상세로 바로 이동할 때 쓴다\n(그 분석은 같은 screenId · viewport 의 screens[].baseScreenResultId · targetScreenResultId)"
                    },
                    "targetFindingId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  },
                  "required": [
                    "fingerprint",
                    "title",
                    "criterion",
                    "change",
                    "screenId",
                    "screenName",
                    "viewport",
                    "worsened"
                  ]
                },
                "description": "fingerprint 별(ADDED → RESOLVED → REMAINING → 심각도 높은 순 → 화면)"
              }
            },
            "required": [
              "resolved",
              "added",
              "remaining",
              "worsened",
              "items"
            ],
            "description": "양쪽 모두 COMPLETED 인 분석에서 양쪽 모두 평가한 기준의 위험 구간만 fingerprint 로 견준다"
          }
        },
        "required": [
          "base",
          "target",
          "sameScoringVersion",
          "criteria",
          "screens",
          "findings"
        ]
      },
      "GetDiagnosisDefaultsRequestPath": {
        "type": "object",
        "properties": {
          "projectId": {
            "type": "string"
          }
        },
        "required": [
          "projectId"
        ]
      },
      "GetDiagnosisDefaultsResponse": {
        "type": "object",
        "properties": {
          "viewports": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/AbleflowViewport"
            },
            "description": "enum 순서"
          },
          "criteria": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/AbleflowCriterion"
            }
          },
          "isDefault": {
            "type": "boolean",
            "description": "저장한 적이 없으면 true(서버 기본값)"
          }
        },
        "required": [
          "viewports",
          "criteria",
          "isDefault"
        ]
      },
      "GetDiagnosisPaginationRequestParams": {
        "allOf": [
          {
            "$ref": "#/components/schemas/PaginationRequest"
          },
          {
            "type": "object",
            "properties": {
              "status": {
                "type": [
                  "array",
                  "null"
                ],
                "items": {
                  "$ref": "#/components/schemas/AbleflowDiagnosisStatus"
                },
                "description": "콤마 구분"
              },
              "trigger": {
                "type": [
                  "array",
                  "null"
                ],
                "items": {
                  "$ref": "#/components/schemas/AbleflowDiagnosisTrigger"
                }
              },
              "from": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "만든 시각 범위(ISO-8601, from 포함 · to 미포함)"
              },
              "to": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "requestedBy": {
                "type": [
                  "array",
                  "null"
                ],
                "items": {
                  "type": "string"
                },
                "description": "실행한 사람 memberId(콤마 구분)"
              }
            }
          }
        ],
        "description": "limit 최대 10000(공통 PaginationRequest.MAX_LIMIT)"
      },
      "GetDiagnosisPaginationRequestPath": {
        "type": "object",
        "properties": {
          "projectId": {
            "type": "string"
          }
        },
        "required": [
          "projectId"
        ]
      },
      "GetDiagnosisPaginationResponse": {
        "type": "object",
        "properties": {
          "count": {
            "type": "number",
            "description": "전체 개수"
          },
          "prev": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "이전 페이지 query string. 키는 늘 있고, 첫 페이지면 null"
          },
          "next": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "다음 페이지 query string. 키는 늘 있고, 마지막 페이지면 null"
          },
          "results": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/DiagnosisResponseItem"
            },
            "description": "조회 결과"
          }
        },
        "required": [
          "count",
          "prev",
          "next",
          "results"
        ]
      },
      "GetDiagnosisProgressRequestPath": {
        "type": "object",
        "properties": {
          "diagnosisId": {
            "type": "string"
          }
        },
        "required": [
          "diagnosisId"
        ]
      },
      "GetDiagnosisProgressResponse": {
        "type": "object",
        "properties": {
          "status": {
            "$ref": "#/components/schemas/AbleflowDiagnosisStatus"
          },
          "analysisCount": {
            "type": "number"
          },
          "completedCount": {
            "type": "number"
          },
          "failedCount": {
            "type": "number"
          },
          "estimatedRemainingSeconds": {
            "type": [
              "number",
              "null"
            ],
            "description": "진행 중일 때 남은 분석 수 × 최근 20개 분석 평균 처리 시간(모르면 빠진다)"
          },
          "items": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "screenResultId": {
                  "type": "string"
                },
                "screenId": {
                  "type": "string"
                },
                "screenName": {
                  "type": "string"
                },
                "url": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "source": {
                  "$ref": "#/components/schemas/AbleflowScreenSource"
                },
                "viewport": {
                  "$ref": "#/components/schemas/AbleflowViewport"
                },
                "status": {
                  "$ref": "#/components/schemas/AbleflowScreenResultStatus"
                },
                "uxRiskScore": {
                  "type": [
                    "number",
                    "null"
                  ],
                  "description": "COMPLETED 만"
                },
                "topFinding": {
                  "type": [
                    "object",
                    "null"
                  ],
                  "properties": {
                    "criterion": {
                      "$ref": "#/components/schemas/AbleflowCriterion"
                    },
                    "title": {
                      "type": "string"
                    },
                    "titleKey": {
                      "type": [
                        "string",
                        "null"
                      ],
                      "description": "규칙 위험 구간에서 온 제목의 문구 키(키 목록은 AbleflowFindingMessageArgs 설명). AI 판단 제목 · 키가 없는 옛 행은 빠진다 — 그때는 title 을 그대로 보인다"
                    },
                    "titleArgs": {
                      "anyOf": [
                        {
                          "$ref": "#/components/schemas/AbleflowFindingMessageArgs"
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "문구 키의 이름 붙은 값(값 자리가 없는 문구 · 키가 없으면 빠진다)"
                    }
                  },
                  "required": [
                    "criterion",
                    "title"
                  ],
                  "description": "가장 심각한 위험 구간 한 줄(심각도 → 만든 순)"
                },
                "failureReason": {
                  "anyOf": [
                    {
                      "$ref": "#/components/schemas/AbleflowFailureReason"
                    },
                    {
                      "type": "null"
                    }
                  ],
                  "description": "FAILED 만"
                },
                "failureDetail": {
                  "type": [
                    "string",
                    "null"
                  ],
                  "description": "FAILED 만. 한 줄 이유(한국어 원문 — AbleFlow 웹은 접기 영역 \"기술 정보\"에 보인다). 서버가 만든 실패 문구면 failureCode · failureArgs 가 함께 나간다.\nAI 판단 비용 상한(aiBudgetExceeded) · 장부 오류(aiCallFailed)는 사용량 장부의 원인 글 그대로다(예: \"이번 달 'AbleFlow 화면 판단' 기능의 AI 사용 한도(… USD)를 모두 사용했습니다. …\")"
                },
                "failureCode": {
                  "type": [
                    "string",
                    "null"
                  ],
                  "description": "실패 문구 키(예: pageNotFound, 키 목록은 AbleflowFailureMessageArgs 설명). 키를 쓰기 전 옛 행은 빠진다 — 그때는 failureDetail 을 그대로 보인다"
                },
                "failureArgs": {
                  "anyOf": [
                    {
                      "$ref": "#/components/schemas/AbleflowFailureMessageArgs"
                    },
                    {
                      "type": "null"
                    }
                  ],
                  "description": "실패 문구의 이름 붙은 값(값 자리가 없는 문구 · 키가 없으면 빠진다)"
                }
              },
              "required": [
                "screenResultId",
                "screenId",
                "screenName",
                "source",
                "viewport",
                "status"
              ]
            },
            "description": "화면 순서 · 뷰포트 순"
          }
        },
        "required": [
          "status",
          "analysisCount",
          "completedCount",
          "failedCount",
          "items"
        ]
      },
      "GetDiagnosisRequestPath": {
        "type": "object",
        "properties": {
          "diagnosisId": {
            "type": "string"
          }
        },
        "required": [
          "diagnosisId"
        ]
      },
      "GetDiagnosisResponse": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "projectId": {
            "type": "string"
          },
          "seq": {
            "type": "number"
          },
          "trigger": {
            "$ref": "#/components/schemas/AbleflowDiagnosisTrigger"
          },
          "status": {
            "$ref": "#/components/schemas/AbleflowDiagnosisStatus"
          },
          "criteria": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/AbleflowCriterion"
            }
          },
          "viewports": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/AbleflowViewport"
            }
          },
          "scoringVersion": {
            "type": "string",
            "description": "산식 버전(지금 \"2026.11-r2\"). 지난 회차와 다르면 비교에 안내"
          },
          "screenCount": {
            "type": "number"
          },
          "analysisCount": {
            "type": "number"
          },
          "completedCount": {
            "type": "number"
          },
          "failedCount": {
            "type": "number"
          },
          "findingCount": {
            "type": "number"
          },
          "scores": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/AbleflowScoreSet"
              },
              {
                "type": "null"
              }
            ],
            "description": "끝난 회차만"
          },
          "previous": {
            "type": [
              "object",
              "null"
            ],
            "properties": {
              "id": {
                "type": "string"
              },
              "seq": {
                "type": "number"
              },
              "scores": {
                "$ref": "#/components/schemas/AbleflowScoreSet",
                "description": "앞 회차는 끝난 회차(COMPLETED · PARTIAL)만이라 점수가 늘 있다"
              },
              "scoringVersion": {
                "type": "string"
              }
            },
            "required": [
              "id",
              "seq",
              "scores",
              "scoringVersion"
            ],
            "description": "바로 앞 끝난 회차(없으면 빠진다)"
          },
          "failureReason": {
            "type": [
              "string",
              "null"
            ],
            "description": "FAILED 일 때 한 줄 이유(한국어 원문)"
          },
          "failureCode": {
            "type": [
              "string",
              "null"
            ],
            "description": "회차 실패 문구 키(예: allAnalysesFailed, 키 목록은 AbleflowFailureMessageArgs 설명). 키를 쓰기 전 행은 빠진다 — 그때는 failureReason 을 그대로 보인다"
          },
          "requestedBy": {
            "$ref": "#/components/schemas/AbleflowMemberRef"
          },
          "createdAt": {
            "type": "string"
          },
          "startedAt": {
            "type": [
              "string",
              "null"
            ]
          },
          "finishedAt": {
            "type": [
              "string",
              "null"
            ]
          }
        },
        "required": [
          "id",
          "projectId",
          "seq",
          "trigger",
          "status",
          "criteria",
          "viewports",
          "scoringVersion",
          "screenCount",
          "analysisCount",
          "completedCount",
          "failedCount",
          "findingCount",
          "requestedBy",
          "createdAt"
        ]
      },
      "GetDiagnosisTrendRequestParams": {
        "type": "object",
        "properties": {
          "from": {
            "type": [
              "string",
              "null"
            ],
            "description": "만든 시각 범위(ISO-8601, from 포함 · to 미포함 — 진단 기록 목록과 같은 기준). 둘 다 없으면 최근 12회차, 있으면 최대 10000"
          },
          "to": {
            "type": [
              "string",
              "null"
            ]
          },
          "trigger": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/components/schemas/AbleflowDiagnosisTrigger"
            },
            "description": "콤마 구분, 없으면 전부"
          }
        }
      },
      "GetDiagnosisTrendRequestPath": {
        "type": "object",
        "properties": {
          "projectId": {
            "type": "string"
          }
        },
        "required": [
          "projectId"
        ]
      },
      "GetDiagnosisTrendResponse": {
        "type": "object",
        "properties": {
          "alertDelta": {
            "type": [
              "number",
              "null"
            ],
            "description": "알림 기준선(반복 진단 스케줄 alertDelta). 스케줄 기능 전이라 지금은 늘 빠진다"
          },
          "points": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "diagnosisId": {
                  "type": "string"
                },
                "seq": {
                  "type": "number"
                },
                "trigger": {
                  "$ref": "#/components/schemas/AbleflowDiagnosisTrigger"
                },
                "status": {
                  "enum": [
                    "COMPLETED",
                    "PARTIAL"
                  ]
                },
                "finishedAt": {
                  "type": "string"
                },
                "uxRiskScore": {
                  "type": "number",
                  "description": "전체(대표 위험도, 0~100 높을수록 위험)"
                },
                "criteria": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "properties": {
                      "criterion": {
                        "$ref": "#/components/schemas/AbleflowCriterion"
                      },
                      "score": {
                        "type": "number"
                      }
                    },
                    "required": [
                      "criterion",
                      "score"
                    ]
                  },
                  "description": "기준별(기준 순서). 그 회차가 고르지 않았거나 평가하지 못한 기준은 빠진다(선을 끊어 그린다)"
                },
                "scoringVersion": {
                  "type": "string",
                  "description": "지난 점과 다르면 화면에 안내"
                },
                "alerted": {
                  "type": "boolean",
                  "description": "이 회차에서 알림이 갔는지(반복 진단 알림 기능 전이라 지금은 늘 false)"
                }
              },
              "required": [
                "diagnosisId",
                "seq",
                "trigger",
                "status",
                "finishedAt",
                "uxRiskScore",
                "criteria",
                "scoringVersion",
                "alerted"
              ]
            }
          }
        },
        "required": [
          "points"
        ]
      },
      "GetFindingPaginationRequestParams": {
        "allOf": [
          {
            "$ref": "#/components/schemas/PaginationRequest"
          },
          {
            "type": "object",
            "properties": {
              "screenResultId": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "화면 결과 하나만(형식이 UUID 가 아니면 400)"
              },
              "criterion": {
                "type": [
                  "array",
                  "null"
                ],
                "items": {
                  "$ref": "#/components/schemas/AbleflowCriterion"
                },
                "description": "콤마 구분"
              },
              "severity": {
                "type": [
                  "array",
                  "null"
                ],
                "items": {
                  "$ref": "#/components/schemas/AbleflowSeverity"
                }
              }
            }
          }
        ],
        "description": "limit 최대 10000"
      },
      "GetFindingPaginationRequestPath": {
        "type": "object",
        "properties": {
          "diagnosisId": {
            "type": "string"
          }
        },
        "required": [
          "diagnosisId"
        ]
      },
      "GetFindingPaginationResponse": {
        "type": "object",
        "properties": {
          "count": {
            "type": "number",
            "description": "전체 개수"
          },
          "prev": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "이전 페이지 query string. 키는 늘 있고, 첫 페이지면 null"
          },
          "next": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "다음 페이지 query string. 키는 늘 있고, 마지막 페이지면 null"
          },
          "results": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/GetFindingPaginationResponseItem"
            },
            "description": "조회 결과"
          }
        },
        "required": [
          "count",
          "prev",
          "next",
          "results"
        ]
      },
      "GetFindingPaginationResponseItem": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "screenResultId": {
            "type": "string"
          },
          "fingerprint": {
            "type": "string",
            "description": "화면 id + 뷰포트 + 기준 + 요소 단서의 SHA-256(전후 비교)"
          },
          "criterion": {
            "$ref": "#/components/schemas/AbleflowCriterion"
          },
          "severity": {
            "$ref": "#/components/schemas/AbleflowSeverity"
          },
          "title": {
            "type": "string",
            "description": "한 줄 제목(예: \"글자 대비가 낮습니다(2.32:1)\"). 규칙 제목은 한국어 원문(titleKey 로 옮긴다), AI 판단 제목은 요청 언어(?locale=) 번역이 있으면 그 글"
          },
          "titleKey": {
            "type": [
              "string",
              "null"
            ],
            "description": "규칙 위험 구간에서 온 제목의 문구 키(키 목록은 AbleflowFindingMessageArgs 설명). AI 판단 제목 · 키가 없는 옛 행은 빠진다 — 그때는 title 을 그대로 보인다"
          },
          "titleArgs": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/AbleflowFindingMessageArgs"
              },
              {
                "type": "null"
              }
            ],
            "description": "문구 키의 이름 붙은 값(값 자리가 없는 문구 · 키가 없으면 빠진다)"
          },
          "region": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/AbleflowRegion"
              },
              {
                "type": "null"
              }
            ],
            "description": "캡처 이미지 대비 0~1 비율. 규칙 계산은 늘 채우고, 영역을 못 정한 판단 결과면 빠진다"
          },
          "elementHint": {
            "type": [
              "string",
              "null"
            ],
            "description": "요소 단서(셀렉터 · 역할 · 글자). 이미지 화면이면 추정. AI 판단이 쓴 단서는 요청 언어(?locale=) 번역이 있으면 그 글(화면 속 글자 · 셀렉터는 그대로 둔다),\n규칙 단서는 저장된 값 그대로. 회차 사이 같은 위험 구간으로 묶는 일(fingerprint · groupKey)은 서버가 저장된 한국어 원문으로 한다"
          },
          "elementHintKey": {
            "type": [
              "string",
              "null"
            ],
            "description": "규칙이 만든 고정 단서의 표시용 키(웹 메시지 키). 지금은 firstScreen(\"첫 화면\", 첫 화면 정보 밀도)뿐. 셀렉터 · AI 단서는 빠진다 — 그때는 elementHint 를 그대로 보인다"
          },
          "evidence": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/AbleflowEvidence"
              },
              {
                "type": "null"
              }
            ],
            "description": "근거 수치(엔진은 위험 구간마다 하나)"
          },
          "priorityRank": {
            "type": [
              "number",
              "null"
            ],
            "description": "이 위험 구간이 속한 개선 우선순위 묶음의 순위(1부터). 끝난 회차만(진행 중이면 없음)"
          },
          "alsoOn": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "screenResultId": {
                  "type": "string"
                },
                "screenName": {
                  "type": "string"
                },
                "viewport": {
                  "$ref": "#/components/schemas/AbleflowViewport"
                }
              },
              "required": [
                "screenResultId",
                "screenName",
                "viewport"
              ]
            },
            "description": "같은 묶음 키(groupKey)의 위험 구간이 있는 다른 분석(화면 순서 · 뷰포트 순)"
          },
          "impact": {
            "type": [
              "string",
              "null"
            ],
            "description": "영향 설명 한 줄 · 고치는 품(기준별 고치는 방법에서 읽는다. 고정표가 없으면 빠진다. impact 는 요청 언어 번역이 있으면 그 글)"
          },
          "effort": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/AbleflowEffort"
              },
              {
                "type": "null"
              }
            ]
          },
          "guide": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/AbleflowGuide"
              },
              {
                "type": "null"
              }
            ],
            "description": "전문가 고정표(expert)와 AI 제안(ai, AI 위험 구간에 제안이 있을 때만)"
          }
        },
        "required": [
          "id",
          "screenResultId",
          "fingerprint",
          "criterion",
          "severity",
          "title",
          "alsoOn"
        ],
        "description": "위험 구간 한 줄"
      },
      "GetIssueCountsRequestParams": {
        "type": "object",
        "properties": {
          "keyword": {
            "type": [
              "string",
              "null"
            ],
            "description": "제목 검색어(대소문자 무시). 한국어 원문 제목과 요청 언어(?locale= en · ja · zh-CN · zh-Hant)의 AI 제목 번역에서 찾는다(OR)"
          },
          "titleKeys": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "제목 문구 키(콤마 구분, 예: textContrastLow — 키 목록은 AbleflowFindingMessageArgs 설명). keyword 와 함께 오면 제목에 keyword 가 들어 있거나 제목 문구 키가 이 중 하나인 과제(OR).\n규칙 제목 원문은 한국어라 다른 언어 화면의 검색어는 원문에 없다 — 화면 언어 메시지에서 검색어가 들어간 키를 찾아 같이 보낸다\n(AI 제목은 서버가 요청 언어 번역에서 찾는다). 모르는 키는 무시한다(형식이 틀리면 400)"
          },
          "projectIds": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "콤마 구분"
          },
          "criterion": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/components/schemas/AbleflowCriterion"
            }
          },
          "severity": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/components/schemas/AbleflowSeverity"
            }
          },
          "assignee": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "담당 memberId(콤마 구분) · \"me\" 는 나 · \"none\" 은 담당 없음. 그 밖의 값은 400"
          }
        }
      },
      "GetIssueCountsRequestPath": {
        "type": "object",
        "properties": {
          "workspaceId": {
            "type": "string"
          }
        },
        "required": [
          "workspaceId"
        ]
      },
      "GetIssueCountsResponse": {
        "type": "object",
        "properties": {
          "total": {
            "type": "number"
          },
          "byStatus": {
            "type": "object",
            "properties": {
              "TODO": {
                "type": "number"
              },
              "IN_PROGRESS": {
                "type": "number"
              },
              "IN_REVIEW": {
                "type": "number"
              },
              "DONE": {
                "type": "number"
              },
              "ON_HOLD": {
                "type": "number"
              },
              "DISMISSED": {
                "type": "number"
              }
            },
            "required": [
              "TODO",
              "IN_PROGRESS",
              "IN_REVIEW",
              "DONE",
              "ON_HOLD",
              "DISMISSED"
            ],
            "description": "모든 상태를 0 까지 채운다"
          }
        },
        "required": [
          "total",
          "byStatus"
        ]
      },
      "GetIssuePaginationRequestParams": {
        "allOf": [
          {
            "$ref": "#/components/schemas/PaginationRequest"
          },
          {
            "type": "object",
            "properties": {
              "keyword": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "제목 검색어(대소문자 무시). 한국어 원문 제목과 요청 언어(?locale= en · ja · zh-CN · zh-Hant)의 AI 제목 번역에서 찾는다(OR)"
              },
              "titleKeys": {
                "type": [
                  "array",
                  "null"
                ],
                "items": {
                  "type": "string"
                },
                "description": "제목 문구 키(콤마 구분, 예: textContrastLow — 키 목록은 AbleflowFindingMessageArgs 설명). keyword 와 함께 오면 제목에 keyword 가 들어 있거나 제목 문구 키가 이 중 하나인 과제(OR).\n규칙 제목 원문은 한국어라 다른 언어 화면의 검색어는 원문에 없다 — 화면 언어 메시지에서 검색어가 들어간 키를 찾아 같이 보낸다\n(AI 제목은 서버가 요청 언어 번역에서 찾는다). 모르는 키는 무시한다(형식이 틀리면 400)"
              },
              "projectIds": {
                "type": [
                  "array",
                  "null"
                ],
                "items": {
                  "type": "string"
                },
                "description": "콤마 구분"
              },
              "criterion": {
                "type": [
                  "array",
                  "null"
                ],
                "items": {
                  "$ref": "#/components/schemas/AbleflowCriterion"
                }
              },
              "severity": {
                "type": [
                  "array",
                  "null"
                ],
                "items": {
                  "$ref": "#/components/schemas/AbleflowSeverity"
                }
              },
              "status": {
                "type": [
                  "array",
                  "null"
                ],
                "items": {
                  "$ref": "#/components/schemas/AbleflowIssueStatus"
                }
              },
              "assignee": {
                "type": [
                  "array",
                  "null"
                ],
                "items": {
                  "type": "string"
                },
                "description": "담당 memberId(콤마 구분) · \"me\" 는 나 · \"none\" 은 담당 없음. 그 밖의 값은 400"
              }
            }
          }
        ]
      },
      "GetIssuePaginationRequestPath": {
        "type": "object",
        "properties": {
          "workspaceId": {
            "type": "string"
          }
        },
        "required": [
          "workspaceId"
        ]
      },
      "GetIssuePaginationResponse": {
        "type": "object",
        "properties": {
          "count": {
            "type": "number",
            "description": "전체 개수"
          },
          "prev": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "이전 페이지 query string. 키는 늘 있고, 첫 페이지면 null"
          },
          "next": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "다음 페이지 query string. 키는 늘 있고, 마지막 페이지면 null"
          },
          "results": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/IssueResponseItem"
            },
            "description": "조회 결과"
          }
        },
        "required": [
          "count",
          "prev",
          "next",
          "results"
        ]
      },
      "GetIssueRequestPath": {
        "type": "object",
        "properties": {
          "issueId": {
            "type": "string"
          }
        },
        "required": [
          "issueId"
        ]
      },
      "GetIssueResponse": {
        "allOf": [
          {
            "$ref": "#/components/schemas/IssueResponseItem"
          },
          {
            "type": "object",
            "properties": {
              "memo": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "findings": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "findingId": {
                      "type": "string"
                    },
                    "screenResultId": {
                      "type": "string"
                    },
                    "screenName": {
                      "type": "string"
                    },
                    "viewport": {
                      "$ref": "#/components/schemas/AbleflowViewport"
                    },
                    "captureImage": {
                      "anyOf": [
                        {
                          "$ref": "#/components/schemas/FileInfoResponse"
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "캡처(공용 응답 주입기, \"ScreenResult_{id}\" · \"captureImage\"). 저장 못 한 캡처는 없음"
                    },
                    "region": {
                      "anyOf": [
                        {
                          "$ref": "#/components/schemas/AbleflowRegion"
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "severity": {
                      "$ref": "#/components/schemas/AbleflowSeverity"
                    }
                  },
                  "required": [
                    "findingId",
                    "screenResultId",
                    "screenName",
                    "viewport",
                    "severity"
                  ]
                },
                "description": "그 프로젝트의 가장 최근 끝난 회차의 같은 묶음 위험 구간(화면 순서 · 뷰포트 순)"
              },
              "history": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "type": {
                      "enum": [
                        "STATUS",
                        "ASSIGNEE",
                        "VERIFICATION",
                        "MEMO"
                      ]
                    },
                    "from": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "to": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "by": {
                      "anyOf": [
                        {
                          "$ref": "#/components/schemas/AbleflowMemberRef"
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "at": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "type",
                    "at"
                  ]
                },
                "description": "상태 · 담당 · 확인 · 메모 기록(최신순). STATUS 는 상태 이름, ASSIGNEE 는 memberId(비우면 없음), MEMO 는 from · to 없음"
              },
              "evidence": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "근거 한 줄 · 고치는 방법(기준별 고치는 방법)"
              },
              "fix": {
                "type": [
                  "string",
                  "null"
                ]
              }
            },
            "required": [
              "findings",
              "history"
            ]
          }
        ]
      },
      "GetMonitorSchedulesRequestPath": {
        "type": "object",
        "properties": {
          "projectId": {
            "type": "string"
          }
        },
        "required": [
          "projectId"
        ]
      },
      "GetMonitorSchedulesResponse": {
        "type": "array",
        "items": {
          "$ref": "#/components/schemas/GetMonitorSchedulesResponseItem"
        }
      },
      "GetMonitorSchedulesResponseItem": {
        "allOf": [
          {
            "$ref": "#/components/schemas/MonitorScheduleBody"
          },
          {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "timeZone": {
                "type": "string",
                "description": "응답에는 늘 있다(보내지 않았으면 Asia/Seoul)"
              },
              "alertDelta": {
                "type": "number",
                "description": "응답에는 늘 있다(보내지 않았으면 5)"
              },
              "nextRunAts": {
                "type": "array",
                "items": {
                  "type": "string"
                },
                "description": "다음 실행 예정 3개(켜진 WEEKLY 만, 아니면 빈 배열). ISO-8601 UTC"
              },
              "lastDiagnosis": {
                "type": [
                  "object",
                  "null"
                ],
                "properties": {
                  "id": {
                    "type": "string"
                  },
                  "seq": {
                    "type": "number"
                  },
                  "status": {
                    "$ref": "#/components/schemas/AbleflowDiagnosisStatus"
                  },
                  "createdAt": {
                    "type": "string"
                  }
                },
                "required": [
                  "id",
                  "seq",
                  "status",
                  "createdAt"
                ],
                "description": "이 일정이 마지막으로 만든 회차(없거나 지워졌으면 없음)"
              },
              "lastSkip": {
                "type": [
                  "object",
                  "null"
                ],
                "properties": {
                  "reason": {
                    "$ref": "#/components/schemas/AbleflowMonitorSkipReason"
                  },
                  "skippedAt": {
                    "type": "string"
                  }
                },
                "required": [
                  "reason",
                  "skippedAt"
                ],
                "description": "마지막 실행 때 회차를 만들지 않고 건너뛰었으면 그 까닭과 시각(그 뒤 회차를 만들면 없어진다)"
              },
              "webhookUrl": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "AFTER_DEPLOY 만: 배포 파이프라인이 POST 할 웹훅 주소(토큰 없음 — Authorization: Bearer {token} 을 따로 붙인다)"
              },
              "webhookTokenIssuedAt": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "AFTER_DEPLOY 만: 프로젝트 웹훅 토큰을 마지막으로 발급한 시각(발급 전이면 없음)"
              },
              "createdBy": {
                "$ref": "#/components/schemas/AbleflowMemberRef",
                "description": "일정 주인(처음에는 만든 사람, 그 사람이 워크스페이스를 나가거나 내보내지면 워크스페이스 소유자). 이 일정이 만든 회차의 실행한 사람(requestedBy)이 된다"
              },
              "createdAt": {
                "type": "string"
              },
              "updatedAt": {
                "type": "string"
              }
            },
            "required": [
              "id",
              "timeZone",
              "alertDelta",
              "nextRunAts",
              "createdBy",
              "createdAt",
              "updatedAt"
            ]
          }
        ],
        "description": "반복 진단 일정 한 줄"
      },
      "GetPrioritiesRequestParams": {
        "type": "object",
        "properties": {
          "limit": {
            "type": [
              "number",
              "null"
            ],
            "description": "위에서 몇 개(없으면 전부, 1~10000, 공통 목록 상한)"
          },
          "labelIds": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "레이블 범위(콤마 구분, OR). 영향 화면 중 하나라도 그 레이블이 붙은 묶음만"
          }
        }
      },
      "GetPrioritiesRequestPath": {
        "type": "object",
        "properties": {
          "diagnosisId": {
            "type": "string"
          }
        },
        "required": [
          "diagnosisId"
        ]
      },
      "GetPrioritiesResponse": {
        "type": "array",
        "items": {
          "$ref": "#/components/schemas/GetPrioritiesResponseItem"
        }
      },
      "GetPrioritiesResponseItem": {
        "type": "object",
        "properties": {
          "rank": {
            "type": "number",
            "description": "1부터(회차 전체 기준. labelIds 로 걸러도 순위는 그대로)"
          },
          "groupKey": {
            "type": "string",
            "description": "묶음 키 = SHA-256(기준 | 요소 단서). 화면 · 뷰포트를 넣지 않아 여러 화면의 같은 문제가 한 줄이 되고, 회차가 바뀌어도 같은 문제면 같다"
          },
          "title": {
            "type": "string",
            "description": "묶음에서 가장 심각한 위험 구간의 제목"
          },
          "titleKey": {
            "type": [
              "string",
              "null"
            ],
            "description": "규칙 위험 구간에서 온 제목의 문구 키(키 목록은 AbleflowFindingMessageArgs 설명). AI 판단 제목 · 키가 없는 옛 행은 빠진다 — 그때는 title 을 그대로 보인다"
          },
          "titleArgs": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/AbleflowFindingMessageArgs"
              },
              {
                "type": "null"
              }
            ],
            "description": "문구 키의 이름 붙은 값(값 자리가 없는 문구 · 키가 없으면 빠진다)"
          },
          "criterion": {
            "$ref": "#/components/schemas/AbleflowCriterion"
          },
          "severity": {
            "$ref": "#/components/schemas/AbleflowSeverity",
            "description": "묶은 위험 구간 중 가장 높은 것"
          },
          "impact": {
            "type": "number",
            "description": "0~100 = round(영향 분석 위험도 합 ÷ (100 × 회차 분석 수) × 100)"
          },
          "findingIds": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "elementHint": {
            "type": [
              "string",
              "null"
            ],
            "description": "대표 위험 구간(심각도 높은 순 → 먼저 생긴 순)의 요소 단서. 화면이 같은 제목 · 같은 값 줄을 묶어 펼칠 때 요소 이름으로 보인다. 없으면 빠진다"
          },
          "elementHintKey": {
            "type": [
              "string",
              "null"
            ],
            "description": "elementHint 가 규칙의 고정 단서일 때 표시용 키(예: firstScreen). 셀렉터 · AI 단서는 빠진다"
          },
          "screens": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "screenResultId": {
                  "type": "string"
                },
                "screenName": {
                  "type": "string"
                },
                "viewport": {
                  "$ref": "#/components/schemas/AbleflowViewport"
                }
              },
              "required": [
                "screenResultId",
                "screenName",
                "viewport"
              ]
            },
            "description": "영향 화면(화면 순서 · 뷰포트 순)"
          },
          "effort": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/AbleflowEffort"
              },
              {
                "type": "null"
              }
            ],
            "description": "아래 넷은 기준별 고치는 방법(운영 콘솔 고정표)에서 읽는다. 고정표가 없으면 빠진다"
          },
          "component": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/AbleflowGuideComponent"
              },
              {
                "type": "null"
              }
            ]
          },
          "evidence": {
            "type": [
              "string",
              "null"
            ],
            "description": "근거 한 줄 · 고치는 방법"
          },
          "fix": {
            "type": [
              "string",
              "null"
            ]
          },
          "issue": {
            "type": [
              "object",
              "null"
            ],
            "properties": {
              "id": {
                "type": "string"
              },
              "status": {
                "$ref": "#/components/schemas/AbleflowIssueStatus"
              },
              "assignee": {
                "anyOf": [
                  {
                    "$ref": "#/components/schemas/AbleflowMemberRef"
                  },
                  {
                    "type": "null"
                  }
                ]
              }
            },
            "required": [
              "id",
              "status"
            ],
            "description": "이미 담은 열린(DONE · DISMISSED 가 아닌) 과제"
          },
          "guide": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/AbleflowGuide"
              },
              {
                "type": "null"
              }
            ],
            "description": "전문가 고정표(expert)와 AI 제안(ai, 묶음의 대표 위험 구간에 AI 제안이 있을 때만)을 나눠 준다"
          }
        },
        "required": [
          "rank",
          "groupKey",
          "title",
          "criterion",
          "severity",
          "impact",
          "findingIds",
          "screens"
        ],
        "description": "개선 우선순위 한 줄"
      },
      "GetProjectLabelsRequestParams": {
        "type": "object",
        "properties": {
          "scope": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/AbleflowLabelScope"
              },
              {
                "type": "null"
              }
            ],
            "description": "하나만 고를 때. 없으면 둘 다"
          }
        }
      },
      "GetProjectLabelsRequestPath": {
        "type": "object",
        "properties": {
          "projectId": {
            "type": "string"
          }
        },
        "required": [
          "projectId"
        ]
      },
      "GetProjectLabelsResponse": {
        "type": "array",
        "items": {
          "$ref": "#/components/schemas/LabelResponseItem"
        }
      },
      "GetProjectPaginationRequestParams": {
        "allOf": [
          {
            "$ref": "#/components/schemas/PaginationRequest"
          },
          {
            "type": "object",
            "properties": {
              "keyword": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "이름 · 설명 · 기본 주소 검색어(대소문자 무시)"
              },
              "mine": {
                "type": [
                  "boolean",
                  "null"
                ],
                "description": "true 면 내가 만든 프로젝트만"
              }
            }
          }
        ],
        "description": "limit 최대 10000(공통 PaginationRequest.MAX_LIMIT, 넘으면 400)"
      },
      "GetProjectPaginationRequestPath": {
        "type": "object",
        "properties": {
          "workspaceId": {
            "type": "string"
          }
        },
        "required": [
          "workspaceId"
        ]
      },
      "GetProjectPaginationResponse": {
        "type": "object",
        "properties": {
          "count": {
            "type": "number",
            "description": "전체 개수"
          },
          "prev": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "이전 페이지 query string. 키는 늘 있고, 첫 페이지면 null"
          },
          "next": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "다음 페이지 query string. 키는 늘 있고, 마지막 페이지면 null"
          },
          "results": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/GetProjectPaginationResponseItem"
            },
            "description": "조회 결과"
          }
        },
        "required": [
          "count",
          "prev",
          "next",
          "results"
        ]
      },
      "GetProjectPaginationResponseItem": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "description": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "설명. 키는 늘 있고, 비워 두었으면 null"
          },
          "baseUrl": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "서비스 기본 주소. 키는 늘 있고, 없으면 null"
          },
          "createdBy": {
            "type": "string",
            "description": "만든 사람 memberId"
          },
          "createdAt": {
            "type": "string"
          },
          "updatedAt": {
            "type": "string"
          },
          "screenCount": {
            "type": "number",
            "description": "화면 수(파일 연결까지 끝난 화면)"
          },
          "latestDiagnosis": {
            "type": [
              "object",
              "null"
            ],
            "properties": {
              "id": {
                "type": "string"
              },
              "seq": {
                "type": "number"
              },
              "status": {
                "$ref": "#/components/schemas/AbleflowDiagnosisStatus"
              },
              "analysisCount": {
                "type": "number"
              },
              "completedCount": {
                "type": "number"
              },
              "uxRiskScore": {
                "type": [
                  "number",
                  "null"
                ]
              },
              "grade": {
                "anyOf": [
                  {
                    "$ref": "#/components/schemas/AbleflowGrade"
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "createdAt": {
                "type": "string"
              },
              "finishedAt": {
                "type": [
                  "string",
                  "null"
                ]
              }
            },
            "required": [
              "id",
              "seq",
              "status",
              "analysisCount",
              "completedCount",
              "createdAt"
            ],
            "description": "가장 최근 회차(없으면 빠진다). 진행 중이면 completedCount/analysisCount, 끝났으면 위험도 · 등급"
          },
          "thumbnails": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "screenResultId": {
                  "type": "string"
                },
                "screenName": {
                  "type": "string"
                },
                "viewport": {
                  "$ref": "#/components/schemas/AbleflowViewport"
                },
                "captureImage": {
                  "anyOf": [
                    {
                      "$ref": "#/components/schemas/FileInfoResponse"
                    },
                    {
                      "type": "null"
                    }
                  ],
                  "description": "캡처(공용 응답 주입기). 키는 늘 있고, 저장 못 한 캡처는 null"
                }
              },
              "required": [
                "screenResultId",
                "screenName",
                "viewport",
                "captureImage"
              ]
            },
            "description": "가장 최근 끝난 회차의 대표 캡처(화면 순서, 최대 3장. 없으면 [])"
          }
        },
        "required": [
          "id",
          "name",
          "description",
          "baseUrl",
          "createdBy",
          "createdAt",
          "updatedAt",
          "screenCount",
          "thumbnails"
        ]
      },
      "GetProjectRequestPath": {
        "type": "object",
        "properties": {
          "projectId": {
            "type": "string"
          }
        },
        "required": [
          "projectId"
        ]
      },
      "GetProjectResponse": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "workspaceId": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "description": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "설명. 키는 늘 있고, 비워 두었으면 null"
          },
          "baseUrl": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "서비스 기본 주소. 키는 늘 있고, 없으면 null"
          },
          "createdBy": {
            "type": "string",
            "description": "만든 사람 memberId"
          },
          "createdAt": {
            "type": "string"
          },
          "updatedAt": {
            "type": "string"
          },
          "screenCount": {
            "type": "number",
            "description": "화면 수(파일 연결까지 끝난 화면)"
          },
          "latestDiagnosis": {
            "type": [
              "object",
              "null"
            ],
            "properties": {
              "id": {
                "type": "string"
              },
              "seq": {
                "type": "number"
              },
              "status": {
                "$ref": "#/components/schemas/AbleflowDiagnosisStatus"
              },
              "analysisCount": {
                "type": "number"
              },
              "completedCount": {
                "type": "number"
              },
              "uxRiskScore": {
                "type": [
                  "number",
                  "null"
                ]
              },
              "grade": {
                "anyOf": [
                  {
                    "$ref": "#/components/schemas/AbleflowGrade"
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "createdAt": {
                "type": "string"
              },
              "finishedAt": {
                "type": [
                  "string",
                  "null"
                ]
              }
            },
            "required": [
              "id",
              "seq",
              "status",
              "analysisCount",
              "completedCount",
              "createdAt"
            ],
            "description": "가장 최근 회차(없으면 빠진다). 진행 중이면 completedCount/analysisCount, 끝났으면 위험도 · 등급"
          },
          "thumbnails": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "screenResultId": {
                  "type": "string"
                },
                "screenName": {
                  "type": "string"
                },
                "viewport": {
                  "$ref": "#/components/schemas/AbleflowViewport"
                },
                "captureImage": {
                  "anyOf": [
                    {
                      "$ref": "#/components/schemas/FileInfoResponse"
                    },
                    {
                      "type": "null"
                    }
                  ],
                  "description": "캡처(공용 응답 주입기). 키는 늘 있고, 저장 못 한 캡처는 null"
                }
              },
              "required": [
                "screenResultId",
                "screenName",
                "viewport",
                "captureImage"
              ]
            },
            "description": "가장 최근 끝난 회차의 대표 캡처(화면 순서, 최대 3장. 없으면 [])"
          }
        },
        "required": [
          "id",
          "workspaceId",
          "name",
          "description",
          "baseUrl",
          "createdBy",
          "createdAt",
          "updatedAt",
          "screenCount",
          "thumbnails"
        ]
      },
      "GetReportRequestParams": {
        "type": "object",
        "properties": {
          "tier": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/AbleflowReportTier"
              },
              {
                "type": "null"
              }
            ],
            "description": "기본 SUMMARY. FULL 은 요금제로 막을 때 전체 리포트가 있는 요금제 · 건당 구매한 회차만(막지 않으면 누구나)"
          }
        }
      },
      "GetReportRequestPath": {
        "type": "object",
        "properties": {
          "diagnosisId": {
            "type": "string"
          }
        },
        "required": [
          "diagnosisId"
        ]
      },
      "GetReportResponse": {
        "type": "object",
        "properties": {
          "tier": {
            "$ref": "#/components/schemas/AbleflowReportTier"
          },
          "project": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "name": {
                "type": "string"
              },
              "baseUrl": {
                "type": [
                  "string",
                  "null"
                ]
              }
            },
            "required": [
              "id",
              "name"
            ],
            "description": "표지"
          },
          "workspaceName": {
            "type": "string"
          },
          "diagnosis": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "seq": {
                "type": "number"
              },
              "finishedAt": {
                "type": "string"
              },
              "requestedBy": {
                "$ref": "#/components/schemas/AbleflowMemberRef"
              },
              "criteria": {
                "type": "array",
                "items": {
                  "$ref": "#/components/schemas/AbleflowCriterion"
                }
              },
              "viewports": {
                "type": "array",
                "items": {
                  "$ref": "#/components/schemas/AbleflowViewport"
                }
              },
              "scoringVersion": {
                "type": "string"
              }
            },
            "required": [
              "id",
              "seq",
              "finishedAt",
              "requestedBy",
              "criteria",
              "viewports",
              "scoringVersion"
            ]
          },
          "scores": {
            "$ref": "#/components/schemas/AbleflowScoreSet",
            "description": "요약 · 기준별(GET /api/diagnoses/{id} 의 scores 와 같다)"
          },
          "previous": {
            "type": [
              "object",
              "null"
            ],
            "properties": {
              "seq": {
                "type": "number"
              },
              "scores": {
                "$ref": "#/components/schemas/AbleflowScoreSet"
              }
            },
            "required": [
              "seq",
              "scores"
            ],
            "description": "바로 앞 끝난 회차(없으면 없음)"
          },
          "findingCount": {
            "type": "number",
            "description": "회차 전체 위험 구간 수(tier 와 상관없이)"
          },
          "screens": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "screenResultId": {
                  "type": "string"
                },
                "screenName": {
                  "type": "string"
                },
                "url": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "viewport": {
                  "$ref": "#/components/schemas/AbleflowViewport"
                },
                "analysisPrecision": {
                  "$ref": "#/components/schemas/AbleflowAnalysisPrecision"
                },
                "captureImage": {
                  "anyOf": [
                    {
                      "$ref": "#/components/schemas/FileInfoResponse"
                    },
                    {
                      "type": "null"
                    }
                  ],
                  "description": "이미지 화면은 없음(화면에 올린 이미지를 쓴다)"
                },
                "scores": {
                  "anyOf": [
                    {
                      "$ref": "#/components/schemas/AbleflowScoreSet"
                    },
                    {
                      "type": "null"
                    }
                  ],
                  "description": "COMPLETED 만"
                },
                "findings": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "properties": {
                      "title": {
                        "type": "string"
                      },
                      "titleKey": {
                        "type": [
                          "string",
                          "null"
                        ],
                        "description": "규칙 위험 구간에서 온 제목의 문구 키(키 목록은 AbleflowFindingMessageArgs 설명). AI 판단 제목 · 키가 없는 옛 행은 빠진다 — 그때는 title 을 그대로 보인다"
                      },
                      "titleArgs": {
                        "anyOf": [
                          {
                            "$ref": "#/components/schemas/AbleflowFindingMessageArgs"
                          },
                          {
                            "type": "null"
                          }
                        ],
                        "description": "문구 키의 이름 붙은 값(값 자리가 없는 문구 · 키가 없으면 빠진다)"
                      },
                      "criterion": {
                        "$ref": "#/components/schemas/AbleflowCriterion"
                      },
                      "severity": {
                        "$ref": "#/components/schemas/AbleflowSeverity"
                      },
                      "region": {
                        "anyOf": [
                          {
                            "$ref": "#/components/schemas/AbleflowRegion"
                          },
                          {
                            "type": "null"
                          }
                        ]
                      }
                    },
                    "required": [
                      "title",
                      "criterion",
                      "severity"
                    ]
                  },
                  "description": "FULL 은 전부, SUMMARY 는 위에서 3개(심각도 → 만든 순). 영역이 없는 위험 구간은 region 이 없다"
                },
                "failureReason": {
                  "anyOf": [
                    {
                      "$ref": "#/components/schemas/AbleflowFailureReason"
                    },
                    {
                      "type": "null"
                    }
                  ]
                }
              },
              "required": [
                "screenResultId",
                "screenName",
                "viewport",
                "analysisPrecision",
                "findings"
              ]
            },
            "description": "화면별(프로젝트 화면 순서 → 뷰포트). 화면별 결과 API 와 같은 값"
          },
          "priorities": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/GetPrioritiesResponseItem"
            },
            "description": "개선 우선순위(SUMMARY 는 위에서 5개). GET /api/diagnoses/{id}/priorities/list 와 같은 모양 · 순위"
          },
          "appendix": {
            "type": "object",
            "properties": {
              "scoringVersion": {
                "type": "string"
              },
              "criteria": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "criterion": {
                      "$ref": "#/components/schemas/AbleflowCriterion"
                    },
                    "description": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  },
                  "required": [
                    "criterion"
                  ]
                }
              }
            },
            "required": [
              "scoringVersion",
              "criteria"
            ],
            "description": "부록: 기준 설명(운영 콘솔 기준별 고치는 방법의 근거 한 줄, 고정표가 없는 기준은 description 이 없다) · 산식 버전"
          }
        },
        "required": [
          "tier",
          "project",
          "workspaceName",
          "diagnosis",
          "scores",
          "findingCount",
          "screens",
          "priorities",
          "appendix"
        ]
      },
      "GetScreenPaginationRequestParams": {
        "allOf": [
          {
            "$ref": "#/components/schemas/PaginationRequest"
          },
          {
            "type": "object",
            "properties": {
              "keyword": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "이름 · 주소 · 경로 검색어(대소문자 무시, 100자 이하)"
              },
              "labelIds": {
                "type": [
                  "array",
                  "null"
                ],
                "items": {
                  "type": "string"
                },
                "description": "콤마 구분. 하나라도 붙은 화면(OR)"
              },
              "unlabeled": {
                "type": [
                  "boolean",
                  "null"
                ],
                "description": "true 면 레이블 없는 화면만"
              },
              "source": {
                "type": [
                  "array",
                  "null"
                ],
                "items": {
                  "$ref": "#/components/schemas/AbleflowScreenSource"
                },
                "description": "콤마 구분"
              },
              "viewport": {
                "anyOf": [
                  {
                    "$ref": "#/components/schemas/AbleflowViewport"
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "PC 를 주면 PC · BOTH 화면"
              }
            }
          }
        ]
      },
      "GetScreenPaginationRequestPath": {
        "type": "object",
        "properties": {
          "projectId": {
            "type": "string"
          }
        },
        "required": [
          "projectId"
        ]
      },
      "GetScreenPaginationResponse": {
        "type": "object",
        "properties": {
          "count": {
            "type": "number",
            "description": "전체 개수"
          },
          "prev": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "이전 페이지 query string. 키는 늘 있고, 첫 페이지면 null"
          },
          "next": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "다음 페이지 query string. 키는 늘 있고, 마지막 페이지면 null"
          },
          "results": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/ScreenResponseItem"
            },
            "description": "조회 결과"
          }
        },
        "required": [
          "count",
          "prev",
          "next",
          "results"
        ]
      },
      "GetScreenRequestPath": {
        "type": "object",
        "properties": {
          "screenId": {
            "type": "string"
          }
        },
        "required": [
          "screenId"
        ]
      },
      "GetScreenResponse": {
        "allOf": [
          {
            "$ref": "#/components/schemas/ScreenResponseItem"
          },
          {
            "type": "object",
            "properties": {
              "projectId": {
                "type": "string"
              }
            },
            "required": [
              "projectId"
            ]
          }
        ]
      },
      "GetScreenResultRequestPath": {
        "type": "object",
        "properties": {
          "screenResultId": {
            "type": "string"
          }
        },
        "required": [
          "screenResultId"
        ]
      },
      "GetScreenResultResponse": {
        "allOf": [
          {
            "$ref": "#/components/schemas/ScreenResultResponseItem"
          },
          {
            "type": "object",
            "properties": {
              "diagnosisId": {
                "type": "string"
              },
              "captureWidth": {
                "type": [
                  "number",
                  "null"
                ],
                "description": "캡처 이미지 픽셀 크기(위험 구간 영역 0~1 비율 → 하이라이트 위치)"
              },
              "captureHeight": {
                "type": [
                  "number",
                  "null"
                ]
              },
              "capturedAt": {
                "type": [
                  "string",
                  "null"
                ]
              }
            },
            "required": [
              "diagnosisId"
            ]
          }
        ]
      },
      "GetScreenResultsRequestParams": {
        "type": "object",
        "properties": {
          "labelIds": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "레이블 범위(콤마, OR. 지금 화면에 붙은 레이블 기준)"
          },
          "viewport": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/AbleflowViewport"
              },
              {
                "type": "null"
              }
            ]
          },
          "status": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/components/schemas/AbleflowScreenResultStatus"
            },
            "description": "콤마 구분"
          },
          "sort": {
            "type": [
              "string",
              "null"
            ],
            "description": "uxRiskScore:DESC(기본, 점수 없는 분석은 뒤) · priority:ASC(프로젝트 화면 순서)"
          }
        }
      },
      "GetScreenResultsRequestPath": {
        "type": "object",
        "properties": {
          "diagnosisId": {
            "type": "string"
          }
        },
        "required": [
          "diagnosisId"
        ]
      },
      "GetScreenResultsResponse": {
        "type": "array",
        "items": {
          "$ref": "#/components/schemas/ScreenResultResponseItem"
        }
      },
      "GetWorkspaceDiagnosisCountsRequestParams": {
        "type": "object",
        "properties": {
          "projectIds": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "프로젝트 UUID(콤마 구분). 다른 워크스페이스 프로젝트는 그냥 걸리지 않는다"
          },
          "trigger": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/components/schemas/AbleflowDiagnosisTrigger"
            }
          },
          "from": {
            "type": [
              "string",
              "null"
            ],
            "description": "만든 시각 범위(ISO-8601, from 포함 · to 미포함)"
          },
          "to": {
            "type": [
              "string",
              "null"
            ]
          },
          "requestedBy": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "실행한 사람 memberId(콤마 구분)"
          }
        }
      },
      "GetWorkspaceDiagnosisCountsRequestPath": {
        "type": "object",
        "properties": {
          "workspaceId": {
            "type": "string"
          }
        },
        "required": [
          "workspaceId"
        ]
      },
      "GetWorkspaceDiagnosisCountsResponse": {
        "type": "object",
        "properties": {
          "total": {
            "type": "number",
            "description": "byStatus 합"
          },
          "byStatus": {
            "type": "object",
            "properties": {
              "QUEUED": {
                "type": "number"
              },
              "RUNNING": {
                "type": "number"
              },
              "COMPLETED": {
                "type": "number"
              },
              "PARTIAL": {
                "type": "number"
              },
              "FAILED": {
                "type": "number"
              },
              "CANCELED": {
                "type": "number"
              }
            },
            "required": [
              "QUEUED",
              "RUNNING",
              "COMPLETED",
              "PARTIAL",
              "FAILED",
              "CANCELED"
            ],
            "description": "모든 상태를 0 까지 채운다"
          },
          "byProject": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "projectId": {
                  "type": "string"
                },
                "projectName": {
                  "type": "string"
                },
                "count": {
                  "type": "number"
                }
              },
              "required": [
                "projectId",
                "projectName",
                "count"
              ]
            },
            "description": "회차가 있는 프로젝트만(많은 순 → 이름순)"
          }
        },
        "required": [
          "total",
          "byStatus",
          "byProject"
        ]
      },
      "GetWorkspaceDiagnosisPaginationRequestParams": {
        "allOf": [
          {
            "$ref": "#/components/schemas/PaginationRequest"
          },
          {
            "type": "object",
            "properties": {
              "projectIds": {
                "type": [
                  "array",
                  "null"
                ],
                "items": {
                  "type": "string"
                },
                "description": "프로젝트 UUID(콤마 구분). 다른 워크스페이스 프로젝트는 그냥 걸리지 않는다"
              },
              "status": {
                "type": [
                  "array",
                  "null"
                ],
                "items": {
                  "$ref": "#/components/schemas/AbleflowDiagnosisStatus"
                },
                "description": "콤마 구분"
              },
              "trigger": {
                "type": [
                  "array",
                  "null"
                ],
                "items": {
                  "$ref": "#/components/schemas/AbleflowDiagnosisTrigger"
                }
              },
              "from": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "만든 시각 범위(ISO-8601, from 포함 · to 미포함)"
              },
              "to": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "requestedBy": {
                "type": [
                  "array",
                  "null"
                ],
                "items": {
                  "type": "string"
                },
                "description": "실행한 사람 memberId(콤마 구분)"
              }
            }
          }
        ],
        "description": "limit 최대 10000"
      },
      "GetWorkspaceDiagnosisPaginationRequestPath": {
        "type": "object",
        "properties": {
          "workspaceId": {
            "type": "string"
          }
        },
        "required": [
          "workspaceId"
        ]
      },
      "GetWorkspaceDiagnosisPaginationResponse": {
        "type": "object",
        "properties": {
          "count": {
            "type": "number",
            "description": "전체 개수"
          },
          "prev": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "이전 페이지 query string. 키는 늘 있고, 첫 페이지면 null"
          },
          "next": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "다음 페이지 query string. 키는 늘 있고, 마지막 페이지면 null"
          },
          "results": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/GetWorkspaceDiagnosisPaginationResponseItem"
            },
            "description": "조회 결과"
          }
        },
        "required": [
          "count",
          "prev",
          "next",
          "results"
        ]
      },
      "GetWorkspaceDiagnosisPaginationResponseItem": {
        "allOf": [
          {
            "$ref": "#/components/schemas/DiagnosisResponseItem"
          },
          {
            "type": "object",
            "properties": {
              "projectId": {
                "type": "string"
              },
              "projectName": {
                "type": "string"
              }
            },
            "required": [
              "projectId",
              "projectName"
            ]
          }
        ]
      },
      "GetWorkspaceLabelsRequestPath": {
        "type": "object",
        "properties": {
          "workspaceId": {
            "type": "string"
          }
        },
        "required": [
          "workspaceId"
        ]
      },
      "GetWorkspaceLabelsResponse": {
        "type": "array",
        "items": {
          "$ref": "#/components/schemas/GetWorkspaceLabelsResponseItem"
        }
      },
      "GetWorkspaceLabelsResponseItem": {
        "allOf": [
          {
            "$ref": "#/components/schemas/LabelResponseItem"
          },
          {
            "type": "object",
            "properties": {
              "projectCount": {
                "type": "number",
                "description": "이 레이블을 쓰는 프로젝트 수"
              }
            },
            "required": [
              "projectCount"
            ]
          }
        ]
      },
      "GetWorkspaceMembersRequestParams": {
        "type": "object",
        "properties": {
          "keyword": {
            "type": [
              "string",
              "null"
            ],
            "description": "이름 · 이메일 검색어(대소문자 무시)"
          }
        }
      },
      "GetWorkspaceMembersRequestPath": {
        "type": "object",
        "properties": {
          "workspaceId": {
            "type": "string"
          }
        },
        "required": [
          "workspaceId"
        ]
      },
      "GetWorkspaceMembersResponse": {
        "type": "array",
        "items": {
          "$ref": "#/components/schemas/GetWorkspaceMembersResponseItem"
        }
      },
      "GetWorkspaceMembersResponseItem": {
        "type": "object",
        "properties": {
          "memberId": {
            "type": "string"
          },
          "name": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "계정 DB 에서 채움. 조회 실패 · 탈퇴면 null"
          },
          "email": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "role": {
            "$ref": "#/components/schemas/AbleflowWorkspaceRole"
          },
          "joinedAt": {
            "type": "string",
            "description": "들어온 시각(초대 수락 · 워크스페이스 생성)"
          },
          "lastActiveAt": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "마지막 활동 시각. 아직 기록하지 않아 늘 null"
          },
          "projectCount": {
            "type": "number",
            "description": "이 사람이 만든 프로젝트 수"
          },
          "me": {
            "type": "boolean",
            "description": "나인지"
          }
        },
        "required": [
          "memberId",
          "name",
          "email",
          "role",
          "joinedAt",
          "lastActiveAt",
          "projectCount",
          "me"
        ]
      },
      "IssueResponseItem": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "seq": {
            "type": "number",
            "description": "워크스페이스 안 표시 번호"
          },
          "projectId": {
            "type": "string"
          },
          "projectName": {
            "type": "string"
          },
          "title": {
            "type": "string",
            "description": "과제 제목(만들 때 묶음 대표 위험 구간의 제목). 규칙 제목은 한국어 원문(titleKey 로 옮긴다), AI 판단 제목은 요청 언어(?locale=) 번역이 있으면 그 글\n(만든 회차의 같은 묶음 · 같은 원문 제목 위험 구간의 번역, 그 회차가 지워졌으면 한국어 원문)"
          },
          "titleKey": {
            "type": [
              "string",
              "null"
            ],
            "description": "규칙 위험 구간에서 온 제목의 문구 키(키 목록은 AbleflowFindingMessageArgs 설명). AI 판단 제목 · 키가 없는 옛 행은 빠진다 — 그때는 title 을 그대로 보인다"
          },
          "titleArgs": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/AbleflowFindingMessageArgs"
              },
              {
                "type": "null"
              }
            ],
            "description": "문구 키의 이름 붙은 값(값 자리가 없는 문구 · 키가 없으면 빠진다)"
          },
          "criterion": {
            "$ref": "#/components/schemas/AbleflowCriterion"
          },
          "severity": {
            "$ref": "#/components/schemas/AbleflowSeverity"
          },
          "status": {
            "$ref": "#/components/schemas/AbleflowIssueStatus"
          },
          "assignee": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/AbleflowMemberRef"
              },
              {
                "type": "null"
              }
            ]
          },
          "screenCount": {
            "type": "number",
            "description": "영향 분석 수 · 묶은 위험 구간 수(그 프로젝트의 가장 최근 끝난 회차 기준, 그 회차에 없으면 0)"
          },
          "findingCount": {
            "type": "number"
          },
          "elementHint": {
            "type": [
              "string",
              "null"
            ],
            "description": "최근 끝난 회차에서 이 과제 묶음의 요소 단서(같은 제목 과제를 구분). 그 회차에 묶음이 없으면 빠진다"
          },
          "elementHintKey": {
            "type": [
              "string",
              "null"
            ],
            "description": "elementHint 가 규칙의 고정 단서일 때 표시용 키(예: firstScreen). 셀렉터 · AI 단서는 빠진다"
          },
          "latestDiagnosisEvaluated": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "그 최근 끝난 회차가 이 과제의 기준을 평가했는지(끝난 분석 중 하나라도 그 기준 점수를 냈는지). false 면 screenCount · findingCount 의 0 은 \"고쳐짐\"이 아니라 \"이번 회차는 보지 않음\"(기준 일부만 고른 진단 등). 끝난 회차가 없으면 없음"
          },
          "source": {
            "type": [
              "object",
              "null"
            ],
            "properties": {
              "diagnosisId": {
                "type": "string"
              },
              "seq": {
                "type": "number"
              },
              "finishedAt": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "rank": {
                "type": [
                  "number",
                  "null"
                ]
              }
            },
            "required": [
              "diagnosisId",
              "seq"
            ],
            "description": "만든 회차와 그때 우선순위 순위(회차가 지워졌으면 빠진다). finishedAt 은 그 회차를 실패만 다시 하는 중(재실행 중)에는 없음"
          },
          "verification": {
            "type": [
              "object",
              "null"
            ],
            "properties": {
              "diagnosisId": {
                "type": "string"
              },
              "result": {
                "enum": [
                  "CONFIRMED",
                  "REOPENED"
                ]
              },
              "at": {
                "type": "string"
              },
              "seq": {
                "type": [
                  "number",
                  "null"
                ],
                "description": "확인한 회차 번호(10 SQL 이전 확인은 없음)"
              }
            },
            "required": [
              "diagnosisId",
              "result",
              "at"
            ],
            "description": "다음 회차 확인(무시됨을 뺀 모든 과제, 확인 전에는 없음). 같은 묶음 키가 사라지면 CONFIRMED, 남으면 REOPENED(열린 과제는 아직 남음). 완료 과제가 REOPENED 면 서버가 TODO 로 다시 연다(같은 묶음의 열린 과제가 있으면 결과만). at = 확인한 회차가 끝난 시각"
          },
          "createdAt": {
            "type": "string"
          },
          "updatedAt": {
            "type": "string"
          },
          "effort": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/AbleflowEffort"
              },
              {
                "type": "null"
              }
            ],
            "description": "고치는 품(기준별 고치는 방법에서 읽는다. 운영 콘솔에서 바꾸면 바로 바뀐다)"
          }
        },
        "required": [
          "id",
          "seq",
          "projectId",
          "projectName",
          "title",
          "criterion",
          "severity",
          "status",
          "screenCount",
          "findingCount",
          "createdAt",
          "updatedAt"
        ],
        "description": "개선 과제 한 줄"
      },
      "LabelResponseItem": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "scope": {
            "$ref": "#/components/schemas/AbleflowLabelScope"
          },
          "projectId": {
            "type": [
              "string",
              "null"
            ],
            "description": "PROJECT 레이블만"
          },
          "name": {
            "type": "string"
          },
          "color": {
            "$ref": "#/components/schemas/AbleflowLabelColor"
          },
          "description": {
            "type": [
              "string",
              "null"
            ],
            "description": "설명. 없으면 빠진다"
          },
          "screenCount": {
            "type": "number",
            "description": "붙은 화면 수(삭제 · 합치기 확인 문구)"
          },
          "createdAt": {
            "type": "string"
          },
          "updatedAt": {
            "type": "string"
          }
        },
        "required": [
          "id",
          "scope",
          "name",
          "color",
          "screenCount",
          "createdAt",
          "updatedAt"
        ]
      },
      "MonitorScheduleBody": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string",
            "description": "이름(1~50자, 앞뒤 공백은 지운다)"
          },
          "type": {
            "enum": [
              "WEEKLY",
              "AFTER_DEPLOY"
            ],
            "description": "WEEKLY: 정해진 요일 · 시각 · AFTER_DEPLOY: 프로젝트 배포 웹훅을 받으면(trigger PRE_DEPLOY, days · time 은 보지 않음)"
          },
          "days": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "number"
            },
            "description": "WEEKLY 만: 요일(1 = 월 … 7 = 일, ISO-8601) 1개 이상 · 시각(\"HH:mm\", 00:00~23:59) · 시간대(IANA, 기본 Asia/Seoul)"
          },
          "time": {
            "type": [
              "string",
              "null"
            ]
          },
          "timeZone": {
            "type": [
              "string",
              "null"
            ]
          },
          "screenIds": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "대상(합집합). 둘 다 비면 400. 이 프로젝트 화면 · 공통 또는 이 프로젝트 전용 레이블만"
          },
          "labelIds": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            }
          },
          "viewports": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/AbleflowViewport"
            },
            "description": "1개 이상"
          },
          "criteria": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/AbleflowCriterion"
            },
            "description": "1개 이상"
          },
          "alertDelta": {
            "type": [
              "number",
              "null"
            ],
            "description": "알림 기준선: 대표 위험도가 지난 회차보다 이만큼 오르면(1~100, 기본 5) · 받는 사람 memberId(이 워크스페이스 구성원만)"
          },
          "alertMemberIds": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            }
          },
          "enabled": {
            "type": "boolean",
            "description": "끄고 켜기"
          }
        },
        "required": [
          "name",
          "type",
          "viewports",
          "criteria",
          "enabled"
        ],
        "description": "반복 진단 일정 만들기 · 고치기 값(전체 값)"
      },
      "PaginationRequest": {
        "type": "object",
        "properties": {
          "offset": {
            "type": [
              "number",
              "null"
            ],
            "description": "시작 오프셋"
          },
          "limit": {
            "type": [
              "number",
              "null"
            ],
            "description": "조회 개수"
          },
          "sort": {
            "type": [
              "string",
              "null"
            ],
            "description": "정렬 조건. 콤마로 구분하며 각 항목은 property 또는 property:ASC|DESC 형식"
          }
        },
        "description": "API 공통 - 페이지네이션 요청 query"
      },
      "RetryFailedDiagnosisRequestBody": {
        "type": "object",
        "properties": {
          "screenResultIds": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "일부만 다시(없으면 실패한 것 전부)"
          }
        },
        "description": "본문 없이 보내도 된다"
      },
      "RetryFailedDiagnosisRequestPath": {
        "type": "object",
        "properties": {
          "diagnosisId": {
            "type": "string"
          }
        },
        "required": [
          "diagnosisId"
        ]
      },
      "RetryFailedDiagnosisResponse": {},
      "ScreenResponseItem": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "source": {
            "$ref": "#/components/schemas/AbleflowScreenSource"
          },
          "url": {
            "type": [
              "string",
              "null"
            ],
            "description": "URL 화면: 전체 주소(경로로 넣었으면 프로젝트 baseUrl + 경로)"
          },
          "path": {
            "type": [
              "string",
              "null"
            ],
            "description": "경로로 넣은 화면이면 경로(기본 주소를 바꾸면 url 이 따라 바뀐다)"
          },
          "viewport": {
            "$ref": "#/components/schemas/AbleflowScreenViewport"
          },
          "images": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/components/schemas/FileInfoResponse"
            },
            "description": "IMAGE 화면: 올린 이미지(priority 순, 첫 장이 썸네일). 공용 응답 주입기가 채운다"
          },
          "labels": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/AbleflowLabelRef"
            },
            "description": "공통 먼저, 이름순"
          },
          "requiresAuth": {
            "type": "boolean"
          },
          "priority": {
            "type": "number",
            "description": "리포트 · 목록 순서(작을수록 앞)"
          },
          "latestResult": {
            "description": "진단(회차) 기능 전이라 늘 없음"
          },
          "createdAt": {
            "type": "string"
          },
          "updatedAt": {
            "type": "string"
          }
        },
        "required": [
          "id",
          "name",
          "source",
          "viewport",
          "labels",
          "requiresAuth",
          "priority",
          "createdAt",
          "updatedAt"
        ]
      },
      "ScreenResultResponseItem": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "screenId": {
            "type": "string",
            "description": "화면이 지워졌어도 남는다(screenDeleted)"
          },
          "screenName": {
            "type": "string",
            "description": "회차 시점의 이름 · 주소"
          },
          "url": {
            "type": [
              "string",
              "null"
            ]
          },
          "source": {
            "$ref": "#/components/schemas/AbleflowScreenSource"
          },
          "screenDeleted": {
            "type": "boolean"
          },
          "labels": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/AbleflowLabelRef"
            },
            "description": "지금 화면에 붙은 레이블(공통 먼저, 이름순). 지워진 화면은 []"
          },
          "viewport": {
            "$ref": "#/components/schemas/AbleflowViewport"
          },
          "status": {
            "$ref": "#/components/schemas/AbleflowScreenResultStatus"
          },
          "analysisPrecision": {
            "$ref": "#/components/schemas/AbleflowAnalysisPrecision"
          },
          "captureImage": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/FileInfoResponse"
              },
              {
                "type": "null"
              }
            ],
            "description": "전체 페이지 캡처(공용 응답 주입기, \"ScreenResult_{id}\" · \"captureImage\"). 이미지 화면 · 저장 못 한 캡처는 없음"
          },
          "scores": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/AbleflowScoreSet"
              },
              {
                "type": "null"
              }
            ],
            "description": "COMPLETED 만"
          },
          "findingCount": {
            "type": "number"
          },
          "criterionNotes": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/components/schemas/AbleflowCriterionNote"
            },
            "description": "COMPLETED 만, 없으면 없음. 빠진 기준 · 일부만 본 기준 · 문제 없음 답"
          },
          "previousUxRiskScore": {
            "type": [
              "number",
              "null"
            ],
            "description": "지난 끝난 회차의 같은 화면 · 뷰포트 위험도"
          },
          "failureReason": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/AbleflowFailureReason"
              },
              {
                "type": "null"
              }
            ]
          }
        },
        "required": [
          "id",
          "screenId",
          "screenName",
          "source",
          "screenDeleted",
          "labels",
          "viewport",
          "status",
          "analysisPrecision",
          "findingCount"
        ],
        "description": "화면별 결과 한 줄"
      },
      "UpdateIssueStatusRequestBody": {
        "type": "object",
        "properties": {
          "status": {
            "$ref": "#/components/schemas/AbleflowIssueStatus"
          }
        },
        "required": [
          "status"
        ]
      },
      "UpdateIssueStatusRequestPath": {
        "type": "object",
        "properties": {
          "issueId": {
            "type": "string"
          }
        },
        "required": [
          "issueId"
        ]
      },
      "UpdateIssueStatusResponse": {}
    },
    "securitySchemes": {
      "bearer": {
        "type": "http",
        "scheme": "bearer",
        "bearerFormat": "afk_<base64url 43>",
        "description": "공개 API 토큰(afk_…)"
      }
    }
  }
}
