brain_dogfood/docs/features.md

💎 핵심 기능 가이드 (v13.3)

본 문서는 뇌사료 프로젝트를 상징하는 핵심 기능들인 지식 시각화, 암호화, AI 분석에 대한 상세 명세를 담고 있습니다.

🌌 1. 지식 네뷸라 (Knowledge Nebula)

D3.js v7 물리 시뮬레이션 엔진을 통해 파편화된 메모들을 유기적인 우주 성단 구조로 시각화합니다.

1.1 시각화 아키텍처

• 엔진: D3.js Force Simulation
• 성단(Constellation) 로직:
  • 그룹 인력: 같은 그룹에 속한 메모들은 서로를 끌어당겨 하나의 별무리를 형성합니다.
  • 의미론적 연결: 공통 태그를 공유하는 노드들 사이에 보이지 않는 인력을 설정하여 맥락이 유사한 지식들이 근접하게 배치됩니다.
• 인터랙션: 노드 클릭 시 상세 정보 모달이 출력되며, 마우스 호버 시 연결된 지식망이 강조(Highlight)됩니다.

🔒 2. 이중 보안 암호화 시스템 (Dual-Layer Security)

2.1 메모 및 파일 보안

• 개별 암호화: 메모마다 고유한 비밀번호를 사용하여 Fernet (AES-128 CBC/HMAC) 방식으로 본문을 암호화합니다.
• 미디어 실드 (v10.1): 모든 첨부파일은 서버 마스터 키로 암호화되어 저장됩니다. 암호화된 메모의 이미지는 로그인된 세션에서만 정밀하게 렌더링을 허용하여 데이터 유출을 원천 차단합니다.

🧠 3. Gemini AI 기반 지식 구조화 (AI Insight)

3.1 자동 추출 및 요약

• 학습된 페르소나: 최신 Gemini 2.0 Flash 모델이 메모의 맥락을 분석하여 핵심 요약과 태그를 생성합니다. (.env에서 모델 식별자를 언제든 변경할 수 있습니다.)
• 지능형 연동: AI가 생성한 태그는 지식 네뷸라 엔진의 인력 설정에 반영되어, 사용자가 명시적으로 연결하지 않아도 관련 지식끼리 우주 상에서 가까이 부유하게 됩니다.

🔗 4. 내부 링크 및 백링크 시스템

4.1 연결 문법 ([[#ID]])

• 자동 링크: 본문에 [[#12]]와 같이 입력하면 뷰어에서 클릭 가능한 링크로 변환되며, 지식 맵 상에서 두 노드 사이에 강력한 실선이 형성됩니다.
• 역방향 추적 (Backlinks): 특정 메모 카드 하단에 해당 메모를 인용 중인 다른 메모의 목록이 노출되어, 지식의 흐름을 양방향으로 추적할 수 있습니다. 27: 32: ## 🌡️ 5. 지식 성장 히트맵 (Intellectual Growth Heatmap) - v14.0 33: 34: ### 5.1 활동 시각화 35: - 기록 습관 형성: 최근 365일간의 활동량을 GitHub 스타일의 그리드로 시각화하여 지식 축적의 꾸준함을 독려합니다. 36: - 동적 범위 필터링: 사용자의 필요에 따라 1개월 / 3개월 / 6개월 / 1년 단위를 자유롭게 선택하여 볼 수 있습니다. 37: - 상태 보존: 선택한 보기 설정은 localStorage에 저장되어 재접속 시에도 유지됩니다. 38: 39: ### 5.2 지능형 히트맵 알고리즘 40: - 단계별 농도: 해당 일의 메모 작성 수에 따라 5단계(lvl-0~lvl-4)의 색상 농도가 적용됩니다. 41: - 프리미엄 그라데이션: 뇌사료 특유의 Cyan(시안)에서 Purple(보라)로 이어지는 네온 그라데이션 테마를 따릅니다. 42: 43: ## 🎨 6. 확장된 에디터 스타일링 (Enhanced Editor) 44: 45: ### 6.1 컬러 텍스트 (Color Syntax) 46: - 시각적 강조: Toast UI Editor의 컬러 신택스 플러그인을 통합하여, 본문 중 중요한 지식 키워드를 다양한 색상으로 강조할 수 있습니다. 47: - 지각적 설계: 다크 모드 환경에서도 가독성이 뛰어난 색상 팔레트를 우선적으로 제공합니다.