Claude-51124 22557e7132 docs: 오래된 트러블슈팅 아카이브 및 구조 정리

- 7-8월 초기 구축 문서 12개를 _archive/troubleshooting/2025_07-08_initial_setup/로 이동
- book/300_architecture/390_human_in_the_loop_intent_learning.md를 journey/research/intent_classification/로 이동 (개발 여정 문서)
- 빈 폴더 제거 (journey/assets/*)

2025-11-17 14:06:05 +09:00

2.1 KiB

Raw Blame History

rb8001: 하드코딩 URL/DB 기본값 환경변수화 정리

날짜: 2025-10-23
작성자: admin
관련 파일: 아래 목록 참조

문제

RAG 업로드/검색, Tavily, skill-slack/news, DB/Neo4j/Embedding 등 다수의 URL/기본값이 코드에 하드코딩되어 운영 환경 전환에 취약.

조치

환경변수/Settings 기반으로 통일. 기본값은 localhost 계열로 보수적 설정.

수정 파일

app/router/slack_handler.py:64, 366 → SKILL_RAG_FILE_URL 기반 /api/upload, /api/search
app/pipelines/langgraph_document.py:34, 53, 141, 168 → SKILL_RAG_FILE_URL 기반 업로드/검색/재색인/텍스트 조회 URL
app/skills/email_integration.py:366 → LLM 콜백 http://localhost:{PORT}/api/llm/extract
app/commands/skill_commands.py:17,18,347 → SKILL_SLACK_URL, SKILL_NEWS_URL, TAVILY_API_URL
app/skills/dm_skill.py:362 → SKILL_NEWS_URL + /api/news/search
app/skills/news_posting_skill.py:36 → DATABASE_URL 기본값을 localhost로 변경
app/memory/neo4j_client.py:33 → NEO4J_URI 기본값을 localhost로 변경
app/services/naverworks_file_processor.py:19 → DATABASE_URL 기본값 localhost
app/services/coldmail_filter.py:14 → DATABASE_URL 기본값 localhost
app/services/coldmail_embedding_filter.py:14 → DATABASE_URL 기본값 localhost
app/services/startup_valuation.py:17 → DATABASE_URL 기본값 localhost
app/core/emotion/base.py:16 → SKILL_EMBEDDING_URL 기본값 8515로 정정
app/services/workflows/web_search_workflow.py:79 → TAVILY_API_URL 적용
app/router/message_router.py:140-167 → 웹검색 그래프 경로 도입(환경변수 WEB_SEARCH_USE_GRAPH) 및 os import

검증

단위 테스트 통과: 대명사 해소/출처블록/그래프 워크플로우 (로컬 전용)
배포 후 헬스체크: /health healthy

교훈

URL/엔드포인트는 코드 하드코딩이 아닌 설정으로 관리해야 환경 전환·보안·유지보수가 용이하다.
DB/Neo4j 기본값은 내부 localhost로 설정하고 실환경은 .env/compose로 주입.

2.1 KiB Raw Blame History

rb8001: 하드코딩 URL/DB 기본값 환경변수화 정리

문제

조치

수정 파일

검증

교훈

2.1 KiB

Raw Blame History