docs(troubleshooting): rb8001/skill-rag-file push and DOCS pull summary (2025-10-21)

troubleshooting/251021_rb8001_skill-rag-file_push_and_DOCS_pull.md

@@ -0,0 +1,50 @@
+# 2025-10-21 rb8001/skill-rag-file 푸시 및 DOCS pull
+
+**작성일**: 2025-10-21  
+**작성자**: Claude (51124 서버 전담)  
+**상태**: 완료
+
+---
+
+## 요약
+- 로컬 변경사항을 원격 Gitea로 푸시하고, `DOCS` 저장소를 최신화(pull)했습니다.
+- 대상 저장소: `rb8001`, `skill-rag-file`, `DOCS`(pull만)
+
+## 변경 내역
+- rb8001
+  - 커밋: `b8901ae` (main)
+  - 내용: 추적 중인 변경만 커밋(Coldmail 워크플로/스크립트 경미 수정). 로컬의 미추적 스크립트(`scripts/debug_email_detail.py`, `scripts/find_pdf_emails.py`)와 임시 파일(`state/_write_test`)은 푸시 제외.
+  - 원격: `http://192.168.219.45:3000/ivada_Ro-being/rb8001.git`
+- skill-rag-file
+  - 커밋: `cfb012c` (main)
+  - 내용: 로컬에서 1커밋 선행 상태를 원격으로 동기화(추가 변경 없음).
+  - 원격: `https://git.ro-being.com/ivada_Ro-being/skill-rag-file.git`
+- DOCS
+  - 동작: `git pull --ff-only origin main` 수행하여 최신화
+  - 반영: 동시간대에 추가된 nginx 관련 이슈 문서 2건이 pull로 함께 반영됨
+
+## 검증
+- Git 기준 검증
+  - `rb8001`: `git log -1 --oneline` = `b8901ae`가 원격 `origin/main`에 반영됨
+  - `skill-rag-file`: `git log -1 --oneline` = `cfb012c`가 원격 `origin/main`에 반영됨
+- 배포(참고)
+  - CLAUDE 가이드의 배포 플로우에 따라 Gitea Actions가 51124에 SSH 후 `git pull && docker compose up -d --build`를 수행함
+  - 운영 검증은 서버에서 다음 절차로 확인 권장:
+    - `docker ps | grep -E "rb8001|skill-rag-file"`
+    - `docker logs [컨테이너명] --tail 100 | grep -iE "error|warn|fail"`
+    - 헬스체크: `curl http://localhost:[서비스포트]/health`
+
+## 영향/리스크
+- rb8001 Coldmail 관련 경미 수정이 런타임 동작에 영향을 줄 수 있음(이메일 워크플로/스크립트 경로). 이상 시 즉시 롤백 또는 수정 커밋 권장.
+- 미추적 스크립트는 아직 원격에 포함되지 않으므로 협업 필요 시 개별 검토 후 포함 여부 결정.
+
+## 후속 조치
+1. 51124에서 실제 재배포 여부 및 컨테이너 상태 확인(로그 에러 유무 점검).
+2. Coldmail 워크플로 관련 경로/인자 변경이 없는지 스모크 테스트 실행.
+3. 필요 시 미추적 스크립트 2건을 정식 유틸로 편입(README/usage 포함)하거나 `.gitignore`로 제외 정책 명확화.
+
+## 교훈
+- 푸시 전 추적/미추적 변경을 구분하고, 임시 파일은 배제해 리스크를 줄인다.
+- 문서 저장소는 편집 전 반드시 `git pull --ff-only`로 최신화해 충돌을 피한다.
+- 배포 검증은 컨테이너 상태/로그/헬스체크 3단계로 빠르게 확인한다.
+