# Claude AI 마스터클래스 — 배포 가이드

> **대상 URL**: https://main.duonedu.net/edu-claude/
> **NAS 경로**: `/volume3/web/edu-claude/`
> **D-Day**: 2026년 5월 16일 (토) 09:00 ~ 13:00
> **장소**: 마스터마인드협회교육원 · 교육센터

---

## 1. 배포 전 체크리스트

### 1.1 파일 영역
- [x] `index.html` — 랜딩페이지 (10개 영역 Claude 강의용)
- [x] `slides.html` — 강의 슬라이드 (45장 · CH1~CH4 + 부록 2)
- [x] `admin.html` — 관리자 콘솔 (비번 `claude2026`)
- [x] `questions.html` — 질문 관리 (비번 `claude2026`)
- [x] `stats.php` — 통계 엔드포인트 (비번 `claude2026`)
- [x] `terms.html` · `privacy.html` — 약관·개인정보처리방침
- [x] `favicon.svg` · `og-image.svg` — Claude 오렌지 톤 브랜딩
- [x] `실습자료_프롬프트.md` — CH1~CH4 + 부록 프롬프트 마스터
- [x] `강의계획서.md` — 정본 (이미 작성됨)
- [x] `실습자료/` — Claude 실습용 4개 폴더 + README

### 1.2 PNG 이미지 ✅ 생성 완료
모든 파비콘·OG 이미지가 Claude 톤(#C96442)으로 생성되어 있습니다.

| 파일 | 사이즈 | 용도 |
|---|---:|---|
| `favicon-32.png` | 564 B | 브라우저 탭 |
| `favicon-256.png` | 4.4 KB | PWA·고해상도 |
| `apple-touch-icon.png` | 3.0 KB | iOS 홈 추가 |
| `og-image.png` | 48.6 KB | SNS 미리보기 (카카오톡·페이스북) |

> 💡 **재생성이 필요할 때**: 디자인 변경 시 `python build_images.py` (또는 PIL 스크립트) 실행.

### 1.3 localStorage 키 변경 확인
- ✅ `kimpo_visitor` → `claude_edu_visitor`
- ✅ `kimpo_theme` → `claude_edu_theme`
- ✅ `kimpoPinged` → `claudeEduPinged`
- ⚠️ `wkuAdminAuthed` (관리자 인증) — admin.html과 호환을 위해 유지

### 1.4 비밀번호 변경 확인
- ✅ index.html / admin.html / stats.php / questions.html / slides.html: `duon2026` → `claude2026`

---

## 2. NAS 배포 절차

### 2.1 SSH 접속 후 폴더 생성
```bash
ssh admin@nas.example.com
sudo mkdir -p /volume3/web/edu-claude
sudo chown -R http:http /volume3/web/edu-claude
```

### 2.2 파일 업로드 (rsync 또는 SFTP)
```bash
# 로컬 (Windows)에서
rsync -avz --exclude='.bkit' --exclude='.omc' --exclude='docs' \
  --exclude='실습자료/_archive_김포' \
  --exclude='실습자료_김포_archive.zip' \
  --exclude='강의PPT.md' --exclude='슬라이드기획서.md' \
  --exclude='슬라이드제작참고자료사이트.txt' \
  --exclude='build_pptx.py' \
  "I:/edu-claude/" admin@nas:/volume3/web/edu-claude/
```

배포 제외 항목:
- `.bkit/` `.omc/` — 개발 도구 메타데이터
- `docs/` — 개발 참고 문서 (김포 흔적 잔존)
- `실습자료/_archive_김포/` — 이전 강의 자료 백업
- `강의PPT.md`, `슬라이드기획서.md`, `build_pptx.py` — 이전 강의 PPT 빌드 자산

### 2.3 권한 설정
```bash
sudo chmod -R 755 /volume3/web/edu-claude
sudo chmod -R 775 /volume3/web/edu-claude/data  # PHP write 가능
sudo chown -R http:http /volume3/web/edu-claude
```

### 2.4 PNG 재생성 (위 1.2 참조)

---

## 3. 배포 후 테스트 체크리스트

### 3.1 입장 게이트
- [ ] https://main.duonedu.net/edu-claude/ 접속
- [ ] 입장 게이트 정상 표시 (소속·부서/팀·직급/역할·이름)
- [ ] 입력 후 메인 페이지 표시
- [ ] 로그아웃 → 게이트 다시 표시

### 3.2 관리자
- [ ] 입장 게이트에 `관리자/관리자/관리자/이신우` 입력 → 비밀번호 `claude2026` → 진입
- [ ] admin.html 직접 접근 → 비밀번호 입력 → 진입
- [ ] 노출 토글 6개 (커리큘럼·자료·도구·프롬프트·슬라이드·자료실) 정상 동작

### 3.3 콘텐츠
- [ ] 4챕터 카드 + 2부록 카드 정상 표시
- [ ] 도구 4종 (Claude / Projects / Artifacts / Console) 카드
- [ ] 프롬프트 6탭 (CH1~CH4 + FAQ + 추천 리소스) 정상 전환
- [ ] 복사 버튼 동작 (복사된 텍스트 정상)
- [ ] 자료실 (Anthropic Docs / Cookbook / Prompt Library / 한국어 커뮤니티)

### 3.4 슬라이드
- [ ] slides.html → 표지 / 목차 / 학습 목표 / CH1 디바이더 / CH1 콘텐츠
- [ ] 좌우 키보드 네비게이션
- [ ] F 키로 풀스크린, ESC로 종료
- [ ] 우측 ☰ 메뉴 → 45장 아웃라인
- [ ] 모바일 스와이프 동작

### 3.5 SEO/SNS
- [ ] OG 이미지 미리보기 (카카오톡 채팅창에 URL 붙여넣기)
- [ ] 페이스북 디버거 (developers.facebook.com/tools/debug/)
- [ ] 모바일 반응형 (iPhone, Android)

### 3.6 캐시 충돌 검증
- [ ] localStorage에 `claude_edu_visitor` 키 정상 저장
- [ ] 다른 강의 사이트(kim-po-ai-edu, lecture-booking 등)와 캐시 충돌 없음

---

## 4. D-Day 운영 가이드

### 4.1 강의 시작 전 (08:30)
- [ ] 노트북 + 빔프로젝터 연결
- [ ] 사이트 입장 게이트 확인
- [ ] 관리자 진입 → 모든 섹션 잠금 해제
- [ ] Claude.ai 로그인 (Pro 계정 데모용)
- [ ] 슬라이드 풀스크린 모드 진입

### 4.2 강의 중 (09:00~13:00)
- 50분 강의 → 10분 휴식 × 3회
- 휴식 시간에 질문 관리 패널 확인 → 답변
- 실습 시 강사 화면을 빔프로젝터로, 수강생은 본인 노트북

### 4.3 강의 종료 후
- [ ] 수강생 피드백 수집 (질문 모달의 익명 의견 활용)
- [ ] 통계 대시보드에서 방문자·국가·기기 데이터 확인
- [ ] 회고: docs/04-report/ (없으면 새로 만들기)

---

## 5. 트러블슈팅

| 증상 | 원인 | 해결 |
|---|---|---|
| 입장 게이트가 무한 반복 | localStorage 비활성화 | 시크릿 모드 해제 권장 |
| OG 이미지 미리보기 없음 | PNG 미생성 | 1.2 PNG 변환 수행 |
| 관리자 비번 불일치 | 캐시된 옛 비번 | localStorage 초기화 후 재시도 |
| 슬라이드 45/45 미표시 | 라인 1672 인디케이터 | "1 / 45" 확인 |
| 통계 저장 안 됨 | data/ 권한 부족 | `chmod 775 data` |

---

## 6. 강사 연락처

- 이신우 · 두온교육(주) · 미래이음연구소
- 📧 mintorain@gmail.com · 📞 010-3343-4000

---

*문서 작성: 2026-05-15 · 미래이음연구소*
