diff --git a/CLAUDE.md b/CLAUDE.md index eb09ccd..1199823 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -2,6 +2,31 @@ 해양 오염 사고 대응 방제 운영 지원 시스템. 유류/HNS 확산 예측, 역추적 분석, 구조 시나리오, 항공 방제, 자산 관리, SCAT 조사, 기상/해상 정보를 통합 제공한다. +## 🚨 절대 지침 (Absolute Rules) + +### 1. 신규 기능 설계/구현 전 develop 최신화 필수 + +신규 기능 설계나 구현을 시작하기 전, **반드시** 다음 절차를 사용자에게 권유하고 확인을 받을 것: + +1. `git fetch origin` 으로 원격 `develop` 최신 상태 확인 +2. `origin/develop`이 로컬 `develop`보다 앞서 있으면 → 로컬 `develop`을 최신화 (`git pull --ff-only` 또는 `git checkout -B develop origin/develop`) +3. 최신화된 `develop`에서 신규 브랜치 생성 (`git checkout -b /`) +4. 해당 브랜치에서 설계·구현 진행 + +> **이유**: 구 버전 develop 기반으로 작업 시 머지 충돌·중복 구현·사라진 코드 복원 등 위험. 최신 base에서 시작해야 MR 리뷰·릴리즈 흐름이 안전. + +### 2. 프론트엔드 구성 시 디자인 시스템 준수 필수 + +모든 프론트엔드 UI 구현은 **반드시** [docs/DESIGN-SYSTEM.md](docs/DESIGN-SYSTEM.md) 규칙을 준수할 것: + +- 시맨틱 토큰(`--bg-base`, `--fg-default`, `--color-accent` 등) 사용 — 축약형/하드코딩 금지 +- 폰트: `PretendardGOV` 단일 폰트 (4웨이트). `var(--font-korean)`, `var(--font-mono)` 경유 +- 다크/라이트 테마 전환 지원 (`data-theme` 속성 기반) +- Tailwind 컬러 키는 CSS 변수 참조 (`bg.base`, `fg.DEFAULT`, `color.accent`) +- 폰트 크기 토큰: `text-caption/body-2/body-1/title-4...` — 인라인 `fontSize` 금지 + +> **이유**: 디자인 일관성·테마 전환·접근성(대비) 확보. 토큰 외 값은 리팩토링 비용을 증가시킴. + - **타입**: react-ts 모노레포 (frontend + backend) - **Frontend**: React 19 + Vite 7 + TypeScript 5.9 + Tailwind CSS 3 - **Backend**: Express 4 + PostgreSQL (pg) + TypeScript