feat(repo-split): mono->5 independent Gitea repos + docs

- 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 <noreply@anthropic.com>
This commit is contained in:
DESKTOP-TKLFCPR\ython 2026-05-31 23:43:50 +09:00
parent f77bb91c0c
commit 4af3453bde
2 changed files with 129 additions and 0 deletions

3
.gitignore vendored
View File

@ -44,6 +44,9 @@ logs/
node_modules/
npm-debug.log*
# 분리된 독립 repo 디렉토리 (모노레포에서 제외)
repos/
# Claude Code local settings
.claude/settings.local.json

View File

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