# AICHAT34 프로젝트 인수인계

## 복구 기준과 범위
- 복구 기준: aichat31 Pages immutable deployment `56195235` (2026-10-01, 앱 31.10 / CSS 31.5).
- 2026-10-04 로컬 aichat31의 `index.html`, `app.js`, `index.css`, `cgame2.js`가 기준 배포 파일과 바이트 단위로 일치하는 것을 확인했습니다.
- A34는 확인된 기준 파일을 복제해 경로·브라우저 저장 키·세션 쿠키·브랜딩을 A34 전용으로 바꾼 독립 복구본입니다. A31과 A33의 파일 및 배포는 변경하지 않았습니다.

## 배포 및 Cloudflare 자원
- 앱: `https://hr.pe.kr/aichat34/`
- 이어서 작업 안내: `https://hr.pe.kr/aichat34/project/`
- Pages project: `aichat34-hr-pe-kr`
- 최근 Pages 운영 배포: `075b95bc-e067-4167-bf0a-7ad806d10caa` (`https://075b95bc.aichat34-hr-pe-kr.pages.dev`)
- 검수 Preview: `3e558ec4-3d40-4b1e-813b-710f49ca5b1a` (`https://3e558ec4.aichat34-hr-pe-kr.pages.dev`)
- Worker: 전용 `aichat34-api`, version `be6809fa-f618-4966-8f40-1090b03e28a6`; 라우트는 `hr.pe.kr/aichat34`와 `/aichat34/*`만 처리합니다. 공유 Worker `hr-z-posts-proxy`는 건드리지 않았습니다.
- D1: `aichat34-db` / `AICHAT34_DB`, database id `91719cf5-36f5-459e-906b-57a8dd9f62d2`; migrations 0001–0008 적용.
- DB에는 공개 카탈로그 시드(Studio2 7개, custom games 10개)만 있습니다. 사용자·세션·크레딧·대화 테이블에는 복사/테스트 계정이 없습니다. A31 계정·잔액·결제·대화·개인 게임 데이터는 복사하지 않았습니다.

## 프로젝트 탐색과 인수인계
- 앱 상단 `프로젝트·소스` 링크 또는 `/project/`에서 README, 소스 파일, 변경 기록과 다운로드를 확인할 수 있습니다.
- 프런트엔드 및 마이그레이션 ZIP과 이미지 자산 ZIP을 제공합니다. 클라이언트 소스와 공개 카탈로그 마이그레이션은 공개 코드입니다.
- Worker 원본은 공개 다운로드에 포함하지 않았습니다. Cloudflare Worker Secrets 목록에도 키가 없습니다. 다음 작업자가 백엔드를 수정하려면 권한이 있는 별도 비공개 작업 사본이 필요합니다.
- Pages에 올린 정적 자산만으로 전체 운영 인프라를 복원할 수는 없습니다. Cloudflare 인증, 전용 Worker 코드, D1 접근은 권한 있는 운영 환경에서 이어받아야 합니다.

## 미완료 운영 설정
- `OPENROUTER_API_KEY`는 비밀값이라 기존 Worker에서 읽거나 복제할 수 없습니다. A34 Worker에는 아직 설정되지 않았습니다. 따라서 AI 기획/채팅 등 키 의존 기능은 실패할 수 있으며, AI 작업 전에 권한 있는 운영자가 Cloudflare Worker Secret으로 설정해야 합니다. 키를 대화·문서·ZIP에 붙이지 마세요.
- 결제 제공자 자격증명도 설정하지 않았습니다. 결제 흐름은 별도 점검 후 활성화하세요.

## 다음 작업 순서
1. 최신 immutable Preview와 이 문서의 상태를 먼저 확인합니다. 여러 컴퓨터가 동시에 수정/배포하지 않도록 합니다.
2. `AGENTS.md`를 읽고 A34 사본만 수정합니다. A31/A33 및 공유 Worker에는 배포하지 않습니다.
3. `wrangler pages deploy site --project-name aichat34-hr-pe-kr --branch <preview-branch>`로 미리보기 후, 앱/파일 다운로드/API JSON 응답과 Worker 동작을 확인합니다. 인증 없는 쓰기 요청은 401이어야 합니다.
4. 운영 반영은 검수한 A34 버전만 올리고, 새 Pages/Worker 배포 ID와 검증 결과를 `CHANGELOG.md`와 이 문서에 적습니다.

