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]]`와 같이 입력하면 뷰어에서 클릭 가능한 링크로 변환되며, 지식 맵 상에서 두 노드 사이에 **강력한 실선**이 형성됩니다.
- **비주얼 노드 링커 (v2.0)**: 
    - **Alt + 클릭 연결**: 메모 카드의 #ID를 `Alt` 키와 함께 클릭하면 화살표 점선이 나타나며, 다른 메모의 #ID를 클릭하는 것만으로 두 지식을 논리적으로 연결합니다.
    - **드래그 앤 드롭**: 메모 카드를 작성기(Composer)로 드래그하여 떨어뜨리면 해당 메모의 링크가 커서 위치에 즉시 삽입됩니다.
    - **퀵 카피 (Quick Copy)**: #ID 배지를 클릭하는 것만으로 `[[#ID]]` 형식이 클립보드에 복사됩니다.
- **역방향 추적 (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)**: 한국어와 영어를 완벽하게 지원하며, 언어 설정을 변경할 경우 히트맵과 달력 등 동적 컴포넌트까지 실시간으로(자동 새로고침) 완벽하게 번역이 적용됩니다.

## ⚡ 8. 고속 워크플로우 (v2.0 신규)
- **즉시 수정 (Instant Edit)**: 메모 카드 위에 마우스를 올리고 `e` 키를 누르면 본문 모달을 거치지 않고 즉시 수정 모드로 진입합니다.
- **직관적 행동 분리 (Discard vs Delete)**: 
    - **작성 취소**: 현재 작업 중인 내용을 버리고 안전하게 창을 닫습니다. (기존 메모는 보존됩니다.)
    - **지식 삭제**: 수정 모드 내에서 별도의 빨간색 삭제 버튼을 통해 명시적으로 메모를 영구 제거합니다.