feat: 통합 blog entity 구조 및 SSG 최적화

[kickbelldev]

Summary

• 분리된 entities (posts, categories, tags)를 단일 blog entity로 통합
• SSG 환경에 최적화된 모듈 레벨 캐싱 구현으로 빌드 성능 개선
• 복잡한 상호 의존성 문제 해결 및 코드 아키텍처 개선

주요 변경사항

🏗️ Entity 아키텍처 개선

• 통합 구조: src/entities/blog/ 하나로 통합
• 모듈 레벨 캐싱: getAllPosts(), getAllCategories() 등 빌드 타임에 한 번만 실행
• 관심사 분리: logic/posts.ts, logic/categories.ts, logic/tags.ts로 논리적 분리
• 타입 통합: 모든 타입을 types.ts로 일원화

⚡ 성능 최적화

• SSG 최적화: 파일을 매번 읽지 않고 모듈 레벨에서 캐싱
• 태그 그래프 사전 계산: 빌드 타임에 태그 관계 및 클러스터 생성
• 관련 포스트 캐싱: 사전 계산된 클러스터 데이터 활용

🔧 코드 품질 개선

• 임포트 경로 통일: 모든 컴포넌트가 @/entities/blog 사용
• TypeScript 에러 해결: 모든 타입 에러 수정 및 일관성 보장
• 사용하지 않는 코드 제거: 불필요한 임포트 및 함수 정리

📁 컨텐츠 관리 개선

• 파일명 표준화: 한글 파일명을 영문으로 변경하여 URL 호환성 개선
• 카테고리별 분류: dev/life 카테고리 구조와 일치하도록 정리

기술적 세부사항

Before (분리된 구조)

src/entities/
├── posts/     # 포스트 관련 로직
├── categories/ # 카테고리 관련 로직  
└── tags/      # 태그 관련 로직

After (통합 구조)

src/entities/blog/
├── index.ts           # 공개 API + 모듈 레벨 캐싱
├── types.ts           # 통합 타입 정의
└── logic/
    ├── posts.ts       # 포스트 로직
    ├── categories.ts  # 카테고리 로직
    └── tags.ts        # 태그 로직

캐싱 최적화 예시

// 빌드 타임에 한 번만 실행
export const allPosts = await getAllPosts()
export const allCategories = await getAllCategories()
export const tagGraph = createTagGraph(allPosts, allTags)
export const tagClusters = createTagClusters(tagGraph)

// 런타임에는 캐시된 데이터 사용
export function getPostBySlug(slug: string): Post | null {
  return allPosts.find((post) => post.slug === slug) || null
}

Commit History

1. content: 컨텐츠 파일명 정리 및 카테고리별 분류
2. refactor: 기존 분리된 entity 구조 제거
3. feat: 통합 blog entity 구조 구현
4. refactor: 모든 컴포넌트를 통합 blog entity 사용하도록 업데이트
5. config: lefthook 설정 업데이트

Test Plan

• TypeScript 컴파일 에러 없음 (pnpm type)
• Biome 린팅/포맷팅 통과 (pnpm biome:check)
• 모든 페이지 라우팅 정상 동작 확인
• 카테고리별 포스트 필터링 동작 확인
• 태그 관련 기능 정상 동작 확인
• 관련 포스트 추천 기능 동작 확인

Breaking Changes

없음. 기존 API와 동일한 인터페이스 유지.

🤖 Generated with Claude Code