DOCS/workflow/README.md
happybell80 64ef0deaee docs(workflow): RAG 03_rag 흐름 문서화 및 JSON settings 필드 추가
- workflow/03_rag/README.md: RAG 워크플로우 인덱스 SSOT
- 4개 흐름 문서 추가 (companyx_grounding, rag_search, rag_upload, skill_embedding)
- workflow README에 03_rag 인덱스 섹션 연결
- JSON 4개에 settings 필드 추가

Made-with: Cursor
2026-03-19 18:31:27 +09:00

52 lines
2.8 KiB
Markdown

# Robeing n8n Workflows
로빙의 분산 마이크로서비스 및 비즈니스 로직을 n8n으로 자동화하기 위한 템플릿 저장소입니다.
## 폴더 구조
- `01_conversation/`: Slack 진입점, 대화 정규화, 콜드메일 IR 알림 및 액션 추출
- `02_skills/`: `skill-*` 서비스 브리지 (Email, News, Calendar, Slack)
- `03_rag/`: 파일 업로드, 인덱싱, 임베딩, Company X 전용 Grounding 파이프라인
- `04_scheduler/`: 정기 브리핑, 상태 알림, 재시도 로직
- `05_admin/`: 서비스 헬스 체크, 일기(Reflection) 자동 생성 및 동기화
## 시스템 구성 및 엔드포인트
| 서버 | 역할 | IP | 주요 포트 |
|------|------|----|-----------|
| 51123 | 메인/인증/DB | 192.168.219.45 | Gateway(8100), Auth(9000), DB(5432) |
| 51124 | 로빙/스킬 | 192.168.219.52 | rb8001(8001), Email(8501), News(8505), RAG(8508), Calendar(8512) |
## 주요 워크플로우 가이드
### 1. 로빙 일기 시스템 (`05_admin/diary_reflection_pipeline.json`)
- 매일 오전 2시, `rb8001`의 하루 활동과 감정을 집계하여 일기를 생성합니다.
- 생성된 요약본을 Slack 관리자 채널로 전송합니다.
### 2. 콜드메일 IR 분석 (`01_conversation/coldmail_ir_notification_sync.json`)
- 네이버웍스 등을 통해 수신된 콜드메일을 감지하고, IR Deck(PDF) 존재 여부를 판별합니다.
- IR 자료가 있을 경우 Slack에 분석 버튼을 노출하여 원클릭으로 지표 추출을 실행합니다.
### 3. 서비스 헬스 모니터 (`05_admin/service_health_check.json`)
- 10분 간격으로 모든 마이크로서비스의 `/health` 또는 `/healthz`를 체크합니다.
- 장애 발생 시 Slack 알림을 통해 즉각적인 대응을 지원합니다.
### 4. 캘린더 스킬 브리지 (`02_skills/skill_calendar_request.json`)
- 구글 캘린더 연동을 위한 브리지 워크플로우입니다.
- 일정 조회, 등록, 삭제 요청을 `skill-calendar` 서비스로 전달합니다.
### 5. RAG 워크플로우 인덱스 (`03_rag/README.md`)
- Company X 내부 문서를 로빙이 읽고 답변하도록 만드는 RAG 흐름의 진입점입니다.
- 업로드, 검색, Grounding, 임베딩 브리지의 역할을 분리해서 봅니다.
- 세부 절차는 각 흐름 문서에서 확인합니다.
## 사용 시 주의사항
- **Credential 설정**: 각 노드의 Slack, HTTP Request 노드에서 실제 환경의 Credentials(Token, API Key)를 설정해야 합니다.
- **IP 주소**: 현재 템플릿은 내부 IP(`192.168.219.*`)를 기본값으로 사용합니다. 환경이 다를 경우 일괄 변경이 필요합니다.
- **채널 ID**: Slack 노드에 설정된 `channelId`는 예시 값이므로, 실제 알림을 받을 채널 ID로 수정하십시오.
---
**최근 업데이트**: 2026-03-18
**상태**: 16개 워크플로우 반영 완료 (기존 12개 + 신규 4개)