Skip to content

Docs: 커스텀 문구 슬롯 좌표(posX·posY·width·height) 단위 확정 #287

Closed

Description

@chanwoo7

배경

SDL 문서화(#249) 중 설명을 쓸 수 없어 미확정으로 남긴 항목이다.

SellerCustomTextToken의 posX·posY·width·height는 커스텀 케이크 도안 위에서 문구 슬롯이 놓일 위치·크기를 나타내는데, 단위와 기준 좌표계가 코드·스키마 어디에도 없다.

  • Prisma: pos_x Int? / pos_y Int? / width Int? / height Int? (주석 없음)
  • 서비스: posX: input.posX ?? null로 그대로 저장만 한다
  • 검증·변환 로직 없음

픽셀인지, 베이스 이미지 대비 비율인지, 좌상단 기준인지 중앙 기준인지 알 수 없다.

현재 처리

단정하지 않고 이 수준까지만 적어 뒀다.

베이스 이미지 위에서 문구가 놓일 가로 위치. 미지정 시 null이고 배치는 클라이언트가 정한다.

필요한 것

FE 커스텀 편집 화면 구현과 함께 좌표계를 확정하고 SDL 설명을 채운다. 확정 시 함께 볼 것:

  • 단위 (px / 비율 / 도안 내부 좌표)
  • 원점 (좌상단 / 중앙)
  • 베이스 이미지 크기가 달라질 때의 해석
  • 값 범위 검증이 필요한지 (현재 없음)

참고

.figma/ 스펙에 커스텀 편집 화면이 확정되면 그 기준을 따른다. 지금 임의로 정하면 FE 구현과 어긋날 위험이 있어 미룬다.

Activity

  1. chanwoo7 commented on Nov 18, 2026

    @chanwoo7
    MemberAuthor

    좌표계를 확정해 #566(문구 자리 좌표 검증)·#567(바탕 1:1 검증)으로 구현했고, 릴리즈 #588(9910dfe)로 운영에 반영했습니다.

    • 단위: 바탕 이미지 한 변을 10,000으로 보는 정수 비율 좌표
    • 원점: 왼쪽 위
    • 범위: posX·posY 09,999, width·height 110,000, posX + width·posY + height ≤ 10,000(서버 검증, SDL 설명 반영)
    • 바탕 이미지 크기: 1:1(정사각형)만 받도록 서버가 검증하므로, 이미지 해상도와 관계없이 같은 비율로 해석됩니다.
    • 기존 값은 마이그레이션에서 바탕 안으로 잘라 넣었습니다(운영에는 해당 행이 없었습니다).
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

    No labels
    No labels

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions