docs: README, CLAUDE.md 작성

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

CLAUDE.md

@@ -1,33 +1,50 @@
 # CLAUDE.md
 
-This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
-
 ## Commands
 
 ```bash
-npm run dev       # Start dev server with HMR (hot module reloading)
-npm run build     # Production build to dist/
-npm run preview   # Preview production build locally
-npm run lint      # Run ESLint on all files
+npm run dev       # 개발 서버 (HMR)
+npm run build     # 프로덕션 빌드 → dist/
+npm run preview   # 빌드 결과 미리보기
+npm run lint      # ESLint
 ```
 
 ## Tech Stack
 
-- **React 19** with plain JavaScript (no TypeScript)
-- **Vite 7** as build tool (uses `@vitejs/plugin-react` with Babel/Fast Refresh)
-- **ESLint** with react-hooks and react-refresh plugins
+- **React 19** — plain JavaScript (no TypeScript)
+- **Vite 7** — `@vitejs/plugin-react` (Babel / Fast Refresh)
+- **React Router v7**
+- **ESLint** — flat config, `no-unused-vars` ignores `^[A-Z_]`
 
 ## Project Purpose
 
-Frontend for a **Unity 3D multiplayer game deployment**. Target users are testers who need to:
-- Access/log in to the game platform
-- Download the Unity game client
-- Launch and play the multiplayer game
+Unity 3D 멀티플레이어 게임 "One of the plans" 웹 플랫폼.
+유저 인증 → 게임 런처 다운로드 → `a301://` 프로토콜로 런처 실행.
 
 ## Project Structure
 
-Currently a minimal Vite + React starter. `src/main.jsx` is the entry point that mounts `src/App.jsx` to `#root`. No routing, state management libraries, or API layer are set up yet — these will be added as the project develops.
+```
+src/
+├── api/           # 백엔드 호출 (client.js: fetch 래퍼 + JWT + 401 처리)
+├── context/       # AuthContext — 3파일 분리 (react-refresh 규칙)
+│   ├── authContextValue.js
+│   ├── AuthContext.jsx
+│   └── useAuth.js
+├── pages/         # HomePage, LoginPage, RegisterPage, AdminPage
+└── components/
+    ├── DownloadSection.jsx   # a301:// URI 호출, 미설치 시 launcher.exe 다운로드
+    ├── AnnouncementBoard.jsx
+    └── admin/                # AnnouncementAdmin, DownloadAdmin, UserAdmin
+```
 
-## ESLint Config
+## Key Patterns
 
-Uses the new flat config format (`eslint.config.js`). The `no-unused-vars` rule ignores variables matching `^[A-Z_]` (uppercase constants are exempt).
+- `src/api/client.js` — 모든 API 호출은 이 래퍼를 통해 처리. 401 응답 시 자동으로 localStorage 토큰 삭제 후 `/login` 리다이렉트.
+- AuthContext는 `react-refresh` 린트 규칙(컴포넌트와 hook 혼재 금지) 때문에 3개 파일로 분리.
+- 환경변수 `VITE_API_BASE_URL` — 빌드 시 주입. 개발 시 빈 문자열(상대경로 사용).
+- 게임 이름 표기: **"One of the plans"** (기술 식별자 `a301`, `A301.exe` 등은 변경하지 않음)
+
+## API Base URL
+
+프론트엔드 nginx는 `/api/` 프록시 없음.
+런처·백엔드 직접 통신은 `https://a301.api.tolelom.xyz` 사용.