diff --git a/journey/troubleshooting/251204_admin_dashboard_business_integration.md b/journey/troubleshooting/251204_admin_dashboard_business_integration.md
new file mode 100644
index 0000000..5d52a72
--- /dev/null
+++ b/journey/troubleshooting/251204_admin_dashboard_business_integration.md
@@ -0,0 +1,75 @@
+# Admin Dashboard 비즈니스 통합 - 사용자/팀 및 로빙 관리 기능 추가
+
+**날짜**: 2025-12-04
+**작성자**: admin
+**관련 파일**:
+- `admin-dashboard/backend/routers/users.py`
+- `admin-dashboard/backend/routers/robeings.py`
+- `admin-dashboard/frontend/app.js:747-843`
+- `robeing-gateway/app/routers/admin.py:48-57`
+
+---
+
+## 문제 상황
+
+### 기존 한계
+- admin-dashboard는 인프라 모니터링만 제공 (시스템/Docker/nginx)
+- main_db 미연결로 사용자/팀/로빙 데이터 접근 불가
+- `admin_routes.py` 1053줄 (FastAPI 권장 300줄 초과), 계층 분리 없음
+
+## 해결 방안
+
+### 1. FastAPI 계층 분리
+
+**구조**: `admin-dashboard/backend/`
+- `schemas/user.py`, `schemas/robeing.py`: Pydantic 모델
+- `state/user_repository.py`, `state/robeing_repository.py`: main_db CRUD
+- `services/user_service.py`, `services/robeing_service.py`: 비즈니스 로직
+- `routers/users.py`, `routers/robeings.py`: API 엔드포인트
+
+**원칙 준수**: router → service → repository, DB 접근은 repository에서만
+
+### 2. main_db 연결
+
+**docker-compose.yml:19**: `DATABASE_URL=postgresql+asyncpg://robeings:robeings@172.17.0.1:5432/main_db`
+**state/user_repository.py:14**: AsyncEngine 생성, asyncpg 사용
+
+### 3. Frontend UI 추가
+
+**index.html:73-96**: 사용자/팀, 로빙 네비게이션 메뉴
+**index.html:301-364**: 사용자/팀, 로빙 섹션 (통계 카드 + 테이블)
+**app.js:747-843**: loadUsers(), loadRobeings() 함수 (asyncio 병렬 처리)
+
+### 4. Gateway 프록시 수정
+
+**문제**: 신규 API(`/admin/api/users`)와 기존 API(`/admin/system`) 경로 패턴 상이
+**해결**: `robeing-gateway/app/routers/admin.py:48-57` - 조건부 경로 처리
+```
+- users/robeings → /admin/api/* 유지
+- 기타 → /admin/* 변환
+```
+
+### 5. 브라우저 캐시 문제
+
+**문제**: app.js 수정했지만 브라우저가 오래된 캐시 사용
+**해결**: `index.html:20` - `<script src="/admin/app.js?v=20251204">`
+
+## 구현 완료
+
+**커밋**: admin-dashboard(0365162), robeing-gateway(8a682bd)
+**테스트**: 14명 사용자, 2개 로빙 조회 성공
+
+## 교훈
+
+### 1. 작업 전 기존 구조 파악 필수
+- 포트(8000), Gateway 프록시 구조를 docs 미확인하고 변경 시도 → 시간 낭비
+- AGENTS.md에 "구조 파악 필수" 원칙 추가
+
+### 2. Gateway 프록시 경로 설계
+- 신규/기존 API 경로 패턴 통일 필요
+- 조건부 처리로 해결 가능하나 복잡도 증가
+
+### 3. 브라우저 캐시 회피
+- JS/CSS 수정 시 버전 파라미터(`?v=YYYYMMDD`) 필수
+- Ctrl+F5도 안 되는 경우 있음 (nginx ETag)
+