From f3db10f0150fd170a953b180db3ffe047a291eea Mon Sep 17 00:00:00 2001 From: zenn Date: Sat, 2 May 2026 10:02:50 +0900 Subject: [PATCH] =?UTF-8?q?=EA=B3=B5=EA=B0=9C=20=EC=83=81=EC=84=B8=20?= =?UTF-8?q?=EA=B2=BD=EB=A1=9C=EC=99=80=20=EC=83=88=20=EA=B8=80=20=EC=97=90?= =?UTF-8?q?=EB=94=94=ED=84=B0=20=EB=B3=B4=EC=A0=95?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- components/admin/AdminBlockEditor.vue | 2 +- components/site/LeftSidebar.vue | 8 ++-- components/site/RightSidebar.vue | 2 +- docs/history.md | 8 ++++ docs/map.md | 8 +++- docs/spec.md | 9 +++++ docs/todo.md | 1 + docs/update.md | 12 ++++++ package-lock.json | 4 +- package.json | 2 +- pages/admin/posts/[id].vue | 2 +- pages/admin/posts/index.vue | 2 +- pages/index.vue | 2 +- pages/post/[slug].vue | 34 ++++++++++++++++ pages/posts/[slug].vue | 32 +++------------ pages/posts/index.vue | 48 ++++++++++++++++++++++ pages/tag/[slug].vue | 57 +++++++++++++++++++++++++++ pages/tags/[slug].vue | 53 ++----------------------- pages/tags/index.vue | 45 +++++++++++++++++++++ server/utils/media-library.js | 2 +- 20 files changed, 242 insertions(+), 91 deletions(-) create mode 100644 pages/post/[slug].vue create mode 100644 pages/posts/index.vue create mode 100644 pages/tag/[slug].vue create mode 100644 pages/tags/index.vue diff --git a/components/admin/AdminBlockEditor.vue b/components/admin/AdminBlockEditor.vue index bddd31d..2af6e11 100644 --- a/components/admin/AdminBlockEditor.vue +++ b/components/admin/AdminBlockEditor.vue @@ -881,7 +881,7 @@ watch(() => props.modelValue, (value) => { const currentValue = serializeBlocks() - if (value === currentValue) { + if (value === currentValue && editorBlocks.value.length) { return } diff --git a/components/site/LeftSidebar.vue b/components/site/LeftSidebar.vue index 9729b38..f43bf24 100644 --- a/components/site/LeftSidebar.vue +++ b/components/site/LeftSidebar.vue @@ -13,16 +13,16 @@ const { data: tags } = await useFetch('/api/tags', { Home pages ⌄ - + Tags Authors - + Style - + Post types ⌄ @@ -46,7 +46,7 @@ const { data: tags } = await useFetch('/api/tags', { v-for="tag in tags" :key="tag.id" class="left-sidebar__category flex items-center gap-3" - :to="`/tags/${tag.slug}`" + :to="`/tag/${tag.slug}`" > {{ tag.name }} diff --git a/components/site/RightSidebar.vue b/components/site/RightSidebar.vue index 41a4e0c..ac32b20 100644 --- a/components/site/RightSidebar.vue +++ b/components/site/RightSidebar.vue @@ -44,7 +44,7 @@ ↗
- + sori.studio 첫 글과 방향 diff --git a/docs/history.md b/docs/history.md index f799e84..45f5fee 100644 --- a/docs/history.md +++ b/docs/history.md @@ -1,5 +1,13 @@ # 의사결정 이력 +## 2026-05-02 v0.0.18 + +### 공개 URL 복수형/단수형 기준 결정 + +게시물과 태그의 전체 목록은 컬렉션이므로 `/posts`, `/tags` 복수형을 사용한다. 개별 게시물과 특정 태그 상세는 하나의 리소스를 가리키므로 `/post/:slug`, `/tag/:slug` 단수형을 기준 경로로 정한다. + +기존에 사용하던 `/posts/:slug`, `/tags/:slug`는 외부 링크나 기존 이동 흐름이 깨지지 않도록 새 단수형 경로로 리다이렉트한다. 관리자 API와 관리자 화면 경로는 내부 관리 리소스 컬렉션이므로 기존 `/admin/posts/:id`, `/admin/tags/:id`를 유지한다. + ## 2026-05-02 v0.0.17 ### 대표 이미지와 미디어 화면 밀도 개선 결정 diff --git a/docs/map.md b/docs/map.md index 45f96c1..3316719 100644 --- a/docs/map.md +++ b/docs/map.md @@ -71,8 +71,12 @@ | 파일 | 화면 | |------|------| | pages/index.vue | 홈 | -| pages/posts/[slug].vue | 블로그 글 상세 | -| pages/tags/[slug].vue | 태그별 글 목록 | +| pages/posts/index.vue | 게시물 전체 목록 | +| pages/posts/[slug].vue | `/post/:slug` 리다이렉트 | +| pages/post/[slug].vue | 블로그 글 상세 | +| pages/tags/index.vue | 태그 전체 목록 | +| pages/tags/[slug].vue | `/tag/:slug` 리다이렉트 | +| pages/tag/[slug].vue | 태그별 글 목록 | | pages/pages/[slug].vue | 고정 페이지 상세 | ## 서버 API diff --git a/docs/spec.md b/docs/spec.md index 1530d66..717e1d2 100644 --- a/docs/spec.md +++ b/docs/spec.md @@ -48,6 +48,14 @@ - 헤더와 사이드바를 사용하지 않고 본문 중심 전체 화면으로 표시 - 진입 경로는 추후 메뉴/링크 설정을 통해 연결 +### 공개 URL 구조 + +- `/posts` - 게시물 전체 목록 +- `/post/:slug` - 개별 게시물 상세 +- `/tags` - 태그 전체 목록 +- `/tag/:slug` - 태그별 게시물 목록 +- 기존 `/posts/:slug`, `/tags/:slug` 상세 경로는 새 단수형 상세 경로로 리다이렉트한다. + ### 레이아웃 파일 ``` @@ -217,6 +225,7 @@ components/content/ - 빈 블록 placeholder는 현재 활성 블록 또는 첫 빈 블록에만 표시한다. - 제목은 별도 라벨 영역이 아니라 에디터 상단의 큰 제목 입력으로 표시한다. - 제목 입력에서 Enter를 누르면 본문 첫 블록으로 포커스를 이동한다. +- 새 글 작성처럼 본문이 비어 있는 경우에도 빈 문단 블록을 먼저 생성한다. - 관리자 글 에디터의 실제 입력 텍스트 색상은 placeholder보다 진하게 표시한다. - 관리자 작성 화면과 공개 본문은 같은 마크다운 렌더링 기준을 사용한다. - 대표 이미지는 URL 직접 입력이 아니라 미디어 선택 또는 새 이미지 업로드로 설정한다. diff --git a/docs/todo.md b/docs/todo.md index f973061..3c41146 100644 --- a/docs/todo.md +++ b/docs/todo.md @@ -3,6 +3,7 @@ ## 1차 관리자 개발 - [ ] 블록 에디터 브라우저 수동 QA: 빈 줄 Enter, `/` 메뉴 필터, 방향키, Enter 선택, 한글 조합 입력 확인 +- [ ] 공개 URL 수동 QA: `/posts`, `/post/:slug`, `/tags`, `/tag/:slug`, 기존 복수형 상세 리다이렉트 확인 - [ ] 블록 에디터 저장/수정 왕복 QA: 기존 글 수정 시 블록 파싱, 저장 후 다시 열기 확인 - [ ] 이미지/갤러리 블록 브라우저 수동 QA: 업로드, 너비 옵션, 저장 후 공개 렌더링, 갤러리 라이트박스 확인 - [ ] 미디어 선택 창 브라우저 수동 QA: 기존 이미지 선택, 갤러리 추가, 빈 미디어 상태 확인 diff --git a/docs/update.md b/docs/update.md index 09b8b2a..99150a5 100644 --- a/docs/update.md +++ b/docs/update.md @@ -1,5 +1,17 @@ # 업데이트 이력 +## v0.0.18 + +- 새 글 작성 화면에서 빈 본문 블록이 생성되지 않던 문제 수정. +- 공개 게시물 목록 경로 `/posts` 추가. +- 공개 게시물 상세 경로를 `/post/:slug` 기준으로 추가. +- 기존 `/posts/:slug` 상세 경로를 `/post/:slug`로 리다이렉트하도록 수정. +- 공개 태그 목록 경로 `/tags` 추가. +- 공개 태그 상세 경로를 `/tag/:slug` 기준으로 추가. +- 기존 `/tags/:slug` 상세 경로를 `/tag/:slug`로 리다이렉트하도록 수정. +- 공개 화면과 관리자 미리보기 링크를 단수형 상세 경로 기준으로 정리. +- 패키지 버전을 0.0.18로 갱신. + ## v0.0.17 - 관리자 글 작성/수정 폼의 대표 이미지 URL 직접 입력을 이미지 선택 UI로 변경. diff --git a/package-lock.json b/package-lock.json index 8ebe929..c0ed914 100644 --- a/package-lock.json +++ b/package-lock.json @@ -1,12 +1,12 @@ { "name": "sori.studio", - "version": "0.0.17", + "version": "0.0.18", "lockfileVersion": 3, "requires": true, "packages": { "": { "name": "sori.studio", - "version": "0.0.17", + "version": "0.0.18", "hasInstallScript": true, "dependencies": { "@nuxtjs/tailwindcss": "^6.14.0", diff --git a/package.json b/package.json index 69ab1ee..c1320a5 100644 --- a/package.json +++ b/package.json @@ -1,6 +1,6 @@ { "name": "sori.studio", - "version": "0.0.17", + "version": "0.0.18", "private": true, "type": "module", "scripts": { diff --git a/pages/admin/posts/[id].vue b/pages/admin/posts/[id].vue index 246ac6f..7ada29d 100644 --- a/pages/admin/posts/[id].vue +++ b/pages/admin/posts/[id].vue @@ -81,7 +81,7 @@ const deletePost = async () => { 보기 diff --git a/pages/admin/posts/index.vue b/pages/admin/posts/index.vue index 83aae51..678b161 100644 --- a/pages/admin/posts/index.vue +++ b/pages/admin/posts/index.vue @@ -92,7 +92,7 @@ const deletePost = async (post) => { {{ post.title }}

- /posts/{{ post.slug }} + /post/{{ post.slug }}

diff --git a/pages/index.vue b/pages/index.vue index d4157ef..5c25749 100644 --- a/pages/index.vue +++ b/pages/index.vue @@ -31,7 +31,7 @@ const mapPostCard = (post) => ({ excerpt: post.excerpt, tag: post.tags?.[0]?.toUpperCase() || 'POST', publishedAt: formatPostDate(post.publishedAt), - to: `/posts/${post.slug}` + to: `/post/${post.slug}` }) const postCards = computed(() => posts.value.map(mapPostCard)) diff --git a/pages/post/[slug].vue b/pages/post/[slug].vue new file mode 100644 index 0000000..2262989 --- /dev/null +++ b/pages/post/[slug].vue @@ -0,0 +1,34 @@ + + + diff --git a/pages/posts/[slug].vue b/pages/posts/[slug].vue index 2262989..4517ee9 100644 --- a/pages/posts/[slug].vue +++ b/pages/posts/[slug].vue @@ -1,34 +1,12 @@ diff --git a/pages/posts/index.vue b/pages/posts/index.vue new file mode 100644 index 0000000..cc9033f --- /dev/null +++ b/pages/posts/index.vue @@ -0,0 +1,48 @@ + + + diff --git a/pages/tag/[slug].vue b/pages/tag/[slug].vue new file mode 100644 index 0000000..01d4e99 --- /dev/null +++ b/pages/tag/[slug].vue @@ -0,0 +1,57 @@ + + + diff --git a/pages/tags/[slug].vue b/pages/tags/[slug].vue index 31f3e66..a5aacfa 100644 --- a/pages/tags/[slug].vue +++ b/pages/tags/[slug].vue @@ -1,57 +1,12 @@ diff --git a/pages/tags/index.vue b/pages/tags/index.vue new file mode 100644 index 0000000..a9e488c --- /dev/null +++ b/pages/tags/index.vue @@ -0,0 +1,45 @@ + + + diff --git a/server/utils/media-library.js b/server/utils/media-library.js index dc40034..2aefb74 100644 --- a/server/utils/media-library.js +++ b/server/utils/media-library.js @@ -132,7 +132,7 @@ const getMediaUsage = (url, posts, pages) => { title: post.title, slug: post.slug, adminUrl: `/admin/posts/${post.id}`, - publicUrl: `/posts/${post.slug}`, + publicUrl: `/post/${post.slug}`, status: post.status, ...usage })))