일일 업로드 현황 (Analytics > Daily Upload)
문서 정보
- 작성일: 2026-05-03
- 최종 업데이트: 2026-05-03
- 버전: v1.0.0
"오늘 이 체육관 영상이 제대로 올라오고 있나?"를 확인하는 페이지입니다. 코트 → 세션(예약 시간 블록) → 10분 슬롯 → 카메라 순으로 사격표처럼 펼쳐지며, 각 칸의 색상으로 업로드 성공·실패·진행 중을 즉시 파악할 수 있습니다.
목차
이 페이지가 하는 일
경로: 어드민 > 분석 > 일일 업로드 현황
특정 체육관의 하루치 영상 업로드 현황을 코트 단위로 점검합니다. 실시간 현황 페이지에서 "영상 업로드 이상"을 발견했을 때 이 페이지로 넘어와 어느 코트·어느 시간대·어느 카메라에서 문제가 생겼는지 구체적으로 확인합니다.
실시간 현황 과의 차이
| 구분 | 실시간 현황 | 일일 업로드 현황 |
|---|---|---|
| 범위 | 지금 이 순간 이상이 있는 코트만 | 하루 전체 업로드 이력 |
| 갱신 | 30초 자동 | 날짜·체육관 변경 시 수동 |
| 목적 | 문제 감지 | 문제 원인 drill-down |
| 표현 방식 | 카드 형식 알림 | 사격표 그리드 |
페이지 구성 한눈에 보기
┌───────────────────────────────────────────────────────────┐
│ [프로필] OO체육관 │
│ 운영시간 월~금 06:00~22:00 / 토~일 09:00~20:00 │
│ 날짜: [오늘 ▼] │
├───────────────────────────────────────────────────────────┤
│ ⚠ 과거 날짜를 선택하면 일부 영상이 삭제됐을 수 있습니다 │ ← 과거 날짜 선택 시만 표시
├───────────────────────────────────────────────────────────┤
│ │
│ ╔══ A코트 · 예약 단위 60분 · 카메라 3대 ══╗ │
│ │
│ ┌─────────────────────────────────────────────────────┐ │
│ │ 10:00 ~ 11:00 예약 있음 (2명) │ │
│ ├───────────────┬──────┬──────┬───── ─┬──────┬──────┬──┤ │
│ │ │10:00 │10:10 │10:20 │10:30 │10:40 │…│ │
│ │ 정면 카메라 │ ● │ ● │ ● │ ● │ ● │…│ │
│ │ 측면 카메라 │ ● │ ● │ ● │ ● │ ● │…│ │
│ │ 후면 카메라 │ ● │ ◐ │ ◯ │ — │ — │…│ │
│ │ 합본 영상 R2 │ ● │ — │ — │ — │ — │…│ │
│ │ 합본 스트리밍 │ ● │ ◐ │ — │ — │ — │…│ │
│ │ 영상 삭제 │ — │ — │ — │ — │ — │…│ │
│ │ 데이터콕 │ 1 │ — │ — │ — │ — │…│ │
│ └───────────────┴──────┴──────┴──────┴──────┴──────┴──┘ │
│ │
│ 범례: ● 완료 ◐ 진행 중 ◯ 실패 — 없음 │
│ │
└───────────────────────────────────────────────────────────┘
영역별 사용 가이드
체육관 및 날짜 선택
페이지 상단에서 체육관과 날짜를 선택합니다.
- 체육관 선택: 왼쪽 목록에서 보고 싶은 체육관을 클릭합니다.
- 날짜 선택: 기본값은 오늘입니다. 날짜 토글을 눌러 과거 날짜를 조회할 수 있습니다.
과거 날짜 조회 시 주의
48시간이 지난 영상과 예약이 없었던 영상은 자동으로 삭제됩니다. 어제 이전 날짜를 조회하면 일부 슬롯의 영상이 이미 삭제된 상태일 수 있으므로, 상단에 경고 배너가 표시됩니다. 업로드 실패와 삭제 완료를 혼동하지 않도록 주의하세요.
코트 블록
체육관 아래에 코트별로 블록이 나뉩니다. 각 블록 헤더에는 다음이 표시됩니다.
╔══ A코트 · 예약 단위 60분 · 카메라 3대 ══╗
- A코트: 코트 이름
- 예약 단위 60분: 이 코트의 녹화·예약 단위 시간 (체육관마다 다를 수 있음)
- 카메라 3대: 이 코트에 설치된 카메라 수
예약 단위가 60분이면 세션 하나가 1시간짜리 블록이고, 20분이면 20분짜리 블록 여러 개로 나뉩니다.
세션 카드 (예약 시간 단위)
각 코트 블록 안에는 세션 카드가 시간 순서로 나열됩니다. 세션은 "한 번의 예약 가능 시간 블록"입니다.
10:00 ~ 11:00 예약 있음 (2명)
11:00 ~ 12:00 예약 없음
예약 있음 표시는 해당 시간대에 실제 예약한 사용자가 있다는 뜻입니다. 예약이 있는 세션에서 업로드 이상이 발생하면 영상을 기다리는 사용자가 있을 가능성이 있으므로 우선 처리해야 합니다.
운영시간 외 세션은 별도로 구분 표시됩니다. 체육관이 문을 닫은 시간대에 업로드가 없는 것은 정상이므로, 운영시간 외 슬롯이 비어 있어도 문제가 아닙니다.
사격표 그리드 읽는 법
세션 카드 내부는 행(카메라/합본/삭제/데이터콕) × 열(10분 단위 슬롯) 형태의 그리드입니다.
행의 종류
| 행 이름 | 의미 |
|---|---|
| 정면·측면·후면 카메라 | 각 카메라가 10분 단위로 R2 스토리지에 업로드한 영상 |
| 합본 영상 R2 | 여러 카메라를 하나로 합친 영상이 R2 스토리지에 저장됐는지 |
| 합본 스트리밍 | 합본 영상이 스트리밍 가능한 상태로 변환됐는지 |
| 영상 삭제 | 해당 슬롯 영상이 자동 삭제됐는지 여부 |
| 데이터콕 | 해당 슬롯 영상에 저장된 데이터콕(PLUS 이상 기능) 개수 |
열(슬롯) 규칙
- 예약 단위가 60분인 코트는 10분짜리 슬롯이 6개입니다 (10:00, 10:10, 10:20, …, 10:50).
- 예약 단위가 20분인 코트는 슬롯이 2개입니다 (10:00, 10:10).
상태 정의
카메라 및 합본 영상 상태
| 표시 | 의미 | 운영팀 판단 |
|---|---|---|
| ● (초록) | 업로드 또는 변환 완료 | 정상 |
| ◐ (노랑) | 업로드 또는 변환 진행 중 | 잠시 대기, 계속되면 주시 |
| ◯ (빨강) | 업로드 또는 변환 실패 | 원인 확인 및 재업로드 검토 |
| — (회색) | 데이터 없음 (아직 처리 안 됨 또는 해당 없음) | 현재 시각 이후 슬롯이면 정상 |
합본 영상 상태 세부
| 상태 | 의미 |
|---|---|
| 합본 진행 중 (◐) | 카메라 영상들을 합치는 작업이 진행 중 |
| 합본 완료 (●) | 합친 영상이 R2에 저장 완료 |
| 스트리밍 준비 완료 (●) | 웹/앱에서 재생 가능한 상태 |
| 스트리밍 인코딩 실패 (◯) | Cloudflare Stream 변환 실패, 재업로드 필요 |
영상 삭제 상태
| 표시 | 의미 |
|---|---|
| — (없음) | 영상 보관 중 (정상) |
| ✓ (삭제 완료) | 자동 삭제 완료 (예약 없거나 48시간 경과) |
삭제 완료 표시된 슬롯은 영상 재생이 불가하며, 재업로드해도 복원되지 않습니다.
데이터콕 수
해당 10분 슬롯 영상에 저장된 데이터콕(PLUS 이상 사용자의 영구 저장 클립) 개수입니다. 숫자가 있다는 것은 그 슬롯 영상에 사용자가 저장한 클립이 있다는 의미로, 그 슬롯이 중요한 영상임을 나타냅니다.
하위 페이지
슬롯 상세 (분석 > 일일 업로드 현황 > 상세)
그리드의 특정 슬롯을 클릭하면 상세 페이지로 이동합니다.
- 예약자 목록 팝업: 해당 세션의 예약자 이름·연락처를 확인합니다.
- 재업로드 요청: 합본 스트리밍 변환에 실패한 경우 재처리를 요청합니다. 수 분 이내에 재시도가 시작됩니다.
- 스케줄 가져오기: 예약과 연결이 끊어진 녹화 세션을 수동으로 예약에 연결합니다. 특수한 경우에만 사용합니다.
영상 플레이어 (분석 > 일일 업로드 현황 > 플레이어)
업로드된 영상을 어드민에서 직접 재생합니다. 세션 단위로 카메라별 영상을 확인할 수 있습니다.
운영 시나리오
시나리오 1: 체육관에서 "오늘 영상이 안 올라와요"라고 연락이 왔다
- 해당 체육관을 선택하고 날짜를 오늘로 설정합니다.
- 코트 블록을 하나씩 확인합니다. 빨간 ◯ 표시가 있는 행·열을 찾습니다.
- 카메라 행에 ◯가 있다면 해당 카메라 PC 또는 네트워크 문제 가능성 → 현장 확인 요청
- 합본 스트리밍 행에 ◯가 있다면 변환 서버 처리 오류 가능성 → 상세 페이지에서 재업로드 요청
- 문제 슬롯에 "예약 있음" 표시라면 해당 사용자에게 안내 필요
시나리오 2: 실시간 현황의 영상 업로드 이상 알림에서 빨간불이 왔다
- 알림 카드의 "일일 업로드 보기" 클릭
- 해당 체육관·코트 블록으로 이동
- 어느 카메라·어느 시간대에 문제가 생겼는지 그리드에서 빨간 ◯ 위치 확인
- 예약자가 있으면 최우선 대응, 없으면 다음 업로드 사이클(10분 후)까지 주시
시나리오 3: 어제 데이터를 점검하고 싶다
- 날짜 토글에서 어제 날짜 선택
- 상단 경고 배너 확인 ("일부 영상이 삭제됐을 수 있음")
- 영상 삭제 행에 ✓ 표시된 슬롯은 이미 삭제 완료된 상태 — 업로드 실패와 혼동 주의
- 어제까지 업로드됐던 슬롯 중 실패(◯) 표시는 당시 발생한 문제이므로, 이미 사용자 피해가 발생했을 가능성 있음 → 이슈 기록
FAQ
Q: 운영시간 외 슬롯이 모두 비어 있는데 정상인가요?
네, 정상입니다. 체육관이 문을 닫은 시간대에는 예약도 없고 카메라도 녹화하지 않습니다. 운영시간 외 세션은 별도로 구분 표시되므로, 비어 있어도 이상 신호가 아닙니다.
Q: 합본 영상은 언제 만들어지나요?
카메라 영상이 10분 단위로 업로드되면, 그 영상들을 하나로 합치는 작업이 자동으로 시작됩니다. 합본 작업에는 수 분이 걸리므로, 카메라 업로드 완료 직후에는 합본 행이 ◐ (진행 중)으로 표시될 수 있습니다.
Q: 재업로드 요청을 하면 바로 복구되나요?
재업로드 요청은 합본 스트리밍 변환 실패 시 재처리를 요청하는 기능입니다. 요청 후 수 분 이내에 재시도가 시작되며, 성공하면 합본 스트리밍 행이 ● 로 바뀝니다. 개별 카메라 업로드 실패(카메라 행의 ◯)는 현장 장비·네트워크를 점검해야 하며, 어드민에서 원격으로 복구할 수 없습니다.
Q: 데이터콕 숫자가 있는 슬롯 영상이 삭제됐을 수 있나요?
데이터콕이 연결된 영상도 보관 정책에 따라 삭제될 수 있습니다. 삭제되면 데이터콕 재생이 불가능해집니다. 단, 데이터콕 항목 자체는 삭제되지 않으므로 사용자 데이터콕 목록에는 남아 있습니다.
관련 문서
- 실시간 현황 — 이상 알림 발생 시 이 페이지로 drill-down
- 일일 업로드 현황 (BE 가이드) — 상태 필드 기술 정의 및 보관 정책 상세
변경 이력
| 버전 | 날짜 | 변경 내용 |
|---|---|---|
| v1.0.0 | 2026-05-03 | 초기 문서 작성 - 운영자 친화 한국어로 전면 재작성 - 사격표 그리드 읽는 법, 상태 정의 명확화 - 체육관 선택·날짜 선택·코트 블록·세션 카드 영역 설명 - 3가지 운영 시나리오 및 FAQ 4개 추가 |