추가콕 시스템
문서 정보
- 작성일: 2026-03-21
- 최종 업데이트: 2026-06-29
- 버전: v2.0.0
개요
추가콕(PinKok)은 녹화 완료 후 영상 시청 중 특정 순간을 마킹하는 북마크 기능입니다.
녹화 중에만 찍을 수 있는 콕과 달리, 추가콕은 사용자가 영상을 다시 보면서 원하는 시점을 자유롭게 추가하거나 제거할 수 있습니다. 추가콕은 서버 DB 모델이 아니라 Firestore의 pin-timestamps 컬렉션에 저장됩니다.
콕과 추가콕
| 구분 | 콕(Kok) | 추가콕(PinKok) |
|---|---|---|
| 성격 | 녹화 중 타임스탬프 | 시청 중 북마크 |
| 생성 시점 | 녹화 중 | 영상 시청 중 |
| 수명 | 영상 만료까지 | 영상 만료까지 |
| 저장소 | Firestore, DB | Firestore |
| 입력 소스 | APP, BEACON | APP |
저장 구조
추가콕은 Firestore에 저장되며, 기존 콕의 Firestore 경로와 나란한 구조 를 사용합니다.
gyms/{gymCode}/date/{YYYY-MM-DD}/hour/{hour}/users/{userId}/pin-timestamps/{docId}
| 컬렉션 | 용도 |
|---|---|
timestamps | 콕 |
pin-timestamps | 추가콕 |
저장 필드
| 필드 | 타입 | 설명 |
|---|---|---|
timestamp | Firestore Timestamp | 영상 내 마킹 시점 |
source | string | 앱에서 생성된 추가콕 입력 소스 |
timestamp는 사용자가 시청한 실제 현재 시간이 아니라, 영상 안에서 마킹한 녹화 시점입니다.
예: 2026년 3월 19일 17:00~18:00 녹화 영상의 17:35 지점을 2026년 3월 21일에 마킹하면 timestamp는 2026-03-19T17:35:00 기준으로 저장됩니다.
자동 정리
추가콕은 별도 DB 정리 대상이 아닙니다. Firestore cleanup 스케줄러가 날짜 폴 더 단위로 재귀 삭제할 때 pin-timestamps 컬렉션도 함께 정리됩니다.
gyms/{gymCode}/date/{YYYY-MM-DD}
└── hour/{hour}/users/{userId}/pin-timestamps/
관련 cleanup 상수는 src/schedulers/firestore-cleanup/domains/kok/kok-cleanup.constant.ts의 PIN_TIMESTAMPS입니다.
FAQ
Q: 추가콕에 개수 제한이 있나요?
추가콕 자체에는 별도 서버 DB 기반 개수 제한이 없습니다.
Q: 영상이 만료되면 추가콕은 어떻게 되나요?
Firestore cleanup 스케줄러가 날짜 단위 정리 과정에서 함께 삭제합니다.
관련 문서
변경 이력
| 버전 | 날짜 | 변경 내용 |
|---|---|---|
| v2.0.0 | 2026-06-29 | MyKok 전환 설명을 제거하고 추가콕 현행 저장/정리 정책 중심으로 재정리 |
| v1.0.0 | 2026-03-21 | 추가콕 개념, Firestore 저장 구조, 자동 정리 메커니즘 문서화 |