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>
This commit is contained in:
2026-10-26 17:28:21 +09:00
parent e197d3deb3
commit 8c805fdd9c
23 changed files with 2279 additions and 13 deletions
+199
View File
@@ -0,0 +1,199 @@
"""안내문 발송 — 순수 함수(DB 없음): 주소 판별(이메일 / 인스타그램), 리스트 붙여넣기 해석, {이름} 바꾸기, 메일 HTML·DM 글.
- 주소를 보고 정한다: `name@domain.tld` = 메일, `@계정`·`instagram.com/계정`·`ig.me/m/계정`·계정명만(영문·숫자·.·_) = 인스타 DM.
- 본문 `{이름}` = 그 줄 이름. `**굵게**` 는 메일에서 굵은 글씨, DM 에서는 별표만 뺀다(인스타는 서식이 없음). 주소(https://…)는 메일에서 링크.
"""
from __future__ import annotations
import re
from html import escape
from typing import Any
NAME_TAG = "{이름}"
KINDS = ("email", "instagram")
KIND_LABELS = {"email": "메일", "instagram": "DM"}
STATUSES = ("대기", "발송중", "보냄", "실패")
_EMAIL_RE = re.compile(r"^[A-Za-z0-9.!#$%&'*+/=?^_`{|}~-]+@[A-Za-z0-9-]+(\.[A-Za-z0-9-]+)+$")
_IG_USER_RE = re.compile(r"^[A-Za-z0-9._]{1,30}$")
_IG_URL_RE = re.compile(r"^(?:https?://)?(?:www\.|m\.)?(?:instagram\.com|instagr\.am)/([^/?#\s]+)", re.IGNORECASE)
_IG_ME_RE = re.compile(r"^(?:https?://)?ig\.me/m/([^/?#\s]+)", re.IGNORECASE)
# instagram.com 아래 계정이 아닌 주소(게시물·릴스 등)
_IG_RESERVED = {"p", "reel", "reels", "tv", "explore", "stories", "direct", "accounts", "about", "legal", "developer"}
DEFAULT_TEMPLATE: dict[str, Any] = {
"subject": "누적매출 300억. 800만개 판매 신화 미라클통 '미라네주방'입니다.",
"sender_name": "미라네주방",
"ad_label": False,
"footer": "",
"body": """안녕하세요, {이름}님.
주방의 본질을 지키며 6년간 묵묵히 300억 매출의 신화를 써온 **'미라네주방'**입니다.
저희는 지난 6년간 제품력 하나로 국내/해외 800만 개 판매를 돌파하고 호주, 동남아 등 글로벌 시장에서 인정받았습니다.
브랜드의 가치를 지키기 위해 공동구매를 극도로 자제해왔으나,
최근 'ㅎ 인플루언서'와의 PPL 및 전용 상품 협업을 통해 단일 프로젝트 매출 약3억, 누적 약 8억원이라는 놀라운 기록을 확인하였고,
ㄷ'인플루언서'님과는 약 2억원의 매출을 달성하는 등 인플루언서 파트너십의 새로운 가능성을 보았습니다.
이에, 압도적인 신뢰도와 감각을 보유하신 {이름}님과의 공동구매 파트너십을 정중히 제안드립니다.
왜 '미라네주방'이어야 하는가?
시장 점유율로 증명된 '미라클통'의 힘: 누적 800만 개 판매. 이미 시장에서 검증된 제품은 팔로워들에게 구구절절 설명할 필요가 없습니다.
희소성의 가치: 아무나 할 수 있는 공구가 아닙니다. 공구를 지양해온 브랜드이기에 {이름}님의 피드에서 진행되는 공구는 팔로워들에게 더욱 특별한 기회로 인식될 것입니다.
1단계: 검증된 베스트셀러로 화력 확인 (Existing Product)
이미 800만 개가 팔려나가며 시장성이 검증된 ‘미라클통’ 등 기존 베스트셀러 라인으로 공동구매를 진행합니다.
팔로워들에게는 '구하고 싶어도 공구로 만나기 힘들었던 제품'이라는 명분을, 인플루언서님께는 확실한 수익과 유입을 보장합니다.
2단계: 화력 입증 시 {이름}님 전용 상품 개발 (Exclusive Product)
첫 공구에서 유의미한 매출 성과가 확인될 경우, 저희는 즉시 {이름}님만을 위한 전용 상품(PB/콜라보) 개발에 착수합니다.
전용 컬러, 단독 구성, 혹은 니즈를 반영한 신규 기능을 담아, 어디에서도 볼 수 없는 '귀하만의 제품'을 시장에 선보이게 됩니다.
이는 인플루언서로서의 브랜드 가치를 한 단계 높이는 결정적인 계기가 될 것입니다.
"'ㅎ인플루언서님'과의 콜라보 사례를 하단과 같이 사진 공유드립니다."
미라네주방은 단순히 한 번의 공구로 끝나는 관계를 원하지 않습니다.
{이름}님의 감각과 저희의 기술력이 만나 주방용품 시장의 판도를 바꿀 '전용 브랜드'를 함께 만들어가길 희망합니다.
긍정적인 검토 부탁드리며, 미라네주방의 성공 신화에 함께 올라타실 파트너가 되어주시길 기다리겠습니다.
감사합니다.
미라네주방 팀 드림
https://miras.co.kr/""",
}
SUBJECT_MAX, BODY_MAX, FOOTER_MAX = 200, 20000, 2000
def _ig_user(value: str) -> str | None:
v = value.strip().strip("/")
if v.startswith("@"):
v = v[1:]
if not _IG_USER_RE.match(v) or v.startswith(".") or v.endswith(".") or ".." in v:
return None
if v.lower() in _IG_RESERVED:
return None
return v.lower()
def detect(address: Any) -> dict[str, Any]:
"""주소 → {"kind": "email"|"instagram"|None, "handle", "error"}. handle = 이메일 소문자 / 인스타 계정명 소문자."""
raw = str(address or "").strip().strip("<>").strip()
if raw.lower().startswith("mailto:"):
raw = raw[7:]
if not raw:
return {"kind": None, "handle": "", "error": "주소가 비었습니다."}
if "@" in raw and not raw.startswith("@") and "/" not in raw:
if _EMAIL_RE.match(raw) and len(raw) <= 320:
return {"kind": "email", "handle": raw.lower(), "error": ""}
return {"kind": None, "handle": "", "error": f"이메일 주소가 올바르지 않습니다: {raw}"}
for rx in (_IG_ME_RE, _IG_URL_RE):
m = rx.match(raw)
if m:
user = _ig_user(m.group(1))
if user:
return {"kind": "instagram", "handle": user, "error": ""}
return {"kind": None, "handle": "", "error": f"인스타그램 계정 주소가 아닙니다: {raw}"}
user = _ig_user(raw)
if user and (raw.startswith("@") or re.search(r"[A-Za-z]", raw)):
return {"kind": "instagram", "handle": user, "error": ""}
return {"kind": None, "handle": "", "error": f"이메일도 인스타그램 주소도 아닙니다: {raw}"}
def _looks_explicit(part: str) -> bool:
"""이메일·@계정·인스타 주소처럼 '주소'가 분명한 칸인가(계정명만 쓴 칸보다 먼저 주소로 고른다)."""
p = part.strip()
return "@" in p or "instagram.com" in p.lower() or "instagr.am" in p.lower() or "ig.me/" in p.lower()
def parse_line(line: str) -> dict[str, Any] | None:
"""붙여 넣은 한 줄 → {"address", "name", ...detect}. 빈 줄·#주석 = None.
칸 나누기 = 탭 · 쉼표 · (둘 다 없으면) 공백. 주소가 분명한 칸(이메일·@·인스타 링크)을 주소로, 나머지는 이름.
둘 다 분명하지 않으면 '주소, 이름' 순서로 본다."""
s = line.strip()
if not s or s.startswith("#"):
return None
parts = [p.strip() for p in re.split(r"\t|,", s) if p.strip()]
if len(parts) == 1:
parts = s.split()
addr_i = next((i for i, p in enumerate(parts) if _looks_explicit(p) and detect(p)["kind"]), None)
if addr_i is None:
addr_i = next((i for i, p in enumerate(parts) if detect(p)["kind"]), 0)
address = parts[addr_i]
name = " ".join(p for i, p in enumerate(parts) if i != addr_i).strip()
return {"address": address, "name": name[:100], **detect(address)}
def parse_bulk(text: str) -> list[dict[str, Any]]:
"""여러 줄 붙여넣기 → 줄마다 parse_line(빈 줄 건너뜀), 같은 주소는 처음 것만(dup=True 표시)."""
out: list[dict[str, Any]] = []
seen: set[tuple[str, str]] = set()
for i, line in enumerate(str(text or "").splitlines(), 1):
r = parse_line(line)
if r is None:
continue
r["line"] = i
key = (r["kind"] or "", r["handle"])
r["dup"] = bool(r["kind"]) and key in seen
seen.add(key)
out.append(r)
return out
def normalize_template(value: dict[str, Any] | None) -> dict[str, Any]:
"""설정 값 정리 — 빠진 칸은 기본값, 길이 제한."""
v = dict(DEFAULT_TEMPLATE)
for k, val in (value or {}).items():
if k in v:
v[k] = val
v["subject"] = str(v["subject"] or "").strip()[:SUBJECT_MAX]
v["body"] = str(v["body"] or "").replace("\r\n", "\n")[:BODY_MAX]
v["footer"] = str(v["footer"] or "").replace("\r\n", "\n").strip()[:FOOTER_MAX]
v["sender_name"] = str(v["sender_name"] or "").strip()[:60]
v["ad_label"] = bool(v["ad_label"])
return v
def needs_name(template: dict[str, Any]) -> bool:
return NAME_TAG in (template.get("subject") or "") or NAME_TAG in (template.get("body") or "")
def fill(text: str, name: str) -> str:
return str(text or "").replace(NAME_TAG, str(name or "").strip())
def subject_for(template: dict[str, Any], name: str) -> str:
s = fill(template.get("subject") or "", name)
return ("(광고) " + s) if template.get("ad_label") and not s.startswith("(광고)") else s
def _body_text(template: dict[str, Any], name: str) -> str:
body = fill(template.get("body") or "", name).rstrip()
footer = (template.get("footer") or "").strip()
return body + ("\n\n" + fill(footer, name) if footer else "")
def plain_text(template: dict[str, Any], name: str) -> str:
"""메일 글 부분·DM 글 — **굵게** 표시는 별표만 뺀다."""
return re.sub(r"\*\*(.+?)\*\*", r"\1", _body_text(template, name))
_URL_RE = re.compile(r"https?://[^\s<>\"']+")
def html_body(template: dict[str, Any], name: str, image_cids: list[str] | None = None) -> str:
"""메일 HTML — 사용자 글은 늘 escape, **굵게** → <b>, 주소 → 링크, 줄바꿈 그대로, 사진은 본문 아래(cid)."""
text = escape(_body_text(template, name))
text = re.sub(r"\*\*(.+?)\*\*", r"<b>\1</b>", text)
text = _URL_RE.sub(lambda m: f'<a href="{m.group(0)}" style="color:#1a56db">{m.group(0)}</a>', text)
imgs = "".join(f'<p style="margin:12px 0 0"><img src="cid:{c}" alt="" style="max-width:100%;height:auto;border-radius:6px"></p>'
for c in (image_cids or []))
return ('<div style="font-family:Pretendard,\'Malgun Gothic\',sans-serif;font-size:14px;line-height:1.7;color:#111;white-space:pre-wrap">'
f"{text}</div>{imgs}")
def dm_link(handle: str) -> str:
"""인스타 DM 창 — ig.me/m/계정(앱·웹 모두 그 사람과의 대화로)."""
return f"https://ig.me/m/{handle}"
def profile_link(handle: str) -> str:
return f"https://www.instagram.com/{handle}/"