diff --git a/app/modules/outreach/CLAUDE.md b/app/modules/outreach/CLAUDE.md
index 18a0cfd..e6a831d 100644
--- a/app/modules/outreach/CLAUDE.md
+++ b/app/modules/outreach/CLAUDE.md
@@ -2,7 +2,7 @@
> 이 모듈만 고칠 때 읽는 요약. 별도 상세 문서 없음 — 코드가 기준.
> 정적 파일: `app/static/outreach.js`, `app/static/outreach.css`. 템플릿: `templates/outreach/`. 테스트: `tests/test_outreach.py`,
-> `tests/js/outreach.browser.test.js`(`render_outreach.py`).
+> `tests/js/outreach.browser.test.js`·`outreach_settings.browser.test.js`(`render_outreach.py`). 편집기 = `app/static/vendor/quill/`(Quill 2.0.3, BSD).
> 다른 모듈과 연결: 메일 = 입출고 Gmail 연결(`inout_store.inout_gmail_tokens`, `app/modules/inout/gmail.py`, 콜백 `/inout/gmail/callback` 이
> 세션 `_gmail_origin=outreach` 를 보고 `_GMAIL_ORIGINS` 로 처리) — 입출고·휴가와 같은 연결.
@@ -10,14 +10,21 @@
- **주소를 보고 메일/DM 판별**(`store.detect`): `name@domain.tld` = 메일, `@계정`·`instagram.com/계정`·`ig.me/m/계정`·계정명만(영문·숫자·.·_) = 인스타 DM.
게시물 주소(`/p/`·`/reel/`)·한글만은 오류. 같은 주소는 한 번(`UNIQUE(kind, handle)`, 이메일·계정명 소문자).
- 리스트 추가 = 붙여넣기(한 줄에 한 사람 `주소, 이름` — 쉼표·탭·띄어쓰기, 순서는 어느 쪽이든, `store.parse_line`) → [미리보기](메일/DM/오류·중복·이미 있음) → [리스트에 추가].
-- **본문 `{이름}`** = 그 줄 이름(제목에도). 이름이 빈 줄은 보내지 않고 실패('이름 없음'), 화면에 "이름 필요" 표시. `**굵게**` = 메일 굵은 글씨(DM 은 별표만 뺌), 주소 = 메일 링크.
+- **본문 `{이름}`** = 그 줄 이름(제목에도). 이름이 빈 줄은 보내지 않고 실패('이름 없음'), 화면에 "이름 필요" 표시.
+- **메일 본문 = HTML**(설정 편집기, `fmt: "html"`) — 저장·읽을 때마다 `store.sanitize_html`(허용 태그 p·br·strong·em·u·s·span·a·ul·ol·li 등,
+ style 은 color·background-color·font-size·font-weight·font-style·text-decoration·text-align 만, 링크는 http(s)/mailto, ` ` → 띄어쓰기, 빈 문단 = `
`).
+ 예전 글·기본 문구(`fmt` 없음) = `text_to_html`(줄마다 문단, `**굵게**`, 주소 링크). 메일 글 버전·DM 대체 글·{이름} 찾기 = `html_to_text`.
+ `{이름}` 은 글자마다 서식이 달라도 `fill_html` 이 바꾼다. 메일 HTML 은 `
` 에 margin:0(메일 프로그램 문단 여백 없앰). - **메일** = [고른 메일 보내기] → `db.claim_for_send`(고른 줄 중 메일·대기/실패만 '발송중'으로 한 UPDATE — 두 번 눌러도·두 사람이 눌러도 한 번) → `send.send_batch`(백그라운드, **보내는 사람 본인 Gmail**, 한 사람에 한 통·1초 간격, 설정 사진 = 본문 아래 cid) → 보냄/실패 + `outreach_logs`. Gmail 연결 없으면 409(화면이 [Gmail 연결] 안내), 끊기면 남은 줄 실패. 서버 재시작 때 남은 '발송중' = 실패(`release_stuck`). - **인스타 DM = 반자동** — 인스타 공식 API 는 처음 연락하는 사람에게 DM 을 보낼 수 없다(상대가 먼저 보낸 24시간 안만, 자동 DM 은 약관 위반·계정 정지 위험). [DM 보내기] = 그 사람 이름이 든 문구 복사 + `https://ig.me/m/계정` 새 탭(누르는 순간 — 문구는 리스트 데이터에 미리 담음) → 붙여 넣어 보낸 뒤 [보냄](`dm-sent`, 기록). - **DM 문구** = 설정 `dm_body`(`store.dm_text`, 최대 1000자 `DM_MAX`, `{이름}`, 별표만 뺌) — 비어 있으면 메일 본문 + 끝 문구. "이름 필요"도 구분별(`needs_name(t, kind)`). -- **설정** `/outreach/settings`(모듈 권한자 누구나): 메일 제목·본문(기본 = 미라네주방 공동구매 제안 문구, `store.DEFAULT_TEMPLATE`)·보내는 이름·끝 문구(수신 거부 안내 등)·인스타 DM 문구(2026-10-27)· - 제목 앞 "(광고)" — 영리 목적 광고성 메일은 정보통신망법 제50조(제목 "(광고)"·수신 거부 방법) 대상일 수 있어 칸을 둠(법무 확인 권장). - 본문 아래 사진 최대 10장(서버가 가로 700px JPEG 로 줄여 `outreach_images` 에, 순서 ◀▶). [기본 문구로 되돌리기] = 칸만(저장해야 적용). + **DM 문구** = 설정 `dm_body`(글, `store.dm_text`, 최대 1000자 `DM_MAX`, `{이름}`, 별표만 뺌) — 비어 있으면 메일 본문 글 + 끝 문구. "이름 필요"도 구분별(`needs_name(t, kind)`). +- **설정** `/outreach/settings`(모듈 권한자 누구나) — **세로 2단**: 왼쪽 메일(제목·"(광고)"·보내는 이름·본문 서식 편집기·끝 문구·본문 아래 사진), + 오른쪽 인스타 DM(서식 없는 편집기·글자 수·[메일 본문 글 가져오기]), 위 막대 [저장]·[기본 문구로 되돌리기](칸만, 저장해야 적용) — 1100px 아래는 위아래. + 입력 칸은 `form="otr-set-form"` 으로 위 막대 폼에 묶음(사진 폼과 겹치지 않게). 편집기 = Quill snow(글자 크기 px·굵게·기울임·밑줄·취소선·글자/배경 색·정렬·목록·링크·서식 지우기·되돌리기), + 저장 = `getSemanticHTML()` → `body`(fmt=html), DM `getText()` → `dm_body`. **`{이름}` 빨강 굵게 = 화면에서만**(class `otr-nametag-on`, 서버 정리 때 class 가 빠져 메일에는 안 남음). + 기본 본문 = 미라네주방 공동구매 제안 문구(`store.DEFAULT_TEMPLATE`, 글). "(광고)" — 영리 목적 광고성 메일은 정보통신망법 제50조 대상일 수 있어 칸을 둠(법무 확인 권장). + 본문 아래 사진 최대 10장(서버가 가로 700px JPEG 로 줄여 `outreach_images` 에, 순서 ◀▶). - 리스트 줄: 이름 바로 고치기(칸 떠나면 저장), [미리보기](메일 = 제목·HTML, DM = 글), 고른 줄 다시 대기·지우기(발송중은 못 지움), 걸러 보기(전체·메일·DM·대기·보냄·실패). diff --git a/app/modules/outreach/db.py b/app/modules/outreach/db.py index 1e4ee4e..040d8ee 100644 --- a/app/modules/outreach/db.py +++ b/app/modules/outreach/db.py @@ -48,8 +48,10 @@ class OutreachDBStore: t = store.normalize_template(value) if not t["subject"]: raise ValueError("메일 제목을 쓰세요.") - if not t["body"].strip(): + 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()) " diff --git a/app/modules/outreach/router.py b/app/modules/outreach/router.py index b102674..1b4c67d 100644 --- a/app/modules/outreach/router.py +++ b/app/modules/outreach/router.py @@ -136,7 +136,8 @@ def index(request: Request) -> Any: rows = [_view(r, template) for r in st.list_recipients()] return _render(request, "outreach/index.html", user, { "page_title": "안내문 발송", "page_subtitle": "메일 일괄 발송 · 인스타 DM", - "template": template, "images": st.list_images(), "rows": rows, "logs": st.list_logs(limit=50), + "template": template, "body_text": store.html_to_text(template["body"]), "needs_name": store.needs_name(template), + "images": st.list_images(), "rows": rows, "logs": st.list_logs(limit=50), "gmail": _gmail_state(request, user), "msg": request.query_params.get("msg", ""), }) @@ -149,19 +150,22 @@ def settings_page(request: Request) -> Any: st, user = got return _render(request, "outreach/settings.html", user, { "page_title": "안내문 발송 — 설정", "page_subtitle": "메일 제목 · 본문 · DM 문구 · 사진", - "template": st.get_template(), "default": store.DEFAULT_TEMPLATE, "images": st.list_images(), + "template": st.get_template(), "default": store.normalize_template(None), "images": st.list_images(), "max_images": 10, "dm_max": store.DM_MAX, "msg": request.query_params.get("msg", ""), }) @router.post("/settings") def settings_save(request: Request, subject: str = Form(""), body: str = Form(""), sender_name: str = Form(""), - footer: str = Form(""), ad_label: str = Form(""), dm_body: str = Form("")) -> RedirectResponse: + footer: str = Form(""), ad_label: str = Form(""), dm_body: str = Form(""), + fmt: str = Form("text")) -> RedirectResponse: + """body = 설정 화면 편집기 HTML(fmt=html, 서버가 다시 정리) — fmt 없이 오면 글로 본다.""" user = _user(request) st = _db(request) try: st.save_template({"subject": subject, "body": body, "sender_name": sender_name, "footer": footer, "dm_body": dm_body, - "ad_label": ad_label in ("1", "on", "true")}, by=user["email"]) + "ad_label": ad_label in ("1", "on", "true"), "fmt": "html" if fmt == "html" else "text"}, + by=user["email"]) except ValueError as exc: raise HTTPException(status_code=400, detail=str(exc)) return RedirectResponse(url="/outreach/settings?" + urlencode({"msg": "설정을 저장했습니다."}), status_code=303) diff --git a/app/modules/outreach/store.py b/app/modules/outreach/store.py index 47b8325..5511d4e 100644 --- a/app/modules/outreach/store.py +++ b/app/modules/outreach/store.py @@ -1,14 +1,16 @@ """안내문 발송 — 순수 함수(DB 없음): 주소 판별(이메일 / 인스타그램), 리스트 붙여넣기 해석, {이름} 바꾸기, 메일 HTML·DM 글. - 주소를 보고 정한다: `name@domain.tld` = 메일, `@계정`·`instagram.com/계정`·`ig.me/m/계정`·계정명만(영문·숫자·.·_) = 인스타 DM. -- 본문 `{이름}` = 그 줄 이름. `**굵게**` 는 메일에서 굵은 글씨, DM 에서는 별표만 뺀다(인스타는 서식이 없음). 주소(https://…)는 메일에서 링크. -- DM 글 = 설정 `dm_body`(인스타 DM 용 문구). 비어 있으면 메일 본문 + 끝 문구. +- 본문 `{이름}` = 그 줄 이름. 메일 본문 = 설정 화면 편집기의 HTML(`fmt: "html"`) — 저장·읽을 때마다 `sanitize_html`(허용 태그·스타일만). + 예전 글·기본 문구(`fmt` 없음 = 글)는 `text_to_html`(`**굵게**` → 굵게, 주소 → 링크, 줄마다 문단). +- DM 글 = 설정 `dm_body`(인스타 DM 용 글, 서식 없음). 비어 있으면 메일 본문 글 + 끝 문구. """ from __future__ import annotations import re from html import escape +from html.parser import HTMLParser from typing import Any NAME_TAG = "{이름}" @@ -29,6 +31,7 @@ DEFAULT_TEMPLATE: dict[str, Any] = { "ad_label": False, "footer": "", "dm_body": "", + "fmt": "text", # body 형식 — 기본 문구는 글, 설정 화면에서 저장하면 "html" "body": """안녕하세요, {이름}님. 주방의 본질을 지키며 6년간 묵묵히 300억 매출의 신화를 써온 **'미라네주방'**입니다. 저희는 지난 6년간 제품력 하나로 국내/해외 800만 개 판매를 돌파하고 호주, 동남아 등 글로벌 시장에서 인정받았습니다. @@ -62,7 +65,7 @@ DEFAULT_TEMPLATE: dict[str, Any] = { 미라네주방 팀 드림 https://miras.co.kr/""", } -SUBJECT_MAX, BODY_MAX, FOOTER_MAX = 200, 20000, 2000 +SUBJECT_MAX, BODY_MAX, FOOTER_MAX = 200, 100000, 2000 # BODY_MAX = 정리한 HTML 길이 DM_MAX = 1000 # 인스타 DM 한 통 글자 수 한도 @@ -148,7 +151,9 @@ def normalize_template(value: dict[str, Any] | None) -> dict[str, Any]: 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] + body = str(v["body"] or "")[:BODY_MAX * 3] + v["body"] = sanitize_html(body if v["fmt"] == "html" else text_to_html(body)) + v["fmt"] = "html" v["footer"] = str(v["footer"] or "").replace("\r\n", "\n").strip()[:FOOTER_MAX] v["dm_body"] = str(v["dm_body"] or "").replace("\r\n", "\n").strip()[:DM_MAX] v["sender_name"] = str(v["sender_name"] or "").strip()[:60] @@ -160,9 +165,10 @@ def needs_name(template: dict[str, Any], kind: str = "email") -> bool: """그 구분(메일/DM)으로 갈 글에 {이름}이 있는가 — DM 은 DM 문구(없으면 메일 본문)만 본다.""" if kind == "instagram" and (template.get("dm_body") or "").strip(): return NAME_TAG in template["dm_body"] + body = html_to_text(template.get("body") or "") if kind == "instagram": - return NAME_TAG in (template.get("body") or "") or NAME_TAG in (template.get("footer") or "") - return NAME_TAG in (template.get("subject") or "") or NAME_TAG in (template.get("body") or "") + return NAME_TAG in body or NAME_TAG in (template.get("footer") or "") + return NAME_TAG in (template.get("subject") or "") or NAME_TAG in body def fill(text: str, name: str) -> str: @@ -174,17 +180,13 @@ def subject_for(template: dict[str, Any], name: str) -> str: 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() +def plain_text(template: dict[str, Any], name: str) -> str: + """메일 글 부분(HTML 메일의 글 버전)·DM 문구가 없을 때의 DM 글 — 본문 글 + 끝 문구.""" + body = fill(html_to_text(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)) - - def dm_text(template: dict[str, Any], name: str) -> str: """인스타 DM 글 — DM 문구가 있으면 그것, 없으면 메일 글(plain_text). **굵게** 는 별표만 뺀다.""" dm = (template.get("dm_body") or "").strip() @@ -193,18 +195,158 @@ def dm_text(template: dict[str, Any], name: str) -> str: return re.sub(r"\*\*(.+?)\*\*", r"\1", fill(dm, name)) +# ── 메일 본문 HTML ───────────────────────────────────────── _URL_RE = re.compile(r"https?://[^\s<>\"']+") +_ALLOWED_TAGS = {"p", "br", "strong", "b", "em", "i", "u", "s", "strike", "span", "a", "ul", "ol", "li", + "h1", "h2", "h3", "blockquote", "sub", "sup"} +_DROP_WITH_CONTENT = {"script", "style", "iframe", "object", "head", "title", "template", "noscript", "svg", "math", + "textarea", "select"} +_STYLE_PROPS = {"color", "background-color", "font-size", "font-weight", "font-style", "text-decoration", "text-align"} +_STYLE_VALUE_RE = re.compile(r"^[#\w\s.,%()-]{1,60}$") +# {이름} — 편집기에서 글자마다 서식이 달라 태그가 끼어도 찾는다(태그는 남기고 글자만 이름으로) +_NAME_IN_HTML_RE = re.compile(r"\{((?:<[^>]*>)*)이((?:<[^>]*>)*)름((?:<[^>]*>)*)\}") + + +def _clean_style(value: str) -> str: + out = [] + for decl in value.split(";"): + prop, _, val = decl.partition(":") + prop, val = prop.strip().lower(), val.strip() + if prop in _STYLE_PROPS and _STYLE_VALUE_RE.match(val) and not re.search(r"url|expression", val, re.I): + out.append(f"{prop}: {val}") + return "; ".join(out) + + +class _Sanitizer(HTMLParser): + """허용 태그·속성(style 은 글자 서식만, a 는 http(s)/mailto 링크만)만 남기고 글은 escape. 태그 짝은 맞춰 닫는다. + 편집기(Quill getSemanticHTML)가 띄어쓰기를 로 내보내 보통 띄어쓰기로 바꾼다(메일은 pre-wrap 이라 여러 칸도 그대로).""" + + def __init__(self) -> None: + super().__init__(convert_charrefs=True) + self.out: list[str] = [] + self.stack: list[str] = [] + self.skip = 0 + self.empty_p = False # 지금 연
에 아직 글이 없다 — 닫을 때
을 넣어 빈 줄 높이를 지킨다
+
+ def handle_starttag(self, tag: str, attrs: list[tuple[str, str | None]]) -> None:
+ if tag in _DROP_WITH_CONTENT:
+ self.skip += 1
+ return
+ if self.skip or tag not in _ALLOWED_TAGS:
+ return
+ if tag == "br":
+ self.out.append("
")
+ self.empty_p = False
+ return
+ a = {k: v or "" for k, v in attrs}
+ extra = ""
+ style = _clean_style(a.get("style", ""))
+ if style:
+ extra += f' style="{escape(style)}"'
+ href = a.get("href", "").strip()
+ if tag == "a" and re.match(r"^(https?:|mailto:)", href, re.I):
+ extra += f' href="{escape(href)}"'
+ self.out.append(f"<{tag}{extra}>")
+ self.stack.append(tag)
+ if tag == "p":
+ self.empty_p = True
+
+ def handle_endtag(self, tag: str) -> None:
+ if tag in _DROP_WITH_CONTENT:
+ self.skip = max(0, self.skip - 1)
+ return
+ if self.skip or tag not in self.stack:
+ return
+ while self.stack:
+ t = self.stack.pop()
+ if t == "p" and self.empty_p:
+ self.out.append("
")
+ self.empty_p = False
+ self.out.append(f"{t}>")
+ if t == tag:
+ break
+
+ def handle_data(self, data: str) -> None:
+ if self.skip:
+ return
+ text = data.replace("\r", "").replace("\n", " ").replace("\xa0", " ")
+ if not text.strip() and (not self.stack or self.stack[-1] in ("ul", "ol")):
+ return
+ if text:
+ self.out.append(escape(text, quote=False))
+ self.empty_p = False
+
+ def result(self) -> str:
+ self.close()
+ while self.stack:
+ self.handle_endtag(self.stack[-1])
+ return "".join(self.out)
+
+
+def sanitize_html(html: str) -> str:
+ p = _Sanitizer()
+ p.feed(str(html or ""))
+ return p.result()
+
+
+def text_to_html(text: str) -> str:
+ """글(예전 본문·기본 문구) → 본문 HTML — 줄마다 문단, 빈 줄 =
{h or '
'}
에 위아래 여백을 줘 편집기보다 줄 간격이 벌어진다 — margin:0 을 붙인다.""" + return re.sub(r'
str: - """메일 HTML — 사용자 글은 늘 escape, **굵게** → , 주소 → 링크, 줄바꿈 그대로, 사진은 본문 아래(cid).""" - text = escape(_body_text(template, name)) - text = re.sub(r"\*\*(.+?)\*\*", r"\1", text) - text = _URL_RE.sub(lambda m: f'{m.group(0)}', text) + """메일 HTML — 본문(정리된 편집기 HTML, {이름} 바꿈) + 끝 문구(글 → escape·링크) + 사진은 본문 아래(cid).""" + body = fill_html(sanitize_html(template.get("body") or ""), name) + footer = (template.get("footer") or "").strip() + if footer: + body += "
{{ msg }}
{% endif %} -