Files

4.9 KiB

💎 핵심 기능 가이드 (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):
    • 작성 취소: 현재 작업 중인 내용을 버리고 안전하게 창을 닫습니다. (기존 메모는 보존됩니다.)
    • 지식 삭제: 수정 모드 내에서 별도의 빨간색 삭제 버튼을 통해 명시적으로 메모를 영구 제거합니다.