← 화면 목록

수강후기

REVIEW-STY-LIST · /review/sty-list

실제 화면 열기 ↗
기능
3
API 호출
1
가드레일
1
id 가 테스트 이름
구현 단계
5 / 5
완료커뮤니티 →wvctesol-api :8080서버 컴포넌트26줄

개발 스펙

이 화면에서 할 수 있어야 하는 것 (1)

  • 수강후기 목록을 본다(659건).

비즈니스 규칙 (2)

  • story 테이블을 쓴다. 합격수기와 컬럼 구성이 거의 같다.
  • 상세를 열면 조회수가 1 오른다.
    근거: sty_view.php:18

API (1)

메서드경로권한모듈 · 설명
GET/api/community/reviews공개
수강후기 목록.
domains:community:community-web

가드레일 (1) — id 가 곧 테스트 이름이다

id반드시 만족해야 하는 것등급
review-list-loads
목록이 페이징과 함께 정상 조회돼야 한다.
normal

구현 계획 (5/5)

  1. ●BoardType · BoardSort · BoardPost · BoardRepositorycommunity-domain
  2. ●BoardQueryUseCase — 목록·상세 공용community-app
  3. ●BoardTable · BoardRepositoryAdaptercommunity-infrastructure
  4. ●/api/community/reviews 구현community-web
  5. ●Next.js 를 BFF 로 전환 — Prisma 직접 접근 제거wvctesol

서버 사이드 구현 계획 — 자바 객체별 요구사항 (5/5)

객체모듈책임 · 지켜야 할 것
● BoardType
enum
community-domain
게시판 종류.
  • 경로로 받은 문자열은 이 열거형으로만 해석한다 — 임의 값이 테이블 이름이 되지 않는다.
  • 알 수 없는 값은 400 INVALID_BOARD.
● BoardSort
enum
community-domain
정렬 기준. 열거형이 곧 화이트리스트다.
  • 원본은 정렬 문자열을 order by 에 그대로 붙였다. 여기서는 문자열이 SQL 로 흘러갈 길 자체를 없앤다.
  • 알 수 없는 값은 오류가 아니라 조용히 기본 정렬로 되돌린다.
● BoardTable
record
community-infrastructure
게시판별 테이블·컬럼 차이를 모아 둔 곳.
  • 노출 플래그 이름이 제각각이고 값도 대소문자가 섞여 있다(pass_note 는 Y/N, faq 는 y/n) — upper() 로 맞춘다.
  • 공지만 고정 컬럼이, 수기·후기만 이미지가, Q&A 만 답변이 있다.
  • SQL 에 들어가는 식별자는 이 레코드가 정한 값뿐이다.
● BoardRepositoryAdapter
class
community-infrastructure
다섯 테이블을 하나의 포트로 조회.
  • 구조가 거의 같아 엔티티를 다섯 벌 만들지 않고 네이티브 쿼리로 묶었다.
  • 검색어는 반드시 바인딩 파라미터로 넘긴다. 문자열 이어붙이기 금지.
  • 숨긴 글은 목록과 상세 양쪽에서 제외한다 — 상세만 빠뜨리면 id 로 뚫린다.
● BoardQueryUseCase
service
community-app
목록·상세 조회.
  • PageRequest 가 page 0·음수·과대를 다듬는다. 오류를 내지 않는다.
  • 상세는 조회수를 정확히 1 올린다.

테스트 방법 (1)

가드레일종류확인 방법
review-list-loadse2e후기 목록이 200 이고 항목 수가 1 이상

정하지 못한 것 · 확인이 필요한 것

  • 원본에 상세(sty_view.php)가 있으나 이관 화면에는 목록만 있다. 상세 화면이 필요한지 확인해야 한다.

스냅샷

REVIEW-STY-LIST 스냅샷

기능 목록 (3)

데이터
  • ·API 조회/api/marketing/content/review/sty-list
미디어
  • ·YouTube 영상
하드코딩
  • ·하드코딩 데이터stats

화면 이동

← 이 화면으로 오는 곳
이 화면에서 가는 곳 →

없음

연결

API
  • /api/marketing/content/review/sty-list
소스
src/app/review/sty-list/page.tsx