콘텐츠로 이동

[WORKSOUT] 에디토리얼 상세

Screen ID Screen Title Screen Path
FEED-EDT-01 에디토리얼 상세 /feed/editorial/{id}

Strapi CKEditor로 작성된 에디토리얼(화보) 본문을 렌더링하는 상세 화면. 헤더, 메인 콘텐츠(더 보기 포함), 더 찾아보기 영역으로 구성된다. 뉴스 콘텐츠도 동일 화면 구조를 사용하는 것으로 보이나 원본에 명시적 확인이 없어 미결 사항에 기록한다.


요소 기준
뒤로가기 이전 화면으로 이동
제목 Strapi title, 왼쪽 정렬
하트 버튼 로그인 사용자만 사용. 탭 시 찜 상태 토글
공유 버튼 현재 상세 URL 공유, 시스템 기본 공유 사용, 성공 시 별도 피드백 없음
항목 기준
데이터 출처 Strapi CKEditor
노출 조건 displayDate 있으면 현재 시각이 기간 안, null이면 지속 노출
이미지 최적화 HTML 내 이미지 lazy loading 적용
더 보기 버튼 노출 기준 렌더링된 콘텐츠 높이 1700px 초과 시
더 보기 버튼 텍스트 {editorial title} 더 보기
더 보기 버튼 위치 전체 콘텐츠 높이 기준 약 40% 지점
전체 펼치기 탭 시 전체 본문 표시, 접기 기능 없음

관리 필드

필드명 활용 방식
title 헤더 제목 / 더 보기 버튼 텍스트
CKEditor 메인 콘텐츠 렌더링
displayDate 노출 기간 제어
thumbnailContainer 목록/추천 영역에서 활용
publishedAt Published 상태여야 노출
항목 기준
레이아웃 Masonry Grid
필터링 현재 콘텐츠와 동일한 타입, 현재 콘텐츠 제외
정렬 피드 리스트와 동일한 최신순
무한 스크롤 지원
빈 상태 문구 현재 게시물이 없습니다. (컨텐츠 정책 공통 문구: 게시물이 존재하지 않습니다도 병용되는 것으로 보임 — 미결 사항 참조)

더 찾아보기 정렬 규칙 (컨텐츠 정책 기준)

  • 에디토리얼 클릭 시: 다른 에디토리얼 또는 뉴스 콘텐츠가 최신순으로 정렬되어 표시
  • 뉴스 클릭 시: 다른 에디토리얼 또는 뉴스 콘텐츠가 최신순으로 정렬되어 표시
  • 컨텐츠가 없을 경우: 빈 상태 문구 노출

  • 엔드포인트: GET https://api.strapi-dev.entropyparadox.link/api/articles
  • 호출 시점: 에디토리얼 상세 화면 진입 시
  • 원문 명시 쿼리 파라미터:
    • pagination[page]=1, pagination[pageSize]=16
    • sort[order]=asc
    • populate[thumbnailContainer][populate]=fixThumbnail
    • populate[thumbnailContainer][populate]=HorizontalThumbnail
    • populate[thumbnailContainer][populate]=PreviewVerticalThumbnail
    • populate[thumbnailContainer][populate]=listPageThumbnail
    • populate=displayDate
    • filters[$or][0][displayDate][displayStartDate][$null]=true
    • filters[$or][0][displayDate][displayEndDate][$null]=true
    • filters[$or][1][displayDate][displayStartDate][$lte]=현재시간
    • filters[$or][1][displayDate][displayEndDate][$gte]=현재시간
  • 운영 메모: 원문에 상세 대상을 특정하는 파라미터(id, documentId, slug)가 명시되어 있지 않다. 실제 구현에서는 이 중 하나의 필터가 추가되어야 하며, 계약서를 최종 기준으로 확인해야 한다.
  • 활용 필드: CKEditor(본문 렌더링), title(헤더/더보기 버튼), displayDate(노출 기간), thumbnailContainer(썸네일 이미지 세트)

관련 콘텐츠 조회 (더 찾아보기)

섹션 제목: “관련 콘텐츠 조회 (더 찾아보기)”
  • 엔드포인트: GET /v1/contents/editorial/see-more
  • 호출 시점: 에디토리얼 상세 화면 로드 후
  • 필터링: 동일 콘텐츠 타입, 현재 콘텐츠 ID 제외, 피드와 동일한 노출 조건

증상 예상 원인 1차 조치
본문 전체 미노출 Strapi 응답 실패 / HTML 파싱 오류 콘텐츠 데이터와 API 응답 확인
더 보기 버튼 미동작 높이 측정 실패 / 펼치기 로직 오류 1700px 초과 여부와 렌더링 로그 확인
더 찾아보기 미노출 see-more API 실패 / 데이터 없음 API 응답과 필터 조건 확인
공유 실패 URL 생성 실패 / OS 공유 오류 URL 생성 단계 확인
찜하기 실패 인증 오류 / 네트워크 장애 로그인 상태와 API 응답 코드 확인

항목 내용
뉴스 상세 처리 방식 원본 마스터/정책 문서 어디에도 뉴스 전용 상세 화면 규격이 없음. 에디토리얼 상세 템플릿을 뉴스에도 그대로 재사용하는지 확인 필요
더 찾아보기 빈 상태 문구 마스터 문서(에디토리얼 상세)는 현재 게시물이 없습니다., 컨텐츠 정책 문서(더 찾아보기 공통)는 게시물이 존재하지 않습니다로 서로 다른 문구를 사용. 최신 확정 문구 확인 필요
상세 조회 API 파라미터 Strapi articles API 호출 시 특정 게시물을 지정하는 파라미터(id/documentId/slug)가 원본에 없음. 백엔드 계약서 기준으로 확인 필요