Skip to content

Conversation

@kickbelldev
Copy link
Owner

Summary

  • API 레이어에서 엔티티 기반 아키텍처로 전환
  • graphology 라이브러리를 활용한 그래프 기반 태그 분석 시스템 구현
  • Vitest 테스트 프레임워크 도입 및 98%+ 커버리지 달성
  • 포스트와 태그 간의 관계 분석 및 클러스터링 알고리즘 적용

주요 변경사항

  • 엔티티 아키텍처: src/entities/ 디렉토리 구조로 도메인 로직 분리
  • 그래프 기반 태그 시스템: 태그 간 공동 출현 관계 분석 및 클러스터링
  • 포괄적인 테스트: 단위 테스트, 통합 테스트, 타입 검증 테스트 포함
  • 타입 안정성: TypeScript 인터페이스 및 그래프 타입 정의

기술 스택

  • graphology: 그래프 구조 및 알고리즘 처리
  • Vitest: 테스트 프레임워크 및 커버리지 도구
  • TypeScript: 타입 안정성 및 인터페이스 정의

Test Coverage

  • Posts 엔티티: 100% 커버리지
  • Tags 엔티티: 98%+ 커버리지
  • 통합 테스트: 엔티티 간 상호작용 검증
  • 타입 테스트: 인터페이스 구조 검증

체크리스트

  • 엔티티 기반 아키텍처 구현
  • 그래프 기반 태그 관계 분석 구현
  • 태그 클러스터링 알고리즘 구현
  • 포괄적인 테스트 스위트 작성
  • 타입 안정성 확보
  • 코드 품질 검사 통과

🤖 Generated with Claude Code

kickbelldev and others added 12 commits July 14, 2025 23:01
- remark-frontmatter: MDX frontmatter 파싱 지원
- remark-mdx-frontmatter: MDX 컴포넌트에서 frontmatter 사용 가능
- next.config.ts에 remarkPlugins 설정 추가
- package.json에 필요한 의존성 추가

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <[email protected]>
- src/entities/posts/ 엔티티 추가
  - index.ts: 게시물 관련 비즈니스 로직
  - types.ts: 게시물 타입 정의
- src/api/posts.ts 삭제하여 도메인 로직 분리
- 블로그 페이지에서 새로운 엔티티 import 경로 적용

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <[email protected]>
- 도메인 엔티티 기반 아키텍처
- 컨텐츠 관리 섹션 수정

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <[email protected]>
- Vitest 테스트 프레임워크 추가
- @vitest/ui 및 @vitest/coverage-v8 커버리지 도구 설정
- 엔티티 테스트를 위한 테스트 스크립트 추가
- src/entities/** 파일 커버리지 타겟 설정

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <[email protected]>
- getAllPosts, getPostBySlug, getPostsByTag 함수 테스트
- 파일 시스템 mocking 및 gray-matter 파싱 테스트
- 에러 처리 및 엣지 케이스 테스트 포함
- 빈 디렉토리, 잘못된 날짜 형식 등 예외 상황 검증

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <[email protected]>
- getAllTags, getTagByName, getTagGraph, getTagRelationships 함수 테스트
- graphology 기반 그래프 구조 검증
- 태그 공동 출현 분석 및 관계 계산 테스트
- 클러스터링 알고리즘 및 중심성 계산 테스트
- 통계 분석 및 에지 케이스 검증 포함

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <[email protected]>
- Posts와 Tags 엔티티 간의 통합 테스트 구현
- 실제 블로그 데이터 시뮬레이션 시나리오 테스트
- 타입 인터페이스 구조 검증 테스트
- 테스트 환경 설정 파일 추가
- 엔티티 간 상호작용 및 데이터 흐름 검증

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <[email protected]>
- graphology 라이브러리를 이용한 태그 그래프 구조 구현
- 태그 공동 출현 관계 분석 및 유사도 계산
- 중심성 기반 태그 클러스터링 알고리즘
- 태그 통계 분석 기능 (most used, least used, average)
- TypeScript 타입 정의 및 인터페이스 구현
- UndirectedGraph 타입을 활용한 태그 그래프 정의

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <[email protected]>
- 프로젝트 VSCode 설정에서 eslint 동작 방지
-  CLAUDE.md에 개발 중 불필요한 개벌서버 실행 방지 지침 추가
- types.ts 파일 테스트 방지

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <[email protected]>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants