brain_dogfood/docs/source_mapping.md

🔗 소스 매핑 및 호출 관계 (v13.4)

본 문서는 프론트엔드 컴포넌트와 백엔드 API, 그리고 내부 함수 간의 호출 관계와 인터페이스를 기술합니다.

📱 1. 프론트엔드 모듈간 관계

모듈 (Component)	기능 설명	주요 호출 (Callee)
app.js	Orchestrator	Visualizer, DrawerManager, ModalManager, API
Visualizer.js	Nebula Engine	D3.js, ModalManager.open(), AppService
DrawerManager.js	Explorer	AppService.filterMemos(), ModalManager
ModalManager.js	Viewer	utils.parseInternalLinks(), utils.fixImagePaths()
ComposerManager.js	Editor	API.saveMemo(), AttachmentBox

---

⚙️ 2. 백엔드 핵심 함수 매핑

2.1 보안 및 유틸리티

함수명	모듈	역할	호출자
decrypt_file	app/security.py	첨부파일 물리 복호화	file.py:download_file
extract_links	app/utils.py	[[#ID]] 패턴 추출	memo.py:create/update

2.2 운영 도구 (Ops)

파일명	역할	주요 로직
deploy.py	정밀 배포	SSH/SFTP 기반 Surgical Cleanup & Upload
backup.py	백업	핵심 자산(.env, DB, Uploads) Tarball 생성

---

🌐 3. 클라이언트-서버 통신 파라미터 (API Flow)

3.1 GET /api/download/<filename> (보안 하향 링크)

• Caller: ModalManager.js (Inline Images) or AttachmentBox.js
• Security: session['logged_in'] 확인 -> is_encrypted 상태에 따른 접근 제어.
• Header: 이미지인 경우 Content-Disposition: inline.

3.2 PUT /api/memos/<id> (수정 및 보안 전이)

• Status Change: 암호화 해제 저장 시 is_encrypted: 0으로 DB 상태 업데이트.
• Process: memo.py:update_memo에서 password 유무에 따른 Re-encryption 수행.