fix(project): 보안·권한·데이터 버그 수정 및 성능 개선

보안
- 첨부 /inline: 업로드한 쪽이 정한 content-type 을 그대로 띄워 HTML/SVG
  첨부로 저장형 XSS 가능 → 안전한 이미지 형식만 인라인, 나머지는 다운로드.
  nosniff + CSP sandbox 헤더 추가.
- 설명란 sanitizer: URL 금지 목록이 "jav	ascript:" 로 우회됨 →
  허용 목록(http/https/mailto/tel/상대경로, img 는 data: 이미지)으로 변경.

권한
- 업무 생성 시 parent_task_id 로 권한 없는 프로젝트에 하위 업무 생성 가능 → 거부.
- 세션 수정/순서/삭제 API 가 세션이 URL 프로젝트 소속인지 안 봄 → 404.
- 업무 생성·수정·연결 시 세션이 해당 프로젝트 것인지 검증.
- 멤버/세션/업무/활동 조회 API 와 프로젝트 화면을 멤버·owner·admin 만.
  users/tasks 전체 조회는 볼 수 있는 프로젝트 업무만.

데이터
- 연결(멀티호밍) 업무를 연결된 프로젝트에서 열어 저장하면 세션 선택이 비어
  stage_id=null 이 전송돼 원래 세션·완료 상태가 지워짐 → home_stage_id 사용,
  빈 세션은 보내지 않음.
- mergeTask 가 같은 id 의 첫 행만 고쳐 연결 업무 카드가 중복/사라짐 → 모든
  맥락 행을 고치되 맥락별 세션 필드는 보존. 새 업무가 다음 동기화까지 안
  보이던 문제도 수정.
- 삭제·세션 이름변경·첨부 추가가 실시간 반영 안 됨 → 트리거 카운터
  (마이그레이션 007, 미적용 시 MAX 폴백). 화면 열자마자 기준값을 잡아
  첫 8초 사이 변경 누락도 해결. 동기화 시 이 프로젝트 행을 통째로 교체.
- 사이드바 "내 업무" 개수가 화면마다 다르던 것 → count_my_open 하나로 통일.
- 업무/프로젝트/댓글 삭제 시 디스크 첨부 파일 정리.

성능
- 라우터 핸들러 async def → def (동기 psycopg 가 이벤트 루프를 막음).
- 프로젝트 화면 N+1 → 업무·세션 각각 쿼리 1회.
- live-version 풀스캔 → PK 한 줄 조회. 탭 숨김 시 폴링 중지.
- 동기화 API 3개 → /snapshot 1개, 배지 숫자는 /my-tasks/open-count.
- 순서 변경 UPDATE N번 → unnest 1번. 첨부는 한도+1 바이트만 읽음.

기타
- 마이그레이션 003 번호 중복 → project_db_003b_task_times.sql.
- CLAUDE.md 의 옛 권한 설명 정정, PROJECT_MODULE.md 갱신. 캐시 버전 20260923b.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
2026-09-23 12:59:37 +09:00
parent b0062504b6
commit ca9beab729
11 changed files with 631 additions and 207 deletions
+216 -93
View File
@@ -10,6 +10,10 @@
- 메일: 업무가 직원에게 '배정'되거나 '완료'되면 관리자에게 알림(BackgroundTasks).
뷰: 메인은 달력(FullCalendar)/타임라인(vis-timeline) 토글. 추가로 보드(칸반)·리스트.
핸들러는 전부 `def`(sync)다. DB 드라이버(psycopg ConnectionPool)가 동기라서
`async def` 안에서 부르면 쿼리 도는 동안 이벤트 루프(=앱 전체 요청 처리)가
멈춘다. `def` 로 두면 FastAPI 가 스레드풀에서 돌린다.
"""
from __future__ import annotations
@@ -45,6 +49,12 @@ from . import store
# 첨부 업로드 제한
_MAX_ATTACH_BYTES = 20 * 1024 * 1024 # 20MB
# 첨부 응답 공통 헤더 — 브라우저가 내용을 보고 형식을 추측(sniff)해 HTML 로
# 실행하지 못하게 하고, 혹시 문서로 열려도 스크립트를 막는다.
_ATTACH_HEADERS = {
"X-Content-Type-Options": "nosniff",
"Content-Security-Policy": "default-src 'none'; img-src 'self'; style-src 'unsafe-inline'; sandbox",
}
logger = logging.getLogger("project.router")
@@ -110,6 +120,35 @@ def _can_delete(user: dict[str, Any], created_by: str | None) -> bool:
_DELETE_DENIED = "삭제는 만든 사람만 할 수 있습니다."
def _accessible_project_ids(st: Any, user: dict[str, Any]) -> set[int] | None:
"""사용자가 볼 수 있는 프로젝트 id 집합. 관리자는 None(=전체)."""
from app.store import is_admin # noqa: WPS433
if is_admin(user):
return None
return {
p["id"] for p in st.list_projects(include_archived=True, member_email=user["email"])
}
def _remove_task_dirs(request: Request, task_ids: list[int]) -> None:
"""삭제된 업무들의 첨부 폴더(DATA_DIR/project/<task_id>)를 지운다.
DB 행은 CASCADE 로 사라지지만 디스크 파일은 남아 계속 쌓였다. 실패해도
삭제 자체는 이미 끝났으므로 로그만 남긴다.
"""
import shutil # noqa: WPS433
base = Path(str(getattr(request.app.state, "data_dir", "."))) / "project"
for tid in task_ids:
d = base / str(int(tid))
if d.is_dir():
try:
shutil.rmtree(d)
except Exception: # noqa: BLE001
logger.warning("첨부 폴더 삭제 실패: %s", d)
def _admin_emails(request: Request) -> list[str]:
"""알림 수신 관리자 이메일 목록.
@@ -381,7 +420,7 @@ def _build_task_calendar(
# 페이지
# ────────────────────────────────────────────────────────────
@router.get("/health")
async def health(request: Request) -> JSONResponse:
def health(request: Request) -> JSONResponse:
st = _store(request)
if st is None:
return JSONResponse({"status": "not_configured"}, status_code=503)
@@ -393,7 +432,7 @@ async def health(request: Request) -> JSONResponse:
@router.get("/api/live-version")
async def api_live_version(request: Request) -> JSONResponse:
def api_live_version(request: Request) -> JSONResponse:
"""프로젝트/업무/댓글/멤버/단계 중 가장 최근 변경 시각.
페이지를 열어둔 클라이언트가 주기적으로 조회해 값이 바뀌면 새로고침한다
@@ -405,7 +444,7 @@ async def api_live_version(request: Request) -> JSONResponse:
@router.get("/", response_class=HTMLResponse)
async def my_tasks_page(request: Request) -> HTMLResponse:
def my_tasks_page(request: Request) -> HTMLResponse:
"""프로젝트 모듈의 첫 화면 = 내 업무.
예전 홈(프로젝트 카드 그리드)은 없앴다 — 좌측 "내 업무" 메뉴와 같은
@@ -461,7 +500,7 @@ async def my_tasks_page(request: Request) -> HTMLResponse:
@router.get("/t/{task_id}")
async def task_permalink(request: Request, task_id: int):
def task_permalink(request: Request, task_id: int):
"""업무 공유 링크(퍼머링크) — 업무 편집 팝업의 "링크 복사"가 만드는 주소.
누구에게 주소가 가더라도 **회사 계정으로 로그인한 그 프로젝트 멤버(또는
@@ -519,7 +558,7 @@ async def task_permalink(request: Request, task_id: int):
@router.get("/p/{project_id}", response_class=HTMLResponse)
async def project_page(request: Request, project_id: int) -> HTMLResponse:
def project_page(request: Request, project_id: int) -> HTMLResponse:
from app.main import build_erp_nav, render_template # noqa: WPS433
from app.store import is_admin # noqa: WPS433
@@ -533,38 +572,52 @@ async def project_page(request: Request, project_id: int) -> HTMLResponse:
raise HTTPException(status_code=404, detail="프로젝트를 찾을 수 없습니다.")
admin = is_admin(user)
# 멤버(또는 owner/관리자)가 아니면 이 프로젝트 화면을 열 수 없다 — 공유
# 링크(/project/t/{id})와 같은 원칙. 예전엔 세션·멤버 목록이 그대로 보였다.
can_manage = _can_manage(request, st, user, project_id)
if not can_manage:
return render_template(
request,
"denied.html",
{
"reason": "이 프로젝트의 멤버만 볼 수 있습니다. "
"프로젝트 관리자에게 멤버 배정을 요청하세요.",
"user": user,
"is_admin": admin,
"nav_items": build_erp_nav(user, active="project"),
},
status_code=403,
)
all_projects = st.list_projects(
include_archived=False,
member_email=None if admin else user["email"],
)
stages = st.list_stages(project_id=project_id)
tasks = st.list_tasks(project_id=project_id, limit=2000)
members = st.list_members(project_id=project_id)
can_manage = _can_manage(request, st, user, project_id)
top_projects = [p for p in all_projects if not p.get("parent_id")] # 과거 서브프로젝트 제외
top_ids = [p["id"] for p in top_projects]
# 좌측 트리 + 전체 집계: 4개 뷰(달력/타임라인/보드/리스트)는 '전체 프로젝트'를 보여준다.
# all_tasks : 접근 가능한 모든 프로젝트의 업무(뷰 데이터)
# stages_by_project : 프로젝트별 단계(보드 이름→단계 매핑 + 모달 단계 선택용)
# projects_meta : 프로젝트 메타(타임라인 그룹/보드 카드 배지용)
# 업무·세션은 프로젝트 수와 상관없이 각각 쿼리 한 번으로 받는다(예전엔
# 프로젝트마다 2번씩 — N+1). 행마다 context_project_id(어느 프로젝트를 보다가
# 담겼는지)가 붙어 있다 — 멀티호밍된 업무는 원 프로젝트와 연결된 프로젝트
# 양쪽에서 한 번씩 나오고, "전체 프로젝트" 집계는 원 소속 행만 센다.
all_tasks = st.list_tasks_for_projects(project_ids=top_ids)
stages_by_project = st.list_stages_for_projects(project_ids=top_ids)
stages = (
stages_by_project[project_id] if project_id in stages_by_project
else st.list_stages(project_id=project_id) # 보관된 프로젝트 등 목록 밖
)
tasks_by_ctx: dict[int, list[dict[str, Any]]] = {}
for t in all_tasks:
tasks_by_ctx.setdefault(t["context_project_id"], []).append(t)
nav_projects: list[dict[str, Any]] = []
all_tasks: list[dict[str, Any]] = []
stages_by_project: dict[int, list[dict[str, Any]]] = {}
projects_meta: list[dict[str, Any]] = []
for p in all_projects:
if p.get("parent_id"):
continue # 과거 서브프로젝트는 트리에서 제외
p_tasks = (
tasks if p["id"] == project_id
else st.list_tasks(project_id=p["id"], limit=2000)
)
# 이 업무가 '어느 프로젝트를 보다가' 담겼는지 표시 — 멀티호밍된 업무는
# 원 프로젝트(t.project_id)와 연결된 프로젝트(p.id) 양쪽에서 각각 한 번씩
# 나온다(각 프로젝트 화면에 보여야 하므로). "전체 프로젝트" 집계 화면은
# context_project_id == project_id(원 소속)인 것만 세어 중복을 없앤다.
for t in p_tasks:
t["context_project_id"] = p["id"]
all_tasks.extend(p_tasks)
stages_by_project[p["id"]] = st.list_stages(project_id=p["id"])
for p in top_projects:
p_tasks = tasks_by_ctx.get(p["id"], [])
projects_meta.append({
"id": p["id"],
"name": p["name"],
@@ -609,12 +662,8 @@ async def project_page(request: Request, project_id: int) -> HTMLResponse:
if u.get("picture")
}
# 우측 "내 업무" 패널 — 홈 화면과 동일한 쿼리/그룹핑(프로젝트별)을 재사용.
# 좌측 사이드바 "내 업무" 배지(진행 중 개수)와 수신함 배지.
my_open_total = sum(
1 for t in st.list_tasks(assignee_email=user["email"], limit=1000)
if not t.get("completed_at")
)
my_open_total = st.count_my_open(assignee_email=user["email"])
mention_unread = _safe_mention_unread(st, user["email"])
# 달력(휴가식 월간 그리드) — ?y=&m= 로 월 이동, 기본 이번 달
@@ -678,7 +727,7 @@ def _db_or_503(request: Request) -> Any:
@router.get("/api/projects")
async def api_list_projects(request: Request) -> JSONResponse:
def api_list_projects(request: Request) -> JSONResponse:
from app.store import is_admin # noqa: WPS433
user = _require_user(request)
@@ -692,7 +741,7 @@ async def api_list_projects(request: Request) -> JSONResponse:
@router.post("/api/projects")
async def api_create_project(
def api_create_project(
request: Request, payload: dict[str, Any] = Body(...)
) -> JSONResponse:
"""최상위 프로젝트 생성 — 로그인해 프로젝트 모듈에 접근할 수 있는 사용자 누구나."""
@@ -715,7 +764,7 @@ async def api_create_project(
@router.post("/api/projects/{project_id}/subprojects")
async def api_create_subproject(
def api_create_subproject(
request: Request, project_id: int, payload: dict[str, Any] = Body(...)
) -> JSONResponse:
"""서브프로젝트 생성 — 멤버(또는 관리자)."""
@@ -741,7 +790,7 @@ async def api_create_subproject(
@router.put("/api/projects/order")
async def api_reorder_projects(
def api_reorder_projects(
request: Request, payload: dict[str, Any] = Body(...)
) -> JSONResponse:
"""홈 화면 프로젝트 카드 드래그 순서 변경. 최상위 프로젝트만 대상이며,
@@ -762,7 +811,7 @@ async def api_reorder_projects(
@router.put("/api/projects/{project_id}")
async def api_update_project(
def api_update_project(
request: Request, project_id: int, payload: dict[str, Any] = Body(...)
) -> JSONResponse:
user = _require_user(request)
@@ -778,7 +827,7 @@ async def api_update_project(
@router.delete("/api/projects/{project_id}")
async def api_delete_project(request: Request, project_id: int) -> JSONResponse:
def api_delete_project(request: Request, project_id: int) -> JSONResponse:
"""프로젝트 삭제 — '만든 사람'만(슈퍼관리자 예외). 안의 업무도 CASCADE."""
user = _require_user(request)
st = _db_or_503(request)
@@ -787,7 +836,11 @@ async def api_delete_project(request: Request, project_id: int) -> JSONResponse:
raise HTTPException(status_code=404, detail="프로젝트를 찾을 수 없습니다.")
if not _can_delete(user, project.get("created_by")):
raise HTTPException(status_code=403, detail=_DELETE_DENIED)
st.delete_project(project_id=project_id)
try:
removed_task_ids = st.delete_project(project_id=project_id)
except KeyError:
raise HTTPException(status_code=404, detail="프로젝트를 찾을 수 없습니다.")
_remove_task_dirs(request, removed_task_ids)
return JSONResponse({"ok": True})
@@ -795,7 +848,7 @@ async def api_delete_project(request: Request, project_id: int) -> JSONResponse:
# JSON API — 멤버 (관리자가 사용자 배정)
# ────────────────────────────────────────────────────────────
@router.get("/api/assignable-users")
async def api_assignable_users(request: Request) -> JSONResponse:
def api_assignable_users(request: Request) -> JSONResponse:
"""배정 후보 = 등록된 사용자 중 프로젝트 권한(project 모듈) 보유자. 관리자 전용.
관리자 페이지의 '프로젝트 관리' 토글을 켠 직원이 자동으로 후보가 된다.
@@ -819,7 +872,7 @@ async def api_assignable_users(request: Request) -> JSONResponse:
@router.get("/api/all-users")
async def api_all_users(request: Request) -> JSONResponse:
def api_all_users(request: Request) -> JSONResponse:
"""프로젝트 화면 좌측 "전체 멤버" 표시용 — project 모듈 권한 보유 등록
사용자 전원. assignable-users 와 후보군은 같지만, 이건 멤버 배정(쓰기)이
아니라 단순 열람용이라 관리자가 아니어도 볼 수 있다."""
@@ -842,31 +895,37 @@ async def api_all_users(request: Request) -> JSONResponse:
@router.get("/api/users/tasks")
async def api_user_tasks(
def api_user_tasks(
request: Request, email: str, project_id: int | None = None
) -> JSONResponse:
"""'전체 멤버'/사이드바 '프로젝트 멤버' 아이콘 클릭 팝업 — 지정한 사용자가
담당자인 업무 목록(프로젝트/세션/마감일). project_id 를 주면 그 프로젝트
안에서 담당하는 업무만(멀티호밍으로 연결된 업무 포함, list_tasks 의
project_id 단일 조회 경로 재사용). 안 주면 전체 프로젝트 대상."""
_require_user(request)
user = _require_user(request)
st = _db_or_503(request)
if project_id is not None:
_require_manage(request, st, user, project_id)
tasks = st.list_tasks(project_id=project_id, assignee_email=email, limit=500)
else:
tasks = st.list_tasks(assignee_email=email, limit=500)
# 전체 대상이면 내가 볼 수 있는 프로젝트의 업무만 남긴다(비관리자).
allowed = _accessible_project_ids(st, user)
if allowed is not None:
tasks = [t for t in tasks if t["project_id"] in allowed]
return JSONResponse({"tasks": tasks})
@router.get("/api/projects/{project_id}/members")
async def api_list_members(request: Request, project_id: int) -> JSONResponse:
_require_user(request)
def api_list_members(request: Request, project_id: int) -> JSONResponse:
user = _require_user(request)
st = _db_or_503(request)
_require_manage(request, st, user, project_id)
return JSONResponse({"members": st.list_members(project_id=project_id)})
@router.post("/api/projects/{project_id}/members")
async def api_add_member(
def api_add_member(
request: Request, project_id: int, payload: dict[str, Any] = Body(...)
) -> JSONResponse:
"""사용자를 프로젝트에 배정 — 관리자 전용."""
@@ -885,7 +944,7 @@ async def api_add_member(
@router.delete("/api/projects/{project_id}/members/{user_email}")
async def api_remove_member(
def api_remove_member(
request: Request, project_id: int, user_email: str
) -> JSONResponse:
_require_admin(request)
@@ -898,14 +957,15 @@ async def api_remove_member(
# JSON API — 단계 (stages)
# ────────────────────────────────────────────────────────────
@router.get("/api/projects/{project_id}/stages")
async def api_list_stages(request: Request, project_id: int) -> JSONResponse:
_require_user(request)
def api_list_stages(request: Request, project_id: int) -> JSONResponse:
user = _require_user(request)
st = _db_or_503(request)
_require_manage(request, st, user, project_id)
return JSONResponse({"stages": st.list_stages(project_id=project_id)})
@router.post("/api/projects/{project_id}/stages")
async def api_add_stage(
def api_add_stage(
request: Request, project_id: int, payload: dict[str, Any] = Body(...)
) -> JSONResponse:
user = _require_user(request)
@@ -924,8 +984,17 @@ async def api_add_stage(
return JSONResponse({"stage": stage}, status_code=201)
def _stage_of_project(st: Any, stage_id: int, project_id: int) -> dict[str, Any]:
"""URL 의 세션이 URL 의 프로젝트 것인지 확인. 권한 검사는 project_id 로
하므로, 이걸 안 보면 아무 프로젝트 멤버나 남의 세션을 고칠 수 있다."""
stage = st.get_stage(stage_id=stage_id)
if stage is None or stage["project_id"] != project_id:
raise HTTPException(status_code=404, detail="세션을 찾을 수 없습니다.")
return stage
@router.delete("/api/projects/{project_id}/stages/{stage_id}")
async def api_delete_stage(
def api_delete_stage(
request: Request, project_id: int, stage_id: int
) -> JSONResponse:
"""세션(단계) 삭제 — 만든 사람만(슈퍼관리자 예외). 생성자 정보가 없는 과거
@@ -933,9 +1002,7 @@ async def api_delete_stage(
user = _require_user(request)
st = _db_or_503(request)
_require_manage(request, st, user, project_id)
stage = st.get_stage(stage_id=stage_id)
if stage is None:
raise HTTPException(status_code=404, detail="세션을 찾을 수 없습니다.")
stage = _stage_of_project(st, stage_id, project_id)
if not _can_delete(user, stage.get("created_by")):
raise HTTPException(status_code=403, detail=_DELETE_DENIED)
try:
@@ -949,22 +1016,49 @@ async def api_delete_stage(
# JSON API — 업무 (tasks)
# ────────────────────────────────────────────────────────────
@router.get("/api/projects/{project_id}/tasks")
async def api_list_tasks(request: Request, project_id: int) -> JSONResponse:
_require_user(request)
def api_list_tasks(request: Request, project_id: int) -> JSONResponse:
user = _require_user(request)
st = _db_or_503(request)
_require_manage(request, st, user, project_id)
tasks = st.list_tasks(project_id=project_id, include_subprojects=True, limit=2000)
return JSONResponse({"tasks": tasks})
@router.get("/api/projects/{project_id}/snapshot")
def api_project_snapshot(request: Request, project_id: int) -> JSONResponse:
"""프로젝트 화면 실시간 동기화용 — 업무(이 프로젝트 + 여기 연결된 업무,
context_project_id·home_stage_id 포함)·세션·멤버를 요청 한 번에.
예전엔 API 3개를 따로 불렀고, 업무 API 는 연결 업무를 빼고 돌려줘서
화면의 연결 업무 행과 맞지 않았다.
"""
user = _require_user(request)
st = _db_or_503(request)
_require_manage(request, st, user, project_id)
return JSONResponse({
"tasks": st.list_tasks_for_projects(project_ids=[project_id]),
"stages": st.list_stages(project_id=project_id),
"members": st.list_members(project_id=project_id),
})
@router.get("/api/my-tasks")
async def api_my_tasks(request: Request) -> JSONResponse:
def api_my_tasks(request: Request) -> JSONResponse:
user = _require_user(request)
st = _db_or_503(request)
return JSONResponse({"tasks": st.list_my_tasks(assignee_email=user["email"], limit=1000)})
@router.get("/api/my-tasks/open-count")
def api_my_open_count(request: Request) -> JSONResponse:
"""사이드바 "내 업무" 배지 숫자만 — 목록 전체를 받지 않는다."""
user = _require_user(request)
st = _db_or_503(request)
return JSONResponse({"open": st.count_my_open(assignee_email=user["email"])})
@router.post("/api/projects/{project_id}/tasks")
async def api_create_task(
def api_create_task(
request: Request,
project_id: int,
bg: BackgroundTasks,
@@ -1029,7 +1123,7 @@ async def api_create_task(
@router.put("/api/tasks/{task_id}")
async def api_update_task(
def api_update_task(
request: Request,
task_id: int,
bg: BackgroundTasks,
@@ -1103,7 +1197,7 @@ async def api_update_task(
@router.delete("/api/tasks/{task_id}")
async def api_delete_task(request: Request, task_id: int) -> JSONResponse:
def api_delete_task(request: Request, task_id: int) -> JSONResponse:
user = _require_user(request)
st = _db_or_503(request)
existing = st.get_task(task_id=task_id)
@@ -1111,12 +1205,16 @@ async def api_delete_task(request: Request, task_id: int) -> JSONResponse:
raise HTTPException(status_code=404, detail="업무를 찾을 수 없습니다.")
if not _can_delete(user, existing.get("created_by")):
raise HTTPException(status_code=403, detail=_DELETE_DENIED)
st.delete_task(task_id=task_id)
try:
removed_task_ids = st.delete_task(task_id=task_id)
except KeyError:
raise HTTPException(status_code=404, detail="업무를 찾을 수 없습니다.")
_remove_task_dirs(request, removed_task_ids) # 하위 업무 첨부 폴더까지
return JSONResponse({"ok": True})
@router.get("/api/tasks/{task_id}")
async def api_get_task(request: Request, task_id: int) -> JSONResponse:
def api_get_task(request: Request, task_id: int) -> JSONResponse:
"""업무 상세 — 하위 업무·연결된 프로젝트 포함. 업무 편집 팝업을 열 때 쓴다."""
user = _require_user(request)
st = _db_or_503(request)
@@ -1133,7 +1231,7 @@ async def api_get_task(request: Request, task_id: int) -> JSONResponse:
# JSON API — 업무 멀티호밍 (다른 프로젝트/세션에 연결)
# ────────────────────────────────────────────────────────────
@router.post("/api/tasks/{task_id}/links")
async def api_add_task_link(
def api_add_task_link(
request: Request, task_id: int, payload: dict[str, Any] = Body(...)
) -> JSONResponse:
"""업무를 다른 프로젝트(의 한 세션)에도 연결한다(아사나의 멀티호밍).
@@ -1162,16 +1260,21 @@ async def api_add_task_link(
)
if not already_linked:
_require_manage(request, st, user, task["project_id"])
stage_id = payload.get("stage_id")
try:
stage_id = st.stage_in_project(
stage_id=payload.get("stage_id") or None, project_id=target_project_id
)
except ValueError as exc:
raise HTTPException(status_code=400, detail=str(exc))
link = st.add_task_link(
task_id=task_id, project_id=target_project_id,
stage_id=int(stage_id) if stage_id else None, created_by=user["email"],
stage_id=stage_id, created_by=user["email"],
)
return JSONResponse({"link": link}, status_code=201)
@router.delete("/api/tasks/{task_id}/links/{project_id}")
async def api_remove_task_link(request: Request, task_id: int, project_id: int) -> JSONResponse:
def api_remove_task_link(request: Request, task_id: int, project_id: int) -> JSONResponse:
user = _require_user(request)
st = _db_or_503(request)
task = st.get_task(task_id=task_id)
@@ -1184,9 +1287,10 @@ async def api_remove_task_link(request: Request, task_id: int, project_id: int)
@router.get("/api/projects/{project_id}/activity")
async def api_activity(request: Request, project_id: int) -> JSONResponse:
_require_user(request)
def api_activity(request: Request, project_id: int) -> JSONResponse:
user = _require_user(request)
st = _db_or_503(request)
_require_manage(request, st, user, project_id)
return JSONResponse({"activity": st.list_activity(project_id=project_id, limit=100)})
@@ -1194,7 +1298,7 @@ async def api_activity(request: Request, project_id: int) -> JSONResponse:
# JSON API — 댓글
# ────────────────────────────────────────────────────────────
@router.get("/api/tasks/{task_id}/comments")
async def api_list_comments(request: Request, task_id: int) -> JSONResponse:
def api_list_comments(request: Request, task_id: int) -> JSONResponse:
user = _require_user(request)
st = _db_or_503(request)
task = st.get_task(task_id=task_id)
@@ -1205,7 +1309,7 @@ async def api_list_comments(request: Request, task_id: int) -> JSONResponse:
@router.post("/api/tasks/{task_id}/comments")
async def api_add_comment(
def api_add_comment(
request: Request, task_id: int, payload: dict[str, Any] = Body(...)
) -> JSONResponse:
user = _require_user(request)
@@ -1242,7 +1346,7 @@ async def api_add_comment(
@router.put("/api/comments/{comment_id}")
async def api_update_comment(
def api_update_comment(
request: Request, comment_id: int, payload: dict[str, Any] = Body(...)
) -> JSONResponse:
from app.store import is_admin # noqa: WPS433
@@ -1264,17 +1368,25 @@ async def api_update_comment(
@router.delete("/api/comments/{comment_id}")
async def api_delete_comment(request: Request, comment_id: int) -> JSONResponse:
def api_delete_comment(request: Request, comment_id: int) -> JSONResponse:
from app.store import is_admin # noqa: WPS433
user = _require_user(request)
st = _db_or_503(request)
try:
st.delete_comment(comment_id=comment_id, requester=user["email"], is_admin=is_admin(user))
files = st.delete_comment(
comment_id=comment_id, requester=user["email"], is_admin=is_admin(user)
)
except KeyError:
raise HTTPException(status_code=404, detail="댓글을 찾을 수 없습니다.")
except PermissionError as exc:
raise HTTPException(status_code=403, detail=str(exc))
# 댓글 첨부 행은 CASCADE 로 사라졌다 — 디스크 파일도 치운다.
for f in files:
try:
(_attach_dir(request, f["task_id"]) / f["stored_name"]).unlink(missing_ok=True)
except Exception: # noqa: BLE001
logger.warning("댓글 첨부 파일 삭제 실패: %s", f.get("stored_name"))
return JSONResponse({"ok": True})
@@ -1289,7 +1401,7 @@ def _attach_dir(request: Request, task_id: int) -> Path:
@router.get("/api/tasks/{task_id}/attachments")
async def api_list_attachments(request: Request, task_id: int) -> JSONResponse:
def api_list_attachments(request: Request, task_id: int) -> JSONResponse:
user = _require_user(request)
st = _db_or_503(request)
task = st.get_task(task_id=task_id)
@@ -1300,7 +1412,7 @@ async def api_list_attachments(request: Request, task_id: int) -> JSONResponse:
@router.post("/api/tasks/{task_id}/attachments")
async def api_upload_attachment(
def api_upload_attachment(
request: Request, task_id: int, file: UploadFile = File(...),
comment_id: int | None = Form(None),
) -> JSONResponse:
@@ -1317,7 +1429,9 @@ async def api_upload_attachment(
if comment is None or comment["task_id"] != task_id:
raise HTTPException(status_code=400, detail="잘못된 댓글입니다.")
data = await file.read()
# 한도+1 바이트까지만 읽는다 — 20MB 를 넘는 파일을 끝까지 메모리에 올린 뒤에야
# 거절하던 것을 막는다(핸들러가 sync def 라 스레드풀에서 동기 읽기).
data = file.file.read(_MAX_ATTACH_BYTES + 1)
if len(data) > _MAX_ATTACH_BYTES:
raise HTTPException(status_code=413, detail="파일이 너무 큽니다(최대 20MB).")
if not data:
@@ -1338,7 +1452,7 @@ async def api_upload_attachment(
@router.get("/api/attachments/{attachment_id}/download")
async def api_download_attachment(request: Request, attachment_id: int):
def api_download_attachment(request: Request, attachment_id: int):
user = _require_user(request)
st = _db_or_503(request)
att = st.get_attachment(attachment_id=attachment_id)
@@ -1354,11 +1468,12 @@ async def api_download_attachment(request: Request, attachment_id: int):
return FileResponse(
str(path), filename=att["filename"],
media_type=att.get("content_type") or "application/octet-stream",
headers=_ATTACH_HEADERS,
)
@router.get("/api/attachments/{attachment_id}/inline")
async def api_inline_attachment(request: Request, attachment_id: int):
def api_inline_attachment(request: Request, attachment_id: int):
"""설명란에 붙여넣은/업로드한 이미지를 `<img src=...>` 로 바로 보여주기 위한
서빙. `/download` 는 `filename=` 을 줘서 강제 다운로드(Content-Disposition:
attachment)가 걸리므로 이미지 삽입에는 못 쓴다 — filename 을 안 주면 브라우저가
@@ -1375,11 +1490,20 @@ async def api_inline_attachment(request: Request, attachment_id: int):
path = _attach_dir(request, att["task_id"]) / att["stored_name"]
if not path.exists():
raise HTTPException(status_code=404, detail="파일이 디스크에 없습니다.")
return FileResponse(str(path), media_type=att.get("content_type") or "application/octet-stream")
content_type = att.get("content_type") or "application/octet-stream"
if not store.inline_safe_content_type(content_type):
# 형식은 업로드한 쪽이 정한 값이라 믿을 수 없다 — text/html·svg 등을 같은
# 도메인에서 그대로 띄우면 스크립트가 로그인 세션으로 돈다(저장형 XSS).
# 안전한 이미지가 아니면 항상 다운로드로 내려준다.
return FileResponse(
str(path), filename=att["filename"],
media_type="application/octet-stream", headers=_ATTACH_HEADERS,
)
return FileResponse(str(path), media_type=content_type, headers=_ATTACH_HEADERS)
@router.delete("/api/attachments/{attachment_id}")
async def api_delete_attachment(request: Request, attachment_id: int) -> JSONResponse:
def api_delete_attachment(request: Request, attachment_id: int) -> JSONResponse:
user = _require_user(request)
st = _db_or_503(request)
att = st.get_attachment(attachment_id=attachment_id)
@@ -1400,7 +1524,7 @@ async def api_delete_attachment(request: Request, attachment_id: int) -> JSONRes
# JSON API — 단계 이름/순서 편집
# ────────────────────────────────────────────────────────────
@router.put("/api/projects/{project_id}/stages/order")
async def api_reorder_stages(
def api_reorder_stages(
request: Request, project_id: int, payload: dict[str, Any] = Body(...)
) -> JSONResponse:
user = _require_user(request)
@@ -1414,13 +1538,14 @@ async def api_reorder_stages(
@router.put("/api/projects/{project_id}/stages/{stage_id}/tasks/order")
async def api_reorder_tasks(
def api_reorder_tasks(
request: Request, project_id: int, stage_id: int, payload: dict[str, Any] = Body(...)
) -> JSONResponse:
"""보드에서 카드를 같은 세션 안에서 드래그로 재정렬."""
user = _require_user(request)
st = _db_or_503(request)
_require_manage(request, st, user, project_id)
_stage_of_project(st, stage_id, project_id)
ids = payload.get("ordered_ids") or []
if not isinstance(ids, list) or not ids:
raise HTTPException(status_code=400, detail="ordered_ids 가 필요합니다.")
@@ -1429,12 +1554,13 @@ async def api_reorder_tasks(
@router.put("/api/projects/{project_id}/stages/{stage_id}")
async def api_update_stage(
def api_update_stage(
request: Request, project_id: int, stage_id: int, payload: dict[str, Any] = Body(...)
) -> JSONResponse:
user = _require_user(request)
st = _db_or_503(request)
_require_manage(request, st, user, project_id)
_stage_of_project(st, stage_id, project_id)
try:
stage = st.update_stage(
stage_id=stage_id,
@@ -1453,7 +1579,7 @@ async def api_update_stage(
# 알림센터 (인앱)
# ────────────────────────────────────────────────────────────
@router.get("/api/notifications")
async def api_notifications(request: Request) -> JSONResponse:
def api_notifications(request: Request) -> JSONResponse:
user = _require_user(request)
st = _db_or_503(request)
unread_only = request.query_params.get("unread") in ("1", "true")
@@ -1464,14 +1590,14 @@ async def api_notifications(request: Request) -> JSONResponse:
@router.get("/api/notifications/unread-count")
async def api_notif_count(request: Request) -> JSONResponse:
def api_notif_count(request: Request) -> JSONResponse:
user = _require_user(request)
st = _db_or_503(request)
return JSONResponse({"unread": st.count_unread(recipient_email=user["email"])})
@router.post("/api/notifications/{notification_id}/read")
async def api_notif_read(request: Request, notification_id: int) -> JSONResponse:
def api_notif_read(request: Request, notification_id: int) -> JSONResponse:
user = _require_user(request)
st = _db_or_503(request)
st.mark_read(notification_id=notification_id, recipient_email=user["email"])
@@ -1479,7 +1605,7 @@ async def api_notif_read(request: Request, notification_id: int) -> JSONResponse
@router.post("/api/notifications/read-all")
async def api_notif_read_all(request: Request) -> JSONResponse:
def api_notif_read_all(request: Request) -> JSONResponse:
user = _require_user(request)
st = _db_or_503(request)
n = st.mark_all_read(recipient_email=user["email"])
@@ -1506,7 +1632,7 @@ def _safe_mention_unread(st: Any, email: str) -> int:
@router.get("/api/mentions")
async def api_mentions(request: Request) -> JSONResponse:
def api_mentions(request: Request) -> JSONResponse:
"""나를 태그한 업무 목록 + 미확인 개수."""
user = _require_user(request)
st = _db_or_503(request)
@@ -1518,14 +1644,14 @@ async def api_mentions(request: Request) -> JSONResponse:
@router.get("/api/mentions/unread-count")
async def api_mentions_unread(request: Request) -> JSONResponse:
def api_mentions_unread(request: Request) -> JSONResponse:
user = _require_user(request)
st = _db_or_503(request)
return JSONResponse({"unread": _safe_mention_unread(st, user["email"])})
@router.post("/api/mentions/read")
async def api_mentions_read(
def api_mentions_read(
request: Request, payload: dict[str, Any] = Body(default={})
) -> JSONResponse:
"""태그 확인 처리. task_id 를 주면 그 업무만, 없으면 전부."""
@@ -1543,7 +1669,7 @@ async def api_mentions_read(
@router.get("/inbox", response_class=HTMLResponse)
async def inbox_page(request: Request) -> HTMLResponse:
def inbox_page(request: Request) -> HTMLResponse:
from app.main import build_erp_nav, render_template # noqa: WPS433
from app.store import is_admin # noqa: WPS433
@@ -1558,10 +1684,7 @@ async def inbox_page(request: Request) -> HTMLResponse:
t["due_label"] = _fmt_date_kr(t.get("due_date"))
# 좌측 사이드바(project/_side.html)는 세 화면 공용 — 같은 데이터가 필요하다.
nav_projects = _nav_projects(st, user, admin)
my_open_total = sum(
1 for t in st.list_tasks(assignee_email=user["email"], limit=1000)
if not t.get("completed_at")
)
my_open_total = st.count_my_open(assignee_email=user["email"])
return render_template(
request,
"project/inbox.html",