Files
dbx-main/app/modules/project/reminders.py
T
king 78b6e8df11 feat(project): 검색·필터·정렬 + 팔로워 + 마감 알림
검색·필터·정렬
- 좌측 사이드바 전체 검색(/api/search): 제목·설명·댓글, 볼 수 있는
  프로젝트의 업무(하위 업무 포함). 설명 HTML 태그에만 걸린 결과는 본문
  텍스트로 재확인해 제거. 어디서 걸렸는지 + 미리보기, 키보드(/ ↑↓ Enter).
- 프로젝트 화면 필터 바: 찾기·상태·담당자·마감·우선순위·정렬. visibleTasks()
  에서 걸러 보드/리스트/달력/타임라인/대시보드 모두 적용, 프로젝트별 기억.
  필터·정렬 중엔 보드 카드 순서 드래그 차단.
- 내 업무 화면에도 찾기·마감·우선순위 필터.

팔로워 · 알림
- task_followers(008): 만든 사람·담당자·댓글 작성자·@태그된 사람 자동 팔로우,
  기존 업무 백필. 업무 팝업에서 추가/빼기/내 팔로우 토글.
- 완료·댓글 인앱 알림 수신자: 프로젝트 멤버 전원 → 담당자 + 팔로워.
  008 미적용이면 예전 방식 폴백.
- 마감 알림(reminders.py, lifespan 에서 데몬 스레드): 영업일(주말·공휴일
  skip) 09시 KST 1회, 다음 영업일까지 마감/오늘 마감/지남(7일 이내).
  수신자 담당자(없으면 팔로워). task_reminders UNIQUE 로 중복 방지, 마감일
  바뀌면 재알림. PROJECT_REMINDER_EMAIL=true 면 요약 메일.
- 008: pg_trgm GIN 인덱스(제목·설명·댓글), 미완료 마감일 부분 인덱스.

버그
- 업무 팝업 담당자 선택지가 프로젝트 멤버뿐이라, 멤버 목록에 없는 담당자
  (프로젝트 owner, 멤버에서 빠진 사람)의 업무를 열고 저장하면 담당자가
  지워지던 문제 수정.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-23 13:28:19 +09:00

184 lines
7.0 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 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