chore(backend): 예시 env 에 AI 코스 설정 항목 추가
CI / Backend (lint · test · e2e · build) (pull_request) Successful in 12m11s
CI / Frontend (lint · type-check · test) (pull_request) Successful in 11m4s
CI / 에러 코드 SSOT 동기화 검사 (pull_request) Successful in 11m15s
CI / Backend (lint · test · e2e · build) (push) Successful in 12m16s
CI / Frontend (lint · type-check · test) (push) Successful in 10m54s
CI / 에러 코드 SSOT 동기화 검사 (push) Successful in 11m18s

AI 설정(AI_PROVIDER · 모델 · effort · 하루 횟수 · 비용 상한 · 제한 시간)이 예시 파일에 없어서,
실제 env 에 무엇을 적을 수 있는지 코드를 읽어야 알 수 있었다. 키와 기본값 설명을 빈 값으로 적어 둔다.
비어 있으면 코드 기본값을 쓰므로 예시를 그대로 옮겨도 동작이 바뀌지 않는다.

설계 §11 은 이 설정들이 루트 .env 에서 compose 로 넘어간다고 적었지만 compose 는 넘기지 않는다.
backend/.env.{env} 에 적는 것으로 고쳤다.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit was merged in pull request #17.
This commit is contained in:
2026-11-12 10:45:08 +09:00
parent 439753e1cf
commit a0c507a350
3 changed files with 46 additions and 7 deletions
+19
View File
@@ -32,3 +32,22 @@ KAKAO_REST_API_KEY=change-me-kakao-rest-api-key
# Claude API 키 — AI 코스 생성. 사용량만큼 과금된다.
ANTHROPIC_API_KEY=change-me-anthropic-api-key
# ── AI 코스 생성 설정 (설계 docs/design/ai-course.md §11) ──
# 비워 두면 코드 기본값을 쓴다. 바꿀 때만 값을 적는다 — 값을 적으면 코드 기본값이 바뀌어도 이 값이 이긴다.
# AI 를 부르는 곳: anthropic(기본) · fake(키 없이 흐름만 확인하는 가짜 AI)
AI_PROVIDER=
# 코스 초안 모델(기본 claude-sonnet-5-5) · 조건 해석 모델(기본 claude-haiku-5-5)
# claude-haiku-5-5 · claude-sonnet-5-5 만 받는다(가격표 src/shared/utils/ai-pricing.ts). 바꾸면 npm run ai:eval 로 다시 잰다
AI_COURSE_MODEL=
AI_CONDITION_MODEL=
# 추론 깊이 low · medium · high (기본 low · low)
AI_COURSE_EFFORT=
AI_CONDITION_EFFORT=
# 하루 생성 횟수 — 비로그인(기기 기준) · 로그인(사용자 기준) (기본 2 · 5)
AI_DAILY_LIMIT_GUEST=
AI_DAILY_LIMIT_MEMBER=
# 하루 비용 상한(정수 달러, 조건 해석 포함, 기본 3) — 넘으면 그날 새 생성을 막는다
AI_DAILY_BUDGET_USD=
# AI 호출 한 번의 제한 시간(ms, 기본 30000)
AI_TIMEOUT_MS=
+19
View File
@@ -29,3 +29,22 @@ KAKAO_REST_API_KEY=change-me-kakao-rest-api-key
# Claude API 키 — 운영용 키를 따로 발급하고 사용량 한도를 걸어 둔다.
ANTHROPIC_API_KEY=change-me-anthropic-api-key
# ── AI 코스 생성 설정 (설계 docs/design/ai-course.md §11) ──
# 비워 두면 코드 기본값을 쓴다. 바꿀 때만 값을 적는다 — 값을 적으면 코드 기본값이 바뀌어도 이 값이 이긴다.
# 운영에서는 ANTHROPIC_API_KEY 가 필수이고, AI_PROVIDER=fake 면 기동하지 않는다
AI_PROVIDER=
# 코스 초안 모델(기본 claude-sonnet-5-5) · 조건 해석 모델(기본 claude-haiku-5-5)
# claude-haiku-5-5 · claude-sonnet-5-5 만 받는다(가격표 src/shared/utils/ai-pricing.ts). 바꾸면 npm run ai:eval 로 다시 잰다
AI_COURSE_MODEL=
AI_CONDITION_MODEL=
# 추론 깊이 low · medium · high (기본 low · low)
AI_COURSE_EFFORT=
AI_CONDITION_EFFORT=
# 하루 생성 횟수 — 비로그인(기기 기준) · 로그인(사용자 기준) (기본 2 · 5)
AI_DAILY_LIMIT_GUEST=
AI_DAILY_LIMIT_MEMBER=
# 하루 비용 상한(정수 달러, 조건 해석 포함, 기본 3) — 넘으면 그날 새 생성을 막는다. 운영 값은 출시 전에 정한다
AI_DAILY_BUDGET_USD=
# AI 호출 한 번의 제한 시간(ms, 기본 30000)
AI_TIMEOUT_MS=