sync: update from workspace (latest ITSM/CICD/DR changes)

2026-06-01 19:59:43 +09:00 · 2026-06-01 19:59:43 +09:00 · 07d1088f06
commit 07d1088f06
parent 7f313b4e55
2 changed files with 164 additions and 0 deletions
--- a/43_레파지토리_구조_가이드.md
+++ b/43_레파지토리_구조_가이드.md
@ -0,0 +1,126 @@
+# GUARDiA 레파지토리 구조 가이드
+
+> **분리 완료일**: 2026-05-31  
+> **이전 구조**: C:\GUARDiA 모노레포  
+> **현재 구조**: 5개 독립 Gitea 저장소
+
+---
+
+## 1. 저장소 구조
+
+### 독립 저장소 목록
+
+| 저장소 | Gitea URL | 로컬 경로 | 서버 경로 |
+|--------|----------|---------|---------|
+| `zio/zioinfo-web` | http://101.79.17.164:3000/zio/zioinfo-web | `C:\GUARDiA\repos\zioinfo-web\` | `/opt/zioinfo/src/` |
+| `zio/guardia-itsm` | http://101.79.17.164:3000/zio/guardia-itsm | `C:\GUARDiA\repos\guardia-itsm\` | `/opt/guardia/app/` |
+| `zio/guardia-manager` | http://101.79.17.164:3000/zio/guardia-manager | `C:\GUARDiA\repos\guardia-manager\` | `/opt/manager/` |
+| `zio/guardia-messenger` | http://101.79.17.164:3000/zio/guardia-messenger | `C:\GUARDiA\repos\guardia-messenger\` | EAS Build |
+| `zio/guardia-docs` | http://101.79.17.164:3000/zio/guardia-docs | `C:\GUARDiA\repos\guardia-docs\` | `/var/www/docs/` |
+
+### 모노레포 (참조용, Claude Code 작업)
+
+```
+C:\GUARDiA\          ← 원본 모노레포 (GitHub 제거됨)
+├── workspace/zioinfo-web/   ← 홈페이지 소스 (모노레포 내)
+├── itsm/                    ← ITSM 소스 (모노레포 내)
+├── manager/                 ← Manager 소스 (모노레포 내)
+├── app/                     ← Messenger 소스 (모노레포 내)
+├── manual/                  ← 매뉴얼 (guardia-docs repo로 분리됨)
+└── repos/                   ← 독립 저장소 디렉토리 (.gitignore 처리)
+    ├── zioinfo-web\
+    ├── guardia-itsm\
+    ├── guardia-manager\
+    ├── guardia-messenger\
+    └── guardia-docs\
+```
+
+---
+
+## 2. 개발 워크플로우
+
+### 기능 개발 (모노레포 기준)
+
+```bash
+# 1. 모노레포에서 기능 개발
+cd C:\GUARDiA
+# 소스 수정 후 커밋
+git add workspace/zioinfo-web/...
+git commit -m "feat: ..."
+
+# 2. 해당 독립 repo에 push
+cd C:\GUARDiA\repos\zioinfo-web
+git pull origin main   # 최신화 (다른 개발자 변경사항)
+# 또는 모노레포에서 subtree push
+cd C:\GUARDiA
+git subtree push --prefix=workspace/zioinfo-web \
+  http://zio:Zio%40Admin2026%21@101.79.17.164:3000/zio/zioinfo-web.git main
+```
+
+### CI/CD 자동 배포
+
+```
+git push origin main (각 독립 repo에서)
+    ↓
+Gitea webhook → http://localhost:9999
+    ↓
+deploy_server.py
+    ↓
+각 시스템 자동 빌드 + 배포
+```
+
+---
+
+## 3. 각 저장소 clone 방법
+
+```bash
+# 홈페이지
+git clone http://zio:Zio%40Admin2026%21@101.79.17.164:3000/zio/zioinfo-web.git
+
+# GUARDiA ITSM
+git clone http://zio:Zio%40Admin2026%21@101.79.17.164:3000/zio/guardia-itsm.git
+
+# GUARDiA Manager
+git clone http://zio:Zio%40Admin2026%21@101.79.17.164:3000/zio/guardia-manager.git
+
+# GUARDiA Messenger
+git clone http://zio:Zio%40Admin2026%21@101.79.17.164:3000/zio/guardia-messenger.git
+
+# 매뉴얼/문서
+git clone http://zio:Zio%40Admin2026%21@101.79.17.164:3000/zio/guardia-docs.git
+```
+
+---
+
+## 4. Gitea 접속 정보
+
+| 항목 | 값 |
+|------|-----|
+| 웹 UI | https://zioinfo.co.kr:3000 |
+| 내부 API | http://127.0.0.1:9003/api/v1 |
+| 계정 | zio / Zio@Admin2026! |
+| Webhook 포트 | http://localhost:9999 |
+| Webhook Secret | `zioinfo-deploy-2026` |
+
+---
+
+## 5. GitHub 제거 완료
+
+```
+이전: origin → https://github.com/ythong86/GUARDiA (삭제됨)
+현재:
+  gitea     → https://zioinfo.co.kr:3000/zio/zioinfo-web.git
+  gitea-itsm → http://101.79.17.164:3000/zio/guardia-itsm.git
+  (각 독립 repo: origin → Gitea)
+```
+
+**Gitea만 사용합니다. GitHub push 금지.**
+
+---
+
+## 6. 주의사항
+
+- `C:\GUARDiA\repos\` 디렉토리는 `.gitignore`에 추가됨 (모노레포에서 추적 안 함)
+- 모노레포(`C:\GUARDiA`)는 Claude Code 작업용으로 유지
+- 실제 배포는 각 독립 repo에서 `git push origin main`으로 수행
+- manual/ 내용은 `zio/guardia-docs`에도 동기화됨
--- a/개편.md
+++ b/개편.md
@ -0,0 +1,38 @@
+클로드코드(Claude Code)의 AI 기반 코드 생성 및 리팩토링 역량과 Variant가 제공하는 무한한 디자인 탐색 인터페이스를 연결하면, '디자인 프로토타이핑에서 실제 프로덕션 코드 생성까지의 속도'를 획기적으로 단축할 수 있습니다.
+이 조합을 활용한 UI 개선 및 개발 프로세스 혁신 방안을 제안합니다.
+1. 디자인 탐색 및 코드화 자동화 루프
+Variant는 아이디어에 맞는 다양한 디자인 옵션을 시각적으로 제시합니다. 이를 단순히 참고하는 것을 넘어, 클로드코드를 통해 즉시 컴포넌트화하는 파이프라인을 구축하십시오.
+
+Workflow:
+Variant 활용: 특정 UI 섹션(예: 대시보드, 랜딩 페이지)에 대해 Variant에서 시각적으로 가장 우수한 디자인 초안을 도출합니다.
+클로드코드 연동: Variant에서 도출된 디자인 스크린샷이나 구조적 아이디어를 클로드코드에 입력합니다.
+Prompt: "Variant에서 선택한 이 디자인 레이아웃과 디자인 시스템(Tailwind/Styled-components 등)을 사용하여 React 컴포넌트로 구현하고, 기존 프로젝트의 스타일 토큰과 통합해줘."
+자동 생성: 클로드코드가 즉시 컴포넌트 코드를 작성하고, 필요 시 기존 코드베이스에 즉시 반영(Apply)합니다.
+
+2. 디자인 시스템 동기화 (Style-to-Code)
+Variant의 디자인 강점은 '끝없는 옵션'입니다. 클로드코드를 사용하여 Variant에서 영감을 받은 디자인을 디자인 토큰으로 변환하십시오.
+방법:
+Variant에서 마음에 드는 UI 구성 요소의 디자인 속성(간격, 폰트, 컬러 팔레트 등)을 분석합니다.
+클로드코드에게 해당 속성을 우리 프로젝트의 tailwind.config.js나 디자인 시스템 레지스트리에 맞게 규격화하도록 요청합니다.
+이 과정을 통해 Variant의 창의적인 디자인 결과물이 일관된 우리 서비스의 코드로 자동 전환됩니다.
+
+3. 컴포넌트 단위의 A/B 테스트 자동화
+Variant는 사용자의 아이디어를 다양한 버전으로 보여줍니다. 이를 활용해 실제 UI의 성능을 개선할 수 있습니다.
+방법:
+Variant에서 대안이 되는 2~3가지 디자인 레이아웃을 생성합니다.
+클로드코드를 통해 각각의 디자인을 독립적인 컴포넌트 버전으로 구현합니다.
+기존 UI 코드와 교체 가능한(Swappable) 형태로 구조화하여, 프론트엔드 환경에서 실제 사용자 데이터를 기반으로 실험 가능한 구조를 구축합니다.
+
+4. 클로드코드를 활용한 '디자인-구현' 격차 해소
+UI 개선 시 가장 큰 병목은 '디자인 의도와 실제 구현 간의 차이'입니다.
+구현 전략:
+클로드코드의 read 기능을 사용하여 현재 프로젝트의 전체 UI 구조를 파악하게 합니다.
+Variant의 디자인 레이아웃을 클로드코드에 제시하면서 "현재 우리 서비스의 레이아웃 체계를 유지하면서, Variant의 UI 요소 스타일을 반영하여 UI를 개선하라"고 지시합니다.
+클로드코드는 파일 변경사항을 미리 보여주므로, 개발자가 수정 사항을 검토한 후 즉시 반영할 수 있습니다.
+
+추천 실행 순서
+시각적 소스 확보: Variant에서 목표하는 UI의 다양한 옵션을 생성하고 시각적 가이드라인(스크린샷)을 확보하십시오.
+프로젝트 컨텍스트 주입: 클로드코드에게 프로젝트 내 UI 컴포넌트 디렉토리와 스타일 가이드 파일을 읽게 하여 프로젝트의 규칙을 인지시킵니다.
+반복적 리팩토링: 위에서 확보한 가이드라인을 바탕으로 클로드코드에게 특정 페이지의 UI 개선을 요청하고, 제안된 코드 변경 사항을 검토하며 점진적으로 업데이트합니다.
+
+위 방법으로 zio의 모든 시스템의 UI를 전면 개편 해 줘.