81b1204693
권한(서버) - 공통 권한 모듈 access.py: 모든 판단을 "지금" 권한으로 — 내 작업·수신함·알림·멘션·검색·상세·공유 링크· 댓글·첨부·알림/메일 수신자에서 권한을 잃은 사람 제외(기록은 이력으로 보존) - 소유자 변경·남을 소유자로 지정한 생성은 관리자만, 새 소유자는 권한 있는 등록 사용자 - 삭제는 생성자 규칙 + 지금 권한(멤버에서 빠진 생성자 거절), 댓글 수정·삭제도 지금 권한 - @태그는 볼 수 있는 사람만(mention_skipped), 태그 후보 all-users?task_id=, 새 담당자 권한 검사 - 연결(멀티호밍) 작업은 연결된 프로젝트 멤버에게 읽기 전용(task_link_scope), 볼 수 없는 연결 프로젝트 숨김 저장·동기화(화면) - 작업 창 세대(taskGen)·블록 ctxSeq 로 늦은 A 응답이 B 를 덮지 않게(A→B, A→B→A, 이미지 업로드 중 전환) - 자동 저장 성공/실패 반환, 실패 칸 재시도, 닫기·전환 전 저장 확인(버리기/계속 편집), 미저장 이탈 경고 - 실시간 동기화 observed/applied 분리·실패 재시도·겹침 방지, snapshot?scope=all 로 전체 범위 반영·권한 회수 안내 - 한국시간 기준 오늘(kstTodayIso), 한글 조합 중 Enter 는 제출하지 않음, 댓글 연타·재전송 중복 방지(client_token) 기타 - 파일 댓글은 본문+파일 한 트랜잭션(POST /comments/files), 실패 파일 표시·유지, 작업 창 댓글에 첨부 표시 - 날짜 범위 검증(부분 수정은 최종 상태), 완료 섹션에 바로 만든 작업 완료 처리·알림 - 마감 알림 발송 기록+수신함 알림 원자적(실패 시 재시도), 권한 없는 수신자 제외 - 테스트: tests/test_project_module.py(로컬 PostgreSQL 11개), tests/js/project_ui.test.js(jsdom 51개) - 문서(PROJECT_MODULE 6-10·도움말·CLAUDE.md), project.js/css 캐시 버전 20260930g, 새 마이그레이션·환경변수 없음 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
198 lines
8.3 KiB
Python
198 lines
8.3 KiB
Python
"""프로젝트 업무 마감 알림 — 아사나의 "마감일 임박/지남" 알림.
|
|
|
|
매일 한 번(기본 09시 KST, 영업일만) 미완료 업무를 훑어 수신함 알림을 만든다.
|
|
· due_soon — 다음 영업일까지 마감(금요일이면 토·일·월 마감분까지)
|
|
· due_today — 오늘 마감
|
|
· overdue — 마감이 지남(최근 7일 이내 마감분만 — 첫 적용 때 오래된 업무가
|
|
한꺼번에 쏟아지지 않게, 연휴로 며칠 건너뛰어도 놓치지 않게)
|
|
수신자는 담당자. 담당자가 없으면 팔로워 전원. 단, 지금 그 작업을 볼 수 있는 사람만.
|
|
|
|
중복 방지: task_reminders(업무, 종류, 마감일, 수신자) UNIQUE — 같은 알림은 한 번만
|
|
간다(재기동·여러 번 실행해도 안전). 마감일을 바꾸면 새 마감일 기준으로 다시 알린다.
|
|
발송 기록과 수신함 알림은 한 트랜잭션이라, 알림 생성이 실패하면 다음 실행에 다시 시도된다.
|
|
|
|
실행 방식: 웹 프로세스 안의 데몬 스레드(start_reminder_thread). 5분마다 깨어나
|
|
"오늘 아직 안 돌았고, 설정 시각이 지났고, 영업일이면" 한 번 돈다. 여러 프로세스가
|
|
동시에 돌아도 위 UNIQUE 덕분에 중복 알림이 없다.
|
|
|
|
환경변수:
|
|
PROJECT_REMINDERS false 면 끈다(기본 켜짐)
|
|
PROJECT_REMINDER_HOUR 실행 시각(KST 0~23, 기본 9)
|
|
PROJECT_REMINDER_EMAIL true 면 수신자에게 메일도 보낸다(사람별 1통 요약, 기본 끔).
|
|
SMTP_* 설정이 있어야 실제로 나간다.
|
|
PUBLIC_BASE_URL 메일 속 업무 링크의 앞부분(예: https://erp.dbxcorp.co.kr)
|
|
"""
|
|
|
|
from __future__ import annotations
|
|
|
|
import logging
|
|
import os
|
|
import threading
|
|
import time
|
|
from datetime import date, timedelta
|
|
from typing import Any
|
|
|
|
from app.timezone import now_kst
|
|
|
|
from . import access, store
|
|
|
|
logger = logging.getLogger("project.reminders")
|
|
|
|
KIND_DUE_SOON = "due_soon"
|
|
KIND_DUE_TODAY = "due_today"
|
|
KIND_OVERDUE = "overdue"
|
|
OVERDUE_WINDOW_DAYS = 7
|
|
|
|
|
|
def _env(name: str, default: str = "") -> str:
|
|
return (os.getenv(name, "") or "").strip() or default
|
|
|
|
|
|
def _env_bool(name: str, default: bool) -> bool:
|
|
v = _env(name).lower()
|
|
if not v:
|
|
return default
|
|
return v in ("1", "true", "yes", "on")
|
|
|
|
|
|
def is_workday(d: date) -> bool:
|
|
return d.weekday() < 5 and not store.holiday_name(d.isoformat())
|
|
|
|
|
|
def next_workday(d: date) -> date:
|
|
n = d + timedelta(days=1)
|
|
while not is_workday(n):
|
|
n += timedelta(days=1)
|
|
return n
|
|
|
|
|
|
def classify(due: date, today: date) -> str | None:
|
|
"""마감일 → 알림 종류(없으면 None)."""
|
|
if due == today:
|
|
return KIND_DUE_TODAY
|
|
if today < due <= next_workday(today):
|
|
return KIND_DUE_SOON
|
|
if today - timedelta(days=OVERDUE_WINDOW_DAYS) <= due < today:
|
|
return KIND_OVERDUE
|
|
return None
|
|
|
|
|
|
def _title_for(kind: str, task: dict[str, Any], today: date) -> str:
|
|
due = date.fromisoformat(task["due_date"][:10])
|
|
if kind == KIND_DUE_TODAY:
|
|
return f"오늘 마감: {task['title']}"
|
|
if kind == KIND_DUE_SOON:
|
|
days = (due - today).days
|
|
when = "내일" if days == 1 else f"{days}일 후"
|
|
return f"마감 임박({when}): {task['title']}"
|
|
return f"마감 지남({(today - due).days}일): {task['title']}"
|
|
|
|
|
|
def run_due_reminders(
|
|
st: Any, *, today: date | None = None, lookup: access.UserLookup | None = None,
|
|
) -> dict[str, int]:
|
|
"""한 번 실행. 새로 만든 알림 수를 종류별로 돌려준다.
|
|
|
|
- 수신자는 지금 그 작업을 볼 수 있는 사람만(access.filter_recipients) — 멤버에서 빠진 담당자·
|
|
협업자, 모듈 권한이 없어진 직원에게는 수신함 알림도 메일도 가지 않는다.
|
|
- 발송 기록(task_reminders)과 수신함 알림은 한 트랜잭션(add_reminder_notification) — 알림 생성이
|
|
실패하면 기록도 되돌려져 다음 실행에서 다시 시도된다. 같은 알림은 UNIQUE 로 한 번만(동시 실행 포함).
|
|
- 보장 범위: 수신함 알림까지. 메일(PROJECT_REMINDER_EMAIL)은 알림이 새로 만들어진 것만 요약해 한 번
|
|
보내며, 메일 발송 실패는 재시도하지 않는다(수신함 알림은 이미 남아 있다).
|
|
"""
|
|
today = today or now_kst().date()
|
|
start = today - timedelta(days=OVERDUE_WINDOW_DAYS)
|
|
end = next_workday(today)
|
|
counts = {KIND_DUE_SOON: 0, KIND_DUE_TODAY: 0, KIND_OVERDUE: 0}
|
|
digest: dict[str, list[tuple[str, dict[str, Any]]]] = {}
|
|
|
|
for t in st.list_open_tasks_due_between(start=start, end=end):
|
|
due = date.fromisoformat(t["due_date"][:10])
|
|
kind = classify(due, today)
|
|
if kind is None:
|
|
continue
|
|
assignee = store.norm_str(t.get("assignee_email"), lower=True)
|
|
wanted = [assignee] if assignee else store.normalize_emails(t.get("followers") or [])
|
|
try:
|
|
recipients = access.filter_recipients(st, t, wanted, lookup)
|
|
except Exception: # noqa: BLE001 - 권한 확인이 안 되면 이번엔 보내지 않는다(다음 실행에 재시도)
|
|
logger.warning("마감 알림 수신자 확인 실패: task=%s", t["id"])
|
|
continue
|
|
for rcpt in recipients:
|
|
title = _title_for(kind, t, today)
|
|
try:
|
|
created = st.add_reminder_notification(
|
|
task_id=t["id"], kind=kind, due_date=t["due_date"][:10], recipient_email=rcpt,
|
|
project_id=t["project_id"], title=title,
|
|
body=f"{t.get('project_name') or ''} · 마감 {t['due_date'][:10]}",
|
|
)
|
|
except Exception: # noqa: BLE001 - 기록도 되돌려졌으니 다음 실행에서 다시 시도
|
|
logger.warning("마감 알림 생성 실패(다음 실행에 재시도): task=%s", t["id"])
|
|
continue
|
|
if not created:
|
|
continue # 이미 보냄
|
|
counts[kind] += 1
|
|
digest.setdefault(rcpt, []).append((title, t))
|
|
|
|
if digest and _env_bool("PROJECT_REMINDER_EMAIL", False):
|
|
_send_digests(digest, today)
|
|
return counts
|
|
|
|
|
|
def _send_digests(digest: dict[str, list[tuple[str, dict[str, Any]]]], today: date) -> None:
|
|
from app.mail import send_email # noqa: WPS433
|
|
|
|
base = _env("PUBLIC_BASE_URL").rstrip("/")
|
|
for rcpt, items in digest.items():
|
|
lines = [f"{today.isoformat()} 마감 알림 — {len(items)}건", ""]
|
|
for title, t in items:
|
|
lines.append(f"· {title} [{t.get('project_name') or ''}]")
|
|
if base:
|
|
lines.append(f" {base}/project/t/{t['id']}")
|
|
send_email(
|
|
to=[rcpt],
|
|
subject=f"[DBX 프로젝트] 마감 알림 {len(items)}건 ({today.isoformat()})",
|
|
body="\n".join(lines) + "\n",
|
|
)
|
|
|
|
|
|
_started = False
|
|
_start_lock = threading.Lock()
|
|
|
|
|
|
def start_reminder_thread(st: Any) -> bool:
|
|
"""웹 프로세스 시작 시 1번. 이미 돌고 있거나 꺼져 있으면 False."""
|
|
global _started # noqa: PLW0603
|
|
if st is None or not _env_bool("PROJECT_REMINDERS", True):
|
|
return False
|
|
with _start_lock:
|
|
if _started:
|
|
return False
|
|
_started = True
|
|
try:
|
|
hour = min(23, max(0, int(_env("PROJECT_REMINDER_HOUR", "9"))))
|
|
except ValueError:
|
|
hour = 9
|
|
|
|
def _loop() -> None:
|
|
last_run: date | None = None
|
|
while True:
|
|
try:
|
|
now = now_kst()
|
|
today = now.date()
|
|
if last_run != today and now.hour >= hour and is_workday(today):
|
|
counts = run_due_reminders(st, today=today)
|
|
last_run = today
|
|
logger.info("마감 알림 실행: %s", counts)
|
|
except Exception as exc: # noqa: BLE001
|
|
if type(exc).__name__ == "UndefinedTable":
|
|
# 008 마이그레이션 미적용 — 오늘은 더 시도하지 않는다(로그 도배 방지)
|
|
logger.warning("마감 알림 skip — project_db_008 마이그레이션 필요")
|
|
last_run = now_kst().date()
|
|
else:
|
|
logger.warning("마감 알림 실패(%s) — 5분 뒤 재시도", type(exc).__name__)
|
|
time.sleep(300)
|
|
|
|
threading.Thread(target=_loop, name="project-reminders", daemon=True).start()
|
|
return True
|