brain_dogfood/docs/user_manual.md

# 📔 뇌사료 (Brain Dogfood) 사용자 매뉴얼 (v1.5)

'뇌사료' 프로젝트에 오신 것을 환영합니다! 본 매뉴얼은 파편화된 영감을 체계적인 지식 성단(Nebula)으로 구축하는 데 필요한 모든 가이드를 제공합니다.

---

## 🌌 1. 지식 네뷸라 (시각화 탐색)

메인 전면에 펼쳐진 **지식 네뷸라**는 단순한 목록이 아닌 지식의 유기적인 지도를 보여줍니다.

- **노드(Node)**: 각각의 메모를 상징하며, 그룹 색상을 따릅니다.
- **링크(Link)**: `[[#ID]]` 문법으로 명시적으로 연결된 관계를 시선과 인력으로 표현합니다.

---

## 🌡️ 2. 지식 성장 히트맵 (Heatmap) 사용법

사이드바의 히트맵은 최근 1년간의 지식 축적 활동량을 시각적으로 보여줍니다.

- **기간 전환**: 상단 드롭다운을 통해 **1개월 / 3개월 / 6개월 / 1년** 단위를 선택할 수 있습니다.
- **언어 연동**: 시스템 언어 설정에 따라 제목과 범례("Less"/"More")가 자동으로 번역됩니다.

---

## ✍️ 3. 메모 작성 및 스타일링

### 3.1 지식 연결 및 자동화 (`[[#ID]]`)
메모 간의 명시적인 지식을 연결하는 방법은 세 가지가 있습니다.
- **비주얼 노드 링커 (Alt + 클릭)**: 메모 카드의 #ID를 `Alt` 키와 함께 누르면 선이 나타납니다. 다른 메모의 #ID를 클릭하면 자동으로 본문에 `[[#ID]]` 링크가 삽입됩니다.
- **드래그 앤 드롭 연결**: 메모 카드를 작성기(Composer)로 직접 드래그하여 원하는 위치에 놓으면 자동으로 링크가 삽입됩니다.
- **수동 입력 및 복사**: 본문에 직접 `[[#12]]`와 같이 입력하거나, 카드의 #ID를 단순 클릭하여 복제된 링크를 붙여넣으세요.
- **효과**: 뷰어에서 클릭 시 해당 메모로 바로 이동하며, 지식 네뷸라 상에 강력한 연결선이 형성됩니다.

### 3.2 컬러 텍스트 (Color Syntax)
에디터 툴바의 색상 아이콘으로 지식의 가독성을 높입니다.

### 3.3 V5 메타데이터 쉴드
시스템이 생성하는 하단 메타데이터는 자동으로 관리되므로 본문 작성에만 집중하면 됩니다.

### 3.4 고속 편집 (Instant Edit)
메어 카드 위에 마우스를 올리고 `e` 키를 누르면 본문 모달을 거치지 않고 즉시 수정 모드로 진입합니다. 작업의 흐름을 끊지 않고 빠르게 메모를 다듬을 수 있습니다.

---

## ⚙️ 4. 설정 및 커스터마이징 (v1.5 신규)

우측 상단의 **[⚙️ 설정]** 버튼을 통해 나만의 지식 환경을 구축할 수 있습니다.

### 4.1 고급 설정 (카테고리 활성화)
- **라이트 모드 (기본)**: 카테고리 기능이 숨겨져 있어 태그와 그룹만으로 심플하게 기록할 수 있습니다.
- **고급 모드**: 설정에서 **"카테고리 기능(고급) 활성화"**를 체크하면, 작성기 하단에 카테고리 선택 칩이 나타나며 사이드바에서도 카테고리별 분류가 활성화됩니다.

### 4.2 다국어 설정 (Language)
- **한국어 / English**: 선호하는 언어를 선택하고 [Save]를 누르면 즉시 전체 UI와 달력, 히트맵 등의 도구가 해당 언어로 재초기화됩니다.

---

## 🔒 5. 보안 및 백업
- **개별 암호화**: 편집기 하단 [암호화 사용]을 통해 메모를 안전하게 잠글 수 있습니다.
- **미디어 보안**: 모든 첨부파일은 서버 측 암호화를 통해 세션이 유효한 사용자에게만 안전하게 제공됩니다.

---

## 🚀 6. 운영 및 관리 (Ops)
- **`deploy.py`**: 개발 환경의 코드를 서버로 안전하게 배포합니다.
- **`backup.py`**: 서버의 핵심 데이터를 정기적으로 백업합니다.

---

**지식의 우주를 마음껏 탐험하세요!** 🛸🌌