mirror of
https://github.com/sotam0316/brain_dogfood.git
synced 2026-04-25 03:48:38 +09:00
leeyj
43 lines
1.9 KiB
Markdown
43 lines
1.9 KiB
Markdown
# 🔗 소스 매핑 및 호출 관계 (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 수행.
|