From ab9464cc3f6ffa1f967557f364d6874d5aa2b9bc Mon Sep 17 00:00:00 2001
From: happybell80 <happybell80@naver.com>
Date: Sun, 14 Sep 2025 14:50:11 +0900
Subject: [PATCH] docs: Add robeing-monitor DB schema mismatch troubleshooting

---
 ...0914_admin_robeing_monitor_schema_error.md | 51 +++++++++++++++++++
 1 file changed, 51 insertions(+)
 create mode 100644 troubleshooting/250914_admin_robeing_monitor_schema_error.md

diff --git a/troubleshooting/250914_admin_robeing_monitor_schema_error.md b/troubleshooting/250914_admin_robeing_monitor_schema_error.md
new file mode 100644
index 0000000..a7e8346
--- /dev/null
+++ b/troubleshooting/250914_admin_robeing_monitor_schema_error.md
@@ -0,0 +1,51 @@
+# robeing-monitor DB 스키마 불일치
+
+## 작성일: 2025-09-14
+## 작성자: admin
+## 환경: 51124 서버, robeing-monitor, PostgreSQL
+
+## 문제 증상
+Gateway에서 stats API 호출 시 매분마다 500 에러 발생
+
+### 에러 로그
+```
+sqlalchemy.exc.ProgrammingError: column robeing.robeing_id does not exist
+LINE 1: SELECT robeing.id AS robeing_id_1, robeing.robeing_id AS rob...
+```
+
+## 원인
+robeing-monitor 코드가 존재하지 않는 컬럼 조회
+- 코드: `robeing.robeing_id` 컬럼 요청
+- DB: 해당 컬럼 없음
+
+## 현재 영향
+- `/api/stats/rb8001` 엔드포인트 실패
+- Gateway가 기본값 반환으로 우회 처리 중
+- 사용자: happybell80 (UUID: 53529291-5050-4daa-89fb-008b546feb63)
+
+## 해결 방법
+로컬 개발자 작업 필요:
+
+1. robeing 테이블 스키마 확인
+```sql
+\d robeing
+```
+
+2. robeing_id 컬럼 추가 또는 코드 수정
+```sql
+-- 옵션 1: 컬럼 추가
+ALTER TABLE robeing ADD COLUMN robeing_id VARCHAR(50);
+
+-- 옵션 2: 코드에서 기존 컬럼 사용
+-- id 또는 다른 식별자 컬럼 사용하도록 수정
+```
+
+3. robeing-monitor 재배포
+
+## 관련 정보
+- Gateway 로그: 매분 실패 기록
+- 51124 서버: robeing_monitor 컨테이너 16시간 가동 중
+- DB: main_db PostgreSQL
+
+## 상태
+🔴 미해결 - 로컬 개발자 작업 대기
\ No newline at end of file