zenn/sori.studio
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

관리자 글 목록 API 응답 경량화

Browse Source
This commit is contained in:
zenn
2026-07-03 10:55:11 +09:00
parent 3f80bbb4ea
commit 94782d5873
12 changed files with 158 additions and 42 deletions
Download Patch File Download Diff File Expand all files Collapse all files

6
docs/history.md
View File

@@ -1,5 +1,11 @@
# 의사결정 이력
## 2026-07-03 v1.10.22 — 관리자 글 목록은 본문 없는 요약 응답을 쓴다
관리자 글 목록은 제목, 상태, 태그, 조회수, 발행일, 썸네일만 빠르게 훑는 화면이다. 게시물 본문 전체를 함께 내려주면 글 수가 늘수록 목록 진입 payload가 본문 길이에 비례해 커지고, 이미지 마크다운이 많은 글에서는 관리 화면 로딩에도 영향을 준다. 따라서 `/admin/api/posts`는 목록 요약 필드만 반환하고, 상세 편집 화면은 기존 `/admin/api/posts/:id`에서 본문을 계속 조회한다.
기존 목록의 추천 토글은 전체 게시물 수정 API에 목록 데이터를 다시 조립해 보내는 구조였다. 목록 응답에서 본문을 제외하면 이 방식은 본문을 빈 값으로 덮어쓸 위험이 있으므로, 추천 상태만 바꾸는 `/admin/api/posts/:id/featured` 전용 API로 분리한다. 목록 검색은 더 이상 본문 전문 검색이 아니라 제목·슬러그·요약·태그 기준으로 유지하고, 본문 검색 고도화는 공개 통합 검색 인덱스 개선 과제와 별도로 다룬다.
## 2026-07-03 v1.10.21 — 관리자 글 목록 필터는 태그 증가를 전제로 한다
관리자 글 목록의 상태·추천·정렬 필터는 선택지가 고정되어 있어 기본 select로 충분하지만, 태그는 운영이 길어질수록 계속 늘어난다. 태그 전체를 네이티브 select에 한 줄로 누적하면 탐색성과 키보드 검색성이 떨어지므로, 글 목록 태그 필터는 검색형 combobox로 바꾸고 현재 사용 중인 태그만 후보로 보여 준다. 검색어가 없으면 전체 태그 옵션과 기존 정렬된 태그 목록을 보여 주고, 입력 중에는 태그명·슬러그 기준으로 좁힌다.