docs: Gateway 변수명 혼란 문서화 - x_user_id 변수가 실제로는 UUID 저장하는 점 명시

troubleshooting/250901_rb8001_chat_history_implementation_issues.md

@@ -53,6 +53,15 @@ GET /gateway/api/history?limit=1
 - username 변환 시도가 불필요했음
 - 직접 UUID 전달로 해결
 
+### 3.3 변수명 혼란 (2025-09-02 추가)
+- **현재 상태**: Gateway에서 `x_user_id` 변수명 사용하지만 실제로는 UUID 값 저장
+- **혼란 요소**: 
+  - 변수명이 `x_user_id`지만 JWT sub의 UUID를 그대로 사용
+  - `get_user_by_username()` 함수 정의되어 있으나 실제 사용 안 함
+  - 주석과 변수명이 실제 값(UUID)과 불일치
+- **작동**: 정상 (UUID를 그대로 전달하므로 문제 없음)
+- **주의**: 향후 코드 수정 시 변수명 때문에 착각 가능
+
 ---
 
 ## 4. JWT Authorization 헤더 미전달