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

2.6 KiB

Raw Blame History

환경변수 참조

작성일: 2025-12-06 목적: 환경변수 중복/오류 방지, 빠른 참조

공통 환경변수

변수명	필수	설명	예시
`SERVICE_NAME`	예	서비스 이름	`skill-slack`
`PORT`	예	서비스 포트	`8502`
`LOG_LEVEL`	선택	로그 레벨	`INFO`
`DATABASE_URL`	예*	PostgreSQL 연결 문자열	`postgresql://...`
`JWT_SECRET_KEY`	예*	JWT 시크릿 키	-

*일부 서비스만 필수

rb8001

변수명	필수	설명	참고
`DATABASE_URL`	예	PostgreSQL 연결	`rb8001/docker-compose.yml`
`JWT_SECRET_KEY`	예	JWT 인증	`rb8001/app/auth.py`
`NEO4J_PASSWORD`	선택	Neo4j 비밀번호	`rb8001/docker-compose.yml`
`TAVILY_API_KEY`	선택	Tavily API 키	`rb8001/docker-compose.yml`
`USE_EMOTION_ANALYSIS`	선택	감정 분석 활성화	`true/false`
`GEMINI_API_KEY`	선택	Gemini API 키	-

skill-* 서비스

skill-slack

변수명	필수	설명
`SERVICE_API_KEY`	예	서비스 인증 키
`SLACK_BOT_TOKEN`	예	Slack 봇 토큰
`JWT_SECRET_KEY`	예	JWT 검증

참고: skill-slack/app/core/config.py, skill-slack/docker-compose.yml

skill-rag-file

변수명	필수	설명
`DATABASE_URL`	예	PostgreSQL 연결
`CHROMA_PORT`	선택	ChromaDB 포트 (기본: 8000)

참고: skill-rag-file/docker-compose.yml:11

skill-calendar

변수명	필수	설명
`DATABASE_URL`	예	PostgreSQL 연결 (51123)

참고: skill-calendar/docker-compose.yml:14

skill-news

변수명	필수	설명
`GEMINI_API_KEY`	예	Gemini API 키
`DATABASE_URL`	예	PostgreSQL 연결

참고: skill_news/README.md:36-39

robeing-monitor

변수명	필수	설명
`DATABASE_URL`	예	PostgreSQL 연결
`ROBEING_URLS`	예	로빙 서비스 URL 목록
`SKILL_URLS`	예	스킬 서비스 URL 목록

참고: robeing-monitor/README.md:37-42

주의사항

민감 정보 하드코딩 금지: API 키, 토큰, 비밀번호는 .env 파일에만 저장
기본값 사용 금지: 환경변수 미설정 시 명시적 에러 처리
참고: DOCS/book/300_architecture/311_FastAPI_구조_원칙.md 섹션 12

업데이트: 환경변수 추가/변경 시 즉시 반영

2.6 KiB Raw Blame History