기역월드 K-POP 방송 운영 안내서

1폴더 준비

1. giyeok-site.zip의 압축을 풀면 giyeok-site 폴더가 생깁니다.
2. 노래-1.zip, 노래-2.zip을 풀어 나온 heal-01~14.m4a 14곡을 giyeok-site/music 폴더 안에 넣습니다.
3. 확인: giyeok-site 바로 안에 _worker.js, _routes.json, index.html, admin.html이 보이고, music 폴더에 14곡이 있어야 합니다.

2시험용 프로젝트 만들기

1. dash.cloudflare.com 로그인 → 왼쪽 Workers & Pages → Create(생성).
2. Pages 탭 → Upload assets(파일 업로드) 선택.
3. 프로젝트 이름에 gwkpop-test 입력 → Create project.
4. giyeok-site 폴더 전체를 끌어다 놓고 → Deploy site.
5. 완료되면 https://gwkpop-test.pages.dev 주소가 생깁니다. (이 상태에선 방송 화면만 되고, 관리자는 아직 안 됩니다.)

3데이터베이스(D1) 만들기 — 필수, 무료

1. 왼쪽 Storage & Databases → D1 SQL Database → Create.
2. 이름 gwkpop-db → Create. (표는 첫 접속 때 자동으로 만들어집니다. 따로 할 일 없음)

4파일 저장소(R2) 만들기 — 선택

1. 왼쪽 R2 Object Storage → 처음이면 이용 신청 → Create bucket → 이름 gwkpop-media.
2. R2는 처음 신청할 때 결제 카드 등록을 요구할 수 있습니다. 무료 한도(10GB 보관, 내려받기 무료) 안에서는 0원입니다.
3. 카드 등록이 꺼려지면 건너뛰어도 됩니다. 이 경우 올린 사진·음원은 D1에 나눠 저장됩니다(5GB까지 무료). 영상은 유튜브 링크를 쓰므로 용량 걱정이 거의 없습니다.

5프로젝트에 연결(바인딩)

1. Workers & Pages → gwkpop-test → Settings(설정) → Bindings(바인딩) → Add.
2. D1 database 선택 → 변수 이름 DB (대문자 그대로) → 데이터베이스 gwkpop-db → 저장.
3. (R2를 만들었다면) R2 bucket 선택 → 변수 이름 MEDIA → 버킷 gwkpop-media → 저장.

6관리자 비밀번호 저장 — 서버에만 보관

1. 같은 Settings → Variables and Secrets(변수 및 비밀) → Add.
2. Type(유형): Secret(비밀) · 이름 ADMIN_PASSWORD · 값: 새 비밀번호 → 저장.
3. 비밀번호는 10자 이상, 영문·숫자·기호 섞어서. 예전 임시 비밀번호(1005)는 쓰지 마세요.
4. Secret으로 저장하면 Cloudflare 화면에서도 다시 보이지 않습니다. 따로 안전한 곳에 적어 두세요.

7한 번 더 올리기(설정 적용)

1. 바인딩과 비밀번호는 다음 배포부터 적용됩니다.
2. gwkpop-test → Deployments(배포) → Create deployment(새 배포) → 같은 giyeok-site 폴더를 다시 끌어다 놓기 → Save and Deploy.

8관리자 첫 로그인

1. https://gwkpop-test.pages.dev/admin.html 접속 → 비밀번호 입력.
2. 처음 로그인하면 기존 내용(뮤직비디오·노래 14곡·라이브·숏츠·홍보모델·공지·편성표)이 자동으로 서버에 옮겨집니다.
3. 위에 “즉시 반영” 표시가 보이면 성공입니다. “비밀번호가 설정되지 않음”이 나오면 6·7단계를 다시 확인하세요.

체크는 이 화면에서만 표시되고 저장되지 않습니다.

방송 화면 gwkpop-test.pages.dev

관리자 화면 /admin.html

1. /admin.html 로그인 → 아이콘(뮤직비디오·라이브·쇼츠·드라마·음원·홍보모델) 선택.
2. ＋ 새로 추가 → 유튜브 주소 붙여넣기 → 저장. 저장 즉시 방송국에 반영됩니다.
3. 여러 개 한꺼번에: 왼쪽 체크 → 아래 공개 / 숨김 / 삭제 버튼.
4. 잘못 지웠으면 휴지통에서 복구. “영구 삭제”만 되돌릴 수 없습니다.
5. 한 달에 한 번쯤 홈 화면의 백업(data.js) 받기를 눌러 보관하세요.
6. 영상은 유튜브에 올리고 링크만 등록하세요. 저장 공간과 비용이 들지 않습니다.

방송 화면은 1분 단위로 캐시하고, 사진·음악 파일은 서버를 거치지 않도록 해 두어 한도를 아낍니다. 한도는 매일 오전 9시(한국 시간)에 초기화됩니다. 유료 플랜(Workers Paid, 월 $5)은 지금 필요 없으며, 필요해지면 먼저 말씀드립니다.

• 서버에 문제가 생겨도 방송 화면은 data.js(비상 사본)로 계속 보입니다.
• 백업 ZIP(giyeok-backup-20261010.zip)은 그대로 보관하세요. 평소에는 ZIP을 다시 올릴 필요가 없습니다.
• 비밀번호를 바꾸려면 6단계에서 값을 바꾸고 7단계처럼 다시 배포하면 됩니다. 기존 로그인은 모두 풀립니다.