랠리 연장, 랠리 포기(삭제), 완주 랠리 삭제, 키트 삭제 API 추가

[mdgarden]

작업 내용

133 에서 추가된 스키마를 바탕으로 API들을 수정합니다.

상세 내용

• [x] Rally select 값 수정
  • [x] stampable 항목 추가 *DB에 없는 항목
  • [x] lastStampedDate 항목 추가
  • [x] dueDate 항목 추가
  • [x] completionDate 항목 추가
  • [x] extendedDueDate 항목 추가
  • [x] isPublic 항목 추가
• [x] 랠리 스탬프 찍기 API 수정
  • [x] path: rallies/[id]/stamp
  • [x] params: 랠리 아이디 {id: string}
  • [x] auth: required (랠리 소유자만 실행가능) 별도 대응
  • [x] 이 API가 실행되면 해당 랠리의 스탬프 값을 증가시킵니다.
  • [x] 기존 랠리 스탬프 API 사용 위치 path 변경
• [x] 랠리 연장 API 추가
  • [x] path: rallies/[id]/extend
  • [x] params: 랠리 아이디 {id: string}
  • [x] auth: required (랠리 소유자만 실행가능) 별도 대응
  • [x] 이 API가 실행되면 해당 랠리의 기간을 연장합니다. 이미 연장되어있는 경우, 에러를 반환합니다.
• [x] Get API들에 ASC/DESC 파람 추가
  • [x] Get Kits
  • [x] Get Rallies
• [x] 랠리 삭제 API 추가
  • [x] path: rallies/[id]
  • [x] DELETE
  • [x] 소프트 딜리트로 적용합니다.
• [x] 키트 삭제 API 추가
  • [x] path: kits/[id]
  • [x] DELETE
  • [x] 소프트 딜리트로 적용합니다.

테스트 내용

• [x] deletedAt이 null이 아닌 값은 반환하지 않습니다.
  • [x] kit
  • [x] rally
• [x] rallies/[id]에서 stampable 값을 반환합니다.
• [x] 랠리 화면에서 스탬프를 정상적으로 찍을 수 있습니다.

기타

[mdgarden]

API를 토글 용도로 사용하는 것은 RESTful 하지 않음 https://stackoverflow.com/questions/3266292/best-way-to-implement-a-restful-toggle-action

사용하지 말아야하는 이유 - 올바르게 처리되었는지 서버가 알 수 없음 https://stackoverflow.com/questions/37666198/restful-api-put-patch-to-flip-boolean/37667363#comment62810763_37666198

API를 액션으로 쓰는것은 RESTful 하지 않음 - REST는 resource에 대한 내용이기 때문에 https://stackoverflow.com/questions/55264780/custom-update-actions-in-restful-services

상기의 원칙대로라면 스탬프 찍기, 마감기한 연장, 비공개 설정 모두 PATCH rallies/[id]에서 이루어져야함

[mdgarden]

stampable을 반환할 때 Prisma Client extensions 활용(미들웨어는 deprecated됨) https://www.prisma.io/docs/orm/prisma-client/client-extensions/result

[mdgarden]

PUT과 PATCH의 멱등성에 관련해서 정리가 잘되어있는 것 같아서 일단 메모 https://stackoverflow.com/questions/28459418/use-of-put-vs-patch-methods-in-rest-api-real-life-scenarios 액션같이 쓰는 법 https://stackoverflow.com/questions/46956374/rest-api-patch-without-request-body