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]])

메모 간의 명시적인 지식을 연결하려면 본문에 샵(#) 기호와 메모 번호를 사용하세요.

• 효과: 뷰어에서 클릭 시 해당 메모로 바로 이동하며, 지식 네뷸라 상에 강력한 연결선이 형성됩니다.

3.2 컬러 텍스트 (Color Syntax)

에디터 툴바의 색상 아이콘으로 지식의 가독성을 높입니다.

3.3 V5 메타데이터 쉴드

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

---

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

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

4.1 고급 설정 (카테고리 활성화)

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

4.2 다국어 설정 (Language)

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

---

🔒 5. 보안 및 백업

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

---

🚀 6. 운영 및 관리 (Ops)

• deploy.py: 개발 환경의 코드를 서버로 안전하게 배포합니다.
• backup.py: 서버의 핵심 데이터를 정기적으로 백업합니다.

---

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