[어드민] 숏폼 업로드 · 편집

화면 정보

Screen ID	Screen Title	메뉴 경로
ADM-CONTENT-SF-01	숏폼 업로드 / 편집 (BO_SF_UPLOAD)	콘텐츠 관리 > 숏폼

개요

백오피스에서 숏폼 콘텐츠(비디오/이미지)를 업로드·편집하는 화면. 사용자 화면이 아닌 백오피스 기능이므로 admin/content-management/ 하위로 분류한다. 연동 시스템: BytePlus (미디어 처리) · 자체 어드민.

미리보기 화면은 별도 문서 참고: shortform-preview (ADM-CONTENT-SF-02)

화면 흐름 개요

BO_SF_LIST_001 (숏폼 목록)
└── 새 콘텐츠 등록 또는 기존 콘텐츠 선택
    └── BO_SF_UPLOAD (숏폼 업로드/편집)
        ├── 저장 → BO_SF_DETAIL (숏폼 상세)
        │   └── Detail View > Preview 버튼
        │       └── BO_SF_PREVIEW (숏폼 미리보기 팝업)
        │           ├── X 버튼 → BO_SF_DETAIL 복귀
        │           └── Exit 버튼 → BO_SF_DETAIL 복귀
        └── 취소 → BO_SF_LIST_001 복귀

미리보기 진입 조건: 저장 완료 후에만 Preview 버튼 활성화. 저장 전에는 “미리보기는 저장한 뒤에 제공됩니다.” 안내 표시.

화면 구성

BO_SF_UPLOAD
├── 기본 정보 영역        ← Title / Admin Memo
├── 미디어 업로드 영역    ← 비디오 + 이미지 (최대 10개)
├── 상품 태깅 영역        ← Product Tag 버튼 (최대 8개)
├── 노출 설정 영역        ← 토글 스위치
└── 하단 버튼 영역        ← 저장 / 취소

기본 정보 입력

필드	규칙
Title	필수 입력, 글자 수 제한 없음
Admin Memo	Master 계정만 입력 가능, 일반 사용자 입력 불가

미디어 업로드 규칙

파일 제한

타입	최대 크기	지원 포맷
비디오	20GB	MP4, FLV, ASF(WMV), RM, RMVB, MPEG, MOV, AVI, FLASH, MPEG-TS(MTS), M4S, M3U8, MKV
이미지	50MB	PNG, JPG, JPEG (권장 해상도: 1080×1920px)

업로드 공통 규칙

항목	기준
최대 업로드 수	10개 (비디오 + 이미지 조합 가능)
+ 버튼 표시	10개 미만일 때만 표시, 10개 도달 시 숨김
파일 삭제	각 파일 우측 상단 X 버튼으로 즉시 삭제
표시 순서	업로드 순서대로 좌측부터 배치
썸네일 자동 설정	첫 번째(order=1) 콘텐츠가 썸네일로 자동 설정

썸네일 자동 생성 기준

첫 번째 콘텐츠 타입	썸네일 처리
이미지	해당 이미지를 비율 유지하며 리사이징하여 썸네일로 사용
영상	영상의 첫 프레임(0초 시점)을 추출하여 썸네일로 사용

썸네일 자동 설정은 저장 후에만 적용된다.

상품 태깅

항목	기준
최대 태깅 수	8개
초과 시	“최대 8개까지만 상품을 태그할 수 있습니다” 메시지
표시 순서	추가된 순서대로 나열
순서 변경	드래그로 변경 가능

상품 태깅 팝업 (BO_SF_PRODUCT_PU)

항목	기준
검색 대상	영문 상품명(`product.name`), 상품 코드(`product.code`)
검색 방식	부분 일치
검색 실행	Enter 키 또는 검색 아이콘 클릭
제외 조건	`product.visible = 0` 상품 제외
결과 없음 메시지	“검색된 상품이 없습니다.”
선택 방식	체크박스 다중 선택
선택 상품 표시	“Selected Products: N” 형태
순서 변경	햄버거 아이콘 드래그
Reset 버튼	검색 내용 및 추가 상품 전체 초기화
Add 버튼	선택 상품 추가 후 팝업 닫기
X 버튼	변경사항 무시하고 팝업 닫기

노출 설정 (토글)

항목	기준
ON	`visible = 1` (노출)
OFF	`visible = 0` (비노출)
토글 변경 가능 조건	Master 계정 승인 시에만 변경 가능
미승인 상태	비활성화 스타일로 표시

하단 버튼

버튼	동작
저장	정보 저장 후 현재 화면 유지, “Saved” 토스트 표시
취소	변경사항 무시하고 BO_SF_LIST_001으로 이동

정책

콘텐츠 상태 관리

상태 코드 정의

상태	조건	설명
DRAFT	제목만 입력하고 저장	최소 필수값만 입력된 상태
PENDING	제목 + 미디어 업로드 후 처리 중	BytePlus 처리 진행 중
INCOMPLETE	미디어 처리 실패 또는 오류	재시도 기능 없음, 재업로드 필요
READY	모든 입력 완료 + 처리 성공	승인 대기 상태
APPROVED	READY 상태에서 Master 승인	노출 활성화 가능 상태
REJECTED	READY 상태에서 Master 거부	—
PUBLISHED	APPROVED 상태에서 노출 ON	실제 앱에 노출 중

상태 전환 흐름

제목 저장
└── DRAFT

미디어 업로드
└── DRAFT → PENDING (BytePlus 처리 시작, 평균 1분 이내)
    ├── 처리 성공 → READY
    └── 처리 실패 → INCOMPLETE (재시도 불가, 재업로드 필요)

Master 검토
├── 승인 → READY → APPROVED
└── 거부 → READY → REJECTED

노출 설정
├── ON → APPROVED → PUBLISHED
└── OFF → PUBLISHED → APPROVED

백그라운드 처리: PENDING 상태에서 화면을 나가도 BytePlus 처리는 백그라운드에서 계속 진행된다.

조회수 집계 정책

항목	기준
중복 카운트 방지	동일 사용자가 24시간 내 같은 숏폼 반복 조회 시 1회만 카운트
영상 콘텐츠	실제 재생 시작 시 카운트
이미지 콘텐츠	이미지가 완전히 로드되어 화면에 표시될 때 카운트
다중 콘텐츠	첫 번째 콘텐츠가 위 조건 충족 시 카운트
카운트 경로	피드 상세 이동 / 공유 링크 접속
백오피스 업데이트 주기	5분 내외 (거의 실시간)

노출이 안 될 때 체크리스트

확인 항목	확인 방법	정상 기준
저장 후 상태가 PENDING에서 안 바뀜	BytePlus 처리 시간 확인	평균 1분 이내 READY로 전환
상태가 INCOMPLETE로 변경	미디어 파일 포맷·크기 확인	재시도 기능 없음, 파일 재업로드 필요
토글 변경 불가	콘텐츠 승인 상태 확인	Master 승인(APPROVED) 상태여야 토글 변경 가능
상품 검색 결과 없음	`product.visible` 값 확인	`visible = 1`인 상품만 검색됨
파일 업로드 + 버튼 미노출	업로드된 파일 수 확인	10개 도달 시 숨김 (정상)

미결 사항

항목	내용
—	—

변경 이력

버전	날짜	변경 내용
v1.0	2026-07-30	최초 작성 (숏폼 업로드 · 편집 · 미리보기 마스터.md 중 BO_SF_UPLOAD + 상태관리 + 조회수정책 이전)