프론트엔드
Zettelkasten과 서비스 문서화 그리고 가슴 설레는 OKR – Hwahae network graph
두줄요약
파편화된 서비스 문서를 Zettelkasten 기반 그래프로 연결하는 HNG MVP를 구현했습니다. Strapi·Next.js·G6 선택 과정과 문서화 운영 과제를 공유합니다.
문제 상황
- 여러 도구와 참여자에 분산된 서비스·개발 문서로 인한 히스토리 및 기능 연결 관계 파악 비용
- 개인정보 사용 구간 탐색 과정에서 담당자 없는 레거시 서비스의 현황 파악 어려움
구조와 흐름
- Zettelkasten의 메모·태그·참조 개념을 화면 또는 기능 단위 문서와 프로젝트 분류에 적용
- 문서를 그래프 노드로, 문서 간 연결을 양방향 관계로 표현하는 Hwahae Network Graph 구성
- Strapi 기반 문서 작성·버전 관리와 Next.js·G6 기반 그래프 조회 분리
선택 이유
- Jamstack의 정적 페이지·CDN 제공 모델을 문서 중심 서비스 특성에 적합한 구조로 판단
- 유연한 DB·API·권한 기능과 편집 환경을 제공하는 headless CMS로 Strapi 선택
- 문서화, 커스터마이징, 예제, 다양한 레이아웃과 노드 성능을 기준으로 G6 선택
성능/운영 포인트
- G6의 ForceAtlas2 레이아웃과 대규모 노드 예제를 근거로 초기 확장성 검토
- 1.5개월간 MVP 구현 완료 후 문서 템플릿과 노드 관리 기준을 후속 과제로 설정
- Jamstack 정적 배포 미적용과 문제 해결 효과 미검증을 POC 단계의 한계로 인식
