260706_1_계정, 로그인, 보안 초안 작성

CLAUDE.md

@@ -1,4 +1,37 @@
-# 프로젝트 행동지침 및 기술 스택 명세 (agent.md)
+# 프로젝트 행동지침 및 기술 스택 명세 (CLAUDE.md)
+
+---
+
+## 🚀 빠른 시작 (Quick Start - 항상 읽기!)
+
+### 웹앱 실행 (전체 스택)
+```bash
+# 1. 프로젝트 루트에서만 작업
+cd d:\02_Software_Prog\임도설계\ 및\ 견적자동화\ 프로그램\ 개발
+
+# 2. Python 가상환경 활성화
+.\venv\Scripts\activate
+
+# 3. 웹서버 실행 (백엔드 + 프론트엔드 동시 시작)
+python main.py
+
+# 브라우저: http://localhost:8000
+```
+
+### 중요 구조
+- **빌드 설정**: 루트(`package.json`, `tsconfig.json`, `vite.config.ts`) — 유일한 빌드 설정
+- **프론트엔드 소스**: `A00_Common/` (진입점), `A0*/`, `B0*/` (페이지들)
+- **프론트엔드 공유 자산**: `ui_template/`, `config/` (TypeScript 설정용)
+- **백엔드**: `main.py`, `common_util/`, `config/` (Python 설정)
+- **DB**: `db_management/` (마이그레이션 SQL)
+
+### 주의사항
+- ❌ `config/` 폴더에 빌드 설정 파일 두지 말 것 (루트만 사용)
+- ❌ `npm run build`는 프로젝트 루트에서만 실행
+- ✅ `python main.py`로 전체 스택 자동 시작 (프론트엔드 빌드 포함)
+- ✅ 코더 AI는 `.agent/CODER_HANDOFF.md` 참고
+
+---
 
 ## 프로젝트 & DB 정보