복잡한 NAS 아카이브를 화면만 따라가며 운영하기.

처음 10분: 이 순서대로 누르기

처음에는 메뉴를 모두 이해하려 하지 않아도 됩니다. 아래 5개만 따라가면 “새 영상만 다운로드”라는 원래 목표까지 도달합니다.

대시보드: 오늘 눌러야 할 것만 보기

대시보드는 깊은 설정 화면이 아니라 운영 Cockpit입니다. 현재 채널의 미보관 수, 큐 대기, 저장소 압박, 런타임 상태를 한 화면에서 읽습니다.

무엇을 봐야 하나요? 좌측 메뉴 badge는 조치가 필요한 수입니다. 중앙의 빠른 이동 카드는 다음 행동으로 바로 이동합니다.

1. 현재 채널 드롭다운에서 운영할 채널을 고릅니다.
2. 새 영상 확인 카드가 0보다 크면 채널 sync부터 실행합니다.
3. 진행 보기가 0보다 크면 큐에 남은 작업을 확인합니다.
4. 런타임 꺼짐이면 Settings에서 워커/스케줄러를 켜야 실다운로드가 가능합니다.

채널 상세: 한 채널을 탭으로 정리하기

채널 화면은 개요 / 다운로드 / 라이브러리 / 로그 / 정책 탭으로 나뉩니다. 처음에는 개요에서 상태를 보고, 실제 작업은 다운로드 탭에서 시작합니다.

개요 탭 마지막 sync, 다음 sync 예정, 미보관 수, 최근 작업 결과를 한눈에 보는 화면입니다.

• 새 영상 확인: YouTube metadata를 다시 읽고 새 영상/삭제/비공개 상태를 갱신합니다.
• 새 영상만 다운로드: 미보관 영상만 후보로 만들고 확인 모달을 엽니다.
• 진행 보기: 현재 채널로 필터된 큐 화면으로 이동합니다.

다운로드: 새 영상만 안전하게 받기

다운로드 탭은 후보 생성, preflight, 선택 큐 등록, worker dry-run, 실다운로드 버튼을 한곳에 모읍니다. 기본값은 안전한 확인 흐름입니다.

런치 컨트롤 실행 가능, 후보, 대기, 선택 수와 예상 용량을 먼저 확인합니다.

확인 모달 이번 pass 최대 수, 이미 받은 영상 스킵 수, 대기 수를 확인한 뒤 시작합니다.

실다운로드 버튼이 잠겨 있을 때

• Worker is paused: 채널 정책이나 런타임 설정에서 worker claim이 막혀 있습니다.
• 실전 워커 꺼짐: Settings에서 워커를 켜고 apply/restart 흐름을 완료해야 합니다.
• 잡을 작업 0: 후보가 없거나 이미 보관된 파일로 판정된 상태입니다.

archive.txt 가져오기

기존 archive.txt를 붙여넣으면 앱이 각 라인을 이미 보관, 알려진 미보관, 알 수 없음, 중복/무효 라인으로 나눕니다. 이 단계에서는 실제 다운로드가 시작되지 않습니다.

큐: 지금 무엇이 움직이는지 보기

큐는 전체 job 관제 화면입니다. 채널 상세의 작은 큐보다 넓게 보고, 상태/프리플라이트/채널 필터로 작업을 좁힙니다.

상태별 작업 읽기 candidate는 후보, queued는 대기, running은 진행 중, failed는 재시도 판단이 필요한 상태입니다.

1. 실행 가능 필터로 지금 처리할 수 있는 작업만 봅니다.
2. 프리플라이트로 yt-dlp 실행 계획과 위험 신호를 확인합니다.
3. 선택 큐 등록으로 후보를 대기열에 올립니다.
4. 드라이런으로 worker가 어떤 작업을 잡을지 확인합니다.
5. 실다운로드는 확인 모달과 최대 5개/pass 제한 뒤에만 실행합니다.

라이브러리: 다운로드 완료를 파일 기준으로 확인

라이브러리는 DB 행만 믿지 않습니다. 다운로드 폴더 아래 실제 미디어 파일과 sidecar를 보고 보관됨/미보관/부분 sidecar/미디어만 있는 항목을 구분합니다.

완료 확인의 기준점 다운로드 후에는 이 화면에서 보관 수, 누락 수, sidecar 상태, 저장 경로를 확인합니다.

• 무자막 h264, media only 같은 저장 뷰로 반복 점검을 빠르게 합니다.
• 썸네일/자막/NFO가 빠진 항목은 sidecar 필터로 찾아 보강할 수 있습니다.
• 파일이 삭제됐는데 DB에만 남은 항목은 미보관/누락 쪽으로 드러나야 정상입니다.

로그와 정책: 왜 그렇게 됐는지 남기기

운영 앱은 결과보다 이유가 중요합니다. 로그 탭은 sync/download/library/runtime 이벤트를, 정책 탭은 채널별 자동화 기준을 보여줍니다.

로그 탭 실패, skipped, completed, duration, tick 상태를 추적하는 출발점입니다.

정책 탭 sync 주기, 자동 후보 생성, 최대 품질, 자막/오디오 정책을 채널별로 조정합니다.

• auto_download가 켜져도 worker가 꺼져 있으면 후보 생성만 되고 실제 claim은 멈춥니다.
• sync_interval_minutes가 metadata scheduler의 due channel 판정 기준입니다.
• 실패한 다운로드는 큐에서 retry하고, 반복 실패는 로그에서 원인을 확인합니다.

인사이트: NAS 폴더 상태를 실제 데이터로 보기

Insights는 저장소 scanner 화면입니다. 용량 압박, 폴더 구조, orphan sidecar, 인덱싱되지 않은 미디어, DB에는 있는데 디스크에 없는 항목을 찾습니다.

운영 점검 화면 디스크가 꽉 차기 전, sidecar가 떠돌기 전, 파일/DB drift가 커지기 전에 여기서 확인합니다.

설정: 런타임과 공개 전 안전장치

Settings는 앱을 운영 모드로 바꾸는 장소입니다. 워커, scheduler, yt-dlp/ffprobe 경로, restart adapter, auth token, 백업/복구 명령, tick 로그를 다룹니다.

런타임 env 매니페스트 현재 실행값과 .env.runtime 적용값이 일치하는지 보고, restart adapter 안내를 확인합니다.

1. CVN_AUTH_TOKEN을 설정해야 localhost 밖 공개가 안전해집니다.
2. 워커/scheduler 값을 수정하면 Apply 후 restart 흐름까지 완료합니다.
3. Docker Compose 환경은 restart 명령을 복사하거나 adapter 실행 설정을 검토합니다.
4. 문제가 생기면 support bundle을 내려 받아 민감정보가 제거됐는지 확인한 뒤 공유합니다.

모바일 폭: NAS 옆에서 빠르게 확인하기

모바일에서는 좌측 메뉴가 상단 그리드로 바뀌고, 카드가 세로로 쌓입니다. 실제 대량 운영은 데스크톱이 편하지만, 상태 확인과 빠른 이동은 좁은 화면에서도 가능합니다.

모바일에서 먼저 볼 것 상단 메뉴 badge, 현재 채널, 준비도 카드, Live 상태를 순서대로 읽으면 됩니다.

자주 헷갈리는 상태