Files
king 8c805fdd9c feat(outreach): 안내문 발송 모듈 — 메일 일괄 발송(본인 Gmail)·인스타 DM 반자동·{이름}
- 새 모듈 app/modules/outreach(권한키 outreach, outreach_db — scripts/sql/outreach_db_init.sql, OUTREACH_DB_URL)
- 리스트 붙여넣기(주소, 이름) → 주소를 보고 메일/DM 판별(store.detect: 이메일·@계정·instagram.com·ig.me·계정명) → 미리보기 → 추가
- 메일 = 고른 줄을 한 UPDATE 로 발송중(두 번 눌러도 한 번) → 백그라운드로 본인 Gmail 한 사람에 한 통(입출고·휴가와 같은 Gmail 연결),
  설정 사진 본문 아래(cid), 보냄/실패·기록. 인스타 = 이름 넣은 문구 복사 + ig.me DM 창 → [보냄] 기록(공식 API 는 첫 DM 불가)
- 설정: 제목·본문 기본 = 미라네주방 공동구매 제안 문구, {이름}·**굵게**, 보내는 이름·끝 문구·(광고) 표시, 사진 10장
- 입출고 Gmail 콜백을 모듈 공용으로(_GMAIL_ORIGINS — vacation·outreach)
- 테스트: 판별·본문·발송(가짜 Gmail)·실제 앱·실제 PG(동시 claim 4번 = 1번)·브라우저

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-26 17:28:21 +09:00

95 lines
4.8 KiB
Python

"""안내문 메일 일괄 발송(2026-10-27) — 보내는 사람 본인 Gmail(입출고·휴가와 같은 Gmail 연결, gmail.send 만)로 한 사람에 한 통.
라우터가 고른 줄을 '발송중'으로 잡은 뒤(db.claim_for_send — 두 번 눌러도 한 번) 응답하고, 이 함수가 백그라운드에서 차례로 보낸다.
줄마다 {이름} 을 바꾼 제목·본문 + 설정 사진(본문 아래, cid)을 만들어 보내고 보냄/실패와 기록(outreach_logs)을 남긴다.
본문에 {이름} 이 있는데 이름이 빈 줄은 보내지 않고 실패('이름 없음'). Gmail 연결이 끊기면 남은 줄은 실패(다시 연결 안내).
"""
from __future__ import annotations
import logging
import time
from typing import Any
from . import store
logger = logging.getLogger("app.outreach.send")
SEND_GAP_SECONDS = 1.0 # 한 통마다 쉬는 시간 — Gmail 이 짧은 시간에 몰린 발송을 막지 않게
def _cid(image_id: int) -> str:
return f"outreach-{image_id}@dbx"
def build_mail(template: dict[str, Any], images: list[dict[str, Any]], *, name: str, sender_name: str, sender_email: str,
to: str) -> bytes:
from app.modules.inout import gmail # noqa: WPS433
cids = [_cid(int(im["id"])) for im in images]
return gmail.build_message(
sender_name=template.get("sender_name") or sender_name, sender_email=sender_email, to=[to], cc=[],
subject=store.subject_for(template, name), text=store.plain_text(template, name),
html=store.html_body(template, name, cids),
inline_images=[{"cid": c, "data": bytes(im["data"])} for c, im in zip(cids, images)],
)
def send_batch(db: Any, inout_store: Any, *, rows: list[dict[str, Any]], user: dict[str, Any],
gap: float = SEND_GAP_SECONDS) -> dict[str, int]:
"""잡아 둔 줄(rows)을 차례로 보낸다 — {"sent", "failed"}. 예외를 밖으로 던지지 않는다(줄마다 결과를 남김)."""
from app.modules.inout import gmail # noqa: WPS433
email = str(user.get("email") or "").lower()
result = {"sent": 0, "failed": 0}
try:
template = db.get_template()
images = db.list_images(with_data=True)
subject_of = lambda r: store.subject_for(template, r["name"]) # noqa: E731
row = inout_store.gmail_token(email) if inout_store is not None else None
refresh = gmail.decrypt_token(email, row["refresh_token_enc"]) if row else None
except Exception as exc: # noqa: BLE001 — 준비 실패 = 잡아 둔 줄 모두 실패(발송중으로 남지 않게)
for r in rows:
db.finish_send(r["id"], ok=False, via="gmail", by=email, subject="", error=f"보낼 준비 실패: {exc}")
result["failed"] = len(rows)
return result
stop_reason = "" if refresh else "Gmail 이 연결되지 않았습니다 — 안내문 발송 → [Gmail 연결] 뒤 다시 보내세요."
need_name = store.needs_name(template)
for i, r in enumerate(rows):
if stop_reason:
db.finish_send(r["id"], ok=False, via="gmail", by=email, subject=subject_of(r), error=stop_reason)
result["failed"] += 1
continue
if need_name and not (r.get("name") or "").strip():
db.finish_send(r["id"], ok=False, via="gmail", by=email, subject=subject_of(r),
error="이름 없음 — 본문에 {이름} 이 있어 이름을 넣은 뒤 다시 보내세요.")
result["failed"] += 1
continue
try:
raw = build_mail(template, images, name=r["name"], sender_name=str(user.get("name") or ""),
sender_email=email, to=r["handle"])
gmail.send(refresh, raw)
except gmail.GmailNotConnected as exc:
try:
inout_store.delete_gmail_token(email)
except Exception: # noqa: BLE001
pass
stop_reason = f"Gmail 연결이 끊겼습니다 — 다시 연결한 뒤 보내세요. ({exc})"
db.finish_send(r["id"], ok=False, via="gmail", by=email, subject=subject_of(r), error=stop_reason)
result["failed"] += 1
continue
except Exception as exc: # noqa: BLE001 — 그 사람만 실패(받는 주소 오류 등), 다음 사람은 계속
db.finish_send(r["id"], ok=False, via="gmail", by=email, subject=subject_of(r), error=str(exc)[:300])
result["failed"] += 1
continue
db.finish_send(r["id"], ok=True, via="gmail", by=email, subject=subject_of(r))
result["sent"] += 1
if gap and i < len(rows) - 1:
time.sleep(gap)
try:
if inout_store is not None and result["sent"]:
inout_store.mark_gmail(email)
except Exception: # noqa: BLE001
pass
logger.info("안내문 메일 %s: 보냄 %s · 실패 %s", email, result["sent"], result["failed"])
return result