feat(project): 업무 휴지통(3개월 보관·관리자 복구) + 하위 업무 우클릭 삭제

- 업무 삭제 시 지우기 직전 스냅샷(업무·하위 업무·댓글·팔로워·@태그·첨부
  기록·연결·활동 이력·마감 알림 기록)을 같은 트랜잭션에서 project_trash 에
  JSONB 로 남기고 삭제. 첨부 실물은 DATA_DIR/project/_trash/<id>/ 로 이동.
- 관리자 전용 휴지통(/project/trash, 좌측 메뉴): 원래 id 그대로 복구(중복·
  지워진 프로젝트·상위 없는 하위는 거부, 지워진 세션은 미지정으로).
  3개월 지난 항목은 휴지통 화면/삭제 때 영구 정리.
- 삭제 확인 공용화(confirmTaskDelete): 하위 업무가 있으면 'N개까지 모두
  삭제' 를 명확히 묻고, 휴지통 보관 안내. 카드 하위 업무 우클릭 메뉴
  (열기/완료/하위 업무 삭제).
- DB: project_db_010_trash.sql. 미적용이면 예전처럼 영구 삭제.
- 로컬 PostgreSQL 17 로 삭제→휴지통→복구·거부 조건·만료 정리 검증.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
2026-09-24 00:51:33 +09:00
parent 624145de56
commit 56250e6027
12 changed files with 563 additions and 23 deletions
+147 -4
View File
@@ -44,7 +44,7 @@ from fastapi.responses import (
)
from psycopg.errors import UndefinedColumn
from app.timezone import today_kst
from app.timezone import KST, now_kst, today_kst
from . import store
@@ -150,6 +150,76 @@ def _remove_task_dirs(request: Request, task_ids: list[int]) -> None:
logger.warning("첨부 폴더 삭제 실패: %s", d)
def _project_data_dir(request: Request) -> Path:
return Path(str(getattr(request.app.state, "data_dir", "."))) / "project"
def _trash_dir(request: Request, trash_id: int) -> Path:
"""휴지통으로 옮긴 첨부 폴더 자리 — DATA_DIR/project/_trash/<trash_id>/<task_id>."""
return _project_data_dir(request) / "_trash" / str(int(trash_id))
def _move_task_dirs_to_trash(request: Request, task_ids: list[int], trash_id: int) -> None:
"""지운 업무들의 첨부 폴더를 휴지통 폴더로 옮긴다(복구 시 되돌림). 실패해도
삭제는 이미 끝났으므로 로그만."""
import shutil # noqa: WPS433
base = _project_data_dir(request)
dest_root = _trash_dir(request, trash_id)
for tid in task_ids:
src = base / str(int(tid))
if not src.is_dir():
continue
try:
dest_root.mkdir(parents=True, exist_ok=True)
shutil.move(str(src), str(dest_root / str(int(tid))))
except Exception: # noqa: BLE001
logger.warning("첨부 폴더 휴지통 이동 실패: %s", src)
def _restore_task_dirs(request: Request, trash_id: int) -> None:
"""휴지통 폴더의 첨부 폴더를 원래 자리(DATA_DIR/project/<task_id>)로 되돌린다."""
import shutil # noqa: WPS433
root = _trash_dir(request, trash_id)
if not root.is_dir():
return
base = _project_data_dir(request)
for d in root.iterdir():
if not d.is_dir():
continue
dest = base / d.name
try:
if dest.exists():
logger.warning("복구 대상 첨부 폴더가 이미 있음 — 건너뜀: %s", dest)
continue
shutil.move(str(d), str(dest))
except Exception: # noqa: BLE001
logger.warning("첨부 폴더 복구 실패: %s", d)
try:
root.rmdir()
except OSError:
pass
def _purge_trash(request: Request, st: Any) -> None:
"""보관 기간(3개월)이 지난 휴지통 항목과 그 첨부 폴더를 영구 삭제. 휴지통 화면을
열거나 업무를 지울 때 가볍게 돈다. 실패해도 본 작업은 막지 않는다."""
import shutil # noqa: WPS433
try:
purged = st.purge_expired_trash()
except Exception: # noqa: BLE001 - 010 미적용 등
return
for trash_id in purged:
d = _trash_dir(request, trash_id)
if d.is_dir():
try:
shutil.rmtree(d)
except Exception: # noqa: BLE001
logger.warning("휴지통 폴더 삭제 실패: %s", d)
def _admin_emails(request: Request) -> list[str]:
"""알림 수신 관리자 이메일 목록.
@@ -1256,11 +1326,16 @@ def api_delete_task(request: Request, task_id: int) -> JSONResponse:
if not _can_delete(user, existing.get("created_by")):
raise HTTPException(status_code=403, detail=_DELETE_DENIED)
try:
removed_task_ids = st.delete_task(task_id=task_id)
removed_task_ids, trash_id = st.delete_task(task_id=task_id, deleted_by=user["email"])
except KeyError:
raise HTTPException(status_code=404, detail="업무를 찾을 수 없습니다.")
_remove_task_dirs(request, removed_task_ids) # 하위 업무 첨부 폴더까지
return JSONResponse({"ok": True})
# 휴지통(010)이 있으면 첨부 폴더도 휴지통으로(복구 대비), 없으면 예전처럼 삭제.
if trash_id is not None:
_move_task_dirs_to_trash(request, removed_task_ids, trash_id)
else:
_remove_task_dirs(request, removed_task_ids) # 하위 업무 첨부 폴더까지
_purge_trash(request, st)
return JSONResponse({"ok": True, "trash": trash_id is not None, "count": len(removed_task_ids)})
@router.get("/api/tasks/{task_id}")
@@ -1843,6 +1918,74 @@ def api_mentions_read(
return JSONResponse({"ok": True, "marked": n})
@router.get("/trash", response_class=HTMLResponse)
def trash_page(request: Request) -> HTMLResponse:
"""휴지통 — 관리자 전용. 지운 업무(하위 업무 포함)를 3개월 보관, 복구."""
from app.main import build_erp_nav, render_template # noqa: WPS433
from app.store import is_admin # noqa: WPS433
user = _require_user(request)
if not is_admin(user):
raise HTTPException(status_code=403, detail="관리자만 볼 수 있습니다.")
st = _store(request)
if st is None:
return _render_config_needed(request, user)
_purge_trash(request, st)
enabled = st.trash_enabled()
return render_template(
request,
"project/trash.html",
{
"user": user,
"is_admin": True,
"nav_items": build_erp_nav(user, active="project"),
"nav_projects": _nav_projects(st, user, True),
"my_open_total": st.count_my_open(assignee_email=user["email"]),
"mention_unread": _safe_mention_unread(st, user["email"]),
"page_title": "휴지통",
"page_subtitle": "삭제한 업무 — 3개월 보관, 관리자만 복구",
"force_sidebar_collapsed": True,
"trash_enabled": enabled,
"items": _trash_view_items(st.list_trash()) if enabled else [],
},
)
def _trash_view_items(items: list[dict[str, Any]]) -> list[dict[str, Any]]:
"""휴지통 화면용 — 삭제 시각(KST 문자열)·남은 보관 일수."""
from datetime import datetime # noqa: WPS433
now = now_kst()
for it in items:
try:
deleted = datetime.fromisoformat(str(it["deleted_at"])).astimezone(KST)
it["deleted_label"] = deleted.strftime("%Y-%m-%d %H:%M")
except (TypeError, ValueError):
it["deleted_label"] = str(it.get("deleted_at") or "")[:16]
try:
expires = datetime.fromisoformat(str(it["expires_at"])).astimezone(KST)
it["days_left"] = max(0, (expires - now).days)
except (TypeError, ValueError):
it["days_left"] = None
it["deleted_by_id"] = (it.get("deleted_by") or "").split("@")[0]
return items
@router.post("/api/trash/{trash_id}/restore")
def api_restore_trash(request: Request, trash_id: int) -> JSONResponse:
"""휴지통 항목 복구 — 관리자 전용. 업무·하위 업무·댓글 등 원래 id 그대로."""
user = _require_admin(request)
st = _db_or_503(request)
try:
result = st.restore_trash(trash_id=trash_id, restored_by=user["email"])
except KeyError:
raise HTTPException(status_code=404, detail="휴지통 항목을 찾을 수 없습니다.")
except ValueError as exc:
raise HTTPException(status_code=409, detail=str(exc))
_restore_task_dirs(request, trash_id)
return JSONResponse({"ok": True, **result})
@router.get("/inbox", response_class=HTMLResponse)
def inbox_page(request: Request) -> HTMLResponse:
from app.main import build_erp_nav, render_template # noqa: WPS433