UUID 기반 3-File 분리 설계를 통한 Git 스토리지 최적화 및 메모리 효율 극대화

Prior Art: The data structure that shapes Thought OS

sys-ronin2026년 6월 19일9분intermediate

AI 요약

Context

단일 파일 기반 저장 구조에서 발생하는 잦은 Full-rewrite 문제와 Git 저장소의 급격한 용량 증가라는 한계점 존재. 모든 노트 수정 시 전체 파일이 갱신되어 Delta Compression 효율이 저하되고 메모리 낭비가 발생하는 구조적 병목 파악.

구조 정보(structure.json), 일반 노트(notes.json), 파일 데이터(files.json)로 데이터를 물리적으로 분리한 3-File Architecture 설계
모든 파일 간 연결 고리로 UUID를 채택하여 Content-agnostic한 참조 구조 구축
Navigation 단계에서 structure.json만 로드하여 메모리 풋프린트를 최소화하고 Content는 On-demand 방식으로 로드하는 지연 로딩 구현
변경 사항을 파일 단위로 격리하여 Git Commit 시 수정된 파일의 Delta만 기록함으로써 스토리지 점유율 최적화
UUID 기반의 독립적 매핑을 통해 특정 항목만 정밀하게 추출하는 Resurrection 및 git-filter-repo 기반의 정밀 삭제 로직 구현

실천 포인트

1. 대용량 JSON 저장 시 변경 빈도가 다른 데이터군을 별도 파일로 분리했는가

2. 데이터 간 참조 시 가변적인 경로 대신 불변의 UUID를 사용하여 연결성을 유지하고 있는가

3. 전체 데이터를 로드하지 않고도 기본 내비게이션이 가능한 최소 단위의 메타데이터 구조를 설계했는가

4. 버전 관리 시스템의 Delta 저장 특성을 고려하여 파일의 크기와 수정 범위를 최적화했는가

태그