Mohaeng-AI/.env.example at main · SERVICE-MOHAENG/Mohaeng-AI · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
# ------------------------------
# 필수 설정 (반드시 지정)
# ------------------------------
# 모든 LLM 호출에 사용하는 OpenAI API 키
OPENAI_API_KEY=


# 서비스 간 인증 시 사용하는 공용 시크릿(x-service-secret)
SERVICE_SECRET=

# 쿼리 해싱 등 보안 용도로 사용되는 HMAC 시크릿
HMAC_SECRET=

# ------------------------------
# LLM / 요청 타임아웃 정책
# ------------------------------
# 기본 LLM 모델
# - ENABLE_STAGE_LLM_ROUTING=false 일 때 모든 stage에서 사용
# - ENABLE_STAGE_LLM_ROUTING=true 일 때 tier 모델 실패 시 fallback 모델로 사용
LLM_MODEL_NAME=gpt-4o-mini

# stage별 tier 라우팅 활성화 여부
ENABLE_STAGE_LLM_ROUTING=false

# stage 라우팅 tier 모델
LLM_MODEL_QUALITY=gpt-4o
LLM_MODEL_SPEED=gpt-4o-mini
LLM_MODEL_COST=gpt-4o-nano

# 요청 단위 하드 타임아웃(초)
REQUEST_TIMEOUT_SECONDS=60

# 일반 LLM 타임아웃(초)
LLM_TIMEOUT_SECONDS=60

# 추천 파이프라인 타임아웃(초)
RECOMMEND_TIMEOUT_SECONDS=45

# 추천 LLM temperature
RECOMMEND_LLM_TEMPERATURE=0.6

# 외부 API 타임아웃 상한(초)
EXTERNAL_API_TIMEOUT_SECONDS=15

# 콜백 요청 타임아웃(초)
CALLBACK_TIMEOUT_SECONDS=10

# 콜백 재시도 설정
CALLBACK_MAX_RETRIES=2
CALLBACK_BACKOFF_BASE_SECONDS=0.5
CALLBACK_BACKOFF_MAX_SECONDS=5.0

# ------------------------------
# Google Places (선택)
# ------------------------------
# 선택 항목: 비어 있으면 Google Places readiness 체크를 건너뜁니다
GOOGLE_PLACES_API_KEY=

# Google Places 요청 타임아웃(초)
GOOGLE_PLACES_TIMEOUT_SECONDS=10

# Google Places 언어 코드
GOOGLE_PLACES_LANGUAGE_CODE=ko

# Google Places Text Search 최소 평점(0.0~5.0, 범위 밖 값은 자동 보정)
GOOGLE_PLACES_MIN_RATING=4.0

# Google Places 후보에 대한 LLM 재정렬 사용 여부
GOOGLE_PLACES_LLM_RERANK_ENABLED=true

# LLM 재정렬 시 슬롯/검색당 최대 후보 개수(1~10, 범위 밖 값은 자동 보정)
GOOGLE_PLACES_LLM_RERANK_MAX_CANDIDATES=5

# ------------------------------
# visit_time 정책
# ------------------------------
# 일정 시작 시각 (HH:MM)
VISIT_TIME_START=09:00

# 장소 체류 기본 시간(분)
VISIT_TIME_STAY_MINUTES=90

# 이동 시간 계산 계수: 직선거리(km) * 계수 + 기본값
VISIT_TIME_TRANSIT_FACTOR=15.0
VISIT_TIME_TRANSIT_BASE_MINUTES=10

# 늦은 시간 경고 기준 시(hour)
VISIT_TIME_LATE_HOUR=23

# 이동 경고 기준(분)
VISIT_TIME_WALK_WARNING_MINUTES=30

# ------------------------------
# 런타임 / 보안
# ------------------------------
# development | staging | production
APP_ENV=development

# disabled | secret | public
DOCS_MODE=disabled

# true이면 API 응답에 내부 오류 메시지를 그대로 노출합니다
EXPOSE_INTERNAL_ERRORS=false

# 쉼표(,)로 구분한 CORS 허용 Origin 목록. 기본은 빈 값 유지.
CORS_ALLOW_ORIGINS=
CORS_ALLOW_METHODS=GET,POST,PUT,PATCH,DELETE,OPTIONS
CORS_ALLOW_HEADERS=Authorization,Content-Type,x-service-secret
CORS_ALLOW_CREDENTIALS=false

# 보안 헤더
SECURITY_HEADERS_ENABLED=true
ENABLE_HSTS=false
HSTS_MAX_AGE_SECONDS=31536000

# 프록시 / 호스트 신뢰 설정
PROXY_HEADERS_ENABLED=true
PROXY_TRUSTED_HOSTS=127.0.0.1
TRUSTED_HOSTS=

# 선택 항목: 로그 레벨(logging config에서 사용)
LOG_LEVEL=INFO

# ------------------------------
# Discord 웹훅 (선택)
# ------------------------------
# 서버 이벤트(시작/종료, 500 에러, 타임아웃 등) 알림을 보낼 Discord 웹훅 URL
# 비어 있으면 웹훅 전송을 건너뜁니다
DISCORD_WEBHOOK_URL=