# 버그 조치 보고서: AI 요약 언어 불일치 (2026-04-18)

## 1. 버그 내용
- **현상**: 사용자가 UI 언어를 한국어로 설정했음에도 불구하고, AI 분석(요약 및 태그 추출) 결과가 영문으로 출력됨.
- **원인**: 
    - 백엔드(`/api/memos/<id>/analyze`)에서 언어 설정을 서버 전역 설정(`app.config['lang']`)에만 의존함.
    - 사용자가 UI에서 언어를 변경해도 이 변경사항이 서버 구성에 실시간으로 반영되지 않아 기본값인 'en'으로 동작함.

## 2. 조치 사항
### 프론트엔드 수정 (`static/js/api.js`)
- `API.triggerAI(id)` 함수에서 `I18nManager.currentLang`을 확인하여 요청 쿼리 파라미터에 `lang`을 추가함.
- 예: `POST /api/memos/123/analyze?lang=ko`

### 백엔드 라우트 수정 (`app/routes/ai.py`)
- `analyze_memo_route`에서 `request.args.get('lang')`을 통해 클라이언트의 현재 언어 설정을 수신하도록 변경.
- 수신된 `lang` 정보를 기반으로 AI 분석 엔진에 언어 지침을 전달함.
- 에러 메시지 또한 `_t(key, lang=lang)`을 사용하여 적절한 언어로 반환되도록 개선.

### AI 엔진 프롬프트 최적화 (`app/ai.py`)
- 한국어(`ko`) 요청 시 **"반드시 모든 응답은 한국어로 작성해야 합니다"**라는 명시적 지침을 프롬프트에 추가하여 모델의 출력 언어를 강제함.

## 3. 결과 및 확인
- UI 언어 설정에 따라 AI의 요약 결과가 정확히 해당 언어로 생성됨을 확인.
- 만약 언어 정보가 전달되지 않을 경우 한국어('ko')를 기본값으로 사용하도록 폴백 로직 적용.

## 4. 향후 주의사항
- 새로운 AI 기능(전체 요약, 추천 시스템 등) 추가 시에도 클라이언트의 `lang` 파라미터를 반드시 연동할 것.