Skip to content

사물함 구역 배치·사진 저장과 구역 상세 응답 개편 #97

Closed

Description

@tnals0924

어떤 기능인가요?

추가하려는 기능에 대해 간결하게 설명해주세요

사물함 구역 상세 조회(GET /v1/app/lockers/sections/{sectionId})가 구역별 칸 배치 구조(layout)와 구역 실제 사진을 함께 내려주도록 바꾼다.

지금은 사물함마다 rowNo·columnNo만 내려줘서 창문·벽면·계단·복도 같은 고정 구조와 테두리로 나뉜 묶음을 그릴 수 없다. 새 테이블 locker_section_layouts에 구역마다 layout(JSON, root 블록 트리)·형식 버전(SMALLINT)·사진 파일 ID를 저장한다. 서버는 layout을 해석하지 않고 그대로 전달한다. 사진은 웹 계층에서 StorageUrlBuilder로 공개 URL을 만든다.

📝 작업 상세 내용

  • locker_section_layouts 테이블 추가 (section_id 유니크, layout JSON, version SMALLINT, photo_file_id) + JPA Entity·Repository
  • 도메인 LockerSectionLayout, 저장소에 구역 단건·layout 조회 추가
  • LockerService.getSectionDetail로 구역·layout·사물함을 함께 조회 (getSectionLockers 대체)
  • 구역 상세 응답에 sectionId·section·layout{version, root}·photoUrl 추가, lockers[]에서 rowNo·columnNo 제거
  • layout 행이 없는 구역은 layout·photoUrl을 null로 응답
  • 사진 업로드용 FileCategory.LOCKER_SECTION_PHOTO 추가

📁 참고 자료 (선택)

Activity

  1. self-assigned this
    on Oct 6, 2026
  2. added a commit that references this issue on Oct 8, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

Labels

No labels
No labels

Type

No type

Projects

No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions