diff --git a/43_레파지토리_구조_가이드.md b/43_레파지토리_구조_가이드.md new file mode 100644 index 0000000..0c15402 --- /dev/null +++ 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`에도 동기화됨 diff --git a/99. 디자인 전면 개편.md b/99. 디자인 전면 개편.md new file mode 100644 index 0000000..81c624e --- /dev/null +++ b/99. 디자인 전면 개편.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를 전면 개편 해 줘. \ No newline at end of file