{
  "version": "1.1",
  "id": "adapter-outbound-persistence-jpa-c04",
  "title": "질의 API가 표현하지 않는 것",
  "question": "keyset 질의 API 는 무엇을 받고 무엇을 받지 않는가?",
  "type": "sequence",
  "direction": "LR",
  "audience": [
    "이 저장소의 구조를 읽는 사람"
  ],
  "summary": "정렬 키와 size 더하기 1과 서명된 커서로 페이지를 만들고 offset 과 total count 질의는 받지 않는다.",
  "alt": "호출자가 keyset 질의 API 에 정렬 키를 주고 서명된 커서를 받으며 offset 과 total count 요청은 받아들여지지 않는 순서.",
  "long_description": "SSOT §5.1 은 KeysetPageRequest 에 offset 자체가 없다고 적는다. 정렬 키와 요청 size + 1, 서명된 nextCursor 로 다음 페이지를 만든다.",
  "source_context": {
    "document": "/home/donghyeon/workspace/chat-gpt-container/document-haness/docs/clean-architecture-backend-template/final/document.md",
    "document_sha256": "8071fe71b3359d9cf60b95909c26c7b50653ce2f22bbc5fcf6988719bb91236d",
    "anchor": {
      "kind": "line",
      "value": 4081,
      "line": 4081
    }
  },
  "composition": {
    "profile": "sequence",
    "diagram_only": true,
    "reference_ids": [
      "payment-approval-sequence"
    ],
    "rationale": "받는 입력과 받지 않는 입력이 순서 위에서 갈린다.",
    "focus_node": "api"
  },
  "groups": [],
  "nodes": [
    {
      "id": "caller",
      "label": "호출자",
      "kind": "service",
      "role": "participant",
      "evidence": [
        {
          "start_line": 4081,
          "end_line": 4094
        }
      ],
      "assumption": false
    },
    {
      "id": "api",
      "label": "keyset 질의 API",
      "kind": "service",
      "role": "participant",
      "evidence": [
        {
          "start_line": 4081,
          "end_line": 4094
        }
      ],
      "assumption": false,
      "emphasis": "primary",
      "details": [
        "KeysetTerm 정렬 키",
        "요청 size + 1"
      ]
    },
    {
      "id": "db",
      "label": "저장소",
      "kind": "service",
      "role": "participant",
      "evidence": [
        {
          "start_line": 4081,
          "end_line": 4096
        }
      ],
      "assumption": false
    }
  ],
  "edges": [
    {
      "id": "m1",
      "from": "caller",
      "to": "api",
      "label": "정렬 키 · size",
      "kind": "request",
      "evidence": [
        {
          "start_line": 4081,
          "end_line": 4094
        }
      ],
      "assumption": false,
      "order": 1
    },
    {
      "id": "m2",
      "from": "api",
      "to": "db",
      "label": "한 건 더 조회",
      "kind": "request",
      "evidence": [
        {
          "start_line": 4081,
          "end_line": 4094
        }
      ],
      "assumption": false,
      "order": 2
    },
    {
      "id": "m3",
      "from": "api",
      "to": "caller",
      "label": "서명된 nextCursor",
      "kind": "response",
      "evidence": [
        {
          "start_line": 4081,
          "end_line": 4094
        }
      ],
      "assumption": false,
      "order": 3,
      "emphasis": "primary"
    },
    {
      "id": "m4",
      "from": "caller",
      "to": "api",
      "label": "offset · total count 없음",
      "kind": "request",
      "evidence": [
        {
          "start_line": 4081,
          "end_line": 4096
        }
      ],
      "assumption": false,
      "order": 4,
      "style": "dashed"
    }
  ],
  "legend": [],
  "metadata": {}
}