링크 요약 수정 API 구현

[ckdals4600]

이슈 배경

• 기 구현된 요약 재생성 기능을 통해 사용자가 획득한 새로운 요약 결과를 선택하는 API 개발
• 프론트엔드 연동을 위한 요약 텍스트 수정(업데이트) 전용 엔드포인트 개발을 진행함.

이슈 내용

1. API 명세

• Endpoint: PATCH /links/{linkId}/summary
• Path Variable: linkId (링크 ID)
• 동작: 사용자가 최종적으로 확정한 새로운 요약 텍스트를 전달받아 해당 링크의 요약 데이터를 갱신함.
• Request:

  {
     "summary": "사용자가 새롭게 선택한 요약 내용입니다."
   }  

• Response:

  {
    "linkId": 103,
    "summary": "사용자가 새롭게 선택한 요약 내용입니다.",
    "updatedAt": "2026-02-27T23:15:00Z"
  }

2. 주요 로직

• 데이터 조회 및 검증: 전달받은 linkId를 기반으로 DB에서 대상 링크(Link) Entity를 조회함.
• 유효성 검사: 요청으로 들어온 요약 텍스트에 대한 유효성(빈 문자열 방지, 최대 길이 제한 등)을 검증함.
• 상태 업데이트: 링크 Entity의 요약 필드를 전달받은 값으로 덮어쓰고, JPA 변경 감지(Dirty Checking)를 통해 트랜잭션을 커밋하여 안전하게 DB를 업데이트함.

3. 개발 범위

• LinkController (또는 SummaryController): 프론트엔드 요청(PATCH)을 처리하고 파라미터를 바인딩하는 컨트롤러 메서드 구현.
• LinkService (또는 SummaryService): 링크 조회 및 요약 데이터 수정을 수행하는 비즈니스(트랜잭션) 로직 작성.
• DTO 정의: 요약 수정 요청을 받기 위한 Request DTO 및 갱신 결과를 반환할 Response DTO 설계 및 반영.

참고 자료

No response