Story: 어드민 연동 모니터링 UI

메타

항목	값
Story ID	E-05-S-08
Epic	E-05 연동 자동화
상태	ready-for-dev
우선순위	P1
규모	M
담당 개발자	수민 (FE)

---

사용자 스토리

As a 운영팀,
I want 현재 진행 중인 연동 상태를 한눈에 보고 싶다,
So that 문제 발생 시 빠르게 대응할 수 있다.

---

수락 기준 (Acceptance Criteria)

AC-01: 연동 현황 대시보드

항목	내용
Given	어드민 페이지에서
When	연동 현황 페이지에 진입하면
Then	현재 Lock 상태와 대기열이 표시된다

AC-02: 세션 목록

항목	내용
Given	연동 현황 페이지에서
When	세션 목록을 볼 때
Then	진행중/대기중/완료/실패 상태별로 필터링할 수 있다

AC-03: 세션 상세

항목	내용
Given	세션 목록에서
When	특정 세션을 클릭하면
Then	상세 정보와 히스토리가 표시된다

AC-04: 수동 조치

항목	내용
Given	실패 또는 타임아웃 세션에서
When	조치 버튼을 클릭하면
Then	재시도 안내 발송 또는 수동 모드 전환이 가능하다

AC-05: 통계

항목	내용
Given	연동 현황 페이지에서
When	통계 섹션을 볼 때
Then	오늘 완료/진행/실패 건수가 표시된다

---

태스크 분해

Task 1: 대시보드 레이아웃 AC-01, AC-05

• [ ] 1.1: /admin/integration 라우트 생성
• [ ] 1.2: Lock 상태 카드 (현재 Lock 보유자, 남은 시간)
• [ ] 1.3: 통계 카드 (완료/진행/실패)

Task 2: 세션 목록 AC-02

• [ ] 2.1: 세션 테이블 컴포넌트
• [ ] 2.2: 상태별 필터 탭
• [ ] 2.3: 실시간 업데이트 (WebSocket 또는 폴링)

Task 3: 세션 상세 AC-03

• [ ] 3.1: 세션 상세 모달/사이드패널
• [ ] 3.2: 상태 히스토리 타임라인
• [ ] 3.3: 수신된 인증번호 표시

Task 4: 수동 조치 AC-04

• [ ] 4.1: 재시도 안내 발송 버튼
• [ ] 4.2: 수동 인증번호 입력 모달
• [ ] 4.3: Lock 강제 해제 버튼

---

화면 구성

┌───────────────────────────────────────────────────────────────┐
│ 📊 연동 현황                                        [새로고침] │
├───────────────────────────────────────────────────────────────┤
│                                                               │
│  🔒 현재 Lock: 김셀러 (shop_123) - 남은 시간 1:23             │
│                                                               │
│  [전체] [진행중] [대기중] [완료] [실패]                       │
│                                                               │
│  ┌─────────────────────────────────────────────────────────┐ │
│  │ 상태 │ 셀러 │ 시작 시간 │ 현재 단계 │ 액션             │ │
│  ├─────────────────────────────────────────────────────────┤ │
│  │ 🔵   │ 김셀러 │ 10:30   │ SMS 대기  │ -               │ │
│  │ 🟡   │ 박셀러 │ 10:31   │ Lock 대기 │ -               │ │
│  │ 🟢   │ 이셀러 │ 10:15   │ 완료      │ -               │ │
│  │ 🔴   │ 최셀러 │ 10:00   │ 타임아웃  │ [재시도] [수동] │ │
│  └─────────────────────────────────────────────────────────┘ │
│                                                               │
│  📈 오늘 통계: 완료 12건 / 진행 2건 / 실패 1건               │
│                                                               │
└───────────────────────────────────────────────────────────────┘

---

Dev Notes

의존성

• E-05-S-04: 세션 상태 머신 (API)
• E-05-S-05: WebSocket (실시간 업데이트)

API 필요

• GET /admin/integration/sessions - 세션 목록
• GET /admin/integration/stats - 통계
• POST /admin/integration/sessions/:id/retry - 재시도

---

생성일: 2026-01-20