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

# common_util_project_delete.py

프로젝트 삭제 시 DB 행(ON DELETE CASCADE 연쇄 소멸) 및 물리 영구저장소 디스크 폴더(`storage/{회사}/{사용자}/{프로젝트ID}/`)를 통째로 지우는 하드 삭제 비즈니스 로직을 담당하는 공통 유틸리티 모듈입니다.

## 🛠️ 주요 함수 목록

| 항목 | 위치(상대 경로) | 역할 |
|---|---|---|
| `hard_delete_project()` | `common_util/common_util_project_delete.py` | 트랜잭션 내에서 `storage_path` 조회 및 검증 후 `projects` 행 DELETE, `PROJECT_HARD_DELETE` 감사 로그 추가를 처리하고 커밋 성공 시 rmtree 물리 삭제를 실행 |

## 🔗 역참조 (사용처)
- [[B01_Dashboard/backend/B01_Dashboard_Router]] (스위치에 따른 프로젝트 하드 삭제 API 호출)