fix: 제목에 괄호가 든 글의 이미지가 발행 때마다 지워지던 문제 수정

[Wisesaturn]

Pull Request Type

• feat: 기능 구현 (새로운 요구사항 구현, 기존 기능 개선)
• fix: 버그 수정
• refactor: 코드 리팩토링

  성능 개선, 구조 변경, 기능 수정 없을 때

• style: 포매팅, 린트 (기능 변화 없음)
• chore: 환경설정, 패키지 관리, 라이브러리 설치 등
• docs: 문서 작성

관련 이슈

closes #131

작업 내용

이미지 폴더 이름도 안전한 문자로 바꿔 저장

• 글 제목으로 만드는 이미지 폴더 이름에서 문자, 숫자, -, _ 만 남기고 나머지를 - 로 바꿉니다. 예를 들어 쌩-npm으로-MFE-구축하기-(1)-:-개념 폴더는 쌩-npm으로-MFE-구축하기-1-개념 이 됩니다.
• 제목에 괄호가 있으면 발행할 때마다 그 글의 썸네일과 본문 이미지가 모두 지워졌습니다. v3.0.3 에서 파일 이름의 괄호는 고쳤지만, 폴더 이름에 남은 괄호 때문에 남길 파일을 고르는 규칙이 경로를 폴더째 잘랐기 때문입니다.
• 이미지를 올리는 쪽과 옛 파일을 지우는 쪽이 같은 함수로 폴더를 만들게 해 둘이 다른 폴더를 보지 않게 했습니다. 글 주소와 문서 id 로 쓰는 제목은 바꾸지 않았습니다.
• 파일 이름과 폴더 이름이 같은 정리 규칙을 씁니다. 공백을 - 로 바꾼 제목에서 - 가 여럿 이어지지 않도록 하나로 합칩니다.

검증

• spec 10건 추가(toSafePathSegment 7건, getStorageFolder 3건). pnpm test 321건, pnpm typecheck, eslint 통과
• 올린 파일 주소에서 getStoragePaths 가 꺼낸 경로가 실제 경로와 같은지 MFE 글의 제목으로 확인합니다
• 머지와 배포 뒤 MFE 글을 다시 발행해 썸네일 주소가 200 을 돌려주는지 확인합니다
• 괄호가 든 옛 폴더는 지워지지 않고 남습니다

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated
blog	Ready	Preview	Sep 27, 2026 9:16am UTC

[Wisesaturn]

Code Review

Found 1 issue:

1. [!NOTE]
   P4. uploadImage.ts 를 고쳤는데 JSDoc 이 아직 @summary 다 (.claude/rules/jsdoc.md says "기존 파일을 고칠 때 그 파일의 @summary 를 함께 바꾼다")

   blog/src/features/publish/api/uploadImage.ts

   Lines 15 to 19 in 939fa97

   	/**
   	* @summary firebase에 image를 업로드하는 함수
   	* @param props
   	* @returns
   	*/

   blog/.claude/rules/jsdoc.md

   Lines 1 to 4 in 939fa97

   	---
   	paths:
   	- '**/*.ts'
   	- '**/*.tsx'

그 밖에 CLAUDE.md 와 .claude/rules/ 준수, 변경 라인 버그, git 이력(#104, #129)과의 정합, 이전 PR(#105, #130) 리뷰 코멘트, 주석과 @example 의 정확성을 확인했고 문제는 없었다. 세 발행 라우트와 create*.ts 가 uploadImage 와 deleteStore 에 같은 값을 넘기므로 두 쪽의 폴더가 어긋나지 않는다.

참고: 같은 카테고리에서 문장 부호만 다른 두 제목(X (1) 과 X 1)은 문서 id 는 다르지만 Storage 폴더가 같아져, 한쪽을 발행하면 다른 쪽 이미지가 지워질 수 있다. 지금 운영 문서에는 해당 사례가 없다.