Witch Rift WEB 0.8

수정일 2026-10-21 · 기존 운영 주소와 DB를 유지하는 패치

패치 ZIP 다운로드

1. 먼저 백업

운영 Cloudflare 계정 권한은 이 작업 환경에 없어 실제 운영 DB 백업·배포는 실행하지 않았습니다. 본인 PC에서 아래 순서로 진행하세요. 공유 중인 사용자에게 잠시 기록을 중단해 달라고 요청하고 기존 WitchRift-Web 폴더를 통째로 복사해 보관하세요. 관리자 화면의 기존 JSON 백업도 받아두세요.

기존 프로젝트의 cloudflare-worker 폴더에서 실행합니다. DB 이름이 다르면 본인의 wrangler.jsonc에 있는 database_name을 사용하세요.

npx wrangler d1 export witch-rift --remote --output=backup-before-web08.sql

명령 성공과 SQL 파일 생성 여부를 확인하고 백업은 공유하지 않는 장소에 보관하세요. 리플레이·시즌·칭호·기존 데이터까지 포함한 전체 복구용은 D1 SQL 백업입니다. 화면의 JSON 백업은 기존 점수·쿠폰 데이터만 포함합니다.

2. 패치와 DB 추가

  1. 패치 ZIP을 해제하면 lib, public, cloudflare-worker 폴더가 있습니다. 기존 WitchRift-Web 폴더에 같은 위치로 덮어씁니다.
  2. 기존 wrangler.jsonc, .dev.vars, secrets, DB ID, 봇 토큰은 유지하세요. 패치에는 이 파일들을 넣지 않았습니다.
  3. cloudflare-worker 폴더에서 아래 명령을 실행하세요.
npx wrangler d1 migrations list witch-rift --remote
npx wrangler d1 migrations apply witch-rift --remote
npx wrangler deploy

신규 마이그레이션은 0002_replays.sql입니다. app_state/polls/votes를 삭제하거나 초기화하지 않고 리플레이·시즌·집계·감사 테이블과 인덱스/트리거를 추가합니다. 기존 0001은 이미 적용된 상태여야 합니다. 이전 테이블이 있는데 0001이 미적용으로 표시되면 반복 실행하지 말고 기존 마이그레이션 이력을 먼저 확인하세요.

배포 후 브라우저를 강력 새로고침하고 WEB 0.8 표시, 기존 참가자·쿠폰 잔액·디스코드 모집 상태를 확인하세요. 운영 주소는 기존 Worker 주소 그대로입니다. ChatGPT의 별도 개인 사이트 배포는 이 Worker 배포를 대신하지 않습니다.

3. 사용 방법

  1. 관리자 입장 → 연결·설정에서 기존 관리자 키로 연결합니다. 키는 화면 메모리에만 유지되며 새로고침하면 다시 연결합니다.
  2. 경기·리플레이 → 리플레이 분석·등록 → 로컬 .rofl 선택. 브라우저 Web Worker가 메타데이터와 SHA-256을 계산합니다. 원본은 네트워크로 보내지 않습니다.
  3. 10명의 Riot ID를 기존 참가자와 연결하세요. 첫 등록은 직접 연결합니다. 다음부터 저장된 PUUID를 우선, 정확한 Riot ID+태그를 보조로 사용합니다. 닉네임 비슷함만으로 자동 연결하지 않습니다.
  4. 실제 경기 시작 시각을 한국 시간으로 입력하고, 파일명에서 읽은 게임 ID·승패·통계를 확인하세요. 확인 사유를 입력하고 등록을 확정합니다. 확정 전에는 집계되지 않습니다.
  5. 잘못된 결과는 경기 상세에서 수정·재연결 또는 집계 제외할 수 있습니다. 제외는 삭제가 아니며 복원 가능합니다. 모든 수정은 사유와 이전 내용을 기록합니다.
  6. 리더보드와 챔피언 티어에서 범위/포지션/패치/최소 경기 수를 선택하세요. 참가자 프로필의 새 경기 통계는 기존 평가·누적 점수와 구분합니다.

기존 결과 기록은 점수·쿠폰 지급용, 리플레이 등록은 상세 통계용입니다. 리플레이 등록으로 기존 점수나 쿠폰을 다시 지급하지 않습니다. 기존 결과 기록 버튼은 그대로 사용하세요. 실제 샘플 경기를 운영 데이터에 자동 등록하지 않았습니다.

세트 결과가 2:1인 경우 기존 점수 시스템의 승패는 세트 차 기준입니다. 새 리플레이 통계는 실제 개별 경기 단위이므로 두 숫자가 다를 수 있습니다.

4. 시즌과 칭호

시즌 기본 OFF. 관리자가 시즌 이름과 시작/종료를 저장해야 사용됩니다. 시작 시각 이상·종료 미만, 한국 시간 입력을 UTC로 저장합니다. 시즌 밖의 경기는 비시즌이며 전체 누적에도 포함됩니다. 종료 후 자동으로 비시즌으로 돌아갑니다. 과거 시즌 지연 등록도 경기 시각으로 판정합니다.

일정 변경 전 기간 내 경기 수를 보여주며 기존 귀속을 자동으로 바꾸지 않습니다. 재분류하려는 경기는 상세 → 수정에서 대상 시즌 안내를 확인하고 한 경기씩 확정하세요. 새 시즌을 만들어도 기존 평가/점수/기록/획득 칭호를 지우지 않습니다.

기존 칭호 조건을 그대로 사용합니다. 다음 저장 시 충족된 칭호를 이력으로 보관하며 조건 변경/시즌 변경 후에도 유지합니다. 이전 버전은 획득일을 기록하지 않았으므로 과거 실제 획득일은 복원할 수 없습니다. 최초 저장 확인일로 명확히 표시합니다. 기존 조건은 누적 전적 기준이라 시즌 값은 없음입니다. 임의 시즌 칭호 규칙을 추가하지 않았습니다.

5. 파서 지원과 신뢰 한계

실제 검증 파일 KR-8423135523.rofl, 13,462,456바이트, RIOT ROFL v2, 패치 16.20.824.8524. 끝 4바이트의 little-endian 메타데이터 길이와 statsJson을 읽었습니다. 10인 경기, BLUE 승리, 킬 38:9, 게임 길이 1,510,533ms(표시 약 1,511초) 확인. 챔피언·포지션·K/D/A·CS(라인+정글)·골드·챔피언 피해량·시야 점수를 추출했습니다.

경기 시각은 확인되지 않아 관리자 입력이 필수이며, 게임 ID는 파일명 출처를 표시합니다. 서버는 24KB 이하의 허용된 통계 필드만 정규화하고 10명·5:5·승패·범위·기존 참가자 연결을 검증합니다. 원본을 받지 않으므로 악의적으로 조작된 통계의 진위를 증명할 수는 없습니다. 관리자 검토와 감사 기록이 신뢰 경계입니다.

지원: 최신 Chrome/Edge의 Web Worker·Web Crypto, RIOT v2 JSON 통계 포함 파일, 최대 64MiB. 다른 패치의 구조가 동일할 수 있지만 검증하지 않은 버전을 보장하지 않습니다. 형식이 바뀌면 실패 이유를 표시하고 등록을 중단합니다. 유료 분석/원본 업로드로 전환하지 않습니다.

메타데이터는 최대 2MiB, 해시는 최대 64MiB 파일 버퍼를 사용합니다. 저사양 모바일은 메모리 부족으로 실패할 수 있습니다. 취소 버튼으로 브라우저 작업을 종료할 수 있습니다.

상세 화면의 로컬 파일 재선택은 해시와 게임 ID를 대조합니다. 다른 파일이면 연결하지 않습니다. 로컬 파일은 별도 영구 저장하지 않으므로 새로고침·다른 기기·브라우저 저장소 삭제 후 다시 선택하세요. 서버 통계는 유지됩니다. 실제 관전은 호환되는 LoL 클라이언트가 필요하며 브라우저 재생·옛 패치의 영구 재생을 제공하지 않습니다.

6. 무료 운영 범위와 보호

공식 문서 확인일 2026-10-21. 계정 플랜·실제 잔여량·다른 Worker/DB 사용량은 접근 권한이 없어 확인 불가입니다. 유료 플랜 전환이나 결제 설정은 하지 않았습니다.

자원Free 공식 한도앱 대응
Workers100,000 요청/일(UTC), CPU 10ms/호출, 메모리 128MB파싱은 브라우저. 60초 자동 폴링 제거, 통계 조회 30초 메모리 캐시
D1 읽기/쓰기읽기 500만 행/일, 쓰기 10만 행/일인덱스·20경기 페이지·증분 집계, 일 등록 100건/변경 200회 보호
D1 저장DB 하나 500MB, 계정 합계 5GB경기 2만 건 또는 경기·감사 본문 합계 100MB부터 등록 제한. DB 전체 크기는 대시보드 확인
정적 자산정적 자산 요청 무료·무제한, 파일 하나 25MiB파서 필요할 때 로딩. 원본 파일 서버 보관 없음. /api/*의 Worker 호출은 별도 요청 한도

운영 화면은 저장된 경기 수와 경기·감사 JSON의 UTF-8 바이트를 실제 누적 측정합니다. 인덱스/정규화 행/집계 행/기존 데이터의 전체 DB 크기는 포함하지 않으므로 계정 실제 사용량과 구분합니다. 80% 경고, 100% 보호 제한. 취소/복원도 감사 기록을 남겨야 하므로 보호 제한 도달 시 중단될 수 있습니다. 한도 전에 백업과 보관 정책을 검토하세요.

가정 예시: 하루 10경기(10인)면 연 3,650경기, 2만 건까지 약 5.5년입니다. 원본 13.5MB 대신 정규화 통계와 감사 자료만 저장합니다. 초기 등록은 40회 이내의 D1 명령과 트리거 변경을 사용하며 수정은 추가 기록을 남깁니다. SQL 명령 수는 과금 행 수와 다릅니다. 실제 reads/writes와 CPU는 Cloudflare 대시보드에서 측정해야 합니다. CPU 10ms 충족은 운영 부하 측정 전에는 보장할 수 없습니다.

예를 들어 하루 20명이 각 30번 조회하면 약 600 API 조회(화면당 호출 수에 따라 증가), 정기 봇 작업은 최대 288회/일입니다. 외부 트래픽·기존 기능 호출·DB 공유 사용량은 별도입니다. 공개 조회 폭주에 대한 계정 전체 방어는 이 앱의 본문 보호 한도만으로 보장되지 않습니다. 한도 접근 시 조회 빈도 감소·기존 백업 정리·보관 정책 검토를 우선하고 자동 결제를 사용하지 마세요.

공식 근거: Workers limits · D1 pricing · D1 limits · Static assets billing

7. 롤백

우선 이전에 복사한 소스 폴더로 돌아가 npx wrangler deploy를 실행하세요. 새 테이블을 삭제하지 않아도 WEB 0.7은 기존 테이블만 사용하므로 기존 기능으로 돌아갈 수 있습니다. 0.8에서 기록한 새 통계는 DB에 남습니다.

DB 자체가 손상되었다면 쓰기를 중단하고 현재 DB도 별도로 export한 뒤, 배포 전 백업과 Cloudflare D1 Time Travel 복원 기능을 검토하세요(Free 보관 기간 7일). SQL 백업을 기존 DB에 무조건 덮어쓰거나 DROP으로 초기화하지 마세요. 전체 복원은 신규 DB에 백업을 가져와 내용을 검증한 뒤 바인딩을 바꾸는 절차가 안전합니다. 이 작업은 본 패치에서 자동 실행하지 않습니다.

8. 검증 및 남은 제약

기존 테스트와 새 테스트 총 28개 통과: 실제 ROFL 추출, 손상/크기 오류, 권한, 중복, 원자적 갱신과 취소/복원, 참가자 재연결 집계, 시즌 OFF·경계·중복 방지, 기존 데이터/칭호 보존, 정렬·검색·필터. 로컬 D1에서 마이그레이션 적용, 빌드 성공. 운영 계정 배포·백업·사용량·부하 검증은 수행하지 못했습니다.

브라우저 QA는 로컬 화면의 메뉴·조회·빈 상태를 확인했습니다. 로컬 미리보기에는 운영 로그인 세션이 없어 관리자 등록 전체 흐름과 모바일 실기기 검증은 제한됩니다. 원본 비전송은 파서/요청 코드와 서버 크기 제한으로 검증했으며 브라우저 네트워크 캡처에 의한 실증은 아직 하지 못했습니다. 실제 테스트는 배포 후 첫 경기 하나를 등록 → 중복 등록 거절 → 집계 제외 → 복원 순서로 확인하세요.

개인 프로필의 타인 명의 한줄평과 일반 사용자의 기존 결과 기록은 원래 공개 참여 방식입니다. 새 로그인/본인 인증을 만들거나 기존 권한을 넓히지 않았습니다. 리플레이 등록·수정·제외·시즌 관리는 기존 관리자 키를 서버에서 검사합니다.