[Content] 메인 히어로 배너 CMS

Strapi 담당자: 김규현

참고: Strapi 기존 메인 배너 관리 기능과 동일한 구조. 비디오 첨부 및 텍스트 위치 설정 기능이 추가됨.

개요

YETI 메인 페이지 히어로 영역에 노출되는 캐러셀 배너를 Strapi CMS에서 관리하는 기능. PC/Mobile 별도 미디어, 텍스트 콘텐츠, 레이아웃 정렬, 버튼, 노출 기간/순서를 설정할 수 있다.

---

필드 정의

1. 미디어

필드	타입	필수	설명
mediaType	Select	O	image / video
pcMedia	File Upload	O	PC용 이미지 또는 영상
mobileMedia	File Upload	O	Mobile용 이미지 또는 영상
pcThumbnail	Image Upload	조건부	video일 때 PC 로딩 전 썸네일
mobileThumbnail	Image Upload	조건부	video일 때 Mobile 로딩 전 썸네일

영상 정책

• 재생 방식: autoplay, muted, loop
• 재생 컨트롤 UI 노출
• 파일 용량/해상도 제한, 이미지 허용 포맷: 개발자 재량

---

2. 텍스트 콘텐츠

필드	타입	필수	설명
badge	Text	X	배지 텍스트
badgeTextColor	Color	X	배지 텍스트 색상 (배경 없음)
title	Text (여러 줄)	O	메인 타이틀, 줄바꿈 그대로 렌더링
titleTextColor	Color	O	타이틀 색상 (PC/Mobile 동일 적용)
description	Text (여러 줄)	X	설명, 줄바꿈 그대로 렌더링
descriptionTextColor	Color	X	설명 텍스트 색상 (PC/Mobile 동일 적용)

---

3. 레이아웃

필드	타입	필수	설명
contentAlignment	Select	O	left / right
textPosition	Select	O	Title 및 Description의 표시 위치 설정

contentAlignment 동작

값	PC	Mobile (세로 스택)
left	텍스트 왼쪽 / 미디어 오른쪽	미디어 위 / 텍스트 아래
right	미디어 왼쪽 / 텍스트 오른쪽	텍스트 위 / 미디어 아래

반응형 breakpoint, 영역 비율, textPosition 선택지: Figma 기준으로 개발자 재량

---

4. 버튼

필드	타입	필수	설명
buttonText	Text	X	버튼 라벨
buttonUrl	URL	X	버튼 클릭 시 이동 경로 (현재 탭)
buttonStyle	Select	X	Figma 디자인 참고

• buttonText 미입력 시 → 버튼 영역 자체 비노출
• hover 효과 없음

---

5. 배너 링크

필드	타입	필수	설명
goToUrl	URL	O	배너 전체 영역 클릭 시 이동 (현재 탭)

클릭 동작

• 배너 전체 클릭 → goToUrl로 이동
• 버튼 클릭 → buttonUrl로 이동 (버튼은 배너 전체 링크와 독립적)

---

6. 운영 설정

필드	타입	필수	설명
displayDate	Date Range	O	노출 시작/종료 일시
order	Number	O	정렬 순서 (낮을수록 우선 노출)

---

정책

캐러셀 동작

• 배너 여러 개일 때: 기존 슬라이드 방식 동일
• 자동 전환: 기존 정책 동일

Validation 규칙

조건	규칙
mediaType = video	pcThumbnail, mobileThumbnail 필수
buttonText 입력 시	buttonUrl 필수
공통	goToUrl 필수, displayDate 필수

---

CMS 입력 순서

운영자가 배너를 등록할 때 노출되는 필드 순서입니다.

1. mediaType
2. pcMedia
3. mobileMedia
4. pcThumbnail (video일 때만 노출)
5. mobileThumbnail (video일 때만 노출)
6. badge
7. badgeTextColor
8. title
9. titleTextColor
10. description
11. descriptionTextColor
12. contentAlignment
13. textPosition
14. buttonText
15. buttonUrl
16. buttonStyle
17. goToUrl
18. displayDate
19. order

---

변경 이력

버전	날짜	변경 내용
v1.0	2026-06-23	최초 작성
v1.1	2026-06-23	비디오 첨부 기능 추가, textPosition 필드 추가, Strapi 담당자 기록