feat(inout): 입고 기록 줄 [사방넷 입고 파일] 엑셀 다운로드

- 1행 제목 상품코드·가용수량·불용수량, A=코드표 사방넷 코드, B=입고 수량, C=상품 이름
- 사방넷 코드가 없는 상품·코드표 연결 불가면 파일 대신 안내
- 발주·입고 담당, 마이그레이션 없음

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
2026-10-19 13:44:42 +09:00
parent 038007c34e
commit 96438d5078
11 changed files with 189 additions and 5 deletions
+6
View File
@@ -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).
+12
View File
@@ -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:
+32
View File
@@ -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 관리자)
# ────────────────────────────────────────────────────────────
+50
View File
@@ -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"
+1 -1
View File
@@ -1,6 +1,6 @@
{% extends "erp_base.html" %}
{% from "inout/_macros.html" import order_badge, progress, due, n, ymd %}
{% block head_extra %}<link rel="stylesheet" href="/static/inout.css?v=20261019a" />{% endblock %}
{% block head_extra %}<link rel="stylesheet" href="/static/inout.css?v=20261019b" />{% endblock %}
{% block content %}
<section class="io">
@@ -20,7 +20,7 @@
</footer>
</dialog>
{%- endmacro -%}
{% block head_extra %}<link rel="stylesheet" href="/static/inout.css?v=20261019a" />{% endblock %}
{% block head_extra %}<link rel="stylesheet" href="/static/inout.css?v=20261019b" />{% endblock %}
{% block content %}
{% set active = order.status in ('open', 'partial') %}
@@ -170,7 +170,7 @@
{% if order.receipts %}
<div class="erp-table-wrap">
<table class="erp-table io-table">
<thead><tr><th>입고일</th><th>품목별 수량</th><th class="io-num">합계</th><th>입고증</th><th>입력</th><th>입고 요청 메일</th>{% if photo_admin %}<th></th>{% endif %}</tr></thead>
<thead><tr><th>입고일</th><th>품목별 수량</th><th class="io-num">합계</th><th>입고증</th><th>입력</th><th>입고 요청 메일 · 사방넷</th>{% if photo_admin %}<th></th>{% endif %}</tr></thead>
<tbody>
{% for r in order.receipts %}
<tr>
@@ -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 %}</button>
{% elif not r.mails %}<span class="erp-muted">-</span>{% endif %}
{% if perms.can_order or perms.can_receive %}
<a class="erp-btn erp-btn-outline erp-btn-sm io-sabang-btn" href="/inout/orders/{{ order.id }}/receipts/{{ r.id }}/sabangnet.xlsx"
title="사방넷 입고 엑셀 — 상품코드(사방넷 코드)·가용수량(입고 수량)·불용수량(상품 이름)" download>사방넷 입고 파일</a>
{% endif %}
</td>
{% if photo_admin %}
<td><form method="post" action="/inout/orders/{{ order.id }}/receipts/{{ r.id }}/delete"
@@ -1,5 +1,5 @@
{% extends "erp_base.html" %}
{% block head_extra %}<link rel="stylesheet" href="/static/inout.css?v=20261019a" />{% endblock %}
{% block head_extra %}<link rel="stylesheet" href="/static/inout.css?v=20261019b" />{% endblock %}
{% block content %}
<section class="io">
@@ -1,6 +1,6 @@
{% extends "erp_base.html" %}
{% from "inout/_macros.html" import due, n, ymd %}
{% block head_extra %}<link rel="stylesheet" href="/static/inout.css?v=20261019a" />{% endblock %}
{% block head_extra %}<link rel="stylesheet" href="/static/inout.css?v=20261019b" />{% endblock %}
{% block content %}
<section class="io">
+1
View File
@@ -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; }
+9
View File
@@ -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
+70
View File
@@ -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, "<b>950ml</b>"]])
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, "<b>950ml</b>"]]) # 앞자리 0 보존
self.assertEqual(ws["A2"].number_format, "@")
_rows, missing = s.sabangnet_rows(_receipt(), {"MW-0320": "0012345", "MW-0950": ""})
self.assertEqual(missing, ["MW-0950 <b>950ml</b>"])
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, "<b>950ml</b>"]])
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