Claude-51124 46baeaff91 docs: 개발 참조 문서 추가 (reference/)

- API 엔드포인트 정리 (api_endpoints.md)
- 인프라 정보 정리 (infrastructure.md)
- 환경변수 정리 (environment_variables.md)
- 배포 파이프라인 정리 (deployment_pipelines.md)
- 상수/설정값 정리 (constants.md)
- 네이밍 컨벤션 정리 (naming_conventions.md)
- 로깅 규칙 정리 (logging_rules.md)

목적: 개발 시 중복/오류 방지, 빠른 참조
모든 문서 100줄 이하 유지, 파일:줄번호 참조 사용

2025-12-06 13:28:46 +09:00

3.7 KiB

Raw Blame History

API 엔드포인트 참조

작성일: 2025-12-06 목적: 개발 시 API 엔드포인트 중복/오류 방지, 빠른 참조

rb8001 (메인 서비스, 8001)

메시지 처리

엔드포인트	메서드	설명	인증
`/api/message`	POST	Gateway/Frontend 메시지 처리	JWT 필수
`/api/feedback/chat`	POST	채팅 피드백 (좋아요/싫어요)	JWT 필수

참고: rb8001/app/router/message_endpoint.py:26, rb8001/main.py:85

LLM

엔드포인트	메서드	설명
`/api/llm/generate`	POST	텍스트 생성
`/api/llm/summarize`	POST	요약
`/api/llm/complete`	POST	완성
`/api/llm/health`	GET	헬스체크

참고: rb8001/app/router/llm_endpoint.py:28,55,93,124

감정 분석

엔드포인트	메서드	설명
`/api/emotion/infer`	POST	감정 추론
`/api/emotion/timeseries`	GET	시계열 데이터
`/api/emotion/team-insight`	GET	팀 인사이트
`/api/emotion/process-message`	POST	메시지 처리
`/api/emotion/health`	GET	헬스체크

참고: rb8001/app/router/emotion_endpoint.py:75,150,188,263,303

기억 온톨로지

엔드포인트	메서드	설명
`/api/v1/memory/event`	POST	사건 저장
`/api/v1/memory/recall`	POST	회상
`/api/v1/memory/stats`	GET	통계

참고: rb8001/app/router/memory_ontology.py:69,118,181

Intent 리뷰

엔드포인트	메서드	설명
`/api/intent-review/queue`	GET	큐 조회
`/api/intent-review/{item_id}/label`	PUT	라벨 업데이트
`/api/intent-review/stats`	GET	통계

참고: rb8001/app/router/intent_review_endpoint.py:33,58,81

IR Deck 평가

엔드포인트	메서드	설명
`/api/ir-deck/upload`	POST	PDF 업로드
`/api/ir-deck/evaluate`	POST	평가 시작
`/api/ir-deck/evaluation/{evaluation_id}`	GET	평가 결과
`/api/ir-deck/chat`	POST	채팅
`/api/ir-deck/feedback`	POST	피드백

참고: rb8001/app/router/ir_deck.py:109,169,263,297,344

Slack

엔드포인트	메서드	설명
`/slack/events`	POST	Slack 이벤트
`/slack/slash`	POST	슬래시 명령어
`/slack/health`	GET	헬스체크

참고: rb8001/app/router/slack_endpoint.py:33,70,117

skill-* 서비스

서비스	포트	주요 엔드포인트	참고
skill-email	8501	`/health`	-
skill-news	8505	`/health`	`skill_news/README.md:30`
skill-slack	8502	`/health`	`skill-slack/README.md:23`
skill-rag-file	8508	`/healthz`, `/api/upload`, `/api/search`	`skill-rag-file/app/main.py:60`
skill-calendar	8512	`/health`, `/api/events`	`skill-calendar/README.md:23`

robeing-monitor (9024)

엔드포인트	메서드	설명
`/health`	GET	헬스체크
`/api/stats/{robeing_id}`	GET/PUT	스탯 조회/업데이트
`/api/monitor/robeings`	GET	로빙 상태
`/api/monitor/skills`	GET	스킬 서비스 상태

참고: robeing-monitor/README.md:68, robeing-monitor/app/api/monitor.py

Gateway (8100)

엔드포인트	메서드	설명
`/gateway/slack/events`	POST	Slack 이벤트 프록시
`/gateway/*`	*	각 서비스 프록시

참고: AGENTS.md:88-92

업데이트: 서비스 추가/변경 시 즉시 반영

3.7 KiB Raw Blame History