Skip to content

[chore] 내 템플릿·휴지통 명세 문구 정리와 스웨거 대조 #106

Open

Description

@oTAETAEo

작업 내용

담당 C의 API 8~18번(내 템플릿·휴지통)을 스웨거·명세·코드로 대조하고, 작업 중 정해 둔 명세 문구 세 가지를 docs/s1-api-spec.md에 반영합니다. 코드는 바꾸지 않습니다.

명세 문구 정리

  • 11번 비고: 동시 수정 시 "나중 저장이 덮어씁니다" → 같은 필드만 나중 저장이 덮어쓰고, 서로 다른 필드를 고친 두 수정은 합쳐짐 (Template의 @DynamicUpdate)
  • 13번 응답 shortcut: 확인한 단축어는 NFC 정규화한 값, 대소문자는 입력 그대로 (#102에서 확정)
  • 15번: int 범위를 넘거나 숫자가 아닌 size·커서 값은 공통 규칙대로 COMMON400_1. TRASH400_1은 숫자로 읽힌 size가 범위 밖일 때

스웨거·명세 대조 (8~18번)

  • 경로·메서드, 요청 파라미터·본문, 응답 result 필드, 성공·에러 코드와 문구, 시각 형식, 캐시 헤더
  • 다른 점은 이 이슈에서 고치지 않고 정리만 합니다. 명세와 코드 중 어느 쪽을 고칠지는 따로 정합니다

이유

C의 API가 모두 develop에 병합되어(#102), 체크리스트의 "스웨거와 명세 비교"를 하고 작업 중 쌓인 명세 문구를 실제 동작에 맞춥니다.

Activity

  1. added
    chore설정·빌드·의존성
    docs문서 (명세, ERD, CLAUDE.md)
    template내 템플릿·휴지통
    on Nov 15, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    chore설정·빌드·의존성docs문서 (명세, ERD, CLAUDE.md)template내 템플릿·휴지통

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions