truloop Wiki

다크 모드

커버 템플릿 관리 ​

정보

커버 템플릿은 사용자가 룹을 만들 때 선택할 수 있는 커버 이미지 템플릿입니다. 관리자가 마스터 이미지를 등록하면 다양한 크기의 변형 이미지가 자동 생성됩니다.

동작 규칙 ​

규칙 1: 템플릿 생성 ​

  • 관리자가 마스터 이미지를 업로드하고, 제목/카테고리/대표 색상/표시 순서/추천 여부를 설정하여 템플릿을 생성합니다.
  • 마스터 이미지 업로드 시 업로드 URL을 먼저 발급받아 직접 업로드한 후 생성 요청을 보냅니다.
  • 생성 시 마스터 이미지로부터 여러 크기의 변형 이미지가 자동 생성됩니다.
  • 새로 생성된 템플릿은 항상 임시저장(DRAFT) 상태로 시작합니다.
  • 허용 이미지 형식: JPEG, PNG, WebP

규칙 2: 카테고리 ​

커버 템플릿은 룹 카테고리와 동일한 7종의 카테고리로 분류됩니다.

카테고리설명
다이닝식사 모임
음료카페, 바 등 음료 모임
소셜/파티친목, 파티 등 사교 모임
액티비티운동, 야외 활동 등
배움스터디, 워크숍 등
비즈니스업무 미팅, 네트워킹 등
가족가족 모임

규칙 3: 상태 흐름 ​

커버 템플릿은 다음과 같은 상태 흐름을 따릅니다.

  • DRAFT(임시저장): 생성 직후 상태. 앱 사용자에게 노출되지 않습니다.
  • PUBLISHED(게시됨): 앱 사용자에게 노출되는 상태.
  • ARCHIVED(보관됨): 앱 사용자에게 더 이상 노출되지 않는 상태. 재게시 가능합니다.

주의

허용되지 않는 상태 전환을 시도하면 오류가 발생합니다. 예를 들어, DRAFT에서 ARCHIVED로 직접 전환할 수 없습니다.

규칙 4: 목록 조회 및 필터링 ​

  • 상태(DRAFT/PUBLISHED/ARCHIVED)와 카테고리로 필터링할 수 있습니다.
  • 페이지 기반 페이징을 지원합니다 (기본 20개, 최대 100개).

규칙 5: 수정 ​

  • 제목, 카테고리, 대표 색상, 표시 순서, 추천 여부를 부분 수정할 수 있습니다.
  • 수정 요청에 포함된 항목만 변경되고, 나머지 항목은 그대로 유지됩니다.

규칙 6: 삭제 ​

  • DRAFT 상태의 템플릿만 삭제할 수 있습니다.
  • PUBLISHED 또는 ARCHIVED 상태에서는 삭제할 수 없습니다.
  • 삭제 시 관련 변형 이미지도 함께 삭제됩니다.

사용자 흐름 ​

마스터 이미지 업로드 ​

관리자가 커버로 사용할 이미지를 선택하여 업로드합니다. JPEG, PNG, WebP 형식을 지원합니다.

템플릿 정보 입력 ​

제목, 카테고리, 대표 색상, 표시 순서, 추천 여부를 설정합니다.

임시저장 생성 ​

시스템이 템플릿을 DRAFT 상태로 생성하고, 마스터 이미지로부터 다양한 크기의 변형 이미지를 자동 생성합니다.

게시 ​

검수 후 PUBLISHED 상태로 변경하면 앱 사용자가 룹 생성 시 해당 커버 템플릿을 선택할 수 있습니다.

보관 또는 재게시 ​

필요에 따라 ARCHIVED로 보관하거나, 보관된 템플릿을 다시 PUBLISHED로 재게시합니다.

관련 문서 ​

변경 이력 ​

날짜변경 내용관련 PR
2026-03-16최초 작성—