docs: 배포 문서 보강 + CI/CD 모노레포 수정 + CLAUDE.md 배포 섹션

deploy/README.md: - 접속 정보 섹션 추가 (URL, 데모 계정, DB) - CI/CD 섹션: 프론트 자동(Gitea Actions), 백엔드/prediction 수동 - 서버별 실행 경로 정리 (rocky-211, redis-211) .gitea/workflows/deploy.yml: - 모노레포 구조 반영 (working-directory: frontend) - paths 필터: frontend/** 변경 시만 트리거 CLAUDE.md: - 모노레포 구조에 prediction/, deploy/, .gitea/ 추가 - 배포 환경 섹션 추가 (서버/포트/관리 방법) Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-04-07 13:43:19 +09:00 · 2026-04-07 13:43:19 +09:00 · 3ced9ffaaa
--- a/.gitea/workflows/deploy.yml
+++ b/.gitea/workflows/deploy.yml
@ -1,9 +1,11 @@
-name: Build and Deploy KCG AI Monitoring
+name: Build and Deploy KCG AI Monitoring (Frontend)

 on:
  push:
    branches:
      - main
+    paths:
+      - 'frontend/**'

 jobs:
  build-and-deploy:
@ -18,20 +20,23 @@ jobs:
          node-version: '24'

      - name: Configure npm registry
+        working-directory: frontend
        run: |
          echo "registry=https://nexus.gc-si.dev/repository/npm-public/" > .npmrc
          echo "//nexus.gc-si.dev/repository/npm-public/:_auth=${{ secrets.NEXUS_NPM_AUTH }}" >> .npmrc

      - name: Install dependencies
+        working-directory: frontend
        run: npm ci --legacy-peer-deps

      - name: Build
+        working-directory: frontend
        run: npm run build

      - name: Deploy to server
        run: |
          mkdir -p /deploy/kcg-ai-monitoring
          rm -rf /deploy/kcg-ai-monitoring/*
-          cp -r dist/* /deploy/kcg-ai-monitoring/
-          echo "Deployed at $(date '+%Y-%m-%d %H:%M:%S')"
+          cp -r frontend/dist/* /deploy/kcg-ai-monitoring/
+          echo "Frontend deployed at $(date '+%Y-%m-%d %H:%M:%S')"
          ls -la /deploy/kcg-ai-monitoring/
--- a/CLAUDE.md
+++ b/CLAUDE.md
@ -7,12 +7,15 @@
 ```
 kcg-ai-monitoring/
 ├── frontend/        # React 19 + TypeScript + Vite (UI)
-├── backend/         # Spring Boot 3.x + Java 21 (자체 인증/권한/감사 + 분석 프록시)
-├── database/        # PostgreSQL 마이그레이션 (Flyway)
+├── backend/         # Spring Boot 3.x + Java 21 (인증/권한/감사 + 분석 API)
+├── prediction/      # Python 3.9 + FastAPI (AIS 분석 엔진, 5분 주기)
+├── database/        # PostgreSQL 마이그레이션 (Flyway V001~V013)
 │   └── migration/
+├── deploy/          # 배포 가이드 + 서버 설정 문서
 ├── docs/            # 프로젝트 문서 (SFR, 아키텍처)
+├── .gitea/          # Gitea Actions CI/CD (프론트 자동배포)
 ├── .claude/         # Claude Code 워크플로우
-├── .githooks/       # Git hooks (commit-msg, pre-commit, post-checkout)
+├── .githooks/       # Git hooks
 └── Makefile         # 통합 dev/build 명령
 ```

@ -75,6 +78,18 @@ make format           # 프론트 prettier
 - 사용자: `kcg-app`
 - 스키마: `kcg`

+## 배포 환경
+
+| 서비스 | 서버 (SSH) | 포트 | 관리 |
+|---|---|---|---|
+| 프론트엔드 | rocky-211 | nginx 443 | Gitea Actions 자동배포 |
+| 백엔드 | rocky-211 | 18080 | `systemctl restart kcg-ai-backend` |
+| prediction | redis-211 | 18092 | `systemctl restart kcg-ai-prediction` |
+
+- **URL**: https://kcg-ai-monitoring.gc-si.dev
+- **배포 상세**: `deploy/README.md` 참조
+- **CI/CD**: `.gitea/workflows/deploy.yml` (프론트만 자동, 백엔드/prediction 수동)
+
 ## 권한 체계

 좌측 탭(메뉴) = 권한 그룹, 내부 패널/액션 = 자식 자원, CRUD 단위 개별 제어.
--- a/deploy/README.md
+++ b/deploy/README.md
@ -1,11 +1,21 @@
 # 배포 가이드

+## 접속 정보
+
+| 항목 | URL / 경로 |
+|---|---|
+| **프론트엔드** | https://kcg-ai-monitoring.gc-si.dev |
+| **백엔드 API** | https://kcg-ai-monitoring.gc-si.dev/api/* |
+| **prediction API** | https://kcg-ai-monitoring.gc-si.dev/api/prediction/* |
+| **데모 로그인** | admin / admin1234! (또는 DemoQuickLogin) |
+| **DB** | `psql -h 211.208.115.83 -U kcg-app -d kcgaidb` (pw: Kcg2026ai) |
+
 ## 서버 구성

-| 서버 | 호스트 | 역할 | 포트 |
-|---|---|---|---|
-| rocky-211 | 211.208.115.83 (ssh rocky-211) | 프론트엔드 + 백엔드 + nginx | 443(nginx), 18080(backend) |
-| redis-211 | 192.168.1.18 (ssh redis-211) | prediction 분석 + Redis + Ollama | 18092(prediction), 8001(기존), 6379(redis) |
+| 서버 | SSH | IP | 역할 | 포트 |
+|---|---|---|---|---|
+| rocky-211 | `ssh rocky-211` | 211.208.115.83 | 프론트 + 백엔드 + nginx | 443, 18080 |
+| redis-211 | `ssh redis-211` | 192.168.1.18 | prediction + Redis + Ollama | 18092, 6379, 11434 |

 ## 서비스 목록

@ -161,3 +171,60 @@ PGPASSWORD='Kcg2026ai' psql -h 211.208.115.83 -U kcg-app -d kcgaidb
 | 5432 | PostgreSQL (kcgaidb, snpdb) | 211.208.115.83 |
 | 6379 | Redis | redis-211 |
 | 11434 | Ollama | redis-211 |
+
+## CI/CD
+
+### 프론트엔드 — Gitea Actions 자동배포
+- 워크플로우: `.gitea/workflows/deploy.yml`
+- 트리거: `main` 브랜치 push, `frontend/**` 변경 시
+- 빌드: Node.js 24, `frontend/` 디렉토리에서 `npm ci && npm run build`
+- 배포: `frontend/dist/` → `/deploy/kcg-ai-monitoring/` (Gitea runner mount)
+- Gitea runner가 rocky-211에서 실행 중이므로 dist가 자동 배포됨
+
+### 백엔드 — SSH 수동배포
+```bash
+# 1. 로컬 빌드
+cd backend && ./mvnw clean package -DskipTests
+
+# 2. 서버 전송
+scp target/kcg-ai-backend-0.0.1-SNAPSHOT.jar \
+  rocky-211:/devdata/services/kcg-ai-monitoring/backend/kcg-ai-backend.jar
+
+# 3. 재시작
+ssh rocky-211 "systemctl restart kcg-ai-backend"
+```
+
+### prediction — SSH 수동배포
+```bash
+# 1. 파일 동기화
+rsync -avz --exclude='.venv' --exclude='__pycache__' --exclude='.env' --exclude='*.pyc' \
+  prediction/ redis-211:/home/apps/kcg-ai-prediction/
+
+# 2. 의존성 변경 시
+ssh redis-211 "cd /home/apps/kcg-ai-prediction && source venv/bin/activate && pip install -r requirements.txt"
+
+# 3. 재시작
+ssh redis-211 "systemctl restart kcg-ai-prediction"
+```
+
+## 서버 실행 경로 정리
+
+### rocky-211 (211.208.115.83)
+| 경로 | 용도 |
+|---|---|
+| `/devdata/services/kcg-ai-monitoring/dist/` | 프론트 빌드 산출물 (nginx root) |
+| `/devdata/services/kcg-ai-monitoring/backend/kcg-ai-backend.jar` | 백엔드 실행 JAR |
+| `/devdata/services/kcg-ai-monitoring/backend/application-prod.yml` | 백엔드 운영 설정 |
+| `/etc/nginx/conf.d/kcg-ai-monitoring.conf` | nginx 프록시 설정 |
+| `/etc/systemd/system/kcg-ai-backend.service` | 백엔드 systemd 서비스 |
+| `/usr/lib/jvm/java-21-openjdk/bin/java` | Java 21 실행 경로 |
+
+### redis-211 (192.168.1.18)
+| 경로 | 용도 |
+|---|---|
+| `/home/apps/kcg-ai-prediction/` | prediction 앱 디렉토리 |
+| `/home/apps/kcg-ai-prediction/.env` | prediction 환경변수 |
+| `/home/apps/kcg-ai-prediction/venv/` | Python 3.9 가상환경 |
+| `/etc/systemd/system/kcg-ai-prediction.service` | prediction systemd 서비스 |
+| `/home/apps/kcg-prediction/` | 기존 iran prediction (포트 8001) |
+| `/home/apps/kcg-prediction-lab/` | 기존 lab prediction (포트 18091) |