6c87a736a6
- store: dm_body(최대 1000자)·dm_text, needs_name 을 메일/DM 구분별로 - 리스트 [DM 보내기] 복사 글·DM 미리보기가 DM 문구 사용 - 설정 화면: DM 문구 칸 + 글자 수, [기본 문구로 되돌리기]에 포함 - 설정은 outreach_settings JSON 이라 DB 변경 없음 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
3.6 KiB
3.6 KiB
[안내문 발송] 안내문 발송 모듈 — app/modules/outreach/, outreach_db
이 모듈만 고칠 때 읽는 요약. 별도 상세 문서 없음 — 코드가 기준. 정적 파일:
app/static/outreach.js,app/static/outreach.css. 템플릿:templates/outreach/. 테스트:tests/test_outreach.py,tests/js/outreach.browser.test.js(render_outreach.py). 다른 모듈과 연결: 메일 = 입출고 Gmail 연결(inout_store.inout_gmail_tokens,app/modules/inout/gmail.py, 콜백/inout/gmail/callback이 세션_gmail_origin=outreach를 보고_GMAIL_ORIGINS로 처리) — 입출고·휴가와 같은 연결.
- 리스트(주소 + 이름)에 안내문을 보낸다(2026-10-27). 권한키
outreach(보기·리스트·보내기·설정 모두), DBOUTREACH_DB_URL(없으면 "설정 필요" 안내). - 주소를 보고 메일/DM 판별(
store.detect):name@domain.tld= 메일,@계정·instagram.com/계정·ig.me/m/계정·계정명만(영문·숫자·.·_) = 인스타 DM. 게시물 주소(/p/·/reel/)·한글만은 오류. 같은 주소는 한 번(UNIQUE(kind, handle), 이메일·계정명 소문자). - 리스트 추가 = 붙여넣기(한 줄에 한 사람
주소, 이름— 쉼표·탭·띄어쓰기, 순서는 어느 쪽이든,store.parse_line) → [미리보기](메일/DM/오류·중복·이미 있음) → [리스트에 추가]. - 본문
{이름}= 그 줄 이름(제목에도). 이름이 빈 줄은 보내지 않고 실패('이름 없음'), 화면에 "이름 필요" 표시.**굵게**= 메일 굵은 글씨(DM 은 별표만 뺌), 주소 = 메일 링크. - 메일 = [고른 메일 보내기] →
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에, 순서 ◀▶). [기본 문구로 되돌리기] = 칸만(저장해야 적용). - 리스트 줄: 이름 바로 고치기(칸 떠나면 저장), [미리보기](메일 = 제목·HTML, DM = 글), 고른 줄 다시 대기·지우기(발송중은 못 지움), 걸러 보기(전체·메일·DM·대기·보냄·실패).