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
+256
View File
@@ -0,0 +1,256 @@
/* 안내문 발송(2026-10-27) — 리스트 화면: 붙여 넣기 → 미리보기(메일/DM/오류) → 추가, 걸러 보기, 이름 고치기,
메일 = 고른 줄 [고른 메일 보내기](서버가 본인 Gmail 로 한 통씩, 보내는 동안 2초마다 다시 읽음),
DM = [DM 보내기](그 사람 이름이 들어간 문구를 클립보드에 + ig.me DM 창을 새 탭) → [보냄]. 설정 화면 = [기본 문구로 되돌리기]. */
(function () {
"use strict";
function esc(s) {
return String(s == null ? "" : s).replace(/[&<>"']/g, function (c) {
return { "&": "&amp;", "<": "&lt;", ">": "&gt;", '"': "&quot;", "'": "&#39;" }[c];
});
}
async function api(method, url, body) {
const res = await fetch(url, { method: method, headers: body ? { "Content-Type": "application/json" } : {},
body: body ? JSON.stringify(body) : undefined, credentials: "same-origin" });
let data = {};
try { data = await res.json(); } catch (_) { data = {}; }
if (!res.ok) { const e = new Error(data.message || data.detail || ("HTTP " + res.status)); e.status = res.status; e.data = data; throw e; }
return data;
}
function toast(msg, bad) {
let el = document.getElementById("otr-toast");
if (!el) { el = document.createElement("div"); el.id = "otr-toast"; el.className = "otr-toast"; document.body.appendChild(el); }
el.textContent = msg;
el.classList.toggle("is-bad", !!bad);
el.hidden = false;
clearTimeout(el._t);
el._t = setTimeout(function () { el.hidden = true; }, 4000);
}
async function copyText(text) {
try { await navigator.clipboard.writeText(text); return true; } catch (_) { /* 아래로 */ }
const ta = document.createElement("textarea");
ta.value = text; ta.style.position = "fixed"; ta.style.top = "-1000px";
document.body.appendChild(ta); ta.select();
let ok = false;
try { ok = document.execCommand("copy"); } catch (_) { ok = false; }
ta.remove();
return ok;
}
// ── 설정 화면 ──
const defBtn = document.getElementById("otr-default");
if (defBtn) {
defBtn.addEventListener("click", function () {
let d = {};
try { d = JSON.parse(document.getElementById("otr-default-data").textContent); } catch (_) { d = {}; }
if (!confirm("제목·본문·보내는 이름·끝 문구를 기본 문구로 바꿀까요? ([저장]을 눌러야 적용)")) return;
const f = document.getElementById("otr-set-form");
f.subject.value = d.subject || "";
f.body.value = d.body || "";
f.sender_name.value = d.sender_name || "";
f.footer.value = d.footer || "";
f.ad_label.checked = !!d.ad_label;
});
}
// ── 리스트 화면 ──
const root = document.getElementById("otr");
const tbody = document.getElementById("otr-tbody");
if (!root || !tbody) return;
let rows = [];
try { rows = JSON.parse(document.getElementById("otr-data").textContent).rows || []; } catch (_) { rows = []; }
let filter = "all";
const picked = new Set();
let pollTimer = null;
function visible(r) {
if (filter === "all") return true;
if (filter === "email" || filter === "instagram") return r.kind === filter;
return r.status === filter;
}
function when(iso) { return iso ? iso.slice(5, 16).replace("T", " ") : ""; }
function render() {
const counts = { all: rows.length, email: 0, instagram: 0, "대기": 0, "보냄": 0, "실패": 0 };
rows.forEach(function (r) { counts[r.kind]++; if (counts[r.status] != null) counts[r.status]++; });
document.querySelectorAll("[data-cnt]").forEach(function (n) { n.textContent = counts[n.dataset.cnt] || 0; });
const shown = rows.filter(visible);
tbody.innerHTML = shown.map(function (r) {
const status = r.status === "실패" ? '<span class="otr-st is-fail" title="' + esc(r.last_error) + '">실패</span>' +
(r.last_error ? '<div class="otr-st-err">' + esc(r.last_error) + "</div>" : "")
: '<span class="otr-st is-' + ({ "대기": "wait", "발송중": "busy", "보냄": "done" }[r.status] || "wait") + '">' + esc(r.status) + "</span>";
const acts = r.kind === "instagram"
? '<button type="button" class="erp-btn erp-btn-primary erp-btn-sm" data-act="dm">DM 보내기</button>' +
(r.status !== "보냄" ? '<button type="button" class="erp-btn erp-btn-outline erp-btn-sm" data-act="dm-sent">보냄</button>' : "")
: '<button type="button" class="erp-btn erp-btn-outline erp-btn-sm" data-act="preview">미리보기</button>';
const addr = r.kind === "instagram"
? '<a href="' + esc(r.profile_link) + '" target="_blank" rel="noopener">@' + esc(r.handle) + "</a>"
: esc(r.handle);
return '<tr data-id="' + r.id + '" class="otr-row is-' + r.kind + (r.needs_name ? " is-noname" : "") + '">' +
'<td class="otr-c-check"><input type="checkbox" data-pick' + (picked.has(r.id) ? " checked" : "") + ' aria-label="고르기" /></td>' +
'<td><span class="otr-kind is-' + r.kind + '">' + esc(r.kind_label) + "</span></td>" +
'<td><input class="otr-name" type="text" maxlength="100" value="' + esc(r.name) + '" placeholder="' +
(r.needs_name ? "이름 필요({이름})" : "이름") + '" aria-label="이름" /></td>' +
'<td class="otr-addr">' + addr + "</td>" +
"<td>" + status + "</td>" +
'<td class="otr-when">' + esc(when(r.sent_at)) + (r.sent_via ? ' <small class="erp-muted">' + (r.sent_via === "dm" ? "DM" : "Gmail") + "</small>" : "") + "</td>" +
'<td class="otr-c-acts">' + acts + "</td></tr>";
}).join("");
document.getElementById("otr-empty").hidden = rows.length > 0;
const sel = rows.filter(function (r) { return picked.has(r.id); });
const mails = sel.filter(function (r) { return r.kind === "email" && (r.status === "대기" || r.status === "실패"); }).length;
document.getElementById("otr-selected").textContent = "고른 줄 " + sel.length + " · 보낼 메일 " + mails;
const all = document.getElementById("otr-check-all");
all.checked = shown.length > 0 && shown.every(function (r) { return picked.has(r.id); });
if (rows.some(function (r) { return r.status === "발송중"; })) startPoll(); else stopPoll();
}
async function reload() {
const d = await api("GET", "/outreach/api/recipients");
rows = d.rows || [];
const ids = new Set(rows.map(function (r) { return r.id; }));
Array.from(picked).forEach(function (id) { if (!ids.has(id)) picked.delete(id); });
render();
}
function startPoll() { if (!pollTimer) pollTimer = setInterval(function () { reload().catch(function () {}); }, 2000); }
function stopPoll() { if (pollTimer) { clearInterval(pollTimer); pollTimer = null; } }
function rowOf(node) { const tr = node.closest("tr[data-id]"); return tr ? rows.find(function (r) { return r.id === +tr.dataset.id; }) : null; }
document.querySelectorAll("[data-filter]").forEach(function (b) {
b.addEventListener("click", function () {
filter = b.dataset.filter;
document.querySelectorAll("[data-filter]").forEach(function (x) { x.classList.toggle("is-active", x === b); });
render();
});
});
document.getElementById("otr-check-all").addEventListener("change", function (e) {
rows.filter(visible).forEach(function (r) { if (e.target.checked) picked.add(r.id); else picked.delete(r.id); });
render();
});
tbody.addEventListener("change", function (e) {
if (e.target.matches("[data-pick]")) {
const r = rowOf(e.target);
if (e.target.checked) picked.add(r.id); else picked.delete(r.id);
render();
}
});
// 이름 — 칸을 떠나면(또는 Enter) 저장
tbody.addEventListener("focusout", async function (e) {
if (!e.target.matches(".otr-name")) return;
const r = rowOf(e.target);
const v = e.target.value.trim();
if (!r || v === (r.name || "")) return;
try {
const d = await api("PUT", "/outreach/api/recipients/" + r.id, { name: v });
Object.assign(r, d.row);
render();
} catch (err) { toast("이름 저장 실패: " + err.message, true); e.target.value = r.name || ""; }
});
tbody.addEventListener("keydown", function (e) {
if (e.target.matches(".otr-name") && e.key === "Enter" && !e.isComposing) { e.preventDefault(); e.target.blur(); }
});
tbody.addEventListener("click", async function (e) {
const btn = e.target.closest("[data-act]");
if (!btn) return;
const r = rowOf(btn);
if (!r) return;
if (btn.dataset.act === "dm") {
if (r.needs_name) { toast("이름을 먼저 넣으세요 — 본문에 {이름}이 있습니다.", true); return; }
// 누르는 순간 바로(브라우저가 막지 않게) — 문구 복사 + DM 창 새 탭. 문구는 화면 데이터에 미리 있다.
const win = window.open(r.dm_link, "_blank", "noopener");
const ok = await copyText(r.dm_text || "");
toast(ok ? "@" + r.handle + " DM 문구를 복사했습니다 — 열린 인스타 DM 창에 붙여 넣어(Ctrl+V) 보낸 뒤 [보냄]을 누르세요."
: "문구를 복사하지 못했습니다 — [미리보기]가 아니라 DM 창에 직접 적어 주세요.", !ok);
if (!win) toast("인스타 창이 막혔습니다 — 브라우저 팝업 허용 뒤 다시 누르세요(문구는 복사됨).", true);
} else if (btn.dataset.act === "dm-sent") {
btn.disabled = true;
try { const d = await api("POST", "/outreach/api/recipients/" + r.id + "/dm-sent"); Object.assign(r, d.row); render(); }
catch (err) { btn.disabled = false; toast("기록 실패: " + err.message, true); }
} else if (btn.dataset.act === "preview") {
try { showPreview(await api("GET", "/outreach/api/recipients/" + r.id + "/preview"), r); }
catch (err) { toast("미리보기 실패: " + err.message, true); }
}
});
// 미리보기 창
const pv = document.getElementById("otr-preview");
function showPreview(d, r) {
document.getElementById("otr-pv-title").textContent = (d.kind === "email" ? "메일 미리보기 → " : "DM 미리보기 → ") + d.to;
document.getElementById("otr-pv-subject").textContent = d.kind === "email" ? "제목: " + d.subject + " · 보내는 이름: " + (d.sender_name || "") : "";
document.getElementById("otr-pv-frame").srcdoc = d.kind === "email" ? d.html
: '<pre style="font-family:sans-serif;white-space:pre-wrap;font-size:14px;line-height:1.6">' + esc(d.text) + "</pre>";
pv.hidden = false;
}
pv.addEventListener("click", function (e) { if (e.target === pv || e.target.closest("[data-close]")) pv.hidden = true; });
document.addEventListener("keydown", function (e) { if (e.key === "Escape" && !pv.hidden) pv.hidden = true; });
// 보내기 · 다시 대기 · 지우기
const sendBtn = document.getElementById("otr-send");
sendBtn.addEventListener("click", async function () {
const sel = rows.filter(function (r) { return picked.has(r.id) && r.kind === "email" && (r.status === "대기" || r.status === "실패"); });
if (!sel.length) { toast("보낼 메일 줄(대기·실패)을 고르세요.", true); return; }
const noName = sel.filter(function (r) { return r.needs_name; }).length;
if (!confirm(sel.length + "명에게 메일을 보낼까요?" + (noName ? "\n(이름 없는 " + noName + "명은 보내지 않고 '실패'로 남습니다)" : ""))) return;
sendBtn.disabled = true;
try {
const d = await api("POST", "/outreach/api/send", { ids: sel.map(function (r) { return r.id; }) });
toast(d.queued + "통을 보내는 중입니다 — 상태가 '보냄'으로 바뀝니다.");
await reload();
} catch (err) {
toast(err.data && err.data.reconnect ? err.message : "보내기 실패: " + err.message, true);
} finally { sendBtn.disabled = false; }
});
document.getElementById("otr-reset").addEventListener("click", async function () {
const sel = rows.filter(function (r) { return picked.has(r.id) && (r.status === "보냄" || r.status === "실패"); });
if (!sel.length) { toast("보냄·실패 줄을 고르세요.", true); return; }
if (!confirm(sel.length + "줄을 다시 '대기'로 둘까요? (다시 보낼 수 있게)")) return;
for (const r of sel) {
try { const d = await api("PUT", "/outreach/api/recipients/" + r.id, { status: "대기" }); Object.assign(r, d.row); }
catch (err) { toast("실패: " + err.message, true); break; }
}
render();
});
document.getElementById("otr-delete").addEventListener("click", async function () {
const ids = Array.from(picked);
if (!ids.length) { toast("지울 줄을 고르세요.", true); return; }
if (!confirm(ids.length + "줄을 리스트에서 지울까요? (보낸 기록은 남습니다)")) return;
try { await api("POST", "/outreach/api/recipients/delete", { ids: ids }); ids.forEach(function (i) { picked.delete(i); }); await reload(); }
catch (err) { toast("지우기 실패: " + err.message, true); }
});
// 리스트 추가 — 미리보기(판별) → 추가
const addBox = document.getElementById("otr-add"), addText = document.getElementById("otr-add-text");
const addSave = document.getElementById("otr-add-save"), addResult = document.getElementById("otr-add-result");
document.getElementById("otr-add-open").addEventListener("click", function () { addBox.hidden = false; addText.focus(); });
document.getElementById("otr-add-close").addEventListener("click", function () { addBox.hidden = true; });
addText.addEventListener("input", function () { addSave.disabled = true; });
document.getElementById("otr-add-preview").addEventListener("click", async function () {
try {
const d = await api("POST", "/outreach/api/recipients/parse", { text: addText.value });
const ok = d.rows.filter(function (r) { return r.kind && !r.dup && !r.exists; });
addResult.hidden = false;
addResult.innerHTML = '<table class="erp-table otr-table"><thead><tr><th>줄</th><th>구분</th><th>이름</th><th>주소</th><th></th></tr></thead><tbody>' +
d.rows.map(function (r) {
const note = !r.kind ? '<span class="otr-err">' + esc(r.error) + "</span>" : r.dup ? "같은 주소가 위에 있음(건너뜀)"
: r.exists ? "이미 리스트에 있음(이름이 비었으면 채움)" : r.name ? "" : '<span class="otr-warn">이름 없음</span>';
return '<tr class="' + (r.kind ? "" : "is-bad") + '"><td>' + r.line + '</td><td><span class="otr-kind is-' + (r.kind || "bad") + '">' +
esc(r.kind_label) + "</span></td><td>" + esc(r.name) + "</td><td>" + esc(r.kind === "instagram" ? "@" + r.handle : r.handle || r.address) +
"</td><td>" + note + "</td></tr>";
}).join("") + "</tbody></table>";
const bad = d.rows.filter(function (r) { return !r.kind; }).length;
document.getElementById("otr-add-sum").textContent = "새로 " + ok.length + "명 (메일 " + ok.filter(function (r) { return r.kind === "email"; }).length +
" · DM " + ok.filter(function (r) { return r.kind === "instagram"; }).length + ")" + (bad ? " · 오류 " + bad + "줄(추가 안 됨)" : "");
addSave.disabled = !d.rows.some(function (r) { return r.kind && !r.dup; });
} catch (err) { toast("미리보기 실패: " + err.message, true); }
});
addSave.addEventListener("click", async function () {
addSave.disabled = true;
try {
const d = await api("POST", "/outreach/api/recipients", { text: addText.value });
toast("추가 " + d.added + "명" + (d.existed ? " · 이미 있던 " + d.existed + "명" : "") + (d.invalid ? " · 오류 " + d.invalid + "줄" : ""));
addText.value = ""; addResult.hidden = true; document.getElementById("otr-add-sum").textContent = "";
addBox.hidden = true;
await reload();
} catch (err) { addSave.disabled = false; toast("추가 실패: " + err.message, true); }
});
render();
})();