brain_dogfood/docs/README.md

🧠 뇌사료 (Brain Dogfood) 프로젝트 문서화 (v5.0+)

"지식은 기록될 때 힘을 얻고, 연결될 때 생명을 얻는다."

본 프로젝트는 개인용 지식창고 및 메모 서버로, 보안, 지능형 연결(Nebula), 그리고 **기록의 습관(Heatmap)**을 핵심 가치로 삼습니다.

🚀 프로젝트 개요

• 이름: 뇌사료 (Brain Dogfood)
• 핵심 가치:
  • 지식 네뷸라 (Knowledge Nebula): D3.js 기반의 유기적인 지식 그래프 시각화.
  • 지식 성장 히트맵 (Growth Heatmap): 꾸준한 기록을 시각화하는 활동 대시보드.
  • 이중 보안: 메모별 개별 암호화 및 미디어 보안 실드.
  • AI 구조화: Gemini 2.0 Flash 기반 자동 요약 및 지능형 태깅.

✨ What's New in v5.0

• Heatmap: 최근 1년/6개월/3개월/1개월 활동량 지표 추가.
• Performance: 대량 데이터 로딩 최적화(Bulk Fetch) 및 무한 스크롤 도입.
• Editor: 중요 지식 강조를 위한 글자 색상(Color Syntax) 기능 통합.

📂 문서 인덱스

1. 사용자 매뉴얼 (User Manual): [최초 사용자 필독] 사용법 및 연결 문법
2. 시스템 아키텍처 (Architecture): 폴더 구조 및 모듈형 설계
3. 데이터베이스 및 API 명세 (API Reference): DB 스키마 및 확장된 API 명세
4. 핵심 기능 가이드 (Features): 히트맵 알고리즘 및 AI 인사이트 메커니즘
5. 로직 흐름도 (Logic Flow): 앱 라이프사이클 및 보안 상태 전이 규칙
6. 소스 매핑 가이드 (Source Mapping): 호출 관계 및 Ops 도구 매핑
7. 단축키 가이드 (Shortcuts Guide): [업무 효율 극대화] 탐색 및 편집 단축키 총정리

---

Last Updated: 2026-04-15