hehihoho3/h-lab
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
aaf8901f13
h-lab/docs/superpowers/plans/2026-05-30-discovery-page.md

504 lines
27 KiB
Markdown
Raw Blame History

# 발굴(Discovery) 전용 페이지 Implementation Plan
> **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking.
**Goal:** 수집한 영상 중 "재가공할 떡상 후보"를 필터·정렬로 빠르게 골라내는 발굴 전용 페이지(`/discover`)를 추가한다.
**Architecture:** 기존 `ChannelVideo` + 큐레이션 API 위에 발굴 조회 쿼리 1개·서비스 메서드 1개·엔드포인트 1개·페이지 1개·사이드바 링크 1개를 더한다. 행별 액션(상태변경·북마크)은 기존 엔드포인트를 재사용한다. 새 외부 호출·새 데이터 없음(비용 0).
**Tech Stack:** Spring Boot 3.4 / Java 21 / Spring Data JPA(JPQL) / Thymeleaf(layout-dialect) / 바닐라 JS(fetch).
> **검증 방식 주의:** 이 프로젝트는 테스트 프레임워크가 없고(`src/test` 없음) 원격 PostgreSQL에 연결된다. 따라서 각 태스크의 검증은 단위테스트 대신 **컴파일 + 기동 + 수동 확인**으로 한다. JAVA_HOME 은 `D:\Development\app\JDK\jdk-21.0.5`.
---
## File Structure
- **수정** `src/main/java/com/hlab/yanalyst/domain/channel/ChannelVideoRepository.java` — `discover(...)` JPQL 쿼리 추가.
- **수정** `src/main/java/com/hlab/yanalyst/domain/channel/ChannelVideoCurationService.java` — `discover(...)` 메서드 추가(파라미터 정규화·기본값·limit 캡·nullsLast 정렬).
- **수정** `src/main/java/com/hlab/yanalyst/domain/channel/ChannelVideoCurationController.java` — `GET /discover` 엔드포인트 추가.
- **수정** `src/main/java/com/hlab/yanalyst/web/WebController.java` — `GET /discover` 페이지 라우트 추가.
- **생성** `src/main/resources/templates/discover.html` — 발굴 페이지(필터 바 + 결과 테이블 + 행 액션 + 영상 모달).
- **수정** `src/main/resources/templates/layout/sidebar.html` — "발굴" 네비 링크 추가.
---
## Task 1: 발굴 조회 쿼리 (Repository)
**Files:**
- Modify: `src/main/java/com/hlab/yanalyst/domain/channel/ChannelVideoRepository.java`
- [ ] **Step 1: `discover` 쿼리 메서드 추가**
`search(...)` 메서드 정의 바로 뒤(파일 내 마지막 메서드 다음, 닫는 `}` 앞)에 아래를 추가한다:
```java
/**
* 발굴(Discovery) 조회. EXCLUDED 는 항상 제외. null/false 조건은 무시.
* 정렬·개수 제한은 호출부의 Pageable(sort + size)로 처리한다.
* @param publishedAfter 이 시각 이후 업로드분만 (null이면 전체)
* @param minRatio viewsPerSubRatio 하한 (null이면 미적용; null 배율 행은 자동 제외)
* @param shortsOnly true면 Shorts만
* @param source CHANNEL | SEARCH (null이면 전체)
* @param unprocessedOnly true면 상태가 NEW/REVIEWING 인 것만
*/
@Query("select v from ChannelVideo v where "
+ "v.interestStatus <> 'EXCLUDED' and "
+ "(:publishedAfter is null or v.publishedAt >= :publishedAfter) and "
+ "(:minRatio is null or v.viewsPerSubRatio >= :minRatio) and "
+ "(:source is null or v.source = :source) and "
+ "(:shortsOnly = false or v.isShorts = true) and "
+ "(:unprocessedOnly = false or v.interestStatus in ('NEW','REVIEWING'))")
java.util.List<ChannelVideo> discover(@Param("publishedAfter") java.time.LocalDateTime publishedAfter,
@Param("minRatio") java.math.BigDecimal minRatio,
@Param("source") String source,
@Param("shortsOnly") boolean shortsOnly,
@Param("unprocessedOnly") boolean unprocessedOnly,
org.springframework.data.domain.Pageable pageable);
```
- [ ] **Step 2: 컴파일로 검증**
Run: `$env:JAVA_HOME="D:\Development\app\JDK\jdk-21.0.5"; .\gradlew.bat compileJava --console=plain`
Expected: `BUILD SUCCESSFUL` (deprecated API 경고는 무시).
- [ ] **Step 3: 커밋**
```bash
git add src/main/java/com/hlab/yanalyst/domain/channel/ChannelVideoRepository.java
git commit -m "feat(discover): add ChannelVideo discovery query"
```
---
## Task 2: 발굴 서비스 메서드 (Service)
**Files:**
- Modify: `src/main/java/com/hlab/yanalyst/domain/channel/ChannelVideoCurationService.java`
- [ ] **Step 1: `discover` 메서드 추가**
`findOutperformers(...)` 메서드 정의 바로 뒤에 아래를 추가한다. (이미 import 된 `Sort`, `StringUtils`, `PageRequest`(`org.springframework.data.domain.PageRequest` 는 풀패키지로 사용), `BigDecimal` 사용)
```java
/**
* 발굴(Discovery) 조회 — 필터 + 정렬 + 개수 제한.
* @param periodDays 최근 N일만 (null/0이면 전체)
* @param minRatio viewsPerSubRatio 하한 (null이면 미적용)
* @param shortsOnly Shorts만
* @param source CHANNEL | SEARCH (빈값이면 전체)
* @param unprocessedOnly true면 NEW/REVIEWING 만
* @param sortBy 정렬 필드(ALLOWED_SORT, 기본 viewsPerSubRatio 내림차순, null은 항상 마지막)
* @param limit 최대 개수(기본 100, 최대 200)
*/
public List<ChannelVideo> discover(Integer periodDays, java.math.BigDecimal minRatio,
boolean shortsOnly, String source, boolean unprocessedOnly,
String sortBy, Integer limit) {
java.time.LocalDateTime publishedAfter =
(periodDays == null || periodDays <= 0) ? null : java.time.LocalDateTime.now().minusDays(periodDays);
String sourceFilter = StringUtils.hasText(source) ? source : null;
String sortField = StringUtils.hasText(sortBy) && ALLOWED_SORT.contains(sortBy) ? sortBy : "viewsPerSubRatio";
int size = (limit == null || limit <= 0) ? 100 : Math.min(limit, 200);
Sort sort = Sort.by(Sort.Order.desc(sortField).nullsLast());
return channelVideoRepository.discover(publishedAfter, minRatio, sourceFilter, shortsOnly, unprocessedOnly,
org.springframework.data.domain.PageRequest.of(0, size, sort));
}
```
- [ ] **Step 2: 컴파일로 검증**
Run: `$env:JAVA_HOME="D:\Development\app\JDK\jdk-21.0.5"; .\gradlew.bat compileJava --console=plain`
Expected: `BUILD SUCCESSFUL`.
- [ ] **Step 3: 커밋**
```bash
git add src/main/java/com/hlab/yanalyst/domain/channel/ChannelVideoCurationService.java
git commit -m "feat(discover): add discover() service method with defaults and limit cap"
```
---
## Task 3: 발굴 엔드포인트 (Controller)
**Files:**
- Modify: `src/main/java/com/hlab/yanalyst/domain/channel/ChannelVideoCurationController.java`
- [ ] **Step 1: `GET /discover` 추가**
`/outperformers` 핸들러(`outperformers(...)`) 바로 뒤에 아래를 추가한다:
```java
@GetMapping("/discover")
@Operation(summary = "발굴(Discovery) 조회",
description = "필터: periodDays(최근 N일), minRatio(배율 하한), shortsOnly, source(CHANNEL|SEARCH), "
+ "unprocessedOnly(NEW/REVIEWING만). 정렬 sortBy(기본 viewsPerSubRatio↓), limit(기본100). "
+ "EXCLUDED 는 항상 제외.")
public ApiResponse<List<ChannelVideo>> discover(
@RequestParam(required = false) Integer periodDays,
@RequestParam(required = false) java.math.BigDecimal minRatio,
@RequestParam(defaultValue = "false") boolean shortsOnly,
@RequestParam(required = false) String source,
@RequestParam(defaultValue = "false") boolean unprocessedOnly,
@RequestParam(required = false) String sortBy,
@RequestParam(required = false) Integer limit) {
return ApiResponse.ok(curationService.discover(periodDays, minRatio, shortsOnly, source, unprocessedOnly, sortBy, limit));
}
```
- [ ] **Step 2: 컴파일로 검증**
Run: `$env:JAVA_HOME="D:\Development\app\JDK\jdk-21.0.5"; .\gradlew.bat compileJava --console=plain`
Expected: `BUILD SUCCESSFUL`.
- [ ] **Step 3: 커밋**
```bash
git add src/main/java/com/hlab/yanalyst/domain/channel/ChannelVideoCurationController.java
git commit -m "feat(discover): add GET /api/v1/channel-videos/discover endpoint"
```
---
## Task 4: 페이지 라우트 (WebController)
**Files:**
- Modify: `src/main/java/com/hlab/yanalyst/web/WebController.java`
- [ ] **Step 1: `/discover` 라우트 추가**
`board(...)` 핸들러 바로 뒤에 아래를 추가한다:
```java
@GetMapping("/discover")
public String discover(Model model) {
model.addAttribute("currentPage", "discover");
return "discover";
}
```
- [ ] **Step 2: 컴파일로 검증**
Run: `$env:JAVA_HOME="D:\Development\app\JDK\jdk-21.0.5"; .\gradlew.bat compileJava --console=plain`
Expected: `BUILD SUCCESSFUL`.
- [ ] **Step 3: 커밋**
```bash
git add src/main/java/com/hlab/yanalyst/web/WebController.java
git commit -m "feat(discover): add /discover page route"
```
---
## Task 5: 발굴 페이지 템플릿 (discover.html)
**Files:**
- Create: `src/main/resources/templates/discover.html`
- [ ] **Step 1: 템플릿 작성**
아래 내용 그대로 새 파일로 생성한다:
```html
<!DOCTYPE html>
<html xmlns:th="http://www.thymeleaf.org" xmlns:layout="http://www.ultraq.net.nz/thymeleaf/layout"
layout:decorate="~{layout/base}">
<head>
<title>h-lab - 발굴</title>
</head>
<body>
<div layout:fragment="content">
<header class="mb-4">
<h1 class="text-2xl font-bold mb-2">발굴 (Discovery)</h1>
<p class="text-muted">수집한 영상 중 재가공할 떡상 후보를 빠르게 골라냅니다. (제외 처리한 영상은 숨겨집니다)</p>
</header>
<!-- 필터 바 -->
<div class="card mb-4">
<div style="display:flex; flex-wrap:wrap; gap:16px; align-items:flex-end;">
<div style="display:flex; flex-direction:column; gap:4px; min-width:120px;">
<label class="text-sm text-muted">기간</label>
<select id="fPeriod" onchange="loadVideos()" class="filter-sel">
<option value="">전체</option>
<option value="7">최근 7일</option>
<option value="14">최근 14일</option>
<option value="30">최근 30일</option>
</select>
</div>
<div style="display:flex; flex-direction:column; gap:4px; min-width:120px;">
<label class="text-sm text-muted">최소 배율</label>
<select id="fMinRatio" onchange="loadVideos()" class="filter-sel">
<option value="">전체</option>
<option value="2">≥ 2x</option>
<option value="3">≥ 3x</option>
<option value="5">≥ 5x</option>
</select>
</div>
<div style="display:flex; flex-direction:column; gap:4px; min-width:120px;">
<label class="text-sm text-muted">출처</label>
<select id="fSource" onchange="loadVideos()" class="filter-sel">
<option value="">전체</option>
<option value="CHANNEL">채널 수집</option>
<option value="SEARCH">검색 수집</option>
</select>
</div>
<div style="display:flex; flex-direction:column; gap:4px; min-width:160px;">
<label class="text-sm text-muted">정렬</label>
<select id="fSort" onchange="loadVideos()" class="filter-sel">
<option value="viewsPerSubRatio">배율(조회/구독) ↓</option>
<option value="viewsPerHour">시간당 조회수 ↓</option>
<option value="viewCount">조회수 ↓</option>
<option value="publishedAt">최신순 ↓</option>
</select>
</div>
<label class="flex items-center gap-2 cursor-pointer" style="height:42px;">
<input type="checkbox" id="fShorts" onchange="loadVideos()"> <span class="text-sm">Shorts만</span>
</label>
<label class="flex items-center gap-2 cursor-pointer" style="height:42px;">
<input type="checkbox" id="fUnprocessed" onchange="loadVideos()"> <span class="text-sm">미처리만(NEW/검토중)</span>
</label>
<button class="btn btn-secondary px-4 py-2 flex items-center gap-1" onclick="loadVideos()">
<i data-lucide="refresh-cw" style="width:16px;"></i> 새로고침
</button>
<span id="resultCount" class="text-sm text-muted" style="margin-left:auto; height:42px; display:flex; align-items:center;"></span>
</div>
</div>
<!-- 결과 테이블 -->
<div class="card p-0" style="overflow-x:auto;">
<table class="w-full" style="border-collapse:collapse; text-align:left;">
<thead style="background:rgba(255,255,255,0.02); border-bottom:1px solid var(--glass-border);">
<tr>
<th class="p-3 text-sm font-bold text-muted">썸네일</th>
<th class="p-3 text-sm font-bold text-muted">제목</th>
<th class="p-3 text-sm font-bold text-muted">채널</th>
<th class="p-3 text-sm font-bold text-muted">구독자</th>
<th class="p-3 text-sm font-bold text-muted">조회수</th>
<th class="p-3 text-sm font-bold text-muted">시간당</th>
<th class="p-3 text-sm font-bold text-muted">배율</th>
<th class="p-3 text-sm font-bold text-muted">업로드</th>
<th class="p-3 text-sm font-bold text-muted">상태</th>
<th class="p-3 text-sm font-bold text-muted">관리</th>
</tr>
</thead>
<tbody id="resultBody">
<tr><td colspan="10" class="p-8 text-center text-muted">로딩 중...</td></tr>
</tbody>
</table>
</div>
<!-- 영상 모달 -->
<div id="videoModal" style="display:none; position:fixed; z-index:1000; left:0; top:0; width:100%; height:100%; background:rgba(0,0,0,0.85); align-items:center; justify-content:center;" onclick="if(event.target===this) closeVideoModal()">
<div style="position:relative; width:95%; max-width:900px; background:var(--glass-bg,#1e1e2d); border-radius:12px; padding:16px; border:1px solid var(--glass-border);">
<div style="display:flex; justify-content:space-between; align-items:center; margin-bottom:12px;">
<h3 class="text-lg font-bold truncate pr-4" id="modalTitle">Video</h3>
<button onclick="closeVideoModal()" class="text-muted hover:text-white" style="font-size:28px; line-height:1; background:none; border:none; cursor:pointer;">&times;</button>
</div>
<div id="iframeContainer" style="width:100%; aspect-ratio:9/16; max-height:70vh; border-radius:8px; overflow:hidden; background:#000; margin:0 auto;"></div>
</div>
</div>
<style>
.filter-sel { padding:8px; height:42px; background:rgba(255,255,255,0.05); border:1px solid var(--glass-border); border-radius:var(--radius-md); color:white; outline:none; }
.filter-sel option { background:#1e1e2d; color:white; }
.row-sel { padding:4px 6px; background:rgba(255,255,255,0.05); border:1px solid var(--glass-border); border-radius:6px; color:white; font-size:0.8rem; outline:none; }
.row-sel option { background:#1e1e2d; color:white; }
</style>
<script th:inline="javascript">
/*<![CDATA[*/
const API = '/api/v1/channel-videos';
const STATUS_LABEL = { NEW:'NEW', REVIEWING:'검토중', TARGET:'작업대상', DONE:'완료', EXCLUDED:'제외' };
const STATUS_KEYS = ['NEW','REVIEWING','TARGET','DONE','EXCLUDED'];
function esc(s){ return (s==null?'':String(s)).replace(/&/g,'&amp;').replace(/</g,'&lt;').replace(/>/g,'&gt;').replace(/"/g,'&quot;'); }
function fmt(n){ return (n==null) ? '-' : Number(n).toLocaleString(); }
function fmtDate(s){ return s ? String(s).substring(0,10) : '-'; }
async function api(url, opts){
const res = await fetch(url, opts);
const json = await res.json().catch(()=>({}));
if(!res.ok || (json && json.success===false)) throw new Error((json && json.message) || ('HTTP '+res.status));
return json.data;
}
async function loadVideos(){
const body = document.getElementById('resultBody');
body.innerHTML = '<tr><td colspan="10" class="p-8 text-center text-muted">로딩 중...</td></tr>';
const p = new URLSearchParams();
const period = document.getElementById('fPeriod').value;
const minRatio = document.getElementById('fMinRatio').value;
const src = document.getElementById('fSource').value;
if(period) p.set('periodDays', period);
if(minRatio) p.set('minRatio', minRatio);
if(src) p.set('source', src);
if(document.getElementById('fShorts').checked) p.set('shortsOnly','true');
if(document.getElementById('fUnprocessed').checked) p.set('unprocessedOnly','true');
p.set('sortBy', document.getElementById('fSort').value);
p.set('limit', '100');
let data;
try { data = await api(API + '/discover?' + p.toString()); }
catch(e){
body.innerHTML = '<tr><td colspan="10" class="p-8 text-center text-danger">불러오기 실패: '+esc(e.message)+'</td></tr>';
return;
}
renderRows(data || []);
}
function ratioBadge(r){
if(r==null) return '<span class="text-muted">-</span>';
const v = Number(r);
let color = '#10b981';
if(v>=10) color = '#ef4444'; else if(v>=2) color = '#f59e0b';
return `<span style="color:${color}; font-weight:bold;">${v.toFixed(1)}x</span>`;
}
function renderRows(list){
const body = document.getElementById('resultBody');
document.getElementById('resultCount').textContent = list.length + '건';
if(list.length===0){
body.innerHTML = '<tr><td colspan="10" class="p-8 text-center text-muted">조건에 맞는 발굴 후보가 없습니다.</td></tr>';
return;
}
body.innerHTML = list.map(v=>{
const statusOpts = STATUS_KEYS.map(k=>
`<option value="${k}" ${v.interestStatus===k?'selected':''}>${STATUS_LABEL[k]}</option>`).join('');
const star = v.bookmarked ? '#f59e0b' : 'var(--text-muted)';
const shortsBadge = v.isShorts ? '<span style="font-size:0.65rem; background:#7C3AED33; color:#a78bfa; padding:1px 5px; border-radius:4px; margin-left:4px;">Shorts</span>' : '';
return `<tr style="border-bottom:1px solid var(--glass-border);">
<td class="p-3">
<div style="position:relative; cursor:pointer; width:96px;" data-vid="${v.videoId}" data-title="${esc(v.title)}" onclick="openVideoModal(this.dataset.vid, this.dataset.title)">
<img src="${esc(v.thumbnailUrl)}" style="width:96px; height:54px; object-fit:cover; border-radius:6px;">
</div>
</td>
<td class="p-3" style="max-width:280px;">
<div class="font-bold text-sm" style="display:-webkit-box; -webkit-line-clamp:2; -webkit-box-orient:vertical; overflow:hidden;">
<a href="https://www.youtube.com/watch?v=${v.videoId}" target="_blank" class="hover:underline text-white">${esc(v.title)}</a>${shortsBadge}
</div>
</td>
<td class="p-3 text-sm text-muted" style="max-width:130px;">
<a href="${v.ytChannelId?('https://www.youtube.com/channel/'+v.ytChannelId):'#'}" target="_blank" class="hover:underline truncate" style="color:#e2e8f0;">${esc(v.channelTitle||'-')}</a>
</td>
<td class="p-3 text-sm">${fmt(v.subscriberCount)}</td>
<td class="p-3 text-sm">${fmt(v.viewCount)}</td>
<td class="p-3 text-sm">${fmt(v.viewsPerHour)}</td>
<td class="p-3 text-sm">${ratioBadge(v.viewsPerSubRatio)}</td>
<td class="p-3 text-sm text-muted">${fmtDate(v.publishedAt)}</td>
<td class="p-3"><select class="row-sel" onchange="setStatus(${v.id}, this.value)">${statusOpts}</select></td>
<td class="p-3">
<div class="flex items-center gap-1">
<a class="btn btn-primary p-2" title="재가공" href="/rework/${v.id}"><i data-lucide="wand-2" style="width:15px;"></i></a>
<button class="btn btn-secondary p-2" title="북마크" onclick="toggleBookmark(${v.id}, ${!!v.bookmarked})"><i data-lucide="star" style="width:15px; color:${star};"></i></button>
</div>
</td>
</tr>`;
}).join('');
if(window.lucide) lucide.createIcons();
}
async function setStatus(id, value){
try { await api(API+'/'+id+'/status', {method:'POST', headers:{'Content-Type':'application/json'}, body:JSON.stringify({status:value})}); }
catch(e){ alert('상태 변경 실패: '+e.message); }
}
async function toggleBookmark(id, current){
try { await api(API+'/'+id+'/bookmark', {method:'POST', headers:{'Content-Type':'application/json'}, body:JSON.stringify({bookmarked: !current})}); loadVideos(); }
catch(e){ alert('북마크 실패: '+e.message); }
}
function openVideoModal(vid, title){
document.getElementById('modalTitle').textContent = title;
document.getElementById('iframeContainer').innerHTML = '<iframe width="100%" height="100%" src="https://www.youtube.com/embed/'+vid+'?autoplay=1" frameborder="0" allow="autoplay; encrypted-media" allowfullscreen></iframe>';
document.getElementById('videoModal').style.display = 'flex';
}
function closeVideoModal(){
document.getElementById('iframeContainer').innerHTML = '';
document.getElementById('videoModal').style.display = 'none';
}
loadVideos();
/*]]>*/
</script>
</div>
</body>
</html>
```
- [ ] **Step 2: 커밋**
```bash
git add src/main/resources/templates/discover.html
git commit -m "feat(discover): add discovery page template"
```
---
## Task 6: 사이드바 링크
**Files:**
- Modify: `src/main/resources/templates/layout/sidebar.html`
- [ ] **Step 1: "발굴" 네비 항목 추가**
"수집함" `<li>`(닫는 `</li>`)와 "보드" `<li>` 사이에 아래 블록을 삽입한다:
```html
<li>
<a th:href="@{/discover}" class="nav-item"
th:classappend="${currentPage == 'discover'} ? 'active'">
<i data-lucide="radar" class="nav-icon"></i>
<span class="nav-text">발굴</span>
</a>
</li>
```
- [ ] **Step 2: 커밋**
```bash
git add src/main/resources/templates/layout/sidebar.html
git commit -m "feat(discover): add sidebar nav link"
```
---
## Task 7: 통합 검증 (기동 + 수동 확인)
**Files:** 없음 (검증 전용)
- [ ] **Step 1: 클린 컴파일**
Run: `$env:JAVA_HOME="D:\Development\app\JDK\jdk-21.0.5"; .\gradlew.bat clean compileJava --console=plain`
Expected: `BUILD SUCCESSFUL`.
- [ ] **Step 2: 기동 확인 (포트 8088 점유 시 기존 인스턴스 종료 후)**
Run: `$env:JAVA_HOME="D:\Development\app\JDK\jdk-21.0.5"; .\gradlew.bat bootRun --console=plain`
Expected: 로그에 `Started HLabApplication` 또는 최소한 `Tomcat started on port 8088` / `JPA EntityManagerFactory` 정상. 빈 에러(`UnsatisfiedDependency`, `BeanCreationException`) 없음.
(이미 8088을 다른 인스턴스가 점유 중이면 그 프로세스가 곧 새 코드로 재기동되었는지 확인하거나, 점유 인스턴스를 종료 후 재기동.)
- [ ] **Step 3: 수동 확인 (브라우저)**
1. `http://localhost:8088/discover` 접속 → 사이드바 "발굴" active, 진입 즉시 배율 내림차순으로 영상 표시.
2. 기간/최소배율/출처/Shorts/미처리만/정렬 변경 시 목록 갱신 확인.
3. 행에서 상태 드롭다운 변경 → 새로고침해도 유지(저장 확인). 북마크 토글 → 별 색 변경. 🪄 재가공 클릭 → `/rework/{id}` 이동. 썸네일 클릭 → 모달 재생.
4. EXCLUDED 로 바꾼 영상이 새로고침 후 목록에서 사라지는지 확인.
5. (선택) Swagger `http://localhost:8088/swagger-ui.html` 에서 `/api/v1/channel-videos/discover` 응답 확인.
- [ ] **Step 4: (이상 없으면) 마무리 커밋 / 정리**
추가 변경이 없으면 커밋할 것 없음. 기동 로그 파일 등 임시 산출물은 `build/`(gitignore) 에 두거나 삭제.
---
## Self-Review 결과
- **스펙 커버리지:** 백엔드(쿼리 T1 / 서비스 T2 / 엔드포인트 T3), 프런트(라우트 T4 / 페이지 T5 / 사이드바 T6), 검증(T7) — 스펙의 5개 컴포넌트 + 기본값 + 에러/빈 상태 + 검증방법 모두 태스크에 매핑됨.
- **기본값 일치:** 서비스 기본 sortField=`viewsPerSubRatio`, UI 기본 정렬 옵션도 `viewsPerSubRatio` 첫번째. unprocessed/shorts 기본 off, 기간/배율 기본 전체 — 스펙과 일치.
- **타입/시그니처 일치:** `discover` 시그니처가 Controller→Service→Repository 3계층에서 동일(파라미터 순서: periodDays/minRatio/shortsOnly/source/unprocessedOnly/sortBy/limit → 서비스 → publishedAfter/minRatio/source/shortsOnly/unprocessedOnly/Pageable). `EXCLUDED` 제외는 Repository에서 처리. `ALLOWED_SORT`/`Sort`/`StringUtils` 는 서비스에 이미 존재.
- **플레이스홀더:** 없음(모든 스텝에 실제 코드/명령 포함).
- **null 정렬:** `Sort.Order.desc(field).nullsLast()` 로 배율 null 행이 상단에 뜨지 않게 처리(Postgres 기본 NULLS FIRST 회피).
Reference in New Issue View Git Blame Copy Permalink