# Admin UI 빌드 백로그 (2026-06-26)

- **목적**: admin-ui 전수 재감사 결과를 **실행 가능한 화면 단위 빌드 백로그**로 정리. "기능이 너무 많이 빠졌다"를 체계적으로 해소.
- **현황**: admin-ui 40화면 — A등급(완성) 7 / B등급(읽기전용·부분) 28 / C(stub) 0. 백엔드 152엔드포인트 중 **약 54%(~82개)가 UI 미연동.**
- **핵심**: 대부분은 **백엔드 API가 이미 있고 UI만 없는** 상태 → UI-only 작업으로 빠르게 메꿀 수 있다. 백엔드 신규가 필요한 건 머니/정합 보정(원장조정·이중입금·재집계·리컨실) 소수.

---

## 분류 기준

- **[UI-only]**: 백엔드 API 존재, 화면/버튼/폼만 추가하면 됨 → Cowork가 즉시 빌드 가능
- **[BE+UI]**: 백엔드 엔드포인트 신규 필요(IntelliJ) + UI → 분리 진행

---

## Phase 1 — P2P/TORQ 가시성 (UI-only, 즉시 착수 권장)

> 지금 가장 체감되는 갭. 상세조회 API(`getMatchDetail`/`getSettlementDetail`/`getMemberDetail`/`getWithdrawOrderDetail`/`getDepositOrderDetail`)가 **이미 존재**하는데 화면이 없다.

| # | 화면 | 작업 | 백엔드 | 비고 |
|---|---|---|---|---|
| P1-1 | 매칭 방식 컬럼 | ✅ **완료(미배포)** — P2pMatchListView에 legType 배지 | 준비됨 | 이번 세션 |
| P1-2 | **P2P 매칭 상세** | 매칭 클릭 → 상세(레그, 정산, 원장, **TORQ escrow_id/상태**, 분쟁 이력) | `getMatchDetail` 존재 | TORQ 가시성 핵심 |
| P1-3 | **P2P 정산 상세** | 정산 드릴다운(TxHash, INNER/ONCHAIN, 부분정산) | `getSettlementDetail` 존재 | |
| P1-4 | **P2P 회원 상세** | 회원 상세(스크래핑 상태, 계좌, 매칭 이력) | `getMemberDetail` 존재 | |
| P1-5 | P2P 주문 상세(입금/출금) | 주문 드릴다운(매칭 진행, 레그 구성) | `get*OrderDetail` 존재 | |
| P1-6 | TORQ 레그 분쟁 판정 노출 | 현재 isTorqTarget 계산만 있고 버튼 미표시 — TORQ 강제판정 UI 연결 | 존재 | P2pMatchListView |

## Phase 2 — 온체인/인프라 운영 액션 (UI-only, CLI 의존 제거)

> 목록은 있으나 액션 버튼이 없어 운영이 API/CLI 직접 호출 중.

| # | 화면 | 작업 | 백엔드 |
|---|---|---|---|
| P2-1 | 논스 관리 | 동기화·잠금해제 버튼 | `sync`/`unlock` 존재 |
| P2-2 | 인프라 지갑 | ADMIN/GAS/SETTLEMENT 생성 폼 | `createAdmin/Gas/Settlement` 존재 |
| P2-3 | 컨트랙트 | 등록·상태변경·정지/해제 | POST/PATCH 존재 |
| P2-4 | Relayer | 등록·상태변경·컨트랙트 등록/해제·해제 | POST/DELETE 존재 |
| P2-5 | 가스비 기록 | 면제(waive) 버튼 | `waive` 존재 |
| P2-6 | 인프라 지갑 잔액 | 단일/일괄 동기화 버튼 | `sync-balance(s)` 존재 |

## Phase 3 — 정산 머니/정합 보정 (BE+UI, P0 운영 리스크)

> 백엔드 엔드포인트 신규 필요. 현재 운영이 수동 SQL로 보정 중(고위험).

| # | 기능 | 작업 | 백엔드 |
|---|---|---|---|
| P3-1 | 시스템 쉐어 출금 | BalanceListView에 출금 폼 | `settlements/withdraw` **존재** → UI-only |
| P3-2 | 정산 재집계 트리거 | 날짜 지정 재집계 버튼 | **엔드포인트 신규(G4)** |
| P3-3 | 원장 수동 조정 | LedgerListView 조정/역분개 + ADJUSTMENT 경유 | **엔드포인트 신규(G1)** — 코어 `SettlementService.adjust` 있음 |
| P3-4 | 이중입금 조회/보정 | 중복 탐지 + reverse | **엔드포인트 신규(G2)** — 코어 `reverseDepositLedger` 있음 |
| P3-5 | 리컨실 정합 대시보드 | fee_role 불변식(Σ=totalFee) 체크 패널 | **엔드포인트 신규(G5)** |

## Phase 4 — 설정/파트너 고급 (UI-only, 완성도)

| # | 화면 | 작업 | 백엔드 |
|---|---|---|---|
| P4-1 | 파트너 화이트리스트 | 상세에 탭 추가(조회/추가/삭제) | 존재 |
| P4-2 | 파트너 텔레그램/Axim 설정 | 상세 탭 | 존재 |
| P4-3 | 파트너 API키 재생성·2FA리셋·임시비번 | 상세 액션 버튼 | 존재 |
| P4-4 | 통화/네트워크 CRUD | 추가·수정 폼 | POST/PUT 존재 |
| P4-5 | 감사 로그 상세 모달 | 상세 조회 | `getAuditLogDetail` 존재 |
| P4-6 | 런타임 설정 편집 | system-settings 수정 UI | `updateSetting` 존재 |

---

## 우선순위 요약

1. **Phase 1 (P2P/TORQ 상세) — UI-only, 즉시** ← 현재 체감 갭, API 준비됨. 가장 빠른 가치.
2. **Phase 3-1 시스템 쉐어 출금** — UI-only(엔드포인트 존재), 수익 회수 운영 필수.
3. **Phase 2 (인프라 액션) — UI-only** — CLI 의존 제거.
4. **Phase 3-2~5 (보정 도구) — BE+UI** — IntelliJ 백엔드 + Cowork UI 병행. P0 운영 리스크.
5. **Phase 4 (설정/파트너)** — 완성도.

> 가드레일: 모든 보정/상태변경/지갑생성은 audit_logs + 사유 + (해당 시) 2FA, 잔액변경은 ledger ADJUSTMENT 경유.

---

## 진행 방식 제안

- **Cowork**: Phase 1·2·3-1·4의 UI-only 항목을 서브에이전트로 구현 → 직접 검수 → 배포.
- **IntelliJ**: Phase 3-2~5의 백엔드 엔드포인트(G1·G2·G4·G5) 신규 — 별도 핸드오프.
- 권장 1차 배치: **Phase 1 전체(P1-2~P1-6) + P1-1 배포** — P2P/TORQ 운영 가시성 한 번에 확보.