From c3d3b5e8f39b6fe116127051546d68a9e8d9ea69 Mon Sep 17 00:00:00 2001 From: king Date: Mon, 19 Oct 2026 15:21:48 +0900 Subject: [PATCH] =?UTF-8?q?feat(inout):=20=EB=B0=9C=EC=A3=BC=20=EB=A9=94?= =?UTF-8?q?=EC=9D=BC=EC=9D=84=20=EB=B3=B4=EB=82=B4=EB=A9=B4=20=EC=9E=85?= =?UTF-8?q?=EA=B3=A0=20=EB=8B=B4=EB=8B=B9=EC=97=90=EA=B2=8C=20=EB=B0=9C?= =?UTF-8?q?=EC=A3=BC=20=EC=95=8C=EB=A6=BC=20=EB=A9=94=EC=9D=BC=20=EC=9E=90?= =?UTF-8?q?=EB=8F=99=20=EB=B0=9C=EC=86=A1?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - 같은 Gmail·같은 제목, 내용은 발주번호·발주일·제품 코드·제품명·수량 - 알림 실패·입고 담당 없음은 공장 메일을 막지 않고 결과에 안내, 미리보기에 받을 사람 표시 Co-Authored-By: Claude Opus 5.5 --- app/modules/inout/CLAUDE.md | 1 + app/modules/inout/router.py | 30 ++++++++- app/modules/inout/store.py | 35 +++++++++++ app/modules/inout/templates/inout/index.html | 4 +- .../inout/templates/inout/order_detail.html | 4 +- .../inout/templates/inout/order_form.html | 4 +- .../inout/templates/inout/pending.html | 4 +- app/static/inout.css | 2 + app/static/inout.js | 5 ++ docs/INOUT_MODULE.md | 4 ++ tests/test_inout_receipt_mail.py | 61 +++++++++++++++++++ 11 files changed, 145 insertions(+), 9 deletions(-) diff --git a/app/modules/inout/CLAUDE.md b/app/modules/inout/CLAUDE.md index b6c436e..6b7f8cf 100644 --- a/app/modules/inout/CLAUDE.md +++ b/app/modules/inout/CLAUDE.md @@ -30,6 +30,7 @@ - 새 발주서 저장 → 미리보기 팝업(받는 사람 = 공장 이메일, 요약 표 본문) → 사람이 [메일 발송]을 눌러야 보냄. - **발주 담당 본인 Gmail**(Gmail API `gmail.send`, 사람마다 [Gmail 연결] 1회 — 고른 구글 계정 = ERP 계정 확인). 갱신 토큰은 `APP_ENCRYPTION_KEY` AES-GCM 암호문(`gmail.py`). - 보낸 기록·재발송 확인. +- **입고 담당 발주 알림 자동 발송**(2026-10-19): 발주 메일이 나가면 같은 Gmail 로 옵션 → 담당자의 입고 담당들에게 따로 보냄 — 제목은 발주 메일과 같고 내용은 발주번호·발주일·제품 코드·제품명·수량만(`store.order_notice_mail`, `router._send_order_notice`). 실패해도 공장 메일은 그대로(안내만), 미리보기 창에 받을 사람 안내. - **참조 기본값 `king@dbxcorp.co.kr`**(2026-10-19) — 미리보기 참조 칸에 미리 들어감, 옵션 → 공장 탭 "발주 메일 참조"에서 고침(`inout_settings` `order_mail_cc`, 행이 없으면 기본값 — 저장만 005 필요). ## 입고 요청 메일 (005, 2026-10-19) diff --git a/app/modules/inout/router.py b/app/modules/inout/router.py index 5462789..537b6fa 100644 --- a/app/modules/inout/router.py +++ b/app/modules/inout/router.py @@ -648,6 +648,7 @@ def mail_preview(request: Request, order_id: int) -> JSONResponse: "callback_url": _callback_url(request), # 구글 클라우드 승인된 리디렉션 URI 에 등록해야 하는 주소(안내용) "from": user.get("email", ""), "to": order.get("factory_email") or "", "factory": order["factory_name"], "cc": st.get_settings()[store.SETTING_ORDER_MAIL_CC], # 참조 기본(옵션 → 공장, 처음엔 king@dbxcorp.co.kr) + "notice_to": _receive_emails(st), # 발송하면 이 입고 담당들에게 발주 알림이 따로 감 "subject": mail["subject"], "html": mail["html"], "sent": [{"at": store.fmt_datetime(m["sent_at"]), "by": m["sent_by"], "to": m["to_addrs"]} for m in order["mails"]], }) @@ -686,7 +687,34 @@ def mail_send(request: Request, order_id: int, payload: dict[str, Any] = Body(.. return JSONResponse({"ok": False, "message": str(exc)}, status_code=502) st.add_order_mail(order_id, sent_by=email, to=to, cc=cc, subject=mail["subject"], gmail_id=gid) st.mark_gmail(email) - return JSONResponse({"ok": True, "message": f"메일을 보냈습니다 → {', '.join(to)}"}) + note = _send_order_notice(st, user, order, refresh, subject=mail["subject"]) + return JSONResponse({"ok": True, "message": f"메일을 보냈습니다 → {', '.join(to)}" + (f" · {note}" if note else ""), + "notice": note}) + + +def _receive_emails(st: Any) -> list[str]: + """발주 알림 받는 사람 = 옵션 → 담당자의 입고 담당(지정된 사람만, ERP 관리자는 자동으로 넣지 않음).""" + return list(st.list_roles().get(store.ROLE_RECEIVE) or []) + + +def _send_order_notice(st: Any, user: dict[str, Any], order: dict[str, Any], refresh: str, *, subject: str) -> str: + """발주 메일을 보낸 뒤 입고 담당들에게 따로 자동 발송(2026-10-19) — 같은 Gmail·같은 제목, 내용은 발주번호·발주일·품목(코드·이름·수량). + 공장 메일은 이미 나갔으므로 여기 실패는 막지 않고 안내 문구만 돌려준다.""" + from . import gmail # noqa: WPS433 + + to = _receive_emails(st) + if not to: + return "입고 담당이 옵션에 없어 발주 알림 메일은 보내지 않았습니다" + email = user.get("email", "") + m = store.order_notice_mail(order, subject=subject, sender_name=str(user.get("name") or ""), sender_email=email) + try: + raw = gmail.build_message(sender_name=str(user.get("name") or ""), sender_email=email, to=to, cc=[], + subject=m["subject"], text=m["text"], html=m["html"]) + gmail.send(refresh, raw) + except (gmail.GmailError, gmail.GmailNotConnected) as exc: + _log.warning("inout order notice mail failed: %s (%s)", order.get("order_no"), exc) + return f"입고 담당 알림 메일은 보내지 못했습니다({exc})" + return f"입고 담당 {len(to)}명에게 발주 알림 메일도 보냈습니다" # ──────────────────────────────────────────────────────────── diff --git a/app/modules/inout/store.py b/app/modules/inout/store.py index 3974f5a..fe76b71 100644 --- a/app/modules/inout/store.py +++ b/app/modules/inout/store.py @@ -646,3 +646,38 @@ def sabangnet_xlsx(rows: list[list[Any]]) -> bytes: def sabangnet_filename(order: dict[str, Any], receipt: dict[str, Any]) -> str: return f"사방넷_입고_{receipt['receipt_date']:%Y%m%d}_{order['order_no']}.xlsx" + + +# ════════════════════════════════════════════════════════════ +# 발주 알림 메일(2026-10-19) — 발주 담당이 발주 메일을 보낼 때 입고 담당(옵션 → 담당자)에게 같은 Gmail 로 따로 자동 발송. +# 내용 = 발주번호·발주일·제품 코드·제품명·수량만(단가·무게 등은 넣지 않음), 제목 = 발주 메일과 같음. +# ════════════════════════════════════════════════════════════ +def order_notice_mail(order: dict[str, Any], *, subject: str, sender_name: str, sender_email: str) -> dict[str, str]: + e = _html.escape + lines = order["lines"] + total = sum(int(x["qty"]) for x in lines) + who = sender_name or sender_email + when = fmt_date(order["order_date"]) + text = ["입고 담당자님, 안녕하세요.", "", "아래와 같이 공장에 발주했습니다. 입고 준비에 참고해 주세요.", "", + f"- 발주번호: {order['order_no']}", f"- 발주일: {when}", "", "[발주 품목] 제품 코드 · 제품명 · 수량"] + text += [f"- {x['item_code']} · {x['item_name']} · {int(x['qty']):,}개" for x in lines] + text += [f"합계 {total:,}개", "", f"발주 담당: {who} ({sender_email})"] + td = "padding:4px 10px;border:1px solid #d9dce1;font-size:14px;line-height:20px;" + th = f"{td}background:#f6f7f9;font-weight:700;white-space:nowrap;" + r = "text-align:right;white-space:nowrap;" + facts = (f'발주번호{e(order["order_no"])}' + f'발주일{e(when)}') + rows = "".join(f'{e(x["item_code"])}{e(x["item_name"])}' + f'{int(x["qty"]):,}' for x in lines) + html = ( + '
' + "

입고 담당자님, 안녕하세요.
아래와 같이 공장에 발주했습니다. 입고 준비에 참고해 주세요.

" + f'{facts}
' + '
 
' + '' + f'' + f'{rows}' + f'
제품 코드제품명수량
합계{total:,}
' + f'

발주 담당: {e(who)} ({e(sender_email)})

' + ) + return {"subject": subject, "text": "\n".join(text), "html": html} diff --git a/app/modules/inout/templates/inout/index.html b/app/modules/inout/templates/inout/index.html index b74898c..ab00799 100644 --- a/app/modules/inout/templates/inout/index.html +++ b/app/modules/inout/templates/inout/index.html @@ -1,6 +1,6 @@ {% extends "erp_base.html" %} {% from "inout/_macros.html" import order_badge, progress, due, n, ymd %} -{% block head_extra %}{% endblock %} +{% block head_extra %}{% endblock %} {% block content %}
@@ -68,4 +68,4 @@
{% endblock %} -{% block scripts %}{% endblock %} +{% block scripts %}{% endblock %} diff --git a/app/modules/inout/templates/inout/order_detail.html b/app/modules/inout/templates/inout/order_detail.html index 5792a87..b167328 100644 --- a/app/modules/inout/templates/inout/order_detail.html +++ b/app/modules/inout/templates/inout/order_detail.html @@ -20,7 +20,7 @@ {%- endmacro -%} -{% block head_extra %}{% endblock %} +{% block head_extra %}{% endblock %} {% block content %} {% set active = order.status in ('open', 'partial') %} @@ -253,4 +253,4 @@ {% endif %} {% endblock %} -{% block scripts %}{% endblock %} +{% block scripts %}{% endblock %} diff --git a/app/modules/inout/templates/inout/order_form.html b/app/modules/inout/templates/inout/order_form.html index bb761e2..cce9697 100644 --- a/app/modules/inout/templates/inout/order_form.html +++ b/app/modules/inout/templates/inout/order_form.html @@ -1,5 +1,5 @@ {% extends "erp_base.html" %} -{% block head_extra %}{% endblock %} +{% block head_extra %}{% endblock %} {% block content %}
@@ -80,4 +80,4 @@
{% endblock %} -{% block scripts %}{% endblock %} +{% block scripts %}{% endblock %} diff --git a/app/modules/inout/templates/inout/pending.html b/app/modules/inout/templates/inout/pending.html index 813b923..1370388 100644 --- a/app/modules/inout/templates/inout/pending.html +++ b/app/modules/inout/templates/inout/pending.html @@ -1,6 +1,6 @@ {% extends "erp_base.html" %} {% from "inout/_macros.html" import due, n, ymd %} -{% block head_extra %}{% endblock %} +{% block head_extra %}{% endblock %} {% block content %}
@@ -88,4 +88,4 @@ {% endif %}
{% endblock %} -{% block scripts %}{% endblock %} +{% block scripts %}{% endblock %} diff --git a/app/static/inout.css b/app/static/inout.css index 9ce18d9..28c1e00 100644 --- a/app/static/inout.css +++ b/app/static/inout.css @@ -319,3 +319,5 @@ .io-ordercc-row .io-in { flex: 1 1 auto; } /* [남은 수량 모두 채우기] 를 누른 뒤 = 되돌리기 모드 */ .io-receipt-bar #io-fill-remaining.is-filled { border-color: #1e7a34; color: #1e7a34; background: #f3fbf5; } +/* 발주 메일 창 — 입고 담당 발주 알림 자동 발송 안내 */ +.io-mail-notice { margin: -4px 0 12px; padding: 8px 12px; border-radius: 8px; background: #f0f6ff; border: 1px solid #cfe0fb; color: #1d4f91; font-size: 12.5px; } diff --git a/app/static/inout.js b/app/static/inout.js index cd88728..a636fe9 100644 --- a/app/static/inout.js +++ b/app/static/inout.js @@ -626,6 +626,10 @@ : (data.factory || "공장") + " 이메일이 옵션에 없습니다 — 받는 사람을 직접 넣거나, 관리자가 옵션 → 공장에 넣어 두세요."; } if (receipt && data.ready === false) hint += (hint ? " " : "") + "(DB 마이그레이션 005 전이라 보낸 기록이 남지 않습니다.)"; + // 발주 메일 — 보내면 입고 담당에게 발주 알림(발주번호·발주일·품목·수량)이 같은 제목으로 따로 자동 발송된다 + const notice = !receipt && data.notice_to ? (data.notice_to.length + ? "메일 발송 시 입고 담당(" + data.notice_to.join(", ") + ")에게 발주 알림 메일(발주번호·발주일·제품 코드·제품명·수량)이 따로 자동 발송됩니다." + : "입고 담당이 옵션에 없어 발주 알림 메일은 가지 않습니다(옵션 → 담당자에서 지정).") : ""; body.innerHTML = '
' + "" + @@ -634,6 +638,7 @@ "" + "
" + (hint ? '

' + esc(hint) + "

" : "") + + (notice ? '

' + esc(notice) + "

" : "") + (receipt && data.photos_skipped ? '

HEIC 등 본문에 넣지 못하는 입고증 사진 ' + esc(data.photos_skipped) + "장은 빠집니다(입고 기록에는 그대로).

" : "") + (sentList ? '
보낸 기록
    ' + sentList + "
" : "") + ''; diff --git a/docs/INOUT_MODULE.md b/docs/INOUT_MODULE.md index fe06eb7..02e09ff 100644 --- a/docs/INOUT_MODULE.md +++ b/docs/INOUT_MODULE.md @@ -105,6 +105,10 @@ cupang·malaysia 와 같은 DSN). 화면에서 코드·이름으로 검색(`GET ## 6-1. 발주 메일 — 발주 담당자 본인 Gmail(2026-10-16, 마이그레이션 003) - **받는 사람** = 옵션 → 공장 **이메일**(`inout_factories.email`, 여러 개는 쉼표). 발주서 화면에서 바꾸거나 참조를 더할 수 있다. +- **입고 담당 발주 알림**(2026-10-19 요청): [메일 발송]으로 공장 메일이 나가면 **같은 Gmail** 로 입고 담당(옵션 → 담당자 `inout_roles` receive, ERP 관리자는 자동 포함 안 함)에게 + 별도 메일을 자동 발송 — 제목 = 발주 메일과 같음, 본문 = 발주번호·발주일 + 표(제품 코드·제품명·수량, 합계)만(단가·무게·은 없음, `store.order_notice_mail`). + 다시 보내기 때도 함께 간다. 알림 실패·입고 담당 없음은 공장 메일을 막지 않고 결과 문구에만("입고 담당 n명에게 발주 알림 메일도 보냈습니다" / 실패 이유), + 기록은 공장 메일 한 건(`inout_order_mails`). 미리보기 창에 "메일 발송 시 입고 담당(…)에게 발주 알림 메일이 따로 자동 발송됩니다" 안내(`notice_to`). - **참조 기본값**(2026-10-19 요청) = `king@dbxcorp.co.kr` — 미리보기 참조 칸에 미리 들어간다. 옵션 → 공장 탭 위 **발주 메일 참조**에서 바꾼다 (`POST /inout/settings/order-mail`, `inout_settings` 키 `order_mail_cc` — 행이 없으면 `store.SETTING_DEFAULTS` 값, 저장은 005 필요). - **흐름**: 새 발주서를 저장하면 발주서 화면이 `?mail=1` 로 열려 **메일 미리보기 팝업**이 바로 뜬다(받는 사람·제목·본문). diff --git a/tests/test_inout_receipt_mail.py b/tests/test_inout_receipt_mail.py index 64c5054..812d719 100644 --- a/tests/test_inout_receipt_mail.py +++ b/tests/test_inout_receipt_mail.py @@ -127,6 +127,9 @@ class _Store: def roles_of(self, email): return {"receive"} + def list_roles(self): + return {"order": [], "receive": []} + def get_order(self, oid): if oid != 7: return None @@ -332,3 +335,61 @@ class OrderMailCcTests(ReceiptMailApiTests): test_preview_defaults_and_photos_inline = test_send_records_and_resend_guard = None test_order_role_cannot_send_receipt_mail = test_receive_role_may_connect_gmail = None + + +class OrderNoticeMailTests(OrderMailCcTests): + """발주 메일을 보내면 입고 담당에게 발주 알림 메일이 같은 제목으로 따로 자동 발송(2026-10-19).""" + + def setUp(self): + super().setUp() + self.st.settings["order_mail_cc"] = "king@dbxcorp.co.kr" + self.st.roles = {"order": ["buyer@x.com"], "receive": ["wh1@x.com", "wh2@x.com"]} + self.st.list_roles = lambda: self.st.roles + self.st.order_mails = [] + self.st.add_order_mail = lambda oid, **kw: self.st.order_mails.append(kw) + self.sent = [] + + def _send(self, fail_second=False): + def fake_send(refresh, raw): + self.sent.append(email.message_from_bytes(raw, policy=policy.default)) + if fail_second and len(self.sent) == 2: + raise gmail.GmailError("구글 오류") + return "gm-%d" % len(self.sent) + + with patch.object(gmail, "decrypt_token", lambda e, enc: "refresh"), patch.object(gmail, "send", fake_send): + return self.c.post("/inout/orders/7/mail", json={"to": "f@x.com", "cc": "king@dbxcorp.co.kr"}) + + def test_preview_shows_notice_recipients(self): + self.assertEqual(self.c.get("/inout/orders/7/mail").json()["notice_to"], ["wh1@x.com", "wh2@x.com"]) + + def test_notice_sent_separately_same_subject_minimal_body(self): + r = self._send() + self.assertEqual(r.status_code, 200, r.text) + self.assertIn("입고 담당 2명에게 발주 알림 메일도 보냈습니다", r.json()["message"]) + factory, notice = self.sent + self.assertEqual(factory["To"], "f@x.com") + self.assertEqual((notice["To"], notice["Cc"]), ("wh1@x.com, wh2@x.com", None)) + self.assertEqual(str(notice["Subject"]), str(factory["Subject"])) # 제목은 발주 메일과 같게 + h = notice.get_body(("html",)).get_content() + for part in ("PO-261019-01", "2026.10.19(월)", "MW-0320", "미라클 통 황토 320ml", ">5,000<", ">10,000<", ">15,000<"): + self.assertIn(part, h) + self.assertIn("<b>950ml</b>", h) + heads = [x.split("")[0].split(">")[-1] for x in h.split("")[1].split("")[0].split("