Files
dbx-main/app/modules/outreach/CLAUDE.md
T
king 48cd7f0878 feat(안내문 발송): DM 수동 보내기 — 이름 지우기·본문 편집·저장한 본문 목록
- 이름 목록: × 한 명씩 빼기·[전체 삭제], 이름 넣기는 목록에 더함
- 본문: 바로 고침(plaintext-only), {이름} 자리 = 분홍 칩, 이름 누르면 고친 글 + 이름 복사
- 저장한 본문(본문 오른쪽): 설정 DM 문구 + 저장한 것, 고르기·[저장]·[새 본문으로 저장]·× 지우기
- outreach_db 마이그레이션 002 outreach_dm_bodies + POST/PUT/DELETE /outreach/api/dm-bodies
  (002 미적용이면 목록 안내만, API 503)
- 캐시 버전 20261030c, 단위·API·실제 PG·브라우저 테스트

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-30 16:51:10 +09:00

6.5 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·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 로 처리) — 입출고·휴가와 같은 연결.

  • 리스트(주소 + 이름)에 안내문을 보낸다(2026-10-27). 권한키 outreach(보기·리스트·보내기·설정 모두), DB OUTREACH_DB_URL(없으면 "설정 필요" 안내).
  • 주소를 보고 메일/DM 판별(store.detect): name@domain.tld = 메일, @계정·instagram.com/계정·ig.me/m/계정·계정명만(영문·숫자·.·_) = 인스타 DM. 게시물 주소(/p/·/reel/)·한글만은 오류. 같은 주소는 한 번(UNIQUE(kind, handle), 이메일·계정명 소문자).
  • 리스트 추가 = 붙여넣기(한 줄에 한 사람 주소, 이름 — 쉼표·탭·띄어쓰기, 순서는 어느 쪽이든, store.parse_line) → [미리보기](메일/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, &nbsp; → 띄어쓰기, 빈 문단 = <br>). 예전 글·기본 문구(fmt 없음) = text_to_html(줄마다 문단, **굵게**, 주소 링크). 메일 글 버전·DM 대체 글·{이름} 찾기 = html_to_text. {이름} 은 글자마다 서식이 달라도 fill_html 이 바꾼다. 메일 HTML 은 <p> 에 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)).
  • 탭(2026-10-30, templates/outreach/_tabs.html) — 발송 리스트 DM 수동 보내기 + 맨 오른쪽 설정 톱니.
  • DM 수동 보내기 탭 /outreach/dm(dm.html, JS outreach.js initDm) — 3단: 왼쪽 = 이름 넣기(붙여 넣기·.txt/.csv 첫 칸, 머리글 "이름"·빈 줄·이미 있는 이름 뺌, 넣을 때마다 목록에 더함) + 이름 목록(× 한 명씩·[전체 삭제], 브라우저만 — 저장 안 함), 가운데 = 본문(contenteditable="plaintext-only", 바로 고침, {이름} 자리 = 분홍 칩 — 직접 {이름} 이라 써도 됨), 오른쪽 = 저장한 본문 목록 (맨 위 "설정 DM 문구(기본)" = dm_template = store.dm_text(template, NAME_TAG), 그 아래 저장한 것 — 누르면 불러옴(고친 글 있으면 확인)·× 하나씩 지우기). 이름을 누르면 칩이 그 이름으로 바뀌고 고친 글 + 이름을 바로 클립보드 복사 + 짧은 안내(1.6초). 글자 수 = 이름 넣은 글 기준, 1000자(DM_MAX) 넘으면 빨강. 저장한 본문 = outreach_db 마이그레이션 002 outreach_dm_bodies(모듈 권한자 모두 같은 목록, 제목 = 첫 글 줄 40자 store.dm_saved_body, 1000자까지): POST /outreach/api/dm-bodies(새 본문으로 저장)·PUT …/{id}(고른 본문 [저장])·DELETE …/{id} — 모두 {items} 돌려줌. 002 미적용이면 목록 안내만, API 503.
  • 설정 = 탭 줄 맨 오른쪽 톱니(.otr-gear, 공용 vendor/material-symbols). .otr .erp-card[hidden] — 공용 .erp-card display:flex 가 hidden 을 덮어 [리스트 추가] 창이 늘 열려 있던 것 고침(2026-10-30).
  • 설정 /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·대기·보냄·실패).