260705_2

common_util/common_util_storage.py

@@ -0,0 +1,36 @@
+"""프로젝트 영구저장소 경로 유틸리티."""
+
+import os
+from pathlib import PurePosixPath
+
+from config.config_system import PROJECT_STORAGE_STAGE_DIRS, STORAGE_BASE_DIR
+
+
+def get_project_stage_path(project_root: str, stage: str) -> str:
+    """프로젝트 루트 아래의 허용된 워크플로우 단계 폴더를 생성한다."""
+    if stage not in PROJECT_STORAGE_STAGE_DIRS:
+        raise ValueError(f"허용되지 않은 프로젝트 저장 단계입니다: {stage}")
+
+    root = os.path.abspath(project_root)
+    path = os.path.abspath(os.path.join(root, stage))
+    if os.path.commonpath((root, path)) != root:
+        raise ValueError("단계 저장 경로가 프로젝트 루트를 벗어났습니다.")
+
+    os.makedirs(path, exist_ok=True)
+    return path
+
+
+def resolve_stored_project_path(relative_path: str) -> str:
+    """DB의 storage 기준 상대 경로를 검증해 실제 프로젝트 경로로 변환한다."""
+    normalized = PurePosixPath(relative_path.replace("\\", "/"))
+    if normalized.is_absolute() or ".." in normalized.parts:
+        raise ValueError("프로젝트 저장 경로는 안전한 상대 경로여야 합니다.")
+    if not normalized.parts or normalized.parts[0] != "storage":
+        raise ValueError("프로젝트 저장 경로는 storage/로 시작해야 합니다.")
+
+    storage_root = os.path.abspath(STORAGE_BASE_DIR)
+    path = os.path.abspath(os.path.join(storage_root, *normalized.parts[1:]))
+    if os.path.commonpath((storage_root, path)) != storage_root or path == storage_root:
+        raise ValueError("프로젝트 저장 경로가 저장소 루트를 벗어났습니다.")
+    os.makedirs(path, exist_ok=True)
+    return path