DOCS/journey/troubleshooting/250820_happybell80_사용자별로빙동적할당구현.md

사용자별 로빙 동적 할당 및 레벨 표시 구현

작성일: 2025-08-20

작성자: happybell80

관련 서비스: frontend-customer, rb10508_micro, robeing-monitor

---

오후 4시 30분

문제 상황

프론트엔드 헤더에 로빙 레벨이 하드코딩되어 있어 실제 DB 값과 불일치:

• game-layout.tsx: "LV.12" 하드코딩
• skills-items-panel.tsx: 기본값 20으로 설정
• 모든 사용자가 동일한 로빙(rb10508_micro) 사용

시스템 구조 파악

로빙 시스템 아키텍처

사용자 로그인 (Google OAuth)
        ↓
    users 테이블 (UUID)
        ↓
workspace_member 테이블
    (robeing_id 할당)
        ↓
    로빙 컨테이너
  (rb8001, rb10508_micro 등)
        ↓
  robeing-monitor (9024)
    (통합 상태 관리)

핵심 테이블 관계

• users: 사용자 UUID 저장
• workspace_member: user_id → robeing_id 매핑
• robeing_stats: 각 로빙의 레벨, 경험치, 스탯

서비스 구조

• 51123 서버: nginx, frontend-customer, auth-server
• 51124 서버: 로빙 컨테이너들 (rb8001:8001, rb10508_micro:10508)
• robeing-monitor: 통합 상태 관리 (포트 9024)

---

오후 4시 45분

해결 방안 설계

1. API 구조 설계

// 필요한 API 엔드포인트
1. GET /api/user/robeing - 사용자에게 할당된 로빙 정보
2. GET /api/stats/{robeing_id} - 특정 로빙의 스탯 조회

2. 프론트엔드 수정 계획

• 하드코딩된 로빙 ID를 동적으로 변경
• 사용자별 로빙 정보 조회 로직 추가
• 실시간 레벨 정보 표시

---

오후 4시 50분

구현 작업

1. robeing-api.ts 수정

// 새로운 함수 추가
export async function getUserRobeing(): Promise<{
  robeing_id: string;
  robeing_url: string;
} | null> {
  // workspace_member에서 사용자의 로빙 조회
}

export async function getRobeingStats(robeingId: string): Promise<{
  level: number;
  experience: number;
  // ...
}> {
  // 특정 로빙의 스탯 조회
}

2. game-layout.tsx 수정

// 변경 전
const [robeingLevel, setRobeingLevel] = useState<number>(1);
// 하드코딩: LV.12

// 변경 후
const [userRobeingId, setUserRobeingId] = useState<string>('rb10508_micro');
// 동적 할당: LV.{robeingLevel}

// useEffect로 사용자별 로빙 정보 조회
useEffect(() => {
  const fetchUserRobeing = async () => {
    const robeingInfo = await getUserRobeing();
    if (robeingInfo) {
      setUserRobeingId(robeingInfo.robeing_id);
    }
  };
  fetchUserRobeing();
}, [user]);

3. rb10508_micro endpoints.py 수정

@router.get("/api/stats/{robeing_id}")
async def get_stats(robeing_id: str):
    # PostgreSQL 직접 연결
    conn = await asyncpg.connect(
        host='192.168.0.100',
        port=5432,
        user='robeings',
        password='robeings',
        database='main_db'
    )
    
    # robeing_stats 테이블 조회
    query = """
        SELECT level, experience, stat_points,
               memory, compute, empathy, leadership, ethics
        FROM robeing_stats
        WHERE robeing_id = $1
    """
    row = await conn.fetchrow(query, robeing_id)

---

오후 4시 55분

추가 발견 사항

포트 번호 불일치 문제

• skill-embedding 서비스 포트가 문서마다 다름
• 8015 → 8515로 통일 필요
• 영향받는 파일:
  • DOCS/300_architecture/360_로빙_컨테이너_경량화_전략.md
  • robeing-monitor/README.md
  • robeing-monitor/docker-compose.yml
  • skill-embedding/.env.example

---

오후 5시 00분

Git 푸시 작업

푸시된 저장소들

1. frontend-customer ✅

   • 사용자별 로빙 동적 할당 구현
   • getUserRobeing(), getRobeingStats() 함수 추가

2. rb10508_micro ✅

   • /api/stats/{robeing_id} DB 조회 구현
   • PostgreSQL 직접 연결 로직 추가

3. DOCS ✅

   • 포트 번호 수정 (8015 → 8515)
   • 각종 문서 업데이트

4. skill-embedding ✅

   • .env.example 포트 번호 수정

5. robeing-monitor ✅

   • README.md, docker-compose.yml 포트 수정

---

교훈

1. 시스템 구조 이해의 중요성

• 단순한 레벨 표시 문제가 아닌 전체 아키텍처 이해 필요
• users → workspace_member → robeing_stats 관계 파악 필수
• 다중 로빙 체계와 사용자 매핑 구조 이해

2. 하드코딩 제거의 필요성

• 기존: 모든 사용자가 rb10508_micro 사용
• 개선: 사용자별 동적 로빙 할당
• 원칙: FUNCTIONAL PROGRAMMING 100%, NO HARDCODING 0%

3. API 설계 일관성

• RESTful 패턴 준수
• 명확한 엔드포인트 네이밍
• 에러 처리 및 기본값 제공

4. 문서와 코드 동기화

• 포트 번호 등 설정값 일관성 유지
• 여러 파일에 분산된 설정 통일
• 변경사항 발생 시 관련 문서 모두 업데이트

5. 점진적 마이그레이션

• 기본값 제공으로 하위 호환성 보장
• API 실패 시 fallback 처리
• 사용자 경험 중단 없이 개선

---

향후 개선 사항

1. Gateway API 통합

   • 현재: 프론트엔드가 직접 로빙 호출
   • 개선: Gateway를 통한 라우팅

2. 캐싱 추가

   • 로빙 정보는 자주 변경되지 않음
   • localStorage 또는 메모리 캐싱 활용

3. 실시간 업데이트

   • 현재: 30초마다 폴링
   • 개선: WebSocket으로 실시간 동기화

4. 로빙 상태 모니터링

   • robeing-monitor 활용도 증대
   • 중앙집중식 상태 관리 강화

---

문서 끝