---
type: concept
status: draft
related_pages: ["[[architecture/shared_resources]]"]
source_file: "common_util/common_util_storage.py"
last_updated: 2026-08-08
---

# common_util_storage.py

프로젝트 파일 저장소의 상대 경로 및 루트 절대 경로 안전 변환/검증을 담당하는 공통 물리 파일 시스템 유틸리티 모듈입니다.

## 🛠️ 주요 함수 목록

| 항목 | 위치(상대 경로) | 역할 |
|---|---|---|
| `resolve_stored_project_path()` | `common_util/common_util_storage.py` | DB에 저장된 프로젝트 저장소 상대 경로를 물리 시스템 절대 경로로 해석 반환 (필요 시 디렉터리 생성) |
| `resolve_project_root_for_delete()` | `common_util/common_util_storage.py` | 삭제용 경로를 검증 해석하여 물리 절대 경로 반환 (디렉터리를 생성하지 않고 4단계 보안 가드 적용) |
| `ensure_project_directory()` | `common_util/common_util_storage.py` | 프로젝트 저장소 디렉토리 존재 보장 및 생성 |

## 🔗 역참조 (사용처)
- [[B01_Dashboard/backend/B01_Dashboard_Router]] (하드 삭제 스위치 시 rmtree 경로 획득 목적)
- [[B03_FileInput/backend/B03_FileInput_Router]]
- [[B04_PreProcess/backend/B04_PreProcess_Router]]
- [[B05_Profile/backend/B05_Profile_Router]]