# 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`에도 동기화됨