brain_dogfood/docs/README.md

🧠 뇌사료 (Brain Dogfood) 프로젝트 문서화 (v1.5)

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

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

🚀 프로젝트 개요

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

✨ What's New in v1.5

• Advanced Category Toggle: 라이트 유저를 위해 카테고리 기능을 숨기거나 켤 수 있는 옵션 도입.
• i18n Stabilization: 한국어/영어 전환 시 히트맵, 달력 등 동적 컴포넌트까지 완벽하게 자가 교정 및 번역 반영.
• V5 Metadata Shield: 정규식 엔진 고도화를 통해 시스템 메타데이터 중복 및 푸터 손상 원천 차단.
• Data Integrity: 다국어 환경의 정합성을 위해 내부 그룹명을 영문 상수로 통일.

📂 문서 인덱스

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-16 (v1.5 Milestone Release)