"""outreach_db PostgreSQL 저장소 — 안내문 발송(2026-10-27). - 연결: 환경변수 `OUTREACH_DB_URL` (예: postgresql://outreach_app:@postgres-db:5432/outreach_db) - 스키마는 앱이 만들지 않는다 — `scripts/sql/outreach_db_init.sql` 을 superuser 가 먼저 적용(앱 계정은 CRUD 만). - 연결 풀은 lazy open — 부팅 때 DB 가 잠시 끊겨도 컨테이너가 죽지 않게(다른 모듈과 같은 방식). """ from __future__ import annotations from datetime import datetime from typing import Any from psycopg.rows import dict_row from psycopg.types.json import Jsonb from psycopg_pool import ConnectionPool from app.timezone import KST from . import store MAX_IMAGES = 10 def _iso(v: Any) -> str: return v.astimezone(KST).isoformat(timespec="seconds") if isinstance(v, datetime) else "" class OutreachDBStore: def __init__(self, dsn: str, *, min_size: int = 1, max_size: int = 4): self._pool = ConnectionPool(conninfo=dsn, min_size=min_size, max_size=max_size, kwargs={"row_factory": dict_row, "autocommit": True}, open=False) self._pool.open(wait=False) def close(self) -> None: self._pool.close() # ── 설정(제목·본문·보내는 이름·끝 문구·(광고)) ───────────────── def get_template(self) -> dict[str, Any]: with self._pool.connection() as conn: row = conn.execute("SELECT value, updated_by, updated_at FROM outreach_settings WHERE key = 'template'").fetchone() t = store.normalize_template(row["value"] if row and isinstance(row["value"], dict) else None) t["updated_by"] = row["updated_by"] if row else "" t["updated_at"] = _iso(row["updated_at"]) if row else "" t["is_default"] = row is None return t def save_template(self, value: dict[str, Any], *, by: str) -> dict[str, Any]: t = store.normalize_template(value) if not t["subject"]: raise ValueError("메일 제목을 쓰세요.") if not store.html_to_text(t["body"]).strip(): raise ValueError("본문을 쓰세요.") if len(t["body"]) > store.BODY_MAX: raise ValueError("본문이 너무 깁니다(서식 포함) — 줄여 주세요.") with self._pool.connection() as conn: conn.execute( "INSERT INTO outreach_settings (key, value, updated_by, updated_at) VALUES ('template', %s, %s, now()) " "ON CONFLICT (key) DO UPDATE SET value = EXCLUDED.value, updated_by = EXCLUDED.updated_by, updated_at = now()", (Jsonb({k: t[k] for k in store.DEFAULT_TEMPLATE}), (by or "").lower()), ) return self.get_template() # ── 메일 본문 아래 사진 ──────────────────────────────── def list_images(self, *, with_data: bool = False) -> list[dict[str, Any]]: cols = "id, filename, width, height, sort_order" + (", data" if with_data else "") with self._pool.connection() as conn: rows = conn.execute(f"SELECT {cols} FROM outreach_images ORDER BY sort_order, id").fetchall() return [dict(r) for r in rows] def get_image(self, image_id: int) -> dict[str, Any] | None: with self._pool.connection() as conn: return conn.execute("SELECT * FROM outreach_images WHERE id = %s", (image_id,)).fetchone() def add_image(self, *, filename: str, data: bytes, width: int, height: int, by: str) -> int: with self._pool.connection() as conn: with conn.transaction(): n = conn.execute("SELECT COUNT(*) AS n, COALESCE(MAX(sort_order), -1) + 1 AS nxt FROM outreach_images").fetchone() if n["n"] >= MAX_IMAGES: raise ValueError(f"사진은 {MAX_IMAGES}장까지 넣을 수 있습니다.") return int(conn.execute( "INSERT INTO outreach_images (filename, data, width, height, sort_order, created_by) " "VALUES (%s, %s, %s, %s, %s, %s) RETURNING id", (filename[:200], data, width, height, int(n["nxt"]), (by or "").lower()), ).fetchone()["id"]) def delete_image(self, image_id: int) -> None: with self._pool.connection() as conn: conn.execute("DELETE FROM outreach_images WHERE id = %s", (image_id,)) def move_image(self, image_id: int, direction: int) -> None: """사진 순서 한 칸 앞/뒤(-1/1).""" ids = [r["id"] for r in self.list_images()] if image_id not in ids: return i = ids.index(image_id) j = i + (-1 if direction < 0 else 1) if not 0 <= j < len(ids): return ids[i], ids[j] = ids[j], ids[i] with self._pool.connection() as conn: conn.execute("UPDATE outreach_images m SET sort_order = v.ord FROM unnest(%s::int[]) WITH ORDINALITY AS v(id, ord) " "WHERE m.id = v.id", (ids,)) # ── 리스트 ─────────────────────────────────────────── @staticmethod def _row(r: dict[str, Any]) -> dict[str, Any]: d = dict(r) d["id"] = int(d["id"]) for k in ("sent_at", "created_at", "updated_at"): d[k] = _iso(d.get(k)) return d def list_recipients(self) -> list[dict[str, Any]]: with self._pool.connection() as conn: rows = conn.execute("SELECT * FROM outreach_recipients ORDER BY id").fetchall() return [self._row(r) for r in rows] def get_recipient(self, rid: int) -> dict[str, Any] | None: with self._pool.connection() as conn: r = conn.execute("SELECT * FROM outreach_recipients WHERE id = %s", (rid,)).fetchone() return self._row(r) if r else None def add_recipients(self, rows: list[dict[str, Any]], *, by: str) -> dict[str, int]: """[{address, name}] 추가 — 주소를 보고 메일/DM 을 정한다. 이미 있는 주소는 이름만 비어 있으면 채우고 건너뜀. 반환 {added, existed, invalid}. 틀린 주소는 저장하지 않고 센다(화면이 미리 보여 줌).""" out = {"added": 0, "existed": 0, "invalid": 0} who = (by or "").lower() with self._pool.connection() as conn: with conn.transaction(): for r in rows: d = store.detect(r.get("address")) if not d["kind"]: out["invalid"] += 1 continue name = str(r.get("name") or "").strip()[:100] got = conn.execute( "INSERT INTO outreach_recipients (kind, handle, address, name, created_by) VALUES (%s, %s, %s, %s, %s) " "ON CONFLICT (kind, handle) DO UPDATE SET name = CASE WHEN outreach_recipients.name = '' " "THEN EXCLUDED.name ELSE outreach_recipients.name END RETURNING (xmax = 0) AS inserted", (d["kind"], d["handle"], str(r.get("address") or "").strip()[:320], name, who), ).fetchone() out["added" if got["inserted"] else "existed"] += 1 return out def update_recipient(self, rid: int, *, name: Any = None, memo: Any = None, status: Any = None) -> dict[str, Any]: sets, params = [], [] if name is not None: sets.append("name = %s") params.append(str(name).strip()[:100]) if memo is not None: sets.append("memo = %s") params.append(str(memo).strip()[:500]) if status is not None: if status != "대기": raise ValueError("상태는 '대기'(다시 보내기)로만 바꿀 수 있습니다.") sets += ["status = '대기'", "last_error = ''"] if not sets: raise ValueError("바꿀 내용이 없습니다.") with self._pool.connection() as conn: r = conn.execute(f"UPDATE outreach_recipients SET {', '.join(sets)} WHERE id = %s RETURNING *", (*params, rid)).fetchone() if not r: raise KeyError(rid) return self._row(r) def delete_recipients(self, ids: list[int]) -> int: with self._pool.connection() as conn: cur = conn.execute("DELETE FROM outreach_recipients WHERE id = ANY(%s) AND status <> '발송중'", ([int(i) for i in ids],)) return cur.rowcount # ── 보내기 ─────────────────────────────────────────── def claim_for_send(self, ids: list[int]) -> list[dict[str, Any]]: """메일 일괄 발송 — 고른 줄 중 메일·대기/실패만 '발송중'으로 바꾸며 가져온다(한 UPDATE — 두 번 눌러도·두 사람이 눌러도 한 번만).""" with self._pool.connection() as conn: rows = conn.execute( "UPDATE outreach_recipients SET status = '발송중', last_error = '' " "WHERE id = ANY(%s) AND kind = 'email' AND status IN ('대기', '실패') RETURNING *", ([int(i) for i in ids],), ).fetchall() return sorted((self._row(r) for r in rows), key=lambda r: r["id"]) def finish_send(self, rid: int, *, ok: bool, via: str, by: str, subject: str, error: str = "") -> None: with self._pool.connection() as conn: with conn.transaction(): r = conn.execute( "UPDATE outreach_recipients SET status = %s, sent_at = CASE WHEN %s THEN now() ELSE sent_at END, " "sent_by = CASE WHEN %s THEN %s ELSE sent_by END, sent_via = CASE WHEN %s THEN %s ELSE sent_via END, " "last_error = %s WHERE id = %s RETURNING kind, address, name", ("보냄" if ok else "실패", ok, ok, (by or "").lower(), ok, via, (error or "")[:500], rid), ).fetchone() if r: conn.execute( "INSERT INTO outreach_logs (recipient_id, kind, address, name, subject, via, sent_by, ok, error) " "VALUES (%s, %s, %s, %s, %s, %s, %s, %s, %s)", (rid, r["kind"], r["address"], r["name"], (subject or "")[:300], via, (by or "").lower(), ok, (error or "")[:500]), ) def mark_dm_sent(self, rid: int, *, by: str, subject: str) -> dict[str, Any]: """DM [보냄] — 인스타 줄만(사람이 DM 창에서 보낸 뒤 누름).""" r = self.get_recipient(rid) if r is None: raise KeyError(rid) if r["kind"] != "instagram": raise ValueError("메일 줄은 [일괄 발송]으로 보냅니다.") self.finish_send(rid, ok=True, via="dm", by=by, subject=subject) return self.get_recipient(rid) # type: ignore[return-value] def release_stuck(self) -> int: """서버가 보내던 중 멈춘 줄(발송중)을 실패로 — 서버 시작 때(앱은 프로세스 하나, 보내기는 메모리 작업).""" with self._pool.connection() as conn: cur = conn.execute("UPDATE outreach_recipients SET status = '실패', last_error = '보내던 중 서버가 다시 시작됨 — 다시 보내세요' " "WHERE status = '발송중'") return cur.rowcount def list_logs(self, *, limit: int = 200) -> list[dict[str, Any]]: with self._pool.connection() as conn: rows = conn.execute("SELECT * FROM outreach_logs ORDER BY sent_at DESC, id DESC LIMIT %s", (limit,)).fetchall() out = [] for r in rows: d = dict(r) d["sent_at"] = _iso(d["sent_at"]) out.append(d) return out