brain_dogfood/docs/features.md

💎 핵심 기능 가이드 (v1.5)

본 문서는 뇌사료 프로젝트를 상징하는 핵심 기능들인 지식 시각화, 암호화, 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) 방식으로 본문을 암호화합니다.
• 미디어 실드: 모든 첨부파일은 서버 마스터 키로 암호화되어 저장됩니다. 암호화된 메모의 이미지는 로그인된 세션에서만 정밀하게 렌더링을 허용하여 데이터 유출을 원천 차단합니다.

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

3.1 자동 추출 및 요약

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

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

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

• 자동 링크: 본문에 [[#12]]와 같이 입력하면 뷰어에서 클릭 가능한 링크로 변환되며, 지식 맵 상에서 두 노드 사이에 강력한 실선이 형성됩니다.
• 역방향 추적 (Backlinks): 특정 메모 카드 하단에 해당 메모를 인용 중인 다른 메모의 목록이 노출되어, 지식의 흐름을 양방향으로 추적할 수 있습니다.

🌡️ 5. 지식 성장 히트맵 (Intellectual Growth Heatmap)

• 활동 시각화: 최근 365일간의 활동량을 GitHub 스타일의 그리드로 시각화하여 지식 축적의 꾸준함을 독려합니다.
• 동적 범위 필터링: 사용자의 필요에 따라 1개월 / 3개월 / 6개월 / 1년 단위를 자유롭게 선택하여 볼 수 있습니다.

🎨 6. 확장된 에디터 스타일링 (Enhanced Editor)

• 컬러 텍스트 (Color Syntax): Toast UI Editor의 컬러 신택스 플러그인을 통합하여, 중요 키워드를 다양한 색상으로 강조할 수 있습니다.
• V5 메타데이터 쉴드: 정밀한 정규식 엔진을 도입하여 메모 하단의 시스템 메타데이터가 중복되거나 파손되는 것을 방지하고 항상 깔끔한 상태를 유지합니다.

⚙️ 7. 맞춤형 사용자 환경 (v1.5 신규)

• 고급 설정 (Advanced Categories): 라이트 유저를 위해 복잡한 카테고리 기능을 숨길 수 있습니다. 설정에서 활성화 시에만 작성기 칩과 사이드바 섹션이 정밀한 레이아웃으로 노출됩니다.
• 글로벌 인텔리전스 (i18n Stabilization): 한국어와 영어를 완벽하게 지원하며, 언어 설정을 변경할 경우 히트맵과 달력 등 동적 컴포넌트까지 실시간으로(자동 새로고침) 완벽하게 번역이 적용됩니다.