guardia-docs/43_레파지토리_구조_가이드.md

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. 개발 워크플로우

기능 개발 (모노레포 기준)

# 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 방법

# 홈페이지
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에도 동기화됨