docs: README/docs 재정리 — 프로젝트 개요·사용방법 정리

- README.md 를 개발 명세에서 프로젝트 개요/구성/빠른 시작 형식으로 재작성
- docs/installer.md (음악퀴즈 간편설치기 단계별 사용 가이드) 신설
- docs/admin-site.md (관리 사이트 운영자 가이드) 신설
- docs/resourcepack-installer.md (리소스팩 간편설치기 동작 명세) 신설
- 중복된 docs/add.md 제거 (resourcepack-installer.md 로 이전)

docs/resourcepack-installer.md

@@ -0,0 +1,69 @@
+# 리소스팩 간편설치기
+
+음악퀴즈에 등록된 음악·사진 목록을 yt-dlp 로 받아 마인크래프트 1.21+ painting variant 텍스처 리소스팩으로 패키징하는 별도 설치기입니다.
+
+기본 골격은 음악퀴즈 간편설치기(`src/installer/`)와 동일하므로 UI/스토어 코드를 공유합니다. 진입점은 `src/installer-rp/main.ts` + `installer-rp/` 렌더러.
+
+## 실행
+
+```bash
+npm run installer:rp        # 개발 실행
+```
+
+윈도우 `.exe` 패키징은 `tsconfig.installer-rp.json` 으로 컴파일한 뒤 `electron-builder` 로 수동 패키징합니다.
+
+## 단계
+
+번호가 붙은 단계는 "이전 / 다음" 으로 이동 가능합니다.
+
+### 1) 음악퀴즈 선택
+
+- 도메인의 `manifest.json` 에서 음악퀴즈 카드 목록을 표시.
+- 선택한 음악퀴즈의 `file/list/<key>.json` 에서 다음을 로드:
+  - 음악 목록(유튜브 영상 주소).
+  - 사진 목록(유튜브 주소 또는 일반 이미지 주소).
+
+### 2) 리소스팩 설치 (자동 시작)
+
+- "다음" 누르면 즉시 시작.
+- 설치 로그를 실시간으로 표시(곡 제목 노출 없이 `n번 노래 다운로드 중…` 형식).
+- 취소 버튼 / 창 닫기 / 강제 종료 시: 진행 중 다운로드를 안전하게 중단하고 임시 파일을 정리한 뒤 정상 종료.
+
+#### 2-1. yt-dlp 준비
+
+- 자동 설치 위치: `%APPDATA%/.mc_custom/` (Linux `~/.config/.mc_custom/`, macOS `~/Library/Application Support/.mc_custom/`).
+- 이미 있으면 업데이트 확인 후 그대로 사용.
+- 시스템 `PATH` 에 `yt-dlp` 가 있으면 그것을 우선 사용 후 업데이트 확인.
+- 자동 설치가 실패하는 환경은 [`yt-dlp-setup.md`](yt-dlp-setup.md) 참고.
+
+#### 2-2. 음악 다운로드 (순차)
+
+- 임시 경로: `%APPDATA%/.mc_custom/.temp/`.
+- 각 곡을 `ogg` 로 변환(Minecraft 사운드 호환 포맷). ffmpeg 필요.
+- 중단되거나 모두 끝나면 `.temp` 내용 삭제.
+
+#### 2-3. 사진 다운로드 → painting variant 텍스처
+
+이미지는 두 형태로 들어옵니다.
+
+- **유튜브 주소** — yt-dlp 가 알려준 영상 ID 로 `https://i.ytimg.com/vi/<id>/maxresdefault.jpg` 1차 시도, 실패하면 `hqdefault.jpg` 폴백.
+- **일반 이미지 주소** — HTTP GET 으로 그대로.
+
+정규화 규칙:
+
+- **슬롯 규격(고정, 데이터팩 측)**: `4 × 4` 블록 정사각, `cover_01 … cover_N`.
+- **최종 PNG 규격(리소스팩 측)**: 정사각 1:1, 최대 `1024 × 1024` px.
+  - `4 × 4` 블록 × 블록당 `256` px (×16 배율) → 1024×1024 가 픽셀 그리드와 정확히 일치.
+- **알고리즘**:
+  1. 가운데 정사각 크롭: `s = min(원본 가로, 원본 세로)` → `s × s`.
+  2. `s > 1024` 이면 `1024 × 1024` 로 축소 (Lanczos 권장).
+  3. `s ≤ 1024` 이면 그대로 `s × s` 유지(업스케일 없음).
+- 파일명: `cover_<NN>.png` (`NN` 은 2자리 0패딩).
+- 저장 경로: `resourcepack/assets/musicquiz/textures/painting/`.
+- 패키지 완성된 리소스팩을 `%APPDATA%/.minecraft/resourcepacks/` 에 zip 으로 배치.
+
+painting variant 의 슬롯·태그 구조와 게임 내 호출 예시는 [`painting-variant.md`](painting-variant.md) 참고.
+
+### 3) 설치 완료
+
+- "확인" 누르면 프로그램 종료.