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:
@@ -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}/"
|
||||
Reference in New Issue
Block a user