diff --git a/app/modules/inout/CLAUDE.md b/app/modules/inout/CLAUDE.md index 95993bf..12f5b77 100644 --- a/app/modules/inout/CLAUDE.md +++ b/app/modules/inout/CLAUDE.md @@ -36,6 +36,12 @@ - 제목 `[입고 요청] yyyy년 mm월 dd일(요일) 입고 요청 합니다.`(입고일) · 본문 "입고된 아래 리스트 상품을 전산 등록 부탁드립니다." + 표(상품 이름·상품 코드·입고 수량·비고 = 발주 품목 줄 메모, 합계) + 메모 + **맨 아래 입고증 사진 = 본문 안 이미지**(CID `multipart/related`, 첨부 아님 — `gmail.build_message(inline_images=)`), 서버가 가로 600px 이하·비율 유지 JPEG 로 줄임(`store.mail_images`, EXIF 회전 반영, HEIC 는 빼고 안내). 미리보기는 cid → data: 로 바꿔 보여 줌. - 보낸 기록 `inout_receipt_mails`(입고 지우면 CASCADE), 이미 보낸 입고는 `resend` 확인. +## 사방넷 입고 파일 (2026-10-19, 마이그레이션 없음) + +- 입고 기록 줄 [사방넷 입고 파일] → `GET /inout/orders/{id}/receipts/{rid}/sabangnet.xlsx`(발주·입고 담당). 1행 제목 **A 상품코드 · B 가용수량 · C 불용수량**, + A = 코드표 `single_items.sabangnet_code`(`itemcode.sabangnet_codes`), B = 입고 수량, **C = 수량이 아니라 상품 이름**(사용자 지정). A·C 는 글자 칸(앞자리 0 보존). +- 사방넷 코드가 빈 품목이 있거나 코드표를 못 읽으면 파일을 만들지 않고 발주서로 돌아가 품목을 알려 준다(빈 칸 업로드 방지). 파일 이름 `사방넷_입고_{입고일}_{발주번호}.xlsx`. + ## 입고증 사진 (003) - 입고 저장 때 첨부(브라우저가 2000px JPEG 로 줄임, 10장·10MB, 파일 머리 검사, 입고와 한 트랜잭션, bytea). diff --git a/app/modules/inout/itemcode.py b/app/modules/inout/itemcode.py index 1a53f91..ddc0bec 100644 --- a/app/modules/inout/itemcode.py +++ b/app/modules/inout/itemcode.py @@ -75,6 +75,18 @@ class SingleItemReader: return None return {str(r["item_code"]).strip().upper(): str(r.get("name") or "").strip() for r in rows} + def sabangnet_codes(self, codes: list[str]) -> dict[str, str] | None: + """코드들 → {코드(대문자): 사방넷 코드}(사방넷 입고 파일, 2026-10-19). 사방넷 코드가 빈 단품은 ''. 조회 불가면 None.""" + if not self.enabled or not self._pool: + return None + wanted = sorted({c.strip().upper() for c in codes if c and c.strip()}) + if not wanted: + return {} + rows = self._run("SELECT item_code, sabangnet_code FROM single_items WHERE upper(item_code) = ANY(%(codes)s)", {"codes": wanted}) + if rows is None: + return None + return {str(r["item_code"]).strip().upper(): str(r.get("sabangnet_code") or "").strip() for r in rows} + def _run(self, sql: str, params: dict[str, Any]) -> list[dict[str, Any]] | None: try: with self._pool.connection() as conn: diff --git a/app/modules/inout/router.py b/app/modules/inout/router.py index ec202da..d21996b 100644 --- a/app/modules/inout/router.py +++ b/app/modules/inout/router.py @@ -15,6 +15,7 @@ GET|POST /inout/orders/{id}/mail 발주 메일 미리보기·발송(발주 담당 본인 Gmail, 사람이 눌러야 보냄) GET|POST /inout/orders/{id}/receipts/{rid}/mail 입고 요청 메일(물류센터, 입고 담당 본인 Gmail, 005) POST /inout/settings/logistics 옵션 → 물류센터(입고 요청 메일 받는 주소·참조, 005) + GET /inout/orders/{id}/receipts/{rid}/sabangnet.xlsx 사방넷 입고 파일(상품코드=사방넷 코드·가용수량=입고 수량·불용수량=상품 이름) GET /inout/gmail/connect · /gmail/callback · POST /gmail/disconnect Gmail 연결(사람별, gmail.send 만) GET /inout/api/items?q= 코드표 단품 검색(JSON) @@ -768,6 +769,37 @@ def receipt_mail_send(request: Request, order_id: int, receipt_id: int, payload: return JSONResponse({"ok": True, "message": f"입고 요청 메일을 보냈습니다 → {', '.join(to)}"}) +@router.get("/orders/{order_id}/receipts/{receipt_id}/sabangnet.xlsx") +def receipt_sabangnet_file(request: Request, order_id: int, receipt_id: int) -> Any: + """사방넷 입고 파일(2026-10-19) — 입고 1건을 엑셀로. 1행 제목 상품코드·가용수량·불용수량, + 상품코드 = 코드표 사방넷 코드, 가용수량 = 입고 수량, 불용수량 = 상품 이름(사용자 지정). 발주·입고 담당. + 사방넷 코드가 없는 품목이 하나라도 있거나 코드표를 못 읽으면 파일을 만들지 않고 발주서로 돌아가 안내한다(빈 칸 업로드 방지).""" + from urllib.parse import quote # noqa: WPS433 + + got = _ctx(request) + if not isinstance(got, tuple): + return got + st, user = got + _require(st, user, "mail") + order = _order_or_404(st, order_id) + receipt = next((r for r in order["receipts"] if int(r["id"]) == receipt_id), None) + if receipt is None: + raise HTTPException(status_code=404, detail="입고 기록을 찾을 수 없습니다.") + reader = _items(request) + codes = reader.sabangnet_codes([x["item_code"] for x in receipt["lines"]]) if reader is not None else None + back = f"/inout/orders/{order_id}" + if codes is None: + why = (getattr(reader, "last_error", "") or getattr(reader, "reason", "")) if reader is not None else "없음" + return _redirect(back, f"코드표(itemcode_db)를 읽지 못해 사방넷 입고 파일을 만들 수 없습니다 — {why}") + rows, missing = store.sabangnet_rows(receipt, codes) + if missing: + return _redirect(back, "코드표에 사방넷 코드가 없는 상품이 있어 사방넷 입고 파일을 만들지 않았습니다: " + ", ".join(missing)) + name = store.sabangnet_filename(order, receipt) + return Response(content=store.sabangnet_xlsx(rows), + media_type="application/vnd.openxmlformats-officedocument.spreadsheetml.sheet", + headers={"Content-Disposition": f"attachment; filename=\"sabangnet_{receipt_id}.xlsx\"; filename*=UTF-8''{quote(name)}"}) + + # ──────────────────────────────────────────────────────────── # 옵션 — 공장·발주 담당·입고 담당(ERP 관리자) # ──────────────────────────────────────────────────────────── diff --git a/app/modules/inout/store.py b/app/modules/inout/store.py index d806f01..7769950 100644 --- a/app/modules/inout/store.py +++ b/app/modules/inout/store.py @@ -588,3 +588,53 @@ def inline_preview_html(html: str, images: list[dict[str, Any]]) -> str: html = html.replace(f'src="cid:{_html.escape(im["cid"])}"', f'src="data:image/jpeg;base64,{base64.b64encode(im["data"]).decode("ascii")}"') return html + + +# ════════════════════════════════════════════════════════════ +# 사방넷 입고 파일(2026-10-19) — 입고 1건 → 엑셀. 1행 제목 A 상품코드 · B 가용수량 · C 불용수량, +# A = 코드표(itemcode_db single_items)의 사방넷 코드, B = 입고 수량, C = 수량이 아니라 상품 이름(사용자 지정). +# ════════════════════════════════════════════════════════════ +SABANGNET_HEADER = ("상품코드", "가용수량", "불용수량") + + +def sabangnet_rows(receipt: dict[str, Any], codes: dict[str, str]) -> tuple[list[list[Any]], list[str]]: + """입고 품목 → (엑셀 줄 [사방넷 코드, 입고 수량, 상품 이름], 사방넷 코드가 없는 품목 "코드 이름" 목록).""" + rows: list[list[Any]] = [] + missing: list[str] = [] + for x in receipt["lines"]: + code = (codes.get(str(x["item_code"]).strip().upper()) or "").strip() + if not code: + missing.append(f"{x['item_code']} {x['item_name']}".strip()) + rows.append([code, int(x["qty"]), str(x["item_name"] or "")]) + return rows, missing + + +def sabangnet_xlsx(rows: list[list[Any]]) -> bytes: + """제목 행(굵게·회색 바탕) + 줄. 상품코드·불용수량(상품 이름)은 글자 칸(앞자리 0 보존).""" + from io import BytesIO # noqa: WPS433 + + from openpyxl import Workbook # noqa: WPS433 + from openpyxl.styles import Font, PatternFill # noqa: WPS433 + + wb = Workbook() + ws = wb.active + ws.title = "입고" + ws.append(list(SABANGNET_HEADER)) + for c in ws[1]: + c.font = Font(bold=True) + c.fill = PatternFill(start_color="FFE7E9ED", end_color="FFE7E9ED", fill_type="solid") + for code, qty, name in rows: + ws.append([code, qty, name]) + r = ws.max_row + ws.cell(row=r, column=1).number_format = "@" + ws.cell(row=r, column=3).number_format = "@" + for letter, col in (("A", 0), ("B", 1), ("C", 2)): + longest = max(sum(2 if ord(ch) > 0x1100 else 1 for ch in str(v)) for v in [SABANGNET_HEADER[col]] + [r[col] for r in rows]) + ws.column_dimensions[letter].width = max(10, min(60, longest + 2)) + buf = BytesIO() + wb.save(buf) + return buf.getvalue() + + +def sabangnet_filename(order: dict[str, Any], receipt: dict[str, Any]) -> str: + return f"사방넷_입고_{receipt['receipt_date']:%Y%m%d}_{order['order_no']}.xlsx" diff --git a/app/modules/inout/templates/inout/index.html b/app/modules/inout/templates/inout/index.html index a6ef3da..d7e94b5 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 %}
diff --git a/app/modules/inout/templates/inout/order_detail.html b/app/modules/inout/templates/inout/order_detail.html index 23856d5..2b6db2e 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') %} @@ -170,7 +170,7 @@ {% if order.receipts %}
- {% if photo_admin %}{% endif %} + {% if photo_admin %}{% endif %} {% for r in order.receipts %} @@ -201,6 +201,10 @@ data-url="/inout/orders/{{ order.id }}/receipts/{{ r.id }}/mail" data-title="입고 요청 메일 · {{ ymd(r.receipt_date) }} 입고 {{ n(r.total) }}개"> {% if r.mails %}다시 보내기{% else %}보내기{% endif %} {% elif not r.mails %}-{% endif %} + {% if perms.can_order or perms.can_receive %} + 사방넷 입고 파일 + {% endif %} {% if photo_admin %}
입고일품목별 수량합계입고증입력입고 요청 메일
입고일품목별 수량합계입고증입력입고 요청 메일 · 사방넷
{% endblock %} +{% block head_extra %}{% endblock %} {% block content %}
diff --git a/app/modules/inout/templates/inout/pending.html b/app/modules/inout/templates/inout/pending.html index 833d28b..70e5cea 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 %}
diff --git a/app/static/inout.css b/app/static/inout.css index 2fe1088..c081803 100644 --- a/app/static/inout.css +++ b/app/static/inout.css @@ -294,3 +294,4 @@ .io-logi-field { display: grid; gap: 4px; } .io-logi-field > span { font-weight: 600; } .io-logi-field small { font-weight: 400; color: var(--color-midtone-gray, #777); } +.io-rmail-cell .io-sabang-btn { margin-top: 4px; display: inline-flex; } diff --git a/docs/INOUT_MODULE.md b/docs/INOUT_MODULE.md index f92687e..69058e6 100644 --- a/docs/INOUT_MODULE.md +++ b/docs/INOUT_MODULE.md @@ -182,6 +182,15 @@ cupang·malaysia 와 같은 DSN). 화면에서 코드·이름으로 검색(`GET - **권한**: 미리보기·발송 = 입고 담당(관리자 포함). 발주 담당만인 사람은 403. - **005 미적용**: 미리보기·발송은 되고(받는 사람은 직접 입력, 참조는 기본값), 보낸 기록·옵션 저장만 안 됨(창에 안내). +## 6-5. 사방넷 입고 파일(2026-10-19, 마이그레이션 없음) + +- 입고 기록 표 **입고 요청 메일 · 사방넷** 칸의 **[사방넷 입고 파일]**(발주 담당·입고 담당) → 그 입고 1건의 엑셀(`GET …/receipts/{rid}/sabangnet.xlsx`). +- 시트 1행 = 제목 **상품코드 · 가용수량 · 불용수량**(굵게·회색 바탕), 2행부터 입고 품목마다 + A = 코드표(itemcode_db `single_items.sabangnet_code`, `itemcode.SingleItemReader.sabangnet_codes`) 사방넷 코드, + B = 입고 수량, **C = 상품 이름**(사용자 요청 — 불용수량 칸이지만 수량이 아니라 이름). A·C 는 글자 서식(`@`, 앞자리 0 보존), 열 너비는 내용 길이로. +- 사방넷 코드가 빈 단품이 하나라도 있으면 파일을 만들지 않고 발주서로 돌아가 "코드표에 사방넷 코드가 없는 상품: …"(빈 상품코드로 사방넷에 올리는 실수 방지), + 코드표 연결이 안 되면 그 이유를 안내. 파일 이름 `사방넷_입고_YYYYMMDD_{발주번호}.xlsx`(입고일). `store.sabangnet_rows·sabangnet_xlsx·sabangnet_filename`. + ## 7. 테스트 ```bash diff --git a/tests/test_inout_receipt_mail.py b/tests/test_inout_receipt_mail.py index 7202d95..eeb216d 100644 --- a/tests/test_inout_receipt_mail.py +++ b/tests/test_inout_receipt_mail.py @@ -228,3 +228,73 @@ class ReceiptMailApiTests(unittest.TestCase): if __name__ == "__main__": unittest.main() + + +class SabangnetFileTests(unittest.TestCase): + """사방넷 입고 파일 — 1행 제목 상품코드·가용수량·불용수량, A=사방넷 코드, B=입고 수량, C=상품 이름.""" + + def test_rows_and_xlsx(self): + from openpyxl import load_workbook + + rows, missing = s.sabangnet_rows(_receipt(), {"MW-0320": "0012345", "MW-0950": "SB-950"}) + self.assertEqual(missing, []) + self.assertEqual(rows, [["0012345", 2000, "미라클 통 황토 320ml"], ["SB-950", 500, "950ml"]]) + ws = load_workbook(io.BytesIO(s.sabangnet_xlsx(rows))).active + got = [[c.value for c in r] for r in ws.iter_rows()] + self.assertEqual(got[0], ["상품코드", "가용수량", "불용수량"]) + self.assertEqual(got[1:], [["0012345", 2000, "미라클 통 황토 320ml"], ["SB-950", 500, "950ml"]]) # 앞자리 0 보존 + self.assertEqual(ws["A2"].number_format, "@") + _rows, missing = s.sabangnet_rows(_receipt(), {"MW-0320": "0012345", "MW-0950": ""}) + self.assertEqual(missing, ["MW-0950 950ml"]) + self.assertEqual(s.sabangnet_filename(_order(), _receipt()), "사방넷_입고_20261019_PO-261019-01.xlsx") + + +class SabangnetApiTests(ReceiptMailApiTests): + def setUp(self): + super().setUp() + p = patch.object(self.api, "_page_user", lambda request: self.user) + p.start() + self.addCleanup(p.stop) + + class Reader: + enabled, reason, last_error = True, "", "" + codes = {"MW-0320": "0012345", "MW-0950": "SB-950"} + + def sabangnet_codes(self, codes): + return None if self.codes is None else {c.upper(): self.codes.get(c.upper(), "") for c in codes} + + self.reader = Reader() + self.c.app.state.inout_items = self.reader + + def test_download(self): + from urllib.parse import unquote + + from openpyxl import load_workbook + + r = self.c.get("/inout/orders/7/receipts/3/sabangnet.xlsx", follow_redirects=False) + self.assertEqual(r.status_code, 200, r.text[:200]) + self.assertIn("spreadsheetml", r.headers["content-type"]) + self.assertIn("사방넷_입고_20261019_PO-261019-01.xlsx", unquote(r.headers["content-disposition"])) + ws = load_workbook(io.BytesIO(r.content)).active + self.assertEqual([[c.value for c in row] for row in ws.iter_rows()], + [["상품코드", "가용수량", "불용수량"], ["0012345", 2000, "미라클 통 황토 320ml"], ["SB-950", 500, "950ml"]]) + + def test_missing_code_or_reader_down_redirects_with_message(self): + from urllib.parse import unquote_plus as unquote + + self.reader.codes = {"MW-0320": "0012345"} + r = self.c.get("/inout/orders/7/receipts/3/sabangnet.xlsx", follow_redirects=False) + self.assertEqual(r.status_code, 303) + self.assertIn("사방넷 코드가 없는 상품", unquote(r.headers["location"])) and self.assertIn("MW-0950", r.headers["location"]) + self.reader.codes = None + r = self.c.get("/inout/orders/7/receipts/3/sabangnet.xlsx", follow_redirects=False) + self.assertIn("코드표(itemcode_db)를 읽지 못해", unquote(r.headers["location"])) + self.assertEqual(self.c.get("/inout/orders/7/receipts/99/sabangnet.xlsx").status_code, 404) + + def test_viewer_cannot_download(self): + self.st.roles_of = lambda email: set() + self.assertEqual(self.c.get("/inout/orders/7/receipts/3/sabangnet.xlsx").status_code, 403) + + # 부모 클래스 테스트를 여기서 다시 돌리지 않는다 + 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