기술 지도

flowchart TB
  accTitle: 현재 웹사이트 시스템 지도
  accDescr: 브라우저는 정적 페이지, SSR 페이지 또는 업무 API를 읽는다. SSR 페이지와 API는 repository로 로컬 데이터를 읽는다.
  browser["브라우저"]
  staticPages["Astro 정적 페이지"]
  ssrPages["Astro SSR 페이지"]
  ticketApi["업무 API · GET 전용"]
  ticketRepo["업무 Repository"]
  teamRepo["구성원 Repository"]
  ticketData[("로컬 업무 데이터")]
  teamData[("구성원 목록 및 활동")]
  browser -->|"페이지 조회"| staticPages
  browser -->|"페이지 조회"| ssrPages
  browser -->|"GET 호출"| ticketApi
  ssrPages --> ticketRepo
  ssrPages --> teamRepo
  ticketApi --> ticketRepo
  ticketRepo --> ticketData
  teamRepo --> teamData

sequenceDiagram
 accTitle: API가 ID로 작업 항목 읽기
 accDescr: API는 ID 형식을 확인하고 리포지토리를 조회해 오류 400, 오류 404 또는 공개 데이터 200을 반환합니다.
 participant client as 호출자
 participant api as 작업 API
 participant repo as Repository
 client->>api: GET /api/tickets/{id}
 alt 잘못된 ID 형식
 api-->>client: 400 · invalid_id
 else 유효한 ID
 api->>repo: get(id)
 repo-->>api: 레코드 또는 null
 alt 찾을 수 없음
 api-->>client: 404 · not_found
 else 레코드 있음
 api->>api: 공개 필드 선택
 api-->>client: 200 · ticket
 end
 end

sequenceDiagram
  accTitle: 업무 목록 페이지 API
  accDescr: Repository가 프로젝트, 제한, 커서를 확인하고 공개 목록과 다음 커서를 반환한다.
  participant client as 호출자
  participant api as 업무 API
  participant repo as Repository
  Note over client,api: gameId=vo, limit=20
  client->>api: GET /api/tickets
  api->>repo: list(gameId, limit, after)
  alt 잘못된 쿼리 또는 커서
    repo-->>api: InvalidTicketQuery
    api-->>client: 400 · invalid_query
  else 유효
    repo-->>api: items 및 nextCursor
    api->>api: 각 항목의 공개 필드 선택
    api-->>client: 200 · items 및 nextCursor
    opt nextCursor가 null이 아님
      client->>api: 동일 gameId로 GET, after=nextCursor
      api->>repo: 다음 페이지 조회
      repo-->>api: items 및 새 nextCursor
      api-->>client: 200 · 공개 필드
    end
  end