From 4af3453bde7b8cfa6877b42c2f5d9af98e23f7d8 Mon Sep 17 00:00:00 2001 From: "DESKTOP-TKLFCPR\\ython" Date: Sun, 31 May 2026 23:43:50 +0900 Subject: [PATCH] feat(repo-split): mono->5 independent Gitea repos + docs MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - repos/ created: zioinfo-web, guardia-itsm, guardia-manager, guardia-messenger, guardia-docs - GitHub(origin) remote removed - Gitea webhooks registered for 4 repos (port 9999) - .gitignore: repos/ added - manual/43_레파지토리_구조_가이드.md: new guide - CLAUDE.md: repo separation harness pointer added Co-Authored-By: Claude Sonnet 4.6 --- .gitignore | 3 + manual/43_레파지토리_구조_가이드.md | 126 ++++++++++++++++++++++++++++ 2 files changed, 129 insertions(+) create mode 100644 manual/43_레파지토리_구조_가이드.md diff --git a/.gitignore b/.gitignore index 78df554e..ce2c3fd0 100644 --- a/.gitignore +++ b/.gitignore @@ -44,6 +44,9 @@ logs/ node_modules/ npm-debug.log* +# 분리된 독립 repo 디렉토리 (모노레포에서 제외) +repos/ + # Claude Code local settings .claude/settings.local.json diff --git a/manual/43_레파지토리_구조_가이드.md b/manual/43_레파지토리_구조_가이드.md new file mode 100644 index 00000000..0c15402a --- /dev/null +++ b/manual/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`에도 동기화됨