feat(realestate-db): add notify queue + 90-day grace cleanup

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

realestate-lab/app/db.py

@@ -433,6 +433,24 @@ def delete_closed_announcements() -> int:
     return cur.rowcount
 
 
+def delete_old_completed_announcements(grace_days: int = 90) -> int:
+    """winner_date + grace_days 경과한 status='완료' 공고를 삭제.
+    winner_date가 NULL인 행은 안전하게 보존(수동 검토 대상).
+    match_results는 FK CASCADE로 자동 삭제. 삭제된 건수 반환.
+    """
+    with _conn() as conn:
+        cur = conn.execute(
+            """
+            DELETE FROM announcements
+            WHERE status = '완료'
+              AND winner_date IS NOT NULL
+              AND date(winner_date) < date('now', ?)
+            """,
+            (f"-{grace_days} days",),
+        )
+    return cur.rowcount
+
+
 def update_all_statuses():
     """모든 진행중 공고의 status를 날짜 기반으로 재계산."""
     with _conn() as conn:
@@ -691,6 +709,42 @@ def mark_match_read(match_id: int) -> bool:
     return cur.rowcount > 0
 
 
+def get_unnotified_matches(min_score: int) -> List[Dict[str, Any]]:
+    """notified_at IS NULL AND match_score >= min_score 인 매칭과 공고 정보 조인 반환."""
+    with _conn() as conn:
+        rows = conn.execute("""
+            SELECT m.id, m.announcement_id, m.match_score, m.match_reasons, m.eligible_types,
+                   a.house_nm, a.region_name, a.district, a.address,
+                   a.receipt_start, a.receipt_end, a.winner_date,
+                   a.house_secd, a.is_speculative_area, a.is_price_cap, a.pblanc_url
+            FROM match_results m
+            JOIN announcements a ON a.id = m.announcement_id
+            WHERE m.notified_at IS NULL
+              AND m.match_score >= ?
+            ORDER BY m.match_score DESC
+        """, (min_score,)).fetchall()
+    items = []
+    for r in rows:
+        d = {c: r[c] for c in r.keys()}
+        d["match_reasons"] = json.loads(d["match_reasons"]) if d["match_reasons"] else []
+        d["eligible_types"] = json.loads(d["eligible_types"]) if d["eligible_types"] else []
+        items.append(d)
+    return items
+
+
+def mark_matches_notified(match_ids: List[int]) -> None:
+    """주어진 match_results IDs의 notified_at을 현재 시각으로 일괄 업데이트."""
+    if not match_ids:
+        return
+    placeholders = ",".join("?" for _ in match_ids)
+    with _conn() as conn:
+        conn.execute(
+            f"UPDATE match_results SET notified_at = strftime('%Y-%m-%dT%H:%M:%fZ','now') "
+            f"WHERE id IN ({placeholders})",
+            match_ids,
+        )
+
+
 # ── collect_log CRUD ─────────────────────────────────────────────────────────
 
 def save_collect_log(new_count: int, total_count: int, error: str = None):