"""프로젝트 업무 마감 알림 — 아사나의 "마감일 임박/지남" 알림. 매일 한 번(기본 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 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) -> dict[str, int]: """한 번 실행. 새로 만든 알림 수를 종류별로 돌려준다.""" 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) recipients = [assignee] if assignee else store.normalize_emails(t.get("followers") or []) for rcpt in recipients: if not st.record_reminder( task_id=t["id"], kind=kind, due_date=t["due_date"][:10], recipient_email=rcpt, ): continue # 이미 보냄 title = _title_for(kind, t, today) try: st.add_notification( recipient_email=rcpt, actor_email="", project_id=t["project_id"], task_id=t["id"], type=kind, title=title, body=f"{t.get('project_name') or ''} · 마감 {t['due_date'][:10]}", ) except Exception: # noqa: BLE001 logger.warning("마감 알림 생성 실패: task=%s", t["id"]) 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