From 597e0da2e37c2c84624ad56412d8d0273d620eef Mon Sep 17 00:00:00 2001
From: htlee <htlee@gcsc.co.kr>
Date: Fri, 27 Feb 2026 16:42:37 +0900
Subject: [PATCH] =?UTF-8?q?chore:=20=ED=8C=80=20=EC=9B=8C=ED=81=AC?=
 =?UTF-8?q?=ED=94=8C=EB=A1=9C=EC=9A=B0=20=EC=8A=A4=ED=81=AC=EB=A6=BD?=
 =?UTF-8?q?=ED=8A=B8=20=EB=B0=8F=20=ED=94=84=EB=A1=9C=EC=A0=9D=ED=8A=B8=20?=
 =?UTF-8?q?=EB=AC=B8=EC=84=9C=20=EC=B6=94=EA=B0=80?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
---
 .claude/scripts/on-commit.sh       | 14 +++++
 .claude/scripts/on-post-compact.sh | 23 +++++++
 .claude/scripts/on-pre-compact.sh  |  8 +++
 .claude/settings.json              | 37 ++++++++++++
 .claude/workflow-version.json      |  6 ++
 CLAUDE.md                          | 96 ++++++++++++++++++++++++++++++
 6 files changed, 184 insertions(+)
 create mode 100755 .claude/scripts/on-commit.sh
 create mode 100755 .claude/scripts/on-post-compact.sh
 create mode 100755 .claude/scripts/on-pre-compact.sh
 create mode 100644 .claude/workflow-version.json
 create mode 100644 CLAUDE.md

diff --git a/.claude/scripts/on-commit.sh b/.claude/scripts/on-commit.sh
new file mode 100755
index 0000000..f473403
--- /dev/null
+++ b/.claude/scripts/on-commit.sh
@@ -0,0 +1,14 @@
+#!/bin/bash
+INPUT=$(cat)
+COMMAND=$(echo "$INPUT" | python3 -c "import sys,json;print(json.load(sys.stdin).get('tool_input',{}).get('command',''))" 2>/dev/null || echo "")
+if echo "$COMMAND" | grep -qE 'git commit'; then
+  cat <<RESP
+{
+  "hookSpecificOutput": {
+    "additionalContext": "커밋이 감지되었습니다. 다음을 수행하세요:\n1. docs/CHANGELOG.md에 변경 내역 추가\n2. memory/project-snapshot.md에서 변경된 부분 업데이트\n3. memory/project-history.md에 이번 변경사항 추가\n4. API 인터페이스 변경 시 memory/api-types.md 갱신\n5. 프로젝트에 lint 설정이 있다면 lint 결과를 확인하고 문제를 수정"
+  }
+}
+RESP
+else
+  echo '{}'
+fi
diff --git a/.claude/scripts/on-post-compact.sh b/.claude/scripts/on-post-compact.sh
new file mode 100755
index 0000000..c61d5a0
--- /dev/null
+++ b/.claude/scripts/on-post-compact.sh
@@ -0,0 +1,23 @@
+#!/bin/bash
+INPUT=$(cat)
+CWD=$(echo "$INPUT" | python3 -c "import sys,json;print(json.load(sys.stdin).get('cwd',''))" 2>/dev/null || echo "")
+if [ -z "$CWD" ]; then
+  CWD=$(pwd)
+fi
+PROJECT_HASH=$(echo "$CWD" | sed 's|/|-|g')
+MEMORY_DIR="$HOME/.claude/projects/$PROJECT_HASH/memory"
+CONTEXT=""
+if [ -f "$MEMORY_DIR/MEMORY.md" ]; then
+  SUMMARY=$(head -100 "$MEMORY_DIR/MEMORY.md" | python3 -c "import sys;print(sys.stdin.read().replace('\\\\','\\\\\\\\').replace('\"','\\\\\"').replace('\n','\\\\n'))" 2>/dev/null)
+  CONTEXT="컨텍스트가 압축되었습니다.\\n\\n[세션 요약]\\n${SUMMARY}"
+fi
+if [ -f "$MEMORY_DIR/project-snapshot.md" ]; then
+  SNAP=$(head -50 "$MEMORY_DIR/project-snapshot.md" | python3 -c "import sys;print(sys.stdin.read().replace('\\\\','\\\\\\\\').replace('\"','\\\\\"').replace('\n','\\\\n'))" 2>/dev/null)
+  CONTEXT="${CONTEXT}\\n\\n[프로젝트 최신 상태]\\n${SNAP}"
+fi
+if [ -n "$CONTEXT" ]; then
+  CONTEXT="${CONTEXT}\\n\\n위 내용을 참고하여 작업을 이어가세요. 상세 내용은 memory/ 디렉토리의 각 파일을 참조하세요."
+  echo "{\"hookSpecificOutput\":{\"additionalContext\":\"${CONTEXT}\"}}"
+else
+  echo "{\"hookSpecificOutput\":{\"additionalContext\":\"컨텍스트가 압축되었습니다. memory 파일이 없으므로 사용자에게 이전 작업 내용을 확인하세요.\"}}"
+fi
diff --git a/.claude/scripts/on-pre-compact.sh b/.claude/scripts/on-pre-compact.sh
new file mode 100755
index 0000000..3f52f09
--- /dev/null
+++ b/.claude/scripts/on-pre-compact.sh
@@ -0,0 +1,8 @@
+#!/bin/bash
+# PreCompact hook: systemMessage만 지원 (hookSpecificOutput 사용 불가)
+INPUT=$(cat)
+cat <<RESP
+{
+  "systemMessage": "컨텍스트 압축이 시작됩니다. 반드시 다음을 수행하세요:\n\n1. memory/MEMORY.md - 핵심 작업 상태 갱신 (200줄 이내)\n2. memory/project-snapshot.md - 변경된 패키지/타입 정보 업데이트\n3. memory/project-history.md - 이번 세션 변경사항 추가\n4. memory/api-types.md - API 인터페이스 변경이 있었다면 갱신\n5. 미완료 작업이 있다면 TodoWrite에 남기고 memory에도 기록"
+}
+RESP
diff --git a/.claude/settings.json b/.claude/settings.json
index 03c2889..b13b469 100644
--- a/.claude/settings.json
+++ b/.claude/settings.json
@@ -43,5 +43,42 @@
       "Read(./**/.env.*)",
       "Read(./**/secrets/**)"
     ]
+  },
+  "hooks": {
+    "SessionStart": [
+      {
+        "matcher": "compact",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "bash .claude/scripts/on-post-compact.sh",
+            "timeout": 10
+          }
+        ]
+      }
+    ],
+    "PreCompact": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "bash .claude/scripts/on-pre-compact.sh",
+            "timeout": 30
+          }
+        ]
+      }
+    ],
+    "PostToolUse": [
+      {
+        "matcher": "Bash",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "bash .claude/scripts/on-commit.sh",
+            "timeout": 15
+          }
+        ]
+      }
+    ]
   }
 }
diff --git a/.claude/workflow-version.json b/.claude/workflow-version.json
new file mode 100644
index 0000000..77a685f
--- /dev/null
+++ b/.claude/workflow-version.json
@@ -0,0 +1,6 @@
+{
+  "applied_global_version": "1.3.0",
+  "applied_date": "2026-02-27",
+  "project_type": "react-ts",
+  "gitea_url": "https://gitea.gc-si.dev"
+}
diff --git a/CLAUDE.md b/CLAUDE.md
new file mode 100644
index 0000000..a9bcc80
--- /dev/null
+++ b/CLAUDE.md
@@ -0,0 +1,96 @@
+# WING-OPS (해양 방제 운영 지원 시스템)
+
+## 프로젝트 개요
+해양 오염 사고 대응을 위한 방제 운영 지원 시스템.
+유류/HNS 확산 예측, 역추적 분석, 구조 시나리오, 항공 방제, 자산 관리, SCAT 조사, 기상/해상 정보를 통합 제공한다.
+
+- **프로젝트 타입**: react-ts (모노레포)
+- **Frontend**: React 19 + Vite 7 + TypeScript 5.9 + Tailwind CSS 3
+- **Backend**: Express 4 + better-sqlite3 + TypeScript
+- **상태관리**: Zustand (클라이언트), TanStack Query (서버)
+- **지도**: Leaflet, OpenLayers
+- **실시간**: Socket.IO
+
+## 빌드/실행
+
+### Frontend
+```bash
+cd frontend
+npm install
+npm run dev       # 개발 서버 (Vite, localhost:5173)
+npm run build     # 프로덕션 빌드 (tsc -b && vite build)
+npm run lint      # ESLint 검증
+npm run preview   # 빌드 미리보기
+```
+
+### Backend
+```bash
+cd backend
+npm install
+npm run dev       # 개발 서버 (tsx watch, localhost:3001)
+npm run build     # TypeScript 컴파일 (tsc)
+npm start         # 프로덕션 실행
+npm run db:seed   # DB 초기 데이터
+```
+
+### Docker
+```bash
+docker-compose up -d   # PostgreSQL 16 + PostGIS + pgAdmin
+```
+
+## 테스트
+테스트 프레임워크 미구성. 향후 Vitest + React Testing Library 도입 예정.
+
+## Lint/Format
+```bash
+cd frontend && npx eslint .          # ESLint (flat config)
+npx prettier --check .               # Prettier 검증
+npx prettier --write .               # Prettier 자동 수정
+```
+
+## 프로젝트 구조
+```
+wing/
+├── frontend/               React 19 + Vite + TypeScript + Tailwind
+│   └── src/
+│       ├── App.tsx          메인 (MainTab 라우팅, 11개 탭)
+│       ├── components/      UI 컴포넌트 (13개 서브디렉토리)
+│       │   ├── analysis/    HNS/Oil/Rescue 분석 시나리오
+│       │   ├── board/       게시판
+│       │   ├── incidents/   사건/사고 관리
+│       │   ├── layer/       레이어 트리
+│       │   ├── layout/      MainLayout, TopBar, LeftPanel, RightPanel
+│       │   ├── map/         MapView, BacktrackReplay
+│       │   ├── reports/     보고서
+│       │   ├── views/       각 탭별 페이지 뷰
+│       │   └── weather/     해양/기상 시각화
+│       ├── hooks/           커스텀 훅 (useLayers, useOceanForecast 등)
+│       ├── services/        API 서비스 (api, khoaApi, weatherApi 등)
+│       ├── store/           Zustand 상태관리
+│       ├── types/           타입 정의
+│       └── utils/           유틸리티 (coordinates, geo, sanitize)
+├── backend/                Express + better-sqlite3
+│   └── src/
+│       ├── server.ts        Express 진입점
+│       ├── routes/          layers, simulation
+│       ├── middleware/      security (입력 살균, rate-limit)
+│       └── db/              database, seed
+├── database/               SQL 초기화 스크립트
+├── docs/                   문서
+├── .claude/                팀 워크플로우 (rules, skills, scripts)
+├── .githooks/              Git hooks (pre-commit, commit-msg, post-checkout)
+└── docker-compose.yml      PostgreSQL + PostGIS + pgAdmin
+```
+
+## 팀 컨벤션
+`.claude/rules/` 디렉토리 참조:
+- `team-policy.md` — 보안/품질 정책
+- `git-workflow.md` — 브랜치/커밋/MR 규칙
+- `code-style.md` — TypeScript/React 코드 스타일
+- `naming.md` — 네이밍 규칙
+- `testing.md` — 테스트 규칙
+
+## 환경 설정
+- Node.js 20 (`.node-version`, fnm 사용)
+- npm registry: Nexus proxy (`.npmrc`)
+- Git hooks: `.githooks/` (core.hooksPath 설정됨)