Compare commits
337 Commits
| Author | SHA1 | Date | |
|---|---|---|---|
| ec0eb0a295 | |||
| 7f94e5efe7 | |||
| 3045bc6f99 | |||
| 1678f00c1b | |||
| 7a7e19636f | |||
| 34b8e2fb6b | |||
| 7c53b16566 | |||
| 8043110197 | |||
| 9f57f5d15e | |||
| 4cd349c3a1 | |||
| 5e9c1dac88 | |||
| 282ee559e0 | |||
| 1096fd68ab | |||
| 8bd62fbf6d | |||
| 9229d269c9 | |||
| 4286c45531 | |||
| f87641233b | |||
| 6822329ff2 | |||
| 36834c65b2 | |||
| 359ff29e95 | |||
| 548a163fc4 | |||
| 8636498bc9 | |||
| 9d2e9f6e1b | |||
| 8e1fa556ed | |||
| a65f53ccca | |||
| 547d594659 | |||
| e385b38885 | |||
| ab6c243ab7 | |||
| fc95c8bd25 | |||
| 828ba0938a | |||
| ecc76ae4d8 | |||
| 3b44cf2985 | |||
| f5ddfd366b | |||
| 21659bca35 | |||
| be4c663f70 | |||
| 6ec5485e70 | |||
| 9c94f70e54 | |||
| 7e0f7f7642 | |||
| 3d28d59e4d | |||
| eb208c0c52 | |||
| 1babc39b64 | |||
| 387341b1d8 | |||
| 3476146102 | |||
| de619eaf9f | |||
| de294a53a4 | |||
| 02f83947de | |||
| 2224eb6c22 | |||
| d9db230fe4 | |||
| ece5b06f7a | |||
| fd37e367a1 | |||
| 97b9729671 | |||
| db32d03e07 | |||
| cf0e3f2139 | |||
| e77f3d6a82 | |||
| e6ebf2188b | |||
| 43771edd77 | |||
| 42fdf98560 | |||
| c325d91bab | |||
| 74782da88c | |||
| e3b7e55695 | |||
| f3cb198681 | |||
| 44779c3979 | |||
| 162f9f28d5 | |||
| 99069619d6 | |||
| cff560ad71 | |||
| b637fdeeeb | |||
| 8449b02320 | |||
| 17b119d8c3 | |||
| b7e05f58aa | |||
| 50f25a7ec7 | |||
| 54e4e08802 | |||
| d27257f15b | |||
| 212a3dd6b0 | |||
| 01208ea4d4 | |||
| 49b3b6a0dc | |||
| 4477a68819 | |||
| 5126943a78 | |||
| 97d002a06c | |||
| 4171d61db1 | |||
| 677bf8f1d1 | |||
| 15dcabc538 | |||
| 25c885d5dd | |||
| 61f5b3c320 | |||
| 5d55081464 | |||
| f54f19fa45 | |||
| 876d9758bd | |||
| 0ba6192e95 | |||
| dd5010019d | |||
| 57745e114e | |||
| 307a0c31b1 | |||
| cfb6878bea | |||
| b0f559907f | |||
| b6c8173899 | |||
| d0e3e3622b | |||
| 6055d50dbe | |||
| 321041b65a | |||
| faed6581fd | |||
| 6b04b7ab6e | |||
| a85d562fa7 | |||
| 889522d935 | |||
| 5e5586a25c | |||
| 5cf1a33e98 | |||
| f4b80e8abc | |||
| 7e86e9c91b | |||
| 4ecde312f9 | |||
| 0c17b02468 | |||
| 97f4a904cd | |||
| f7a3afcebf | |||
| b3001c3051 | |||
| 443fa56671 | |||
| 884e654bea | |||
| ff3b36bf77 | |||
| 48cd7f0878 | |||
| 456dfe376f | |||
| 64e19e8c3e | |||
| 6543ce3f0f | |||
| 3a43f699f5 | |||
| c13f529721 | |||
| f904d5935c | |||
| 945b81ab4a | |||
| c85ba4acc3 | |||
| fa50a85730 | |||
| 12c733bafc | |||
| 72352a2ed9 | |||
| 38afbca839 | |||
| ede1f8e5e1 | |||
| 45f92f60ca | |||
| 4ec9f2944a | |||
| 439ecb035c | |||
| 5a660e73dd | |||
| 007a16eb9c | |||
| c9b4fa36fe | |||
| 2a3272e514 | |||
| e420b7f1af | |||
| 7914fc6056 | |||
| 667bdd813c | |||
| 66b5155b9b | |||
| 883fcd24f6 | |||
| fbed3ef159 | |||
| 2b3b36d646 | |||
| d9dd03ecc8 | |||
| d48a942932 | |||
| 3d2e20427c | |||
| d007122782 | |||
| f4d7e9588f | |||
| 7275f12a74 | |||
| 9c166be404 | |||
| 77355b10e4 | |||
| 6c87a736a6 | |||
| 3a0ec6e840 | |||
| 18d2835304 | |||
| fba27772a4 | |||
| c9e5a78115 | |||
| 2bbc2320dc | |||
| 07861dfe8c | |||
| 5d30433019 | |||
| 8c805fdd9c | |||
| e197d3deb3 | |||
| 4b2defac3a | |||
| 197c3c13a3 | |||
| 6f58beb2c5 | |||
| d20ce1efac | |||
| f0391e88fa | |||
| a12a862c47 | |||
| 6191118ac7 | |||
| 36d000eb17 | |||
| 6a1c9f4434 | |||
| 77cf46c859 | |||
| a6f505bebf | |||
| 09f6a2ee6f | |||
| 2cba5596a9 | |||
| de5a8a3d0a | |||
| 906633a884 | |||
| 96f54db0b1 | |||
| 3d14ff4a85 | |||
| 7731e4e8de | |||
| 248782fffb | |||
| c590e0fabe | |||
| bed658576d | |||
| 6fffa88f68 | |||
| 7e459c1926 | |||
| 904cf10e5c | |||
| 1926128fb0 | |||
| cfb11955d4 | |||
| 2f31604c4e | |||
| e63734c984 | |||
| 9883971beb | |||
| da42675a15 | |||
| cebe5719a5 | |||
| b80887ba1b | |||
| 808361b62c | |||
| 88c0c961cc | |||
| b8564e8f3e | |||
| 317cfd2fdd | |||
| ec8b9787e6 | |||
| 443dfc5a8a | |||
| 161dc87c6a | |||
| 4baf098491 | |||
| 08d0b2c013 | |||
| ac9159bdbd | |||
| e3a8649b41 | |||
| 5ef9a55d91 | |||
| e3e3b42c28 | |||
| d7db21a36b | |||
| aea3b5e83a | |||
| 6fe6ca92d4 | |||
| 7fc17b9032 | |||
| 985dbee74e | |||
| af71d4513a | |||
| f0cead5f06 | |||
| f341de7c2b | |||
| 750dc96712 | |||
| 8652064415 | |||
| 48c0c96f1f | |||
| cc68d5be67 | |||
| 16515e9095 | |||
| 2c4f42d383 | |||
| 6d1e4f32a4 | |||
| a396b94a9f | |||
| cba4b3b441 | |||
| 0f4f8cabf0 | |||
| 981ad386bf | |||
| 866dc14f08 | |||
| 34dca7cb76 | |||
| c655eb100d | |||
| f79b970056 | |||
| bc5023c708 | |||
| 48cae3b163 | |||
| d666d28c7c | |||
| d29c26a017 | |||
| 6feacf7582 | |||
| 232695c004 | |||
| 18b3ae007d | |||
| a281bebedf | |||
| 73c896a987 | |||
| bca1082c26 | |||
| cad347a936 | |||
| da5f4d3d65 | |||
| 2f05a73509 | |||
| c82f712f0b | |||
| 3e56f1223a | |||
| bd1cc61434 | |||
| e7d737f853 | |||
| ef6313ec9f | |||
| f1384d3a9a | |||
| 1efc59ffcf | |||
| ee752e66c0 | |||
| 5135e68569 | |||
| d895c35d6a | |||
| 52ca60df9a | |||
| ee96c924fc | |||
| b23774420b | |||
| 1df0c2bbd6 | |||
| a11aaab9be | |||
| 650df5b058 | |||
| d6ea464733 | |||
| bff71eeeba | |||
| 897d19ca1c | |||
| 8c1cc3e7bb | |||
| 962fed151a | |||
| c710e184e7 | |||
| 50d66c00a6 | |||
| 6249ced4fa | |||
| 7f4fb93996 | |||
| f2d4275b7f | |||
| 11ab405783 | |||
| 3aaa1d9daa | |||
| 91de84bec9 | |||
| 28e6cdd78a | |||
| 39d730faa0 | |||
| c3d3b5e8f3 | |||
| 137f6e4d98 | |||
| a29854b2cb | |||
| cc3e702204 | |||
| d4e4bc5dbf | |||
| 52e21a3a68 | |||
| 971666532e | |||
| 9cc508dc50 | |||
| 2a2c436013 | |||
| f486e6f263 | |||
| 90af8a8486 | |||
| 2237e2e799 | |||
| 96438d5078 | |||
| 038007c34e | |||
| 08fe894d1b | |||
| b95d3909a4 | |||
| cb69b086d7 | |||
| 86720d073e | |||
| 7540bc5610 | |||
| 96d33c668b | |||
| c1b3d7af59 | |||
| e64612a8d9 | |||
| 62c345bbb5 | |||
| ee728ed006 | |||
| 619f95b7f4 | |||
| fa7c55dee5 | |||
| 215b937f1e | |||
| f1e8dd5bf5 | |||
| fde37515c8 | |||
| f3b33d4084 | |||
| 86ea9a11d4 | |||
| b5bdf99069 | |||
| a475f0b2f6 | |||
| dcc6cd27b6 | |||
| 12f1d455b9 | |||
| 9429485236 | |||
| 451b37955e | |||
| 2ed275cd80 | |||
| 5d7862515f | |||
| 6121a27454 | |||
| 4c17158753 | |||
| 586a14f7f9 | |||
| 65a1fd1991 | |||
| e722d8ba1b | |||
| 6f3bffd840 | |||
| 80b7becd45 | |||
| 8051e7f207 | |||
| 7933f163b4 | |||
| 0836d6a926 | |||
| 36b1f49340 | |||
| b2710a0831 | |||
| 8bbb1f9ab2 | |||
| 8a597007cb | |||
| dc54553d2f | |||
| 527ec83b30 | |||
| abf03f0a80 | |||
| b397bdf83b | |||
| 32457e4ce8 | |||
| 94fac65238 | |||
| 1cabad8e3b | |||
| e753e55aa1 | |||
| 31db917eb8 | |||
| 59dd7e2ef9 | |||
| 30b0366818 | |||
| d6b15a6aec | |||
| ed7b2ef3ca | |||
| 70743394d8 |
+34
-6
@@ -26,10 +26,13 @@ CUSTOMER_ORDER_LIST_URL=/orderlist/
|
||||
# DB/역할/스키마/센터 seed 생성: scripts/sql/cupang_db_init.sql 참고.
|
||||
# CUPANG_DB_URL=postgresql://cupang_app:replace-me@postgres-db:5432/cupang_db
|
||||
|
||||
# 쿠팡 밀크런 출고리스트를 기록할 Google 스프레드시트 (분배 확정 시 출고일 시트 생성)
|
||||
# - 대상 문서는 반드시 "Google 스프레드시트" 형식(업로드한 .xlsx 는 파일>Google 스프레드시트로 저장)
|
||||
# - 서비스 계정 이메일(client_email)에 해당 문서를 편집자로 공유해야 한다
|
||||
# 쿠팡 밀크런 출고리스트 문서 (분배 확정·출고리스트 작성 팝업이 출고일 시트에 기록)
|
||||
# - 구글 드라이브에 올린 .xlsx 파일 id(기본값 = 아래 id). 구글 스프레드시트 문서 id 여도 된다(형식 자동 판별)
|
||||
# - .xlsx 는 Drive 권한이 필요하다: 서비스 계정(GOOGLE_SHEETS_CREDENTIALS) 또는 GOOGLE_SLIDES_OAUTH_REFRESH_TOKEN
|
||||
# - 서비스 계정이면 이메일(client_email)에 해당 파일을 편집자로 공유해야 한다
|
||||
# CUPANG_SHEET_ID=1J74op7lBZOgE27p4R28I3RWsv0EtXdii
|
||||
# "밀크런 출고리스트 작성" 팝업 전용 — 드라이브 .xlsx 파일 id(기본값 = 아래 id, 엑셀만·구글 시트로 대신 쓰지 않음)
|
||||
# CUPANG_OUTBOUND_XLSX_ID=1J74op7lBZOgE27p4R28I3RWsv0EtXdii
|
||||
#
|
||||
# [방식 A] 사용자 OAuth 리프레시 토큰 — 조직 정책으로 서비스 계정 키를 못 만들 때
|
||||
# 토큰 발급: python scripts/google_sheets_authorize.py --client-id .. --client-secret ..
|
||||
@@ -49,6 +52,10 @@ CUSTOMER_ORDER_LIST_URL=/orderlist/
|
||||
# Cloud Console 에서 Google Drive API·Google Slides API 사용 설정. 서비스 계정이면 공유 드라이브 콘텐츠 관리자로 추가.
|
||||
# GOOGLE_SLIDES_OAUTH_REFRESH_TOKEN=replace-me # 비우면 GOOGLE_SHEETS_OAUTH_REFRESH_TOKEN 사용
|
||||
# MEETING_BOARD_FOLDER_ID=0AGF3CIEboPQiUk9PVA # 보드를 만들 공유 드라이브(폴더) ID — 비우면 이 기본값
|
||||
#
|
||||
# Project 업무 파일 → 구글 드라이브(설명란·보드 카드·세부 업무에 파일 끌어 놓기) — 위 Google 인증(Drive 권한)을 같이 쓴다.
|
||||
# 그 아래 프로젝트/섹션/업무/세부 업무 폴더를 자동으로 만든다. 서비스 계정이면 공유 드라이브 폴더여야 올라간다.
|
||||
# PROJECT_DRIVE_FOLDER_ID=1Zdak2FtACRJ6peOnA9zD22hsbbsTixJG # 업무 파일 최상위 폴더 ID — 비우면 이 기본값
|
||||
|
||||
# ─── 휴가 관리 모듈 (vacation_db) ───
|
||||
# 설정해야 모듈이 동작한다(미설정 시 "설정 필요" 안내, JSON 폴백 없음).
|
||||
@@ -119,6 +126,11 @@ CUSTOMER_ORDER_LIST_URL=/orderlist/
|
||||
# 미설정 시 카페24 기본 도메인(https://<mall_id>.cafe24.com)으로 대체된다.
|
||||
# CAFE24_SHOP_URL=https://www.miras.co.kr
|
||||
#
|
||||
# 멀티쇼핑몰 번호(쉼표). 옵션/품목 팝업에서 바꾼 품목 진열·판매를 이 쇼핑몰 모두에 같은 값으로
|
||||
# 보낸다(추가금액·자체코드는 기본몰 1 만). 번호는 카페24 관리자 → 멀티쇼핑몰 관리에서 확인.
|
||||
# 미설정 시 1(기본몰)만.
|
||||
# CAFE24_SHOP_NOS=1,2,3
|
||||
#
|
||||
# 카페24 읽기 지연 유예시간(분). 카페24 관리자 API 는 PUT 뒤 한동안 GET 에서 예전
|
||||
# 값을 돌려준다. 이 시간 안에 우리가 쓴 값이 있으면, GET 이 그 이전 값을 돌려줘도
|
||||
# 마지막 쓰기(revision·스냅샷)를 화면·적용 기준으로 삼는다. 지나면 카페24 값을 믿는다.
|
||||
@@ -144,6 +156,21 @@ CUSTOMER_ORDER_LIST_URL=/orderlist/
|
||||
# CAFE24_MOBILE_DETAIL_FTP_PATH=/sde_design/mobile11/product/detail.html
|
||||
# CAFE24_PC_DETAIL_FTP_PATH=/sde_design/skin11/product/detail.html
|
||||
|
||||
# ─── 입출고 관리 모듈 (inout_db) — app/modules/inout ───
|
||||
# 본사 → 공장 발주, 물류 입고, 미입고 관리. 미설정 시 "설정 필요" 안내만.
|
||||
# 초기화: scripts/sql/inout_db_init.sql (docs/INOUT_MODULE.md). 제품(단품)은 아래 ITEMCODE_DB_URL 재사용.
|
||||
# INOUT_DB_URL=postgresql://inout_app:replace-me@postgres-db:5432/inout_db
|
||||
|
||||
# ─── 안내문 발송 모듈 (outreach_db) — app/modules/outreach ───
|
||||
# 리스트(이메일·인스타 주소 + 이름)에 안내문 메일 일괄 발송(보내는 사람 본인 Gmail — 입출고 Gmail 연결 재사용)·인스타 DM 반자동.
|
||||
# 초기화: scripts/sql/outreach_db_init.sql (docs/DEPLOYMENT.md "안내문 발송 DB 생성"). 미설정 시 "설정 필요" 안내만.
|
||||
# OUTREACH_DB_URL=postgresql://outreach_app:replace-me@postgres-db:5432/outreach_db
|
||||
|
||||
# ─── 라이브 커머스 모듈 (live_db) — app/modules/live ───
|
||||
# 말레이시아 라이브 방송의 호스트 정보·방송 스케줄·판매금액·결과 이미지.
|
||||
# 초기화: scripts/sql/live_db_init.sql (docs/DEPLOYMENT.md "라이브 커머스 DB 생성"). 미설정 시 "설정 필요" 안내만.
|
||||
# LIVE_DB_URL=postgresql://live_app:replace-me@postgres-db:5432/live_db
|
||||
|
||||
# ─── 상품 검색 (itemcode_db 읽기 전용) ───
|
||||
# cupang 설정 화면에서 제품명을 itemcode_db 에서 검색해 등록한다(읽기만).
|
||||
# 미설정 시 검색 비활성 → 수동 등록만 가능.
|
||||
@@ -169,10 +196,11 @@ CUSTOMER_ORDER_LIST_URL=/orderlist/
|
||||
# APP_ENCRYPTION_KEY_V1=
|
||||
# [매출 업데이트] 가 가져오는 기간(오늘 포함 최근 N일, 기본 7, 최대 90)
|
||||
# PERFORMANCE_SYNC_DAYS=7
|
||||
# 매출 자동 업데이트(웹 프로세스 안 스레드) — 기본 켜짐, 매일 09:00~19:00 정각·30분마다 오늘 포함 최근 10일.
|
||||
# PERFORMANCE_AUTO_SYNC=false # 끄기
|
||||
# 매출·광고비 자동 업데이트(웹 프로세스 안 스레드) — 기본 켜짐, 오늘 포함 최근 10일.
|
||||
# 일정(간격·요일·시작/끝)은 실적 설정 "자동 업데이트" 카드에서 매출·광고비 따로 정한다(performance_db 011). 저장 전 기본 = 매일 9~19시 30분마다.
|
||||
# PERFORMANCE_AUTO_SYNC=false # 끄기(설정 화면 일정과 상관없이)
|
||||
# PERFORMANCE_AUTO_SYNC_DAYS=10 # 가져올 기간(1~90일)
|
||||
# PERFORMANCE_AUTO_SYNC_HOURS=9-19 # 시간대(시작시-마지막시, 마지막 시는 정각 회차까지)
|
||||
# PERFORMANCE_AUTO_SYNC_HOURS=9-19 # 일정 저장 전 기본 시간대(시작시-마지막시, 마지막 시는 정각 회차까지)
|
||||
|
||||
# 자산관리 — 별도 asset_db. 사용자가 서버에서 asset_db_init.sql로 직접 초기화.
|
||||
# 미설정 시 등록/배정은 비활성, HWiNFO XML 분석 미리보기는 사용 가능.
|
||||
|
||||
@@ -3,6 +3,11 @@ FROM python:3.12-slim
|
||||
# 작업 디렉토리
|
||||
WORKDIR /app
|
||||
|
||||
# 글자 인식(라이브 커머스 결과 이미지 → 매출, app/modules/live/ocr.py) — 영어 데이터만
|
||||
RUN apt-get update \
|
||||
&& apt-get install -y --no-install-recommends tesseract-ocr tesseract-ocr-eng \
|
||||
&& rm -rf /var/lib/apt/lists/*
|
||||
|
||||
# 의존성 먼저 설치 (캐시 활용)
|
||||
COPY requirements.txt .
|
||||
RUN pip install --no-cache-dir -r requirements.txt
|
||||
|
||||
@@ -85,10 +85,17 @@ def read_text_file(config: Cafe24FtpConfig, path: str) -> str:
|
||||
|
||||
|
||||
def temp_names(path: str, tag: str) -> tuple[str, str]:
|
||||
"""(임시 업로드 이름, 원본을 잠시 비킬 이름) — 같은 폴더, 원본 이름 + 표식."""
|
||||
"""(임시 업로드 이름, 원본을 잠시 비킬 이름) — 같은 폴더, 원본 이름 + 표식.
|
||||
|
||||
⚠️ 원래 확장자를 **맨 끝에 그대로** 둔다. 카페24 디자인 FTP 는 허용된 확장자(.js·
|
||||
.html·.css 등)만 받는다 — 예전 이름 `product-swiper.js.cf24tmp-…` 는 확장자가 바뀌어
|
||||
STOR 가 `550 Operation not permitted` 로 거부됐다(실물). 그래서
|
||||
`product-swiper_cf24tmp_<tag>.js` 모양으로 만든다(점·하이픈 대신 밑줄).
|
||||
"""
|
||||
folder, name = posixpath.split(path)
|
||||
return (posixpath.join(folder, f"{name}.cf24tmp-{tag}"),
|
||||
posixpath.join(folder, f"{name}.cf24old-{tag}"))
|
||||
stem, ext = posixpath.splitext(name)
|
||||
return (posixpath.join(folder, f"{stem}_cf24tmp_{tag}{ext}"),
|
||||
posixpath.join(folder, f"{stem}_cf24old_{tag}{ext}"))
|
||||
|
||||
|
||||
def write_text_file(
|
||||
|
||||
@@ -486,7 +486,7 @@ VARIANT_UNKNOWN = "unknown" # 요청이 도달했을 수 있으나 응답을
|
||||
|
||||
|
||||
def update_variants(
|
||||
client: Cafe24Client, product_no: int, requests: list[dict[str, Any]]
|
||||
client: Cafe24Client, product_no: int, requests: list[dict[str, Any]], *, shop_no: int = 1
|
||||
) -> list[dict[str, Any]]:
|
||||
"""여러 품목 부분 수정 — **행별 결과**를 돌려준다(요청 순서 그대로).
|
||||
|
||||
@@ -506,7 +506,7 @@ def update_variants(
|
||||
continue
|
||||
try:
|
||||
payload = client.put(
|
||||
f"/admin/products/{no}/variants", json={"shop_no": 1, "requests": chunk}, product_no=no
|
||||
f"/admin/products/{no}/variants", json={"shop_no": int(shop_no), "requests": chunk}, product_no=no
|
||||
)
|
||||
except Cafe24Error as exc:
|
||||
status = VARIANT_UNKNOWN if getattr(exc, "maybe_applied", False) else VARIANT_FAILED
|
||||
|
||||
@@ -0,0 +1,345 @@
|
||||
"""Google 드라이브에 올려 둔 엑셀(.xlsx) 파일을 시트처럼 고쳐 쓰기(쿠팡 밀크런 출고리스트, 2026-10-23).
|
||||
|
||||
구글 시트 문서가 아니라 드라이브의 .xlsx 파일이면 Sheets API 로는 쓸 수 없다. 그래서
|
||||
파일을 내려받아(openpyxl) 고친 뒤 같은 파일 id 에 내용을 다시 올린다(링크·공유·이름 그대로).
|
||||
|
||||
- 인증은 google_drive 와 같다(서비스 계정 우선, 없으면 OAuth 리프레시 토큰 — Drive 권한 포함).
|
||||
- `GoogleSheetsWriter` 와 같은 메서드(sheet_titles·read_ranges·append_block·write_table·delete_sheet·lock)를
|
||||
같은 인자로 제공한다 → cupang 라우터는 어느 쪽인지 몰라도 된다(`file_kind` 로 골라 씀).
|
||||
- `with writer.lock:` 안의 호출은 내려받은 사본 하나를 같이 쓰고, 블록이 끝날 때 바뀐 게 있으면 한 번만 올린다.
|
||||
잠금 밖에서 부른 메서드는 호출마다 내려받고(바뀌면) 올린다.
|
||||
- 올리기 직전에 파일 version 을 다시 보고, 그 사이 누가 고쳤으면 `XlsxChangedError` — 덮어쓰지 않는다
|
||||
(호출부가 처음부터 다시 시도).
|
||||
- 비밀값은 로그·화면에 출력하지 않는다.
|
||||
"""
|
||||
|
||||
from __future__ import annotations
|
||||
|
||||
import re
|
||||
import threading
|
||||
from io import BytesIO
|
||||
from typing import Any
|
||||
|
||||
from app.integrations.google_drive import GoogleDriveError, GoogleDriveFiles, _friendly_drive
|
||||
|
||||
XLSX_MIME = "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet"
|
||||
SHEETS_MIME = "application/vnd.google-apps.spreadsheet"
|
||||
_RANGE_RE = re.compile(r"^([A-Z]+)(\d*)(?::([A-Z]+)(\d*))?$")
|
||||
|
||||
# 같은 파일을 두 요청이 동시에 내려받아 고치면 나중 것이 앞의 것을 지우므로 한 번에 하나씩.
|
||||
_LOCK = threading.RLock()
|
||||
_KIND_CACHE: dict[str, str] = {}
|
||||
|
||||
|
||||
class XlsxChangedError(RuntimeError):
|
||||
"""내려받은 뒤 올리기 전에 다른 사람이 파일을 고쳤다."""
|
||||
|
||||
|
||||
def _col_num(letters: str) -> int:
|
||||
n = 0
|
||||
for ch in letters:
|
||||
n = n * 26 + (ord(ch) - 64)
|
||||
return n
|
||||
|
||||
|
||||
def _parse_range(a1: str) -> tuple[str, int, int, int | None, int | None]:
|
||||
""""'시트'!F6:F" → (시트, 첫 행, 첫 열, 끝 행|None, 끝 열|None). 끝이 비면 시트 끝까지."""
|
||||
sheet, _, ref = a1.rpartition("!")
|
||||
if sheet.startswith("'") and sheet.endswith("'"):
|
||||
sheet = sheet[1:-1].replace("''", "'")
|
||||
m = _RANGE_RE.match(ref.upper())
|
||||
if not sheet or not m:
|
||||
raise ValueError(f"지원하지 않는 범위: {a1}")
|
||||
c1, r1, c2, r2 = m.groups()
|
||||
if c2 is None: # 셀 하나
|
||||
c2, r2 = c1, r1
|
||||
return sheet, int(r1 or 1), _col_num(c1), (int(r2) if r2 else None), _col_num(c2)
|
||||
|
||||
|
||||
def _text(value: Any) -> str:
|
||||
"""Sheets API 의 FORMATTED_VALUE 처럼 문자열로(정수인 실수는 소수점 없이)."""
|
||||
if value is None:
|
||||
return ""
|
||||
if isinstance(value, float) and value.is_integer():
|
||||
return str(int(value))
|
||||
return str(value)
|
||||
|
||||
|
||||
def _put(cell: Any, value: Any) -> None:
|
||||
"""Sheets 의 USER_ENTERED 처럼 앞의 작은따옴표는 "글자 그대로" 표시로 보고 떼어 낸다."""
|
||||
if isinstance(value, str) and value.startswith("'"):
|
||||
cell.value = value[1:]
|
||||
cell.data_type = "s" # '=' 로 시작해도 수식이 되지 않게
|
||||
else:
|
||||
cell.value = value
|
||||
|
||||
|
||||
class DriveXlsxWriter(GoogleDriveFiles):
|
||||
"""드라이브 .xlsx 파일 하나를 GoogleSheetsWriter 처럼 다룬다(spreadsheet_id = 드라이브 파일 id)."""
|
||||
|
||||
def __init__(self) -> None:
|
||||
super().__init__()
|
||||
self._depth = 0
|
||||
self._book: dict[str, Any] | None = None # {"id", "wb", "version", "dirty"}
|
||||
|
||||
# ── 내려받기 / 올리기 ───────────────────────────
|
||||
def file_kind(self, file_id: str) -> str:
|
||||
""""xlsx" | "sheets" | 그 밖의 mimeType. 실패는 GoogleDriveError(사유)."""
|
||||
if file_id in _KIND_CACHE:
|
||||
return _KIND_CACHE[file_id]
|
||||
meta = self._meta(file_id, "mimeType")
|
||||
mime = str(meta.get("mimeType") or "")
|
||||
kind = "xlsx" if mime == XLSX_MIME else "sheets" if mime == SHEETS_MIME else mime
|
||||
_KIND_CACHE[file_id] = kind
|
||||
return kind
|
||||
|
||||
def _meta(self, file_id: str, fields: str) -> dict[str, Any]:
|
||||
self._check()
|
||||
try:
|
||||
return self._service().files().get(fileId=file_id, fields=fields, supportsAllDrives=True).execute()
|
||||
except Exception as exc: # noqa: BLE001
|
||||
raise self._error(exc) from None
|
||||
|
||||
@staticmethod
|
||||
def _error(exc: Exception) -> GoogleDriveError:
|
||||
text = _friendly_drive(exc).replace("업무 파일 폴더", "출고리스트 엑셀 파일")
|
||||
return GoogleDriveError(text)
|
||||
|
||||
def _open(self, file_id: str) -> dict[str, Any]:
|
||||
from openpyxl import load_workbook
|
||||
|
||||
version = str(self._meta(file_id, "version").get("version") or "")
|
||||
try:
|
||||
data = self._service().files().get_media(fileId=file_id, supportsAllDrives=True).execute()
|
||||
except Exception as exc: # noqa: BLE001
|
||||
raise self._error(exc) from None
|
||||
return {"id": file_id, "wb": load_workbook(BytesIO(data)), "version": version, "dirty": False}
|
||||
|
||||
def _save(self, book: dict[str, Any]) -> None:
|
||||
from googleapiclient.http import MediaIoBaseUpload
|
||||
|
||||
now = str(self._meta(book["id"], "version").get("version") or "")
|
||||
if book["version"] and now != book["version"]:
|
||||
raise XlsxChangedError("출고리스트 엑셀 파일이 그 사이 바뀌었습니다.")
|
||||
out = BytesIO()
|
||||
book["wb"].save(out)
|
||||
out.seek(0)
|
||||
try:
|
||||
self._service().files().update(
|
||||
fileId=book["id"], media_body=MediaIoBaseUpload(out, mimetype=XLSX_MIME, resumable=False),
|
||||
fields="id", supportsAllDrives=True,
|
||||
).execute()
|
||||
except Exception as exc: # noqa: BLE001
|
||||
raise self._error(exc) from None
|
||||
|
||||
class _Session:
|
||||
def __init__(self, writer: "DriveXlsxWriter") -> None:
|
||||
self.w = writer
|
||||
|
||||
def __enter__(self) -> "DriveXlsxWriter":
|
||||
_LOCK.acquire()
|
||||
self.w._depth += 1
|
||||
return self.w
|
||||
|
||||
def __exit__(self, exc_type: Any, *_: Any) -> None:
|
||||
w = self.w
|
||||
try:
|
||||
w._depth -= 1
|
||||
if w._depth == 0:
|
||||
book, w._book = w._book, None
|
||||
if exc_type is None and book is not None and book["dirty"]:
|
||||
w._save(book)
|
||||
finally:
|
||||
_LOCK.release()
|
||||
|
||||
@property
|
||||
def lock(self) -> "DriveXlsxWriter._Session":
|
||||
"""이 블록 안의 호출은 내려받은 사본 하나를 같이 쓰고, 끝날 때 바뀐 게 있으면 한 번 올린다."""
|
||||
return DriveXlsxWriter._Session(self)
|
||||
|
||||
def _wb(self, file_id: str) -> Any:
|
||||
if self._book is None or self._book["id"] != file_id:
|
||||
if self._book is not None and self._book["dirty"]:
|
||||
self._save(self._book)
|
||||
self._book = self._open(file_id)
|
||||
return self._book["wb"]
|
||||
|
||||
def _touch(self) -> None:
|
||||
if self._book is not None:
|
||||
self._book["dirty"] = True
|
||||
|
||||
@staticmethod
|
||||
def _url(file_id: str) -> str:
|
||||
return f"https://docs.google.com/spreadsheets/d/{file_id}/edit"
|
||||
|
||||
# ── GoogleSheetsWriter 와 같은 메서드 ────────────
|
||||
def sheet_titles(self, *, spreadsheet_id: str) -> list[str]:
|
||||
with self.lock:
|
||||
return list(self._wb(spreadsheet_id).sheetnames)
|
||||
|
||||
def read_ranges(self, *, spreadsheet_id: str, ranges: list[str], chunk: int = 50) -> list[list[list[Any]]]:
|
||||
"""범위마다 값의 2차원 목록(문자열) — Sheets API 처럼 뒤쪽 빈 칸·빈 행은 잘라 낸다."""
|
||||
del chunk
|
||||
with self.lock:
|
||||
wb = self._wb(spreadsheet_id)
|
||||
out: list[list[list[Any]]] = []
|
||||
for a1 in ranges:
|
||||
title, r1, c1, r2, c2 = _parse_range(a1)
|
||||
if title not in wb.sheetnames:
|
||||
out.append([])
|
||||
continue
|
||||
ws = wb[title]
|
||||
rows = [
|
||||
[_text(v) for v in row]
|
||||
for row in ws.iter_rows(min_row=r1, max_row=r2 or ws.max_row, min_col=c1,
|
||||
max_col=c2 or ws.max_column, values_only=True)
|
||||
]
|
||||
for row in rows:
|
||||
while row and row[-1] == "":
|
||||
row.pop()
|
||||
while rows and not rows[-1]:
|
||||
rows.pop()
|
||||
out.append(rows)
|
||||
return out
|
||||
|
||||
def append_block(
|
||||
self,
|
||||
*,
|
||||
spreadsheet_id: str,
|
||||
title: str,
|
||||
cells: dict[tuple[int, int], Any],
|
||||
merges: list[tuple[int, int, int, int]],
|
||||
first_row: int,
|
||||
last_row: int,
|
||||
first_col: int,
|
||||
last_col: int,
|
||||
left_cols: tuple[int, ...] = (9,),
|
||||
highlight: str = "",
|
||||
) -> dict[str, Any]:
|
||||
"""이미 있는 시트의 first_row~last_row 에 표 한 덩어리(위쪽 내용은 그대로). 서식은 GoogleSheetsWriter 와 같다."""
|
||||
from openpyxl.styles import PatternFill
|
||||
|
||||
with self.lock:
|
||||
wb = self._wb(spreadsheet_id)
|
||||
if title not in wb.sheetnames:
|
||||
raise LookupError(f"시트 '{title}' 이(가) 없습니다.")
|
||||
ws = wb[title]
|
||||
for (r, c), value in cells.items():
|
||||
_put(ws.cell(row=r, column=c), value)
|
||||
for (r1, c1, r2, c2) in merges:
|
||||
ws.merge_cells(start_row=r1, start_column=c1, end_row=r2, end_column=c2)
|
||||
fill = PatternFill("solid", fgColor=highlight) if highlight else PatternFill(fill_type=None)
|
||||
_style_rows(ws, first_row, last_row, first_col, last_col, left_cols=left_cols, fill=fill)
|
||||
self._touch()
|
||||
return {
|
||||
"created": False, "title": title, "first_row": first_row, "last_row": last_row,
|
||||
"url": self._url(spreadsheet_id),
|
||||
}
|
||||
|
||||
def delete_sheet(self, *, spreadsheet_id: str, title: str) -> dict[str, Any]:
|
||||
"""시트 1장 삭제. 없으면 missing, 문서에 그 하나뿐이면 내용만 비운다(cleared)."""
|
||||
with self.lock:
|
||||
wb = self._wb(spreadsheet_id)
|
||||
if title not in wb.sheetnames:
|
||||
return {"ok": True, "action": "missing", "title": title}
|
||||
if len(wb.sheetnames) <= 1:
|
||||
_replace_sheet(wb, title)
|
||||
action = "cleared"
|
||||
else:
|
||||
wb.remove(wb[title])
|
||||
wb.active = min(wb.index(wb.active) if wb.active is not None else 0, len(wb.sheetnames) - 1)
|
||||
action = "deleted"
|
||||
self._touch()
|
||||
return {"ok": True, "action": action, "title": title}
|
||||
|
||||
def write_table(
|
||||
self,
|
||||
*,
|
||||
spreadsheet_id: str,
|
||||
title: str,
|
||||
cells: dict[tuple[int, int], Any],
|
||||
merges: list[tuple[int, int, int, int]],
|
||||
header_row: int,
|
||||
first_data_row: int,
|
||||
last_row: int,
|
||||
first_col: int,
|
||||
last_col: int,
|
||||
title_row: int,
|
||||
widths: dict[int, int],
|
||||
header_bg: str = "",
|
||||
row_highlights: list[tuple[int, int, str]] | None = None,
|
||||
) -> dict[str, Any]:
|
||||
"""시트를 만들고(있으면 새로 갈아 끼우고) 표를 통째로 기록한다. 좌표 1-based, 색은 "RRGGBB"."""
|
||||
from openpyxl.styles import Alignment, Font, PatternFill
|
||||
from openpyxl.utils import get_column_letter
|
||||
|
||||
with self.lock:
|
||||
wb = self._wb(spreadsheet_id)
|
||||
created = title not in wb.sheetnames
|
||||
ws = _replace_sheet(wb, title)
|
||||
for (r, c), value in cells.items():
|
||||
_put(ws.cell(row=r, column=c), value)
|
||||
for (r1, c1, r2, c2) in merges:
|
||||
ws.merge_cells(start_row=r1, start_column=c1, end_row=r2, end_column=c2)
|
||||
|
||||
center = Alignment(horizontal="center", vertical="center", wrap_text=True)
|
||||
head = ws.cell(row=title_row, column=first_col)
|
||||
head.font = Font(size=16, bold=True)
|
||||
head.alignment = center
|
||||
ws.row_dimensions[title_row].height = 28
|
||||
header_fill = PatternFill("solid", fgColor=header_bg) if header_bg else PatternFill(fill_type=None)
|
||||
_style_rows(ws, header_row, header_row, first_col, last_col, left_cols=(), fill=header_fill)
|
||||
for col in range(first_col, last_col + 1):
|
||||
ws.cell(row=header_row, column=col).font = Font(bold=True)
|
||||
if last_row >= first_data_row:
|
||||
_style_rows(ws, first_data_row, last_row, first_col, last_col, left_cols=(9,), fill=None)
|
||||
for (r1, r2, color) in (row_highlights or []):
|
||||
fill = PatternFill("solid", fgColor=color)
|
||||
for row in range(r1, r2 + 1):
|
||||
for col in range(first_col, last_col + 1):
|
||||
ws.cell(row=row, column=col).fill = fill
|
||||
for col, px in widths.items():
|
||||
ws.column_dimensions[get_column_letter(col)].width = round(px / 7.0, 2)
|
||||
self._touch()
|
||||
return {"created": created, "title": title, "url": self._url(spreadsheet_id)}
|
||||
|
||||
|
||||
def _replace_sheet(wb: Any, title: str) -> Any:
|
||||
"""같은 이름의 빈 시트로 갈아 끼운다(탭 위치 유지). 없으면 맨 뒤에 새로."""
|
||||
if title in wb.sheetnames:
|
||||
index = wb.sheetnames.index(title)
|
||||
wb.remove(wb[title])
|
||||
return wb.create_sheet(title, index)
|
||||
return wb.create_sheet(title)
|
||||
|
||||
|
||||
def _style_rows(
|
||||
ws: Any, r1: int, r2: int, c1: int, c2: int, *, left_cols: tuple[int, ...], fill: Any
|
||||
) -> None:
|
||||
"""가운데 정렬·줄바꿈·얇은 검은 테두리, left_cols 만 왼쪽 정렬. fill 이 None 이면 배경은 그대로."""
|
||||
from openpyxl.styles import Alignment, Border, Side
|
||||
|
||||
thin = Side(style="thin", color="000000")
|
||||
box = Border(left=thin, right=thin, top=thin, bottom=thin)
|
||||
center = Alignment(horizontal="center", vertical="center", wrap_text=True)
|
||||
left = Alignment(horizontal="left", vertical="center", wrap_text=True)
|
||||
for row in range(r1, r2 + 1):
|
||||
for col in range(c1, c2 + 1):
|
||||
cell = ws.cell(row=row, column=col)
|
||||
cell.border = box
|
||||
cell.alignment = left if col in left_cols else center
|
||||
if fill is not None:
|
||||
cell.fill = fill
|
||||
|
||||
|
||||
_WRITER: DriveXlsxWriter | None = None
|
||||
_WRITER_LOCK = threading.Lock()
|
||||
|
||||
|
||||
def get_writer() -> DriveXlsxWriter:
|
||||
"""프로세스당 하나(설정이 비어 있으면 매번 다시 확인)."""
|
||||
global _WRITER
|
||||
with _WRITER_LOCK:
|
||||
if _WRITER is None or not _WRITER.enabled:
|
||||
_WRITER = DriveXlsxWriter()
|
||||
return _WRITER
|
||||
@@ -0,0 +1,209 @@
|
||||
"""Google 드라이브 — 업무 파일 올리기(설명란·보드 카드·세부 업무에 파일 끌어 놓기, 2026-10-19).
|
||||
|
||||
인증은 google_slides 와 같은 설정(서비스 계정 우선, 없으면 OAuth 리프레시 토큰 — Drive 권한 포함)을 쓴다.
|
||||
|
||||
- 최상위 폴더 `PROJECT_DRIVE_FOLDER_ID`(기본 = 업무 파일 폴더). 그 아래 `프로젝트/섹션/업무/세부 업무` 폴더를 이름으로
|
||||
찾고 없으면 만든다(휴지통 폴더 제외). 같은 경로를 두 사람이 동시에 만들지 않게 폴더 찾기·만들기는 한 번에 하나씩.
|
||||
- 올린 파일은 appProperties `dbxTaskId` = 업무 id — 설명란에서 링크를 지우면 **우리가 올린 파일만** 휴지통으로 보낸다
|
||||
(다른 사람이 붙여 넣은 드라이브 링크는 건드리지 않음). 링크를 되살리면(되돌리기·잘라 붙이기) 휴지통에서 꺼낸다.
|
||||
휴지통 파일은 드라이브가 30일 뒤 지운다.
|
||||
- 서비스 계정은 내 드라이브 저장 용량이 없어 "공유 드라이브" 폴더여야 올라간다(OAuth 토큰이면 그 사용자 드라이브도 됨).
|
||||
- 비밀값(키/토큰)은 로그·화면에 절대 출력하지 않는다. 라이브러리·설정이 없으면 `enabled = False`.
|
||||
"""
|
||||
|
||||
from __future__ import annotations
|
||||
|
||||
import os
|
||||
import re
|
||||
import threading
|
||||
from typing import Any, BinaryIO, Iterable
|
||||
|
||||
from app.integrations.google_slides import GoogleSlidesClient, _friendly
|
||||
|
||||
DEFAULT_FOLDER_ID = "1Zdak2FtACRJ6peOnA9zD22hsbbsTixJG"
|
||||
FOLDER_MIME = "application/vnd.google-apps.folder"
|
||||
TASK_KEY = "dbxTaskId"
|
||||
CHUNK = 8 * 1024 * 1024
|
||||
# 설명란 링크에서 드라이브 파일 id — 우리가 넣는 링크 모양(https://drive.google.com/file/d/<id>/view)
|
||||
FILE_LINK_RE = re.compile(r"https://drive\.google\.com/file/d/([A-Za-z0-9_-]{10,})")
|
||||
|
||||
# 폴더 찾기·만들기는 한 번에 하나(같은 폴더가 두 개 생기지 않게). 파일 올리기·휴지통은 호출마다 따로 만든
|
||||
# 서비스 객체로(googleapiclient 의 HTTP 는 스레드 안전하지 않다) — 큰 파일이 다른 사람 업로드를 막지 않게.
|
||||
_FOLDER_LOCK = threading.Lock()
|
||||
|
||||
|
||||
class GoogleDriveError(RuntimeError):
|
||||
"""화면에 보여도 되는 사유(비밀값 없음)."""
|
||||
|
||||
|
||||
def root_folder_id() -> str:
|
||||
return (os.getenv("PROJECT_DRIVE_FOLDER_ID") or "").strip() or DEFAULT_FOLDER_ID
|
||||
|
||||
|
||||
def file_url(file_id: str) -> str:
|
||||
return f"https://drive.google.com/file/d/{file_id}/view"
|
||||
|
||||
|
||||
def file_ids_in(html: str) -> set[str]:
|
||||
"""설명 HTML 안의 드라이브 파일 링크 id 들."""
|
||||
return set(FILE_LINK_RE.findall(html or ""))
|
||||
|
||||
|
||||
def folder_name(name: Any) -> str:
|
||||
"""폴더 이름 — 앞뒤 공백·줄바꿈 정리, 너무 길면 자름, 비면 "(이름 없음)"."""
|
||||
s = re.sub(r"\s+", " ", str(name or "")).strip()[:120]
|
||||
return s or "(이름 없음)"
|
||||
|
||||
|
||||
def _q(value: str) -> str:
|
||||
"""Drive 검색어 따옴표 안 글자(역슬래시·작은따옴표 이스케이프)."""
|
||||
return value.replace("\\", "\\\\").replace("'", "\\'")
|
||||
|
||||
|
||||
class GoogleDriveFiles(GoogleSlidesClient):
|
||||
"""google_slides 의 인증(서비스 계정·OAuth)을 그대로 쓰고 Drive 만 연다."""
|
||||
|
||||
def __init__(self) -> None: # noqa: D107 — 부모 __init__ 대신(Slides 서비스는 만들지 않음)
|
||||
self.enabled = False
|
||||
self.reason = ""
|
||||
self.auth_mode = ""
|
||||
self._creds: Any = None
|
||||
try:
|
||||
import googleapiclient.discovery # noqa: F401
|
||||
import googleapiclient.http # noqa: F401
|
||||
except ImportError:
|
||||
self.reason = "google-api-python-client 미설치"
|
||||
return
|
||||
creds = self._service_account_creds()
|
||||
if creds is None:
|
||||
creds = self._oauth_creds()
|
||||
if creds is None:
|
||||
if not self.reason:
|
||||
self.reason = "Google 인증 미설정(GOOGLE_SHEETS_CREDENTIALS 또는 GOOGLE_SLIDES_OAUTH_REFRESH_TOKEN 필요)"
|
||||
return
|
||||
self._creds = creds
|
||||
self.enabled = True
|
||||
|
||||
def _service(self) -> Any:
|
||||
from googleapiclient.discovery import build
|
||||
|
||||
return build("drive", "v3", credentials=self._creds, cache_discovery=False)
|
||||
|
||||
def _check(self) -> None:
|
||||
if not self.enabled:
|
||||
raise GoogleDriveError(self.reason or "Google 드라이브 연동이 꺼져 있습니다.")
|
||||
|
||||
# ────────────────────────────────────────────────
|
||||
def ensure_folder_path(self, names: Iterable[str], *, root: str | None = None) -> str:
|
||||
"""root 아래 names 순서대로 폴더를 찾거나 만들고 마지막 폴더 id."""
|
||||
self._check()
|
||||
parent = root or root_folder_id()
|
||||
with _FOLDER_LOCK:
|
||||
try:
|
||||
drive = self._service()
|
||||
for raw in names:
|
||||
name = folder_name(raw)
|
||||
q = (f"'{_q(parent)}' in parents and name = '{_q(name)}' and mimeType = '{FOLDER_MIME}' "
|
||||
"and trashed = false")
|
||||
res = drive.files().list(
|
||||
q=q, fields="files(id)", pageSize=1, supportsAllDrives=True, includeItemsFromAllDrives=True,
|
||||
corpora="allDrives", orderBy="createdTime",
|
||||
).execute()
|
||||
found = res.get("files") or []
|
||||
if found:
|
||||
parent = found[0]["id"]
|
||||
continue
|
||||
parent = drive.files().create(
|
||||
body={"name": name, "mimeType": FOLDER_MIME, "parents": [parent]},
|
||||
fields="id", supportsAllDrives=True,
|
||||
).execute()["id"]
|
||||
except GoogleDriveError:
|
||||
raise
|
||||
except Exception as exc: # noqa: BLE001
|
||||
raise GoogleDriveError(_friendly_drive(exc)) from None
|
||||
return parent
|
||||
|
||||
def upload(self, *, folder_id: str, name: str, stream: BinaryIO, mimetype: str, task_id: int) -> dict[str, Any]:
|
||||
"""폴더에 파일 하나 → {id, name, url}. 이름은 원래 파일 이름.확장자 그대로."""
|
||||
self._check()
|
||||
from googleapiclient.http import MediaIoBaseUpload
|
||||
|
||||
try:
|
||||
media = MediaIoBaseUpload(stream, mimetype=mimetype or "application/octet-stream", chunksize=CHUNK,
|
||||
resumable=True)
|
||||
meta = {"name": name, "parents": [folder_id], "appProperties": {TASK_KEY: str(int(task_id))}}
|
||||
f = self._service().files().create(body=meta, media_body=media, fields="id,name",
|
||||
supportsAllDrives=True).execute()
|
||||
except Exception as exc: # noqa: BLE001
|
||||
raise GoogleDriveError(_friendly_drive(exc)) from None
|
||||
return {"id": f["id"], "name": f.get("name") or name, "url": file_url(f["id"])}
|
||||
|
||||
def ours(self, file_id: str) -> dict[str, Any] | None:
|
||||
"""우리가 올린 파일이면 {trashed, task_id}, 아니면(남의 파일·없는 파일·권한 없음) None."""
|
||||
self._check()
|
||||
try:
|
||||
f = self._service().files().get(fileId=file_id, fields="trashed,appProperties",
|
||||
supportsAllDrives=True).execute()
|
||||
except Exception: # noqa: BLE001 — 지워졌거나 볼 수 없는 파일은 건드리지 않는다
|
||||
return None
|
||||
tid = (f.get("appProperties") or {}).get(TASK_KEY)
|
||||
if not tid:
|
||||
return None
|
||||
return {"trashed": bool(f.get("trashed")), "task_id": tid}
|
||||
|
||||
def move_to(self, file_id: str, folder_id: str, *, task_id: int) -> bool:
|
||||
"""그 업무가 올린 파일(appProperties dbxTaskId == task_id)이면 folder_id 로 옮긴다 — 옮겼으면 True.
|
||||
남의 파일·다른 업무가 올린 파일(링크만 붙여 넣은 것)·이미 그 폴더에 있는 파일은 그대로 둔다."""
|
||||
self._check()
|
||||
try:
|
||||
drive = self._service()
|
||||
f = drive.files().get(fileId=file_id, fields="parents,appProperties",
|
||||
supportsAllDrives=True).execute()
|
||||
except Exception: # noqa: BLE001 — 지워졌거나 볼 수 없는 파일은 건드리지 않는다
|
||||
return False
|
||||
if (f.get("appProperties") or {}).get(TASK_KEY) != str(int(task_id)):
|
||||
return False
|
||||
parents = [p for p in (f.get("parents") or []) if p]
|
||||
if parents == [folder_id]:
|
||||
return False
|
||||
try:
|
||||
drive.files().update(fileId=file_id, addParents=folder_id,
|
||||
removeParents=",".join(p for p in parents if p != folder_id),
|
||||
fields="id", supportsAllDrives=True).execute()
|
||||
except Exception as exc: # noqa: BLE001
|
||||
raise GoogleDriveError(_friendly_drive(exc)) from None
|
||||
return True
|
||||
|
||||
def set_trashed(self, file_id: str, trashed: bool) -> None:
|
||||
self._check()
|
||||
try:
|
||||
self._service().files().update(fileId=file_id, body={"trashed": bool(trashed)},
|
||||
supportsAllDrives=True).execute()
|
||||
except Exception as exc: # noqa: BLE001
|
||||
raise GoogleDriveError(_friendly_drive(exc)) from None
|
||||
|
||||
|
||||
def _friendly_drive(exc: Exception) -> str:
|
||||
status = getattr(getattr(exc, "resp", None), "status", None)
|
||||
text = str(exc)
|
||||
if "storageQuotaExceeded" in text or "do not have storage quota" in text:
|
||||
return ("서비스 계정은 내 드라이브에 파일을 올릴 수 없습니다 — 업무 파일 폴더를 공유 드라이브에 두거나 "
|
||||
"OAuth 토큰(GOOGLE_SLIDES_OAUTH_REFRESH_TOKEN)을 쓰세요.")
|
||||
if status == 404:
|
||||
return "업무 파일 폴더를 찾을 수 없습니다(PROJECT_DRIVE_FOLDER_ID·폴더 공유 권한 확인)."
|
||||
if status == 403 and "insufficient" not in text.lower():
|
||||
return "Google 드라이브 접근이 거부되었습니다(폴더 편집 권한·Drive API 사용 설정 확인)."
|
||||
return _friendly(exc).replace("Google 슬라이드 처리 실패", "Google 드라이브 처리 실패")
|
||||
|
||||
|
||||
_CLIENT: GoogleDriveFiles | None = None
|
||||
_CLIENT_LOCK = threading.Lock()
|
||||
|
||||
|
||||
def get_client() -> GoogleDriveFiles:
|
||||
"""프로세스당 하나(설정이 비어 있으면 매번 다시 확인 — .env 를 고치고 재시작 없이도 사유가 갱신되게)."""
|
||||
global _CLIENT
|
||||
with _CLIENT_LOCK:
|
||||
if _CLIENT is None or not _CLIENT.enabled:
|
||||
_CLIENT = GoogleDriveFiles()
|
||||
return _CLIENT
|
||||
@@ -42,6 +42,37 @@ def _hex_color(value: str) -> dict[str, float]:
|
||||
}
|
||||
|
||||
|
||||
def a1_sheet(title: str) -> str:
|
||||
"""A1 표기용 시트 이름 — 작은따옴표로 감싸고 안의 ' 는 '' 로."""
|
||||
return "'" + title.replace("'", "''") + "'"
|
||||
|
||||
|
||||
def col_letter(col: int) -> str:
|
||||
"""1-based 열 번호 → 열 문자(A, B, …, AA)."""
|
||||
letters = ""
|
||||
while col > 0:
|
||||
col, rem = divmod(col - 1, 26)
|
||||
letters = chr(65 + rem) + letters
|
||||
return letters
|
||||
|
||||
|
||||
def _repeat_cell(
|
||||
sheet_id: int, r1: int, c1: int, r2: int, c2: int, fmt: dict[str, Any], fields: str
|
||||
) -> dict[str, Any]:
|
||||
"""1-based 양끝 포함 범위에 같은 서식을 입히는 요청."""
|
||||
return {
|
||||
"repeatCell": {
|
||||
"range": {
|
||||
"sheetId": sheet_id,
|
||||
"startRowIndex": r1 - 1, "endRowIndex": r2,
|
||||
"startColumnIndex": c1 - 1, "endColumnIndex": c2,
|
||||
},
|
||||
"cell": {"userEnteredFormat": fmt},
|
||||
"fields": fields,
|
||||
}
|
||||
}
|
||||
|
||||
|
||||
# 웹 핸들러가 sync def(스레드풀)라 여러 요청이 동시에 이 writer 를 쓸 수 있다.
|
||||
# googleapiclient 의 HTTP 클라이언트(httplib2)는 스레드 안전하지 않고, 같은 날짜
|
||||
# 시트를 동시에 지우고/쓰면 내용이 섞이므로 시트 작업은 한 번에 하나씩만 한다.
|
||||
@@ -169,6 +200,144 @@ class GoogleSheetsWriter:
|
||||
).execute()
|
||||
return int(res["replies"][0]["addSheet"]["properties"]["sheetId"])
|
||||
|
||||
@property
|
||||
def lock(self) -> Any:
|
||||
"""읽고 → 쓰기를 한 덩어리로 묶을 때 쓰는 잠금(같은 시트에 동시에 덧붙이지 않게).
|
||||
|
||||
RLock 이라 잡은 채로 이 writer 의 다른 메서드를 불러도 된다."""
|
||||
return _LOCK
|
||||
|
||||
@_serialized
|
||||
def sheet_titles(self, *, spreadsheet_id: str) -> list[str]:
|
||||
"""문서의 시트 이름 목록(탭 순서)."""
|
||||
if not self.enabled:
|
||||
raise RuntimeError(self.reason or "Google Sheets 미설정")
|
||||
meta = self._service.spreadsheets().get(
|
||||
spreadsheetId=spreadsheet_id, fields="sheets.properties.title"
|
||||
).execute()
|
||||
return [str(sh.get("properties", {}).get("title") or "") for sh in meta.get("sheets", [])]
|
||||
|
||||
@_serialized
|
||||
def read_ranges(
|
||||
self, *, spreadsheet_id: str, ranges: list[str], chunk: int = 50
|
||||
) -> list[list[list[Any]]]:
|
||||
"""A1 범위 여러 개의 값(범위마다 2차원 목록). 요청 하나가 너무 길지 않게 나눠 읽는다."""
|
||||
if not self.enabled:
|
||||
raise RuntimeError(self.reason or "Google Sheets 미설정")
|
||||
out: list[list[list[Any]]] = []
|
||||
for i in range(0, len(ranges), chunk):
|
||||
part = ranges[i:i + chunk]
|
||||
res = self._service.spreadsheets().values().batchGet(
|
||||
spreadsheetId=spreadsheet_id, ranges=part
|
||||
).execute()
|
||||
got = res.get("valueRanges", [])
|
||||
out.extend(vr.get("values", []) for vr in got)
|
||||
out.extend([] for _ in range(len(part) - len(got)))
|
||||
return out
|
||||
|
||||
@_serialized
|
||||
def append_block(
|
||||
self,
|
||||
*,
|
||||
spreadsheet_id: str,
|
||||
title: str,
|
||||
cells: dict[tuple[int, int], Any],
|
||||
merges: list[tuple[int, int, int, int]],
|
||||
first_row: int,
|
||||
last_row: int,
|
||||
first_col: int,
|
||||
last_col: int,
|
||||
left_cols: tuple[int, ...] = (9,),
|
||||
highlight: str = "",
|
||||
) -> dict[str, Any]:
|
||||
"""이미 있는 시트의 first_row~last_row 에 표 한 덩어리를 쓴다(위쪽 내용은 그대로).
|
||||
|
||||
서식은 write_table 의 데이터 행과 같다 — 가운데 정렬·줄바꿈·테두리, left_cols 만 왼쪽 정렬,
|
||||
highlight("RRGGBB")가 있으면 그 덩어리 배경색. 좌표는 1-based."""
|
||||
if not self.enabled:
|
||||
raise RuntimeError(self.reason or "Google Sheets 미설정")
|
||||
|
||||
meta = self._service.spreadsheets().get(
|
||||
spreadsheetId=spreadsheet_id,
|
||||
fields="sheets.properties(sheetId,title,gridProperties.rowCount)",
|
||||
).execute()
|
||||
props = next(
|
||||
(sh.get("properties", {}) for sh in meta.get("sheets", [])
|
||||
if sh.get("properties", {}).get("title") == title),
|
||||
None,
|
||||
)
|
||||
if props is None:
|
||||
raise LookupError(f"시트를 찾을 수 없습니다: {title}")
|
||||
sheet_id = int(props.get("sheetId"))
|
||||
row_count = int(props.get("gridProperties", {}).get("rowCount") or 0)
|
||||
|
||||
requests: list[dict[str, Any]] = []
|
||||
if row_count < last_row:
|
||||
# 격자보다 아래에는 값을 쓸 수 없으므로 행을 먼저 늘린다
|
||||
requests.append({"appendDimension": {
|
||||
"sheetId": sheet_id, "dimension": "ROWS", "length": last_row - row_count,
|
||||
}})
|
||||
for (r1, c1, r2, c2) in merges:
|
||||
requests.append({
|
||||
"mergeCells": {
|
||||
"mergeType": "MERGE_ALL",
|
||||
"range": {
|
||||
"sheetId": sheet_id,
|
||||
"startRowIndex": r1 - 1, "endRowIndex": r2,
|
||||
"startColumnIndex": c1 - 1, "endColumnIndex": c2,
|
||||
},
|
||||
}
|
||||
})
|
||||
requests.append(_repeat_cell(
|
||||
sheet_id, first_row, first_col, last_row, last_col,
|
||||
{"horizontalAlignment": "CENTER", "verticalAlignment": "MIDDLE", "wrapStrategy": "WRAP"},
|
||||
"userEnteredFormat(horizontalAlignment,verticalAlignment,wrapStrategy)",
|
||||
))
|
||||
for col in left_cols:
|
||||
requests.append(_repeat_cell(
|
||||
sheet_id, first_row, col, last_row, col,
|
||||
{"horizontalAlignment": "LEFT"}, "userEnteredFormat(horizontalAlignment)",
|
||||
))
|
||||
if highlight:
|
||||
requests.append(_repeat_cell(
|
||||
sheet_id, first_row, first_col, last_row, last_col,
|
||||
{"backgroundColor": _hex_color(highlight)}, "userEnteredFormat(backgroundColor)",
|
||||
))
|
||||
border = {"style": "SOLID", "color": {"red": 0, "green": 0, "blue": 0}}
|
||||
requests.append({
|
||||
"updateBorders": {
|
||||
"range": {
|
||||
"sheetId": sheet_id,
|
||||
"startRowIndex": first_row - 1, "endRowIndex": last_row,
|
||||
"startColumnIndex": first_col - 1, "endColumnIndex": last_col,
|
||||
},
|
||||
"top": border, "bottom": border, "left": border, "right": border,
|
||||
"innerHorizontal": border, "innerVertical": border,
|
||||
}
|
||||
})
|
||||
self._service.spreadsheets().batchUpdate(
|
||||
spreadsheetId=spreadsheet_id, body={"requests": requests}
|
||||
).execute()
|
||||
|
||||
matrix = [
|
||||
[cells.get((r, c), "") for c in range(first_col, last_col + 1)]
|
||||
for r in range(first_row, last_row + 1)
|
||||
]
|
||||
self._service.spreadsheets().values().update(
|
||||
spreadsheetId=spreadsheet_id,
|
||||
range=f"{a1_sheet(title)}!{col_letter(first_col)}{first_row}",
|
||||
valueInputOption="USER_ENTERED",
|
||||
body={"values": matrix},
|
||||
).execute()
|
||||
|
||||
return {
|
||||
"created": False,
|
||||
"title": title,
|
||||
"first_row": first_row,
|
||||
"last_row": last_row,
|
||||
"url": f"https://docs.google.com/spreadsheets/d/{spreadsheet_id}/edit#gid={sheet_id}",
|
||||
}
|
||||
|
||||
@_serialized
|
||||
def delete_sheet(self, *, spreadsheet_id: str, title: str) -> dict[str, Any]:
|
||||
"""이름이 정확히 일치하는 시트 1장을 삭제한다.
|
||||
@@ -263,17 +432,7 @@ class GoogleSheetsWriter:
|
||||
})
|
||||
|
||||
def _fmt(r1: int, c1: int, r2: int, c2: int, fmt: dict[str, Any], fields: str) -> dict[str, Any]:
|
||||
return {
|
||||
"repeatCell": {
|
||||
"range": {
|
||||
"sheetId": sheet_id,
|
||||
"startRowIndex": r1 - 1, "endRowIndex": r2,
|
||||
"startColumnIndex": c1 - 1, "endColumnIndex": c2,
|
||||
},
|
||||
"cell": {"userEnteredFormat": fmt},
|
||||
"fields": fields,
|
||||
}
|
||||
}
|
||||
return _repeat_cell(sheet_id, r1, c1, r2, c2, fmt, fields)
|
||||
|
||||
requests.append(_fmt(
|
||||
title_row, first_col, title_row, last_col,
|
||||
|
||||
@@ -44,9 +44,12 @@ def send_email(
|
||||
body: str,
|
||||
html: str | None = None,
|
||||
from_name: str = "DBX ERP",
|
||||
reply_to: str = "",
|
||||
) -> bool:
|
||||
"""단순 텍스트(+선택 HTML) 메일 1건 발송.
|
||||
|
||||
reply_to — 받는 사람이 [답장]하면 갈 주소(예: 휴가 메일 = 처리한 사람, 2026-10-27). 보내는 주소는 늘 SMTP_FROM.
|
||||
|
||||
반환: 성공 True / 비활성·실패 False. 예외를 밖으로 던지지 않는다.
|
||||
"""
|
||||
host = _env("SMTP_HOST")
|
||||
@@ -71,6 +74,8 @@ def send_email(
|
||||
msg["Subject"] = subject
|
||||
msg["From"] = formataddr((from_name, sender))
|
||||
msg["To"] = ", ".join(recipients)
|
||||
if reply_to and "@" in reply_to:
|
||||
msg["Reply-To"] = formataddr((from_name, reply_to.strip()))
|
||||
msg.set_content(body)
|
||||
if html:
|
||||
msg.add_alternative(html, subtype="html")
|
||||
|
||||
+94
-1
@@ -2,7 +2,7 @@ import inspect
|
||||
import os
|
||||
from contextlib import asynccontextmanager
|
||||
from pathlib import Path
|
||||
from typing import Any
|
||||
from typing import Any, Literal
|
||||
|
||||
from authlib.integrations.starlette_client import OAuth, OAuthError
|
||||
from dotenv import load_dotenv
|
||||
@@ -24,10 +24,16 @@ from .modules.dispatch import build_dispatch_store
|
||||
from .modules.dispatch import router as dispatch_router
|
||||
from .modules.expense import CategoryStore, build_expense_store
|
||||
from .modules.expense import router as expense_router
|
||||
from .modules.inout import build_inout_items, build_inout_store
|
||||
from .modules.inout import router as inout_router
|
||||
from .modules.live import build_live_store
|
||||
from .modules.live import router as live_router
|
||||
from .modules.malaysia import build_malaysia_itemcode, build_malaysia_store
|
||||
from .modules.malaysia import router as malaysia_router
|
||||
from .modules.notice import build_notice_store
|
||||
from .modules.notice import router as notice_router
|
||||
from .modules.outreach import build_outreach_store
|
||||
from .modules.outreach import router as outreach_router
|
||||
from .modules.performance import build_performance_store
|
||||
from .modules.performance import router as performance_router
|
||||
from .modules.project import build_project_store
|
||||
@@ -59,6 +65,11 @@ MODULE_LABELS: dict[str, str] = {
|
||||
"cafe24": "카페24 상품관리",
|
||||
"performance": "실적",
|
||||
"asset": "자산관리",
|
||||
"inout": "입출고 관리",
|
||||
"outreach": "안내문 발송",
|
||||
"live": "라이브 커머스",
|
||||
"live_host": "라이브 호스트 등록",
|
||||
"live_host_edit": "라이브 호스트 수정",
|
||||
"expense_approver": "개인경비",
|
||||
"vacation_approver": "휴가",
|
||||
}
|
||||
@@ -153,6 +164,9 @@ _MODULE_TEMPLATE_DIRS = [
|
||||
BASE_DIR / "modules" / "performance" / "templates",
|
||||
BASE_DIR / "modules" / "asset" / "templates",
|
||||
BASE_DIR / "modules" / "notice" / "templates",
|
||||
BASE_DIR / "modules" / "inout" / "templates",
|
||||
BASE_DIR / "modules" / "outreach" / "templates",
|
||||
BASE_DIR / "modules" / "live" / "templates",
|
||||
]
|
||||
templates = Jinja2Templates(directory=str(BASE_DIR / "templates"))
|
||||
templates.env.loader = ChoiceLoader(
|
||||
@@ -218,6 +232,15 @@ app.state.performance_store = build_performance_store(dsn=env("PERFORMANCE_DB_UR
|
||||
app.state.asset_store = build_asset_store(dsn=env("ASSET_DB_URL") or None)
|
||||
# 긴급 공지(ERP 전체 화면 가운데): project_db 024 — 프로젝트 저장소의 연결 풀을 같이 쓴다(없으면 None → 503).
|
||||
app.state.notice_store = build_notice_store(app.state.project_store)
|
||||
# 입출고 관리(본사 → 공장 발주, 물류 입고, 미입고): INOUT_DB_URL 없으면 store=None(라우터가 "설정 필요" 안내).
|
||||
# 제품은 itemcode_db 단품(single_items) 읽기 전용 — ITEMCODE_DB_URL 재사용.
|
||||
app.state.inout_store = build_inout_store(dsn=env("INOUT_DB_URL") or None)
|
||||
app.state.inout_items = build_inout_items()
|
||||
# 안내문 발송(메일 일괄·인스타 DM 반자동): OUTREACH_DB_URL 없으면 store=None(화면이 "설정 필요" 안내).
|
||||
# 메일은 보내는 사람 본인 Gmail — 입출고 Gmail 연결(inout_store.inout_gmail_tokens)을 같이 쓴다.
|
||||
app.state.outreach_store = build_outreach_store(dsn=env("OUTREACH_DB_URL") or None)
|
||||
# 라이브 커머스(말레이시아 방송 호스트·스케줄): LIVE_DB_URL 없으면 store=None(화면이 "설정 필요" 안내).
|
||||
app.state.live_store = build_live_store(dsn=env("LIVE_DB_URL") or None)
|
||||
|
||||
# 모듈 라우터 등록 — 신규 모듈 추가 시 여기 한 줄.
|
||||
app.include_router(expense_router)
|
||||
@@ -230,6 +253,9 @@ app.include_router(cafe24_router)
|
||||
app.include_router(performance_router)
|
||||
app.include_router(asset_router)
|
||||
app.include_router(notice_router)
|
||||
app.include_router(inout_router)
|
||||
app.include_router(outreach_router)
|
||||
app.include_router(live_router)
|
||||
|
||||
|
||||
def public_url_for(request: Request, route_name: str) -> str:
|
||||
@@ -422,6 +448,37 @@ def _menu_items_for(user_rec: dict[str, Any]) -> list[dict[str, Any]]:
|
||||
"status": "ready",
|
||||
"category": "관리",
|
||||
},
|
||||
{
|
||||
"key": "inout",
|
||||
"title": "입출고 관리",
|
||||
"subtitle": "Inbound",
|
||||
"description": "본사에서 공장으로 넣은 제작 발주와 물류 입고 수량을 맞춰 보고, 미입고·초과 입고를 관리합니다.",
|
||||
"url": "/inout/",
|
||||
"health_url": "/inout/health",
|
||||
"status": "ready",
|
||||
"category": "운영",
|
||||
},
|
||||
{
|
||||
"key": "outreach",
|
||||
"title": "안내문 발송",
|
||||
"subtitle": "Outreach",
|
||||
"description": "이메일·인스타그램 리스트에 이름을 넣은 안내문을 메일로 일괄 발송하고 인스타 DM 을 보냅니다.",
|
||||
"url": "/outreach/",
|
||||
"health_url": "/outreach/health",
|
||||
"status": "ready",
|
||||
"category": "운영",
|
||||
},
|
||||
{
|
||||
"key": "live",
|
||||
"title": "라이브 커머스",
|
||||
"card_title": "라이브 커머스 · Live Commerce", # 메인 카드만 한글·영문 둘 다(사이드바는 짧게)
|
||||
"subtitle": "Malaysia",
|
||||
"description": "말레이시아 라이브 방송의 호스트 정보와 방송 스케줄·판매금액·결과 이미지를 관리합니다.",
|
||||
"url": "/live/",
|
||||
"health_url": "/live/health",
|
||||
"status": "ready",
|
||||
"category": "운영",
|
||||
},
|
||||
]
|
||||
items.append({
|
||||
"key": "asset", "title": "자산관리", "subtitle": "Asset Management",
|
||||
@@ -437,6 +494,9 @@ def _menu_items_for(user_rec: dict[str, Any]) -> list[dict[str, Any]]:
|
||||
def _icon_svg(name: str) -> str:
|
||||
"""좌측 사이드바용 인라인 아이콘. 외부 의존 없는 작은 SVG."""
|
||||
paths = {
|
||||
"inout": '<path d="M3 7l9-4 9 4v10l-9 4-9-4z"/><path d="M3 7l9 4 9-4"/><path d="M12 11v10"/>',
|
||||
"outreach": '<path d="M22 2 11 13"/><path d="M22 2 15 22l-4-9-9-4z"/>',
|
||||
"live": '<rect x="2" y="6" width="14" height="12" rx="2"/><path d="m16 11 6-4v10l-6-4"/>',
|
||||
"asset": '<rect x="3" y="3" width="18" height="13" rx="2"/><path d="M8 21h8M12 16v5"/><path d="M7 7h10M7 11h6"/>',
|
||||
"home": '<path d="M3 11 12 3l9 8"/><path d="M5 10v10h14V10"/>',
|
||||
"expense": '<rect x="3" y="6" width="18" height="13" rx="2"/><path d="M3 10h18"/><path d="M7 15h4"/>',
|
||||
@@ -652,6 +712,39 @@ async def healthz() -> dict[str, str]:
|
||||
return {"status": "ok"}
|
||||
|
||||
|
||||
@app.get("/api/auth/check")
|
||||
async def external_module_auth(
|
||||
request: Request, module: Literal["corm", "order"]
|
||||
) -> JSONResponse:
|
||||
"""외부 서비스 접근을 ERP의 현재 사용자/권한으로 판단한다.
|
||||
|
||||
세션에 권한을 복제하지 않는다. 삭제·권한 해제는 다음 요청부터 반영된다.
|
||||
호출 서비스는 브라우저의 세션 쿠키만 전달하며 이메일을 지정할 수 없다.
|
||||
"""
|
||||
headers = {"Cache-Control": "no-store", "Vary": "Cookie"}
|
||||
user = get_current_user_record(request)
|
||||
if user is None:
|
||||
return JSONResponse(
|
||||
{"detail": "로그인이 필요합니다."}, status_code=401, headers=headers
|
||||
)
|
||||
if not has_module(user, module):
|
||||
return JSONResponse(
|
||||
{"detail": "모듈 접근 권한이 없습니다."}, status_code=403, headers=headers
|
||||
)
|
||||
return JSONResponse(
|
||||
{
|
||||
"module": module,
|
||||
"user": {
|
||||
"email": user["email"],
|
||||
"name": user.get("name", ""),
|
||||
"role": user.get("role", "user"),
|
||||
"is_super_admin": bool(user.get("is_super_admin")),
|
||||
},
|
||||
},
|
||||
headers=headers,
|
||||
)
|
||||
|
||||
|
||||
# ── 관리자 페이지 ──────────────────────────────────────────────
|
||||
@app.get("/admin", response_class=HTMLResponse)
|
||||
async def admin_page(request: Request) -> HTMLResponse:
|
||||
|
||||
@@ -0,0 +1,9 @@
|
||||
# [자산] 자산관리 모듈 — `app/modules/asset/`, `asset_db`
|
||||
|
||||
> 이 모듈만 고칠 때 읽는 요약. 상세는 `docs/ASSET_MODULE.md`.
|
||||
> 정적 파일: `app/static/asset.css`, `app/static/asset.js`. 템플릿: `templates/`.
|
||||
|
||||
- 진입 `/asset/`, 권한키 `asset`. 사무집기·전산장비 개별 자산번호 등록.
|
||||
- 배정/반납/상태·구매/보증·활동 이력, HWiNFO XML 사양/보고서 보존(`hwinfo.py`), 사진 갤러리(`media.py`), 보고서 모니터 자산(`monitors.py`).
|
||||
- 삭제는 수퍼관리자(`SUPER_ADMIN_EMAIL`)만 — 이력/원본 보존.
|
||||
- `ASSET_DB_URL` 미설정 시 저장 비활성, XML 분석 미리보기는 가능.
|
||||
@@ -0,0 +1,45 @@
|
||||
# [카페24] 카페24 상품관리 모듈 — `app/modules/cafe24/`, `cafe24_db`
|
||||
|
||||
> 이 모듈만 고칠 때 읽는 요약. 상세는 `docs/CAFE24_MODULE.md`(큰 문서 — `grep -n '^#'` 로 목차 보고 필요한 절만 읽기).
|
||||
> 정적 파일: `app/static/cafe24.css`, `cafe24-options.js`. 템플릿: `templates/`. 테스트: `tests/`.
|
||||
> 공통 API 계층: `app/integrations/cafe24/` — **실적 모듈 카페24 어댑터도 같은 토큰을 씀**, 바꾸면 실적 영향 확인.
|
||||
> 배포 시 이 모듈 변경이면 worker 도 같이 재빌드 — compose 서비스명 `cafe24-worker`(컨테이너명 `dbx-cafe24-worker` 아님): `docker compose up -d --build --no-deps web cafe24-worker`.
|
||||
|
||||
## 기능
|
||||
|
||||
- 카페24 관리자에 들어가지 않고 상품 상세페이지(description HTML) 조회·편집·즉시적용·예약적용·버전 이력.
|
||||
- 3분할 화면(목록 | HTML 편집기 | 상품 정보 패널). 목록에 64x64 대표 이미지(`tiny_image`, 없으면 `detail_image`).
|
||||
- HTML 편집기에서 `<img>` 태그에 마우스를 올리면 태그를 오렌지색으로 칠하고 화면 오른쪽에 폭 500px·창 높이로 파일명과 미리보기(상대 경로는 `CAFE24_SHOP_URL` 루트 기준, 색칠 한도 `HL_LIMIT` 초과 소스는 미동작).
|
||||
- HTML 편집기에서 커서가 `<img>` 태그 안 어디에 있든 Ctrl+↑/↓ 로 `src` 파일명(`.jpg`/`.gif`/`.png`) 번호 변경. 없음 → `_2` → `_3` …, 이미 `_숫자` 면 다음 숫자부터. 내릴 때는 원래 번호(없었으면 원래 이름) 아래로 안 감 — 다른 편집이 끼거나 다른 이미지로 옮기면 그때 번호가 새 원래 번호.
|
||||
- 정보 패널(`routes_product_info.py`, `_side.html`)에서 상품명·판매가·공급가·소비자가, 대표이미지, 옵션(생성/이름·썸네일·표시방식 수정/삭제)·품목(자체코드·추가금액·진열·판매) 수정.
|
||||
품목 진열·판매는 `CAFE24_SHOP_NOS`(예 1,2,3)의 모든 멀티쇼핑몰에 같은 값으로 보냄(추가금액 등은 기본몰만).
|
||||
- 대표이미지는 `POST /admin/products/{no}/images` 에 base64 data URI + `image_upload_type=A`.
|
||||
NNEditor 업로드 경로를 PUT `detail_image` 에 넣는 방식은 적용 안 됨.
|
||||
- 옵션/품목 팝업 「판매 가격」 열: 기본 정보 판매가 + 추가금액을 보여주고, 입력하면 추가금액을 역산(`cafe24-options.js` `bindSalePrice`). 저장되는 값은 추가금액뿐.
|
||||
- 옵션/품목 팝업 옵션값 이름·자체 품목코드·추가금액·판매 가격 칸: Enter·↓ 아래 행, ↑ 위 행 같은 열로 이동(한글 조합 중에는 이동 안 함).
|
||||
- 옵션/품목 팝업(단일 옵션 화면) 「모바일 스와이프 복사(코드)」: `// 상품명` + `"품목코드": "/web/…썸네일 경로",` 줄들을 클립보드로
|
||||
(`cafe24-options.js` `swipeCode` — 행에 지금 보이는 썸네일 기준, 도메인/CDN 은 떼고 `/web/` 부터).
|
||||
「모바일 스와이프 복사(이름)」은 키가 품목코드 대신 옵션값 이름(`swipeCode(tbody, true)`, 품목코드 있는 행만).
|
||||
- 예약(편집기 아래 「예약 적용」): 대표 이미지(썸네일) · 상세페이지 · 진열 · 판매를 지정 시각에. 대표 이미지 파일은 `cafe24_schedule_images`(마이그레이션 006)에 보관, worker 가 이미지 먼저 교체.
|
||||
- 권한키 `cafe24`(연결/해제는 admin 전용).
|
||||
|
||||
## 규칙
|
||||
|
||||
- **카페24 PUT options 는 옵션값 추가를 오류 없이 무시한다** — 기존 옵션에 행 추가는 「옵션 재생성」(DELETE → POST, 품목코드 새로 부여)으로만. 저장 버튼이 새 행을 보면 재생성 확인창으로 넘긴다.
|
||||
|
||||
- 카페24 OAuth/API 클라이언트는 향후 주문관리와 공유하기 위해 **공통 계층 `app/integrations/cafe24/`** 에 둔다 — 라우터에서 `httpx`/`requests` 직접 호출 금지.
|
||||
- 토큰은 Fernet 암호화 저장(`CAFE24_TOKEN_SECRET`), 로그/화면에 토큰·시크릿 절대 미출력.
|
||||
- 쓰기 직전 항상 카페24 현재 HTML 을 다시 읽어 `BACKUP` revision 생성(로컬 값을 현재값으로 가정 금지).
|
||||
- 디자인 FTP(스와이프·상품상세) 쓰기는 임시 파일 → 검증 → rename. **카페24 FTP 는 허용 확장자만 받으므로 임시 이름도 원래 확장자로 끝나야 함**(`x_cf24tmp_<tag>.js`, `design_ftp.temp_names`). `x.js.cf24tmp-…` 는 `550 Operation not permitted`.
|
||||
- 예약은 DB 저장 + 별도 worker(`worker.py`, compose 서비스 `cafe24-worker`, 컨테이너 `dbx-cafe24-worker`)가 처리 — 웹 프로세스에서 대기하지 않는다.
|
||||
|
||||
## 읽기 지연 ("마지막 쓰기가 권위")
|
||||
|
||||
- **카페24 관리자 API 는 PUT 뒤 한동안 GET 에서 예전 값을 돌려준다(읽기 지연)** — 우리 캐시 문제가 아니다.
|
||||
- 상세설명: 카페24 값이 최근 revision 중 하나와 같으면 지연으로 보고 마지막 MANUAL/SCHEDULED 를 표시·지문 기준으로 씀(`store.resolve_description`).
|
||||
- 스칼라(상품명·가격·이미지·진열/판매): PUT 응답 스냅샷(`cafe24_products.last_write_snapshot`, 마이그레이션 004)과 GET 의 `updated_date` 를 비교해 덮어씌움(`store.overlay_recent_write`).
|
||||
- 진열/판매만 바꾼 PUT 은 `updated_date` 가 안 오를 수 있음 → **같은 시각 + 값 다름 = 지연**.
|
||||
- 단건 GET 뿐 아니라 **목록·예약 미리보기도 보정** 필수(`store.overlay_product_rows`). 빠뜨리면 "진열/중지 바꿔도 반영 안 됨"으로 보임.
|
||||
- 유예시간 `CAFE24_READ_LAG_GRACE_MIN`(기본 360분).
|
||||
- 쓰기 후 화면은 PUT 응답으로 그리고 다시 GET 하지 않는다.
|
||||
- API 문서 예제는 apidocs.cafe24.com 청크 JS 에서 추출(예전 `/docs/code` JSON 은 404).
|
||||
@@ -42,6 +42,15 @@ def read_lag_grace_minutes() -> int:
|
||||
return store.parse_grace_minutes(os.getenv("CAFE24_READ_LAG_GRACE_MIN"))
|
||||
|
||||
|
||||
def shop_nos() -> list[int]:
|
||||
"""품목 진열·판매를 함께 맞출 멀티쇼핑몰 번호. `CAFE24_SHOP_NOS`(예: 1,2,3), 기본 [1]."""
|
||||
import os # noqa: WPS433
|
||||
|
||||
from . import store # noqa: WPS433
|
||||
|
||||
return store.parse_shop_nos(os.getenv("CAFE24_SHOP_NOS"))
|
||||
|
||||
|
||||
def require_user(request: Request) -> dict[str, Any]:
|
||||
from app.main import get_current_user_record # noqa: WPS433
|
||||
from app.store import has_module # noqa: WPS433
|
||||
@@ -96,11 +105,11 @@ def guard(request: Request):
|
||||
반환이 tuple 이면 (store, user), 아니면 그대로 응답으로 돌려준다.
|
||||
"""
|
||||
from app.main import get_current_user_record, render_template # noqa: WPS433
|
||||
from app.store import has_module, is_admin # noqa: WPS433
|
||||
from app.store import has_module, is_admin, login_redirect # noqa: WPS433
|
||||
|
||||
user = get_current_user_record(request)
|
||||
if user is None:
|
||||
return RedirectResponse(url="/login", status_code=303)
|
||||
return login_redirect(request)
|
||||
if not has_module(user, MODULE_KEY):
|
||||
return render_template(
|
||||
request,
|
||||
|
||||
+52
-17
@@ -663,6 +663,27 @@ class Cafe24Store:
|
||||
return {}
|
||||
return dict(row["last_write_snapshot"])
|
||||
|
||||
def get_recent_product_snapshots(self, grace_minutes: int) -> dict[int, dict[str, Any]]:
|
||||
"""유예시간 안에 쓴 상품들의 product 스냅샷 섹션 {product_no: {"data", "written_at"}}.
|
||||
|
||||
목록 화면이 상품마다 따로 조회하지 않고 한 번에 지연 보정하기 위한 것이다.
|
||||
섹션별 written_at 판정은 store.overlay_recent_write 가 다시 한다.
|
||||
"""
|
||||
with self._pool.connection() as conn:
|
||||
rows = conn.execute(
|
||||
"""
|
||||
SELECT product_no, last_write_snapshot -> 'product' AS product
|
||||
FROM cafe24_products
|
||||
WHERE last_written_at >= now() - make_interval(mins => %s)
|
||||
AND last_write_snapshot ? 'product'
|
||||
""",
|
||||
(max(0, int(grace_minutes)),),
|
||||
).fetchall()
|
||||
return {
|
||||
int(r["product_no"]): dict(r["product"])
|
||||
for r in rows if isinstance(r.get("product"), dict)
|
||||
}
|
||||
|
||||
# ════════════════════════════════════════════════════════════
|
||||
# 상세페이지 HTML 버전 (append-only — UPDATE/DELETE 하지 않는다)
|
||||
# 쓰기 직전 BACKUP 을 남기는 것이 유일한 복구 수단이다.
|
||||
@@ -798,27 +819,41 @@ class Cafe24Store:
|
||||
set_selling: bool | None,
|
||||
memo: str = "",
|
||||
created_by: str = "",
|
||||
image: bytes | None = None,
|
||||
image_type: str = "",
|
||||
image_name: str = "",
|
||||
) -> int:
|
||||
"""예약 등록. image 가 있으면 파일을 cafe24_schedule_images 에 같은 트랜잭션으로 남긴다(006).
|
||||
|
||||
이미지 없는 예약은 006 컬럼을 쓰지 않는다 — 마이그레이션 전에도 기존 예약 등록이 깨지지 않게.
|
||||
"""
|
||||
cols = ["product_no", "scheduled_at", "revision_id", "set_display", "set_selling", "memo", "created_by"]
|
||||
vals: list[Any] = [int(product_no), scheduled_at, revision_id, set_display, set_selling,
|
||||
(memo or "")[:500], created_by or ""]
|
||||
if image:
|
||||
cols += ["image_type", "image_name"]
|
||||
vals += [image_type, (image_name or "")[:200]]
|
||||
with self._pool.connection() as conn:
|
||||
with conn.transaction():
|
||||
row = conn.execute(
|
||||
f"INSERT INTO cafe24_product_schedules ({', '.join(cols)}) " # noqa: S608 — 고정 컬럼명만
|
||||
f"VALUES ({', '.join(['%s'] * len(cols))}) RETURNING id",
|
||||
vals,
|
||||
).fetchone()
|
||||
if row and image:
|
||||
conn.execute(
|
||||
"INSERT INTO cafe24_schedule_images (schedule_id, data) VALUES (%s, %s)",
|
||||
(row["id"], image),
|
||||
)
|
||||
return int(row["id"]) if row else 0
|
||||
|
||||
def get_schedule_image(self, schedule_id: int) -> bytes:
|
||||
"""예약 대표 이미지 파일. 없으면 b""."""
|
||||
with self._pool.connection() as conn:
|
||||
row = conn.execute(
|
||||
"""
|
||||
INSERT INTO cafe24_product_schedules
|
||||
(product_no, scheduled_at, revision_id, set_display, set_selling,
|
||||
memo, created_by)
|
||||
VALUES (%s,%s,%s,%s,%s,%s,%s)
|
||||
RETURNING id
|
||||
""",
|
||||
(
|
||||
int(product_no),
|
||||
scheduled_at,
|
||||
revision_id,
|
||||
set_display,
|
||||
set_selling,
|
||||
(memo or "")[:500],
|
||||
created_by or "",
|
||||
),
|
||||
"SELECT data FROM cafe24_schedule_images WHERE schedule_id = %s", (int(schedule_id),)
|
||||
).fetchone()
|
||||
return int(row["id"]) if row else 0
|
||||
return bytes(row["data"]) if row else b""
|
||||
|
||||
def list_schedules(self, *, limit: int = 200) -> list[dict[str, Any]]:
|
||||
"""예약 목록. 대기 중인 것을 먼저, 그다음 최근 처리 순."""
|
||||
|
||||
@@ -37,7 +37,7 @@ from app.integrations.cafe24 import Cafe24Error, build_cafe24_api, products
|
||||
from app.timezone import now_kst
|
||||
|
||||
from . import store, writes
|
||||
from .common import read_lag_grace_minutes, require_store
|
||||
from .common import read_lag_grace_minutes, require_store, shop_nos
|
||||
from .routes_products import load_product, locked_json, remember_write
|
||||
|
||||
logger = logging.getLogger("cafe24.product_info")
|
||||
@@ -482,19 +482,11 @@ def options_update(
|
||||
try:
|
||||
body = store.build_update_options_request(
|
||||
original, edited, option_list_type=str(payload.get("option_list_type") or ""),
|
||||
allow_append=True,
|
||||
)
|
||||
except ValueError as exc:
|
||||
raise HTTPException(status_code=400, detail=str(exc)) from exc
|
||||
if loaded["option"]["option_preset_code"]:
|
||||
body["option_preset_code"] = loaded["option"]["option_preset_code"]
|
||||
# 뒤에 덧붙인 옵션값 — 카페24가 받아들이면 품목을 자동 생성한다(재시도 조회).
|
||||
added_texts = [
|
||||
v["option_text"]
|
||||
for o, n in zip(body["original_options"], body["options"])
|
||||
for v in n["option_value"][len(o["option_value"]):]
|
||||
]
|
||||
added = len(added_texts)
|
||||
|
||||
try:
|
||||
updated = products.update_options(api.client, product_no, body)
|
||||
@@ -508,7 +500,7 @@ def options_update(
|
||||
record_error = _save_snapshot_safe(
|
||||
st, product_no, "options",
|
||||
_options_snapshot(updated, befores=[loaded["raw_option"], loaded["effective_option"]],
|
||||
osec=loaded["options_section"], recent=added_texts),
|
||||
osec=loaded["options_section"], recent=[]),
|
||||
)
|
||||
# 이름 바꾸기 표(수정 전 → 수정 후) — 위치로 짝지어진다(build_update_options_request).
|
||||
rename: dict[tuple[str, str], tuple[str, str]] = {}
|
||||
@@ -541,29 +533,15 @@ def options_update(
|
||||
summary = "; ".join(
|
||||
f"{o['option_name']}: " + ", ".join(v["option_text"] for v in o["option_value"])
|
||||
for o in body["options"]
|
||||
) + (f" (+{added} 추가)" if added else "")
|
||||
|
||||
fresh: list[dict[str, Any]] | None = None
|
||||
if added:
|
||||
# 새 옵션값의 품목코드를 받아 돌려준다 — 화면이 자체코드/추가금액을 이어서 PUT 한다.
|
||||
# 늦게 나타나는 품목은 pending 으로 표시된다(_annotate).
|
||||
_osec, vsec = _snapshot_sections(st, product_no)
|
||||
fresh = _patch_variants(
|
||||
vsec, products.wait_for_variants(api.client, product_no, len(loaded["raw_variants"]) + added)
|
||||
)
|
||||
)
|
||||
writes.audit_safe(st, actor=actor, action="update_options", product_no=product_no,
|
||||
result="SUCCESS", detail=summary[:900])
|
||||
logger.info("카페24 상품 %s 옵션 수정 (%s)", product_no, actor)
|
||||
|
||||
shown_option, shown_variants = _annotate(
|
||||
updated, fresh if fresh is not None else renamed_variants, added_texts
|
||||
)
|
||||
out: dict[str, Any] = {"ok": True, "option": _options_view(shown_option),
|
||||
"variants": [_variant_view(v) for v in shown_variants],
|
||||
"record_warning": record_error}
|
||||
if added:
|
||||
out["added"] = added
|
||||
return out
|
||||
shown_option, shown_variants = _annotate(updated, renamed_variants, [])
|
||||
return {"ok": True, "option": _options_view(shown_option),
|
||||
"variants": [_variant_view(v) for v in shown_variants],
|
||||
"record_warning": record_error}
|
||||
|
||||
|
||||
@product_info_router.delete("/products/{product_no}/options")
|
||||
@@ -658,6 +636,7 @@ def variants_update(
|
||||
"failed": {code: 사유}, "unknown": {code: 사유}}
|
||||
100건 묶음 중 일부가 실패해도 성공한 행은 성공으로 기록·표시한다(화면이 그 행을
|
||||
다시 보내지 않게). 하나도 반영되지 않았으면 502.
|
||||
진열·판매는 `CAFE24_SHOP_NOS` 의 다른 쇼핑몰에도 같은 값으로 보낸다 — 실패는 "shop_failed".
|
||||
"""
|
||||
st, user = require_store(request)
|
||||
actor = str(user.get("email") or "")
|
||||
@@ -695,9 +674,26 @@ def variants_update(
|
||||
failed[code] = result["error"]
|
||||
record_error = _save_snapshot_safe(st, product_no, "variants", by_code) if by_code else ""
|
||||
|
||||
# 멀티쇼핑몰: 진열·판매는 쇼핑몰마다 따로라 기본몰(1)에 반영된 행의 진열·판매만
|
||||
# 다른 쇼핑몰에도 똑같이 보낸다. 추가금액(통화가 다름)·자체코드·순서는 보내지 않는다.
|
||||
flags = [
|
||||
{"variant_code": code, **{k: sent[code][k] for k in ("display", "selling") if k in sent[code]}}
|
||||
for code in by_code if {"display", "selling"} & set(sent.get(code) or {})
|
||||
]
|
||||
shop_failed: dict[str, str] = {}
|
||||
for shop in (shop_nos()[1:] if flags else []):
|
||||
bad = [r for r in products.update_variants(api.client, product_no, flags, shop_no=shop)
|
||||
if r["status"] != products.VARIANT_OK]
|
||||
if bad:
|
||||
shop_failed[str(shop)] = f"{len(bad)}건 — {bad[0]['error']}"
|
||||
|
||||
detail = "; ".join(
|
||||
f"{code}: " + ", ".join(f"{k}={v}" for k, v in patch.items()) for code, patch in by_code.items()
|
||||
)
|
||||
if flags and len(shop_nos()) > 1:
|
||||
detail = f"[진열·판매 쇼핑몰 {','.join(map(str, shop_nos()))}] " + detail
|
||||
if shop_failed:
|
||||
detail += " / 다른 쇼핑몰 실패: " + "; ".join(f"{s}번 {e}" for s, e in shop_failed.items())
|
||||
if failed or unknown:
|
||||
detail = (f"성공 {len(by_code)} / 실패 {len(failed)} / 결과 모름 {len(unknown)} — " + detail)
|
||||
first = next(iter({**failed, **unknown}.values()), "")
|
||||
@@ -718,5 +714,6 @@ def variants_update(
|
||||
"updated": {code: _variant_view({"variant_code": code, **patch}) for code, patch in by_code.items()},
|
||||
"failed": failed,
|
||||
"unknown": unknown,
|
||||
"shop_failed": shop_failed,
|
||||
"record_warning": record_error,
|
||||
}
|
||||
|
||||
@@ -133,10 +133,11 @@ def _iso(value: Any) -> str:
|
||||
|
||||
|
||||
def _row_for_list(raw: dict[str, Any]) -> dict[str, Any]:
|
||||
"""왼쪽 목록에 쓸 필드만 — 상품번호·상품명·진열·판매·최근수정."""
|
||||
"""왼쪽 목록에 쓸 필드만 — 상품번호·대표 이미지·상품명·진열·판매·최근수정."""
|
||||
normalized = products.normalize_product(raw)
|
||||
return {
|
||||
"product_no": normalized["product_no"],
|
||||
"thumb": str(raw.get("tiny_image") or raw.get("detail_image") or ""),
|
||||
"product_name": normalized["product_name"],
|
||||
"display": normalized["display"],
|
||||
"selling": normalized["selling"],
|
||||
@@ -328,6 +329,13 @@ def product_list(request: Request) -> HTMLResponse:
|
||||
error = ""
|
||||
try:
|
||||
raw_rows, truncated = products.list_all_products(api.client, product_name=keyword)
|
||||
# 목록 API 도 쓰기 직후 한동안 예전 값을 준다 — 진열/판매 등을 최근 쓰기로 보정한다.
|
||||
try:
|
||||
snapshots = st.get_recent_product_snapshots(read_lag_grace_minutes())
|
||||
except Exception: # noqa: BLE001 — 보정 실패는 목록 표시를 막지 않는다
|
||||
logger.exception("카페24 최근 쓰기 스냅샷 조회 실패")
|
||||
snapshots = {}
|
||||
raw_rows = store.overlay_product_rows(raw_rows, snapshots, grace_minutes=read_lag_grace_minutes())
|
||||
st.upsert_products([products.normalize_product(r) for r in raw_rows])
|
||||
total = len(raw_rows)
|
||||
rows = [_row_for_list(r) for r in raw_rows]
|
||||
|
||||
@@ -1,8 +1,9 @@
|
||||
"""카페24 예약관리 — 지정 시각에 상세페이지·진열/판매를 자동 적용.
|
||||
"""카페24 예약관리 — 지정 시각에 대표 이미지·상세페이지·진열/판매를 자동 적용.
|
||||
|
||||
되돌리기(자동 복원)는 쓰지 않는다. 예약은 "그 시각에 이 내용을 적용" 하나뿐이다.
|
||||
한 예약에서 세 가지를 각각 고를 수 있다.
|
||||
한 예약에서 네 가지를 각각 고를 수 있다.
|
||||
|
||||
대표 이미지 고른 파일로 그 시각에 교체 (파일은 DB 보관 — 마이그레이션 006)
|
||||
상세페이지 HTML 편집기에 있는 내용을 그 시각에 적용 (안 고르면 HTML 은 그대로)
|
||||
진열 진열 / 미진열 / 변경 없음
|
||||
판매 판매 / 중지 / 변경 없음
|
||||
@@ -19,14 +20,15 @@ from __future__ import annotations
|
||||
|
||||
import logging
|
||||
|
||||
from fastapi import APIRouter, Form, Request
|
||||
from fastapi.responses import HTMLResponse, RedirectResponse
|
||||
from fastapi import APIRouter, File, Form, HTTPException, Request, UploadFile
|
||||
from fastapi.responses import HTMLResponse, RedirectResponse, Response
|
||||
|
||||
from app.integrations.cafe24 import Cafe24Error, build_cafe24_api, load_config, products
|
||||
|
||||
from . import store, writes
|
||||
from .common import base_ctx, guard
|
||||
from .routes_products import _no_store
|
||||
from .routes_product_info import _read_image
|
||||
from .routes_products import _no_store, load_product
|
||||
|
||||
logger = logging.getLogger("cafe24.schedules")
|
||||
|
||||
@@ -53,6 +55,7 @@ def schedules_page(request: Request) -> HTMLResponse:
|
||||
has_html=bool(row.get("has_html")),
|
||||
set_display=row.get("set_display"),
|
||||
set_selling=row.get("set_selling"),
|
||||
has_image=bool(row.get("image_type")),
|
||||
),
|
||||
"editable": store.is_editable(row.get("status") or ""),
|
||||
"needs_review": row.get("status") == store.STATUS_NEEDS_REVIEW,
|
||||
@@ -63,7 +66,7 @@ def schedules_page(request: Request) -> HTMLResponse:
|
||||
ctx.update(
|
||||
{
|
||||
"page_title": "카페24 — 예약관리",
|
||||
"page_subtitle": "지정 시각에 상세페이지·진열/판매 자동 적용",
|
||||
"page_subtitle": "지정 시각에 대표 이미지·상세페이지·진열/판매 자동 적용",
|
||||
"rows": rows,
|
||||
"pending": sum(1 for r in rows if r["status"] == store.STATUS_PENDING),
|
||||
"review": sum(1 for r in rows if r["needs_review"]),
|
||||
@@ -85,12 +88,14 @@ def schedule_create(
|
||||
set_selling: str = Form(""),
|
||||
memo: str = Form(""),
|
||||
list_query: str = Form(""),
|
||||
image: UploadFile | None = File(None),
|
||||
):
|
||||
"""편집기에서 예약을 등록한다.
|
||||
|
||||
HTML 을 적용하는 예약이면 지금 편집기 내용을 DRAFT revision 으로 저장해 고정한다.
|
||||
단건 적용과 같은 다듬기(URL 인코딩 → 소스 정리)를 거치므로, 예약이 실행됐을 때
|
||||
저장되는 값이 화면에서 본 것과 같다.
|
||||
대표 이미지 파일을 고르면 파일을 DB 에 보관했다가 그 시각에 교체한다(마이그레이션 006).
|
||||
"""
|
||||
checked = guard(request)
|
||||
if not isinstance(checked, tuple):
|
||||
@@ -105,9 +110,16 @@ def schedule_create(
|
||||
display_flag = store.parse_tristate(set_display)
|
||||
selling_flag = store.parse_tristate(set_selling)
|
||||
|
||||
if not want_html and display_flag is None and selling_flag is None:
|
||||
image_data = b""
|
||||
if image is not None and image.filename: # 파일을 안 고르면 브라우저가 이름 없는 빈 파트를 보낸다
|
||||
try:
|
||||
image_data = _read_image(image)
|
||||
except HTTPException as exc:
|
||||
return RedirectResponse(url=f"{back}&err={exc.detail}", status_code=303)
|
||||
|
||||
if not want_html and display_flag is None and selling_flag is None and not image_data:
|
||||
return RedirectResponse(
|
||||
url=f"{back}&err=예약할 내용을 하나 이상 선택하세요(상세페이지 / 진열 / 판매).",
|
||||
url=f"{back}&err=예약할 내용을 하나 이상 선택하세요(대표 이미지 / 상세페이지 / 진열 / 판매).",
|
||||
status_code=303,
|
||||
)
|
||||
|
||||
@@ -146,9 +158,12 @@ def schedule_create(
|
||||
set_selling=selling_flag,
|
||||
memo=memo,
|
||||
created_by=actor,
|
||||
image=image_data or None,
|
||||
image_type=(image.content_type or "").lower() if image_data and image else "",
|
||||
image_name=(image.filename or "") if image_data and image else "",
|
||||
)
|
||||
detail = store.describe_schedule_action(
|
||||
has_html=want_html, set_display=display_flag, set_selling=selling_flag
|
||||
has_html=want_html, set_display=display_flag, set_selling=selling_flag, has_image=bool(image_data)
|
||||
)
|
||||
st.log_audit(
|
||||
actor=actor, action="schedule_create", product_no=product_no,
|
||||
@@ -179,6 +194,20 @@ def schedule_cancel(request: Request, schedule_id: int):
|
||||
)
|
||||
|
||||
|
||||
@schedules_router.get("/schedules/{schedule_id}/image")
|
||||
def schedule_image(request: Request, schedule_id: int):
|
||||
"""예약해 둔 대표 이미지 미리보기(목록 썸네일)."""
|
||||
checked = guard(request)
|
||||
if not isinstance(checked, tuple):
|
||||
return checked
|
||||
st, _user = checked
|
||||
row = st.get_schedule(schedule_id)
|
||||
data = st.get_schedule_image(schedule_id) if row.get("image_type") else b""
|
||||
if not data:
|
||||
return Response(status_code=404)
|
||||
return Response(content=data, media_type=str(row["image_type"]), headers={"Cache-Control": "private, max-age=3600"})
|
||||
|
||||
|
||||
@schedules_router.get("/schedules/preview/{product_no}")
|
||||
def schedule_current_flags(request: Request, product_no: int) -> dict:
|
||||
"""예약 폼의 기본값을 위해 현재 진열/판매 상태를 알려준다(JSON, 읽기 전용)."""
|
||||
@@ -187,7 +216,7 @@ def schedule_current_flags(request: Request, product_no: int) -> dict:
|
||||
st, _user = require_store(request)
|
||||
api = build_cafe24_api(st)
|
||||
try:
|
||||
raw = products.get_product(api.client, product_no)
|
||||
raw, _ = load_product(st, api, product_no) # 방금 바꾼 진열/판매가 지연으로 예전 값이 되지 않게
|
||||
except Cafe24Error as exc:
|
||||
return {"product_no": product_no, "error": str(exc)}
|
||||
normalized = products.normalize_product(raw)
|
||||
|
||||
+73
-22
@@ -452,10 +452,12 @@ def parse_schedule_at(value: object, *, now: datetime | None = None) -> datetime
|
||||
|
||||
|
||||
def describe_schedule_action(
|
||||
*, has_html: bool, set_display: bool | None, set_selling: bool | None
|
||||
*, has_html: bool, set_display: bool | None, set_selling: bool | None, has_image: bool = False
|
||||
) -> str:
|
||||
"""예약 내용을 한 줄로 요약(목록·로그 표시용)."""
|
||||
parts: list[str] = []
|
||||
if has_image:
|
||||
parts.append("대표이미지")
|
||||
if has_html:
|
||||
parts.append("상세페이지")
|
||||
if set_display is not None:
|
||||
@@ -504,6 +506,15 @@ WRITE_REVISION_TYPES: tuple[str, ...] = (REVISION_MANUAL, REVISION_SCHEDULED, RE
|
||||
DEFAULT_READ_LAG_GRACE_MIN = 360
|
||||
|
||||
|
||||
def parse_shop_nos(value: object) -> list[int]:
|
||||
"""`CAFE24_SHOP_NOS`("1,2,3") → [1, 2, 3]. 기본 쇼핑몰 1 은 항상 맨 앞, 잘못된 값은 버린다."""
|
||||
out = [1]
|
||||
for part in str(value or "").replace(" ", "").split(","):
|
||||
if part.isdigit() and int(part) > 0 and int(part) not in out:
|
||||
out.append(int(part))
|
||||
return out
|
||||
|
||||
|
||||
def parse_grace_minutes(value: object, default: int = DEFAULT_READ_LAG_GRACE_MIN) -> int:
|
||||
try:
|
||||
minutes = int(str(value or "").strip())
|
||||
@@ -640,6 +651,12 @@ def overlay_recent_write(
|
||||
보다 GET 의 updated_date 가 **이전**이면 GET 이 아직 예전 레코드를 돌려주는
|
||||
것이다. 우리 서버 시계와 비교하지 않으므로 시계 차이에 영향받지 않는다.
|
||||
날짜가 없어 판정할 수 없으면 카페24 값을 그대로 둔다.
|
||||
|
||||
두 updated_date 가 **같을** 때: 카페24는 진열/판매만 바꾼 PUT 에서 updated_date 를
|
||||
올리지 않을 수 있다. 그러면 지연된 GET 도 같은 시각을 돌려주므로 "같다 = 따라잡음"
|
||||
으로 보면 예전 진열/판매가 그대로 보인다(실제 발생 — 바꿔도 반영 안 된 것처럼 보임).
|
||||
같은 시각인데 값이 다르면 카페24 기준으로 그 뒤 수정된 근거가 없으므로 지연으로 본다.
|
||||
GET 이 **이후** 시각이면 관리자 등에서 다시 고친 것 — 카페24 값을 믿는다.
|
||||
반환: (병합된 상품 dict, 지연 여부)
|
||||
"""
|
||||
if not snapshot:
|
||||
@@ -648,7 +665,9 @@ def overlay_recent_write(
|
||||
return fetched, False
|
||||
fetched_at = _as_aware(fetched.get("updated_date"))
|
||||
snap_at = _as_aware(snapshot.get("updated_date"))
|
||||
if fetched_at is None or snap_at is None or fetched_at >= snap_at:
|
||||
if fetched_at is None or snap_at is None or fetched_at > snap_at:
|
||||
return fetched, False
|
||||
if fetched_at == snap_at and not _snapshot_differs(fetched, snapshot):
|
||||
return fetched, False
|
||||
merged = dict(fetched)
|
||||
for key in SNAPSHOT_FIELDS:
|
||||
@@ -658,6 +677,50 @@ def overlay_recent_write(
|
||||
return merged, True
|
||||
|
||||
|
||||
def _snapshot_differs(fetched: dict, snapshot: dict) -> bool:
|
||||
"""GET 에 있는 스냅샷 필드 중 값이 다른 것이 있는가(문자열로 비교 — 둘 다 카페24 원본 모양)."""
|
||||
for key in SNAPSHOT_FIELDS:
|
||||
if key == "updated_date" or key not in snapshot or key not in fetched:
|
||||
continue
|
||||
if fetched[key] is None:
|
||||
continue
|
||||
if str(fetched[key]) != str(snapshot[key]):
|
||||
return True
|
||||
return False
|
||||
|
||||
|
||||
def overlay_product_rows(
|
||||
rows: list[dict],
|
||||
snapshots: dict,
|
||||
*,
|
||||
grace_minutes: int,
|
||||
now: datetime | None = None,
|
||||
) -> list[dict]:
|
||||
"""목록(GET /admin/products) 행마다 최근 쓰기 스냅샷을 덮어씌운다.
|
||||
|
||||
snapshots: {product_no: {"data": 스냅샷, "written_at": ISO}} — 스냅샷 product 섹션.
|
||||
목록 API 도 단건 GET 과 똑같이 읽기 지연이 있다. 보정하지 않으면 진열/판매를 바꾼
|
||||
뒤 목록을 다시 불러올 때 예전 상태로 보이고(필터에 걸려 사라지기도 한다), 그 값이
|
||||
캐시(cafe24_products)에도 다시 저장된다.
|
||||
"""
|
||||
if not snapshots:
|
||||
return rows
|
||||
out: list[dict] = []
|
||||
for row in rows:
|
||||
try:
|
||||
no = int(row.get("product_no") or 0)
|
||||
except (TypeError, ValueError):
|
||||
no = 0
|
||||
section = snapshots.get(no) if no else None
|
||||
if isinstance(section, dict) and section.get("data"):
|
||||
row, _ = overlay_recent_write(
|
||||
row, snapshot=section.get("data"), written_at=section.get("written_at"),
|
||||
grace_minutes=grace_minutes, now=now,
|
||||
)
|
||||
out.append(row)
|
||||
return out
|
||||
|
||||
|
||||
# ── 품목 스냅샷: 코드별 · 필드별 병합 ──
|
||||
# 스냅샷 모양: {variant_code: {필드: 값, ..., "_at": ISO, "_deleted": bool,
|
||||
# "options": [{name,value}...], "_options_before": [...]}}
|
||||
@@ -921,16 +984,15 @@ def build_update_options_request(
|
||||
edited: list[dict],
|
||||
*,
|
||||
option_list_type: str = "",
|
||||
allow_append: bool = False,
|
||||
) -> dict:
|
||||
"""옵션명/옵션값(이름·이미지·색상·표시방식) 수정 요청.
|
||||
|
||||
카페24 PUT options 는 `original_options`(수정 전) 와 `options`(수정 후) 를
|
||||
**위치**로 짝지어 이름을 바꾼다. 그래서
|
||||
- 옵션값을 **뒤에 덧붙이는** 것(`allow_append`)만 허용한다 — 앞쪽 위치는 그대로라
|
||||
기존 이름이 밀리지 않는다(카페24가 추가를 거부하면 그 오류가 그대로 올라온다).
|
||||
- 옵션값 **삭제**(개수 감소)는 거부한다 — 중간을 빼면 뒤 값들이 한 칸씩 당겨져
|
||||
엉뚱한 품목의 이름이 바뀐다. 정리는 옵션 재생성(삭제 후 생성)으로 한다.
|
||||
**위치**로 짝지어 이름을 바꾼다. 옵션값 개수는 바꿀 수 없다:
|
||||
- **추가**: 카페24 문서상 PUT 은 옵션 항목 추가를 지원하지 않는다 — 실물에서
|
||||
덧붙여 보내도 오류 없이 무시되어 "저장했는데 사라짐"이 됐다(2026-11-06).
|
||||
추가는 옵션 재생성(삭제 후 POST)으로 한다.
|
||||
- **삭제**: 중간을 빼면 뒤 값들이 한 칸씩 당겨져 엉뚱한 품목의 이름이 바뀐다.
|
||||
original: GET 응답의 options 그대로. edited: 화면에서 보낸 같은 모양의 목록.
|
||||
"""
|
||||
if len(original) != len(edited):
|
||||
@@ -945,10 +1007,10 @@ def build_update_options_request(
|
||||
f"옵션 「{o.get('option_name')}」 의 옵션값을 줄일 수 없습니다. "
|
||||
"옵션값 삭제는 카페24 API 가 지원하지 않습니다 — 옵션 재생성으로 정리하세요."
|
||||
)
|
||||
if len(e_vals) > len(o_vals) and not allow_append:
|
||||
if len(e_vals) > len(o_vals):
|
||||
raise ValueError(
|
||||
f"옵션 「{o.get('option_name')}」 의 옵션값 개수가 카페24와 다릅니다. "
|
||||
"다시 읽은 뒤 수정하세요."
|
||||
f"옵션 「{o.get('option_name')}」 에 옵션값을 추가할 수 없습니다. "
|
||||
"카페24 API 는 기존 옵션에 옵션값 추가를 지원하지 않습니다 — 「옵션 재생성」으로 추가하세요."
|
||||
)
|
||||
name = str(e.get("option_name") or "").strip()
|
||||
if not name:
|
||||
@@ -984,17 +1046,6 @@ def build_update_options_request(
|
||||
n_item[key] = value
|
||||
orig_entry["option_value"].append(o_item)
|
||||
new_entry["option_value"].append(n_item)
|
||||
# 덧붙이는 새 옵션값 — 수정 전 목록에는 없고 수정 후 목록 끝에만 있다.
|
||||
for ev in e_vals[len(o_vals):]:
|
||||
text = str(ev.get("option_text") or "").strip()
|
||||
if not text:
|
||||
raise ValueError("추가할 옵션값 이름은 비울 수 없습니다.")
|
||||
n_item = {"option_text": text}
|
||||
for key in ("option_image_file", "option_link_image", "option_color"):
|
||||
value = str(ev.get(key) or "").strip()
|
||||
if value:
|
||||
n_item[key] = value
|
||||
new_entry["option_value"].append(n_item)
|
||||
orig_out.append(orig_entry)
|
||||
new_out.append(new_entry)
|
||||
request: dict = {"original_options": orig_out, "options": new_out}
|
||||
|
||||
@@ -0,0 +1,113 @@
|
||||
"""일회성 — 모든 옵션 상품의 품목 진열·판매를 기본몰(1) 값으로 다른 멀티쇼핑몰에 맞춘다.
|
||||
|
||||
# 미리보기(쓰지 않음): 바뀔 품목만 출력
|
||||
docker exec dbx-main python -m app.modules.cafe24.sync_variant_flags --shops 3,4
|
||||
# 실제 반영 — 출력(바꾸기 전 값 포함)을 파일로 남겨 둔다
|
||||
docker exec dbx-main python -m app.modules.cafe24.sync_variant_flags --shops 3,4 --apply > sync.log
|
||||
|
||||
기본몰 값은 화면과 같은 기준(읽기 지연 보정)으로 읽는다. 다른 쇼핑몰에 없는 품목은 건너뛴다.
|
||||
진열·판매만 보낸다(추가금액·자체코드는 건드리지 않음). 출력의 BEFORE 줄 = 되돌릴 때 쓸 원래 값.
|
||||
"""
|
||||
from __future__ import annotations
|
||||
|
||||
import argparse
|
||||
import json
|
||||
import os
|
||||
import sys
|
||||
from typing import Any
|
||||
|
||||
|
||||
def plan_flag_sync(base: list[dict[str, Any]], shop_variants: list[dict[str, Any]]) -> list[dict[str, Any]]:
|
||||
"""기본몰 품목(display/selling = bool) vs 다른 쇼핑몰 GET 품목('T'/'F') → 바꿀 PUT 요청."""
|
||||
from app.integrations.cafe24 import products # noqa: WPS433
|
||||
|
||||
other = {str(v.get("variant_code") or ""): v for v in shop_variants}
|
||||
out = []
|
||||
for v in base:
|
||||
o = other.get(v["variant_code"])
|
||||
if o is None:
|
||||
continue
|
||||
req = {k: ("T" if v[k] else "F") for k in ("display", "selling")
|
||||
if products._flag(o.get(k)) != v[k]} # noqa: SLF001
|
||||
if req:
|
||||
out.append({"variant_code": v["variant_code"], **req})
|
||||
return out
|
||||
|
||||
|
||||
def main(argv: list[str] | None = None) -> int:
|
||||
from app.integrations.cafe24 import build_cafe24_api # noqa: WPS433
|
||||
|
||||
from . import build_cafe24_store # noqa: WPS433
|
||||
|
||||
ap =argparse.ArgumentParser()
|
||||
ap.add_argument("--shops", required=True, help="맞출 쇼핑몰 번호(쉼표), 예: 3,4")
|
||||
ap.add_argument("--apply", action="store_true", help="실제로 카페24에 쓴다(없으면 미리보기)")
|
||||
args = ap.parse_args(argv)
|
||||
shops = [int(s) for s in args.shops.split(",") if s.strip().isdigit() and int(s) > 1]
|
||||
if not shops:
|
||||
print("--shops 에 2 이상 쇼핑몰 번호가 필요합니다.", file=sys.stderr)
|
||||
return 2
|
||||
|
||||
st = build_cafe24_store(dsn=os.environ["CAFE24_DB_URL"])
|
||||
try:
|
||||
return _run(st, build_cafe24_api(st), shops, args.apply)
|
||||
finally:
|
||||
st.close()
|
||||
|
||||
|
||||
def _run(st: Any, api: Any, shops: list[int], apply: bool) -> int:
|
||||
from app.integrations.cafe24 import products # noqa: WPS433
|
||||
|
||||
from . import writes # noqa: WPS433
|
||||
from .routes_product_info import _load_options_and_variants # noqa: WPS433
|
||||
|
||||
items, truncated = products.list_all_products(api.client)
|
||||
if truncated:
|
||||
print("상품이 상한(1000)을 넘어 일부만 처리합니다.", file=sys.stderr)
|
||||
mode = "APPLY" if apply else "DRY-RUN"
|
||||
total = failed = 0
|
||||
for item in items:
|
||||
no = int(item["product_no"])
|
||||
if str(item.get("has_option") or "T") == "F":
|
||||
continue
|
||||
try:
|
||||
base = _load_options_and_variants(st, api, no)["variants"]
|
||||
except Exception as exc: # noqa: BLE001 — 한 상품 실패가 나머지를 막지 않게
|
||||
print(f"ERROR {no} 기본몰 조회 실패: {exc}")
|
||||
failed += 1
|
||||
continue
|
||||
for shop in shops:
|
||||
try:
|
||||
got = api.client.get(f"/admin/products/{no}/variants", params={"shop_no": shop}, product_no=no)
|
||||
except Exception as exc: # noqa: BLE001
|
||||
print(f"ERROR {no} shop {shop} 조회 실패: {exc}")
|
||||
failed += 1
|
||||
continue
|
||||
shop_vars = got.get("variants") if isinstance(got.get("variants"), list) else []
|
||||
reqs = plan_flag_sync(base, shop_vars)
|
||||
if not reqs:
|
||||
continue
|
||||
before = {str(v.get("variant_code")): {"display": v.get("display"), "selling": v.get("selling")}
|
||||
for v in shop_vars if str(v.get("variant_code")) in {r["variant_code"] for r in reqs}}
|
||||
print("BEFORE " + json.dumps({"product_no": no, "shop_no": shop, "variants": before}, ensure_ascii=False))
|
||||
print(f"{mode} {no} shop {shop}: {len(reqs)}건 " + json.dumps(reqs, ensure_ascii=False))
|
||||
total += len(reqs)
|
||||
if not apply:
|
||||
continue
|
||||
bad = [r for r in products.update_variants(api.client, no, reqs, shop_no=shop)
|
||||
if r["status"] != products.VARIANT_OK]
|
||||
failed += len(bad)
|
||||
writes.audit_safe(
|
||||
st, actor="SYNC_SHOPS", action="update_variants", product_no=no,
|
||||
result="FAIL" if bad else "SUCCESS",
|
||||
detail=(f"[쇼핑몰 {shop} 진열·판매 = 기본몰] " + json.dumps(reqs, ensure_ascii=False)
|
||||
+ (f" / 실패 {len(bad)}: {bad[0]['error']}" if bad else ""))[:900],
|
||||
)
|
||||
if bad:
|
||||
print(f"ERROR {no} shop {shop}: 실패 {len(bad)}건 — {bad[0]['error']}")
|
||||
print(f"{mode} 끝 — 상품 {len(items)}개 확인, 바꿀/바꾼 품목 {total}건, 오류 {failed}건")
|
||||
return 1 if failed else 0
|
||||
|
||||
|
||||
if __name__ == "__main__":
|
||||
raise SystemExit(main())
|
||||
@@ -122,7 +122,7 @@
|
||||
<input type="hidden" name="list_query" value="{{ list_query }}" />
|
||||
|
||||
<div class="cf24-editor-bar">
|
||||
<span class="cf24-shortcuts">단축키: 주석토글[Ctrl+/] · 줄 복사[Alt+Shift+↑↓] · 줄 이동[Alt+↑↓] · 줄 삭제[Shift+Del]</span>
|
||||
<span class="cf24-shortcuts">단축키: 주석토글[Ctrl+/] · 줄 복사[Alt+Shift+↑↓] · 줄 이동[Alt+↑↓] · 줄 삭제[Shift+Del] · 이미지 번호[Ctrl+↑↓]</span>
|
||||
<span class="cf24-editor-bar-right">
|
||||
<input class="cf24-memo" type="text" name="memo" maxlength="200"
|
||||
placeholder="변경 메모 (버전 이력에 남습니다)" />
|
||||
@@ -156,7 +156,7 @@
|
||||
<details class="cf24-details">
|
||||
<summary>예약 적용 — 지정한 시각에 자동 반영</summary>
|
||||
<form class="cf24-schedule-form" id="cf24-schedule-form" method="post"
|
||||
action="/cafe24/schedules"
|
||||
action="/cafe24/schedules" enctype="multipart/form-data"
|
||||
data-confirm="지정한 시각에 자동으로 반영됩니다. 예약을 등록할까요?">
|
||||
<input type="hidden" name="product_no" value="{{ product_no }}" />
|
||||
<input type="hidden" name="list_query" value="{{ list_query }}" />
|
||||
@@ -205,6 +205,15 @@
|
||||
<option value="off">중지</option>
|
||||
</select>
|
||||
</label>
|
||||
{# 대표 이미지(썸네일) — 고르면 그 시각에 교체. 파일은 DB 에 보관했다가 worker 가 올린다. #}
|
||||
<div class="cf24-schedule-wide cf24-schedule-image">
|
||||
<span>대표 이미지</span>
|
||||
<label class="cf24-file-pick">
|
||||
<input type="file" name="image" id="cf24-schedule-image" accept="image/jpeg,image/png,image/gif,image/webp" />
|
||||
<span class="erp-btn erp-btn-outline">파일 선택</span>
|
||||
<span class="cf24-file-name" id="cf24-schedule-image-name">변경 없음</span>
|
||||
</label>
|
||||
</div>
|
||||
<label class="cf24-schedule-wide">
|
||||
<span>메모</span>
|
||||
<input class="cf24-schedule-input" type="text" name="memo" maxlength="200"
|
||||
@@ -221,7 +230,8 @@
|
||||
<a class="erp-btn erp-btn-outline" href="/cafe24/schedules">예약 목록</a>
|
||||
</div>
|
||||
<p class="cf24-muted" style="margin:8px 0 0;">
|
||||
진열·판매만 바꾸려면 위 체크를 해제하세요. 셋 중 하나 이상은 선택해야 합니다.
|
||||
대표 이미지·진열·판매만 바꾸려면 위 체크를 해제하세요. 넷 중 하나 이상은 선택해야 합니다.
|
||||
대표 이미지는 JPG·PNG·GIF·WEBP, 10MB 이하(목록/축소 이미지는 카페24가 자동 생성).
|
||||
</p>
|
||||
</form>
|
||||
</details>
|
||||
|
||||
@@ -1,5 +1,5 @@
|
||||
{# 카페24 모듈 공용 상단 탭. active_tab: products | design:pc_detail | design:mobile_detail | design:swiper | schedules | system #}
|
||||
<div class="erp-page-actions" style="display:flex;gap:8px;flex-wrap:wrap;align-items:center;">
|
||||
<div class="erp-page-actions" style="display:flex;gap:8px;flex-wrap:wrap;align-items:center;margin-bottom:10px;">
|
||||
<a class="erp-btn {% if active_tab=='products' %}erp-btn-primary{% else %}erp-btn-outline{% endif %}"
|
||||
href="/cafe24/">상품관리</a>
|
||||
<a class="erp-btn {% if active_tab=='design:pc_detail' %}erp-btn-primary{% else %}erp-btn-outline{% endif %}"
|
||||
|
||||
@@ -1,7 +1,7 @@
|
||||
{% extends "erp_base.html" %}
|
||||
|
||||
{% block head_extra %}
|
||||
<link rel="stylesheet" href="/static/cafe24.css?v=20261015a" />
|
||||
<link rel="stylesheet" href="/static/cafe24.css?v=20261110a" />
|
||||
{% endblock %}
|
||||
|
||||
{% block content %}
|
||||
|
||||
@@ -1,7 +1,7 @@
|
||||
{% extends "erp_base.html" %}
|
||||
|
||||
{% block head_extra %}
|
||||
<link rel="stylesheet" href="/static/cafe24.css?v=20261015a" />
|
||||
<link rel="stylesheet" href="/static/cafe24.css?v=20261110a" />
|
||||
{% endblock %}
|
||||
|
||||
{% block content %}
|
||||
@@ -45,6 +45,7 @@
|
||||
<thead>
|
||||
<tr>
|
||||
<th class="cf24-col-no" data-sort-key="no" data-sort-type="num">번호</th>
|
||||
<th class="cf24-col-thumb"></th>
|
||||
<th class="cf24-col-name" data-sort-key="name" data-sort-type="text">상품명</th>
|
||||
<th class="cf24-col-flag" data-sort-key="display" data-sort-type="num">진열</th>
|
||||
<th class="cf24-col-flag" data-sort-key="selling" data-sort-type="num">판매</th>
|
||||
@@ -60,6 +61,7 @@
|
||||
data-selling="{{ 1 if r.selling else 0 }}"
|
||||
data-updated="{{ r.updated_date }}">
|
||||
<td class="cf24-col-no">{{ r.product_no }}</td>
|
||||
<td class="cf24-col-thumb"><img class="cf24-thumb" {% if r.thumb %}src="{{ r.thumb }}"{% endif %} loading="lazy" alt="" /></td>
|
||||
<td class="cf24-col-name" title="{{ r.product_name }}">
|
||||
<a href="/cafe24/?{{ qs }}selected={{ r.product_no }}">{{ r.product_name }}</a>
|
||||
</td>
|
||||
@@ -122,10 +124,13 @@
|
||||
<div class="cf24-modal-body cf24-options-body" id="cf24-options-body"></div>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
{# 소스의 <img> 위에 마우스를 올리면 화면 오른쪽에 뜨는 미리보기 — setupCodeEditor 가 켜고 끈다. #}
|
||||
<div class="cf24-img-preview" id="cf24-img-preview" hidden><div class="cf24-img-preview-name"></div><img alt="이미지를 불러올 수 없습니다" /></div>
|
||||
{% endblock %}
|
||||
|
||||
{% block scripts %}
|
||||
<script src="/static/cafe24-options.js?v=20260928c"></script>
|
||||
<script src="/static/cafe24-options.js?v=20261110c"></script>
|
||||
<script>
|
||||
(function () {
|
||||
var pane = document.getElementById("cf24-editor-pane");
|
||||
@@ -164,14 +169,42 @@
|
||||
last = TOKEN_RE.lastIndex;
|
||||
if (m[1]) { out += '<span class="cf24-t-com">' + esc(m[1]) + "</span>"; continue; }
|
||||
if (m[2]) { out += '<span class="cf24-t-doc">' + esc(m[2]) + "</span>"; continue; }
|
||||
out += '<span class="cf24-t-pun">' + esc(m[3]) + "</span>" +
|
||||
'<span class="cf24-t-tag">' + esc(m[4]) + "</span>" +
|
||||
paintAttrs(m[5]) +
|
||||
'<span class="cf24-t-pun">' + esc(m[6]) + "</span>";
|
||||
var tag = '<span class="cf24-t-pun">' + esc(m[3]) + "</span>" +
|
||||
'<span class="cf24-t-tag">' + esc(m[4]) + "</span>" +
|
||||
paintAttrs(m[5]) +
|
||||
'<span class="cf24-t-pun">' + esc(m[6]) + "</span>";
|
||||
out += /^img$/i.test(m[4]) ? '<span class="cf24-t-img">' + tag + "</span>" : tag;
|
||||
}
|
||||
return out + esc(src.slice(last));
|
||||
}
|
||||
|
||||
// 상대 경로는 쇼핑몰 루트 기준이다: ../img/a.jpg → https://쇼핑몰/img/a.jpg
|
||||
function imgPreviewUrl(tag) {
|
||||
var m = tag.match(/\ssrc\s*=\s*(?:"([^"]*)"|'([^']*)'|([^\s>]+))/i);
|
||||
var src = m && (m[1] || m[2] || m[3]);
|
||||
var shop = document.getElementById("cf24-url");
|
||||
if (!src || !shop) return "";
|
||||
try { return new URL(src, new URL("/", shop.value)).href; }
|
||||
catch (err) { return ""; }
|
||||
}
|
||||
|
||||
function imgFileName(url) {
|
||||
var name = new URL(url).pathname.split("/").pop();
|
||||
// URL 이 한글 파일명을 %XX 로 바꿔 놓으므로 되돌린다.
|
||||
try { return decodeURIComponent(name); }
|
||||
catch (err) { return name; }
|
||||
}
|
||||
|
||||
function showImgPreview(url) {
|
||||
var box = document.getElementById("cf24-img-preview");
|
||||
var img = box.lastElementChild;
|
||||
if (url && img.getAttribute("src") !== url) {
|
||||
img.src = url;
|
||||
box.firstElementChild.textContent = imgFileName(url);
|
||||
}
|
||||
box.hidden = !url;
|
||||
}
|
||||
|
||||
function setupCodeEditor() {
|
||||
var ta = document.getElementById("cf24-html-pc");
|
||||
var hl = document.getElementById("cf24-hl-pc");
|
||||
@@ -337,6 +370,62 @@
|
||||
applyEdit(from, to, "", lineFrom + col, lineFrom + col);
|
||||
}
|
||||
|
||||
/* Ctrl+↑/↓ — 커서가 <img> 태그 안 어디에 있든 src 파일명(.jpg/.gif/.png)의 번호를 바꾼다.
|
||||
a.jpg → a_2.jpg → a_3.jpg …, a_5.jpg → a_6.jpg …. 내릴 때는 원래 번호(없었으면 원래 이름) 아래로 안 간다.
|
||||
원래 번호는 imgStep 에 기억한다 — 이 단축키 말고 소스가 바뀌거나 다른 이미지로 옮기면 그때 번호가 새 원래 번호.
|
||||
조건이 안 맞으면 false — 브라우저 기본 동작을 막지 않는다. */
|
||||
var imgStep = null;
|
||||
|
||||
function stepImgSuffix(up) {
|
||||
var at = ta.selectionStart, value = ta.value;
|
||||
if (at !== ta.selectionEnd) return false;
|
||||
|
||||
var tagRe = /<img\s(?:"[^"]*"|'[^']*'|[^>"'])*>/gi, tag;
|
||||
while ((tag = tagRe.exec(value)) && tagRe.lastIndex <= at);
|
||||
if (!tag || tag.index >= at) return false;
|
||||
|
||||
var src = tag[0].match(/\ssrc\s*=\s*(?:"([^"]*)|'([^']*)|([^\s>"']+))/i);
|
||||
var path = src && (src[1] || src[2] || src[3]);
|
||||
var file = path && path.match(/^(.*)\.(?:jpg|gif|png)(?=[?#]|$)/i);
|
||||
if (!file) return false;
|
||||
|
||||
var ext = tag.index + src.index + src[0].length - path.length + file[1].length; // 확장자 시작 위치
|
||||
var num = file[1].match(/_(\d{1,15})$/); // 16자리부터는 숫자 계산이 어긋나 번호로 보지 않는다
|
||||
var orig = imgStep && imgStep.value === value && imgStep.ext === ext ? imgStep.orig : (num ? num[1] : "");
|
||||
var n = num ? Number(num[1]) : 1;
|
||||
if (!up && n <= (orig ? Number(orig) : 1)) return true; // 원래 번호 아래로는 안 간다
|
||||
|
||||
var next = up ? n + 1 : n - 1;
|
||||
// a_01 → a_02 처럼 원래 자릿수를 유지한다.
|
||||
var text = !orig && next < 2 ? "" : "_" + String(next).padStart(orig.length, "0");
|
||||
var from = ext - (num ? num[0].length : 0);
|
||||
var caret = at >= ext ? at + text.length - (ext - from) : at <= from ? at : from + text.length;
|
||||
applyEdit(from, ext, text, caret, caret);
|
||||
imgStep = { value: ta.value, ext: from + text.length, orig: orig };
|
||||
return true;
|
||||
}
|
||||
|
||||
/* 이미지 미리보기 — 맨 위 textarea 를 판정에서 잠깐 빼고 색칠 층의 <img> 를 찾는다.
|
||||
글자 폭을 계산하지 않아 한글·탭·여러 줄 태그에서도 위치가 어긋나지 않는다.
|
||||
shortcut: HL_LIMIT 초과 소스는 색칠을 안 해 미리보기도 안 뜬다, 그런 상품이 나오면 글자 위치 계산으로 교체. */
|
||||
var hoverTag = null;
|
||||
|
||||
function setHoverTag(tag) {
|
||||
if (tag === hoverTag) return;
|
||||
if (hoverTag) hoverTag.classList.remove("cf24-t-img-on");
|
||||
if (tag) tag.classList.add("cf24-t-img-on");
|
||||
hoverTag = tag;
|
||||
showImgPreview(tag ? imgPreviewUrl(tag.textContent) : "");
|
||||
}
|
||||
|
||||
ta.addEventListener("mousemove", function (e) {
|
||||
ta.style.pointerEvents = "none";
|
||||
var el = document.elementFromPoint(e.clientX, e.clientY);
|
||||
ta.style.pointerEvents = "";
|
||||
setHoverTag(el && el.closest(".cf24-t-img"));
|
||||
});
|
||||
ta.addEventListener("mouseleave", function () { setHoverTag(null); });
|
||||
|
||||
ta.addEventListener("scroll", sync);
|
||||
ta.addEventListener("input", function () { dirty = true; refresh(); });
|
||||
ta.addEventListener("keydown", function (e) {
|
||||
@@ -356,6 +445,10 @@
|
||||
else moveLines(isDown);
|
||||
return;
|
||||
}
|
||||
if (e.ctrlKey && !e.altKey && !e.metaKey && !e.shiftKey && (isUp || isDown) && stepImgSuffix(isUp)) {
|
||||
e.preventDefault();
|
||||
return;
|
||||
}
|
||||
// Shift+Delete — 줄 삭제. (윈도우 기본 동작인 "잘라내기"를 대신한다)
|
||||
if (e.shiftKey && !e.ctrlKey && !e.altKey && !e.metaKey &&
|
||||
(e.key === "Delete" || e.code === "Delete")) {
|
||||
@@ -470,6 +563,17 @@
|
||||
// 날짜·시간도 두 개의 별도 input 값을 합쳐 서버가 기대하는 형식으로 만든다.
|
||||
var schedForm = pane.querySelector("#cf24-schedule-form");
|
||||
if (schedForm) {
|
||||
var schedImg = schedForm.querySelector("#cf24-schedule-image");
|
||||
var schedImgName = schedForm.querySelector("#cf24-schedule-image-name");
|
||||
if (schedImg) schedImg.addEventListener("change", function () {
|
||||
var f = schedImg.files && schedImg.files[0];
|
||||
if (f && f.size > 10 * 1024 * 1024) {
|
||||
window.erpAlert("10MB 를 넘는 파일은 올릴 수 없습니다.");
|
||||
schedImg.value = "";
|
||||
f = null;
|
||||
}
|
||||
schedImgName.textContent = f ? f.name + " (" + Math.round(f.size / 1024) + "KB) — 그 시각에 교체" : "변경 없음";
|
||||
});
|
||||
schedForm.addEventListener("submit", function (e) {
|
||||
var box = document.getElementById("cf24-html-pc");
|
||||
var holder = document.getElementById("cf24-schedule-html");
|
||||
@@ -485,7 +589,8 @@
|
||||
// 확인창이 비동기라 일단 제출을 멈추고, 확인을 받으면 다시 보낸다.
|
||||
// (required 검사는 이미 통과한 뒤라 form.submit() 으로 보내도 안전하다)
|
||||
e.preventDefault();
|
||||
window.erpConfirm(schedForm.dataset.confirm).then(function (ok) {
|
||||
var imgFile = schedImg && schedImg.files && schedImg.files[0];
|
||||
window.erpConfirm(schedForm.dataset.confirm + (imgFile ? "\n\n대표 이미지: 「" + imgFile.name + "」(으)로 교체" : "")).then(function (ok) {
|
||||
if (!ok) return;
|
||||
dirty = false; // 예약 등록으로 화면을 떠나므로 편집 중 경고를 끈다.
|
||||
schedForm.submit();
|
||||
@@ -864,6 +969,8 @@
|
||||
if (link) { link.href = p.detail_image; link.classList.remove("is-hidden"); }
|
||||
if (empty) empty.classList.add("is-hidden");
|
||||
}
|
||||
var thumb = document.querySelector('#cf24-list tr.cf24-row[data-no="' + no + '"] .cf24-thumb');
|
||||
if (thumb && (p.tiny_image || p.detail_image)) thumb.src = bust(p.tiny_image || p.detail_image);
|
||||
root.querySelectorAll("[data-image-key]").forEach(function (el) {
|
||||
var v = p[el.dataset.imageKey];
|
||||
if (!v) return;
|
||||
|
||||
@@ -1,7 +1,7 @@
|
||||
{% extends "erp_base.html" %}
|
||||
|
||||
{% block head_extra %}
|
||||
<link rel="stylesheet" href="/static/cafe24.css?v=20261015a" />
|
||||
<link rel="stylesheet" href="/static/cafe24.css?v=20261110a" />
|
||||
{% endblock %}
|
||||
|
||||
{% block content %}
|
||||
@@ -37,7 +37,7 @@
|
||||
<th style="width:130px;">예정 시각</th>
|
||||
<th style="width:66px;">상품</th>
|
||||
<th>상품명</th>
|
||||
<th style="width:150px;">적용 내용</th>
|
||||
<th style="width:170px;">적용 내용</th>
|
||||
<th style="width:96px;">상태</th>
|
||||
<th>메모 / 오류</th>
|
||||
<th style="width:130px;">등록자</th>
|
||||
@@ -53,7 +53,8 @@
|
||||
<a href="/cafe24/?selected={{ r.product_no }}">{{ r.product_no }}</a>
|
||||
</td>
|
||||
<td>{{ r.product_name or '—' }}</td>
|
||||
<td class="cf24-nowrap">{{ r.action_label }}</td>
|
||||
<td class="cf24-nowrap">{{ r.action_label }}
|
||||
{% if r.image_type %}<a href="/cafe24/schedules/{{ r.id }}/image" target="_blank" rel="noopener" title="{{ r.image_name }}"><img class="cf24-sched-img" src="/cafe24/schedules/{{ r.id }}/image" alt="{{ r.image_name }}" loading="lazy" /></a>{% endif %}</td>
|
||||
<td class="cf24-nowrap">
|
||||
{% if r.status == 'SUCCESS' %}<span class="erp-badge cf24-badge-ok">{{ r.status_label }}</span>
|
||||
{% elif r.status == 'FAILED' %}<span class="cf24-err">{{ r.status_label }}</span>
|
||||
|
||||
@@ -1,7 +1,7 @@
|
||||
{% extends "erp_base.html" %}
|
||||
|
||||
{% block head_extra %}
|
||||
<link rel="stylesheet" href="/static/cafe24.css?v=20261015a" />
|
||||
<link rel="stylesheet" href="/static/cafe24.css?v=20261110a" />
|
||||
{% endblock %}
|
||||
|
||||
{% block content %}
|
||||
|
||||
@@ -193,6 +193,9 @@ class MemoryStore:
|
||||
def get_write_snapshot(self, product_no):
|
||||
return dict(self.snapshots.get(int(product_no), {}))
|
||||
|
||||
def get_recent_product_snapshots(self, grace_minutes):
|
||||
return {no: dict(snap["product"]) for no, snap in self.snapshots.items() if snap.get("product")}
|
||||
|
||||
# ── 예약 ──
|
||||
def add_schedule(self, **fields):
|
||||
sid = next(self._ids)
|
||||
@@ -393,6 +396,8 @@ class FakeCafe24:
|
||||
self._variant_puts += 1
|
||||
if self.fail_variant_chunk and self._variant_puts == self.fail_variant_chunk:
|
||||
raise self.variant_error or Cafe24ApiError("품목 수정 거절", status=422)
|
||||
if (json or {}).get("shop_no", 1) != 1: # 다른 쇼핑몰 — 기본몰 상태는 그대로
|
||||
return {"variants": [dict(r) for r in (json or {}).get("requests") or []]}
|
||||
out = []
|
||||
for r in (json or {}).get("requests") or []:
|
||||
for var in self.variants:
|
||||
@@ -408,6 +413,13 @@ class FakeCafe24:
|
||||
|
||||
def post(self, path, *, json=None, **kw):
|
||||
self.calls.append(("POST", path, json))
|
||||
if path == f"/admin/products/{self.product_no}/images": # 대표이미지 등록(A 타입)
|
||||
self._tick()
|
||||
n = sum(1 for c in self.calls if c[1] == path)
|
||||
image = {k: f"/web/product/{k.split('_')[0]}/{self.product_no}_{n}.png"
|
||||
for k in ("detail_image", "list_image", "tiny_image", "small_image")}
|
||||
self.state.update(image)
|
||||
return {"image": image}
|
||||
out = self._options_call("POST", path, json)
|
||||
return copy.deepcopy(out) if out is not None else {}
|
||||
|
||||
@@ -475,10 +487,20 @@ class FakeFTP:
|
||||
raise ftplib.error_perm("550 No such file")
|
||||
callback(self.files[path])
|
||||
|
||||
# 카페24 디자인 FTP 는 허용 확장자만 받는다(실물: `x.js.cf24tmp-…` STOR → 550).
|
||||
ALLOWED_EXT = (".js", ".html", ".htm", ".css", ".json", ".txt", ".xml",
|
||||
".jpg", ".jpeg", ".gif", ".png", ".svg", ".webp")
|
||||
|
||||
@classmethod
|
||||
def _check_ext(cls, path):
|
||||
if not path.lower().endswith(cls.ALLOWED_EXT):
|
||||
raise ftplib.error_perm(f"550 {path}: Operation not permitted")
|
||||
|
||||
def storbinary(self, cmd, fp):
|
||||
path = cmd.split(" ", 1)[1]
|
||||
data = fp.read()
|
||||
FakeFTP.log.append(("STOR", path))
|
||||
self._check_ext(path)
|
||||
self.files[path] = data[: len(data) // 2] if FakeFTP.truncate_store else data
|
||||
|
||||
def rename(self, src, dst):
|
||||
@@ -490,6 +512,7 @@ class FakeFTP:
|
||||
raise ftplib.error_perm("502 RNFR not implemented")
|
||||
if src not in self.files:
|
||||
raise ftplib.error_perm("550 No such file")
|
||||
self._check_ext(dst)
|
||||
if dst in self.files and FakeFTP.rename_mode == "no_overwrite":
|
||||
raise ftplib.error_perm("553 File exists")
|
||||
self.files[dst] = self.files.pop(src)
|
||||
|
||||
@@ -649,6 +649,9 @@ def test_describe_schedule_action():
|
||||
assert store.describe_schedule_action(
|
||||
has_html=False, set_display=None, set_selling=None
|
||||
) == "없음"
|
||||
assert store.describe_schedule_action(
|
||||
has_html=True, set_display=None, set_selling=None, has_image=True
|
||||
) == "대표이미지 · 상세페이지"
|
||||
|
||||
|
||||
def test_normalize_schedule_status():
|
||||
@@ -746,7 +749,7 @@ def test_design_ftp_read_and_write_roundtrip():
|
||||
assert design_ftp.read_text_file(_FTP_CFG, _SWIPER) == "new content"
|
||||
# 원본에 직접 STOR 하지 않는다 — 임시 파일에 올린 뒤 이름 바꾸기로 교체
|
||||
stors = [e for e in ftp.log if e[0] == "STOR"]
|
||||
assert stors and all(".cf24tmp-" in e[1] for e in stors), ftp.log
|
||||
assert stors and all("_cf24tmp_" in e[1] and e[1].endswith(".js") for e in stors), ftp.log
|
||||
assert any(e[0] == "RENAME" and e[2] == _SWIPER for e in ftp.log)
|
||||
# 임시 파일이 남지 않는다
|
||||
assert set(ftp.files) == {_SWIPER}
|
||||
@@ -1083,6 +1086,22 @@ def test_resolve_description_accepts_iso_created_at():
|
||||
assert (html, state) == ("NEW", store.SYNC_PENDING)
|
||||
|
||||
|
||||
def test_parse_shop_nos():
|
||||
assert store.parse_shop_nos(None) == [1]
|
||||
assert store.parse_shop_nos("2, 3,1,x,0,3") == [1, 2, 3]
|
||||
|
||||
|
||||
def test_plan_flag_sync():
|
||||
from app.modules.cafe24.sync_variant_flags import plan_flag_sync
|
||||
|
||||
base = [{"variant_code": "A", "display": True, "selling": False},
|
||||
{"variant_code": "B", "display": True, "selling": True},
|
||||
{"variant_code": "C", "display": False, "selling": False}]
|
||||
shop = [{"variant_code": "A", "display": "F", "selling": "F"},
|
||||
{"variant_code": "B", "display": "T", "selling": "T"}] # C 는 그 쇼핑몰에 없음
|
||||
assert plan_flag_sync(base, shop) == [{"variant_code": "A", "display": "T"}]
|
||||
|
||||
|
||||
def test_parse_grace_minutes():
|
||||
assert store.parse_grace_minutes("30") == 30
|
||||
assert store.parse_grace_minutes("") == store.DEFAULT_READ_LAG_GRACE_MIN
|
||||
@@ -1127,6 +1146,71 @@ def test_product_snapshot_keeps_only_scalar_fields():
|
||||
assert snap == {"product_name": "A", "price": "1.00", "display": "T"}
|
||||
|
||||
|
||||
def test_overlay_same_updated_date_but_different_flags_is_lag():
|
||||
# 카페24는 진열/판매만 바꾼 PUT 에서 updated_date 를 안 올릴 수 있다 — 같은 시각에 값이
|
||||
# 다르면 지연이다(예전엔 "같다 = 따라잡음"으로 봐서 바꾼 진열/판매가 되돌아 보였다).
|
||||
fetched = {"display": "T", "selling": "T", "updated_date": "2026-09-18T10:00:00+09:00"}
|
||||
snap = {"display": "F", "selling": "T", "updated_date": "2026-09-18T10:00:00+09:00"}
|
||||
merged, stale = store.overlay_recent_write(fetched, snapshot=snap, written_at=now_kst(), grace_minutes=60)
|
||||
assert stale is True and merged["display"] == "F"
|
||||
|
||||
|
||||
def test_overlay_same_updated_date_and_same_values_is_caught_up():
|
||||
fetched = {"display": "F", "price": "1.00", "updated_date": "2026-09-18T10:00:00+09:00"}
|
||||
snap = {"display": "F", "price": "1.00", "updated_date": "2026-09-18T10:00:00+09:00"}
|
||||
merged, stale = store.overlay_recent_write(fetched, snapshot=snap, written_at=now_kst(), grace_minutes=60)
|
||||
assert stale is False and merged is fetched
|
||||
|
||||
|
||||
def test_overlay_product_rows_fixes_lagging_list():
|
||||
rows = [
|
||||
{"product_no": 1, "display": "T", "selling": "T", "updated_date": "2026-09-18T10:00:00+09:00"},
|
||||
{"product_no": 2, "display": "T", "selling": "T", "updated_date": "2026-09-18T10:00:00+09:00"},
|
||||
]
|
||||
snaps = {1: {"data": {"display": "T", "selling": "F", "updated_date": "2026-09-18T10:00:00+09:00"},
|
||||
"written_at": now_kst().isoformat()}}
|
||||
out = store.overlay_product_rows(rows, snaps, grace_minutes=60)
|
||||
assert out[0]["selling"] == "F"
|
||||
assert out[1] is rows[1]
|
||||
assert store.overlay_product_rows(rows, {}, grace_minutes=60) is rows
|
||||
|
||||
|
||||
def test_status_toggle_survives_read_lag_without_updated_date_bump():
|
||||
"""진열/판매 배지 → PUT → 다시 열어도(단건·목록) 바꾼 값이 보인다.
|
||||
|
||||
실물 재현 조건: PUT 이 updated_date 를 올리지 않고, GET 은 한동안 예전 값을 준다.
|
||||
"""
|
||||
from app.modules.cafe24 import routes_products
|
||||
|
||||
st = fakes.MemoryStore()
|
||||
cafe = fakes.FakeCafe24()
|
||||
api = fakes.FakeApi(cafe)
|
||||
cafe._tick = lambda: None # 진열/판매만 바꾸면 updated_date 그대로
|
||||
cafe.stale = dict(cafe.state) # GET 은 바꾸기 전 값(읽기 지연)
|
||||
orig = (routes_products.require_store, routes_products.build_cafe24_api)
|
||||
routes_products.require_store = lambda request: (st, {"email": "a@b.c"})
|
||||
routes_products.build_cafe24_api = lambda _st: api
|
||||
try:
|
||||
res = routes_products.product_status(None, 131, {"field": "selling", "value": False})
|
||||
assert res == {"ok": True, "display": True, "selling": False}
|
||||
assert cafe.state["selling"] == "F"
|
||||
assert cafe.puts()[-1][2]["request"] == {"selling": "F"}
|
||||
|
||||
product, stale = routes_products.load_product(st, api, 131)
|
||||
assert stale is True and products.normalize_product(product)["selling"] is False
|
||||
|
||||
rows = store.overlay_product_rows(
|
||||
[dict(cafe.stale)], st.get_recent_product_snapshots(60), grace_minutes=60
|
||||
)
|
||||
assert products.normalize_product(rows[0])["selling"] is False
|
||||
|
||||
# 다시 켜기 — 값은 요청한 결과값 그대로(뒤집기 아님)
|
||||
res = routes_products.product_status(None, 131, {"field": "selling", "value": True})
|
||||
assert res["selling"] is True and cafe.state["selling"] == "T"
|
||||
finally:
|
||||
routes_products.require_store, routes_products.build_cafe24_api = orig
|
||||
|
||||
|
||||
# ════════════════════════════════════════════════════════════
|
||||
# 기본 정보 · 옵션 · 품목 입력 검증
|
||||
# ════════════════════════════════════════════════════════════
|
||||
@@ -1196,21 +1280,18 @@ def test_build_update_options_request_rejects_count_mismatch():
|
||||
pass
|
||||
else:
|
||||
raise AssertionError(edited)
|
||||
# 덧붙이기는 allow_append 일 때만
|
||||
# 덧붙이기 거부 — 카페24 PUT 은 옵션값 추가를 무시한다(저장 후 사라짐). 재생성으로 안내.
|
||||
more = [{"option_name": "A", "option_value": [{"option_text": "1"}, {"option_text": "2", "option_image_file": "https://d/2.png"}]}]
|
||||
try:
|
||||
store.build_update_options_request(original, more)
|
||||
except ValueError:
|
||||
pass
|
||||
except ValueError as exc:
|
||||
assert "옵션 재생성" in str(exc)
|
||||
else:
|
||||
raise AssertionError("append without flag accepted")
|
||||
body = store.build_update_options_request(original, more, allow_append=True)
|
||||
assert body["original_options"][0]["option_value"] == [{"option_text": "1"}]
|
||||
assert body["options"][0]["option_value"] == [{"option_text": "1"}, {"option_text": "2", "option_image_file": "https://d/2.png"}]
|
||||
# 줄이기는 allow_append 여도 거부 (위치 짝맞춤으로 이름이 밀린다)
|
||||
raise AssertionError("append accepted")
|
||||
# 줄이기도 거부 (위치 짝맞춤으로 이름이 밀린다)
|
||||
two = [{"option_name": "A", "option_value": [{"option_text": "1"}, {"option_text": "2"}]}]
|
||||
try:
|
||||
store.build_update_options_request(two, original, allow_append=True)
|
||||
store.build_update_options_request(two, original)
|
||||
except ValueError:
|
||||
pass
|
||||
else:
|
||||
|
||||
@@ -50,6 +50,7 @@ from app.timezone import now_kst
|
||||
|
||||
from . import store, writes
|
||||
from .common import read_lag_grace_minutes
|
||||
from .routes_products import load_product
|
||||
|
||||
logger = logging.getLogger("cafe24.worker")
|
||||
|
||||
@@ -77,9 +78,28 @@ def _summary(row: dict[str, Any]) -> str:
|
||||
has_html=bool(row.get("revision_id")),
|
||||
set_display=row.get("set_display"),
|
||||
set_selling=row.get("set_selling"),
|
||||
has_image=bool(row.get("image_type")),
|
||||
)
|
||||
|
||||
|
||||
def _apply_image(st: Any, api: Any, product_no: int, data: bytes, content_type: str) -> str:
|
||||
"""예약 대표 이미지 교체(routes_product_info.product_image 와 같은 순서). 반환: 새 detail_image.
|
||||
|
||||
상세페이지·진열/판매보다 **먼저** 한다 — 뒤 단계가 실패해 재시도되면 같은 이미지를 한 번 더
|
||||
올릴 뿐이라 안전하고, 앞 단계(시도 기록)가 SUCCESS 로 복구된 뒤 이미지가 빠지는 일이 없다.
|
||||
"""
|
||||
current, _ = load_product(st, api, product_no)
|
||||
if not current:
|
||||
raise Cafe24Error("카페24에서 상품을 찾지 못했습니다.")
|
||||
images = products.set_main_image(api.client, product_no, data, content_type=content_type)
|
||||
if not images.get("detail_image"):
|
||||
raise Cafe24Error("카페24가 등록된 이미지 경로를 돌려주지 않았습니다.")
|
||||
writes.remember_product_write(
|
||||
st, product_no, {**current, **images, "updated_date": now_kst().isoformat(timespec="seconds")}
|
||||
)
|
||||
return str(images["detail_image"])
|
||||
|
||||
|
||||
def _retry_or_fail(st: Any, row: dict[str, Any], token: str, error: str) -> str:
|
||||
"""재시도 예산 안이면 PENDING + 대기, 아니면 FAILED. 반환: 결과 상태."""
|
||||
retry_count = int(row.get("retry_count") or 0)
|
||||
@@ -113,6 +133,8 @@ def run_one(st: Any, api: Any, row: dict[str, Any]) -> str:
|
||||
def fence() -> bool:
|
||||
return bool(st.renew_schedule_lease(schedule_id, token, ttl_seconds=lease))
|
||||
|
||||
image_type = str(row.get("image_type") or "")
|
||||
new_image = ""
|
||||
try:
|
||||
html: str | None = None
|
||||
if revision_id:
|
||||
@@ -122,17 +144,26 @@ def run_one(st: Any, api: Any, row: dict[str, Any]) -> str:
|
||||
html = str(revision.get("html_content") or "")
|
||||
if not html.strip():
|
||||
raise Cafe24Error(f"버전 {revision_id} 의 내용이 비어 있습니다.")
|
||||
image = st.get_schedule_image(schedule_id) if image_type else b""
|
||||
if image_type and not image:
|
||||
raise Cafe24Error("예약해 둔 대표 이미지 파일을 찾을 수 없습니다.")
|
||||
with writes.write_lock(
|
||||
st, writes.product_lock_key(product_no), actor=ACTOR,
|
||||
purpose=f"예약 #{schedule_id} 실행", wait_seconds=0,
|
||||
) as lock:
|
||||
outcome = writes.write_product(
|
||||
st, api, product_no,
|
||||
lock=lock, origin=store.ORIGIN_SCHEDULED, actor=ACTOR, html=html,
|
||||
set_display=set_display, set_selling=set_selling,
|
||||
schedule_id=schedule_id, target_revision_id=int(revision_id) if revision_id else None,
|
||||
memo=f"예약 #{schedule_id} 적용", extra_fence=fence,
|
||||
)
|
||||
if image:
|
||||
if not fence():
|
||||
raise writes.WriteBusy("예약 lease 를 잃었습니다 — 다른 worker 가 처리합니다.")
|
||||
new_image = _apply_image(st, api, product_no, image, image_type)
|
||||
outcome = writes.WriteOutcome()
|
||||
if html is not None or set_display is not None or set_selling is not None:
|
||||
outcome = writes.write_product(
|
||||
st, api, product_no,
|
||||
lock=lock, origin=store.ORIGIN_SCHEDULED, actor=ACTOR, html=html,
|
||||
set_display=set_display, set_selling=set_selling,
|
||||
schedule_id=schedule_id, target_revision_id=int(revision_id) if revision_id else None,
|
||||
memo=f"예약 #{schedule_id} 적용", extra_fence=fence,
|
||||
)
|
||||
except writes.WriteSetupError as exc:
|
||||
st.finish_schedule(schedule_id, token=token, status=store.STATUS_PENDING, error=str(exc),
|
||||
next_retry_at=now_kst() + timedelta(seconds=SETUP_RETRY_SECONDS))
|
||||
@@ -171,6 +202,7 @@ def run_one(st: Any, api: Any, row: dict[str, Any]) -> str:
|
||||
revision_id=outcome.revision_id or (int(revision_id) if revision_id else None),
|
||||
schedule_id=schedule_id, result="SUCCESS",
|
||||
detail=summary + (f" (백업 {outcome.backup_id})" if outcome.backup_id else "")
|
||||
+ (f" / 대표이미지 → '{new_image}'" if new_image else "")
|
||||
+ (f" / {note}" if note else ""),
|
||||
)
|
||||
logger.info("예약 #%s 상품 %s 적용 완료 — %s", schedule_id, product_no, summary)
|
||||
|
||||
@@ -232,6 +232,9 @@ def resolve_effective(
|
||||
# ════════════════════════════════════════════════════════════
|
||||
def remember_product_write(st: Any, product_no: int, updated: dict[str, Any]) -> tuple[dict[str, Any], str]:
|
||||
"""PUT 응답(상품 dict)을 캐시·스냅샷에 남긴다. (정규화된 상품 행, 기록 오류 문자열)."""
|
||||
if updated and not updated.get("product_no"):
|
||||
# 응답에 상품번호가 빠져도 기록은 남긴다 — 안 남기면 지연 보정이 안 돼 예전 값이 보인다.
|
||||
updated = {**updated, "product_no": int(product_no)}
|
||||
info = products.normalize_product(updated) if updated else {}
|
||||
if not info.get("product_no"):
|
||||
return info, ""
|
||||
|
||||
@@ -0,0 +1,76 @@
|
||||
# [쿠팡] 쿠팡 밀크런 모듈 — `app/modules/cupang/`, `cupang_db`
|
||||
|
||||
> 이 모듈만 고칠 때 읽는 요약. 별도 상세 문서 없음 — 이 파일이 기준.
|
||||
> 정적 파일: `app/static/cupang.css`, `app/static/cupang.js`. 템플릿: `templates/`.
|
||||
> 상품은 `itemcode_db` 읽기 전용(`itemcode.py`).
|
||||
|
||||
## 출고 달력 / 상자 계산
|
||||
|
||||
- 출고 달력·상자 계산이 중심.
|
||||
- 출고 묶음은 **상자 계산 화면의 [분배 확정] 으로만** 만든다. 신규 등록 폼 없음, `/cupang/new` 는 상자 계산으로 리다이렉트.
|
||||
- 확정 조건: 미배분 상자 0 + 담긴 센터마다 출고방식(택배/파렛트) 선택.
|
||||
- 확정 시 센터마다 출고 묶음 1건(`status=출고준비`, 센터입고일 = 출고일 + 1일).
|
||||
- 상자 구성은 `cupang_shipments.box_plan` JSONB 에 스냅샷(혼합 상자 내용물·상자 종류 표시용).
|
||||
- 출고리스트 엑셀 자동 다운로드(`GET /cupang/export.xlsx?date=`, 시트명 YYYYMMDD).
|
||||
- 양식 생성은 `export.py` 한 곳에서 만들어 xlsx·구글시트가 공유.
|
||||
- 작업 중 상태는 `cupang_box_calc_drafts` 에 이름 붙여 임시 저장/불러오기.
|
||||
|
||||
## 출고리스트 문서 동기화 (드라이브 엑셀 파일)
|
||||
|
||||
- 출고리스트 문서는 **구글 드라이브에 올린 .xlsx 파일**(`CUPANG_SHEET_ID`, 기본 `router.DEFAULT_SHEET_ID`
|
||||
= `1J74op7lBZOgE27p4R28I3RWsv0EtXdii`). `router._sheet_target` 이 드라이브에서 형식을 보고 writer 를 고른다:
|
||||
- .xlsx → `app/integrations/drive_xlsx.py` — 내려받아 openpyxl 로 고친 뒤 같은 파일 id 에 다시 올림
|
||||
(인증은 google_drive 와 같음: 서비스 계정 또는 `GOOGLE_SLIDES_OAUTH_REFRESH_TOKEN`/`GOOGLE_SHEETS_OAUTH_REFRESH_TOKEN`, Drive 권한).
|
||||
`with writer.lock:` 블록 = 내려받기 1번·올리기 1번. 올리기 직전 version 이 바뀌었으면(누가 고침) `_in_sheet` 가 처음부터 다시(3번).
|
||||
- 구글 시트 문서 → 예전처럼 `google_sheets.py`(Sheets API). 드라이브 인증이 없을 때도 이쪽.
|
||||
- 엑셀은 openpyxl 로 다시 저장하므로 파일 안 그림·차트는 사라진다(출고리스트에는 없음).
|
||||
- 인증이 없으면 조용히 skip. 확정과 동시에 출고일 시트를 생성/덮어쓰기.
|
||||
- 출고 삭제(건별/날짜 전체) 시에도 같은 날짜 시트 동기화 — 남은 출고가 있으면 다시 쓰고, 없으면 시트 삭제
|
||||
(문서에 시트가 하나뿐이면 내용만 비움).
|
||||
|
||||
## 제품 포장무게
|
||||
|
||||
- 설정(제품명)에서 제품별 포장무게(g, `cupang_products.weight_g`, 마이그레이션 007 + 시드) 입력·표시·정렬.
|
||||
- 출고 상세 상자 목록에 상자별 무게 합계(수량 × 지금 포장무게, `router._attach_box_weights`).
|
||||
- 무게 없는 제품은 "일부 미입력".
|
||||
- 화면은 kg 소수 첫째 자리 사사오입(`router._g_to_kg`) + 맨 아래 수량·무게 합계 행(앞 3열 병합).
|
||||
- 표 칸 모두 가운데 정렬, 요약 카드와 20px 간격.
|
||||
- 상자 목록 엑셀에도 무게(g) 열.
|
||||
|
||||
## 쿠팡 발주 엑셀 업로드
|
||||
|
||||
- 다중 업로드(`POST /cupang/api/box-calc/upload`, openpyxl).
|
||||
- F13 입고예정일의 하루 전 = 출고일.
|
||||
- 22행부터 B=쿠팡상품코드·F=센터명·G=수량을 읽어 `cupang_products.coupang_item_code` 로 제품 매칭 → 센터별 합산
|
||||
→ 센터 단위로 상자 계산·자동 배분.
|
||||
|
||||
## 쿠팡 로켓 매출 (`/cupang/sales`)
|
||||
|
||||
- 테이블 `cupang_sales`·`cupang_sales_weekly`. 발주 라인별 공급가·원가·물류비·마진 표.
|
||||
- 기간/센터/유형/검색 조회, 행 CRUD, 엑셀 다운로드.
|
||||
- 구글 시트 양식 xlsx·csv 업로드(`sales_import.py`) — 같은 발주번호+SKU+출고일+센터+수량은 덮어씀.
|
||||
- 광고비·할인 프로모션·장려금은 주차 단위(`cupang_sales_weekly`)로 보관, 순마진은 화면에서 계산.
|
||||
- 초기 데이터는 `scripts/sql/cupang_sales_seed.sql`.
|
||||
|
||||
## 밀크런 출고리스트 작성 (팝업 → 드라이브 엑셀 파일, 2026-10-23)
|
||||
|
||||
- 첫 화면 "+ 신규 등록" 옆 엑셀색(#217346) 버튼 → 팝업(`index.html` + `static/cupang-outbound.js`).
|
||||
팝업 높이 850px 고정(화면이 낮으면 화면 - 32px), 넘치면 팝업 안 스크롤, [취소]·[완료] 줄은 맨 아래(`.cpg-ol-box`).
|
||||
상자 계산 없이 입고센터 여러 곳을 한 번에 **출고리스트 엑셀 파일에만** 적는다 — cupang_db 출고 묶음은 만들지 않는다(달력에 안 보임).
|
||||
- 대상 파일은 `router._outbound_target` — `CUPANG_OUTBOUND_XLSX_ID`(기본 `DEFAULT_OUTBOUND_XLSX_ID` = `1J74op7lBZOgE27p4R28I3RWsv0EtXdii`),
|
||||
항상 `drive_xlsx`. `CUPANG_SHEET_ID`(분배 확정 동기화)와 따로라 그게 구글 시트 문서여도 팝업은 엑셀에만 쓴다.
|
||||
드라이브 인증이 없거나 파일이 .xlsx 가 아니면 구글 시트로 대신 쓰지 않고 503(사유 표시).
|
||||
- 공통 입력: 작성일(기본 오늘)·출고일·센터입고일(출고일 고르면 +1일 자동)·작업자(기본 `export.WORKER`) — 날짜 칸은 프로젝트 날짜 팝업
|
||||
(`PJLib.enhanceDateInput`, project.js 를 `PJ_LIB_ONLY` 로 로드).
|
||||
- **입고센터 카드**(`#cpg-ol-center-tpl`, [+ 입고센터 추가]·[센터 삭제], 최대 20곳): 센터마다 입고센터(시트 F열 + 등록 센터, 직접 입력 가능),
|
||||
출고방식(**기본 택배**/파렛트), 제품(코드표 `GET /cupang/api/products/all` 검색 → 코드·이름 자동, 수량 수기), 출고(수기).
|
||||
카드 배경색은 센터마다 다르다(JS `recolor` → `data-tone` 0~7, 팝업에 나온 순서대로 배정·같은 센터는 같은 색·미선택은 회색, 색은 cupang.css).
|
||||
- `POST /cupang/api/outbound-sheet` 본문 `{document_date, ship_date, center_arrival_date, worker, centers: [{center, ship_method, outbound, lines}]}`
|
||||
(`centers` 없으면 본문 자체가 센터 1곳 — `_clean_outbound_entries`). 센터 순서대로 시트 `YYYYMMDD(요일)`(출고일) 맨 아래에
|
||||
`export.build_block` 으로 덧붙임(순번 B열 이어짐, 파렛트 센터만 배경색). 시트가 없거나 5행 머리글이 없으면 첫 센터는 양식째 새로 쓴다(`write_table`).
|
||||
전체가 `writer.lock` 한 덩어리 = 엑셀 내려받기 1번·올리기 1번(`_run_outbound_write`). 입고센터 후보는 `GET /cupang/api/outbound-sheet/centers`(10분 캐시).
|
||||
- **진행 막대**: 팝업은 `?stream=1` 로 보내고 서버가 NDJSON 한 줄씩 `{progress, until, step}`(5 내려받기 → 40~80 센터별 추가 → 80 올리기)
|
||||
… 마지막 `{done: true, ...결과}` 또는 `{error}`. 쓰기는 별도 스레드(잠금은 잡은 스레드에서 풀어야 함)가 하고 큐로 넘긴다.
|
||||
화면은 단계 사이에도 다음 단계(until) 바로 앞까지 조금씩 채우고 %를 같이 표시, 실패면 빨강. 입력 오류(400)·설정 없음(503)은 스트림 전 보통 JSON.
|
||||
- 주의: 같은 출고일에 [분배 확정]·출고 삭제가 일어나면 기존 동기화가 그 날짜 시트를 DB 기준으로 **통째로 다시 써서**
|
||||
팝업으로 적은 줄이 사라진다.
|
||||
@@ -94,37 +94,15 @@ def build_table(ship_date: str, shipments: list[dict[str, Any]]) -> dict[str, An
|
||||
row = FIRST_DATA_ROW
|
||||
seq = 0
|
||||
for sh in shipments:
|
||||
lines = sh.get("lines") or []
|
||||
if not lines:
|
||||
block = build_block(sh, start_row=row, start_seq=seq)
|
||||
if block is None:
|
||||
continue
|
||||
start = row
|
||||
for ln in lines:
|
||||
seq += 1
|
||||
cells[(row, 2)] = seq
|
||||
cells[(row, 8)] = ln.get("product_code") or ""
|
||||
cells[(row, 9)] = ln.get("product_name_snapshot") or ""
|
||||
cells[(row, 10)] = int(ln.get("quantity") or 0)
|
||||
row += 1
|
||||
end = row - 1
|
||||
|
||||
method = sh.get("ship_method") or ""
|
||||
if method == PALLET_METHOD:
|
||||
pallet_ranges.append((start, end))
|
||||
|
||||
block = {
|
||||
# 날짜는 요일까지 표기 — 2026-09-03(목)
|
||||
3: with_dow(str(sh.get("document_date") or "")),
|
||||
4: with_dow(str(sh.get("ship_date") or "")),
|
||||
5: with_dow(str(sh.get("center_arrival_date") or "")),
|
||||
6: sh.get("center_name_snapshot") or "",
|
||||
7: method,
|
||||
11: sh.get("outbound_summary") or "",
|
||||
12: WORKER,
|
||||
}
|
||||
for col in MERGE_COLS:
|
||||
cells[(start, col)] = block[col]
|
||||
if end > start:
|
||||
merges.append((start, col, end, col))
|
||||
cells.update(block["cells"])
|
||||
merges.extend(block["merges"])
|
||||
if block["is_pallet"]:
|
||||
pallet_ranges.append((block["first_row"], block["last_row"]))
|
||||
row = block["last_row"] + 1
|
||||
seq = block["last_seq"]
|
||||
|
||||
return {
|
||||
"title": title,
|
||||
@@ -135,6 +113,53 @@ def build_table(ship_date: str, shipments: list[dict[str, Any]]) -> dict[str, An
|
||||
}
|
||||
|
||||
|
||||
def build_block(sh: dict[str, Any], *, start_row: int, start_seq: int) -> dict[str, Any] | None:
|
||||
"""출고 묶음(센터) 1건 → start_row 부터 품목 1줄 = 1행. 품목이 없으면 None.
|
||||
|
||||
build_table(시트 전체)과 출고리스트 직접 작성(기존 시트 아래에 덧붙임)이 같이 쓴다.
|
||||
순번(B열)은 start_seq 다음 번호부터 이어진다.
|
||||
"""
|
||||
lines = sh.get("lines") or []
|
||||
if not lines:
|
||||
return None
|
||||
cells: dict[tuple[int, int], Any] = {}
|
||||
merges: list[tuple[int, int, int, int]] = []
|
||||
row, seq = start_row, start_seq
|
||||
for ln in lines:
|
||||
seq += 1
|
||||
cells[(row, 2)] = seq
|
||||
cells[(row, 8)] = ln.get("product_code") or ""
|
||||
cells[(row, 9)] = ln.get("product_name_snapshot") or ""
|
||||
cells[(row, 10)] = int(ln.get("quantity") or 0)
|
||||
row += 1
|
||||
end = row - 1
|
||||
|
||||
method = sh.get("ship_method") or ""
|
||||
block = {
|
||||
# 날짜는 요일까지 표기 — 2026-09-03(목)
|
||||
3: with_dow(str(sh.get("document_date") or "")),
|
||||
4: with_dow(str(sh.get("ship_date") or "")),
|
||||
5: with_dow(str(sh.get("center_arrival_date") or "")),
|
||||
6: sh.get("center_name_snapshot") or "",
|
||||
7: method,
|
||||
11: sh.get("outbound_summary") or "",
|
||||
12: sh.get("worker") or WORKER,
|
||||
}
|
||||
for col in MERGE_COLS:
|
||||
cells[(start_row, col)] = block[col]
|
||||
if end > start_row:
|
||||
merges.append((start_row, col, end, col))
|
||||
|
||||
return {
|
||||
"cells": cells,
|
||||
"merges": merges,
|
||||
"first_row": start_row,
|
||||
"last_row": end,
|
||||
"last_seq": seq,
|
||||
"is_pallet": method == PALLET_METHOD,
|
||||
}
|
||||
|
||||
|
||||
def build_workbook(ship_date: str, shipments: list[dict[str, Any]]) -> Any:
|
||||
"""xlsx 워크북(openpyxl). 시트명 = YYYYMMDD(요일)."""
|
||||
from openpyxl import Workbook
|
||||
|
||||
+395
-33
@@ -22,6 +22,7 @@ from app.timezone import today_kst
|
||||
from fastapi import APIRouter, Body, Depends, File, Form, HTTPException, Request, UploadFile
|
||||
from fastapi.responses import HTMLResponse, JSONResponse, RedirectResponse
|
||||
|
||||
from .export import WORKER as OUTBOUND_WORKER
|
||||
from .holidays import holiday_name, is_holiday
|
||||
from .store import SHIP_METHODS, parse_weight_g
|
||||
|
||||
@@ -74,11 +75,11 @@ def _render_config_needed(request: Request, user: dict[str, Any]) -> HTMLRespons
|
||||
def _guard(request: Request) -> tuple[Any, dict[str, Any]] | HTMLResponse | RedirectResponse:
|
||||
"""로그인+권한+store 점검을 한 번에. 페이지 핸들러 진입부에서 사용."""
|
||||
from app.main import get_current_user_record, render_template # noqa: WPS433
|
||||
from app.store import has_module, is_admin # noqa: WPS433
|
||||
from app.store import has_module, is_admin, login_redirect # noqa: WPS433
|
||||
|
||||
user = get_current_user_record(request)
|
||||
if user is None:
|
||||
return RedirectResponse(url="/login", status_code=303)
|
||||
return login_redirect(request)
|
||||
if not has_module(user, "cupang"):
|
||||
return render_template(
|
||||
request,
|
||||
@@ -222,6 +223,7 @@ def index(request: Request) -> HTMLResponse:
|
||||
"months": months,
|
||||
"selected_date": sel,
|
||||
"sel_shipments": sel_shipments,
|
||||
"outbound_worker": OUTBOUND_WORKER,
|
||||
},
|
||||
)
|
||||
|
||||
@@ -243,21 +245,57 @@ def _shipments_for_date(store: Any, ship_date: str) -> list[dict[str, Any]]:
|
||||
return out
|
||||
|
||||
|
||||
# 출고리스트 문서 — 구글 드라이브에 올려 둔 엑셀(.xlsx) 파일(2026-10-23). 구글 시트 문서여도 된다.
|
||||
DEFAULT_SHEET_ID = "1J74op7lBZOgE27p4R28I3RWsv0EtXdii"
|
||||
|
||||
|
||||
def _sheet_target(store: Any) -> tuple[Any, str, dict[str, Any] | None]:
|
||||
"""(writer, spreadsheet_id, skip 사유) — 설정이 없으면 skip 정보를 돌려준다."""
|
||||
"""(writer, 문서 id, skip 사유) — 쓸 수 없으면 skip 정보를 돌려준다.
|
||||
|
||||
문서 형식은 드라이브에서 보고 고른다 — .xlsx 파일이면 drive_xlsx(내려받아 고친 뒤 다시 올림),
|
||||
구글 시트 문서면 google_sheets. 두 writer 는 같은 메서드를 갖는다."""
|
||||
import os # noqa: WPS433
|
||||
|
||||
from app.integrations.google_sheets import get_writer # noqa: WPS433
|
||||
from app.integrations import drive_xlsx, google_sheets # noqa: WPS433
|
||||
|
||||
spreadsheet_id = (os.getenv("CUPANG_SHEET_ID") or "").strip()
|
||||
if not spreadsheet_id:
|
||||
return None, "", {"ok": False, "skipped": True, "reason": "CUPANG_SHEET_ID 미설정"}
|
||||
writer = get_writer()
|
||||
spreadsheet_id = (os.getenv("CUPANG_SHEET_ID") or "").strip() or DEFAULT_SHEET_ID
|
||||
drive = drive_xlsx.get_writer()
|
||||
if not drive.enabled:
|
||||
# 드라이브 인증이 없으면 예전처럼 Sheets API 로(구글 시트 문서일 때만 된다)
|
||||
writer = google_sheets.get_writer()
|
||||
if not writer.enabled:
|
||||
return None, "", {"ok": False, "skipped": True, "reason": writer.reason}
|
||||
return writer, spreadsheet_id, None
|
||||
try:
|
||||
kind = drive.file_kind(spreadsheet_id)
|
||||
except Exception as exc: # noqa: BLE001 - 사유만(비밀값 없음)
|
||||
return None, "", {"ok": False, "skipped": True, "reason": str(exc) or type(exc).__name__}
|
||||
if kind == "xlsx":
|
||||
return drive, spreadsheet_id, None
|
||||
if kind != "sheets":
|
||||
return None, "", {"ok": False, "skipped": True, "reason": f"엑셀·구글 시트 파일이 아닙니다({kind})"}
|
||||
writer = google_sheets.get_writer()
|
||||
if not writer.enabled:
|
||||
return None, "", {"ok": False, "skipped": True, "reason": writer.reason}
|
||||
return writer, spreadsheet_id, None
|
||||
|
||||
|
||||
def _in_sheet(writer: Any, fn: Any) -> Any:
|
||||
"""`with writer.lock:` 안에서 fn() — 읽기~쓰기를 한 덩어리로.
|
||||
|
||||
엑셀 파일(drive_xlsx)은 내려받은 뒤 올리기 전에 누가 파일을 고쳤으면 처음부터 다시(최대 3번)."""
|
||||
from app.integrations.drive_xlsx import XlsxChangedError # noqa: WPS433
|
||||
|
||||
for attempt in range(3):
|
||||
try:
|
||||
with writer.lock:
|
||||
return fn()
|
||||
except XlsxChangedError:
|
||||
if attempt == 2:
|
||||
raise
|
||||
return None
|
||||
|
||||
|
||||
def _sync_google_sheet_after_delete(store: Any, ship_date: str) -> dict[str, Any]:
|
||||
"""출고 삭제 후 구글 시트를 현재 상태에 맞춘다.
|
||||
|
||||
@@ -275,7 +313,8 @@ def _sync_google_sheet_after_delete(store: Any, ship_date: str) -> dict[str, Any
|
||||
return _push_to_google_sheet(store, ship_date)
|
||||
|
||||
try:
|
||||
res = writer.delete_sheet(spreadsheet_id=spreadsheet_id, title=sheet_title(ship_date))
|
||||
res = _in_sheet(writer, lambda: writer.delete_sheet(spreadsheet_id=spreadsheet_id,
|
||||
title=sheet_title(ship_date)))
|
||||
except Exception as exc: # noqa: BLE001 - 사유만 남긴다
|
||||
return {"ok": False, "skipped": False, "reason": f"{type(exc).__name__}: {exc}"}
|
||||
return {"ok": True, "skipped": False, **res}
|
||||
@@ -291,17 +330,12 @@ def _log_sheet(action: str, ship_date: str, res: dict[str, Any]) -> None:
|
||||
|
||||
|
||||
def _push_to_google_sheet(store: Any, ship_date: str) -> dict[str, Any]:
|
||||
"""확정한 출고일을 Google 스프레드시트에 시트 1장으로 기록.
|
||||
"""확정한 출고일을 출고리스트 문서(드라이브 엑셀 또는 구글 시트)에 시트 1장으로 기록.
|
||||
|
||||
- 대상 스프레드시트: 환경변수 `CUPANG_SHEET_ID`
|
||||
- 인증: 서비스 계정(app/integrations/google_sheets.py). 미설정이면 조용히 skip.
|
||||
- 대상 문서: 환경변수 `CUPANG_SHEET_ID`(기본 DEFAULT_SHEET_ID), 형식은 `_sheet_target` 이 고른다.
|
||||
- 인증: 서비스 계정 또는 OAuth(app/integrations/drive_xlsx.py·google_sheets.py). 미설정이면 조용히 skip.
|
||||
- 실패해도 출고 묶음 저장은 이미 끝났으므로 예외를 밖으로 던지지 않는다.
|
||||
"""
|
||||
from .export import ( # noqa: WPS433
|
||||
COL_FIRST, COL_LAST, FIRST_DATA_ROW, HEADER_BG, HEADER_ROW, PALLET_BG,
|
||||
TITLE_ROW, WIDTHS_PX, build_table, sheet_title,
|
||||
)
|
||||
|
||||
writer, spreadsheet_id, skip = _sheet_target(store)
|
||||
if skip:
|
||||
return skip
|
||||
@@ -310,28 +344,356 @@ def _push_to_google_sheet(store: Any, ship_date: str) -> dict[str, Any]:
|
||||
if not shipments:
|
||||
return {"ok": False, "skipped": True, "reason": "해당 출고일의 출고 묶음 없음"}
|
||||
|
||||
table = build_table(ship_date, shipments)
|
||||
try:
|
||||
res = writer.write_table(
|
||||
spreadsheet_id=spreadsheet_id,
|
||||
title=sheet_title(ship_date),
|
||||
cells=table["cells"],
|
||||
merges=table["merges"],
|
||||
header_row=HEADER_ROW,
|
||||
first_data_row=FIRST_DATA_ROW,
|
||||
last_row=table["last_row"],
|
||||
first_col=COL_FIRST,
|
||||
last_col=COL_LAST,
|
||||
title_row=TITLE_ROW,
|
||||
widths=WIDTHS_PX,
|
||||
header_bg=HEADER_BG,
|
||||
row_highlights=[(r1, r2, PALLET_BG) for (r1, r2) in table["pallet_ranges"]],
|
||||
)
|
||||
res = _in_sheet(writer, lambda: _write_full_sheet(writer, spreadsheet_id, ship_date, shipments))
|
||||
except Exception as exc: # noqa: BLE001 - 시트 기록 실패는 경고로만 알린다
|
||||
return {"ok": False, "skipped": False, "reason": f"{type(exc).__name__}: {exc}"}
|
||||
return {"ok": True, "skipped": False, **res}
|
||||
|
||||
|
||||
def _write_full_sheet(
|
||||
writer: Any, spreadsheet_id: str, ship_date: str, shipments: list[dict[str, Any]]
|
||||
) -> dict[str, Any]:
|
||||
"""출고일 시트를 양식(1~5행)부터 통째로 다시 쓴다. 실패는 예외로 알린다."""
|
||||
from .export import ( # noqa: WPS433
|
||||
COL_FIRST, COL_LAST, FIRST_DATA_ROW, HEADER_BG, HEADER_ROW, PALLET_BG,
|
||||
TITLE_ROW, WIDTHS_PX, build_table, sheet_title,
|
||||
)
|
||||
|
||||
table = build_table(ship_date, shipments)
|
||||
res = writer.write_table(
|
||||
spreadsheet_id=spreadsheet_id,
|
||||
title=sheet_title(ship_date),
|
||||
cells=table["cells"],
|
||||
merges=table["merges"],
|
||||
header_row=HEADER_ROW,
|
||||
first_data_row=FIRST_DATA_ROW,
|
||||
last_row=table["last_row"],
|
||||
first_col=COL_FIRST,
|
||||
last_col=COL_LAST,
|
||||
title_row=TITLE_ROW,
|
||||
widths=WIDTHS_PX,
|
||||
header_bg=HEADER_BG,
|
||||
row_highlights=[(r1, r2, PALLET_BG) for (r1, r2) in table["pallet_ranges"]],
|
||||
)
|
||||
return {**res, "first_row": FIRST_DATA_ROW, "last_row": table["last_row"]}
|
||||
|
||||
|
||||
# ════════════════════════════════════════════════════════════
|
||||
# 밀크런 출고리스트 직접 작성 — 상자 계산 없이 팝업에서 입력한 센터 1곳을
|
||||
# 출고리스트 문서(드라이브 엑셀 파일)의 출고일 시트(YYYYMMDD(요일)) 맨 아래에 덧붙인다. cupang_db 에는 저장하지 않는다.
|
||||
# ════════════════════════════════════════════════════════════
|
||||
OUTBOUND_SHEET_METHODS: tuple[str, ...] = ("파렛트", "택배")
|
||||
_SHEET_CENTERS_TTL_SECONDS = 600
|
||||
_sheet_centers_cache: dict[str, Any] = {"at": 0.0, "sheet": "", "names": []}
|
||||
# 팝업이 쓰는 문서 — 항상 드라이브 엑셀(.xlsx) 파일. CUPANG_SHEET_ID(분배 확정 동기화)와 따로 둔다:
|
||||
# 서버의 CUPANG_SHEET_ID 가 구글 시트 문서를 가리켜도 팝업은 엑셀 파일에만 쓴다(구글 시트로 대신 쓰지 않음).
|
||||
DEFAULT_OUTBOUND_XLSX_ID = "1J74op7lBZOgE27p4R28I3RWsv0EtXdii"
|
||||
|
||||
|
||||
def _outbound_target() -> tuple[Any, str, dict[str, Any] | None]:
|
||||
"""(drive_xlsx writer, 엑셀 파일 id, skip 사유). 드라이브 인증이 없거나 .xlsx 가 아니면 skip."""
|
||||
import os # noqa: WPS433
|
||||
|
||||
from app.integrations import drive_xlsx # noqa: WPS433
|
||||
|
||||
file_id = (os.getenv("CUPANG_OUTBOUND_XLSX_ID") or "").strip() or DEFAULT_OUTBOUND_XLSX_ID
|
||||
writer = drive_xlsx.get_writer()
|
||||
if not writer.enabled:
|
||||
return None, "", {"ok": False, "skipped": True, "reason": writer.reason}
|
||||
try:
|
||||
kind = writer.file_kind(file_id)
|
||||
except Exception as exc: # noqa: BLE001 - 사유만(비밀값 없음)
|
||||
return None, "", {"ok": False, "skipped": True, "reason": str(exc) or type(exc).__name__}
|
||||
if kind != "xlsx":
|
||||
return None, "", {"ok": False, "skipped": True, "reason": f"출고리스트 파일이 엑셀(.xlsx)이 아닙니다({kind})"}
|
||||
return writer, file_id, None
|
||||
|
||||
|
||||
def _sheet_text(value: Any, *, label: str, max_len: int, required: bool = True) -> str:
|
||||
text = str(value or "").strip()
|
||||
if required and not text:
|
||||
raise HTTPException(status_code=400, detail=f"{label}을(를) 입력해 주세요.")
|
||||
if len(text) > max_len:
|
||||
raise HTTPException(status_code=400, detail=f"{label}은(는) {max_len}자까지 입력할 수 있습니다.")
|
||||
# USER_ENTERED 로 쓰므로 '=' 로 시작하면 수식이 된다 — 글자 그대로 남긴다.
|
||||
return "'" + text if text.startswith("=") else text
|
||||
|
||||
|
||||
def _sheet_date(value: Any, *, label: str) -> str:
|
||||
try:
|
||||
return _date.fromisoformat(str(value or "").strip()).isoformat()
|
||||
except ValueError:
|
||||
raise HTTPException(status_code=400, detail=f"{label}을(를) 선택해 주세요.") from None
|
||||
|
||||
|
||||
def _clean_outbound_entry(payload: dict[str, Any]) -> dict[str, Any]:
|
||||
"""팝업 입력 → export.build_block 이 읽는 출고 묶음 모양."""
|
||||
method = str(payload.get("ship_method") or "").strip()
|
||||
if method not in OUTBOUND_SHEET_METHODS:
|
||||
raise HTTPException(status_code=400, detail="출고방식은 파렛트 또는 택배 중에서 골라 주세요.")
|
||||
|
||||
raw_lines = payload.get("lines")
|
||||
if not isinstance(raw_lines, list) or not raw_lines:
|
||||
raise HTTPException(status_code=400, detail="제품을 1개 이상 추가해 주세요.")
|
||||
if len(raw_lines) > 100:
|
||||
raise HTTPException(status_code=400, detail="제품은 한 번에 100줄까지 입력할 수 있습니다.")
|
||||
lines = []
|
||||
for i, ln in enumerate(raw_lines, start=1):
|
||||
if not isinstance(ln, dict):
|
||||
raise HTTPException(status_code=400, detail=f"{i}번째 제품 정보를 확인해 주세요.")
|
||||
try:
|
||||
qty = int(str(ln.get("quantity") or "").replace(",", "").strip())
|
||||
except ValueError:
|
||||
qty = 0
|
||||
if not 1 <= qty <= 1_000_000:
|
||||
raise HTTPException(status_code=400, detail=f"{i}번째 제품의 수량을 확인해 주세요.")
|
||||
lines.append({
|
||||
"product_code": _sheet_text(ln.get("code"), label=f"{i}번째 제품코드", max_len=60),
|
||||
"product_name_snapshot": _sheet_text(ln.get("name"), label=f"{i}번째 제품명", max_len=200),
|
||||
"quantity": qty,
|
||||
})
|
||||
|
||||
return {
|
||||
"document_date": _sheet_date(payload.get("document_date"), label="작성일"),
|
||||
"ship_date": _sheet_date(payload.get("ship_date"), label="출고일"),
|
||||
"center_arrival_date": _sheet_date(payload.get("center_arrival_date"), label="센터입고일"),
|
||||
"center_name_snapshot": _sheet_text(payload.get("center"), label="입고센터", max_len=60),
|
||||
"ship_method": method,
|
||||
"outbound_summary": _sheet_text(payload.get("outbound"), label="출고", max_len=100, required=False),
|
||||
"worker": _sheet_text(payload.get("worker") or OUTBOUND_WORKER, label="작업자", max_len=30),
|
||||
"lines": lines,
|
||||
}
|
||||
|
||||
|
||||
def _sheet_centers(writer: Any, spreadsheet_id: str) -> list[str]:
|
||||
"""출고리스트 문서의 모든 시트 F열(입고센터, 6행부터)에 적힌 센터 이름. 10분 캐시."""
|
||||
import time # noqa: WPS433
|
||||
|
||||
from app.integrations.google_sheets import a1_sheet # noqa: WPS433
|
||||
|
||||
from .export import FIRST_DATA_ROW # noqa: WPS433
|
||||
|
||||
cache = _sheet_centers_cache
|
||||
if cache["sheet"] == spreadsheet_id and time.monotonic() - cache["at"] < _SHEET_CENTERS_TTL_SECONDS:
|
||||
return list(cache["names"])
|
||||
with writer.lock: # 엑셀 파일이면 한 번만 내려받는다
|
||||
titles = writer.sheet_titles(spreadsheet_id=spreadsheet_id)
|
||||
columns = writer.read_ranges(
|
||||
spreadsheet_id=spreadsheet_id,
|
||||
ranges=[f"{a1_sheet(t)}!F{FIRST_DATA_ROW}:F" for t in titles],
|
||||
)
|
||||
names = sorted({
|
||||
str(row[0]).strip() for rows in columns for row in rows if row and str(row[0]).strip()
|
||||
})
|
||||
cache.update(at=time.monotonic(), sheet=spreadsheet_id, names=names)
|
||||
return list(names)
|
||||
|
||||
|
||||
def _append_outbound_entry(writer: Any, spreadsheet_id: str, entry: dict[str, Any]) -> dict[str, Any]:
|
||||
"""출고일 시트 맨 아래에 덧붙인다. 시트가 없거나 양식(5행 머리글)이 없으면 양식째 만든다."""
|
||||
from app.integrations.google_sheets import a1_sheet, col_letter # noqa: WPS433
|
||||
|
||||
from .export import ( # noqa: WPS433
|
||||
COL_FIRST, COL_LAST, FIRST_DATA_ROW, HEADER_ROW, PALLET_BG, build_block, sheet_title,
|
||||
)
|
||||
|
||||
title = sheet_title(entry["ship_date"])
|
||||
rows: list[list[Any]] = []
|
||||
if title in writer.sheet_titles(spreadsheet_id=spreadsheet_id):
|
||||
rows = writer.read_ranges(
|
||||
spreadsheet_id=spreadsheet_id,
|
||||
ranges=[f"{a1_sheet(title)}!A1:{col_letter(COL_LAST)}"],
|
||||
)[0]
|
||||
last_row = max(
|
||||
(i for i, row in enumerate(rows, start=1) if any(str(v).strip() for v in row)), default=0
|
||||
)
|
||||
if last_row < HEADER_ROW:
|
||||
return _write_full_sheet(writer, spreadsheet_id, entry["ship_date"], [entry])
|
||||
|
||||
# 순번(B열)은 시트에 이미 있는 가장 큰 번호 다음부터
|
||||
last_seq = 0
|
||||
for row in rows[FIRST_DATA_ROW - 1:]:
|
||||
text = str(row[1]).strip() if len(row) > 1 else ""
|
||||
if text.isdigit():
|
||||
last_seq = max(last_seq, int(text))
|
||||
block = build_block(entry, start_row=last_row + 1, start_seq=last_seq)
|
||||
return writer.append_block(
|
||||
spreadsheet_id=spreadsheet_id,
|
||||
title=title,
|
||||
cells=block["cells"],
|
||||
merges=block["merges"],
|
||||
first_row=block["first_row"],
|
||||
last_row=block["last_row"],
|
||||
first_col=COL_FIRST,
|
||||
last_col=COL_LAST,
|
||||
highlight=PALLET_BG if block["is_pallet"] else "",
|
||||
)
|
||||
|
||||
|
||||
@router.get("/api/outbound-sheet/centers")
|
||||
def outbound_sheet_centers(
|
||||
request: Request, _: dict[str, Any] = Depends(_require_user)
|
||||
) -> JSONResponse:
|
||||
"""입고센터 후보 — 출고리스트 문서에 적힌 센터 + 설정에 등록된 센터."""
|
||||
store = _store(request)
|
||||
names = {c["name"] for c in store.list_centers()} if store else set()
|
||||
reason = ""
|
||||
writer, spreadsheet_id, skip = _outbound_target()
|
||||
if skip:
|
||||
reason = str(skip.get("reason") or "")
|
||||
else:
|
||||
try:
|
||||
names.update(_sheet_centers(writer, spreadsheet_id))
|
||||
except Exception as exc: # noqa: BLE001 - 목록은 등록 센터만으로도 쓸 수 있다
|
||||
reason = f"출고리스트 파일을 읽지 못했습니다({str(exc) or type(exc).__name__})"
|
||||
return JSONResponse({"centers": sorted(names), "reason": reason})
|
||||
|
||||
|
||||
_OUTBOUND_MAX_CENTERS = 20
|
||||
|
||||
|
||||
def _clean_outbound_entries(payload: dict[str, Any]) -> list[dict[str, Any]]:
|
||||
"""팝업 입력 → 입고센터마다 출고 묶음 1건.
|
||||
|
||||
공통(작성일·출고일·센터입고일·작업자) + `centers: [{center, ship_method, outbound, lines}]`.
|
||||
`centers` 가 없으면 payload 자체를 센터 1곳으로 본다."""
|
||||
raw = payload.get("centers")
|
||||
if raw is None:
|
||||
return [_clean_outbound_entry(payload)]
|
||||
if not isinstance(raw, list) or not raw:
|
||||
raise HTTPException(status_code=400, detail="입고센터를 1곳 이상 추가해 주세요.")
|
||||
if len(raw) > _OUTBOUND_MAX_CENTERS:
|
||||
raise HTTPException(status_code=400, detail=f"입고센터는 한 번에 {_OUTBOUND_MAX_CENTERS}곳까지 입력할 수 있습니다.")
|
||||
common = {k: payload.get(k) for k in ("document_date", "ship_date", "center_arrival_date", "worker")}
|
||||
entries = []
|
||||
for i, c in enumerate(raw, start=1):
|
||||
if not isinstance(c, dict):
|
||||
raise HTTPException(status_code=400, detail=f"{i}번째 입고센터 정보를 확인해 주세요.")
|
||||
try:
|
||||
entries.append(_clean_outbound_entry({**c, **common}))
|
||||
except HTTPException as exc:
|
||||
prefix = f"{i}번째 입고센터: " if len(raw) > 1 else ""
|
||||
raise HTTPException(status_code=exc.status_code, detail=prefix + str(exc.detail)) from None
|
||||
return entries
|
||||
|
||||
|
||||
def _run_outbound_write(
|
||||
writer: Any, file_id: str, entries: list[dict[str, Any]], report: Any
|
||||
) -> dict[str, Any]:
|
||||
"""센터들을 차례로 출고일 시트 아래에 덧붙인다(엑셀은 내려받기·올리기 1번씩).
|
||||
|
||||
report(진행률, 다음 단계 진행률, 단계 이름) 로 진행 상황을 알린다. 실패는 HTTPException(502)."""
|
||||
from app.integrations.drive_xlsx import XlsxChangedError # noqa: WPS433
|
||||
from app.integrations.google_drive import GoogleDriveError # noqa: WPS433
|
||||
|
||||
ship_date = entries[0]["ship_date"]
|
||||
n = len(entries)
|
||||
|
||||
def run() -> list[dict[str, Any]]:
|
||||
report(5, 40, "출고리스트 엑셀 내려받는 중")
|
||||
writer.sheet_titles(spreadsheet_id=file_id) # 이 덩어리에서 한 번 내려받는다
|
||||
done = []
|
||||
for i, entry in enumerate(entries):
|
||||
report(40 + 40 * i // n, 40 + 40 * (i + 1) // n,
|
||||
f"{entry['center_name_snapshot']} 추가 중 ({i + 1}/{n})")
|
||||
done.append(_append_outbound_entry(writer, file_id, entry))
|
||||
report(80, 100, "출고리스트 엑셀 올리는 중")
|
||||
return done
|
||||
|
||||
try:
|
||||
# 시트 끝 위치를 읽고 쓰는 사이에 다른 요청이 끼어들지 않게 한 덩어리로
|
||||
results = _in_sheet(writer, run)
|
||||
except Exception as exc: # noqa: BLE001 - 사유만 남긴다(비밀값 미출력)
|
||||
_log_sheet("manual-append", ship_date, {"ok": False, "reason": type(exc).__name__})
|
||||
if isinstance(exc, XlsxChangedError):
|
||||
why = "다른 사람이 파일을 고치는 중입니다"
|
||||
elif isinstance(exc, GoogleDriveError):
|
||||
why = str(exc)
|
||||
else:
|
||||
why = type(exc).__name__
|
||||
raise HTTPException(
|
||||
status_code=502, detail=f"출고리스트 파일에 기록하지 못했습니다({why}). 잠시 후 다시 시도해 주세요."
|
||||
) from exc
|
||||
|
||||
first, last = results[0], results[-1]
|
||||
_log_sheet("manual-append", ship_date,
|
||||
{"ok": True, "action": f"xlsx {file_id} centers {n} rows {first.get('first_row')}-{last.get('last_row')}"})
|
||||
if _sheet_centers_cache["sheet"] == file_id:
|
||||
_sheet_centers_cache["names"] = sorted(
|
||||
{*_sheet_centers_cache["names"], *(e["center_name_snapshot"] for e in entries)})
|
||||
return {
|
||||
"ok": True,
|
||||
"title": last.get("title"),
|
||||
"url": last.get("url"),
|
||||
"first_row": first.get("first_row"),
|
||||
"last_row": last.get("last_row"),
|
||||
"line_count": sum(len(e["lines"]) for e in entries),
|
||||
"centers": [
|
||||
{"center": e["center_name_snapshot"], "first_row": r.get("first_row"), "last_row": r.get("last_row"),
|
||||
"line_count": len(e["lines"])}
|
||||
for e, r in zip(entries, results)
|
||||
],
|
||||
}
|
||||
|
||||
|
||||
@router.post("/api/outbound-sheet")
|
||||
def outbound_sheet_write(
|
||||
request: Request,
|
||||
payload: dict[str, Any] = Body(...),
|
||||
stream: bool = False,
|
||||
_: dict[str, Any] = Depends(_require_user),
|
||||
) -> Any:
|
||||
"""출고리스트 엑셀에 센터들을 덧붙인다.
|
||||
|
||||
`?stream=1` 이면 한 줄에 JSON 하나씩(NDJSON) 진행 상황을 흘려보낸다 —
|
||||
`{"progress", "until", "step"}` … 마지막에 `{"done": true, ...결과}` 또는 `{"error": 사유}`.
|
||||
입력 오류(400)·설정 없음(503)은 흘려보내기 전에 보통 JSON 오류로 돌려준다."""
|
||||
entries = _clean_outbound_entries(payload)
|
||||
writer, file_id, skip = _outbound_target()
|
||||
if skip:
|
||||
_log_sheet("manual-append", entries[0]["ship_date"], skip)
|
||||
raise HTTPException(
|
||||
status_code=503, detail=f"출고리스트 엑셀 파일에 쓸 수 없습니다: {skip.get('reason') or '설정 확인 필요'}"
|
||||
)
|
||||
if not stream:
|
||||
return JSONResponse(_run_outbound_write(writer, file_id, entries, lambda *_a: None))
|
||||
|
||||
import queue # noqa: WPS433
|
||||
import threading # noqa: WPS433
|
||||
|
||||
from fastapi.responses import StreamingResponse # noqa: WPS433
|
||||
|
||||
events: Any = queue.Queue()
|
||||
|
||||
def work() -> None:
|
||||
# 잠금(writer.lock)은 잡은 스레드에서 풀어야 하므로 쓰기 전체를 스레드 하나에서
|
||||
try:
|
||||
res = _run_outbound_write(
|
||||
writer, file_id, entries,
|
||||
lambda p, until, step: events.put({"progress": p, "until": until, "step": step}),
|
||||
)
|
||||
events.put({"progress": 100, "until": 100, "step": "완료", "done": True, **res})
|
||||
except HTTPException as exc:
|
||||
events.put({"error": str(exc.detail)})
|
||||
except Exception as exc: # noqa: BLE001
|
||||
events.put({"error": f"출고리스트 파일에 기록하지 못했습니다({type(exc).__name__})."})
|
||||
finally:
|
||||
events.put(None)
|
||||
|
||||
threading.Thread(target=work, name="cupang-outbound-write", daemon=True).start()
|
||||
|
||||
def lines() -> Any:
|
||||
while True:
|
||||
item = events.get()
|
||||
if item is None:
|
||||
return
|
||||
yield json.dumps(item, ensure_ascii=False) + "\n"
|
||||
|
||||
return StreamingResponse(lines(), media_type="application/x-ndjson",
|
||||
headers={"Cache-Control": "no-cache", "X-Accel-Buffering": "no"})
|
||||
|
||||
|
||||
@router.get("/export.xlsx")
|
||||
def export_shipments_xlsx(request: Request, date: str = "") -> Any:
|
||||
"""출고일 기준 출고리스트 엑셀 다운로드. 시트명 = YYYYMMDD."""
|
||||
|
||||
@@ -1,6 +1,12 @@
|
||||
{% extends "erp_base.html" %}
|
||||
|
||||
{% block head_extra %}<link rel="stylesheet" href="/static/cupang.css?v=20261013b" />{% endblock %}
|
||||
{% block head_extra %}
|
||||
{# 출고리스트 작성 팝업의 날짜 칸은 프로젝트 화면의 날짜 팝업을 그대로 쓴다 — project.js 는 PJ_LIB_ONLY 로 부품만 #}
|
||||
<link rel="stylesheet" href="/static/project.css?v=20261111c" />
|
||||
<link rel="stylesheet" href="/static/vendor/material-symbols/material-symbols.css" />
|
||||
<link rel="stylesheet" href="/static/cupang.css?v=20261023d" />
|
||||
<script>window.PJ_LIB_ONLY = true; window.PJ_HOLIDAYS = {{ (pj_kr_holidays or {}) | tojson }};</script>
|
||||
{% endblock %}
|
||||
|
||||
{% block content %}
|
||||
<section class="cpg">
|
||||
@@ -9,6 +15,7 @@
|
||||
<div class="cpg-actions-grid">
|
||||
<div class="cpg-actions-main">
|
||||
<a class="erp-btn erp-btn-primary" href="/cupang/box-calc">+ 신규 등록</a>
|
||||
<button type="button" class="erp-btn cpg-btn-excel" id="cpg-ol-open">밀크런 출고리스트 작성</button>
|
||||
<span class="cpg-settings-btns">
|
||||
<a class="erp-btn erp-btn-outline cpg-sales-link" href="/cupang/sales">쿠팡 로켓 매출</a>
|
||||
<a class="erp-btn erp-btn-outline" href="/cupang/products">제품명 설정</a>
|
||||
@@ -168,10 +175,82 @@
|
||||
<input type="hidden" name="next" id="cpg-del-next" />
|
||||
</form>
|
||||
|
||||
<!-- 밀크런 출고리스트 작성 팝업 — 완료하면 출고리스트 엑셀(구글 드라이브 .xlsx) 출고일 시트 아래에 덧붙인다 -->
|
||||
<div class="cpg-modal" id="cpg-ol-dlg" hidden>
|
||||
<div class="cpg-modal-back" data-ol-close></div>
|
||||
<div class="cpg-modal-box cpg-ol-box" role="dialog" aria-modal="true" aria-labelledby="cpg-ol-title">
|
||||
<h3 id="cpg-ol-title">밀크런 출고리스트 작성</h3>
|
||||
|
||||
<div class="cpg-ol-grid cpg-ol-grid-4">
|
||||
<div class="erp-field"><span>작성일</span><input type="date" id="cpg-ol-doc-date" /></div>
|
||||
<div class="erp-field"><span>출고일</span><input type="date" id="cpg-ol-ship-date" /></div>
|
||||
<div class="erp-field"><span>센터입고일</span><input type="date" id="cpg-ol-arrival-date" /></div>
|
||||
<label class="erp-field"><span>작업자</span>
|
||||
<input class="erp-input" type="text" id="cpg-ol-worker" maxlength="30" value="{{ outbound_worker }}" /></label>
|
||||
</div>
|
||||
|
||||
<!-- 입고센터 카드 — 센터마다 출고방식·제품·출고를 따로 입력(cupang-outbound.js 가 템플릿으로 만든다) -->
|
||||
<div class="cpg-ol-centers" id="cpg-ol-centers"></div>
|
||||
<button type="button" class="erp-btn erp-btn-outline cpg-ol-add-center" id="cpg-ol-add-center">+ 입고센터 추가</button>
|
||||
<template id="cpg-ol-center-tpl">
|
||||
<section class="cpg-ol-center">
|
||||
<header class="cpg-ol-center-head">
|
||||
<strong class="cpg-ol-center-no">입고센터 1</strong>
|
||||
<button type="button" class="cpg-icon-btn is-danger cpg-ol-center-del">센터 삭제</button>
|
||||
</header>
|
||||
<div class="cpg-ol-grid">
|
||||
<label class="erp-field"><span>입고센터</span>
|
||||
<select class="erp-select cpg-ol-center-sel"><option value="">불러오는 중…</option></select></label>
|
||||
<label class="erp-field"><span>출고방식</span>
|
||||
<select class="erp-select cpg-ol-method">
|
||||
<option value="택배">택배</option>
|
||||
<option value="파렛트">파렛트</option>
|
||||
</select></label>
|
||||
<label class="erp-field"><span>출고</span>
|
||||
<input class="erp-input cpg-ol-outbound" type="text" maxlength="100" placeholder="예) 2파렛트, 15박스" /></label>
|
||||
<label class="erp-field cpg-ol-center-custom" hidden><span>새 입고센터</span>
|
||||
<input class="erp-input cpg-ol-center-new" type="text" maxlength="60" placeholder="센터 이름" /></label>
|
||||
</div>
|
||||
<div class="erp-field"><span>제품 (코드표에서 검색해 추가)</span>
|
||||
<div class="cpg-ol-search">
|
||||
<input class="erp-input cpg-ol-search-input" type="search" autocomplete="off"
|
||||
placeholder="제품코드 또는 제품명으로 검색" />
|
||||
<ul class="cpg-ol-results" hidden></ul>
|
||||
</div>
|
||||
</div>
|
||||
<table class="cpg-ol-lines" hidden>
|
||||
<thead><tr><th>제품코드</th><th>제품명</th><th>수량</th><th></th></tr></thead>
|
||||
<tbody></tbody>
|
||||
</table>
|
||||
<p class="erp-muted cpg-ol-empty">위 검색창에서 제품을 골라 추가하세요.</p>
|
||||
</section>
|
||||
</template>
|
||||
|
||||
<p class="erp-muted cpg-ol-target" id="cpg-ol-target"></p>
|
||||
<div class="cpg-ol-progress" id="cpg-ol-progress" hidden>
|
||||
<div class="cpg-ol-progress-top">
|
||||
<span id="cpg-ol-progress-step">준비 중</span>
|
||||
<b id="cpg-ol-progress-pct">0%</b>
|
||||
</div>
|
||||
<div class="cpg-ol-progress-track" role="progressbar" aria-valuemin="0" aria-valuemax="100" aria-valuenow="0"
|
||||
aria-label="기록 진행률" id="cpg-ol-progress-track">
|
||||
<div class="cpg-ol-progress-bar" id="cpg-ol-progress-bar"></div>
|
||||
</div>
|
||||
</div>
|
||||
<p class="cpg-ol-error" id="cpg-ol-error" hidden></p>
|
||||
<div class="cpg-ol-actions">
|
||||
<button type="button" class="erp-btn erp-btn-outline" data-ol-close>취소</button>
|
||||
<button type="button" class="erp-btn cpg-btn-excel" id="cpg-ol-submit">완료</button>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
</section>
|
||||
{% endblock %}
|
||||
|
||||
{% block scripts %}
|
||||
<script src="/static/project.js?v=20261111b" defer></script>
|
||||
<script src="/static/cupang-outbound.js?v=20261023d" defer></script>
|
||||
<script>
|
||||
(function () {
|
||||
var dlg = document.getElementById("cpg-del-dlg");
|
||||
|
||||
@@ -0,0 +1,14 @@
|
||||
# [배송] 말레이시아 배송 모듈 — `app/modules/dispatch/`, `dispatch_db`
|
||||
|
||||
> 이 모듈만 고칠 때 읽는 요약. 상세는 `docs/DISPATCH_MODULE.md`.
|
||||
> 정적 파일: `app/static/dispatch/`. 템플릿: `templates/`. 테스트: `tests/`.
|
||||
|
||||
- TikTok·Shopee 출고관리. 권한키 `dispatch`.
|
||||
- 플랫폼별 데이터 엑셀 업로드(TikTok = `03_TikTok_Order_Export.xlsx`, Shopee = `Packing List.Doorstep Delivery.xlsx`)
|
||||
→ 1상자 = 1카드 출고 작업 리스트·SKU 피킹 요약·Kagayaku 전달표 자동 생성.
|
||||
- 1상자 묶음 기준 Package ID > Tracking ID > Order ID, 같은 상자 같은 SKU 합산.
|
||||
- 작업 상태 토글(`dispatch_logs` 기록).
|
||||
- 받는 사람 이름/전화/주소는 상자 단위로 저장(작업 카드 표시 + 출고 엑셀 생성용) — **개인정보**, 로그·외부 전송 주의.
|
||||
- 배치 다운로드 zip 에 업로드 원본 + 취합 출고 엑셀(`YYYY.MM.DD(Ddd)_tictoc|shopee.xlsx`) 포함.
|
||||
- 기간별 발송 수량 엑셀(`/dispatch/period-export`, **수퍼 관리자 전용**): 날짜별·아이템별 수량(`_N` 배수 반영, 세트는 BOM 으로 낱개 분해) + 아이템×날짜 요약 시트 + 세트×날짜 요약 시트(낱개로 풀기 전 세트 수량).
|
||||
- 엑셀은 openpyxl 파싱/생성.
|
||||
@@ -309,6 +309,41 @@ class DispatchStore:
|
||||
for r in rows
|
||||
]
|
||||
|
||||
def shipped_by_date_range(
|
||||
self, *, date_from: str, date_to: str
|
||||
) -> list[dict[str, Any]]:
|
||||
"""기간(양끝 포함) 날짜·SKU별 합산 수량 — 기간별 발송 수량 엑셀용.
|
||||
|
||||
반환: [{"dispatch_date": "YYYY-MM-DD", "seller_sku", "product_name", "qty"}].
|
||||
_N 배수 반영은 호출부(export)에서 한다.
|
||||
"""
|
||||
with self._pool.connection() as conn:
|
||||
rows = conn.execute(
|
||||
"""
|
||||
SELECT b.dispatch_date, i.seller_sku,
|
||||
MAX(i.product_name) AS product_name,
|
||||
SUM(i.quantity)::int AS qty
|
||||
FROM dispatch_items i
|
||||
JOIN dispatch_parcels p ON p.id = i.parcel_id
|
||||
JOIN dispatch_batches b ON b.id = p.batch_id
|
||||
WHERE b.dispatch_date BETWEEN %s AND %s
|
||||
GROUP BY b.dispatch_date, i.seller_sku
|
||||
ORDER BY b.dispatch_date ASC, i.seller_sku ASC
|
||||
""",
|
||||
(date_from, date_to),
|
||||
).fetchall()
|
||||
return [
|
||||
{
|
||||
"dispatch_date": r["dispatch_date"].isoformat()
|
||||
if isinstance(r["dispatch_date"], date)
|
||||
else str(r["dispatch_date"] or ""),
|
||||
"seller_sku": r["seller_sku"] or "",
|
||||
"product_name": r["product_name"] or "",
|
||||
"qty": int(r["qty"] or 0),
|
||||
}
|
||||
for r in rows
|
||||
]
|
||||
|
||||
# ════════════════════════════════════════════════════════════
|
||||
# 말레이시아 재고 차감 1회성 가드
|
||||
# ════════════════════════════════════════════════════════════
|
||||
|
||||
@@ -246,6 +246,158 @@ def stock_filename(dispatch_date: str) -> str:
|
||||
return f"{stamp}_sabangnet_outbound.xlsx"
|
||||
|
||||
|
||||
# ── 기간별 발송 수량 엑셀(수퍼 관리자) ──
|
||||
def missing_set_boms(
|
||||
rows: list[dict[str, Any]], set_bom: dict[str, list[dict[str, Any]]]
|
||||
) -> list[str]:
|
||||
"""세트(MY-)인데 BOM 이 없어 낱개로 풀 수 없는 코드 목록(정렬)."""
|
||||
return sorted({
|
||||
b for b in (split_sku(r.get("seller_sku", ""))[0].strip().upper() for r in rows)
|
||||
if b.startswith(_SET_PREFIX) and b not in set_bom
|
||||
})
|
||||
|
||||
|
||||
def aggregate_shipped(
|
||||
rows: list[dict[str, Any]],
|
||||
name_map: dict[str, str] | None = None,
|
||||
set_bom: dict[str, list[dict[str, Any]]] | None = None,
|
||||
) -> tuple[list[str], dict[str, str], dict[tuple[str, str], int]]:
|
||||
"""날짜·SKU별 합산 행 → (날짜목록, {코드: 상품명}, {(날짜, 코드): 수량}).
|
||||
|
||||
seller_sku 의 _N 접미사는 배수로 곱해 실제 아이템코드로 합친다
|
||||
(예: MT-0320_3 × 2 → MT-0320 6개). 세트(set_bom 에 있는 코드)는 구성 낱개로
|
||||
풀어 (수량 × 구성수량) 을 낱개 코드에 더한다.
|
||||
"""
|
||||
name_map = name_map or {}
|
||||
set_bom = set_bom or {}
|
||||
dates: set[str] = set()
|
||||
names: dict[str, str] = {}
|
||||
qty: dict[tuple[str, str], int] = {}
|
||||
|
||||
def _add(d: str, code: str, n: int, fallback: str) -> None:
|
||||
key = (d, code)
|
||||
qty[key] = qty.get(key, 0) + n
|
||||
if not names.get(code):
|
||||
names[code] = resolve_product_name(code, name_map, fallback=fallback)
|
||||
|
||||
for r in rows:
|
||||
base, mult = split_sku(r.get("seller_sku", ""))
|
||||
code = base.strip().upper()
|
||||
if not code:
|
||||
continue
|
||||
pieces = int(r.get("qty", 0) or 0) * mult
|
||||
if pieces <= 0:
|
||||
continue
|
||||
d = r.get("dispatch_date", "") or ""
|
||||
dates.add(d)
|
||||
comps = set_bom.get(code)
|
||||
if comps: # 세트 → 낱개 분해
|
||||
for c in comps:
|
||||
cc = str(c.get("component_code", "")).strip().upper()
|
||||
n = pieces * int(c.get("component_qty", 0) or 0)
|
||||
if cc and n > 0:
|
||||
_add(d, cc, n, "")
|
||||
else:
|
||||
_add(d, code, pieces, r.get("product_name", "") or "")
|
||||
return sorted(dates), names, qty
|
||||
|
||||
|
||||
def build_period_xlsx(
|
||||
*,
|
||||
rows: list[dict[str, Any]],
|
||||
date_from: str,
|
||||
date_to: str,
|
||||
name_map: dict[str, str] | None = None,
|
||||
set_bom: dict[str, list[dict[str, Any]]] | None = None,
|
||||
) -> bytes:
|
||||
"""기간별 발송 수량 xlsx(세트는 낱개로 풀어 합산). 시트 3개.
|
||||
|
||||
- 「날짜별」: 발송 날짜 / 아이템 코드 / 상품이름 / 수량 (날짜·코드 오름차순, 맨 끝 합계)
|
||||
- 「아이템별 요약」: 아이템 코드 / 상품이름 / 날짜1..N / 합계 (맨 끝 날짜별 합계 행)
|
||||
- 「세트별 요약」: 세트 코드 / 상품이름 / 날짜1..N / 합계 — 낱개로 풀기 전 세트 단위 수량
|
||||
"""
|
||||
from openpyxl import Workbook # noqa: WPS433
|
||||
from openpyxl.styles import Alignment, Font, PatternFill
|
||||
from openpyxl.utils import get_column_letter
|
||||
|
||||
set_bom = set_bom or {}
|
||||
dates, names, qty = aggregate_shipped(rows, name_map, set_bom)
|
||||
codes = sorted(names)
|
||||
# 세트 행만 BOM 없이 다시 합산하면 세트 단위 수량이 된다(_N 배수 반영은 같다).
|
||||
set_rows = [r for r in rows if split_sku(r.get("seller_sku", ""))[0].strip().upper() in set_bom]
|
||||
_sd, set_names, set_qty = aggregate_shipped(set_rows, name_map)
|
||||
|
||||
head_fill = PatternFill("solid", fgColor="E2E8F0")
|
||||
head_font = Font(bold=True)
|
||||
bold = Font(bold=True)
|
||||
|
||||
def _style_head(ws: Any) -> None:
|
||||
for cell in ws[1]:
|
||||
cell.fill = head_fill
|
||||
cell.font = head_font
|
||||
cell.alignment = Alignment(horizontal="center", vertical="center")
|
||||
ws.freeze_panes = "A2"
|
||||
|
||||
wb = Workbook()
|
||||
|
||||
# 시트 1 — 날짜별 목록
|
||||
ws = wb.active
|
||||
ws.title = "날짜별"
|
||||
headers = ["발송 날짜", "아이템 코드", "상품이름", "수량"]
|
||||
ws.append(headers)
|
||||
total = 0
|
||||
for d in dates:
|
||||
for code in codes:
|
||||
n = qty.get((d, code))
|
||||
if not n:
|
||||
continue
|
||||
ws.append([d, code, names.get(code, ""), n])
|
||||
total += n
|
||||
ws.append(["합계", "", "", total])
|
||||
for cell in ws[ws.max_row]:
|
||||
cell.font = bold
|
||||
_style_head(ws)
|
||||
_autosize(ws, headers)
|
||||
|
||||
# 시트 2·3 — 코드(행) × 날짜(열) 요약. 날짜 열은 두 시트 모두 전체 발송 날짜로 맞춘다.
|
||||
def _pivot(title: str, code_label: str, p_names: dict[str, str],
|
||||
p_qty: dict[tuple[str, str], int]) -> None:
|
||||
p_codes = sorted(p_names)
|
||||
ws2 = wb.create_sheet(title)
|
||||
headers2 = [code_label, "상품이름", *dates, "합계"]
|
||||
ws2.append(headers2)
|
||||
for code in p_codes:
|
||||
per_day = [p_qty.get((d, code), 0) for d in dates]
|
||||
ws2.append([code, p_names.get(code, ""), *[n or None for n in per_day], sum(per_day)])
|
||||
day_totals = [sum(p_qty.get((d, c), 0) for c in p_codes) for d in dates]
|
||||
ws2.append(["합계", "", *day_totals, sum(day_totals)])
|
||||
for cell in ws2[ws2.max_row]:
|
||||
cell.font = bold
|
||||
_style_head(ws2)
|
||||
ws2.freeze_panes = "C2"
|
||||
_autosize(ws2, headers2)
|
||||
for i in range(3, len(headers2) + 1): # 날짜 열은 좁게 고정
|
||||
ws2.column_dimensions[get_column_letter(i)].width = 12
|
||||
|
||||
_pivot("아이템별 요약", "아이템 코드", names, qty)
|
||||
_pivot("세트별 요약", "세트 코드", set_names, set_qty)
|
||||
|
||||
wb.properties.title = f"말레이시아 발송 수량 {date_from} ~ {date_to}"
|
||||
|
||||
buf = io.BytesIO()
|
||||
wb.save(buf)
|
||||
return buf.getvalue()
|
||||
|
||||
|
||||
def period_filename(date_from: str, date_to: str) -> str:
|
||||
"""기간별 발송 수량 파일명: 2026.10.01-2026.10.28_shipped_qty.xlsx."""
|
||||
def _stamp(v: str) -> str:
|
||||
d = _parse_date(v)
|
||||
return d.strftime("%Y.%m.%d") if d else (v or "").strip()
|
||||
|
||||
return f"{_stamp(date_from)}-{_stamp(date_to)}_shipped_qty.xlsx"
|
||||
|
||||
|
||||
def _cell(value: Any) -> Any:
|
||||
"""송장/전화번호 등이 숫자로 보이면 엑셀이 과학표기/반올림 하므로 문자열 보존."""
|
||||
if isinstance(value, int):
|
||||
|
||||
@@ -131,11 +131,11 @@ def _render_config_needed(request: Request, user: dict[str, Any]) -> HTMLRespons
|
||||
def _guard(request: Request):
|
||||
"""로그인+권한+store 점검. 페이지 핸들러 진입부에서 사용."""
|
||||
from app.main import get_current_user_record, render_template # noqa: WPS433
|
||||
from app.store import has_module, is_admin # noqa: WPS433
|
||||
from app.store import has_module, is_admin, login_redirect # noqa: WPS433
|
||||
|
||||
user = get_current_user_record(request)
|
||||
if user is None:
|
||||
return RedirectResponse(url="/login", status_code=303)
|
||||
return login_redirect(request)
|
||||
if not has_module(user, "dispatch"):
|
||||
return render_template(
|
||||
request,
|
||||
@@ -477,6 +477,72 @@ def stock_export(
|
||||
)
|
||||
|
||||
|
||||
_PERIOD_MAX_DAYS = 366
|
||||
|
||||
|
||||
@router.get("/period-export")
|
||||
def period_export(
|
||||
request: Request,
|
||||
date_from: str,
|
||||
date_to: str,
|
||||
user: dict[str, Any] = Depends(_require_user),
|
||||
) -> Response:
|
||||
"""기간(양끝 포함) 날짜별·아이템별 발송 수량 xlsx — 슈퍼 관리자 전용.
|
||||
|
||||
seller_sku 의 _N 배수 반영, 세트(MY-)는 itemcode_db BOM 으로 낱개로 풀어 합산.
|
||||
"""
|
||||
if not bool(user.get("is_super_admin")):
|
||||
raise HTTPException(status_code=403, detail="기간별 발송 수량은 슈퍼 관리자만 받을 수 있습니다.")
|
||||
st = _store(request)
|
||||
if st is None:
|
||||
raise HTTPException(status_code=503, detail="dispatch_db 미설정")
|
||||
d_from = export._parse_date(date_from)
|
||||
d_to = export._parse_date(date_to)
|
||||
if d_from is None or d_to is None:
|
||||
raise HTTPException(status_code=400, detail="시작일·종료일을 YYYY-MM-DD 로 입력하세요.")
|
||||
if d_from > d_to:
|
||||
d_from, d_to = d_to, d_from
|
||||
if (d_to - d_from).days + 1 > _PERIOD_MAX_DAYS:
|
||||
raise HTTPException(status_code=400, detail=f"기간은 최대 {_PERIOD_MAX_DAYS}일까지 가능합니다.")
|
||||
|
||||
f, t = d_from.isoformat(), d_to.isoformat()
|
||||
rows = st.shipped_by_date_range(date_from=f, date_to=t)
|
||||
if not rows:
|
||||
raise HTTPException(status_code=404, detail=f"{f} ~ {t} 기간의 발송 데이터가 없습니다.")
|
||||
|
||||
# 세트 BOM 이 없으면 낱개로 못 푼 채 파일이 만들어진다 — 조용히 틀리지 말고 알린다.
|
||||
set_bom, _sab = _itemcode_bom_and_sabangnet(request)
|
||||
missing_sets = export.missing_set_boms(rows, set_bom)
|
||||
if missing_sets:
|
||||
reader = getattr(request.app.state, "malaysia_itemcode", None)
|
||||
hint = getattr(reader, "last_error", "") or getattr(reader, "reason", "")
|
||||
detail = (
|
||||
"세트 BOM 을 찾지 못해 낱개로 풀 수 없습니다: "
|
||||
+ ", ".join(missing_sets)
|
||||
+ ". itemcode_db 의 set_components 에 해당 세트 BOM 이 등록돼 있는지 확인하세요."
|
||||
)
|
||||
if hint:
|
||||
detail += f" (itemcode 리더 오류: {hint})"
|
||||
raise HTTPException(status_code=422, detail=detail)
|
||||
|
||||
xlsx_bytes = export.build_period_xlsx(
|
||||
rows=rows, date_from=f, date_to=t,
|
||||
name_map=_itemcode_name_map(request), set_bom=set_bom,
|
||||
)
|
||||
fname = export.period_filename(f, t)
|
||||
headers = {
|
||||
"Content-Disposition": (
|
||||
f"attachment; filename=\"shipped_{f}_{t}.xlsx\"; "
|
||||
f"filename*=UTF-8''{quote(fname)}"
|
||||
)
|
||||
}
|
||||
return Response(
|
||||
content=xlsx_bytes,
|
||||
media_type="application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
|
||||
headers=headers,
|
||||
)
|
||||
|
||||
|
||||
@router.post("/stock-deduct")
|
||||
def stock_deduct(
|
||||
request: Request,
|
||||
|
||||
@@ -114,7 +114,8 @@
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<div class="erp-card dsp-calwrap">
|
||||
<div class="dsp-calwrap" style="display:flex;flex-direction:column;gap:16px;">
|
||||
<div class="erp-card" style="margin:0;">
|
||||
<div class="cpg-card-head"><h3 style="margin:0;" data-ko="사방넷 출고 다운로드" data-en="Sabangnet Outbound Download">사방넷 출고 다운로드</h3></div>
|
||||
<p class="erp-muted" style="margin:4px 0 10px;font-size:13px;"
|
||||
data-ko="날짜를 클릭하면 그날 출고를 낱개로 분해한 사방넷 출고 엑셀을 받습니다. 사방넷에 올리면 출고로 잡혀 재고가 차감됩니다."
|
||||
@@ -143,6 +144,24 @@
|
||||
<div id="dsp-cal-deduct-note" class="erp-muted" style="font-size:12px;"></div>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
{% if is_super %}
|
||||
<div class="erp-card" style="margin:0;">
|
||||
<div class="cpg-card-head"><h3 style="margin:0;" data-ko="기간별 발송 수량" data-en="Shipped Qty by Period">기간별 발송 수량</h3></div>
|
||||
<p class="erp-muted" style="margin:4px 0 10px;font-size:13px;"
|
||||
data-ko="기간 안 날짜별·아이템별 발송 수량을 엑셀로 받습니다. 세트는 낱개로 풀어 합산하고, 세트 수량은 별도 시트에 담습니다. (수퍼 관리자 전용)"
|
||||
data-en="Download shipped quantities per date and item for the period. Sets are split into singles; set counts are on a separate sheet. (Super admin only)">기간 안 날짜별·아이템별 발송 수량을 엑셀로 받습니다. 세트는 낱개로 풀어 합산하고, 세트 수량은 별도 시트에 담습니다. (수퍼 관리자 전용)</p>
|
||||
<div style="display:flex;align-items:center;gap:6px;flex-wrap:wrap;">
|
||||
<input type="date" id="dsp-pe-from" class="erp-input" style="flex:1 1 120px;min-width:0;padding:7px 8px;border:1px solid #cbd5e1;border-radius:8px;" />
|
||||
<span class="erp-muted">~</span>
|
||||
<input type="date" id="dsp-pe-to" class="erp-input" style="flex:1 1 120px;min-width:0;padding:7px 8px;border:1px solid #cbd5e1;border-radius:8px;" />
|
||||
</div>
|
||||
<button type="button" id="dsp-pe-dl" class="erp-btn erp-btn-primary" style="margin-top:10px;width:100%;"
|
||||
data-ko="📊 기간별 발송 수량 엑셀 다운로드" data-en="📊 Download Shipped Qty Excel">📊 기간별 발송 수량 엑셀 다운로드</button>
|
||||
<div id="dsp-pe-note" class="erp-muted" style="font-size:12px;margin-top:6px;"></div>
|
||||
</div>
|
||||
{% endif %}
|
||||
</div>
|
||||
</div>
|
||||
</section>
|
||||
{% endblock %}
|
||||
@@ -264,6 +283,53 @@
|
||||
render();
|
||||
})();
|
||||
|
||||
// ── 기간별 발송 수량 엑셀(수퍼 관리자) ──
|
||||
(function () {
|
||||
var btn = document.getElementById('dsp-pe-dl');
|
||||
if (!btn) return;
|
||||
var fromEl = document.getElementById('dsp-pe-from');
|
||||
var toEl = document.getElementById('dsp-pe-to');
|
||||
var note = document.getElementById('dsp-pe-note');
|
||||
function pad(n) { return (n < 10 ? '0' : '') + n; }
|
||||
function iso(d) { return d.getFullYear() + '-' + pad(d.getMonth() + 1) + '-' + pad(d.getDate()); }
|
||||
function en() { return (window.dspLang && window.dspLang() === 'en'); }
|
||||
// 기본: 이번 달 1일 ~ 오늘
|
||||
var now = new Date();
|
||||
fromEl.value = iso(new Date(now.getFullYear(), now.getMonth(), 1));
|
||||
toEl.value = iso(now);
|
||||
|
||||
btn.onclick = function () {
|
||||
var f = fromEl.value, t = toEl.value;
|
||||
if (!f || !t) { alert(en() ? 'Pick both dates.' : '시작일과 종료일을 고르세요.'); return; }
|
||||
btn.disabled = true;
|
||||
note.textContent = en() ? 'Preparing…' : '만드는 중…';
|
||||
var url = '/dispatch/period-export?date_from=' + encodeURIComponent(f) + '&date_to=' + encodeURIComponent(t);
|
||||
fetch(url)
|
||||
.then(function (r) {
|
||||
if (!r.ok) {
|
||||
return r.json().catch(function () { return {}; }).then(function (j) {
|
||||
throw new Error((j && j.detail) || ('HTTP ' + r.status));
|
||||
});
|
||||
}
|
||||
var cd = r.headers.get('Content-Disposition') || '';
|
||||
var m = cd.match(/filename\*=UTF-8''([^;]+)/);
|
||||
var name = m ? decodeURIComponent(m[1]) : ('shipped_' + f + '_' + t + '.xlsx');
|
||||
return r.blob().then(function (b) {
|
||||
var a = document.createElement('a');
|
||||
a.href = URL.createObjectURL(b);
|
||||
a.download = name;
|
||||
document.body.appendChild(a); a.click(); a.remove();
|
||||
setTimeout(function () { URL.revokeObjectURL(a.href); }, 1000);
|
||||
note.textContent = '';
|
||||
});
|
||||
})
|
||||
.catch(function (e) {
|
||||
note.textContent = (e && e.message) || (en() ? 'Failed' : '실패');
|
||||
})
|
||||
.then(function () { btn.disabled = false; });
|
||||
};
|
||||
})();
|
||||
|
||||
// ── 받는 사람 찾기(이름/주문/패키지/송장 번호 부분 일치) ──
|
||||
(function () {
|
||||
var wrap = document.getElementById('dsp-search');
|
||||
|
||||
@@ -0,0 +1,91 @@
|
||||
"""기간별 발송 수량 엑셀(export.aggregate_shipped / build_period_xlsx) 테스트.
|
||||
|
||||
DB 없이 집계·엑셀 생성만 검증한다.
|
||||
python -m app.modules.dispatch.tests.test_period_export
|
||||
또는 pytest 로 실행 가능.
|
||||
"""
|
||||
|
||||
from __future__ import annotations
|
||||
|
||||
import io
|
||||
|
||||
from app.modules.dispatch import export
|
||||
|
||||
_ROWS = [
|
||||
{"dispatch_date": "2026-10-02", "seller_sku": "MT-0320", "product_name": "A", "qty": 2},
|
||||
{"dispatch_date": "2026-10-01", "seller_sku": "MT-0320_3", "product_name": "A", "qty": 1},
|
||||
{"dispatch_date": "2026-10-01", "seller_sku": "mt-0320", "product_name": "A", "qty": 1},
|
||||
{"dispatch_date": "2026-10-01", "seller_sku": "MY-0001", "product_name": "Set", "qty": 4},
|
||||
{"dispatch_date": "2026-10-02", "seller_sku": "", "product_name": "", "qty": 9},
|
||||
]
|
||||
|
||||
|
||||
def test_aggregate_multiplier_and_merge():
|
||||
"""_N 배수 반영 + 대소문자/접미사 다른 같은 코드 합산, 빈 코드 제외(BOM 없으면 세트 그대로)."""
|
||||
dates, names, qty = export.aggregate_shipped(_ROWS, {"MT-0320": "상품A"})
|
||||
assert dates == ["2026-10-01", "2026-10-02"], dates
|
||||
assert qty[("2026-10-01", "MT-0320")] == 4 # 1×3 + 1
|
||||
assert qty[("2026-10-02", "MT-0320")] == 2
|
||||
assert qty[("2026-10-01", "MY-0001")] == 4
|
||||
assert names["MT-0320"] == "상품A" # itemcode 이름 우선
|
||||
assert names["MY-0001"] == "Set" # 없으면 파싱된 이름
|
||||
|
||||
|
||||
_BOM = {"MY-0001": [
|
||||
{"component_code": "MT-0320", "component_qty": 1},
|
||||
{"component_code": "mt-0550", "component_qty": 2},
|
||||
]}
|
||||
|
||||
|
||||
def test_aggregate_explodes_sets():
|
||||
"""세트는 BOM 으로 낱개 분해해 같은 날 같은 낱개 코드에 합산."""
|
||||
dates, names, qty = export.aggregate_shipped(_ROWS, {"MT-0550": "상품B"}, _BOM)
|
||||
assert ("2026-10-01", "MY-0001") not in qty
|
||||
assert qty[("2026-10-01", "MT-0320")] == 8 # 1×3 + 1 + 세트 4×1
|
||||
assert qty[("2026-10-01", "MT-0550")] == 8 # 세트 4×2
|
||||
assert names["MT-0550"] == "상품B"
|
||||
assert export.missing_set_boms(_ROWS, _BOM) == []
|
||||
assert export.missing_set_boms(_ROWS, {}) == ["MY-0001"]
|
||||
|
||||
|
||||
def test_build_period_xlsx_sheets():
|
||||
from openpyxl import load_workbook
|
||||
|
||||
data = export.build_period_xlsx(
|
||||
rows=_ROWS, date_from="2026-10-01", date_to="2026-10-02", name_map={}, set_bom=_BOM
|
||||
)
|
||||
wb = load_workbook(io.BytesIO(data))
|
||||
assert wb.sheetnames == ["날짜별", "아이템별 요약", "세트별 요약"]
|
||||
|
||||
ws = wb["날짜별"]
|
||||
rows = list(ws.iter_rows(values_only=True))
|
||||
assert rows[0] == ("발송 날짜", "아이템 코드", "상품이름", "수량")
|
||||
assert rows[1] == ("2026-10-01", "MT-0320", "A", 8)
|
||||
assert rows[2] == ("2026-10-01", "MT-0550", None, 8)
|
||||
assert rows[3] == ("2026-10-02", "MT-0320", "A", 2)
|
||||
assert rows[-1][0] == "합계" and rows[-1][3] == 18
|
||||
|
||||
ws2 = wb["아이템별 요약"]
|
||||
rows2 = list(ws2.iter_rows(values_only=True))
|
||||
assert rows2[0] == ("아이템 코드", "상품이름", "2026-10-01", "2026-10-02", "합계")
|
||||
assert rows2[1] == ("MT-0320", "A", 8, 2, 10)
|
||||
assert rows2[2] == ("MT-0550", None, 8, None, 8)
|
||||
assert rows2[3] == ("합계", None, 16, 2, 18)
|
||||
|
||||
# 세트는 낱개로 풀기 전 세트 단위 수량, 날짜 열은 전체 발송 날짜와 같다.
|
||||
rows3 = list(wb["세트별 요약"].iter_rows(values_only=True))
|
||||
assert rows3[0] == ("세트 코드", "상품이름", "2026-10-01", "2026-10-02", "합계")
|
||||
assert rows3[1] == ("MY-0001", "Set", 4, None, 4)
|
||||
assert rows3[2] == ("합계", None, 4, 0, 4)
|
||||
|
||||
|
||||
def test_period_filename():
|
||||
assert export.period_filename("2026-10-01", "2026-10-28") == "2026.10.01-2026.10.28_shipped_qty.xlsx"
|
||||
|
||||
|
||||
if __name__ == "__main__":
|
||||
test_aggregate_multiplier_and_merge()
|
||||
test_aggregate_explodes_sets()
|
||||
test_build_period_xlsx_sheets()
|
||||
test_period_filename()
|
||||
print("OK")
|
||||
@@ -0,0 +1,4 @@
|
||||
# [경비] 개인경비 모듈 — `app/modules/expense/`, `expense_db`
|
||||
|
||||
> 이 모듈만 고칠 때 읽는 요약. 별도 상세 문서 없음 — 코드(`router.py`·`store.py`·`categories.py`)가 기준.
|
||||
> 템플릿: `templates/`. DB 구성은 필요할 때만 `docs/DATABASES.md` 의 expense_db 절.
|
||||
@@ -265,11 +265,11 @@ def expense_index(request: Request) -> HTMLResponse:
|
||||
get_current_user_record,
|
||||
render_template,
|
||||
)
|
||||
from app.store import has_module, is_admin # noqa: WPS433
|
||||
from app.store import has_module, is_admin, login_redirect # noqa: WPS433
|
||||
|
||||
user = get_current_user_record(request)
|
||||
if user is None:
|
||||
return RedirectResponse(url="/login", status_code=303)
|
||||
return login_redirect(request)
|
||||
if not has_module(user, "expense"):
|
||||
return render_template(
|
||||
request,
|
||||
@@ -325,11 +325,11 @@ def pending_page(request: Request) -> HTMLResponse:
|
||||
get_current_user_record,
|
||||
render_template,
|
||||
)
|
||||
from app.store import has_module, is_admin # noqa: WPS433
|
||||
from app.store import has_module, is_admin, login_redirect # noqa: WPS433
|
||||
|
||||
user = get_current_user_record(request)
|
||||
if user is None:
|
||||
return RedirectResponse(url="/login", status_code=303)
|
||||
return login_redirect(request)
|
||||
if not (is_admin(user) or has_module(user, "expense_approver")):
|
||||
return render_template(
|
||||
request,
|
||||
@@ -362,11 +362,11 @@ def reports_page(request: Request) -> HTMLResponse:
|
||||
get_current_user_record,
|
||||
render_template,
|
||||
)
|
||||
from app.store import is_admin # noqa: WPS433
|
||||
from app.store import is_admin, login_redirect # noqa: WPS433
|
||||
|
||||
user = get_current_user_record(request)
|
||||
if user is None:
|
||||
return RedirectResponse(url="/login", status_code=303)
|
||||
return login_redirect(request)
|
||||
store = _store(request)
|
||||
_require_db_store(store)
|
||||
year_str = request.query_params.get("year") or str(now_kst().year)
|
||||
@@ -436,11 +436,11 @@ def approved_page(request: Request) -> HTMLResponse:
|
||||
get_current_user_record,
|
||||
render_template,
|
||||
)
|
||||
from app.store import has_module, is_admin # noqa: WPS433
|
||||
from app.store import has_module, is_admin, login_redirect # noqa: WPS433
|
||||
|
||||
user = get_current_user_record(request)
|
||||
if user is None:
|
||||
return RedirectResponse(url="/login", status_code=303)
|
||||
return login_redirect(request)
|
||||
if not (is_admin(user) or has_module(user, "expense_approver")):
|
||||
return render_template(
|
||||
request,
|
||||
@@ -667,11 +667,11 @@ def settings_page(request: Request) -> HTMLResponse:
|
||||
get_current_user_record,
|
||||
render_template,
|
||||
)
|
||||
from app.store import has_module, is_admin # noqa: WPS433
|
||||
from app.store import has_module, is_admin, login_redirect # noqa: WPS433
|
||||
|
||||
user = get_current_user_record(request)
|
||||
if user is None:
|
||||
return RedirectResponse(url="/login", status_code=303)
|
||||
return login_redirect(request)
|
||||
if not (is_admin(user) or has_module(user, "expense_approver")):
|
||||
return render_template(
|
||||
request,
|
||||
|
||||
@@ -0,0 +1,126 @@
|
||||
# [입출고] 입출고 관리 모듈 — `app/modules/inout/`, `inout_db`(2026-10-16)
|
||||
|
||||
> 이 모듈만 고칠 때 읽는 요약. 상세는 `docs/INOUT_MODULE.md`.
|
||||
> 정적 파일: `app/static/inout.css`, `inout.js`. 템플릿: `templates/`.
|
||||
> 상품은 `itemcode_db.single_items` 읽기 전용(`itemcode.py`). `APP_ENCRYPTION_KEY` 는 실적 모듈과 공유.
|
||||
> 참고 모델: 이카운트 "발주 대비 미입고"·Odoo 분할 입고/종결.
|
||||
|
||||
## 발주 / 입고
|
||||
|
||||
- 본사 → 공장 제품 제작 발주(발주서 `PO-YYMMDD-NN`). 제품 = `itemcode_db.single_items` 단품만, 검색 `GET /inout/api/items`·저장 때 서버 재확인.
|
||||
- 물류 입고를 여러 번 나눠 입력, 품목별 발주·입고·미입고.
|
||||
- 미입고 현황(제품별 합계·발주별·지연).
|
||||
- 발주 목록 상태 보기(진행 중·완료·종결·취소·전체)는 **사람마다 기억**(2026-11-04) — `inout_settings` 키 `list_status:{이메일}`(마이그레이션 없음, 005 미적용이면 기억만 안 함). 주소에 `status` 가 있으면 저장, 없으면 저장값, 그것도 없으면 진행 중.
|
||||
- 발주 목록 **입고일** 열(2026-11-05, 입고 예정일과 발주 사이, `db.list_orders` `receipt_dates`) — 여러 날에 나눠 입고하면 칸 안에서 줄바꿈(오래된 날부터), 같은 날 여러 번은 한 번만, 입고 전 `-`.
|
||||
- 발주 목록 거르기 줄(2026-11-05) — 상태·공장은 왼쪽, 발주일~[찾기]는 오른쪽(`.io-filter-right`).
|
||||
- 발주 목록 표 머리글(2026-11-05, `.io-list-table`) = 가운데·굵게·`--text-caption` × 111% × 90%·회색 배경, 표 글자 전체도 원래의 90%. 미입고 현황 등 다른 표는 그대로.
|
||||
- [남은 수량 모두 채우기]를 한 번 더 누르면(= [채운 수량 되돌리기]) 채우기 전 값으로(2026-10-19, `inout.js`).
|
||||
- 초과 입고는 확인 화면 후 허용(트랜잭션 안에서 발주서 잠그고 판단, `confirm_over`).
|
||||
- **전체 입고 완료(모든 품목 입고 ≥ 발주, 상태 done·over)면 더 입고 못 함**(2026-10-19) — 화면은 입고 칸·[입고 저장]·사진·[남은 수량 채우기]를 흐리게 disabled, 서버 `_add_receipt` 도 잠근 뒤 거절. 입고 기록을 지우면 다시 열림.
|
||||
- 잔량 종결·취소(취소는 입고 없을 때만).
|
||||
- 상태는 저장하지 않고 누적 입고로 계산(`store.order_status`).
|
||||
- 모든 품목 입고완료·초과입고 = "✓ 전체 입고 완료"(초과면 "초과 포함", `order_badge`).
|
||||
- 발주 삭제는 **수퍼관리자만**(발주 목록 🗑, `perms.super`, 입고·사진·메일 기록까지 CASCADE).
|
||||
|
||||
## 권한 / 옵션
|
||||
|
||||
- 권한키 `inout`(조회).
|
||||
- **발주 담당·입고 담당·공장(담당자·연락처 따로, 002)은 모듈 옵션** — 상단 톱니 → 팝업(`/inout/settings?panel=1`, ERP 관리자, `inout_roles`·`inout_factories`). 관리자는 둘 다.
|
||||
- 공용 `.erp-input`·`.erp-table-wrap` 겹침은 `.io` 안에서만 바로잡음.
|
||||
- **입고 담당(발주 담당 아님)은 품목을 이름·발주 수량만**(`items_limited`), 옵션은 관리자만.
|
||||
|
||||
## 발주 메일 (003)
|
||||
|
||||
- 새 발주서 저장 → 미리보기 팝업(받는 사람 = 공장 이메일, 요약 표 본문) → 사람이 [메일 발송]을 눌러야 보냄.
|
||||
- **발주 담당 본인 Gmail**(Gmail API `gmail.send`, 사람마다 [Gmail 연결] 1회 — 고른 구글 계정 = ERP 계정 확인). 갱신 토큰은 `APP_ENCRYPTION_KEY` AES-GCM 암호문(`gmail.py`).
|
||||
**휴가 모듈도 같은 연결을 쓴다**(2026-10-27) — 휴가 옵션 [Gmail 연결]은 세션 `_gmail_origin=vacation` 을 달고 같은 콜백(`/inout/gmail/callback`)으로 돌아오며,
|
||||
콜백이 `_gmail_callback_vacation`(휴가 권한 확인, 휴가 옵션으로 복귀)으로 넘긴다. 토큰 표·끊기는 공용 — 바꾸면 휴가 메일(`vacation/notify.py`)도 확인.
|
||||
- 보낸 기록·재발송 확인.
|
||||
- **본문 고치기**(2026-10-27): 발주 메일 미리보기 iframe 이 `designMode`(sandbox `allow-same-origin`, 스크립트 없음) — 고치면 [원래 본문으로]·닫을 때 확인,
|
||||
보낼 때만 `html` 을 함께 POST → `store.clean_mail_html`(허용 태그·표·인라인 서식만, url()·이벤트·스크립트 제거) + 글 버전 `mail_html_to_text`. 안 고치면 서버 본문 그대로. 입고 요청 메일은 고치기 없음(cid 사진).
|
||||
**서식 막대**(`initMail` 안 `RTE_BAR`, 안내문 발송 편집기와 같은 구성: 크기·굵게·기울임·밑줄·취소선·글자/배경 색·정렬·목록·링크·서식 지우기·되돌리기) = iframe `execCommand`(styleWithCSS → span style).
|
||||
Quill 은 표를 못 담아 안 씀. 크기는 fontSize 7 → px span 으로 바꿔 끼움. 선택은 본문 문서의 현재 선택 우선(막대 mousedown 때 기억은 대비용). 서버는 `text-decoration-line` → `text-decoration`.
|
||||
- **입고 담당 발주 알림 자동 발송**(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 필요).
|
||||
|
||||
- **간단 발주 메일**(2026-11-04): 공장 이름에 "대성화학"·"인천공장"이 들어가면(`store.SIMPLE_MAIL_FACTORIES`, 띄어쓰기 무시) 품목 표 = 번호·제품 코드·제품명·수량·**박스당 수량·박스 수**·비고만, 요약 표·글 본문에서도 금액·무게·PP·은을 뺀다(단가가 공장에 나가지 않게). 색상 줄 배경·합계 수량은 그대로.
|
||||
박스 값은 발주 품목 사본이 아니라 **메일을 만들 때의 상품 정보**(`router._mail_order` → `store.line_boxes`, 뚜껑 있으면 통·뚜껑 따로, 입수 없으면 `-`). 다른 공장 메일엔 박스 칸 없음.
|
||||
|
||||
## 입고 요청 메일 (005, 2026-10-19)
|
||||
|
||||
- 입고 담당이 **입고 저장** → 발주서 화면 `?rmail={입고 id}` 로 미리보기 팝업이 바로 뜸 → [메일 발송](입고 담당 본인 Gmail, 발주 메일과 같은 연결 — Gmail 연결 권한은 발주·입고 담당 `_require(…, "mail")`). 입고 기록 줄 [보내기/다시 보내기]로 언제든.
|
||||
- 받는 사람 = 옵션 → **물류센터** 탭 담당자 이메일(`inout_settings` `logistics_emails`), 참조 기본 = `receipt_mail_cc`(005 가 `king@dbxcorp.co.kr, bj@dbxcorp.co.kr` 넣음). 창에서 고칠 수 있음.
|
||||
- 제목 `[입고 요청] 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, 마이그레이션 없음)
|
||||
|
||||
- 입고 기록 줄 [사방넷 입고 파일](엑셀 초록 `#217346`) → `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).
|
||||
- 썸네일·크게 보기·나중에 더하기. 초과 확인은 브라우저가 먼저(사진 유지).
|
||||
- **돌리기**(2026-11-02) — 크게 보기 창 왼쪽·오른쪽 버튼(입고 담당) → `POST /inout/orders/{id}/photos/{pid}/rotate?degrees=90|270` → 서버가 **저장된 사진 자체**를 돌려 덮어씀(`store.rotate_image`, EXIF 회전을 픽셀에 반영, 같은 형식, JPEG 품질 92) — 원본 링크·입고 요청 메일도 돌린 사진. 되돌리기 = 반대로 돌리기. HEIC·움직이는 GIF 는 못 돌림(HEIC 은 버튼 숨김).
|
||||
사진 응답은 `no-cache` + ETag(돌린 뒤 예전 사진이 캐시에 남지 않게).
|
||||
|
||||
## 상품 정보 (004, 옵션 세 번째 탭)
|
||||
|
||||
- 테이블 `inout_products`·`inout_products_excluded`.
|
||||
- [단품 불러오기] = 코드표 단품 → 목록(값을 넣은 상품은 그대로·지운 단품은 다음에도 빠짐, 제외 목록에서 되살리기).
|
||||
- 단가(원)·무게(개당 g = PP량)·은(Ag) 함유량(%) 수기 입력(은 g = 무게 × % 자동).
|
||||
- 한 번 불러오면 발주서 제품은 이 목록에서. 발주 품목에 그때 값 사본(`unit_price`·`weight_g`·`silver_pct`).
|
||||
- 발주서·메일에 금액(수량 × 단가)·PP·은 함유량과 합계.
|
||||
- 발주서 화면 품목 표(`.io-items-table`, 2026-10-21): 제목 행 검정·굵게·가운데, 합계 줄 검정·굵게·제목 크기, "합계" = 1~3열 가운데.
|
||||
열 **PP 사용량**·**은(Ag) 함유량** = 발주 수량 전체 사용량 kg(`store.line_usage` — 메일 표와 같은 값), 아래 작은 글씨 = 개당 g·%.
|
||||
- **합계 줄(발주서 화면·발주 메일 표 같음)**: 금액 뒤 " 원", 무게 뒤 " kg", 무게는 소수 첫째 자리에서 반올림(정수 kg). 줄 값·메일 요약 표는 예전 자릿수 그대로.
|
||||
- **발주 메일 표**(2026-10-19, `store.order_mail`): 전체 무게(kg) = 개당 g × 수량 · **PP 사용량(kg)** = 전체 무게 − 은 무게(은 함유량 왼쪽 열) · 은(Ag) 함유량 = `30% (76.5kg)`(괄호 = 전체 무게 × %, kg 소수 넷째). 합계 줄·요약(전체 무게·PP 사용량·은 총량)도 kg. 첫 요약 표는 항목·값 두 쌍씩 4열(4×4), 요청 사항은 맨 아래 한 줄 전체. 발주서 화면 표는 예전 그대로(PP g/개).
|
||||
|
||||
## 상품 그룹·색상 (006, 2026-10-21)
|
||||
|
||||
- 옵션 **상품 그룹** 탭(2026-10-21 상품 정보 탭에서 분리) = 그룹 표(`inout_product_groups`: 이름·은 함유량·색상·순서, `POST /inout/settings/groups`·`…/{id}/delete`).
|
||||
상품 줄 **그룹** 고르기 → 그 상품의 은 함유량·색상 = 그룹 값(자기 값 칸은 숨김·보존, 그룹 지우면 자기 값으로). 그룹 없는 상품은 상품마다.
|
||||
계산은 `db._PRODUCT_SELECT_006`(silver_pct·color = 그룹 적용 값, own_* = 자기 값) 한 곳 — 목록·발주서 제품 고르기·발주 품목 사본이 같은 값.
|
||||
- 색상 = 색없음·오렌지·파랑·회색·아이보리색(`store.COLORS` 키 none·orange·blue·gray·ivory → 이름·칸 색), 화면은 색 사각형 + 이름(`_macros.swatch`).
|
||||
- 발주 품목에 그때 색상 사본(`inout_order_lines.color`, 006 전 품목 NULL = 지금 상품 색상). **발주 메일 품목 표에서 색상 있는 품목 줄 전체 배경 = 그 색**(tr + 칸마다).
|
||||
- 006 확인(`groups_ready`)은 연결을 열기 **전에** — 미적용이면 1분 기억(발주 저장 트랜잭션 안에서 두 번째 연결을 잡아 동시 발주에서 풀이 바닥났었다).
|
||||
- 옵션 → 담당자 = 아이콘(구글 프로필 사진, 없으면 기본 아이콘) + 이름, 아래 이메일.
|
||||
|
||||
## 박스 입수·파렛트 (007, 2026-10-21)
|
||||
|
||||
- 옵션 → 상품 정보 **통 수량(박스)**·**뚜껑 수량(박스)** = 통·뚜껑이 한 박스에 몇 개(`inout_products.body_per_box`·`lid_per_box`, 1 이상 정수, 뚜껑 없으면 빈칸,
|
||||
`store.validate_box_values`). 상품 정보 표 제목 행 = 가운데·굵게·13.2px(예전 12px × 110%).
|
||||
- **새 발주서** 줄마다 "통·뚜껑 박스" 칸(`inout.js boxCell`) = 통 ⌈수량 ÷ 통 입수⌉박스 · 뚜껑 ⌈수량 ÷ 뚜껑 입수⌉박스, 힌트 = 통·뚜껑 입수의 **최소공배수**(둘 다 꽉 차는 수량 단위,
|
||||
뚜껑 없으면 통 입수)와 지금 수량에 가까운 그 배수(누르면 수량 칸에), 배수면 "✓ 꽉 찹니다". 합계 줄 = 통·뚜껑·전체 박스 → **파렛트 ⌈전체 박스 ÷ 30⌉**(`store.PALLET_BOXES`) + 마지막 파렛트 박스 수.
|
||||
- 수량 칸 오른쪽 **◀ ▶** = 공배수(`unitOf`)만큼 줄이기·늘리기 — 배수가 아니면 가까운 아래/위 배수로, 0 이면 빈칸. 제품을 안 골랐거나 입수가 없으면 못 누름.
|
||||
- 합계 줄 파렛트 그림(`palletSvg`·`palletVis`, 6열 × 5행 박스 + 받침대) = 꽉 찬 파렛트(최대 10개 + "+N") · 잔량 파렛트(실린 박스만 색칠, 몇 %·몇 박스 더 실으면 한 파렛트), 딱 맞으면 "✓ 모든 파렛트가 꽉 찹니다".
|
||||
- 품목 표 제목 행 = 가운데·굵게·`--text-caption` × 110%.
|
||||
- 화면 계산만 — 발주 품목 사본·발주서 화면·**발주 메일에는 넣지 않음**(사용자 지정). 값은 지금 상품 정보(`_form_page` 의 `body_per_box`, `/api/items`).
|
||||
- 007 확인 `db.boxes_ready`(groups_ready 와 같은 방식 — 연결 열기 전, 미적용 1분 기억). 그룹·색상 조회(`_PRODUCT_SELECT_006`)는 `p.*` 라 새 열이 따라온다.
|
||||
|
||||
## 봉투·백 (008, 2026-11-04)
|
||||
|
||||
- 이름에 **"미라클 봉투"·"미라클백"** 이 들어간 상품(`store.is_bag`, 저장 안 함 — 이름으로 판단) = 옵션 → 상품 정보에서 일반 상품과 **표를 나눔**(봉투·백 표가 위). 칸: **박스당 수량**(`body_per_box` 재사용)·**1파렛트당 박스 수량**(`inout_products.boxes_per_pallet`). 뚜껑 없음(저장하면 `lid_per_box` 는 NULL).
|
||||
**단가·무게·은 칸 없음**(2026-11-04 사용자 지정) — 전에 넣은 값은 줄의 숨은 칸으로 저장 때 그대로 보내 지우지 않음. 그룹·색상 칸은 있음. 새 발주서 "단가 없는 N종"·발주서 화면과 발주 메일의 "단가 미입력 N종"(`store.order_totals`) 안내에서 봉투·백은 뺌.
|
||||
- 새 발주서 합계 줄에 봉투·백 박스·파렛트를 **통·뚜껑과 따로** 표시: 파렛트 = ⌈Σ(박스 ÷ 그 상품 1파렛트 박스)⌉. 파렛트 그림도 통처럼(`palletVis(all, cap, mixed)`, 그림 칸은 60칸까지) — 1파렛트 박스 수가 다른 상품이 섞이면 가장 큰 값으로 환산해 잔량은 %만. 입수·1파렛트 값은 `store.box_info`(`_form_page`·`/api/items`).
|
||||
- 008 확인 `db.bags_ready`(boxes_ready 와 같은 방식). 미적용이면 모두 일반 상품으로 동작.
|
||||
|
||||
## 오른쪽 달력 (2026-10-21)
|
||||
|
||||
- 입출고 **모든 화면** 2열(`.io-split` = 왼쪽 `section.io` | 오른쪽 `_calendar.html`, 1100px 미만은 한 열 270px). 스크롤해도 위에 붙음.
|
||||
달력 크기 = 화면에 따라 270~396px(`clamp(270px, 20.7vw, 396px)`, 2026-11-05 90% 로 줄임, 높이 ×320/300) — 입출고 화면만 ERP 공용 최대 폭 1550px 를 풀어 넓은 화면 여백을 씀(2026-10-21 "여백이 많다, 더 키워 달라").
|
||||
글자·칸은 달력 너비 기준 `cqw`(300px 일 때 1cqw = 3px)라 같은 비율로 커진다 — 새 크기 값도 px 대신 cqw 로.
|
||||
- 프로젝트 달력 모양(일요일 시작·요일 줄 회색·오늘 검은 동그라미·토 파랑·일/공휴일 빨강 — 공휴일 표는 `project.store.holiday_name` 재사용).
|
||||
공휴일 이름은 숫자 아래 한 줄(`.io-cal-hol`, 8.5px — 5글자까지 다 보임, 더 길면 … + 말풍선에 전체 이름).
|
||||
- 날짜 칸 = 발주(발주일, 파랑)·입고(입고일, 초록) 건수(취소된 발주 제외), 누르면 그날 목록 팝업 → 발주서. 달 이동은 새로고침 없이 `GET /inout/api/calendar?month=YYYY-MM`(`db.calendar`).
|
||||
- **메뉴를 옮겨도 달력은 다시 그리지 않음**(2026-10-21) — 마지막 달력(달·API 응답 글·칸 HTML)을 sessionStorage `io_cal_v1` 에 두고 `_calendar.html` 인라인 스크립트가 그리기 전에 붙임,
|
||||
`inout.js` 는 서버 값을 다시 받아 **글이 달라졌을 때만** 다시 그린다(보던 달도 유지). `CAL_KEY` 는 `initCalendar` 안에 — 바깥 const 면 위에서 먼저 부를 때 TDZ 로 복원이 조용히 꺼진다.
|
||||
|
||||
## 시각 / 날짜
|
||||
|
||||
- 시각은 DB 시간대와 무관하게 KST 로 읽음(`db._KstTimestamptzLoader`).
|
||||
- 날짜 서식은 모두 `yyyy.mm.dd(요일)`(`ymd`·`ymdhm` 매크로, `store.fmt_date`).
|
||||
- **날짜 칸 = ERP 공용 달력**(2026-11-05, `erp-datepop`, `_datepop.html` + `inout.js` 머리) — 발주 목록 기간·발주일·입고 예정일·입고일. `input[type=date]` 는 숨긴 값 저장소(폼 전송 그대로), 국경일·대체공휴일 빨강·이름 + 마우스를 올리면 이름(`title`, 표 = `project.store.KR_HOLIDAYS`, `router._date_holidays`).
|
||||
필수 칸은 [지우기] 없음(숨긴 required 칸이 비면 브라우저가 안내 없이 저장을 막는다), 잠긴 입고일은 버튼도 disabled. 테스트 `tests/js/inout_datepop.browser.test.js`(`render_inout.py`).
|
||||
@@ -0,0 +1,32 @@
|
||||
"""입출고 관리(inout) 모듈 — 본사 → 공장 제품 제작 발주, 물류 입고(분할), 발주 대비 미입고·초과 관리.
|
||||
|
||||
- 라우터: `router.py` (prefix=/inout)
|
||||
- 저장소: `db.py` (inout_db / PostgreSQL) + `store.py` (상태·검사, 순수 함수)
|
||||
- 제품: `itemcode.py` — itemcode_db.single_items(단품) 읽기 전용(ITEMCODE_DB_URL 재사용)
|
||||
- 템플릿: `templates/inout/`, 화면 스크립트·스타일 `static/inout.{js,css}`
|
||||
|
||||
INOUT_DB_URL 미설정이면 build_inout_store 가 None → 라우터가 "설정 필요" 안내(앱은 죽지 않음).
|
||||
권한: 모듈 권한키 `inout`(조회), 발주 담당·입고 담당은 모듈 옵션(inout_roles)에서 지정, ERP 관리자는 둘 다 + 옵션.
|
||||
상세 docs/INOUT_MODULE.md.
|
||||
"""
|
||||
|
||||
from typing import Any
|
||||
|
||||
from .router import router
|
||||
|
||||
__all__ = ["router", "build_inout_store", "build_inout_items"]
|
||||
|
||||
|
||||
def build_inout_store(*, dsn: str | None) -> Any:
|
||||
if not dsn:
|
||||
return None
|
||||
from .db import InoutDBStore # 지연 import
|
||||
|
||||
return InoutDBStore(dsn)
|
||||
|
||||
|
||||
def build_inout_items() -> Any:
|
||||
"""코드표 단품 리더(ITEMCODE_DB_URL). 미설정이면 enabled=False."""
|
||||
from .itemcode import SingleItemReader # 지연 import
|
||||
|
||||
return SingleItemReader()
|
||||
@@ -0,0 +1,892 @@
|
||||
"""inout_db PostgreSQL 저장소 — 공장·담당자·발주서·입고.
|
||||
|
||||
- 드라이버: psycopg 3 + pool(다른 모듈과 같은 패턴), 연결 `INOUT_DB_URL`. 스키마는 scripts/sql/inout_db_init.sql(앱이 만들지 않음).
|
||||
- 상태(발주·부분입고·입고완료·초과·종결·취소)는 저장하지 않고 품목별 누적 입고로 계산한다(store.order_status) — 어긋날 일이 없다.
|
||||
- 쓰기는 한 트랜잭션. 입고 저장은 발주서 행을 잠그고(FOR UPDATE) 그 안에서 누적 입고를 다시 읽어 초과를 판단한다
|
||||
(두 사람이 동시에 입고해도 초과 확인을 건너뛰지 않게).
|
||||
"""
|
||||
|
||||
from __future__ import annotations
|
||||
|
||||
import time
|
||||
from datetime import date, datetime
|
||||
from typing import Any
|
||||
|
||||
from psycopg.errors import UndefinedColumn, UndefinedTable, UniqueViolation
|
||||
from psycopg.rows import dict_row
|
||||
from psycopg.types.datetime import TimestamptzLoader
|
||||
from psycopg_pool import ConnectionPool
|
||||
|
||||
from app.timezone import KST
|
||||
|
||||
from . import store
|
||||
|
||||
|
||||
_SCAN_LIMIT = 20000 # 목록에서 상태 거르기 전에 읽는 발주서 상한
|
||||
|
||||
# 상품 정보 + 그룹(006) — 그룹 상품은 그룹의 은 함유량·색상, 그룹 없는 상품은 자기 값(own_*).
|
||||
# p.* 다음에 같은 이름(silver_pct·color)을 다시 고르면 dict_row 는 뒤의 값(그룹 적용 값)을 쓴다. p.* 라 007 박스 입수 등 새 열도 따라온다.
|
||||
_PRODUCT_SELECT_006 = (
|
||||
"SELECT p.*, g.name AS group_name, p.silver_pct AS own_silver_pct, COALESCE(p.color, 'none') AS own_color, "
|
||||
"CASE WHEN g.id IS NULL THEN p.silver_pct ELSE g.silver_pct END AS silver_pct, "
|
||||
"CASE WHEN g.id IS NULL THEN COALESCE(p.color, 'none') ELSE g.color END AS color "
|
||||
"FROM inout_products p LEFT JOIN inout_product_groups g ON g.id = p.group_id"
|
||||
)
|
||||
|
||||
|
||||
class OverReceipt(Exception):
|
||||
"""확인 없이 발주보다 많이 입고하려 함 — over = [{item_code, item_name, ordered, after, over}]."""
|
||||
|
||||
def __init__(self, over: list[dict[str, Any]]) -> None:
|
||||
super().__init__("초과 입고")
|
||||
self.over = over
|
||||
|
||||
|
||||
def _norm_email(e: str) -> str:
|
||||
return (e or "").strip().lower()
|
||||
|
||||
|
||||
class _KstTimestamptzLoader(TimestamptzLoader):
|
||||
"""TIMESTAMPTZ → 한국 시각(KST) datetime. 화면·메일에 찍는 시각(입력·보낸 시각 등)이 DB 서버 시간대(보통 UTC)와 무관하게."""
|
||||
|
||||
def load(self, data: Any) -> datetime:
|
||||
return super().load(data).astimezone(KST)
|
||||
|
||||
|
||||
def _kst_session(conn: Any) -> None:
|
||||
# 세션 시간대(SET TIME ZONE)는 쓰지 않는다 — 'Asia/Seoul' 은 시간대 자료가 없는 서버에서 접속이 실패하고,
|
||||
# 고정 오프셋은 psycopg 가 못 읽어 UTC 로 돌아간다. 읽을 때 파이썬에서 바꾼다.
|
||||
conn.adapters.register_loader("timestamptz", _KstTimestamptzLoader)
|
||||
|
||||
|
||||
class InoutDBStore:
|
||||
def __init__(self, dsn: str, *, min_size: int = 1, max_size: int = 5):
|
||||
self._pool = ConnectionPool(conninfo=dsn, min_size=min_size, max_size=max_size,
|
||||
kwargs={"row_factory": dict_row, "autocommit": True}, configure=_kst_session, open=False)
|
||||
self._pool.open(wait=False)
|
||||
|
||||
def close(self) -> None:
|
||||
self._pool.close()
|
||||
|
||||
# ════════════════════════════════════════════════════════════
|
||||
# 공장
|
||||
# ════════════════════════════════════════════════════════════
|
||||
def list_factories(self, *, include_inactive: bool = False) -> list[dict[str, Any]]:
|
||||
where = "" if include_inactive else "WHERE f.is_active"
|
||||
with self._pool.connection() as conn:
|
||||
return conn.execute(
|
||||
"SELECT f.*, (SELECT count(*) FROM inout_orders o WHERE o.factory_id = f.id) AS order_count "
|
||||
f"FROM inout_factories f {where} ORDER BY f.is_active DESC, f.sort_order, f.name"
|
||||
).fetchall()
|
||||
|
||||
def save_factory(self, *, factory_id: int | None, name: str, manager: str = "", contact: str = "", email: str = "",
|
||||
memo: str = "", is_active: bool = True, sort_order: int = 0) -> int:
|
||||
"""공장 추가·수정. 담당자(manager, 002)·연락처(contact)·이메일(email, 003 — 여러 개는 쉼표)."""
|
||||
name = (name or "").strip()
|
||||
if not name or len(name) > 100:
|
||||
raise ValueError("공장 이름을 1~100자로 입력하세요.")
|
||||
emails = ", ".join(store.parse_emails(email, label="공장 이메일"))
|
||||
vals = (name, (manager or "").strip()[:100], (contact or "").strip()[:200], emails, (memo or "").strip()[:store.MEMO_MAX],
|
||||
bool(is_active), int(sort_order))
|
||||
try:
|
||||
with self._pool.connection() as conn:
|
||||
dup = conn.execute("SELECT id FROM inout_factories WHERE lower(name) = lower(%s) AND id <> %s",
|
||||
(name, factory_id or 0)).fetchone()
|
||||
if dup:
|
||||
raise ValueError(f"같은 이름의 공장이 이미 있습니다: {name}")
|
||||
if factory_id:
|
||||
row = conn.execute(
|
||||
"UPDATE inout_factories SET name=%s, manager=%s, contact=%s, email=%s, memo=%s, is_active=%s, sort_order=%s "
|
||||
"WHERE id=%s RETURNING id", (*vals, factory_id)).fetchone()
|
||||
if not row:
|
||||
raise ValueError("공장을 찾을 수 없습니다.")
|
||||
return int(row["id"])
|
||||
return int(conn.execute(
|
||||
"INSERT INTO inout_factories (name, manager, contact, email, memo, is_active, sort_order) "
|
||||
"VALUES (%s,%s,%s,%s,%s,%s,%s) RETURNING id", vals).fetchone()["id"])
|
||||
except UndefinedColumn:
|
||||
raise ValueError("DB 마이그레이션 inout_db 002·003(공장 담당자·이메일 칸)이 아직 적용되지 않았습니다.") from None
|
||||
|
||||
def delete_factory(self, factory_id: int) -> None:
|
||||
"""발주 기록이 없는 공장만 지운다(있으면 '사용 안 함'으로 숨김)."""
|
||||
with self._pool.connection() as conn:
|
||||
used = conn.execute("SELECT 1 FROM inout_orders WHERE factory_id=%s LIMIT 1", (factory_id,)).fetchone()
|
||||
if used:
|
||||
raise ValueError("발주 기록이 있는 공장은 지울 수 없습니다 — '사용 안 함'으로 바꾸세요.")
|
||||
conn.execute("DELETE FROM inout_factories WHERE id=%s", (factory_id,))
|
||||
|
||||
# ════════════════════════════════════════════════════════════
|
||||
# 담당자(발주 담당·입고 담당)
|
||||
# ════════════════════════════════════════════════════════════
|
||||
def list_roles(self) -> dict[str, list[str]]:
|
||||
out: dict[str, list[str]] = {r: [] for r in store.ROLES}
|
||||
with self._pool.connection() as conn:
|
||||
for r in conn.execute("SELECT email, role FROM inout_roles ORDER BY email").fetchall():
|
||||
out.setdefault(r["role"], []).append(r["email"])
|
||||
return out
|
||||
|
||||
def roles_of(self, email: str) -> set[str]:
|
||||
with self._pool.connection() as conn:
|
||||
rows = conn.execute("SELECT role FROM inout_roles WHERE email=%s", (_norm_email(email),)).fetchall()
|
||||
return {r["role"] for r in rows}
|
||||
|
||||
def set_role_members(self, role: str, emails: list[str], *, by: str) -> None:
|
||||
"""그 역할 담당자를 통째로 바꾼다(한 트랜잭션)."""
|
||||
if role not in store.ROLES:
|
||||
raise ValueError("알 수 없는 담당 종류입니다.")
|
||||
clean = sorted({_norm_email(e) for e in emails if _norm_email(e)})
|
||||
with self._pool.connection() as conn, conn.transaction():
|
||||
conn.execute("DELETE FROM inout_roles WHERE role=%s AND NOT (email = ANY(%s))", (role, clean))
|
||||
for e in clean:
|
||||
conn.execute("INSERT INTO inout_roles (email, role, created_by) VALUES (%s,%s,%s) ON CONFLICT DO NOTHING",
|
||||
(e, role, _norm_email(by)))
|
||||
|
||||
# ════════════════════════════════════════════════════════════
|
||||
# 발주서
|
||||
# ════════════════════════════════════════════════════════════
|
||||
def _ready_flags(self) -> tuple[bool, bool]:
|
||||
"""(004 상품 정보, 006 그룹·색상) — 발주 저장 트랜잭션을 열기 전에 확인해 _insert_line 에 넘긴다."""
|
||||
return self.products_ready(), self.groups_ready()
|
||||
|
||||
def _insert_line(self, conn: Any, order_id: int, line_no: int, ln: dict[str, Any], names: dict[str, str],
|
||||
specs: dict[str, dict[str, Any]], ready: tuple[bool, bool]) -> None:
|
||||
"""발주 품목 한 줄 — 004 가 적용됐으면 상품 정보의 단가·무게·은 함유량을(006 이면 색상도) 그때 값으로 함께 남긴다."""
|
||||
products_ok, groups_ok = ready
|
||||
if groups_ok: # 006 — 색상 사본도(그룹 상품은 그룹 색상)
|
||||
sp = specs.get(ln["item_code"]) or {}
|
||||
conn.execute("INSERT INTO inout_order_lines (order_id, line_no, item_code, item_name, qty, memo, unit_price, weight_g, silver_pct, color) "
|
||||
"VALUES (%s,%s,%s,%s,%s,%s,%s,%s,%s,%s)",
|
||||
(order_id, line_no, ln["item_code"], names.get(ln["item_code"], ""), ln["qty"], ln["memo"],
|
||||
sp.get("unit_price"), sp.get("weight_g"), sp.get("silver_pct"), sp.get("color") or "none"))
|
||||
elif products_ok:
|
||||
sp = specs.get(ln["item_code"]) or {}
|
||||
conn.execute("INSERT INTO inout_order_lines (order_id, line_no, item_code, item_name, qty, memo, unit_price, weight_g, silver_pct) "
|
||||
"VALUES (%s,%s,%s,%s,%s,%s,%s,%s,%s)",
|
||||
(order_id, line_no, ln["item_code"], names.get(ln["item_code"], ""), ln["qty"], ln["memo"],
|
||||
sp.get("unit_price"), sp.get("weight_g"), sp.get("silver_pct")))
|
||||
else:
|
||||
conn.execute("INSERT INTO inout_order_lines (order_id, line_no, item_code, item_name, qty, memo) VALUES (%s,%s,%s,%s,%s,%s)",
|
||||
(order_id, line_no, ln["item_code"], names.get(ln["item_code"], ""), ln["qty"], ln["memo"]))
|
||||
|
||||
def create_order(self, data: dict[str, Any], names: dict[str, str], *, by: str,
|
||||
specs: dict[str, dict[str, Any]] | None = None) -> dict[str, Any]:
|
||||
"""data = store.validate_order 결과, names = {코드: 단품 이름}, specs = {코드: 상품 정보 행}(004). 반환 {id, order_no}."""
|
||||
ready = self._ready_flags()
|
||||
with self._pool.connection() as conn, conn.transaction():
|
||||
self._require_factory(conn, data["factory_id"])
|
||||
conn.execute("SELECT pg_advisory_xact_lock(hashtext('inout_order_no'))")
|
||||
prefix = store.order_no(data["order_date"], 0)[:-2]
|
||||
# 순번은 숫자로 비교 — 글자 max 면 "-99" 가 "-100" 보다 커서 100번째부터 같은 번호가 나온다
|
||||
row = conn.execute("SELECT max(substr(order_no, %s)::int) AS m FROM inout_orders "
|
||||
"WHERE order_no LIKE %s AND substr(order_no, %s) ~ '^[0-9]{1,9}$'",
|
||||
(len(prefix) + 1, prefix + "%", len(prefix) + 1)).fetchone()
|
||||
seq = (row["m"] or 0) + 1 if row else 1
|
||||
no = store.order_no(data["order_date"], seq)
|
||||
oid = conn.execute(
|
||||
"INSERT INTO inout_orders (order_no, factory_id, order_date, due_date, memo, created_by, updated_by) "
|
||||
"VALUES (%s,%s,%s,%s,%s,%s,%s) RETURNING id",
|
||||
(no, data["factory_id"], data["order_date"], data["due_date"], data["memo"], _norm_email(by), _norm_email(by)),
|
||||
).fetchone()["id"]
|
||||
for i, ln in enumerate(data["lines"], start=1):
|
||||
self._insert_line(conn, oid, i, ln, names, specs or {}, ready)
|
||||
return {"id": int(oid), "order_no": no}
|
||||
|
||||
def update_order(self, order_id: int, data: dict[str, Any], names: dict[str, str], *, by: str,
|
||||
specs: dict[str, dict[str, Any]] | None = None) -> None:
|
||||
"""머리글·품목 고치기. 입고된 품목은 뺄 수 없다(입고 기록이 사라지므로) — 수량은 바꿀 수 있다.
|
||||
이미 있던 품목의 단가 등 사본은 그대로(발주 당시 값), 새로 넣은 품목만 지금 상품 정보 값으로(004)."""
|
||||
ready = self._ready_flags()
|
||||
with self._pool.connection() as conn, conn.transaction():
|
||||
head = self._lock_order(conn, order_id)
|
||||
if head["cancelled_at"]:
|
||||
raise ValueError("취소된 발주서는 고칠 수 없습니다.")
|
||||
self._require_factory(conn, data["factory_id"], allow_inactive_id=head["factory_id"])
|
||||
existing = {r["item_code"]: r for r in conn.execute(
|
||||
"SELECT l.id, l.item_code, COALESCE(sum(rl.qty), 0) AS received FROM inout_order_lines l "
|
||||
"LEFT JOIN inout_receipt_lines rl ON rl.order_line_id = l.id WHERE l.order_id=%s GROUP BY l.id",
|
||||
(order_id,)).fetchall()}
|
||||
wanted = {ln["item_code"] for ln in data["lines"]}
|
||||
blocked = [c for c, r in existing.items() if c not in wanted and int(r["received"]) > 0]
|
||||
if blocked:
|
||||
raise ValueError("입고 기록이 있는 품목은 뺄 수 없습니다: " + ", ".join(sorted(blocked)))
|
||||
for code, r in existing.items():
|
||||
if code not in wanted:
|
||||
conn.execute("DELETE FROM inout_order_lines WHERE id=%s", (r["id"],))
|
||||
for i, ln in enumerate(data["lines"], start=1):
|
||||
if ln["item_code"] in existing:
|
||||
conn.execute("UPDATE inout_order_lines SET line_no=%s, qty=%s, memo=%s WHERE id=%s",
|
||||
(i, ln["qty"], ln["memo"], existing[ln["item_code"]]["id"]))
|
||||
else:
|
||||
self._insert_line(conn, order_id, i, ln, names, specs or {}, ready)
|
||||
conn.execute("UPDATE inout_orders SET factory_id=%s, order_date=%s, due_date=%s, memo=%s, updated_by=%s WHERE id=%s",
|
||||
(data["factory_id"], data["order_date"], data["due_date"], data["memo"], _norm_email(by), order_id))
|
||||
|
||||
def set_closed(self, order_id: int, *, closed: bool, reason: str = "", by: str) -> None:
|
||||
"""종결(남은 미입고를 더 기다리지 않음) / 종결 풀기."""
|
||||
with self._pool.connection() as conn, conn.transaction():
|
||||
head = self._lock_order(conn, order_id)
|
||||
if head["cancelled_at"]:
|
||||
raise ValueError("취소된 발주서입니다.")
|
||||
if closed:
|
||||
conn.execute("UPDATE inout_orders SET closed_at=now(), closed_by=%s, close_reason=%s, updated_by=%s WHERE id=%s",
|
||||
(_norm_email(by), (reason or "").strip()[:store.MEMO_MAX], _norm_email(by), order_id))
|
||||
else:
|
||||
conn.execute("UPDATE inout_orders SET closed_at=NULL, closed_by='', close_reason='', updated_by=%s WHERE id=%s",
|
||||
(_norm_email(by), order_id))
|
||||
|
||||
def cancel_order(self, order_id: int, *, by: str) -> None:
|
||||
"""잘못 넣은 발주 — 입고 기록이 없을 때만 취소(기록은 남김)."""
|
||||
with self._pool.connection() as conn, conn.transaction():
|
||||
self._lock_order(conn, order_id)
|
||||
if conn.execute("SELECT 1 FROM inout_receipts WHERE order_id=%s LIMIT 1", (order_id,)).fetchone():
|
||||
raise ValueError("입고 기록이 있는 발주서는 취소할 수 없습니다 — 남은 수량은 '종결'하세요.")
|
||||
conn.execute("UPDATE inout_orders SET cancelled_at=now(), cancelled_by=%s, updated_by=%s WHERE id=%s",
|
||||
(_norm_email(by), _norm_email(by), order_id))
|
||||
|
||||
def delete_order(self, order_id: int) -> dict[str, Any]:
|
||||
"""발주서 완전 삭제(수퍼관리자) — 품목·입고 기록·입고증 사진·메일 기록까지 함께(CASCADE). 되돌릴 수 없다.
|
||||
반환 {order_no, receipts} — 화면 안내·로그용."""
|
||||
with self._pool.connection() as conn, conn.transaction():
|
||||
self._lock_order(conn, order_id)
|
||||
n = conn.execute("SELECT count(*) AS n FROM inout_receipts WHERE order_id=%s", (order_id,)).fetchone()["n"]
|
||||
row = conn.execute("DELETE FROM inout_orders WHERE id=%s RETURNING order_no", (order_id,)).fetchone()
|
||||
return {"order_no": row["order_no"], "receipts": int(n)}
|
||||
|
||||
def get_order(self, order_id: int) -> dict[str, Any] | None:
|
||||
with self._pool.connection() as conn:
|
||||
head = conn.execute(
|
||||
# 담당자(manager)는 002 열 — 미적용 DB 에서도 깨지지 않게 to_jsonb 로 읽는다
|
||||
"SELECT o.*, f.name AS factory_name, to_jsonb(f) ->> 'manager' AS factory_manager, f.contact AS factory_contact, "
|
||||
"COALESCE(to_jsonb(f) ->> 'email', '') AS factory_email "
|
||||
"FROM inout_orders o JOIN inout_factories f ON f.id = o.factory_id WHERE o.id=%s",
|
||||
(order_id,)).fetchone()
|
||||
if not head:
|
||||
return None
|
||||
lines = conn.execute(
|
||||
"SELECT l.*, COALESCE(sum(rl.qty), 0)::int AS received FROM inout_order_lines l "
|
||||
"LEFT JOIN inout_receipt_lines rl ON rl.order_line_id = l.id WHERE l.order_id=%s "
|
||||
"GROUP BY l.id ORDER BY l.line_no", (order_id,)).fetchall()
|
||||
receipts = conn.execute("SELECT * FROM inout_receipts WHERE order_id=%s ORDER BY receipt_date, id",
|
||||
(order_id,)).fetchall()
|
||||
rlines = conn.execute(
|
||||
"SELECT rl.receipt_id, rl.order_line_id, rl.qty, l.item_code, l.item_name FROM inout_receipt_lines rl "
|
||||
"JOIN inout_order_lines l ON l.id = rl.order_line_id JOIN inout_receipts r ON r.id = rl.receipt_id "
|
||||
"WHERE r.order_id=%s ORDER BY l.line_no", (order_id,)).fetchall()
|
||||
# 입고증 사진(목록만 — 내용은 /inout/photos/{id})·발주 메일 기록 — 003 미적용이면 빈 목록
|
||||
try:
|
||||
photos = conn.execute(
|
||||
"SELECT p.id, p.receipt_id, p.filename, p.content_type, p.size_bytes FROM inout_receipt_photos p "
|
||||
"JOIN inout_receipts r ON r.id = p.receipt_id WHERE r.order_id=%s ORDER BY p.id", (order_id,)).fetchall()
|
||||
mails = conn.execute("SELECT * FROM inout_order_mails WHERE order_id=%s ORDER BY sent_at, id", (order_id,)).fetchall()
|
||||
except UndefinedTable:
|
||||
photos, mails = [], []
|
||||
# 입고 요청 메일 기록(005) — 미적용이면 빈 목록
|
||||
try:
|
||||
rmails = conn.execute(
|
||||
"SELECT m.* FROM inout_receipt_mails m JOIN inout_receipts r ON r.id = m.receipt_id "
|
||||
"WHERE r.order_id=%s ORDER BY m.sent_at, m.id", (order_id,)).fetchall()
|
||||
except UndefinedTable:
|
||||
rmails = []
|
||||
by_rmail: dict[int, list[dict[str, Any]]] = {}
|
||||
for m in rmails:
|
||||
by_rmail.setdefault(int(m["receipt_id"]), []).append(m)
|
||||
by_photo: dict[int, list[dict[str, Any]]] = {}
|
||||
for ph in photos:
|
||||
by_photo.setdefault(int(ph["receipt_id"]), []).append(ph)
|
||||
by_receipt: dict[int, list[dict[str, Any]]] = {}
|
||||
for r in rlines:
|
||||
by_receipt.setdefault(int(r["receipt_id"]), []).append(r)
|
||||
if any("color" in ln and ln["color"] is None for ln in lines): # 006 전 품목 = 지금 상품 색상
|
||||
cur = self.catalog_lookup([ln["item_code"] for ln in lines if ln["color"] is None])
|
||||
for ln in lines:
|
||||
if ln.get("color") is None and ln["item_code"] in cur:
|
||||
ln["color"] = cur[ln["item_code"]].get("color")
|
||||
lines = store.decorate_lines(lines)
|
||||
status = store.order_status(lines, closed=bool(head["closed_at"]), cancelled=bool(head["cancelled_at"]))
|
||||
return {**head, "lines": lines, "summary": store.summarize(lines), "status": status,
|
||||
"status_label": store.ORDER_LABELS[status],
|
||||
"receipts": [{**r, "lines": by_receipt.get(int(r["id"]), []), "photos": by_photo.get(int(r["id"]), []),
|
||||
"mails": by_rmail.get(int(r["id"]), []),
|
||||
"total": sum(int(x["qty"]) for x in by_receipt.get(int(r["id"]), []))} for r in receipts],
|
||||
"mails": mails}
|
||||
|
||||
def list_orders(self, *, status: str = "active", factory_id: int | None = None, q: str = "",
|
||||
date_from: date | None = None, date_to: date | None = None, limit: int = 500) -> list[dict[str, Any]]:
|
||||
"""목록 — 상태는 품목 합계로 계산한 뒤 거른다. q = 발주번호·제품 코드·제품 이름."""
|
||||
where, params = ["TRUE"], []
|
||||
if factory_id:
|
||||
where.append("o.factory_id = %s")
|
||||
params.append(factory_id)
|
||||
if date_from:
|
||||
where.append("o.order_date >= %s")
|
||||
params.append(date_from)
|
||||
if date_to:
|
||||
where.append("o.order_date <= %s")
|
||||
params.append(date_to)
|
||||
if q.strip():
|
||||
like = "%" + q.strip().replace("\\", "\\\\").replace("%", "\\%").replace("_", "\\_") + "%"
|
||||
where.append("(o.order_no ILIKE %s OR EXISTS (SELECT 1 FROM inout_order_lines x WHERE x.order_id = o.id "
|
||||
"AND (x.item_code ILIKE %s OR x.item_name ILIKE %s)))")
|
||||
params += [like, like, like]
|
||||
with self._pool.connection() as conn:
|
||||
heads = conn.execute(
|
||||
"SELECT o.*, f.name AS factory_name FROM inout_orders o JOIN inout_factories f ON f.id = o.factory_id "
|
||||
# 상태는 품목 합계로 계산해 아래에서 거르므로 넉넉히 읽는다(발주서는 많아야 연 수천 건)
|
||||
f"WHERE {' AND '.join(where)} ORDER BY o.order_date DESC, o.id DESC LIMIT {_SCAN_LIMIT}", params
|
||||
).fetchall()
|
||||
ids = [h["id"] for h in heads]
|
||||
lines = conn.execute(
|
||||
"SELECT l.order_id, l.item_code, l.item_name, l.qty, COALESCE(sum(rl.qty), 0)::int AS received "
|
||||
"FROM inout_order_lines l LEFT JOIN inout_receipt_lines rl ON rl.order_line_id = l.id "
|
||||
"WHERE l.order_id = ANY(%s) GROUP BY l.id ORDER BY l.line_no", (ids,)).fetchall() if ids else []
|
||||
# 입고일 열 — 같은 날 여러 번 입고해도 날짜는 하나
|
||||
receipts = conn.execute("SELECT DISTINCT order_id, receipt_date FROM inout_receipts WHERE order_id = ANY(%s) "
|
||||
"ORDER BY order_id, receipt_date", (ids,)).fetchall() if ids else []
|
||||
by_order: dict[int, list[dict[str, Any]]] = {}
|
||||
for ln in lines:
|
||||
by_order.setdefault(int(ln["order_id"]), []).append(ln)
|
||||
receipt_dates: dict[int, list[date]] = {}
|
||||
for r in receipts:
|
||||
receipt_dates.setdefault(int(r["order_id"]), []).append(r["receipt_date"])
|
||||
allowed = store.STATUS_FILTERS.get(status, store.STATUS_FILTERS["active"])[1]
|
||||
out = []
|
||||
for h in heads:
|
||||
ls = by_order.get(int(h["id"]), [])
|
||||
st = store.order_status(ls, closed=bool(h["closed_at"]), cancelled=bool(h["cancelled_at"]))
|
||||
if st not in allowed:
|
||||
continue
|
||||
names = [x["item_name"] or x["item_code"] for x in ls]
|
||||
out.append({**h, "status": st, "status_label": store.ORDER_LABELS[st], "summary": store.summarize(ls),
|
||||
"receipt_dates": receipt_dates.get(int(h["id"]), []), "line_count": len(ls), "items_label": (names[0] + (f" 외 {len(names) - 1}종" if len(names) > 1 else "")) if names else ""})
|
||||
if len(out) >= limit:
|
||||
break
|
||||
return out
|
||||
|
||||
# ════════════════════════════════════════════════════════════
|
||||
# 입고
|
||||
# ════════════════════════════════════════════════════════════
|
||||
def add_receipt(self, order_id: int, quantities: dict[int, Any], *, receipt_date: Any, memo: Any,
|
||||
confirm_over: bool, by: str, photos: list[dict[str, Any]] | None = None) -> dict[str, Any]:
|
||||
"""입고 1건 저장. 발주를 넘는 품목이 있는데 confirm_over 가 아니면 OverReceipt(아무것도 저장 안 함).
|
||||
photos = store.validate_photos 결과(입고증) — 입고와 한 트랜잭션(사진 저장이 실패하면 입고도 저장 안 함)."""
|
||||
try:
|
||||
return self._add_receipt(order_id, quantities, receipt_date=receipt_date, memo=memo,
|
||||
confirm_over=confirm_over, by=by, photos=photos or [])
|
||||
except UndefinedTable:
|
||||
raise ValueError("DB 마이그레이션 inout_db 003(입고증 사진)이 아직 적용되지 않아 사진을 저장할 수 없습니다 — "
|
||||
"사진 없이 저장하거나 관리자에게 알려 주세요.") from None
|
||||
|
||||
def _add_receipt(self, order_id: int, quantities: dict[int, Any], *, receipt_date: Any, memo: Any,
|
||||
confirm_over: bool, by: str, photos: list[dict[str, Any]]) -> dict[str, Any]:
|
||||
with self._pool.connection() as conn, conn.transaction():
|
||||
head = self._lock_order(conn, order_id)
|
||||
if head["cancelled_at"]:
|
||||
raise ValueError("취소된 발주서에는 입고할 수 없습니다.")
|
||||
if head["closed_at"]:
|
||||
raise ValueError("종결된 발주서입니다 — 입고하려면 발주 담당이 종결을 풀어야 합니다.")
|
||||
lines = conn.execute(
|
||||
"SELECT l.id, l.item_code, l.item_name, l.qty, COALESCE(sum(rl.qty), 0)::int AS received "
|
||||
"FROM inout_order_lines l LEFT JOIN inout_receipt_lines rl ON rl.order_line_id = l.id "
|
||||
"WHERE l.order_id=%s GROUP BY l.id", (order_id,)).fetchall()
|
||||
# 전체 입고 완료(모든 품목 입고 ≥ 발주)면 더 받지 않는다(2026-10-19) — 화면은 버튼을 막고, 서버도 거절(잠근 뒤 판단)
|
||||
if lines and all(int(x["received"]) >= int(x["qty"]) for x in lines):
|
||||
raise ValueError("전체 입고가 완료된 발주서입니다 — 더 입고할 수 없습니다(잘못 넣은 입고는 입고 기록에서 지운 뒤 다시 넣으세요).")
|
||||
data = store.validate_receipt(lines, quantities, receipt_date=receipt_date, memo=memo)
|
||||
if data["over"] and not confirm_over:
|
||||
raise OverReceipt(data["over"])
|
||||
rid = conn.execute("INSERT INTO inout_receipts (order_id, receipt_date, memo, created_by) VALUES (%s,%s,%s,%s) RETURNING id",
|
||||
(order_id, data["receipt_date"], data["memo"], _norm_email(by))).fetchone()["id"]
|
||||
for it in data["items"]:
|
||||
conn.execute("INSERT INTO inout_receipt_lines (receipt_id, order_line_id, qty) VALUES (%s,%s,%s)",
|
||||
(rid, it["order_line_id"], it["qty"]))
|
||||
self._insert_photos(conn, int(rid), photos, by)
|
||||
return {"id": int(rid), "over": data["over"], "total": sum(it["qty"] for it in data["items"]), "photos": len(photos)}
|
||||
|
||||
# ── 입고증 사진(003) ──
|
||||
@staticmethod
|
||||
def _insert_photos(conn: Any, receipt_id: int, photos: list[dict[str, Any]], by: str) -> None:
|
||||
for ph in photos:
|
||||
conn.execute("INSERT INTO inout_receipt_photos (receipt_id, filename, content_type, size_bytes, data, created_by) "
|
||||
"VALUES (%s,%s,%s,%s,%s,%s)",
|
||||
(receipt_id, ph["filename"], ph["content_type"], len(ph["data"]), ph["data"], _norm_email(by)))
|
||||
|
||||
def add_receipt_photos(self, order_id: int, receipt_id: int, files: list[tuple[str, bytes]], *, by: str) -> int:
|
||||
"""이미 있는 입고에 사진 더하기(빠뜨렸을 때). 장수 한도는 잠근 뒤 다시 센다. 반환 = 더한 장수."""
|
||||
try:
|
||||
with self._pool.connection() as conn, conn.transaction():
|
||||
head = self._lock_order(conn, order_id)
|
||||
if head["cancelled_at"]:
|
||||
raise ValueError("취소된 발주서입니다.")
|
||||
if not conn.execute("SELECT 1 FROM inout_receipts WHERE id=%s AND order_id=%s", (receipt_id, order_id)).fetchone():
|
||||
raise ValueError("입고 기록을 찾을 수 없습니다.")
|
||||
have = int(conn.execute("SELECT count(*) AS n FROM inout_receipt_photos WHERE receipt_id=%s",
|
||||
(receipt_id,)).fetchone()["n"])
|
||||
photos = store.validate_photos(files, existing=have)
|
||||
if not photos:
|
||||
raise ValueError("올릴 사진을 고르세요.")
|
||||
self._insert_photos(conn, receipt_id, photos, by)
|
||||
return len(photos)
|
||||
except UndefinedTable:
|
||||
raise ValueError("DB 마이그레이션 inout_db 003(입고증 사진)이 아직 적용되지 않았습니다.") from None
|
||||
|
||||
def delete_receipt_photo(self, order_id: int, photo_id: int) -> None:
|
||||
with self._pool.connection() as conn, conn.transaction():
|
||||
self._lock_order(conn, order_id)
|
||||
row = conn.execute("DELETE FROM inout_receipt_photos p USING inout_receipts r "
|
||||
"WHERE p.id=%s AND p.receipt_id = r.id AND r.order_id=%s RETURNING p.id",
|
||||
(photo_id, order_id)).fetchone()
|
||||
if not row:
|
||||
raise ValueError("사진을 찾을 수 없습니다.")
|
||||
|
||||
def rotate_receipt_photo(self, order_id: int, photo_id: int, degrees: int) -> None:
|
||||
"""저장된 사진 자체를 돌린다(2026-11-02) — 화면·원본·입고 요청 메일 모두 돌린 사진."""
|
||||
with self._pool.connection() as conn, conn.transaction():
|
||||
head = self._lock_order(conn, order_id)
|
||||
if head["cancelled_at"]:
|
||||
raise ValueError("취소된 발주서입니다.")
|
||||
row = conn.execute("SELECT p.data FROM inout_receipt_photos p JOIN inout_receipts r ON r.id = p.receipt_id "
|
||||
"WHERE p.id=%s AND r.order_id=%s", (photo_id, order_id)).fetchone()
|
||||
if not row:
|
||||
raise ValueError("사진을 찾을 수 없습니다.")
|
||||
data = store.rotate_image(bytes(row["data"]), degrees)
|
||||
conn.execute("UPDATE inout_receipt_photos SET data=%s, size_bytes=%s WHERE id=%s", (data, len(data), photo_id))
|
||||
|
||||
def get_photo(self, photo_id: int) -> dict[str, Any] | None:
|
||||
"""사진 내용(+ 발주서 id) — 보여 주기용."""
|
||||
try:
|
||||
with self._pool.connection() as conn:
|
||||
return conn.execute("SELECT p.id, p.filename, p.content_type, p.data, r.order_id FROM inout_receipt_photos p "
|
||||
"JOIN inout_receipts r ON r.id = p.receipt_id WHERE p.id=%s", (photo_id,)).fetchone()
|
||||
except UndefinedTable:
|
||||
return None
|
||||
|
||||
# ════════════════════════════════════════════════════════════
|
||||
# Gmail 연결(사람별, 갱신 토큰 암호문만) · 발주 메일 기록 — 003
|
||||
# ════════════════════════════════════════════════════════════
|
||||
def gmail_token(self, email: str) -> dict[str, Any] | None:
|
||||
try:
|
||||
with self._pool.connection() as conn:
|
||||
return conn.execute("SELECT * FROM inout_gmail_tokens WHERE email=%s", (_norm_email(email),)).fetchone()
|
||||
except UndefinedTable:
|
||||
return None
|
||||
|
||||
def save_gmail_token(self, email: str, *, refresh_token_enc: str, scopes: str) -> None:
|
||||
try:
|
||||
with self._pool.connection() as conn:
|
||||
conn.execute("INSERT INTO inout_gmail_tokens (email, refresh_token_enc, scopes, connected_at, last_error) "
|
||||
"VALUES (%s,%s,%s,now(),'') ON CONFLICT (email) DO UPDATE SET refresh_token_enc=EXCLUDED.refresh_token_enc, "
|
||||
"scopes=EXCLUDED.scopes, connected_at=now(), last_error=''",
|
||||
(_norm_email(email), refresh_token_enc, scopes[:500]))
|
||||
except UndefinedTable:
|
||||
raise ValueError("DB 마이그레이션 inout_db 003(발주 메일)이 아직 적용되지 않았습니다.") from None
|
||||
|
||||
def delete_gmail_token(self, email: str) -> None:
|
||||
try:
|
||||
with self._pool.connection() as conn:
|
||||
conn.execute("DELETE FROM inout_gmail_tokens WHERE email=%s", (_norm_email(email),))
|
||||
except UndefinedTable:
|
||||
pass
|
||||
|
||||
def mark_gmail(self, email: str, *, error: str = "") -> None:
|
||||
"""보낸 뒤 — 성공이면 마지막 사용 시각, 실패면 오류 문구(비밀값 없음)."""
|
||||
with self._pool.connection() as conn:
|
||||
conn.execute("UPDATE inout_gmail_tokens SET last_used_at = CASE WHEN %s = '' THEN now() ELSE last_used_at END, "
|
||||
"last_error=%s WHERE email=%s", (error[:300], error[:300], _norm_email(email)))
|
||||
|
||||
def add_order_mail(self, order_id: int, *, sent_by: str, to: list[str], cc: list[str], subject: str, gmail_id: str) -> None:
|
||||
with self._pool.connection() as conn:
|
||||
conn.execute("INSERT INTO inout_order_mails (order_id, sent_by, to_addrs, cc_addrs, subject, gmail_id) "
|
||||
"VALUES (%s,%s,%s,%s,%s,%s)",
|
||||
(order_id, _norm_email(sent_by), ", ".join(to), ", ".join(cc), subject[:300], gmail_id[:100]))
|
||||
|
||||
# ════════════════════════════════════════════════════════════
|
||||
# 모듈 설정(물류센터 이메일·입고 요청 메일 참조) · 입고 요청 메일 기록 — 005
|
||||
# ════════════════════════════════════════════════════════════
|
||||
def settings_ready(self) -> bool:
|
||||
with self._pool.connection() as conn:
|
||||
return bool(conn.execute("SELECT to_regclass('public.inout_settings') IS NOT NULL AND "
|
||||
"to_regclass('public.inout_receipt_mails') IS NOT NULL AS ok").fetchone()["ok"])
|
||||
|
||||
def get_settings(self) -> dict[str, str]:
|
||||
"""설정 값 — 없는 키는 store.SETTING_DEFAULTS. 005 미적용이어도 기본값으로."""
|
||||
out = dict(store.SETTING_DEFAULTS)
|
||||
try:
|
||||
with self._pool.connection() as conn:
|
||||
for r in conn.execute("SELECT key, value FROM inout_settings").fetchall():
|
||||
if r["key"] in out:
|
||||
out[r["key"]] = r["value"]
|
||||
except UndefinedTable:
|
||||
pass
|
||||
return out
|
||||
|
||||
def save_settings(self, values: dict[str, str], *, by: str) -> None:
|
||||
try:
|
||||
with self._pool.connection() as conn, conn.transaction():
|
||||
for k, v in values.items():
|
||||
conn.execute("INSERT INTO inout_settings (key, value, updated_by, updated_at) VALUES (%s,%s,%s,now()) "
|
||||
"ON CONFLICT (key) DO UPDATE SET value=EXCLUDED.value, updated_by=EXCLUDED.updated_by, updated_at=now()",
|
||||
(k, v, _norm_email(by)))
|
||||
except UndefinedTable:
|
||||
raise ValueError("DB 마이그레이션 inout_db 005(물류센터 이메일·입고 요청 메일)가 아직 적용되지 않았습니다.") from None
|
||||
|
||||
# 발주 목록 상태 거르기 — 사람마다 기억(2026-11-04). 같은 설정 표에 사람별 키(마이그레이션 없음), 005 미적용이면 기억만 안 한다.
|
||||
def get_list_status(self, email: str) -> str:
|
||||
try:
|
||||
with self._pool.connection() as conn:
|
||||
row = conn.execute("SELECT value FROM inout_settings WHERE key = %s",
|
||||
("list_status:" + _norm_email(email),)).fetchone()
|
||||
except UndefinedTable:
|
||||
return ""
|
||||
return row["value"] if row else ""
|
||||
|
||||
def save_list_status(self, email: str, status: str) -> None:
|
||||
try:
|
||||
self.save_settings({"list_status:" + _norm_email(email): status}, by=email)
|
||||
except ValueError:
|
||||
pass
|
||||
|
||||
def receipt_photo_data(self, receipt_id: int) -> list[dict[str, Any]]:
|
||||
"""입고 1건의 사진 내용(메일 본문에 넣기) — 올린 순서."""
|
||||
try:
|
||||
with self._pool.connection() as conn:
|
||||
return conn.execute("SELECT id, filename, content_type, data FROM inout_receipt_photos WHERE receipt_id=%s ORDER BY id",
|
||||
(receipt_id,)).fetchall()
|
||||
except UndefinedTable:
|
||||
return []
|
||||
|
||||
def add_receipt_mail(self, receipt_id: int, *, sent_by: str, to: list[str], cc: list[str], subject: str, gmail_id: str) -> None:
|
||||
try:
|
||||
with self._pool.connection() as conn:
|
||||
conn.execute("INSERT INTO inout_receipt_mails (receipt_id, sent_by, to_addrs, cc_addrs, subject, gmail_id) "
|
||||
"VALUES (%s,%s,%s,%s,%s,%s)",
|
||||
(receipt_id, _norm_email(sent_by), ", ".join(to), ", ".join(cc), subject[:300], gmail_id[:100]))
|
||||
except UndefinedTable:
|
||||
pass # 메일은 이미 나갔다 — 기록만 못 남김(005 미적용)
|
||||
|
||||
def delete_receipt(self, order_id: int, receipt_id: int, *, by: str) -> None:
|
||||
"""잘못 넣은 입고 1건을 지운다(그 수량만큼 다시 미입고)."""
|
||||
with self._pool.connection() as conn, conn.transaction():
|
||||
head = self._lock_order(conn, order_id)
|
||||
if head["cancelled_at"]:
|
||||
raise ValueError("취소된 발주서입니다.")
|
||||
row = conn.execute("DELETE FROM inout_receipts WHERE id=%s AND order_id=%s RETURNING id",
|
||||
(receipt_id, order_id)).fetchone()
|
||||
if not row:
|
||||
raise ValueError("입고 기록을 찾을 수 없습니다.")
|
||||
conn.execute("UPDATE inout_orders SET updated_by=%s WHERE id=%s", (_norm_email(by), order_id))
|
||||
|
||||
# ════════════════════════════════════════════════════════════
|
||||
# 상품 정보(004) — 코드표 단품 + 단가·무게(개당 g)·은 함유량(%) 수기 입력, 지운 단품은 제외 목록
|
||||
# ════════════════════════════════════════════════════════════
|
||||
def products_ready(self) -> bool:
|
||||
"""004 가 적용됐나(상품 표·발주 품목 값 칸). 한 번 확인되면 기억."""
|
||||
if getattr(self, "_products_ok", False):
|
||||
return True
|
||||
with self._pool.connection() as conn:
|
||||
ok = bool(conn.execute(
|
||||
"SELECT to_regclass('public.inout_products') IS NOT NULL AND EXISTS (SELECT 1 FROM information_schema.columns "
|
||||
"WHERE table_name = 'inout_order_lines' AND column_name = 'unit_price') AS ok").fetchone()["ok"])
|
||||
self._products_ok = ok
|
||||
return ok
|
||||
|
||||
def _need_products(self) -> None:
|
||||
if not self.products_ready():
|
||||
raise ValueError("DB 마이그레이션 inout_db 004(상품 정보)가 아직 적용되지 않았습니다.")
|
||||
|
||||
def list_products(self) -> list[dict[str, Any]]:
|
||||
"""상품 정보 — 006 이면 그룹 이름·그룹 적용 값(silver_pct·color)·상품 자기 값(own_*)까지."""
|
||||
if not self.products_ready():
|
||||
return []
|
||||
grouped = self.groups_ready()
|
||||
with self._pool.connection() as conn:
|
||||
if grouped:
|
||||
return conn.execute(_PRODUCT_SELECT_006 + " ORDER BY p.item_code").fetchall()
|
||||
return conn.execute("SELECT * FROM inout_products ORDER BY item_code").fetchall()
|
||||
|
||||
def list_excluded(self) -> list[dict[str, Any]]:
|
||||
if not self.products_ready():
|
||||
return []
|
||||
with self._pool.connection() as conn:
|
||||
return conn.execute("SELECT * FROM inout_products_excluded ORDER BY item_code").fetchall()
|
||||
|
||||
def import_products(self, items: list[dict[str, str]], *, by: str) -> dict[str, int]:
|
||||
"""코드표 단품 → 상품 정보. 새 단품은 추가, 값(단가·무게·은 함유량)을 넣은 상품은 그대로(이름도),
|
||||
값이 없는 상품은 이름만 최신으로, 제외 목록의 단품은 건너뛴다."""
|
||||
self._need_products()
|
||||
out = {"added": 0, "renamed": 0, "kept": 0, "excluded": 0, "same": 0}
|
||||
with self._pool.connection() as conn, conn.transaction():
|
||||
have = {r["item_code"]: r for r in conn.execute("SELECT * FROM inout_products FOR UPDATE").fetchall()}
|
||||
skip = {r["item_code"] for r in conn.execute("SELECT item_code FROM inout_products_excluded").fetchall()}
|
||||
for it in items:
|
||||
code, name = it["code"].strip().upper(), (it.get("name") or "").strip()[:300]
|
||||
if not code:
|
||||
continue
|
||||
if code in skip:
|
||||
out["excluded"] += 1
|
||||
elif code not in have:
|
||||
conn.execute("INSERT INTO inout_products (item_code, item_name, updated_by) VALUES (%s,%s,%s) "
|
||||
"ON CONFLICT (item_code) DO NOTHING", (code, name, _norm_email(by)))
|
||||
have[code] = {"item_code": code}
|
||||
out["added"] += 1
|
||||
elif store.has_values(have[code]):
|
||||
out["kept"] += 1
|
||||
elif have[code].get("item_name") != name:
|
||||
conn.execute("UPDATE inout_products SET item_name=%s, updated_at=now() WHERE item_code=%s", (name, code))
|
||||
out["renamed"] += 1
|
||||
else:
|
||||
out["same"] += 1
|
||||
return out
|
||||
|
||||
def save_products(self, rows: list[dict[str, Any]], *, by: str) -> int:
|
||||
"""값 저장 — rows = [{code, unit_price, weight_g, silver_pct}](store.validate_product_values 를 거친 값). 한 트랜잭션.
|
||||
006 이면 줄에 group_id·color(상품 자기 색상)도 — 그룹 상품의 은 함유량·색상은 그룹 값이 쓰인다."""
|
||||
self._need_products()
|
||||
grouped = self.groups_ready() and any("group_id" in r for r in rows)
|
||||
boxed = self.boxes_ready() and any("body_per_box" in r for r in rows)
|
||||
bagged = self.bags_ready() and any("boxes_per_pallet" in r for r in rows)
|
||||
with self._pool.connection() as conn, conn.transaction():
|
||||
if bagged: # 008 — 봉투·백 1파렛트당 박스 수량
|
||||
for r in rows:
|
||||
if "boxes_per_pallet" in r:
|
||||
conn.execute("UPDATE inout_products SET boxes_per_pallet=%s WHERE item_code=%s", (r["boxes_per_pallet"], r["code"]))
|
||||
if boxed: # 007 — 통·뚜껑 박스 입수(그룹과 무관, 상품마다)
|
||||
for r in rows:
|
||||
if "body_per_box" in r:
|
||||
conn.execute("UPDATE inout_products SET body_per_box=%s, lid_per_box=%s WHERE item_code=%s",
|
||||
(r.get("body_per_box"), r.get("lid_per_box"), r["code"]))
|
||||
if grouped:
|
||||
known = {int(g["id"]) for g in conn.execute("SELECT id FROM inout_product_groups").fetchall()}
|
||||
for r in rows:
|
||||
gid = r.get("group_id")
|
||||
if gid is not None and int(gid) not in known:
|
||||
raise ValueError(f"{r['code']}: 없는 그룹입니다(다른 사람이 지웠을 수 있음 — 옵션을 다시 여세요).")
|
||||
hit = conn.execute(
|
||||
"UPDATE inout_products SET unit_price=%s, weight_g=%s, silver_pct=%s, group_id=%s, color=%s, "
|
||||
"updated_by=%s, updated_at=now() WHERE item_code=%s RETURNING item_code",
|
||||
(r["unit_price"], r["weight_g"], r["silver_pct"], gid, r.get("color") or "none",
|
||||
_norm_email(by), r["code"])).fetchone()
|
||||
if not hit:
|
||||
raise ValueError(f"상품 정보에 없는 단품입니다: {r['code']}")
|
||||
return len(rows)
|
||||
for r in rows:
|
||||
hit = conn.execute("UPDATE inout_products SET unit_price=%s, weight_g=%s, silver_pct=%s, updated_by=%s, updated_at=now() "
|
||||
"WHERE item_code=%s RETURNING item_code",
|
||||
(r["unit_price"], r["weight_g"], r["silver_pct"], _norm_email(by), r["code"])).fetchone()
|
||||
if not hit:
|
||||
raise ValueError(f"상품 정보에 없는 단품입니다: {r['code']}")
|
||||
return len(rows)
|
||||
|
||||
def exclude_product(self, code: str, *, by: str) -> None:
|
||||
"""상품 정보에서 지우고 제외 목록에 — 다음 불러오기에서 빠진다(지난 발주서는 그대로)."""
|
||||
self._need_products()
|
||||
with self._pool.connection() as conn, conn.transaction():
|
||||
row = conn.execute("DELETE FROM inout_products WHERE item_code=%s RETURNING item_name", (code,)).fetchone()
|
||||
if not row:
|
||||
raise ValueError("상품을 찾을 수 없습니다.")
|
||||
conn.execute("INSERT INTO inout_products_excluded (item_code, item_name, excluded_by) VALUES (%s,%s,%s) "
|
||||
"ON CONFLICT (item_code) DO UPDATE SET excluded_at=now(), excluded_by=EXCLUDED.excluded_by",
|
||||
(code, row["item_name"], _norm_email(by)))
|
||||
|
||||
def restore_product(self, code: str, *, by: str) -> None:
|
||||
"""제외 목록에서 되살리기 — 바로 상품 정보로(값은 빈칸)."""
|
||||
self._need_products()
|
||||
with self._pool.connection() as conn, conn.transaction():
|
||||
row = conn.execute("DELETE FROM inout_products_excluded WHERE item_code=%s RETURNING item_name", (code,)).fetchone()
|
||||
if not row:
|
||||
raise ValueError("제외 목록에 없는 단품입니다.")
|
||||
conn.execute("INSERT INTO inout_products (item_code, item_name, updated_by) VALUES (%s,%s,%s) ON CONFLICT DO NOTHING",
|
||||
(code, row["item_name"], _norm_email(by)))
|
||||
|
||||
def catalog_count(self) -> int:
|
||||
if not self.products_ready():
|
||||
return 0
|
||||
with self._pool.connection() as conn:
|
||||
return int(conn.execute("SELECT count(*) AS n FROM inout_products").fetchone()["n"])
|
||||
|
||||
def catalog_search(self, q: str, *, limit: int = 30) -> list[dict[str, Any]]:
|
||||
"""발주서 제품 고르기 — 상품 정보에서(지운 단품 제외). 코드 앞부분 일치 먼저."""
|
||||
esc = (q or "").strip().replace("\\", "\\\\").replace("%", "\\%").replace("_", "\\_")
|
||||
if not esc:
|
||||
return []
|
||||
args = {"q": f"%{esc}%", "p": f"{esc}%", "n": int(limit)}
|
||||
grouped = self.groups_ready()
|
||||
with self._pool.connection() as conn:
|
||||
if grouped: # 그룹 상품은 그룹의 은 함유량·색상
|
||||
return conn.execute(
|
||||
_PRODUCT_SELECT_006 + " WHERE p.item_code ILIKE %(q)s OR p.item_name ILIKE %(q)s "
|
||||
"ORDER BY (p.item_code ILIKE %(p)s) DESC, p.item_code LIMIT %(n)s", args).fetchall()
|
||||
return conn.execute(
|
||||
"SELECT * FROM inout_products "
|
||||
"WHERE item_code ILIKE %(q)s OR item_name ILIKE %(q)s "
|
||||
"ORDER BY (item_code ILIKE %(p)s) DESC, item_code LIMIT %(n)s", args).fetchall()
|
||||
|
||||
def catalog_lookup(self, codes: list[str]) -> dict[str, dict[str, Any]]:
|
||||
if not codes or not self.products_ready():
|
||||
return {}
|
||||
grouped = self.groups_ready()
|
||||
with self._pool.connection() as conn:
|
||||
if grouped: # 발주 품목 사본 = 그룹 적용 값
|
||||
rows = conn.execute(_PRODUCT_SELECT_006 + " WHERE p.item_code = ANY(%s)", ([c.upper() for c in codes],)).fetchall()
|
||||
else:
|
||||
rows = conn.execute("SELECT * FROM inout_products WHERE item_code = ANY(%s)", ([c.upper() for c in codes],)).fetchall()
|
||||
return {r["item_code"]: r for r in rows}
|
||||
|
||||
# ════════════════════════════════════════════════════════════
|
||||
# 상품 그룹(006) — 은 함유량·색상을 그룹에 한 번만. 그룹을 지우면 그 상품들은 그룹 없음(자기 값)으로.
|
||||
# ════════════════════════════════════════════════════════════
|
||||
def groups_ready(self) -> bool:
|
||||
"""006 이 적용됐나(그룹 표·상품 group_id·발주 품목 color). 적용됐으면 계속, 아직이면 1분 동안 기억한다 —
|
||||
부를 때마다 연결을 하나 더 잡지 않게(발주 저장 트랜잭션이 연결을 쥔 채 부르면 동시 발주에서 풀이 바닥난다).
|
||||
그래서 연결을 열기 전에 먼저 부른다."""
|
||||
if getattr(self, "_groups_ok", False):
|
||||
return True
|
||||
if time.monotonic() - getattr(self, "_groups_checked", -1e9) < 60:
|
||||
return False
|
||||
if not self.products_ready():
|
||||
return False
|
||||
with self._pool.connection() as conn:
|
||||
ok = bool(conn.execute(
|
||||
"SELECT to_regclass('public.inout_product_groups') IS NOT NULL "
|
||||
"AND EXISTS (SELECT 1 FROM information_schema.columns WHERE table_name = 'inout_products' AND column_name = 'group_id') "
|
||||
"AND EXISTS (SELECT 1 FROM information_schema.columns WHERE table_name = 'inout_order_lines' AND column_name = 'color') AS ok"
|
||||
).fetchone()["ok"])
|
||||
self._groups_ok = ok
|
||||
self._groups_checked = time.monotonic()
|
||||
return ok
|
||||
|
||||
def boxes_ready(self) -> bool:
|
||||
"""007 이 적용됐나(상품 body_per_box·lid_per_box). groups_ready 와 같이 — 적용됐으면 계속, 아직이면 1분 기억, 연결 열기 전에 부른다."""
|
||||
if getattr(self, "_boxes_ok", False):
|
||||
return True
|
||||
if time.monotonic() - getattr(self, "_boxes_checked", -1e9) < 60:
|
||||
return False
|
||||
if not self.products_ready():
|
||||
return False
|
||||
with self._pool.connection() as conn:
|
||||
ok = bool(conn.execute(
|
||||
"SELECT EXISTS (SELECT 1 FROM information_schema.columns WHERE table_name = 'inout_products' "
|
||||
"AND column_name = 'lid_per_box') AS ok").fetchone()["ok"])
|
||||
self._boxes_ok = ok
|
||||
self._boxes_checked = time.monotonic()
|
||||
return ok
|
||||
|
||||
def bags_ready(self) -> bool:
|
||||
"""008 이 적용됐나(상품 boxes_per_pallet). boxes_ready 와 같은 방식."""
|
||||
if getattr(self, "_bags_ok", False):
|
||||
return True
|
||||
if time.monotonic() - getattr(self, "_bags_checked", -1e9) < 60:
|
||||
return False
|
||||
if not self.products_ready():
|
||||
return False
|
||||
with self._pool.connection() as conn:
|
||||
ok = bool(conn.execute(
|
||||
"SELECT EXISTS (SELECT 1 FROM information_schema.columns WHERE table_name = 'inout_products' "
|
||||
"AND column_name = 'boxes_per_pallet') AS ok").fetchone()["ok"])
|
||||
self._bags_ok = ok
|
||||
self._bags_checked = time.monotonic()
|
||||
return ok
|
||||
|
||||
def _need_groups(self) -> None:
|
||||
if not self.groups_ready():
|
||||
raise ValueError("DB 마이그레이션 inout_db 006(상품 그룹·색상)이 아직 적용되지 않았습니다.")
|
||||
|
||||
def list_groups(self) -> list[dict[str, Any]]:
|
||||
if not self.groups_ready():
|
||||
return []
|
||||
with self._pool.connection() as conn:
|
||||
return conn.execute(
|
||||
"SELECT g.*, (SELECT count(*) FROM inout_products p WHERE p.group_id = g.id)::int AS product_count "
|
||||
"FROM inout_product_groups g ORDER BY g.sort_order, g.name").fetchall()
|
||||
|
||||
def save_group(self, *, group_id: int | None, name: str, silver_pct: Any, color: str, sort_order: int, by: str) -> int:
|
||||
"""그룹 만들기·고치기(store.validate_group 를 거친 값). 같은 이름은 거절. 반환 = 그룹 id."""
|
||||
self._need_groups()
|
||||
try:
|
||||
with self._pool.connection() as conn, conn.transaction():
|
||||
if group_id:
|
||||
row = conn.execute(
|
||||
"UPDATE inout_product_groups SET name=%s, silver_pct=%s, color=%s, sort_order=%s, updated_by=%s, "
|
||||
"updated_at=now() WHERE id=%s RETURNING id",
|
||||
(name, silver_pct, color, sort_order, _norm_email(by), group_id)).fetchone()
|
||||
if not row:
|
||||
raise ValueError("그룹을 찾을 수 없습니다(다른 사람이 지웠을 수 있음).")
|
||||
else:
|
||||
row = conn.execute(
|
||||
"INSERT INTO inout_product_groups (name, silver_pct, color, sort_order, updated_by) "
|
||||
"VALUES (%s,%s,%s,%s,%s) RETURNING id",
|
||||
(name, silver_pct, color, sort_order, _norm_email(by))).fetchone()
|
||||
except UniqueViolation:
|
||||
raise ValueError(f"같은 이름의 그룹이 있습니다: {name}") from None
|
||||
return int(row["id"])
|
||||
|
||||
def delete_group(self, group_id: int) -> str:
|
||||
"""그룹 지우기 — 그 그룹 상품은 그룹 없음(상품 자기 은 함유량·색상)으로. 지난 발주서는 그대로. 반환 = 이름."""
|
||||
self._need_groups()
|
||||
with self._pool.connection() as conn, conn.transaction():
|
||||
row = conn.execute("DELETE FROM inout_product_groups WHERE id=%s RETURNING name", (group_id,)).fetchone()
|
||||
if not row:
|
||||
raise ValueError("그룹을 찾을 수 없습니다.")
|
||||
return str(row["name"])
|
||||
|
||||
# ════════════════════════════════════════════════════════════
|
||||
# 달력(2026-10-21) — 화면 오른쪽 달력에 날짜별 발주(발주일)·입고(입고일). 취소된 발주는 뺀다.
|
||||
# ════════════════════════════════════════════════════════════
|
||||
def calendar(self, start: date, end: date) -> dict[str, list[dict[str, Any]]]:
|
||||
with self._pool.connection() as conn:
|
||||
orders = conn.execute(
|
||||
"SELECT o.id, o.order_no, o.order_date, f.name AS factory_name, "
|
||||
"(SELECT COALESCE(sum(qty), 0) FROM inout_order_lines l WHERE l.order_id = o.id)::int AS qty, "
|
||||
"(SELECT count(*) FROM inout_order_lines l WHERE l.order_id = o.id)::int AS kinds, "
|
||||
"(SELECT l.item_name FROM inout_order_lines l WHERE l.order_id = o.id ORDER BY l.line_no LIMIT 1) AS first_item "
|
||||
"FROM inout_orders o JOIN inout_factories f ON f.id = o.factory_id "
|
||||
"WHERE o.cancelled_at IS NULL AND o.order_date BETWEEN %s AND %s ORDER BY o.order_date, o.id",
|
||||
(start, end)).fetchall()
|
||||
receipts = conn.execute(
|
||||
"SELECT r.id, r.order_id, r.receipt_date, o.order_no, f.name AS factory_name, "
|
||||
"COALESCE(sum(rl.qty), 0)::int AS qty "
|
||||
"FROM inout_receipts r JOIN inout_orders o ON o.id = r.order_id JOIN inout_factories f ON f.id = o.factory_id "
|
||||
"LEFT JOIN inout_receipt_lines rl ON rl.receipt_id = r.id "
|
||||
"WHERE o.cancelled_at IS NULL AND r.receipt_date BETWEEN %s AND %s "
|
||||
"GROUP BY r.id, o.order_no, f.name ORDER BY r.receipt_date, r.id",
|
||||
(start, end)).fetchall()
|
||||
return {"orders": orders, "receipts": receipts}
|
||||
|
||||
# ════════════════════════════════════════════════════════════
|
||||
# 미입고 현황 — 진행 중(종결·취소 아님) 발주의 남은 수량, 그리고 초과 입고
|
||||
# ════════════════════════════════════════════════════════════
|
||||
def outstanding(self, *, factory_id: int | None = None, q: str = "") -> dict[str, list[dict[str, Any]]]:
|
||||
where, params = ["o.closed_at IS NULL", "o.cancelled_at IS NULL"], []
|
||||
if factory_id:
|
||||
where.append("o.factory_id = %s")
|
||||
params.append(factory_id)
|
||||
if q.strip():
|
||||
like = "%" + q.strip().replace("\\", "\\\\").replace("%", "\\%").replace("_", "\\_") + "%"
|
||||
where.append("(l.item_code ILIKE %s OR l.item_name ILIKE %s OR o.order_no ILIKE %s)")
|
||||
params += [like, like, like]
|
||||
with self._pool.connection() as conn:
|
||||
rows = conn.execute(
|
||||
"SELECT o.id AS order_id, o.order_no, o.order_date, o.due_date, f.name AS factory_name, "
|
||||
"l.item_code, l.item_name, l.qty, COALESCE(sum(rl.qty), 0)::int AS received "
|
||||
"FROM inout_order_lines l JOIN inout_orders o ON o.id = l.order_id "
|
||||
"JOIN inout_factories f ON f.id = o.factory_id "
|
||||
"LEFT JOIN inout_receipt_lines rl ON rl.order_line_id = l.id "
|
||||
f"WHERE {' AND '.join(where)} GROUP BY l.id, o.id, f.name "
|
||||
"ORDER BY o.due_date NULLS LAST, o.order_date, o.id, l.line_no", params).fetchall()
|
||||
rows = store.decorate_lines(rows)
|
||||
return {"pending": [r for r in rows if r["remaining"] > 0], "over": [r for r in rows if r["over"] > 0]}
|
||||
|
||||
# ── 내부 ──
|
||||
@staticmethod
|
||||
def _lock_order(conn: Any, order_id: int) -> dict[str, Any]:
|
||||
head = conn.execute("SELECT * FROM inout_orders WHERE id=%s FOR UPDATE", (order_id,)).fetchone()
|
||||
if not head:
|
||||
raise LookupError("발주서를 찾을 수 없습니다.")
|
||||
return head
|
||||
|
||||
@staticmethod
|
||||
def _require_factory(conn: Any, factory_id: int, *, allow_inactive_id: int | None = None) -> None:
|
||||
row = conn.execute("SELECT is_active FROM inout_factories WHERE id=%s", (factory_id,)).fetchone()
|
||||
if not row:
|
||||
raise ValueError("공장을 찾을 수 없습니다.")
|
||||
if not row["is_active"] and factory_id != allow_inactive_id:
|
||||
raise ValueError("사용하지 않는 공장입니다(옵션에서 '사용'으로 바꾸세요).")
|
||||
@@ -0,0 +1,192 @@
|
||||
"""발주 메일 — 발주 담당자 본인 Gmail 로 보내기(2026-10-16 사용자 요청, Gmail API).
|
||||
|
||||
연결(사람마다 한 번): [Gmail 연결] → 구글 동의 화면(로그인과 같은 OAuth 클라이언트 GOOGLE_CLIENT_ID, 범위 = gmail.send 만)
|
||||
→ /inout/gmail/callback 에서 ① 고른 구글 계정이 ERP 로그인 계정과 같은지(다르면 거절 — 남의 메일함으로 보내지 않게)
|
||||
② gmail.send 를 허락했는지 ③ 갱신 토큰이 왔는지 확인 → 갱신 토큰을 APP_ENCRYPTION_KEY(실적 모듈과 같은 마스터 키,
|
||||
AES-256-GCM, AAD = inout:gmail:{email})로 암호화해 inout_gmail_tokens 에. 원문·접근 토큰은 저장·출력하지 않는다.
|
||||
보내기: 갱신 토큰 → 접근 토큰(oauth2.googleapis.com/token) → gmail.users.messages.send(raw = RFC 822, 글 + HTML).
|
||||
사람이 [메일 발송]을 눌렀을 때만 보낸다(자동 발송 없음). 연결이 끊겼으면(invalid_grant·권한 없음) 다시 연결 안내.
|
||||
구글 클라우드 준비(관리자 1회): Gmail API 사용 설정 · OAuth 동의 화면에 …/auth/gmail.send 범위 추가 ·
|
||||
OAuth 클라이언트의 승인된 리디렉션 URI 에 {PUBLIC_BASE_URL}/inout/gmail/callback 추가. 상세 docs/INOUT_MODULE.md.
|
||||
"""
|
||||
|
||||
from __future__ import annotations
|
||||
|
||||
import base64
|
||||
import os
|
||||
from email.message import EmailMessage
|
||||
from email.utils import formataddr
|
||||
from typing import Any
|
||||
|
||||
import httpx
|
||||
|
||||
GMAIL_SCOPE = "https://www.googleapis.com/auth/gmail.send"
|
||||
TOKEN_URI = "https://oauth2.googleapis.com/token"
|
||||
SEND_URI = "https://gmail.googleapis.com/gmail/v1/users/me/messages/send"
|
||||
REVOKE_URI = "https://oauth2.googleapis.com/revoke"
|
||||
CLIENT_NAME = "inout_gmail"
|
||||
|
||||
|
||||
class GmailNotConnected(Exception):
|
||||
"""Gmail 연결이 없거나 끊김 — 다시 [Gmail 연결]."""
|
||||
|
||||
|
||||
class GmailError(Exception):
|
||||
"""보내기 실패(구글 오류 등) — 문구는 화면에 그대로(비밀값 없음)."""
|
||||
|
||||
|
||||
def _http() -> httpx.Client:
|
||||
"""HTTP 클라이언트 — 테스트가 바꿔 끼운다."""
|
||||
return httpx.Client(timeout=20.0)
|
||||
|
||||
|
||||
# ── 토큰 암호화(실적 모듈과 같은 마스터 키) ─────────────────
|
||||
def _ring() -> Any:
|
||||
from app.modules.performance.security.crypto import CryptoConfigError, KeyRing # noqa: WPS433
|
||||
|
||||
try:
|
||||
return KeyRing.from_env()
|
||||
except CryptoConfigError as exc:
|
||||
raise GmailError(f"암호화 키가 없어 Gmail 연결을 저장할 수 없습니다 — {exc}") from None
|
||||
|
||||
|
||||
def _aad(email: str) -> str:
|
||||
return f"inout:gmail:{(email or '').strip().lower()}"
|
||||
|
||||
|
||||
def encrypt_token(email: str, refresh_token: str) -> str:
|
||||
from app.modules.performance.security.crypto import encrypt # noqa: WPS433
|
||||
|
||||
return encrypt(refresh_token, aad=_aad(email), ring=_ring())
|
||||
|
||||
|
||||
def decrypt_token(email: str, enc: str) -> str:
|
||||
from app.modules.performance.security.crypto import DecryptError, decrypt # noqa: WPS433
|
||||
|
||||
try:
|
||||
return decrypt(enc, aad=_aad(email), ring=_ring())
|
||||
except DecryptError:
|
||||
raise GmailNotConnected("저장된 Gmail 연결을 읽을 수 없습니다(암호화 키가 바뀌었을 수 있음) — 다시 연결하세요.") from None
|
||||
|
||||
|
||||
# ── OAuth 클라이언트(로그인과 같은 GOOGLE_CLIENT_ID, 범위만 다름) ──
|
||||
def oauth_client() -> Any:
|
||||
from app.main import env, oauth # noqa: WPS433
|
||||
|
||||
if not env("GOOGLE_CLIENT_ID") or not env("GOOGLE_CLIENT_SECRET"):
|
||||
raise GmailError("GOOGLE_CLIENT_ID/SECRET 이 없어 Gmail 을 연결할 수 없습니다.")
|
||||
client = oauth.create_client(CLIENT_NAME)
|
||||
if client is None:
|
||||
oauth.register(
|
||||
name=CLIENT_NAME,
|
||||
client_id=env("GOOGLE_CLIENT_ID"),
|
||||
client_secret=env("GOOGLE_CLIENT_SECRET"),
|
||||
server_metadata_url="https://accounts.google.com/.well-known/openid-configuration",
|
||||
client_kwargs={"scope": f"openid email {GMAIL_SCOPE}"},
|
||||
)
|
||||
client = oauth.create_client(CLIENT_NAME)
|
||||
return client
|
||||
|
||||
|
||||
def check_grant(token: dict[str, Any], *, expected_email: str) -> tuple[str, str]:
|
||||
"""콜백 토큰 확인 → (갱신 토큰, 허락된 범위). 계정이 다르거나 발송 권한·갱신 토큰이 없으면 GmailError."""
|
||||
info = token.get("userinfo") or {}
|
||||
got = str(info.get("email") or "").strip().lower()
|
||||
want = (expected_email or "").strip().lower()
|
||||
if not got or got != want:
|
||||
raise GmailError(f"ERP 로그인 계정({want})과 다른 구글 계정({got or '알 수 없음'})을 골랐습니다 — 같은 계정으로 다시 연결하세요.")
|
||||
scopes = str(token.get("scope") or "")
|
||||
if GMAIL_SCOPE not in scopes.split():
|
||||
raise GmailError("메일 보내기 권한(gmail.send)을 허락하지 않았습니다 — 동의 화면에서 체크한 뒤 다시 연결하세요.")
|
||||
refresh = str(token.get("refresh_token") or "")
|
||||
if not refresh:
|
||||
raise GmailError("구글이 갱신 토큰을 주지 않았습니다 — 구글 계정 → 보안 → 타사 앱 접근에서 이 앱을 지우고 다시 연결하세요.")
|
||||
return refresh, scopes
|
||||
|
||||
|
||||
# ── 보내기 ──────────────────────────────────────────────
|
||||
def _google_message(resp: httpx.Response) -> str:
|
||||
try:
|
||||
body = resp.json()
|
||||
except ValueError:
|
||||
return f"HTTP {resp.status_code}"
|
||||
err = body.get("error")
|
||||
if isinstance(err, dict):
|
||||
return str(err.get("message") or err.get("status") or resp.status_code)[:200]
|
||||
return str(body.get("error_description") or err or resp.status_code)[:200]
|
||||
|
||||
|
||||
def access_token(refresh_token: str) -> str:
|
||||
from app.main import env # noqa: WPS433
|
||||
|
||||
try:
|
||||
with _http() as client:
|
||||
resp = client.post(TOKEN_URI, data={"client_id": env("GOOGLE_CLIENT_ID"), "client_secret": env("GOOGLE_CLIENT_SECRET"),
|
||||
"refresh_token": refresh_token, "grant_type": "refresh_token"})
|
||||
except httpx.HTTPError as exc:
|
||||
raise GmailError(f"구글 인증 서버에 연결하지 못했습니다({type(exc).__name__}).") from None
|
||||
if resp.status_code != 200:
|
||||
try:
|
||||
code = str(resp.json().get("error") or "")
|
||||
except ValueError:
|
||||
code = ""
|
||||
if code in ("invalid_grant", "unauthorized_client", "invalid_client"):
|
||||
raise GmailNotConnected("Gmail 연결이 끊겼습니다(권한 취소·비밀번호 변경 등) — 다시 연결하세요.")
|
||||
raise GmailError(f"구글 인증 실패: {_google_message(resp)}")
|
||||
token = str(resp.json().get("access_token") or "")
|
||||
if not token:
|
||||
raise GmailError("구글 인증 서버가 접근 토큰을 주지 않았습니다.")
|
||||
return token
|
||||
|
||||
|
||||
def build_message(*, sender_name: str, sender_email: str, to: list[str], cc: list[str], subject: str,
|
||||
text: str, html: str, inline_images: list[dict[str, Any]] | None = None) -> bytes:
|
||||
"""글 + HTML(multipart/alternative). inline_images = [{cid, data(JPEG)}] 면 HTML 쪽을 multipart/related 로 만들어
|
||||
<img src="cid:…"> 가 첨부가 아니라 본문 안 이미지로 보이게 한다(입고 요청 메일, 2026-10-19)."""
|
||||
msg = EmailMessage()
|
||||
msg["From"] = formataddr((sender_name or sender_email, sender_email))
|
||||
msg["To"] = ", ".join(to)
|
||||
if cc:
|
||||
msg["Cc"] = ", ".join(cc)
|
||||
msg["Subject"] = subject
|
||||
msg.set_content(text)
|
||||
msg.add_alternative(html, subtype="html")
|
||||
if inline_images:
|
||||
html_part = msg.get_payload()[1]
|
||||
for im in inline_images: # 파일 이름은 붙이지 않는다 — 메일 프로그램이 첨부 목록에 따로 띄우지 않게
|
||||
html_part.add_related(im["data"], maintype="image", subtype="jpeg", cid=f"<{im['cid']}>", disposition="inline")
|
||||
return msg.as_bytes()
|
||||
|
||||
|
||||
def send(refresh_token: str, raw: bytes) -> str:
|
||||
"""보내고 Gmail 메시지 id 를 돌려준다."""
|
||||
token = access_token(refresh_token)
|
||||
body = {"raw": base64.urlsafe_b64encode(raw).decode("ascii")}
|
||||
try:
|
||||
with _http() as client:
|
||||
resp = client.post(SEND_URI, json=body, headers={"Authorization": f"Bearer {token}"})
|
||||
except httpx.HTTPError as exc:
|
||||
raise GmailError(f"Gmail 에 연결하지 못했습니다({type(exc).__name__}).") from None
|
||||
if resp.status_code in (401, 403):
|
||||
msg = _google_message(resp)
|
||||
if "has not been used" in msg or "disabled" in msg.lower():
|
||||
raise GmailError(f"Gmail API 가 꺼져 있습니다 — 관리자가 구글 클라우드에서 Gmail API 를 사용 설정해야 합니다. ({msg})")
|
||||
raise GmailNotConnected(f"Gmail 보내기 권한이 없습니다 — 다시 연결하세요. ({msg})")
|
||||
if resp.status_code != 200:
|
||||
raise GmailError(f"메일을 보내지 못했습니다: {_google_message(resp)}")
|
||||
return str(resp.json().get("id") or "")
|
||||
|
||||
|
||||
def revoke(refresh_token: str) -> None:
|
||||
"""연결 끊기 — 구글 쪽 권한도 취소(실패해도 무시, 우리 쪽 토큰은 지운다)."""
|
||||
try:
|
||||
with _http() as client:
|
||||
client.post(REVOKE_URI, data={"token": refresh_token})
|
||||
except httpx.HTTPError:
|
||||
pass
|
||||
|
||||
|
||||
def configured() -> bool:
|
||||
"""APP_ENCRYPTION_KEY·GOOGLE_CLIENT_ID/SECRET 이 있는지(화면 안내용)."""
|
||||
return bool(os.getenv("APP_ENCRYPTION_KEY", "").strip() and os.getenv("GOOGLE_CLIENT_ID", "").strip()
|
||||
and os.getenv("GOOGLE_CLIENT_SECRET", "").strip())
|
||||
@@ -0,0 +1,103 @@
|
||||
"""itemcode_db 읽기 전용 — 단품(single_items)만 검색·확인.
|
||||
|
||||
입출고 발주서의 제품은 코드표 DB 의 단품 아이템에서만 고른다(2026-10-16 사용자 요청 — 세트는 공장 발주 대상이 아님).
|
||||
itemcode_db 실제 스키마(운영 확인됨, malaysia/itemcode.py 와 같음): single_items(item_code, sabangnet_code, name).
|
||||
환경변수 `ITEMCODE_DB_URL`(읽기 전용 역할 itemcode_ro) — cupang·malaysia 모듈과 공유.
|
||||
미설정/실패 시 enabled=False, 빈 결과(앱/모듈을 죽이지 않음) — 그때 발주서 저장은 "코드표 연결 필요"로 막는다.
|
||||
"""
|
||||
|
||||
from __future__ import annotations
|
||||
|
||||
import logging
|
||||
import os
|
||||
from typing import Any
|
||||
|
||||
logger = logging.getLogger("inout.itemcode")
|
||||
|
||||
_SEARCH_SQL = (
|
||||
"SELECT item_code, name FROM single_items "
|
||||
"WHERE item_code ILIKE %(q)s OR name ILIKE %(q)s "
|
||||
"ORDER BY (item_code ILIKE %(prefix)s) DESC, item_code ASC LIMIT %(limit)s"
|
||||
)
|
||||
_LOOKUP_SQL = "SELECT item_code, name FROM single_items WHERE upper(item_code) = ANY(%(codes)s)"
|
||||
|
||||
|
||||
class SingleItemReader:
|
||||
def __init__(self, dsn: str | None = None) -> None:
|
||||
self._pool: Any = None
|
||||
self.enabled = False
|
||||
self.reason = ""
|
||||
self.last_error = ""
|
||||
self._configure(dsn if dsn is not None else os.getenv("ITEMCODE_DB_URL", "").strip())
|
||||
|
||||
def _configure(self, dsn: str) -> None:
|
||||
if not dsn:
|
||||
self.reason = "ITEMCODE_DB_URL 미설정 — 코드표(단품) 조회 비활성."
|
||||
return
|
||||
try:
|
||||
from psycopg.rows import dict_row
|
||||
from psycopg_pool import ConnectionPool
|
||||
|
||||
self._pool = ConnectionPool(conninfo=dsn, min_size=1, max_size=3,
|
||||
kwargs={"row_factory": dict_row, "autocommit": True}, open=False)
|
||||
self._pool.open(wait=False)
|
||||
self.enabled = True
|
||||
except Exception as exc: # noqa: BLE001 — 설정/드라이버 문제로 모듈을 죽이지 않음
|
||||
self.reason = f"itemcode_db 연결 풀 생성 실패: {type(exc).__name__}"
|
||||
|
||||
def search(self, query: str, *, limit: int = 30) -> list[dict[str, str]]:
|
||||
"""코드·이름 부분 일치(코드 앞부분 일치 먼저). 반환 [{"code","name"}]. 실패는 빈 목록."""
|
||||
q = (query or "").strip()
|
||||
if not q or not self.enabled or not self._pool:
|
||||
return []
|
||||
esc = q.replace("\\", "\\\\").replace("%", "\\%").replace("_", "\\_")
|
||||
rows = self._run(_SEARCH_SQL, {"q": f"%{esc}%", "prefix": f"{esc}%", "limit": int(limit)})
|
||||
return [{"code": str(r["item_code"]).strip(), "name": str(r.get("name") or "").strip()} for r in rows or []]
|
||||
|
||||
def list_all(self, *, limit: int = 20000) -> list[dict[str, str]] | None:
|
||||
"""단품 전체(옵션 → 상품 정보 → 단품 불러오기). 조회 불가면 None(빈 목록과 구분)."""
|
||||
if not self.enabled or not self._pool:
|
||||
return None
|
||||
rows = self._run("SELECT item_code, name FROM single_items ORDER BY item_code LIMIT %(limit)s", {"limit": int(limit)})
|
||||
if rows is None:
|
||||
return None
|
||||
return [{"code": str(r["item_code"]).strip().upper(), "name": str(r.get("name") or "").strip()} for r in rows if r.get("item_code")]
|
||||
|
||||
def lookup(self, codes: list[str]) -> dict[str, str] | None:
|
||||
"""코드들 → {코드(대문자): 이름}. 단품 표에 없는 코드는 빠진다. 조회 불가면 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(_LOOKUP_SQL, {"codes": wanted})
|
||||
if rows is None:
|
||||
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:
|
||||
rows = conn.execute(sql, params).fetchall()
|
||||
self.last_error = ""
|
||||
return rows
|
||||
except Exception as exc: # noqa: BLE001 — 모듈을 죽이지 않음
|
||||
self.last_error = f"{type(exc).__name__}"
|
||||
logger.exception("itemcode(single_items) 조회 실패")
|
||||
return None
|
||||
|
||||
def close(self) -> None:
|
||||
if self._pool is not None:
|
||||
self._pool.close()
|
||||
File diff suppressed because it is too large
Load Diff
@@ -0,0 +1,998 @@
|
||||
"""입출고 관리 — 상수·검사·상태 계산(순수 함수, DB 없음).
|
||||
|
||||
흐름(2026-10-16 사용자 요청, 상용 ERP 참고 — 이카운트 "발주 대비 미입고 현황"·Odoo 분할 입고/잔량 종결):
|
||||
발주 담당이 공장에 발주서(단품 코드·수량)를 넣고 → 물류에 들어올 때마다 입고 담당이 그날 들어온 수량을 입력(여러 번 나눠도 됨)
|
||||
→ 품목마다 발주 − 누적 입고 = 미입고. 다 들어오면 입고완료, 더 들어오면 초과입고(확인 후 허용, 빨강 표시).
|
||||
더 안 들어올 잔량은 발주 담당이 "종결"(이카운트 발주 종결 · Odoo No backorder) — 미입고 현황에서 빠지고 종결로 남는다.
|
||||
"""
|
||||
|
||||
from __future__ import annotations
|
||||
|
||||
import html as _html
|
||||
import html.parser as _html_parser
|
||||
import re
|
||||
from datetime import date, datetime
|
||||
from decimal import ROUND_HALF_UP, Decimal, InvalidOperation
|
||||
from typing import Any, Iterable
|
||||
|
||||
ROLE_ORDER = "order" # 발주 담당
|
||||
ROLE_RECEIVE = "receive" # 입고 담당
|
||||
ROLES = (ROLE_ORDER, ROLE_RECEIVE)
|
||||
ROLE_LABELS = {ROLE_ORDER: "발주 담당", ROLE_RECEIVE: "입고 담당"}
|
||||
|
||||
MAX_QTY = 10_000_000
|
||||
MAX_LINES = 200
|
||||
MEMO_MAX = 500
|
||||
|
||||
# 품목 상태
|
||||
LINE_NONE, LINE_PARTIAL, LINE_DONE, LINE_OVER = "none", "partial", "done", "over"
|
||||
LINE_LABELS = {LINE_NONE: "미입고", LINE_PARTIAL: "부분입고", LINE_DONE: "입고완료", LINE_OVER: "초과입고"}
|
||||
|
||||
# 발주서 상태 — 진행(open·partial)은 미입고 현황에 나온다
|
||||
ST_OPEN, ST_PARTIAL, ST_DONE, ST_OVER, ST_CLOSED, ST_CANCELLED = "open", "partial", "done", "over", "closed", "cancelled"
|
||||
# 모든 품목이 입고완료·초과입고 = "전체 입고 완료"(2026-10-17 요청 — 초과가 있으면 화면에 "초과 포함"만 덧붙인다)
|
||||
ORDER_LABELS = {ST_OPEN: "발주", ST_PARTIAL: "부분입고", ST_DONE: "전체 입고 완료", ST_OVER: "전체 입고 완료",
|
||||
ST_CLOSED: "종결", ST_CANCELLED: "취소"}
|
||||
ACTIVE_STATUSES = (ST_OPEN, ST_PARTIAL) # 아직 더 들어올 것이 있는 발주
|
||||
STATUS_FILTERS = { # 목록 거르기
|
||||
"active": ("진행 중", ACTIVE_STATUSES),
|
||||
"done": ("완료", (ST_DONE, ST_OVER)),
|
||||
"closed": ("종결·취소", (ST_CLOSED, ST_CANCELLED)),
|
||||
"all": ("전체", tuple(ORDER_LABELS)),
|
||||
}
|
||||
|
||||
|
||||
WEEKDAYS_KO = "월화수목금토일"
|
||||
|
||||
|
||||
def fmt_date(d: date | None) -> str:
|
||||
"""날짜 서식 — 2026.10.17(토). 입출고 화면·메일 모두 이 모양(2026-10-17 요청). 화면 쪽은 _macros.html ymd 와 같다."""
|
||||
if not d:
|
||||
return ""
|
||||
return f"{d:%Y.%m.%d}({WEEKDAYS_KO[d.weekday()]})"
|
||||
|
||||
|
||||
def fmt_datetime(dt: datetime | None) -> str:
|
||||
"""2026.10.17(토) 15:14 — 시각은 DB 에서 KST 로 읽는다(db._KstTimestamptzLoader)."""
|
||||
return f"{fmt_date(dt)} {dt:%H:%M}" if dt else ""
|
||||
|
||||
|
||||
def line_status(qty: int, received: int) -> str:
|
||||
if received <= 0:
|
||||
return LINE_NONE
|
||||
if received < qty:
|
||||
return LINE_PARTIAL
|
||||
return LINE_DONE if received == qty else LINE_OVER
|
||||
|
||||
|
||||
def order_status(lines: Iterable[dict[str, Any]], *, closed: bool = False, cancelled: bool = False) -> str:
|
||||
"""lines: [{qty, received}]. 취소·종결이 먼저, 그다음 입고 합계로."""
|
||||
if cancelled:
|
||||
return ST_CANCELLED
|
||||
if closed:
|
||||
return ST_CLOSED
|
||||
sts = [line_status(int(x["qty"]), int(x.get("received") or 0)) for x in lines]
|
||||
if not sts or all(s == LINE_NONE for s in sts):
|
||||
return ST_OPEN
|
||||
if any(s in (LINE_NONE, LINE_PARTIAL) for s in sts):
|
||||
return ST_PARTIAL
|
||||
return ST_OVER if any(s == LINE_OVER for s in sts) else ST_DONE
|
||||
|
||||
|
||||
def summarize(lines: list[dict[str, Any]]) -> dict[str, int]:
|
||||
"""발주·입고·미입고(0 아래로 안 내려감)·초과 합계."""
|
||||
ordered = sum(int(x["qty"]) for x in lines)
|
||||
received = sum(int(x.get("received") or 0) for x in lines)
|
||||
remaining = sum(max(int(x["qty"]) - int(x.get("received") or 0), 0) for x in lines)
|
||||
over = sum(max(int(x.get("received") or 0) - int(x["qty"]), 0) for x in lines)
|
||||
pct = min(100, round(received * 100 / ordered)) if ordered else 0
|
||||
return {"ordered": ordered, "received": received, "remaining": remaining, "over": over, "pct": pct}
|
||||
|
||||
|
||||
def decorate_lines(lines: list[dict[str, Any]]) -> list[dict[str, Any]]:
|
||||
"""화면용 — 품목마다 미입고·초과·상태 이름."""
|
||||
out = []
|
||||
for x in lines:
|
||||
qty, rec = int(x["qty"]), int(x.get("received") or 0)
|
||||
st = line_status(qty, rec)
|
||||
out.append({**x, "received": rec, "remaining": max(qty - rec, 0), "over": max(rec - qty, 0),
|
||||
"status": st, "status_label": LINE_LABELS[st]})
|
||||
return out
|
||||
|
||||
|
||||
# ── 입력 검사 ────────────────────────────────────────────────
|
||||
def parse_qty(raw: Any, *, label: str = "수량", allow_zero: bool = False) -> int:
|
||||
s = str(raw if raw is not None else "").replace(",", "").strip()
|
||||
if not s:
|
||||
if allow_zero:
|
||||
return 0
|
||||
raise ValueError(f"{label}을(를) 입력하세요.")
|
||||
try:
|
||||
n = int(s)
|
||||
except ValueError:
|
||||
raise ValueError(f"{label}은(는) 정수로 입력하세요.") from None
|
||||
if n < 0 or (n == 0 and not allow_zero):
|
||||
raise ValueError(f"{label}은(는) {0 if allow_zero else 1} 이상이어야 합니다.")
|
||||
if n > MAX_QTY:
|
||||
raise ValueError(f"{label}이(가) 너무 큽니다.")
|
||||
return n
|
||||
|
||||
|
||||
def parse_date(raw: Any, *, label: str, required: bool = True) -> date | None:
|
||||
s = str(raw or "").strip()
|
||||
if not s:
|
||||
if required:
|
||||
raise ValueError(f"{label}을(를) 입력하세요.")
|
||||
return None
|
||||
try:
|
||||
return date.fromisoformat(s)
|
||||
except ValueError:
|
||||
raise ValueError(f"{label} 형식이 올바르지 않습니다(YYYY-MM-DD).") from None
|
||||
|
||||
|
||||
def validate_order(*, factory_id: Any, order_date: Any, due_date: Any, memo: Any,
|
||||
codes: list[str], quantities: list[str], line_memos: list[str] | None = None) -> dict[str, Any]:
|
||||
"""발주서 폼 → 정리된 값. 빈 줄(코드·수량 둘 다 없음)은 건너뛴다. 같은 제품 두 줄은 오류."""
|
||||
errors: list[str] = []
|
||||
try:
|
||||
fid = int(str(factory_id or "").strip())
|
||||
except ValueError:
|
||||
fid = 0
|
||||
if fid <= 0:
|
||||
errors.append("공장을 고르세요.")
|
||||
od = dd = None
|
||||
try:
|
||||
od = parse_date(order_date, label="발주일")
|
||||
except ValueError as exc:
|
||||
errors.append(str(exc))
|
||||
try:
|
||||
dd = parse_date(due_date, label="입고 예정일", required=False)
|
||||
except ValueError as exc:
|
||||
errors.append(str(exc))
|
||||
if od and dd and dd < od:
|
||||
errors.append("입고 예정일이 발주일보다 빠릅니다.")
|
||||
line_memos = line_memos or []
|
||||
lines: list[dict[str, Any]] = []
|
||||
seen: set[str] = set()
|
||||
for i, code in enumerate(codes):
|
||||
code = (code or "").strip().upper()
|
||||
raw_qty = quantities[i] if i < len(quantities) else ""
|
||||
if not code and not str(raw_qty or "").strip():
|
||||
continue
|
||||
if not code:
|
||||
errors.append(f"{i + 1}번째 줄: 제품을 고르세요.")
|
||||
continue
|
||||
if code in seen:
|
||||
errors.append(f"{code}: 같은 제품이 두 줄에 있습니다 — 한 줄로 합쳐 주세요.")
|
||||
continue
|
||||
seen.add(code)
|
||||
try:
|
||||
qty = parse_qty(raw_qty, label=f"{code} 발주 수량")
|
||||
except ValueError as exc:
|
||||
errors.append(str(exc))
|
||||
continue
|
||||
lines.append({"item_code": code, "qty": qty,
|
||||
"memo": str(line_memos[i] if i < len(line_memos) else "").strip()[:MEMO_MAX]})
|
||||
if not lines and not any("줄" in e or "수량" in e for e in errors):
|
||||
errors.append("발주할 제품을 한 줄 이상 넣으세요.")
|
||||
if len(lines) > MAX_LINES:
|
||||
errors.append(f"한 발주서에 {MAX_LINES}개 제품까지 넣을 수 있습니다.")
|
||||
if errors:
|
||||
raise ValueError("\n".join(errors))
|
||||
return {"factory_id": fid, "order_date": od, "due_date": dd, "memo": str(memo or "").strip()[:MEMO_MAX], "lines": lines}
|
||||
|
||||
|
||||
def validate_receipt(order_lines: list[dict[str, Any]], quantities: dict[int, Any], *,
|
||||
receipt_date: Any, memo: Any) -> dict[str, Any]:
|
||||
"""입고 입력 — quantities: {발주 줄 id: 입력값}. 빈칸·0 은 이번에 안 들어온 것.
|
||||
over = 이번 입고로 발주를 넘는 품목(확인 받은 뒤 저장). order_lines 는 지금까지 누적 입고(received)를 포함."""
|
||||
errors: list[str] = []
|
||||
try:
|
||||
rd = parse_date(receipt_date, label="입고일")
|
||||
except ValueError as exc:
|
||||
errors.append(str(exc))
|
||||
rd = None
|
||||
by_id = {int(x["id"]): x for x in order_lines}
|
||||
items: list[dict[str, Any]] = []
|
||||
over: list[dict[str, Any]] = []
|
||||
for lid, raw in quantities.items():
|
||||
line = by_id.get(int(lid))
|
||||
if line is None:
|
||||
errors.append("이 발주서에 없는 품목이 들어 있습니다.")
|
||||
continue
|
||||
try:
|
||||
qty = parse_qty(raw, label=f"{line['item_code']} 입고 수량", allow_zero=True)
|
||||
except ValueError as exc:
|
||||
errors.append(str(exc))
|
||||
continue
|
||||
if qty == 0:
|
||||
continue
|
||||
items.append({"order_line_id": int(lid), "qty": qty})
|
||||
after = int(line.get("received") or 0) + qty
|
||||
if after > int(line["qty"]):
|
||||
over.append({"item_code": line["item_code"], "item_name": line.get("item_name", ""),
|
||||
"ordered": int(line["qty"]), "after": after, "over": after - int(line["qty"])})
|
||||
if not items and not errors:
|
||||
errors.append("입고 수량을 한 품목 이상 넣으세요.")
|
||||
if errors:
|
||||
raise ValueError("\n".join(errors))
|
||||
return {"receipt_date": rd, "memo": str(memo or "").strip()[:MEMO_MAX], "items": items, "over": over}
|
||||
|
||||
|
||||
def order_no(order_date: date, seq: int) -> str:
|
||||
"""PO-YYMMDD-NN — 발주일 기준 그날 순번(01부터)."""
|
||||
return f"PO-{order_date:%y%m%d}-{seq:02d}"
|
||||
|
||||
|
||||
# ════════════════════════════════════════════════════════════
|
||||
# 발주 메일(2026-10-16, 마이그레이션 003) — 받는 주소 검사, 본문(요약) 만들기. 보내기는 gmail.py
|
||||
# ════════════════════════════════════════════════════════════
|
||||
MAX_RECIPIENTS = 10
|
||||
_EMAIL_RE = re.compile(r"^[A-Za-z0-9._%+\-']+@[A-Za-z0-9.\-]+\.[A-Za-z]{2,}$")
|
||||
|
||||
|
||||
def parse_emails(raw: Any, *, label: str = "이메일", required: bool = False) -> list[str]:
|
||||
"""'a@x.com, b@y.co.kr; c@z.com' → 주소 목록(순서 유지·중복 제거). 형식이 틀리면 ValueError."""
|
||||
out: list[str] = []
|
||||
for part in re.split(r"[\s,;]+", str(raw or "")):
|
||||
if not part:
|
||||
continue
|
||||
if not _EMAIL_RE.match(part) or len(part) > 254:
|
||||
raise ValueError(f"{label} 형식이 올바르지 않습니다: {part[:60]}")
|
||||
if part.lower() not in [x.lower() for x in out]:
|
||||
out.append(part)
|
||||
if required and not out:
|
||||
raise ValueError(f"{label}을(를) 입력하세요.")
|
||||
if len(out) > MAX_RECIPIENTS:
|
||||
raise ValueError(f"{label}은(는) {MAX_RECIPIENTS}개까지 넣을 수 있습니다.")
|
||||
return out
|
||||
|
||||
|
||||
# 간단 발주 메일(2026-11-04) — 이 공장들엔 품목 표를 번호·제품 코드·제품명·수량·박스당 수량·박스 수·비고만, 요약에서도 금액·무게·은을 뺀다.
|
||||
SIMPLE_MAIL_FACTORIES = ("대성화학", "인천공장")
|
||||
|
||||
|
||||
def is_simple_mail_factory(name: Any) -> bool:
|
||||
"""이름 일부·띄어쓰기가 달라도 맞게 — 놓치면 단가가 공장에 나간다."""
|
||||
compact = "".join(str(name or "").split())
|
||||
return any(word in compact for word in SIMPLE_MAIL_FACTORIES)
|
||||
|
||||
|
||||
def line_boxes(x: dict[str, Any]) -> dict[str, Any]:
|
||||
"""간단 발주 메일 칸 — 박스당 수량·박스 수(올림). 뚜껑이 있으면 통·뚜껑 따로, 입수가 없으면 '-'(total None)."""
|
||||
body, lid, qty = x.get("body_per_box"), x.get("lid_per_box"), int(x["qty"])
|
||||
if not body:
|
||||
return {"per": "-", "count": "-", "total": None}
|
||||
boxes = -(-qty // body)
|
||||
if not lid:
|
||||
return {"per": f"{body:,}개", "count": f"{boxes:,}박스", "total": boxes}
|
||||
lids = -(-qty // lid)
|
||||
return {"per": f"통 {body:,}개 · 뚜껑 {lid:,}개", "count": f"통 {boxes:,} · 뚜껑 {lids:,}박스", "total": boxes + lids}
|
||||
|
||||
|
||||
def order_mail(order: dict[str, Any], *, sender_name: str, sender_email: str) -> dict[str, str]:
|
||||
"""발주서 → 메일 제목·글 본문·HTML 본문(요약). order = db.get_order 결과.
|
||||
품목마다 단가·금액(수량 × 단가)·전체 무게(개당 g × 수량, kg)·PP 사용량(전체 무게 − 은 무게, kg)·은 함유량(%·전체 무게 × %, kg)
|
||||
— 발주 품목에 남긴 그때 값(004). 없으면 '-'. (2026-10-19 — 예전엔 PP(g/개)·개당 은 g)"""
|
||||
lines = order["lines"]
|
||||
first = (lines[0]["item_name"] or lines[0]["item_code"]) if lines else ""
|
||||
more = f" 외 {len(lines) - 1}종" if len(lines) > 1 else ""
|
||||
subject = f"[발주] {order['order_no']} · {order['factory_name']} · {first}{more}"
|
||||
total = sum(int(x["qty"]) for x in lines)
|
||||
money = order_totals(lines)
|
||||
due = fmt_date(order["due_date"]) if order.get("due_date") else "협의"
|
||||
greet = f"{order['factory_manager']}님, 안녕하세요." if order.get("factory_manager") else "안녕하세요."
|
||||
who = sender_name or sender_email
|
||||
facts = [("발주번호", order["order_no"]), ("발주일", fmt_date(order["order_date"])),
|
||||
("입고 예정일", due), ("품목", f"{len(lines)}종 · 총 {total:,}개")]
|
||||
simple = is_simple_mail_factory(order.get("factory_name"))
|
||||
ag_kg = money["silver_g"] / Decimal(1000) if money["silver_g"] is not None else None
|
||||
if not simple:
|
||||
if money["amount"] is not None:
|
||||
note = f" (단가 미입력 {money['missing_price']}종 제외)" if money["missing_price"] else ""
|
||||
facts.append(("발주 금액", f"{fmt_num(money['amount'])}원{note}"))
|
||||
if money["pp_kg"] is not None:
|
||||
facts.append(("전체 무게", f"{fmt_num(money['pp_kg'], 3)} kg"))
|
||||
if money["pp_use_kg"] is not None:
|
||||
facts.append(("PP 사용량", f"{fmt_num(money['pp_use_kg'], 3)} kg"))
|
||||
if ag_kg is not None:
|
||||
facts.append(("은(Ag) 총량", f"{fmt_num(ag_kg, 4)} kg"))
|
||||
if order.get("memo"):
|
||||
facts.append(("요청 사항", order["memo"]))
|
||||
|
||||
def cells(x: dict[str, Any]) -> dict[str, str]:
|
||||
price, pct = to_dec(x.get("unit_price")), to_dec(x.get("silver_pct"))
|
||||
amt = line_amount(int(x["qty"]), price)
|
||||
use = line_usage(x)
|
||||
total_kg, ag_kg = use["total_kg"], use["ag_kg"]
|
||||
return {"price": fmt_num(price) if price is not None else "-", "amount": fmt_num(amt) if amt is not None else "-",
|
||||
"weight": fmt_num(total_kg, 3) if total_kg is not None else "-",
|
||||
"pp_use": fmt_num(total_kg - ag_kg, 3) if ag_kg is not None else "-",
|
||||
"ag": (f"{fmt_num(pct, 4)}%" + (f" ({fmt_num(ag_kg, 4)}kg)" if ag_kg is not None else "")) if pct is not None else "-"}
|
||||
|
||||
# 글 본문(HTML 을 못 보는 메일 프로그램용)
|
||||
text = [greet, "", "아래와 같이 제품 제작을 발주합니다.", ""]
|
||||
text += [f"- {k}: {v}" for k, v in facts]
|
||||
text += ["", "[발주 품목] 제품 코드 · 제품명 · 수량 · 박스당 수량 · 박스 수 · 비고" if simple else "[발주 품목] 수량 · 단가 · 금액 · 전체 무게 · PP 사용량 · 은 함유량"]
|
||||
for i, x in enumerate(lines, start=1):
|
||||
c = cells(x)
|
||||
b = line_boxes(x)
|
||||
if simple:
|
||||
detail = f" · 박스당 {b['per']} · {b['count']}" if b["total"] is not None else ""
|
||||
else:
|
||||
detail = (f" · 단가 {c['price']} · 금액 {c['amount']}"
|
||||
f" · 전체 무게 {c['weight'] + 'kg' if c['weight'] != '-' else '-'}"
|
||||
f" · PP 사용량 {c['pp_use'] + 'kg' if c['pp_use'] != '-' else '-'} · 은 {c['ag']}")
|
||||
text.append(f"{i}. {x['item_code']} {x['item_name']} — {int(x['qty']):,}개{detail}"
|
||||
+ (f" ({x['memo']})" if x.get("memo") else ""))
|
||||
text += ["", "입고 예정일까지 물류로 입고 부탁드리며, 일정이 바뀌면 회신 부탁드립니다.", "", f"발주 담당: {who} ({sender_email})"]
|
||||
# HTML 본문 — 값은 모두 escape
|
||||
e = _html.escape
|
||||
td = "padding:6px 10px;border:1px solid #d9dce1;"
|
||||
r = "text-align:right;white-space:nowrap;"
|
||||
# 요약 표 = 항목·값 두 쌍씩 한 줄(4열, 2026-10-19 — 예전 2열 × 8행). 요청 사항(길 수 있음)은 맨 아래 한 줄 전체.
|
||||
# 칸 높이는 글자 한 줄에 맞게 — 받은 메일(메일 프로그램)에서 칸이 크게 늘어나 보여 줄 높이·글자 크기·위아래 여백을 칸마다 못 박는다.
|
||||
ftd = "padding:4px 10px;border:1px solid #d9dce1;font-size:14px;line-height:20px;height:20px;vertical-align:middle;white-space:nowrap;"
|
||||
fth = f"{ftd}background:#f6f7f9;text-align:left;font-weight:700;"
|
||||
pairs = [(k, v) for k, v in facts if k != "요청 사항"]
|
||||
fact_rows = ""
|
||||
for i in range(0, len(pairs), 2):
|
||||
cols = "".join(f'<th style="{fth}">{e(k)}</th><td style="{ftd}">{e(str(v))}</td>' for k, v in pairs[i:i + 2])
|
||||
if len(pairs[i:i + 2]) == 1:
|
||||
cols += f'<th style="{fth}"></th><td style="{ftd}"></td>'
|
||||
fact_rows += f"<tr>{cols}</tr>"
|
||||
if order.get("memo"): # 요청 사항은 길면 줄을 바꿔야 하므로 높이를 고정하지 않는다
|
||||
memo_td = "padding:4px 10px;border:1px solid #d9dce1;font-size:14px;line-height:20px;vertical-align:middle;"
|
||||
fact_rows += (f'<tr><th style="{fth}">요청 사항</th>'
|
||||
f'<td colspan="3" style="{memo_td}">{e(str(order["memo"]))}</td></tr>')
|
||||
rows = []
|
||||
for i, x in enumerate(lines, start=1):
|
||||
c = cells(x)
|
||||
# 색상 있는 품목(006) = 줄 전체 배경 그 색 — 메일 프로그램이 tr 배경을 무시하기도 해서 칸마다도 칠한다
|
||||
hexc = color_hex(x.get("color"))
|
||||
ctd = f"{td}background:{hexc};" if hexc else td
|
||||
tr_style = f' style="background:{hexc}"' if hexc else ""
|
||||
b = line_boxes(x)
|
||||
detail = (f'<td style="{ctd}{r}">{e(b["per"])}</td><td style="{ctd}{r}">{e(b["count"])}</td>') if simple else (
|
||||
f'<td style="{ctd}{r}">{e(c["price"])}</td><td style="{ctd}{r}">{e(c["amount"])}</td>'
|
||||
f'<td style="{ctd}{r}">{e(c["weight"])}</td><td style="{ctd}{r}">{e(c["pp_use"])}</td><td style="{ctd}{r}">{e(c["ag"])}</td>')
|
||||
rows.append(
|
||||
f'<tr{tr_style}><td style="{ctd}text-align:center">{i}</td>'
|
||||
f'<td style="{ctd}font-family:Consolas,monospace">{e(x["item_code"])}</td>'
|
||||
f'<td style="{ctd}">{e(x["item_name"])}</td><td style="{ctd}{r}">{int(x["qty"]):,}</td>{detail}'
|
||||
f'<td style="{ctd}">{e(x.get("memo") or "")}</td></tr>')
|
||||
# 합계 줄(2026-10-21) — 금액 뒤 " 원", 무게 뒤 " kg", 무게는 소수 첫째 자리에서 반올림(정수 kg)
|
||||
foot_amount = f'{fmt_num(money["amount"])} 원' if money["amount"] is not None else ""
|
||||
foot_pp = f'{fmt_num(money["pp_kg"], 0)} kg' if money["pp_kg"] is not None else ""
|
||||
foot_use = f'{fmt_num(money["pp_use_kg"], 0)} kg' if money["pp_use_kg"] is not None else ""
|
||||
foot_ag = f'{fmt_num(ag_kg, 0)} kg' if ag_kg is not None else ""
|
||||
bg = "background:#f6f7f9;"
|
||||
box_totals = [t for t in (line_boxes(x)["total"] for x in lines) if t is not None]
|
||||
foot_boxes = f"{sum(box_totals):,}박스" if box_totals else ""
|
||||
if box_totals and len(box_totals) < len(lines):
|
||||
foot_boxes += f" (미설정 {len(lines) - len(box_totals)}종 제외)"
|
||||
head_detail = f'<th style="{td}">박스당 수량</th><th style="{td}">박스 수</th>' if simple else (
|
||||
f'<th style="{td}">단가(원)</th><th style="{td}">금액(원)</th>'
|
||||
f'<th style="{td}">전체 무게(kg)</th><th style="{td}">PP 사용량(kg)</th><th style="{td}">은(Ag) 함유량</th>')
|
||||
foot_detail = f'<th style="{td}{bg}"></th><th style="{td}{bg}{r}">{e(foot_boxes)}</th>' if simple else (
|
||||
f'<th style="{td}{bg}"></th><th style="{td}{bg}{r}">{e(foot_amount)}</th>'
|
||||
f'<th style="{td}{bg}{r}">{e(foot_pp)}</th><th style="{td}{bg}{r}">{e(foot_use)}</th><th style="{td}{bg}{r}">{e(foot_ag)}</th>')
|
||||
html = (
|
||||
'<div style="font-family:\'Malgun Gothic\',\'Apple SD Gothic Neo\',sans-serif;font-size:14px;color:#1d1d1f;line-height:1.6">'
|
||||
f"<p>{e(greet)}<br>아래와 같이 제품 제작을 발주합니다.</p>"
|
||||
f'<table cellpadding="0" cellspacing="0" style="border-collapse:collapse;margin:8px 0 0">{fact_rows}</table>'
|
||||
# 두 표 사이 18px — 표 margin 은 메일 프로그램마다 무시되기도 해서 높이 18px 빈 줄로 띄운다
|
||||
'<div style="height:18px;line-height:18px;font-size:1px"> </div>'
|
||||
'<table style="border-collapse:collapse;min-width:640px;margin:0">'
|
||||
f'<thead><tr style="{bg}"><th style="{td}">{"번호" if simple else "No"}</th><th style="{td}">제품 코드</th><th style="{td}">제품명</th>'
|
||||
f'<th style="{td}">수량</th>{head_detail}'
|
||||
f'<th style="{td}">비고</th></tr></thead>'
|
||||
f'<tbody>{"".join(rows)}</tbody>'
|
||||
f'<tfoot><tr><th colspan="3" style="{td}{bg}text-align:right">합계</th>'
|
||||
f'<th style="{td}{bg}{r}">{total:,}</th>{foot_detail}'
|
||||
f'<th style="{td}{bg}"></th></tr></tfoot></table>'
|
||||
"<p>입고 예정일까지 물류로 입고 부탁드리며, 일정이 바뀌면 회신 부탁드립니다.</p>"
|
||||
f'<p style="color:#555">발주 담당: {e(who)} (<a href="mailto:{e(sender_email)}">{e(sender_email)}</a>)</p></div>'
|
||||
)
|
||||
return {"subject": subject, "text": "\n".join(text), "html": html}
|
||||
|
||||
|
||||
# 발주 메일 본문 고치기(2026-10-27) — 미리보기 창에서 사람이 고친 HTML 을 그대로 보낸다.
|
||||
# 표·서식(인라인 style)은 남기고 스크립트·이벤트 속성·외부 리소스(url()·img)는 뺀다. 글 버전은 고친 HTML 에서 다시 만든다.
|
||||
MAIL_HTML_MAX = 300_000
|
||||
_MAIL_TAGS = {"div", "p", "br", "span", "b", "strong", "i", "em", "u", "s", "strike", "font", "a", "ul", "ol", "li",
|
||||
"h1", "h2", "h3", "h4", "blockquote", "sub", "sup", "hr",
|
||||
"table", "thead", "tbody", "tfoot", "tr", "th", "td", "colgroup", "col", "caption"}
|
||||
_MAIL_VOID = {"br", "hr", "col"}
|
||||
_MAIL_DROP = {"script", "style", "iframe", "object", "embed", "head", "title", "template", "noscript", "svg", "math",
|
||||
"textarea", "select", "button", "form", "input", "link", "meta"}
|
||||
_MAIL_ATTRS = {"colspan", "rowspan", "cellpadding", "cellspacing", "border", "align", "valign", "width", "height", "color"}
|
||||
_MAIL_STYLE_PROPS = {"color", "background", "background-color", "font-family", "font-size", "font-weight", "font-style",
|
||||
"text-decoration", "text-align", "vertical-align", "white-space", "line-height", "height", "width",
|
||||
"min-width", "max-width", "padding", "padding-top", "padding-right", "padding-bottom", "padding-left",
|
||||
"margin", "margin-top", "margin-right", "margin-bottom", "margin-left", "border", "border-top",
|
||||
"border-right", "border-bottom", "border-left", "border-color", "border-collapse", "border-spacing"}
|
||||
_MAIL_STYLE_VALUE_RE = re.compile(r"^[#\w\s.,%()'\"-]{1,120}$")
|
||||
_MAIL_ATTR_VALUE_RE = re.compile(r"^[#\w%.-]{1,20}$")
|
||||
|
||||
|
||||
def _mail_style(value: str) -> str:
|
||||
out = []
|
||||
for decl in value.split(";"):
|
||||
prop, _, val = decl.partition(":")
|
||||
prop, val = prop.strip().lower(), val.strip()
|
||||
if prop == "text-decoration-line": # 서식 막대(Chrome execCommand)가 밑줄·취소선을 이렇게 만든다 — 메일 프로그램은 text-decoration 만 아는 곳이 많다
|
||||
prop = "text-decoration"
|
||||
if prop in _MAIL_STYLE_PROPS and _MAIL_STYLE_VALUE_RE.match(val) and not re.search(r"url|expression|@import", val, re.I):
|
||||
out.append(f"{prop}:{val}")
|
||||
return ";".join(out)
|
||||
|
||||
|
||||
class _MailSanitizer(_html_parser.HTMLParser):
|
||||
def __init__(self) -> None:
|
||||
super().__init__(convert_charrefs=True)
|
||||
self.out: list[str] = []
|
||||
self.stack: list[str] = []
|
||||
self.skip = 0
|
||||
|
||||
def handle_starttag(self, tag: str, attrs: list[tuple[str, str | None]]) -> None:
|
||||
if tag in _MAIL_DROP:
|
||||
self.skip += 1
|
||||
return
|
||||
if self.skip or tag not in _MAIL_TAGS:
|
||||
return
|
||||
extra = ""
|
||||
for k, v in attrs:
|
||||
v = (v or "").strip()
|
||||
if k == "style":
|
||||
style = _mail_style(v)
|
||||
if style:
|
||||
extra += f' style="{_html.escape(style)}"'
|
||||
elif k == "href" and tag == "a" and re.match(r"^(https?:|mailto:)", v, re.I):
|
||||
extra += f' href="{_html.escape(v)}"'
|
||||
elif k in _MAIL_ATTRS and _MAIL_ATTR_VALUE_RE.match(v):
|
||||
extra += f' {k}="{_html.escape(v)}"'
|
||||
self.out.append(f"<{tag}{extra}>")
|
||||
if tag not in _MAIL_VOID:
|
||||
self.stack.append(tag)
|
||||
|
||||
def handle_startendtag(self, tag: str, attrs: list[tuple[str, str | None]]) -> None:
|
||||
if tag in _MAIL_VOID:
|
||||
self.handle_starttag(tag, attrs)
|
||||
|
||||
def handle_endtag(self, tag: str) -> None:
|
||||
if tag in _MAIL_DROP:
|
||||
self.skip = max(0, self.skip - 1)
|
||||
return
|
||||
if self.skip or tag not in self.stack:
|
||||
return
|
||||
while self.stack:
|
||||
t = self.stack.pop()
|
||||
self.out.append(f"</{t}>")
|
||||
if t == tag:
|
||||
break
|
||||
|
||||
def handle_data(self, data: str) -> None:
|
||||
if not self.skip:
|
||||
self.out.append(_html.escape(data, quote=False))
|
||||
|
||||
def result(self) -> str:
|
||||
self.close()
|
||||
while self.stack:
|
||||
self.out.append(f"</{self.stack.pop()}>")
|
||||
return "".join(self.out)
|
||||
|
||||
|
||||
class _MailText(_html_parser.HTMLParser):
|
||||
"""HTML → 글 버전 — 문단·줄은 줄바꿈, 표 칸은 " | " 로 잇는다."""
|
||||
|
||||
_BLOCK = {"p", "div", "tr", "li", "h1", "h2", "h3", "h4", "blockquote", "table", "hr"}
|
||||
|
||||
def __init__(self) -> None:
|
||||
super().__init__(convert_charrefs=True)
|
||||
self.parts: list[str] = []
|
||||
self.cell = False # 이 줄에 이미 칸이 있다 — 다음 칸 앞에 구분자
|
||||
|
||||
def handle_starttag(self, tag: str, attrs: list[tuple[str, str | None]]) -> None:
|
||||
if tag == "br" or tag in self._BLOCK:
|
||||
self.parts.append("\n")
|
||||
self.cell = False
|
||||
elif tag in ("td", "th"):
|
||||
if self.cell:
|
||||
self.parts.append(" | ")
|
||||
self.cell = True
|
||||
if tag == "li":
|
||||
self.parts.append("- ")
|
||||
|
||||
def handle_data(self, data: str) -> None:
|
||||
self.parts.append(re.sub(r"\s+", " ", data.replace("\xa0", " ")))
|
||||
|
||||
|
||||
def clean_mail_html(html: Any) -> str:
|
||||
"""고친 메일 본문 HTML → 보낼 HTML(허용 태그·속성·글자 서식만). 너무 길거나 글이 없으면 ValueError."""
|
||||
raw = str(html or "")
|
||||
if len(raw) > MAIL_HTML_MAX:
|
||||
raise ValueError("메일 본문이 너무 깁니다.")
|
||||
p = _MailSanitizer()
|
||||
p.feed(raw)
|
||||
out = p.result()
|
||||
if not mail_html_to_text(out).strip():
|
||||
raise ValueError("메일 본문이 비어 있습니다.")
|
||||
return out
|
||||
|
||||
|
||||
def mail_html_to_text(html: str) -> str:
|
||||
p = _MailText()
|
||||
p.feed(str(html or ""))
|
||||
p.close()
|
||||
lines = [ln.strip() for ln in "".join(p.parts).split("\n")]
|
||||
return re.sub(r"\n{3,}", "\n\n", "\n".join(lines)).strip()
|
||||
|
||||
|
||||
# ════════════════════════════════════════════════════════════
|
||||
# 상품 정보(2026-10-16, 마이그레이션 004) — 단가·무게(개당 g = PP량)·은(Ag) 함유량(%) 수기 입력
|
||||
# 은 함량(g/개) = 무게 × 은 함유량 ÷ 100 — 저장하지 않고 계산(silver_g).
|
||||
# ════════════════════════════════════════════════════════════
|
||||
PRODUCT_LIMITS = {"unit_price": ("단가", Decimal("1000000000"), 2), "weight_g": ("무게", Decimal("1000000"), 2),
|
||||
"silver_pct": ("은 함유량", Decimal("100"), 4)}
|
||||
|
||||
|
||||
def to_dec(v: Any) -> Decimal | None:
|
||||
if v is None or v == "":
|
||||
return None
|
||||
try:
|
||||
return Decimal(str(v))
|
||||
except (InvalidOperation, ValueError):
|
||||
return None
|
||||
|
||||
|
||||
def fmt_num(v: Any, places: int = 2) -> str:
|
||||
"""1234.50 → '1,234.5', 1234 → '1,234' (소수 끝 0 은 뺀다)."""
|
||||
d = to_dec(v)
|
||||
if d is None:
|
||||
return ""
|
||||
q = d.quantize(Decimal(1).scaleb(-places), rounding=ROUND_HALF_UP)
|
||||
s = f"{q:,.{places}f}"
|
||||
return s.rstrip("0").rstrip(".") if "." in s else s
|
||||
|
||||
|
||||
def silver_g(weight_g: Any, silver_pct: Any) -> Decimal | None:
|
||||
w, p = to_dec(weight_g), to_dec(silver_pct)
|
||||
if w is None or p is None:
|
||||
return None
|
||||
return (w * p / Decimal(100)).quantize(Decimal("0.0001"), rounding=ROUND_HALF_UP)
|
||||
|
||||
|
||||
def line_usage(x: dict[str, Any]) -> dict[str, Decimal | None]:
|
||||
"""발주 품목 한 줄의 발주 수량 전체 사용량(kg) — 전체 무게 = 개당 g × 수량, 은 = 전체 무게 × %, PP 사용량 = 전체 − 은
|
||||
(은 함유량이 없으면 PP 사용량도 없음 — order_totals 의 pp_use_kg 와 같은 기준). 메일 표·발주서 화면 품목 표가 같이 쓴다."""
|
||||
w, pct, q = to_dec(x.get("weight_g")), to_dec(x.get("silver_pct")), int(x["qty"])
|
||||
total_kg = w * q / Decimal(1000) if w is not None else None
|
||||
ag_kg = total_kg * pct / Decimal(100) if total_kg is not None and pct is not None else None
|
||||
return {"total_kg": total_kg, "ag_kg": ag_kg, "pp_use_kg": total_kg - ag_kg if ag_kg is not None else None}
|
||||
|
||||
|
||||
def line_amount(qty: int, unit_price: Any) -> Decimal | None:
|
||||
p = to_dec(unit_price)
|
||||
return None if p is None else (p * int(qty)).quantize(Decimal("0.01"), rounding=ROUND_HALF_UP)
|
||||
|
||||
|
||||
def order_totals(lines: list[dict[str, Any]]) -> dict[str, Any]:
|
||||
"""발주 금액 합(단가 있는 줄만, 없으면 None)·단가 없는 줄 수·PP 총량(= 전체 무게, kg)·은 총량(g)·
|
||||
PP 사용량(kg, 무게·은 함유량이 다 있는 줄의 전체 무게 − 은 무게 — 메일 표, 2026-10-19)."""
|
||||
amount = pp = ag = use = None
|
||||
missing = 0
|
||||
for x in lines:
|
||||
q = int(x["qty"])
|
||||
a = line_amount(q, x.get("unit_price"))
|
||||
if a is None:
|
||||
if not is_bag(x.get("item_name")): # 봉투·백은 단가가 원래 없음 — "단가 미입력" 안내에서 뺀다
|
||||
missing += 1
|
||||
else:
|
||||
amount = (amount or Decimal(0)) + a
|
||||
w = to_dec(x.get("weight_g"))
|
||||
if w is not None:
|
||||
pp = (pp or Decimal(0)) + w * q / Decimal(1000)
|
||||
p = to_dec(x.get("silver_pct"))
|
||||
if w is not None and p is not None: # 개당 은 g 를 반올림하기 전 값으로 곱한다(합계 오차 방지)
|
||||
ag = (ag or Decimal(0)) + w * p / Decimal(100) * q
|
||||
use = (use or Decimal(0)) + w * q * (Decimal(100) - p) / Decimal(100000)
|
||||
return {"amount": amount, "missing_price": missing, "pp_kg": pp, "silver_g": ag,
|
||||
"pp_use_kg": use}
|
||||
|
||||
|
||||
def parse_decimal(raw: Any, *, key: str) -> Decimal | None:
|
||||
"""상품 정보 칸 하나 — 빈칸은 None(미입력), 숫자·쉼표·0 이상·한도 안·소수 자리."""
|
||||
label, limit, places = PRODUCT_LIMITS[key]
|
||||
s = str(raw if raw is not None else "").replace(",", "").replace("%", "").strip()
|
||||
if not s:
|
||||
return None
|
||||
try:
|
||||
d = Decimal(s)
|
||||
except InvalidOperation:
|
||||
raise ValueError(f"{label}은(는) 숫자로 입력하세요.") from None
|
||||
if not d.is_finite() or d < 0:
|
||||
raise ValueError(f"{label}은(는) 0 이상이어야 합니다.")
|
||||
if d > limit:
|
||||
raise ValueError(f"{label}이(가) 너무 큽니다(최대 {fmt_num(limit, 0)}).")
|
||||
return d.quantize(Decimal(1).scaleb(-places), rounding=ROUND_HALF_UP)
|
||||
|
||||
|
||||
def validate_product_values(values: dict[str, Any]) -> dict[str, Decimal | None]:
|
||||
"""{"unit_price","weight_g","silver_pct"} → 정리된 값. 틀리면 ValueError(칸 이름 포함)."""
|
||||
return {k: parse_decimal(values.get(k), key=k) for k in PRODUCT_LIMITS}
|
||||
|
||||
|
||||
def has_values(p: dict[str, Any]) -> bool:
|
||||
"""단가·무게·은 함유량(·그룹·색상 006·박스 입수 007) 중 하나라도 넣었나 — 넣은 상품은 다시 불러와도 그대로 둔다."""
|
||||
return (any(p.get(k) is not None for k in PRODUCT_LIMITS) or p.get("group_id") is not None
|
||||
or (p.get("color") or "none") != "none" or any(p.get(k) is not None for k in BOX_FIELDS)
|
||||
or p.get("boxes_per_pallet") is not None)
|
||||
|
||||
|
||||
# ════════════════════════════════════════════════════════════
|
||||
# 박스 입수(2026-10-21, 마이그레이션 007) — 통·뚜껑이 한 박스에 몇 개. 뚜껑이 없는 상품은 빈칸.
|
||||
# 새 발주서 화면이 수량 → 통·뚜껑 박스 수(올림)·전체 파렛트(1파렛트 = PALLET_BOXES 박스, 올림)를 계산한다(메일엔 안 넣음).
|
||||
# ════════════════════════════════════════════════════════════
|
||||
BOX_FIELDS = {"body_per_box": "통 수량(박스)", "lid_per_box": "뚜껑 수량(박스)"}
|
||||
MAX_PER_BOX = 1_000_000
|
||||
PALLET_BOXES = 30
|
||||
|
||||
|
||||
def parse_per_box(raw: Any, *, key: str = "", label: str = "") -> int | None:
|
||||
"""박스 입수 칸 하나 — 빈칸은 None(없음·미입력), 1 이상 정수(쉼표 허용)."""
|
||||
label = label or BOX_FIELDS[key]
|
||||
s = str(raw if raw is not None else "").replace(",", "").strip()
|
||||
if not s:
|
||||
return None
|
||||
if not s.isdigit():
|
||||
raise ValueError(f"{label}은(는) 1 이상 정수로 입력하세요.")
|
||||
n = int(s)
|
||||
if n < 1:
|
||||
raise ValueError(f"{label}은(는) 1 이상이어야 합니다(없으면 빈칸).")
|
||||
if n > MAX_PER_BOX:
|
||||
raise ValueError(f"{label}이(가) 너무 큽니다.")
|
||||
return n
|
||||
|
||||
|
||||
def validate_box_values(values: dict[str, Any]) -> dict[str, int | None]:
|
||||
return {k: parse_per_box(values.get(k), key=k) for k in BOX_FIELDS}
|
||||
|
||||
|
||||
# 봉투·백(2026-11-04, 마이그레이션 008) — 이름으로 판단(저장 안 함). 뚜껑 없음, 박스당 수량 = body_per_box, 1파렛트 박스 수는 상품마다.
|
||||
BAG_NAME_WORDS = ("미라클 봉투", "미라클백")
|
||||
|
||||
|
||||
def is_bag(name: Any) -> bool:
|
||||
return any(word in str(name or "") for word in BAG_NAME_WORDS)
|
||||
|
||||
|
||||
def validate_bag_values(values: dict[str, Any]) -> dict[str, int | None]:
|
||||
return {"body_per_box": parse_per_box(values.get("body_per_box"), label="박스당 수량"), "lid_per_box": None,
|
||||
"boxes_per_pallet": parse_per_box(values.get("boxes_per_pallet"), label="1파렛트당 박스 수량")}
|
||||
|
||||
|
||||
def box_info(row: dict[str, Any]) -> dict[str, Any]:
|
||||
"""발주서 화면 박스 계산 값 — 008 미적용(열 없음)이면 모두 일반 상품으로."""
|
||||
bag = "boxes_per_pallet" in row and is_bag(row.get("item_name"))
|
||||
return {"body_per_box": row.get("body_per_box"), "lid_per_box": None if bag else row.get("lid_per_box"),
|
||||
"is_bag": bag, "boxes_per_pallet": row.get("boxes_per_pallet") if bag else None}
|
||||
|
||||
|
||||
# ════════════════════════════════════════════════════════════
|
||||
# 상품 그룹·색상(2026-10-21, 마이그레이션 006)
|
||||
# 그룹에 은 함유량·색상을 한 번만 — 그룹 상품은 그룹 값, 그룹 없는 상품은 자기 값(effective_product).
|
||||
# 색상 = 키 → (이름, 칸 색). 발주 메일 품목 표에서 색상 있는 품목 줄 전체 배경 = 칸 색(옅게 — 글자가 읽히게).
|
||||
# ════════════════════════════════════════════════════════════
|
||||
COLORS = {"none": ("색없음", ""), "orange": ("오렌지", "#FFD8B0"), "blue": ("파랑", "#CFE0FA"),
|
||||
"gray": ("회색", "#DDDFE3"), "ivory": ("아이보리색", "#FFF6D9")}
|
||||
MAX_GROUP_NAME = 100
|
||||
|
||||
|
||||
def norm_color(raw: Any) -> str:
|
||||
"""색상 키(none·orange·blue·gray·ivory). 빈칸 = none. 모르는 값은 ValueError."""
|
||||
key = str(raw if raw is not None else "").strip().lower() or "none"
|
||||
if key not in COLORS:
|
||||
raise ValueError("색상은 " + "·".join(v[0] for v in COLORS.values()) + " 중에서 고르세요.")
|
||||
return key
|
||||
|
||||
|
||||
def color_hex(key: Any) -> str:
|
||||
"""색상 키 → 칸 색(#RRGGBB). 색없음·모름 = ''."""
|
||||
return COLORS.get(str(key or "none"), ("", ""))[1]
|
||||
|
||||
|
||||
def color_name(key: Any) -> str:
|
||||
return COLORS.get(str(key or "none"), COLORS["none"])[0]
|
||||
|
||||
|
||||
def validate_group(values: dict[str, Any]) -> dict[str, Any]:
|
||||
"""그룹 저장 값 — 이름(필수, 100자)·은 함유량(빈칸 = 미입력)·색상·순서."""
|
||||
name = str(values.get("name") or "").strip()
|
||||
if not name:
|
||||
raise ValueError("그룹 이름을 넣으세요.")
|
||||
if len(name) > MAX_GROUP_NAME:
|
||||
raise ValueError(f"그룹 이름은 {MAX_GROUP_NAME}자까지입니다.")
|
||||
try:
|
||||
sort_order = int(str(values.get("sort_order") or "0").strip() or 0)
|
||||
except ValueError:
|
||||
raise ValueError("순서는 숫자로 넣으세요.") from None
|
||||
return {"name": name, "silver_pct": parse_decimal(values.get("silver_pct"), key="silver_pct"),
|
||||
"color": norm_color(values.get("color")), "sort_order": max(-9999, min(9999, sort_order))}
|
||||
|
||||
|
||||
# ════════════════════════════════════════════════════════════
|
||||
# 입고증 사진(2026-10-16, 마이그레이션 003)
|
||||
# ════════════════════════════════════════════════════════════
|
||||
MAX_PHOTOS = 10 # 입고 한 건에
|
||||
MAX_PHOTO_BYTES = 10 * 1024 * 1024 # 한 장(브라우저가 줄여서 보내므로 보통 0.3~1MB)
|
||||
|
||||
|
||||
def sniff_image(data: bytes) -> str | None:
|
||||
"""파일 머리로 이미지 종류 판단(브라우저가 보낸 종류는 믿지 않는다). 모르면 None."""
|
||||
if data[:3] == b"\xff\xd8\xff":
|
||||
return "image/jpeg"
|
||||
if data[:8] == b"\x89PNG\r\n\x1a\n":
|
||||
return "image/png"
|
||||
if data[:4] == b"RIFF" and data[8:12] == b"WEBP":
|
||||
return "image/webp"
|
||||
if data[:6] in (b"GIF87a", b"GIF89a"):
|
||||
return "image/gif"
|
||||
if data[4:12] in (b"ftypheic", b"ftypheix", b"ftypmif1", b"ftyphevc", b"ftypheif"):
|
||||
return "image/heic" # 아이폰 원본 — 사파리 외 브라우저는 미리보기 못 함(내려받기)
|
||||
return None
|
||||
|
||||
|
||||
def validate_photos(files: list[tuple[str, bytes]], *, existing: int = 0) -> list[dict[str, Any]]:
|
||||
"""[(파일 이름, 내용)] → [{filename, content_type, data}]. 빈 파일은 건너뛴다. 하나라도 틀리면 ValueError."""
|
||||
out: list[dict[str, Any]] = []
|
||||
for name, data in files:
|
||||
if not data:
|
||||
continue
|
||||
name = (name or "photo").replace("\\", "/").rsplit("/", 1)[-1][:120]
|
||||
if len(data) > MAX_PHOTO_BYTES:
|
||||
raise ValueError(f"사진이 너무 큽니다(한 장 {MAX_PHOTO_BYTES // 1024 // 1024}MB까지): {name}")
|
||||
ctype = sniff_image(data)
|
||||
if ctype is None:
|
||||
raise ValueError(f"사진 파일(JPG·PNG·WEBP·GIF·HEIC)만 올릴 수 있습니다: {name}")
|
||||
out.append({"filename": name, "content_type": ctype, "data": data})
|
||||
if existing + len(out) > MAX_PHOTOS:
|
||||
raise ValueError(f"입고 한 건에 사진은 {MAX_PHOTOS}장까지입니다.")
|
||||
return out
|
||||
|
||||
|
||||
def rotate_image(data: bytes, degrees: int) -> bytes:
|
||||
"""사진 내용을 시계 방향 90·270도로 돌려 같은 형식으로(2026-11-02). 휴대폰 사진의 회전 정보(EXIF)는 픽셀에 반영한 뒤 돌린다."""
|
||||
from io import BytesIO # noqa: WPS433
|
||||
|
||||
from PIL import Image, ImageOps # noqa: WPS433
|
||||
|
||||
if degrees not in (90, 270):
|
||||
raise ValueError("사진은 왼쪽·오른쪽으로만 돌릴 수 있습니다.")
|
||||
kind = sniff_image(data)
|
||||
if kind == "image/heic":
|
||||
raise ValueError("HEIC 사진은 돌릴 수 없습니다 — JPG 로 바꿔 다시 올려 주세요.")
|
||||
try:
|
||||
im = Image.open(BytesIO(data))
|
||||
if getattr(im, "n_frames", 1) > 1:
|
||||
raise ValueError("움직이는 사진은 돌릴 수 없습니다.")
|
||||
icc = im.info.get("icc_profile")
|
||||
im = ImageOps.exif_transpose(im)
|
||||
# PIL 의 ROTATE_n 은 반시계 방향 — 시계 90도 = ROTATE_270
|
||||
im = im.transpose(Image.Transpose.ROTATE_270 if degrees == 90 else Image.Transpose.ROTATE_90)
|
||||
fmt = {"image/jpeg": "JPEG", "image/png": "PNG", "image/webp": "WEBP", "image/gif": "GIF"}[kind]
|
||||
opts: dict[str, Any] = {"icc_profile": icc} if icc and fmt != "GIF" else {}
|
||||
if fmt in ("JPEG", "WEBP"):
|
||||
opts["quality"] = 92
|
||||
buf = BytesIO()
|
||||
im.save(buf, format=fmt, **opts)
|
||||
except ValueError:
|
||||
raise
|
||||
except Exception as exc: # noqa: BLE001 — 깨진 파일 등(원본은 그대로 둔다)
|
||||
raise ValueError("이 사진은 돌릴 수 없습니다.") from exc
|
||||
out = buf.getvalue()
|
||||
if len(out) > MAX_PHOTO_BYTES:
|
||||
raise ValueError(f"돌린 사진이 너무 큽니다(한 장 {MAX_PHOTO_BYTES // 1024 // 1024}MB까지).")
|
||||
return out
|
||||
|
||||
|
||||
# ════════════════════════════════════════════════════════════
|
||||
# 입고 요청 메일(2026-10-19, 마이그레이션 005) — 입고 담당이 입고를 저장한 뒤 물류센터 입고 담당자에게
|
||||
# "전산 등록 부탁" 메일(입고 담당 본인 Gmail). 받는 사람 = 옵션 → 물류센터 이메일, 참조 기본 = king@·bj@dbxcorp.co.kr.
|
||||
# 본문 = 입고 상품 표(상품 이름·상품 코드·입고 수량·비고) + 입고증 사진을 본문 안 이미지(CID, 첨부 아님, 가로 600px 이하).
|
||||
# ════════════════════════════════════════════════════════════
|
||||
SETTING_LOGISTICS_EMAILS = "logistics_emails"
|
||||
SETTING_RECEIPT_MAIL_CC = "receipt_mail_cc"
|
||||
SETTING_ORDER_MAIL_CC = "order_mail_cc" # 발주 메일 참조 기본값(2026-10-19 — king@, 옵션 → 공장에서 고침)
|
||||
SETTING_DEFAULTS = {SETTING_LOGISTICS_EMAILS: "", SETTING_RECEIPT_MAIL_CC: "king@dbxcorp.co.kr, bj@dbxcorp.co.kr",
|
||||
SETTING_ORDER_MAIL_CC: "king@dbxcorp.co.kr"}
|
||||
MAIL_IMAGE_MAX_W = 600
|
||||
|
||||
|
||||
def clean_emails(raw: Any, *, label: str) -> str:
|
||||
"""옵션 저장용 — 주소 검사 후 'a@x.com, b@y.com' 로 다시 씀(비우면 '')."""
|
||||
return ", ".join(parse_emails(raw, label=label))
|
||||
|
||||
|
||||
def mail_images(photos: list[dict[str, Any]]) -> tuple[list[dict[str, Any]], int]:
|
||||
"""입고증 사진 → 메일 본문용 JPEG(가로 최대 600px, 세로는 비율대로, 회전 정보 반영).
|
||||
반환 ([{cid, data, width, height}], 못 넣은 장수) — HEIC 등 서버가 못 여는 사진은 빼고 센다."""
|
||||
from io import BytesIO # noqa: WPS433
|
||||
|
||||
from PIL import Image, ImageOps # noqa: WPS433
|
||||
|
||||
out: list[dict[str, Any]] = []
|
||||
skipped = 0
|
||||
for ph in photos:
|
||||
try:
|
||||
im = Image.open(BytesIO(bytes(ph["data"])))
|
||||
if im.format == "JPEG":
|
||||
im.draft("RGB", (MAIL_IMAGE_MAX_W * 2, MAIL_IMAGE_MAX_W * 2)) # 큰 JPEG 는 줄여서 읽기(빠름)
|
||||
im = ImageOps.exif_transpose(im)
|
||||
if im.mode not in ("RGB", "L"):
|
||||
rgba = im.convert("RGBA")
|
||||
bg = Image.new("RGB", rgba.size, (255, 255, 255))
|
||||
bg.paste(rgba, mask=rgba.split()[-1])
|
||||
im = bg
|
||||
if im.width > MAIL_IMAGE_MAX_W:
|
||||
im = im.resize((MAIL_IMAGE_MAX_W, max(1, round(im.height * MAIL_IMAGE_MAX_W / im.width))), Image.LANCZOS)
|
||||
buf = BytesIO()
|
||||
im.convert("RGB").save(buf, "JPEG", quality=85, optimize=True)
|
||||
except Exception: # noqa: BLE001 — HEIC·깨진 파일은 본문에서 뺀다(입고 기록의 사진은 그대로)
|
||||
skipped += 1
|
||||
continue
|
||||
out.append({"cid": f"inout-photo-{ph['id']}@dbx", "data": buf.getvalue(), "width": im.width, "height": im.height})
|
||||
return out, skipped
|
||||
|
||||
|
||||
def receipt_mail_subject(receipt_date: date) -> str:
|
||||
d = receipt_date
|
||||
return f"[입고 요청] {d.year}년 {d.month:02d}월 {d.day:02d}일({WEEKDAYS_KO[d.weekday()]}) 입고 요청 합니다."
|
||||
|
||||
|
||||
def receipt_mail(order: dict[str, Any], receipt: dict[str, Any], *, images: list[dict[str, Any]], skipped: int = 0,
|
||||
sender_name: str, sender_email: str) -> dict[str, str]:
|
||||
"""입고 1건 → 제목·글 본문·HTML 본문. 이미지는 <img src="cid:…"> (보낼 때 gmail.build_message 가 본문에 붙임).
|
||||
비고 = 그 발주 품목의 줄 메모. 값은 모두 escape."""
|
||||
memo_of = {int(ln["id"]): (ln.get("memo") or "") for ln in order["lines"]}
|
||||
rows = [{"name": x["item_name"], "code": x["item_code"], "qty": int(x["qty"]), "note": memo_of.get(int(x["order_line_id"]), "")}
|
||||
for x in receipt["lines"]]
|
||||
total = sum(r["qty"] for r in rows)
|
||||
who = sender_name or sender_email
|
||||
when = fmt_date(receipt["receipt_date"])
|
||||
info = f"입고일 {when} · 발주번호 {order['order_no']} · 공장 {order['factory_name']}"
|
||||
lead = "입고된 아래 리스트 상품을 전산 등록 부탁드립니다."
|
||||
# 글 본문(HTML 을 못 보는 메일 프로그램용)
|
||||
text = ["안녕하세요.", "", lead, "", info, "", "[입고 상품] 상품 이름 · 상품 코드 · 입고 수량 · 비고"]
|
||||
text += [f"- {r['name']} · {r['code']} · {r['qty']:,}개" + (f" · {r['note']}" if r["note"] else "") for r in rows]
|
||||
text.append(f"합계 {total:,}개")
|
||||
if receipt.get("memo"):
|
||||
text += ["", f"메모: {receipt['memo']}"]
|
||||
if images or skipped:
|
||||
text += ["", f"입고 인증 사진 {len(images)}장(본문 이미지)" + (f", 본문에 넣지 못한 사진 {skipped}장(HEIC 등)" if skipped else "")]
|
||||
text += ["", f"입고 담당: {who} ({sender_email})"]
|
||||
# HTML 본문
|
||||
e = _html.escape
|
||||
td = "padding:6px 10px;border:1px solid #d9dce1;"
|
||||
r_ = "text-align:right;white-space:nowrap;"
|
||||
bg = "background:#f6f7f9;"
|
||||
body_rows = "".join(
|
||||
f'<tr><td style="{td}">{e(r["name"])}</td><td style="{td}font-family:Consolas,monospace">{e(r["code"])}</td>'
|
||||
f'<td style="{td}{r_}">{r["qty"]:,}</td><td style="{td}">{e(r["note"])}</td></tr>' for r in rows)
|
||||
imgs = "".join(
|
||||
f'<p style="margin:8px 0"><img src="cid:{e(im["cid"])}" width="{im["width"]}" height="{im["height"]}" alt="입고 인증 사진 {i}" '
|
||||
f'style="display:block;width:{im["width"]}px;max-width:100%;height:auto;border:1px solid #d9dce1"></p>'
|
||||
for i, im in enumerate(images, start=1))
|
||||
photo_block = ""
|
||||
if images or skipped:
|
||||
photo_block = (f'<p style="margin:18px 0 4px"><b>입고 인증 사진</b> <span style="color:#777">{len(images)}장</span></p>{imgs}'
|
||||
+ (f'<p style="color:#777">본문에 넣지 못한 사진 {skipped}장(HEIC 등) — ERP 입고 기록에서 볼 수 있습니다.</p>' if skipped else ""))
|
||||
html = (
|
||||
'<div style="font-family:\'Malgun Gothic\',\'Apple SD Gothic Neo\',sans-serif;font-size:14px;color:#1d1d1f;line-height:1.6">'
|
||||
f"<p>안녕하세요.<br>{e(lead)}</p>"
|
||||
f'<p style="color:#555;margin:0 0 8px">{e(info)}</p>'
|
||||
'<table style="border-collapse:collapse;min-width:480px">'
|
||||
f'<thead><tr style="{bg}"><th style="{td}">상품 이름</th><th style="{td}">상품 코드</th><th style="{td}">입고 수량</th>'
|
||||
f'<th style="{td}">비고</th></tr></thead><tbody>{body_rows}</tbody>'
|
||||
f'<tfoot><tr><th colspan="2" style="{td}{bg}text-align:right">합계</th><th style="{td}{bg}{r_}">{total:,}</th>'
|
||||
f'<th style="{td}{bg}"></th></tr></tfoot></table>'
|
||||
+ (f'<p style="margin:10px 0 0">메모: {e(str(receipt["memo"]))}</p>' if receipt.get("memo") else "")
|
||||
+ photo_block
|
||||
+ f'<p style="color:#555;margin-top:18px">입고 담당: {e(who)} (<a href="mailto:{e(sender_email)}">{e(sender_email)}</a>)</p></div>'
|
||||
)
|
||||
return {"subject": receipt_mail_subject(receipt["receipt_date"]), "text": "\n".join(text), "html": html}
|
||||
|
||||
|
||||
def inline_preview_html(html: str, images: list[dict[str, Any]]) -> str:
|
||||
"""미리보기 창용 — cid: 를 data: 로 바꿔 브라우저에서 바로 보이게(보내는 메일은 cid 그대로)."""
|
||||
import base64 # noqa: WPS433
|
||||
|
||||
for im in images:
|
||||
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"
|
||||
|
||||
|
||||
# ════════════════════════════════════════════════════════════
|
||||
# 발주 알림 메일(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'<tr><th style="{th}text-align:left">발주번호</th><td style="{td}">{e(order["order_no"])}</td>'
|
||||
f'<th style="{th}text-align:left">발주일</th><td style="{td}">{e(when)}</td></tr>')
|
||||
rows = "".join(f'<tr><td style="{td}font-family:Consolas,monospace">{e(x["item_code"])}</td><td style="{td}">{e(x["item_name"])}</td>'
|
||||
f'<td style="{td}{r}">{int(x["qty"]):,}</td></tr>' for x in lines)
|
||||
html = (
|
||||
'<div style="font-family:\'Malgun Gothic\',\'Apple SD Gothic Neo\',sans-serif;font-size:14px;color:#1d1d1f;line-height:1.6">'
|
||||
"<p>입고 담당자님, 안녕하세요.<br>아래와 같이 공장에 발주했습니다. 입고 준비에 참고해 주세요.</p>"
|
||||
f'<table cellpadding="0" cellspacing="0" style="border-collapse:collapse;margin:8px 0 0">{facts}</table>'
|
||||
'<div style="height:18px;line-height:18px;font-size:1px"> </div>'
|
||||
'<table cellpadding="0" cellspacing="0" style="border-collapse:collapse;min-width:420px">'
|
||||
f'<thead><tr><th style="{th}">제품 코드</th><th style="{th}">제품명</th><th style="{th}">수량</th></tr></thead>'
|
||||
f'<tbody>{rows}</tbody>'
|
||||
f'<tfoot><tr><th colspan="2" style="{th}text-align:right">합계</th><th style="{th}{r}">{total:,}</th></tr></tfoot></table>'
|
||||
f'<p style="color:#555;margin-top:18px">발주 담당: {e(who)} (<a href="mailto:{e(sender_email)}">{e(sender_email)}</a>)</p></div>'
|
||||
)
|
||||
return {"subject": subject, "text": "\n".join(text), "html": html}
|
||||
@@ -0,0 +1,32 @@
|
||||
{# 오른쪽 달력(2026-10-21) — 입출고 모든 화면 오른쪽 위 300×320, 오른쪽 열 너비 = 달력 너비.
|
||||
프로젝트 달력과 같은 모양(일요일 시작 · 요일 줄 회색 · 오늘 검은 동그라미 · 토 파랑 · 일/공휴일 빨강 · 다른 달 흐리게).
|
||||
날짜 칸 = 발주(발주일, 파랑) · 입고(입고일, 초록) 건수, 누르면 그날 목록(발주서로 이동). 내용은 inout.js 가 GET /inout/api/calendar 로 그린다. #}
|
||||
<aside class="io-side" aria-label="발주·입고 달력">
|
||||
<div class="io-cal" id="io-cal" data-month="{{ today.strftime('%Y-%m') }}">
|
||||
<div class="io-cal-head">
|
||||
<button type="button" class="io-cal-nav" data-step="-1" aria-label="이전 달" title="이전 달">‹</button>
|
||||
<h3 class="io-cal-title" aria-live="polite">{{ today.year }}년 {{ today.month }}월</h3>
|
||||
<button type="button" class="io-cal-nav" data-step="1" aria-label="다음 달" title="다음 달">›</button>
|
||||
<button type="button" class="io-cal-today">오늘</button>
|
||||
</div>
|
||||
<div class="io-cal-box">
|
||||
<div class="io-cal-wd" aria-hidden="true">
|
||||
<span class="is-sun">일</span><span>월</span><span>화</span><span>수</span><span>목</span><span>금</span><span class="is-sat">토</span>
|
||||
</div>
|
||||
<div class="io-cal-days" role="grid"></div>
|
||||
</div>
|
||||
</div>
|
||||
{# 화면을 옮겨도 달력이 다시 그려지지 않게 — 마지막 달력(sessionStorage, inout.js 가 저장)을 그리기 전에 바로 붙인다.
|
||||
inout.js 는 서버 값을 다시 받아 바뀐 게 있을 때만 다시 그린다. #}
|
||||
<script>(function () {
|
||||
try {
|
||||
var c = JSON.parse(sessionStorage.getItem("io_cal_v1") || "null"), cal = document.getElementById("io-cal");
|
||||
if (!c || !c.html || !c.month || !cal) return;
|
||||
cal.dataset.month = c.month;
|
||||
cal.dataset.restored = "1";
|
||||
cal.querySelector(".io-cal-title").textContent = c.title;
|
||||
cal.querySelector(".io-cal-days").innerHTML = c.html;
|
||||
} catch (e) {}
|
||||
})();</script>
|
||||
<p class="io-cal-legend"><i class="io-cal-m is-order">n</i>발주 <i class="io-cal-m is-receipt">n</i>입고 <span class="io-sub">· 날짜를 누르면 목록</span></p>
|
||||
</aside>
|
||||
@@ -0,0 +1,5 @@
|
||||
{# 날짜 칸 = ERP 공용 달력(erp-datepop) — inout.js 가 input[type=date] 를 날짜 버튼으로 바꾼다. inout.js 보다 먼저 include. #}
|
||||
<link rel="stylesheet" href="/static/vendor/material-symbols/material-symbols.css" />
|
||||
<link rel="stylesheet" href="/static/erp-datepop.css?v=20261102a" />
|
||||
<script type="application/json" id="io-holidays">{{ (date_holidays or {}) | tojson }}</script>
|
||||
<script src="/static/erp-datepop.js?v=20261106a" defer></script>
|
||||
@@ -0,0 +1,33 @@
|
||||
{# 상태 배지 — 발주서(open·partial·done·over·closed·cancelled) / 품목(none·partial·done·over) #}
|
||||
{% macro status_badge(status, label) -%}
|
||||
<span class="io-badge io-st-{{ status }}">{{ label }}</span>
|
||||
{%- endmacro %}
|
||||
|
||||
{# 진행률 막대 — 입고 ÷ 발주 #}
|
||||
{% macro progress(summary) -%}
|
||||
<span class="io-progress" title="입고 {{ '{:,}'.format(summary.received) }} / 발주 {{ '{:,}'.format(summary.ordered) }}">
|
||||
<span class="io-progress-bar{% if summary.over %} is-over{% endif %}" style="width:{{ summary.pct }}%"></span>
|
||||
</span><span class="io-progress-pct">{{ summary.pct }}%</span>
|
||||
{%- endmacro %}
|
||||
|
||||
{# 날짜 서식 — 2026.10.17(토) / 2026.10.17(토) 15:14 (2026-10-17 요청, 메일·JSON 은 store.fmt_date·fmt_datetime) #}
|
||||
{% macro ymd(d) -%}{% if d %}{{ d.strftime('%Y.%m.%d') }}({{ '월화수목금토일'[d.weekday()] }}){% endif %}{%- endmacro %}
|
||||
{% macro ymdhm(d) -%}{% if d %}{{ ymd(d) }} {{ d.strftime('%H:%M') }}{% endif %}{%- endmacro %}
|
||||
|
||||
{# 발주서 상태 — 모든 품목이 입고완료·초과입고면 초록 "✓ 전체 입고 완료"(초과가 있으면 "초과 포함"), 나머지는 상태 배지 #}
|
||||
{% macro order_badge(status, label) -%}
|
||||
{% if status in ('done', 'over') %}<span class="io-badge io-st-done io-st-all">✓ {{ label }}</span>{% if status == 'over' %}<span class="io-badge-note">초과 포함</span>{% endif %}
|
||||
{%- else %}{{ status_badge(status, label) }}{% endif %}
|
||||
{%- endmacro %}
|
||||
|
||||
{# 입고 예정일 — 지났는데 남은 게 있으면 빨강 "지연 N일" #}
|
||||
{% macro due(due_date, today, active) -%}
|
||||
{% if due_date %}{{ ymd(due_date) }}{% if active and due_date < today %} <span class="io-late">지연 {{ (today - due_date).days }}일</span>{% elif active %} <span class="erp-muted">D-{{ (due_date - today).days }}</span>{% endif %}{% else %}<span class="erp-muted">-</span>{% endif %}
|
||||
{%- endmacro %}
|
||||
|
||||
{% macro n(v) -%}{{ '{:,}'.format(v or 0) }}{%- endmacro %}
|
||||
|
||||
{# 색상 사각형(006) — 색이 칠해진 네모. 색없음은 빗금 없는 흰 네모 + 테두리. colors = store.COLORS #}
|
||||
{% macro swatch(key, colors) -%}
|
||||
<i class="io-swatch{% if not colors.get(key or 'none', ('', ''))[1] %} is-none{% endif %}" style="background:{{ colors.get(key or 'none', ('', ''))[1] or '#fff' }}" aria-hidden="true"></i>
|
||||
{%- endmacro %}
|
||||
@@ -0,0 +1,36 @@
|
||||
{# 입출고 관리 공용 상단: 탭(발주 목록·미입고 현황) + 담당 표시 + 새 발주서 + 옵션 톱니(관리자, 팝업) + 알림 문구(?msg=) #}
|
||||
<div class="io-nav">
|
||||
<a class="erp-btn {% if tab == 'orders' %}erp-btn-primary{% else %}erp-btn-outline{% endif %}" href="/inout/">발주 목록</a>
|
||||
<a class="erp-btn {% if tab == 'pending' %}erp-btn-primary{% else %}erp-btn-outline{% endif %}" href="/inout/pending">미입고 현황</a>
|
||||
<span class="io-nav-gap"></span>
|
||||
<span class="io-roles erp-muted">
|
||||
{% if perms.can_order %}<span class="erp-badge erp-badge-neutral">발주 담당</span>{% endif %}
|
||||
{% if perms.can_receive %}<span class="erp-badge erp-badge-neutral">입고 담당</span>{% endif %}
|
||||
{% if not perms.can_order and not perms.can_receive %}조회만 가능 — 담당 지정은 옵션(관리자){% endif %}
|
||||
</span>
|
||||
{% if perms.can_order %}<a class="erp-btn erp-btn-primary" href="/inout/orders/new">+ 새 발주서</a>{% endif %}
|
||||
{% if perms.admin %}
|
||||
<button type="button" class="io-gear" id="io-options-btn" title="입출고 관리 옵션" aria-label="입출고 관리 옵션"
|
||||
aria-haspopup="dialog" {% if open_options %}data-open="1"{% endif %}>
|
||||
<svg viewBox="0 0 24 24" width="20" height="20" fill="none" stroke="currentColor" stroke-width="1.8" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true">
|
||||
<circle cx="12" cy="12" r="3"/>
|
||||
<path d="M19.4 15a1.65 1.65 0 0 0 .33 1.82l.06.06a2 2 0 1 1-2.83 2.83l-.06-.06a1.65 1.65 0 0 0-1.82-.33 1.65 1.65 0 0 0-1 1.51V21a2 2 0 1 1-4 0v-.09A1.65 1.65 0 0 0 9 19.4a1.65 1.65 0 0 0-1.82.33l-.06.06a2 2 0 1 1-2.83-2.83l.06-.06A1.65 1.65 0 0 0 4.68 15a1.65 1.65 0 0 0-1.51-1H3a2 2 0 1 1 0-4h.09A1.65 1.65 0 0 0 4.6 9a1.65 1.65 0 0 0-.33-1.82l-.06-.06a2 2 0 1 1 2.83-2.83l.06.06A1.65 1.65 0 0 0 9 4.68a1.65 1.65 0 0 0 1-1.51V3a2 2 0 1 1 4 0v.09a1.65 1.65 0 0 0 1 1.51 1.65 1.65 0 0 0 1.82-.33l.06-.06a2 2 0 1 1 2.83 2.83l-.06.06A1.65 1.65 0 0 0 19.4 9a1.65 1.65 0 0 0 1.51 1H21a2 2 0 1 1 0 4h-.09a1.65 1.65 0 0 0-1.51 1z"/>
|
||||
</svg>
|
||||
</button>
|
||||
{% endif %}
|
||||
</div>
|
||||
{% if msg %}<p class="io-flash" role="status">{{ msg }}</p>{% endif %}
|
||||
|
||||
{% if perms.admin %}
|
||||
{# 옵션 팝업 — 내용은 열 때 GET /inout/settings?panel=1 로 받아 넣고, 저장은 제자리에서(inout.js) #}
|
||||
<dialog class="io-dlg" id="io-options" aria-labelledby="io-options-title" tabindex="-1">
|
||||
<header class="io-dlg-head">
|
||||
<h2 id="io-options-title">입출고 관리 옵션</h2>
|
||||
<button type="button" class="io-dlg-x" data-close aria-label="닫기" title="닫기">
|
||||
<svg viewBox="0 0 24 24" width="20" height="20" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" aria-hidden="true"><path d="M6 6l12 12M18 6L6 18"/></svg>
|
||||
</button>
|
||||
</header>
|
||||
<p class="io-dlg-msg" role="status" hidden></p>
|
||||
<div class="io-dlg-body" id="io-options-body"><p class="erp-muted">불러오는 중…</p></div>
|
||||
</dialog>
|
||||
{% endif %}
|
||||
@@ -0,0 +1,243 @@
|
||||
{% from "inout/_macros.html" import ymd, swatch %}
|
||||
{# 옵션 팝업 내용(GET /inout/settings?panel=1) — 탭: 담당자 · 공장 · 상품 정보(004). 폼 저장은 inout.js 가 제자리에서(X-Inout-Options: 1 → JSON).
|
||||
공장 줄은 표(<table>) 안에 폼을 둘 수 없어 입력칸에 form="…" 속성으로 표 밖 폼에 묶는다 — 열이 머리 줄과 맞는다. #}
|
||||
<div class="io-dlg-tabs" role="tablist" aria-label="옵션 분류">
|
||||
<button type="button" role="tab" class="is-active" aria-selected="true" data-pane="roles">담당자</button>
|
||||
<button type="button" role="tab" aria-selected="false" data-pane="factories" tabindex="-1">공장 <span class="io-dlg-count">{{ factories|length }}</span></button>
|
||||
<button type="button" role="tab" aria-selected="false" data-pane="groups" tabindex="-1">상품 그룹 <span class="io-dlg-count">{{ groups|length }}</span></button>
|
||||
<button type="button" role="tab" aria-selected="false" data-pane="products" tabindex="-1">상품 정보 <span class="io-dlg-count">{{ products|length }}</span></button>
|
||||
<button type="button" role="tab" aria-selected="false" data-pane="logistics" tabindex="-1">물류센터</button>
|
||||
</div>
|
||||
|
||||
<section class="io-dlg-pane" data-pane="roles" role="tabpanel">
|
||||
<p class="io-help">
|
||||
<b>발주 담당</b> — 발주서 작성·고치기·잔량 종결·취소. <b>입고 담당</b> — 물류에 들어온 입고 수량 입력·지우기.
|
||||
그 밖의 사람은 조회만 합니다. ERP 관리자는 지정 없이도 둘 다 할 수 있습니다.
|
||||
후보 = ERP 관리자 화면에서 <b>입출고 관리</b> 권한을 받은 사용자.
|
||||
</p>
|
||||
<form method="post" action="/inout/settings/roles" class="io-dlg-form">
|
||||
<table class="io-dlg-table">
|
||||
<thead><tr><th>사용자</th>{% for role, label in role_labels.items() %}<th class="io-c">{{ label }}</th>{% endfor %}</tr></thead>
|
||||
<tbody>
|
||||
{% for c in candidates %}
|
||||
<tr>
|
||||
<td><span class="io-person">
|
||||
{% if c.picture %}<img class="io-avatar" src="{{ c.picture }}" alt="" referrerpolicy="no-referrer" loading="lazy" />
|
||||
{% else %}<svg class="io-avatar io-avatar-empty" viewBox="0 0 24 24" aria-hidden="true"><circle cx="12" cy="12" r="12" fill="#d5d9de"/><circle cx="12" cy="9.5" r="4" fill="#fff"/><path d="M4.6 19.6a8.6 8.6 0 0 1 14.8 0A11.9 11.9 0 0 1 12 24a11.9 11.9 0 0 1-7.4-4.4z" fill="#fff"/></svg>{% endif %}
|
||||
<span class="io-person-text"><b class="io-user">{{ c.name or c.email }}</b><span class="io-sub">{{ c.email }}</span></span>
|
||||
</span></td>
|
||||
{% for role in role_labels %}
|
||||
<td class="io-c"><input type="checkbox" name="{{ role }}_email" value="{{ c.email }}" {% if c.email in roles[role] %}checked{% endif %}
|
||||
aria-label="{{ c.email }} {{ role_labels[role] }}" /></td>
|
||||
{% endfor %}
|
||||
</tr>
|
||||
{% else %}
|
||||
<tr><td colspan="3" class="io-empty">입출고 관리 권한을 받은 사용자가 없습니다 — ERP 관리자 화면에서 먼저 권한을 주세요.</td></tr>
|
||||
{% endfor %}
|
||||
</tbody>
|
||||
</table>
|
||||
<div class="io-dlg-actions"><button type="submit" class="erp-btn erp-btn-primary">담당자 저장</button></div>
|
||||
</form>
|
||||
</section>
|
||||
|
||||
<section class="io-dlg-pane" data-pane="factories" role="tabpanel" hidden>
|
||||
<p class="io-help">발주서에서 고르는 공장(발주처)입니다. <b>이메일</b>은 발주 메일을 받을 주소(여러 개는 쉼표). 발주 기록이 있는 공장은 지우지 말고 <b>사용</b>을 끄면 목록에서 숨겨집니다.</p>
|
||||
<form method="post" action="/inout/settings/order-mail" class="io-dlg-form io-ordercc-form">
|
||||
<label class="io-logi-field"><span>발주 메일 참조 <small>(모든 발주 메일의 참조 칸에 미리 들어감 — 보낼 때 고칠 수 있음, 여러 개는 쉼표)</small></span>
|
||||
<span class="io-ordercc-row"><input class="io-in" type="text" inputmode="email" name="order_mail_cc" value="{{ settings.order_mail_cc }}" maxlength="1000"
|
||||
aria-label="발주 메일 참조" />
|
||||
<button type="submit" class="erp-btn erp-btn-outline erp-btn-sm"{% if not settings_ready %} disabled title="DB 마이그레이션 inout_db 005 필요"{% endif %}>저장</button></span></label>
|
||||
</form>
|
||||
{% for f in factories %}<form method="post" action="/inout/settings/factories" id="io-f{{ f.id }}" class="io-dlg-form"><input type="hidden" name="id" value="{{ f.id }}" /></form>{% endfor %}
|
||||
<form method="post" action="/inout/settings/factories" id="io-fnew" class="io-dlg-form"><input type="hidden" name="is_active" value="1" /></form>
|
||||
<table class="io-dlg-table io-factory-table">
|
||||
<colgroup><col class="w-name" /><col class="w-man" /><col class="w-tel" /><col class="w-mail" /><col class="w-memo" /><col class="w-sort" /><col class="w-use" /><col class="w-cnt" /><col class="w-btn" /></colgroup>
|
||||
<thead><tr><th>공장 이름</th><th>담당자</th><th>연락처</th><th title="발주 메일을 받을 주소 — 여러 개는 쉼표로">이메일</th><th>메모</th><th class="io-c">순서</th><th class="io-c">사용</th><th class="io-c">발주</th><th></th></tr></thead>
|
||||
<tbody>
|
||||
{% for f in factories %}
|
||||
{% set fid = 'io-f' ~ f.id %}
|
||||
<tr class="{% if not f.is_active %}is-inactive{% endif %}">
|
||||
<td><input class="io-in" form="{{ fid }}" type="text" name="name" value="{{ f.name }}" maxlength="100" required aria-label="공장 이름" /></td>
|
||||
<td><input class="io-in" form="{{ fid }}" type="text" name="manager" value="{{ f.manager }}" maxlength="100" aria-label="담당자" /></td>
|
||||
<td><input class="io-in" form="{{ fid }}" type="tel" name="contact" value="{{ f.contact }}" maxlength="200" aria-label="연락처" /></td>
|
||||
<td><input class="io-in" form="{{ fid }}" type="text" inputmode="email" name="email" value="{{ f.email }}" maxlength="600" aria-label="이메일" placeholder="발주 메일 받는 주소" /></td>
|
||||
<td><input class="io-in" form="{{ fid }}" type="text" name="memo" value="{{ f.memo }}" maxlength="500" aria-label="메모" /></td>
|
||||
<td class="io-c"><input class="io-in io-in-num" form="{{ fid }}" type="number" name="sort_order" value="{{ f.sort_order }}" aria-label="순서" /></td>
|
||||
<td class="io-c"><input form="{{ fid }}" type="checkbox" name="is_active" value="1" {% if f.is_active %}checked{% endif %} aria-label="사용" /></td>
|
||||
<td class="io-c io-sub">{{ f.order_count }}건</td>
|
||||
<td class="io-btns">
|
||||
<button form="{{ fid }}" type="submit" class="erp-btn erp-btn-outline erp-btn-sm">저장</button>
|
||||
{% if not f.order_count %}<button form="{{ fid }}" type="submit" class="erp-btn erp-btn-outline erp-btn-sm" formaction="/inout/settings/factories/{{ f.id }}/delete"
|
||||
formnovalidate data-confirm="공장 '{{ f.name }}' 을(를) 지울까요?">지우기</button>{% endif %}
|
||||
</td>
|
||||
</tr>
|
||||
{% endfor %}
|
||||
<tr class="io-new-row">
|
||||
<td><input class="io-in" form="io-fnew" type="text" name="name" maxlength="100" required placeholder="새 공장 이름" aria-label="새 공장 이름" /></td>
|
||||
<td><input class="io-in" form="io-fnew" type="text" name="manager" maxlength="100" placeholder="담당자" aria-label="담당자" /></td>
|
||||
<td><input class="io-in" form="io-fnew" type="tel" name="contact" maxlength="200" placeholder="010-0000-0000" aria-label="연락처" /></td>
|
||||
<td><input class="io-in" form="io-fnew" type="text" inputmode="email" name="email" maxlength="600" placeholder="factory@example.com" aria-label="이메일" /></td>
|
||||
<td><input class="io-in" form="io-fnew" type="text" name="memo" maxlength="500" placeholder="메모" aria-label="메모" /></td>
|
||||
<td class="io-c"><input class="io-in io-in-num" form="io-fnew" type="number" name="sort_order" value="0" aria-label="순서" /></td>
|
||||
<td></td><td></td>
|
||||
<td class="io-btns"><button form="io-fnew" type="submit" class="erp-btn erp-btn-primary erp-btn-sm">+ 추가</button></td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
</section>
|
||||
|
||||
<section class="io-dlg-pane" data-pane="groups" role="tabpanel" hidden>
|
||||
{% if not groups_ready %}
|
||||
<p class="io-error">상품 그룹·색상은 DB 마이그레이션 inout_db 006 적용 후 쓸 수 있습니다 — 관리자에게 알려 주세요.</p>
|
||||
{% else %}
|
||||
<p class="io-help">
|
||||
그룹마다 <b>은(Ag) 함유량</b>·<b>색상</b>을 한 번만 넣습니다 — <b>상품 정보</b> 탭에서 상품마다 그룹을 고르면 그 상품은 그룹 값을 씁니다(그룹 없는 상품은 상품마다).
|
||||
색상 있는 품목은 발주 메일 표에서 그 줄 배경이 그 색입니다. 그룹을 지우면 그 상품들은 그룹 없음(상품마다 값)으로 바뀝니다.
|
||||
</p>
|
||||
{% for g in groups %}<form method="post" action="/inout/settings/groups" id="io-g{{ g.id }}" class="io-dlg-form io-group-form"><input type="hidden" name="id" value="{{ g.id }}" /></form>{% endfor %}
|
||||
<form method="post" action="/inout/settings/groups" id="io-gnew" class="io-dlg-form io-group-form"></form>
|
||||
<table class="io-dlg-table io-group-table">
|
||||
<colgroup><col class="w-gname" /><col class="w-num" /><col class="w-color" /><col class="w-sort" /><col class="w-cnt" /><col class="w-btn" /></colgroup>
|
||||
<thead><tr><th>그룹 이름</th><th class="io-r">은 함유량(%)</th><th>색상</th><th class="io-c">순서</th><th class="io-c">상품</th><th></th></tr></thead>
|
||||
<tbody>
|
||||
{% for g in groups %}
|
||||
{% set gf = 'io-g' ~ g.id %}
|
||||
<tr>
|
||||
<td><input class="io-in" form="{{ gf }}" type="text" name="name" value="{{ g.name }}" maxlength="100" required aria-label="그룹 이름" /></td>
|
||||
<td><input class="io-in io-in-num" form="{{ gf }}" type="text" name="silver_pct" value="{{ fmt_num(g.silver_pct, 4) if g.silver_pct is not none else '' }}" inputmode="decimal" aria-label="{{ g.name }} 은 함유량" /></td>
|
||||
<td><span class="io-color">{{ swatch(g.color, colors) }}<select class="io-in io-color-select" form="{{ gf }}" name="color" aria-label="{{ g.name }} 색상">
|
||||
{% for key, c in colors.items() %}<option value="{{ key }}" data-hex="{{ c[1] }}" {% if g.color == key %}selected{% endif %}>{{ c[0] }}</option>{% endfor %}
|
||||
</select></span></td>
|
||||
<td class="io-c"><input class="io-in io-in-num" form="{{ gf }}" type="number" name="sort_order" value="{{ g.sort_order }}" aria-label="순서" /></td>
|
||||
<td class="io-c io-sub">{{ g.product_count }}개</td>
|
||||
<td class="io-btns">
|
||||
<button form="{{ gf }}" type="submit" class="erp-btn erp-btn-outline erp-btn-sm">저장</button>
|
||||
<button form="{{ gf }}" type="submit" class="erp-btn erp-btn-outline erp-btn-sm" formaction="/inout/settings/groups/{{ g.id }}/delete"
|
||||
formnovalidate data-confirm="그룹 '{{ g.name }}' 을(를) 지울까요? 그룹 상품 {{ g.product_count }}개는 그룹 없음(상품마다 값)으로 바뀝니다.">지우기</button>
|
||||
</td>
|
||||
</tr>
|
||||
{% endfor %}
|
||||
<tr class="io-new-row">
|
||||
<td><input class="io-in" form="io-gnew" type="text" name="name" maxlength="100" required placeholder="새 그룹 이름" aria-label="새 그룹 이름" /></td>
|
||||
<td><input class="io-in io-in-num" form="io-gnew" type="text" name="silver_pct" inputmode="decimal" placeholder="%" aria-label="새 그룹 은 함유량" /></td>
|
||||
<td><span class="io-color">{{ swatch('none', colors) }}<select class="io-in io-color-select" form="io-gnew" name="color" aria-label="새 그룹 색상">
|
||||
{% for key, c in colors.items() %}<option value="{{ key }}" data-hex="{{ c[1] }}">{{ c[0] }}</option>{% endfor %}
|
||||
</select></span></td>
|
||||
<td class="io-c"><input class="io-in io-in-num" form="io-gnew" type="number" name="sort_order" value="0" aria-label="순서" /></td>
|
||||
<td></td>
|
||||
<td class="io-btns"><button form="io-gnew" type="submit" class="erp-btn erp-btn-primary erp-btn-sm">+ 추가</button></td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
{% endif %}
|
||||
</section>
|
||||
|
||||
<section class="io-dlg-pane" data-pane="products" role="tabpanel" hidden>
|
||||
{% if not products_ready %}
|
||||
<p class="io-error">DB 마이그레이션 inout_db 004(상품 정보)가 아직 적용되지 않았습니다 — 관리자에게 알려 주세요.</p>
|
||||
{% else %}
|
||||
<p class="io-help">
|
||||
코드표의 단품을 불러와 <b>단가</b>(원)·<b>무게</b>(개당 g = PP량)·<b>은(Ag) 함유량</b>(%)을 넣습니다 — 은 함량(g)은 무게 × %로 자동 계산.
|
||||
값을 넣은 상품은 다시 불러와도 그대로이고, 지운 단품은 다음 불러오기에서 빠집니다. 발주서 제품은 이 목록에서 고르며, 발주할 때의 값이 발주서에 남습니다.
|
||||
{% if groups_ready %}<b>그룹</b>을 고른 상품은 은 함유량·<b>색상</b>을 그룹 값으로 씁니다(<b>상품 그룹</b> 탭에서 한 번만 설정).{% endif %}
|
||||
{% if boxes_ready %}<b>통 수량(박스)</b>·<b>뚜껑 수량(박스)</b> = 통·뚜껑이 한 박스에 몇 개씩 들어가는지(뚜껑이 없으면 빈칸) — 새 발주서에서 박스 수·파렛트 수를 계산합니다.{% endif %}
|
||||
이름에 "미라클 봉투"·"미라클백"이 들어간 상품은 <b>봉투·백</b> 표에서 <b>박스당 수량</b>·<b>1파렛트당 박스 수량</b>을 넣습니다(단가·무게·은 없음).
|
||||
</p>
|
||||
<div class="io-prod-bar">
|
||||
<button type="button" class="erp-btn erp-btn-outline erp-btn-sm" id="io-prod-import">단품 불러오기</button>
|
||||
<input type="search" class="io-in io-prod-search" id="io-prod-search" placeholder="코드·제품명 찾기" aria-label="상품 찾기" />
|
||||
<span class="io-sub" id="io-prod-count">{{ products|length }}개{% if excluded %} · 제외 {{ excluded|length }}개{% endif %}</span>
|
||||
<span class="io-nav-gap"></span>
|
||||
<button type="button" class="erp-btn erp-btn-primary erp-btn-sm" id="io-prod-save" disabled>변경 저장 <span id="io-prod-dirty"></span></button>
|
||||
</div>
|
||||
{% if products %}
|
||||
<div class="io-prod-scroll">
|
||||
{# 봉투·백(008) = 일반 상품과 표를 나눔, 짧은 목록이라 위에. 박스 칸 두 개만 다르고 나머지 칸은 같다 #}
|
||||
{% set bags = products|selectattr('is_bag')|list %}
|
||||
{% for bag_table, rows in [(true, bags), (false, products|rejectattr('is_bag')|list)] if rows %}
|
||||
<div class="io-prod-part">
|
||||
{% if bags %}<div class="io-prod-part-title">{{ '봉투·백' if bag_table else '일반 상품' }} <span class="io-sub">{{ rows|length }}개</span></div>{% endif %}
|
||||
<table class="io-dlg-table io-prod-table{% if groups_ready %} has-groups{% endif %}">
|
||||
<colgroup><col class="w-code" /><col />{% if groups_ready %}<col class="w-group" />{% endif %}{% if not bag_table %}<col class="w-num" /><col class="w-num" /><col class="w-num" /><col class="w-ag" />{% endif %}{% if boxes_ready %}<col class="w-box" /><col class="w-box" />{% endif %}{% if groups_ready %}<col class="w-color" />{% endif %}<col class="w-del" /></colgroup>
|
||||
<thead><tr><th>코드</th><th>제품명</th>{% if groups_ready %}<th>그룹</th>{% endif %}{% if not bag_table %}<th class="io-r">단가(원)</th><th class="io-r">무게·PP(g/개)</th><th class="io-r">은 함유량(%)</th><th class="io-r">은(g/개)</th>{% endif %}{% if bag_table %}<th title="한 박스에 몇 개">박스당 수량</th><th title="한 파렛트에 몇 박스">1파렛트당 박스 수량</th>{% elif boxes_ready %}<th title="통이 한 박스에 몇 개">통 수량(박스)</th><th title="뚜껑이 한 박스에 몇 개 — 뚜껑이 없으면 빈칸">뚜껑 수량(박스)</th>{% endif %}{% if groups_ready %}<th>색상</th>{% endif %}<th></th></tr></thead>
|
||||
<tbody>
|
||||
{% for p in rows %}
|
||||
{% set own_pct = p.own_silver_pct if groups_ready else p.silver_pct %}
|
||||
<tr data-code="{{ p.item_code }}" data-search="{{ (p.item_code ~ ' ' ~ p.item_name ~ ' ' ~ (p.group_name or ''))|lower }}"{% if groups_ready and p.group_id %} class="is-grouped"{% endif %}>
|
||||
<td class="io-code">{{ p.item_code }}{% if bag_table %}
|
||||
{# 봉투·백엔 단가·무게·은 칸이 없다 — 전에 넣은 값이 저장 때 지워지지 않게 숨은 칸으로 그대로 보낸다 #}
|
||||
<input type="hidden" data-key="unit_price" value="{{ fmt_num(p.unit_price) if p.unit_price is not none else '' }}" />
|
||||
<input type="hidden" data-key="weight_g" value="{{ fmt_num(p.weight_g) if p.weight_g is not none else '' }}" />
|
||||
<input type="hidden" data-key="silver_pct" value="{{ fmt_num(own_pct, 4) if own_pct is not none else '' }}" />{% endif %}</td>
|
||||
<td class="io-prod-name">{{ p.item_name }}</td>
|
||||
{% if groups_ready %}
|
||||
<td><select class="io-in io-group-select" data-key="group_id" aria-label="{{ p.item_code }} 그룹">
|
||||
<option value="" data-silver="" data-color="">그룹 없음</option>
|
||||
{% for g in groups %}<option value="{{ g.id }}" data-silver="{{ fmt_num(g.silver_pct, 4) if g.silver_pct is not none else '' }}" data-color="{{ g.color }}" {% if p.group_id == g.id %}selected{% endif %}>{{ g.name }}</option>{% endfor %}
|
||||
</select></td>
|
||||
{% endif %}
|
||||
{% if not bag_table %}
|
||||
<td><input class="io-in io-in-num" data-key="unit_price" value="{{ fmt_num(p.unit_price) if p.unit_price is not none else '' }}" inputmode="decimal" aria-label="{{ p.item_code }} 단가" /></td>
|
||||
<td><input class="io-in io-in-num" data-key="weight_g" value="{{ fmt_num(p.weight_g) if p.weight_g is not none else '' }}" inputmode="decimal" aria-label="{{ p.item_code }} 무게" /></td>
|
||||
<td><input class="io-in io-in-num io-own" data-key="silver_pct" value="{{ fmt_num(own_pct, 4) if own_pct is not none else '' }}" inputmode="decimal" aria-label="{{ p.item_code }} 은 함유량" />
|
||||
{% if groups_ready %}<span class="io-group-val io-r" title="그룹 값 — 그룹에서 바꿉니다">{{ fmt_num(p.silver_pct, 4) if p.silver_pct is not none else '-' }}</span>{% endif %}</td>
|
||||
<td class="io-r io-ag" title="무게 × 은 함유량 ÷ 100">{{ fmt_num(p.silver_g, 4) if p.silver_g is not none else '-' }}</td>
|
||||
{% endif %}
|
||||
{% if bag_table %}
|
||||
<td><input class="io-in io-in-num" data-key="body_per_box" value="{{ '{:,}'.format(p.body_per_box) if p.body_per_box else '' }}" inputmode="numeric" aria-label="{{ p.item_code }} 박스당 수량" /></td>
|
||||
<td><input class="io-in io-in-num" data-key="boxes_per_pallet" value="{{ '{:,}'.format(p.boxes_per_pallet) if p.boxes_per_pallet else '' }}" inputmode="numeric" aria-label="{{ p.item_code }} 1파렛트당 박스 수량" /></td>
|
||||
{% elif boxes_ready %}
|
||||
<td><input class="io-in io-in-num" data-key="body_per_box" value="{{ '{:,}'.format(p.body_per_box) if p.body_per_box else '' }}" inputmode="numeric" aria-label="{{ p.item_code }} 통 수량(박스)" /></td>
|
||||
<td><input class="io-in io-in-num" data-key="lid_per_box" value="{{ '{:,}'.format(p.lid_per_box) if p.lid_per_box else '' }}" inputmode="numeric" placeholder="없음" aria-label="{{ p.item_code }} 뚜껑 수량(박스)" /></td>
|
||||
{% endif %}
|
||||
{% if groups_ready %}
|
||||
<td><span class="io-color io-own">{{ swatch(p.own_color, colors) }}<select class="io-in io-color-select" data-key="color" aria-label="{{ p.item_code }} 색상">
|
||||
{% for key, c in colors.items() %}<option value="{{ key }}" data-hex="{{ c[1] }}" {% if p.own_color == key %}selected{% endif %}>{{ c[0] }}</option>{% endfor %}
|
||||
</select></span>
|
||||
<span class="io-color io-group-val" title="그룹 값 — 그룹에서 바꿉니다">{{ swatch(p.color, colors) }}<span class="io-color-name">{{ colors[p.color][0] if p.color in colors else '' }}</span></span></td>
|
||||
{% endif %}
|
||||
<td class="io-r"><button type="button" class="io-icon-btn" data-exclude="{{ p.item_code }}" title="지우기 — 다음 불러오기에서도 뺌" aria-label="{{ p.item_code }} 지우기">✕</button></td>
|
||||
</tr>
|
||||
{% endfor %}
|
||||
</tbody>
|
||||
</table>
|
||||
</div>
|
||||
{% endfor %}
|
||||
</div>
|
||||
{% else %}
|
||||
<p class="io-empty">아직 불러온 단품이 없습니다 — [단품 불러오기]를 누르세요. (그 전에는 발주서에서 코드표 단품을 바로 고릅니다)</p>
|
||||
{% endif %}
|
||||
{% if excluded %}
|
||||
<details class="io-excluded">
|
||||
<summary>제외 목록 {{ excluded|length }}개 — 불러오기에서 빠지는 단품</summary>
|
||||
<ul>
|
||||
{% for x in excluded %}
|
||||
<li><span class="io-code">{{ x.item_code }}</span> {{ x.item_name }} <span class="io-sub">· {{ ymd(x.excluded_at) }}</span>
|
||||
<button type="button" class="io-link-btn" data-restore="{{ x.item_code }}">되살리기</button></li>
|
||||
{% endfor %}
|
||||
</ul>
|
||||
</details>
|
||||
{% endif %}
|
||||
{% endif %}
|
||||
</section>
|
||||
|
||||
<section class="io-dlg-pane" data-pane="logistics" role="tabpanel" hidden>
|
||||
{% if not settings_ready %}
|
||||
<p class="io-error">DB 마이그레이션 inout_db 005(물류센터 이메일·입고 요청 메일)가 아직 적용되지 않았습니다 — 관리자에게 알려 주세요.</p>
|
||||
{% endif %}
|
||||
<p class="io-help">
|
||||
입고 담당이 <b>입고 저장</b>을 누르면 물류센터 입고 담당자에게 보낼 <b>입고 요청 메일</b>(전산 등록 부탁 · 입고 상품 표 · 입고증 사진)을
|
||||
미리 보여 주고, [메일 발송]을 눌러 입고 담당 본인 Gmail 로 보냅니다. 아래 주소가 받는 사람·참조 칸에 미리 들어갑니다(보낼 때 고칠 수 있음).
|
||||
</p>
|
||||
<form method="post" action="/inout/settings/logistics" class="io-dlg-form io-logi-form">
|
||||
<label class="io-logi-field"><span>물류센터 담당자 이메일 <small>(받는 사람 — 여러 개는 쉼표)</small></span>
|
||||
<input class="io-in" type="text" inputmode="email" name="logistics_emails" value="{{ settings.logistics_emails }}" maxlength="1000"
|
||||
placeholder="logistics@example.com" aria-label="물류센터 담당자 이메일" /></label>
|
||||
<label class="io-logi-field"><span>입고 요청 메일 참조 <small>(여러 개는 쉼표)</small></span>
|
||||
<input class="io-in" type="text" inputmode="email" name="receipt_mail_cc" value="{{ settings.receipt_mail_cc }}" maxlength="1000"
|
||||
aria-label="입고 요청 메일 참조" /></label>
|
||||
<div class="io-dlg-actions"><button type="submit" class="erp-btn erp-btn-primary"{% if not settings_ready %} disabled{% endif %}>물류센터 저장</button></div>
|
||||
</form>
|
||||
</section>
|
||||
|
||||
<p class="io-dlg-foot">코드표(단품) 연결: {{ items_status }}</p>
|
||||
@@ -0,0 +1,77 @@
|
||||
{% 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=20261105d" />{% endblock %}
|
||||
|
||||
{% block content %}
|
||||
<div class="io-split">{# 2열 — 왼쪽 화면 | 오른쪽 달력(2026-10-21) #}
|
||||
<section class="io">
|
||||
{% include "inout/_nav.html" %}
|
||||
|
||||
<form class="io-filter" method="get" action="/inout/">
|
||||
{# 상태 = 링크(다른 거르기 값 유지). 검색 칸 Enter 는 아래 [찾기] — 상태는 숨은 칸 값 그대로 #}
|
||||
{% set keep = {'factory': filters.factory or '', 'q': filters.q, 'from': filters['from'], 'to': filters['to']} %}
|
||||
<div class="io-seg" role="group" aria-label="상태">
|
||||
{% for key, f in status_filters.items() %}
|
||||
<a href="/inout/?{{ dict(keep, status=key) | urlencode }}" class="io-seg-btn{% if filters.status == key %} is-active{% endif %}"
|
||||
{% if filters.status == key %}aria-current="true"{% endif %}>{{ f[0] }}</a>
|
||||
{% endfor %}
|
||||
</div>
|
||||
<input type="hidden" name="status" value="{{ filters.status }}" />
|
||||
<select class="erp-select" name="factory" aria-label="공장" onchange="this.form.submit()">
|
||||
<option value="">전체 공장</option>
|
||||
{% for f in factories %}<option value="{{ f.id }}" {% if filters.factory == f.id %}selected{% endif %}>{{ f.name }}{% if not f.is_active %} (사용 안 함){% endif %}</option>{% endfor %}
|
||||
</select>
|
||||
<div class="io-filter-right">
|
||||
<label class="io-date">발주일 <input class="erp-input" type="date" name="from" value="{{ filters['from'] }}" aria-label="발주일 시작" /></label>
|
||||
<span class="erp-muted">~</span>
|
||||
<input class="erp-input" type="date" name="to" value="{{ filters['to'] }}" aria-label="발주일 끝" />
|
||||
<input class="erp-input io-search" type="search" name="q" value="{{ filters.q }}" placeholder="발주번호·제품 코드·제품 이름" />
|
||||
<button type="submit" class="erp-btn erp-btn-outline">찾기</button>
|
||||
</div>
|
||||
</form>
|
||||
|
||||
<div class="erp-card-block">
|
||||
<div class="erp-table-wrap">
|
||||
<table class="erp-table io-table io-list-table">
|
||||
<thead><tr>
|
||||
<th>발주번호</th><th>공장</th><th>제품</th><th>발주일</th><th>입고 예정일</th><th>입고일</th>
|
||||
<th class="io-num">발주</th><th class="io-num">입고</th><th class="io-num">미입고</th><th>진행</th><th>상태</th>
|
||||
{% if perms.super %}<th class="io-col-trash"><span class="sr-only">삭제</span></th>{% endif %}
|
||||
</tr></thead>
|
||||
<tbody>
|
||||
{% for o in orders %}
|
||||
{% set active = o.status in ('open', 'partial') %}
|
||||
<tr class="io-row-link" data-href="/inout/orders/{{ o.id }}">
|
||||
<td><a href="/inout/orders/{{ o.id }}" class="io-order-no">{{ o.order_no }}</a></td>
|
||||
<td>{{ o.factory_name }}</td>
|
||||
<td class="io-items">{{ o.items_label }}<div class="erp-row-sub">{{ o.line_count }}종</div></td>
|
||||
<td>{{ ymd(o.order_date) }}</td>
|
||||
<td>{{ due(o.due_date, today, active) }}</td>
|
||||
<td>{% for d in o.receipt_dates %}<div>{{ ymd(d) }}</div>{% else %}-{% endfor %}</td>
|
||||
<td class="io-num">{{ n(o.summary.ordered) }}</td>
|
||||
<td class="io-num">{{ n(o.summary.received) }}</td>
|
||||
<td class="io-num{% if o.summary.remaining and active %} io-remaining{% endif %}">{{ n(o.summary.remaining) }}{% if o.summary.over %}<div class="io-over-sub">초과 +{{ n(o.summary.over) }}</div>{% endif %}</td>
|
||||
<td class="io-progress-cell">{{ progress(o.summary) }}</td>
|
||||
<td class="io-status-cell">{{ order_badge(o.status, o.status_label) }}</td>
|
||||
{% if perms.super %}
|
||||
{# 수퍼관리자만 — 완전 삭제(품목·입고 기록·사진·메일 기록까지) #}
|
||||
<td class="io-col-trash"><form method="post" action="/inout/orders/{{ o.id }}/delete"
|
||||
data-erp-confirm="{{ o.order_no }} 발주서를 완전히 삭제할까요?{% if o.summary.received %} 입고 {{ n(o.summary.received) }}개 기록과 입고증 사진{% else %} 품목{% endif %}·발주 메일 기록까지 모두 지워지고 되돌릴 수 없습니다.">
|
||||
<input type="hidden" name="back" value="{{ request.url.path }}{% if request.url.query %}?{{ request.url.query }}{% endif %}" />
|
||||
<button type="submit" class="io-icon-btn io-del-btn" title="발주 삭제(수퍼관리자)" aria-label="{{ o.order_no }} 발주 삭제">
|
||||
<svg viewBox="0 0 24 24" width="15" height="15" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="M4 7h16M9 7V4h6v3M6 7l1 13h10l1-13M10 11v6M14 11v6"/></svg>
|
||||
</button></form></td>
|
||||
{% endif %}
|
||||
</tr>
|
||||
{% else %}
|
||||
<tr><td colspan="{{ 12 if perms.super else 11 }}" class="erp-empty">{% if filters.status == 'active' %}진행 중인 발주가 없습니다.{% else %}조건에 맞는 발주가 없습니다.{% endif %}</td></tr>
|
||||
{% endfor %}
|
||||
</tbody>
|
||||
</table>
|
||||
</div>
|
||||
</div>
|
||||
</section>
|
||||
{% include "inout/_calendar.html" %}
|
||||
</div>
|
||||
{% endblock %}
|
||||
{% block scripts %}{% include "inout/_datepop.html" %}<script src="/static/inout.js?v=20261105a" defer></script>{% endblock %}
|
||||
@@ -0,0 +1,265 @@
|
||||
{% extends "erp_base.html" %}
|
||||
{% from "inout/_macros.html" import status_badge, order_badge, progress, due, n, ymd, ymdhm %}
|
||||
{#- 메일 창(발주 메일 · 입고 요청 메일 같은 모양) — 열면 미리보기 GET, [메일 발송]을 눌러야 보낸다(inout.js initMail) -#}
|
||||
{%- macro mail_dialog(id, title, open_url='', open_title='') -%}
|
||||
<dialog class="io-dlg io-mail-dlg" id="{{ id }}" aria-labelledby="{{ id }}-title" tabindex="-1"
|
||||
{%- if open_url %} data-open-url="{{ open_url }}" data-open-title="{{ open_title }}"{% endif %}>
|
||||
<header class="io-dlg-head">
|
||||
<h2 id="{{ id }}-title" data-mail-title>{{ title }}</h2>
|
||||
<button type="button" class="io-dlg-x" data-close aria-label="닫기" title="닫기">
|
||||
<svg viewBox="0 0 24 24" width="20" height="20" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" aria-hidden="true"><path d="M6 6l12 12M18 6L6 18"/></svg>
|
||||
</button>
|
||||
</header>
|
||||
<p class="io-dlg-msg" role="status" hidden></p>
|
||||
<div class="io-dlg-body" data-mail-body><p class="erp-muted">불러오는 중…</p></div>
|
||||
<footer class="io-dlg-footbar" data-mail-foot hidden>
|
||||
<button type="button" class="io-link-btn" data-gmail-disconnect>Gmail 연결 끊기</button>
|
||||
<span class="io-nav-gap"></span>
|
||||
<button type="button" class="erp-btn erp-btn-outline" data-close>취소</button>
|
||||
<button type="button" class="erp-btn erp-btn-primary" data-mail-send>메일 발송</button>
|
||||
</footer>
|
||||
</dialog>
|
||||
{%- endmacro -%}
|
||||
{% block head_extra %}<link rel="stylesheet" href="/static/inout.css?v=20261105d" />{% endblock %}
|
||||
|
||||
{% block content %}
|
||||
{% set active = order.status in ('open', 'partial') %}
|
||||
{% set receiving = perms.can_receive and can_receive_now %}
|
||||
{# 전체 입고 완료(모든 품목 입고완료·초과) — 입고 칸·[입고 저장]을 흐리게 막는다(서버도 거절, 2026-10-19). 입고 기록을 지우면 다시 열림 #}
|
||||
{% set recv_done = order.status in ('done', 'over') %}
|
||||
{% set dis = ' disabled' if recv_done else '' %}
|
||||
{% set photo_admin = perms.can_receive and not order.cancelled_at %}
|
||||
<div class="io-split">{# 2열 — 왼쪽 화면 | 오른쪽 달력(2026-10-21) #}
|
||||
<section class="io">
|
||||
{% include "inout/_nav.html" %}
|
||||
|
||||
<div class="erp-card-block io-head">
|
||||
<div class="io-head-main">
|
||||
<div class="io-head-title">
|
||||
<h2>{{ order.order_no }}</h2>{{ order_badge(order.status, order.status_label) }}
|
||||
</div>
|
||||
<dl class="io-head-meta">
|
||||
<div><dt>공장</dt><dd>{{ order.factory_name }}{% if order.factory_manager or order.factory_contact %}<span class="io-factory-who">{{ order.factory_manager }}{% if order.factory_manager and order.factory_contact %} · {% endif %}{{ order.factory_contact }}</span>{% endif %}</dd></div>
|
||||
<div><dt>발주일</dt><dd>{{ ymd(order.order_date) }}</dd></div>
|
||||
<div><dt>입고 예정일</dt><dd>{{ due(order.due_date, today, active) }}</dd></div>
|
||||
<div><dt>진행</dt><dd>{{ progress(order.summary) }}</dd></div>
|
||||
<div><dt>발주 메일</dt><dd>{% if order.mails %}{% set last = order.mails[-1] %}<span class="io-mail-sent">보냄 {{ ymdhm(last.sent_at) }}</span><span class="io-factory-who">{{ last.sent_by }} → {{ last.to_addrs }}{% if order.mails|length > 1 %} · 모두 {{ order.mails|length }}번{% endif %}</span>{% else %}<span class="erp-muted">아직 안 보냄</span>{% endif %}</dd></div>
|
||||
{% if order.memo %}<div class="io-wide"><dt>메모</dt><dd>{{ order.memo }}</dd></div>{% endif %}
|
||||
{% if order.closed_at %}<div class="io-wide"><dt>종결</dt><dd>{{ ymd(order.closed_at) }} · {{ order.closed_by }}{% if order.close_reason %} — {{ order.close_reason }}{% endif %}</dd></div>{% endif %}
|
||||
{% if order.cancelled_at %}<div class="io-wide"><dt>취소</dt><dd>{{ ymd(order.cancelled_at) }} · {{ order.cancelled_by }}</dd></div>{% endif %}
|
||||
</dl>
|
||||
</div>
|
||||
<div class="io-kpis io-kpis-head">
|
||||
<div class="erp-summary-card erp-summary-card--mini"><div class="erp-summary-label">발주</div><div class="erp-summary-value">{{ n(order.summary.ordered) }}</div></div>
|
||||
<div class="erp-summary-card erp-summary-card--mini"><div class="erp-summary-label">입고</div><div class="erp-summary-value">{{ n(order.summary.received) }}</div></div>
|
||||
<div class="erp-summary-card erp-summary-card--mini{% if order.summary.remaining and active %} io-kpi-remaining{% endif %}"><div class="erp-summary-label">미입고</div><div class="erp-summary-value">{{ n(order.summary.remaining) }}</div></div>
|
||||
{% if order.summary.over %}<div class="erp-summary-card erp-summary-card--mini io-kpi-over"><div class="erp-summary-label">초과</div><div class="erp-summary-value">+{{ n(order.summary.over) }}</div></div>{% endif %}
|
||||
</div>
|
||||
{% if perms.can_order and not order.cancelled_at %}
|
||||
<div class="io-head-actions">
|
||||
<button type="button" class="erp-btn erp-btn-primary erp-btn-sm io-mail-btn" id="io-mail-btn" data-order="{{ order.id }}"
|
||||
{% if open_mail %}data-open="1"{% endif %} aria-haspopup="dialog">
|
||||
<svg viewBox="0 0 24 24" width="15" height="15" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><rect x="3" y="5" width="18" height="14" rx="2"/><path d="m3 7 9 6 9-6"/></svg>
|
||||
{% if order.mails %}발주 메일 다시 보내기{% else %}발주 메일 보내기{% endif %}</button>
|
||||
<a class="erp-btn erp-btn-outline erp-btn-sm" href="/inout/orders/{{ order.id }}/edit">발주서 고치기</a>
|
||||
{% if order.closed_at %}
|
||||
<form method="post" action="/inout/orders/{{ order.id }}/reopen"><button class="erp-btn erp-btn-outline erp-btn-sm" type="submit">종결 풀기</button></form>
|
||||
{% elif order.summary.remaining %}
|
||||
<form method="post" action="/inout/orders/{{ order.id }}/close" class="io-close-form" data-erp-confirm="남은 미입고 {{ n(order.summary.remaining) }}개를 더 기다리지 않고 종결할까요? 미입고 현황에서 빠집니다.">
|
||||
<input class="erp-input io-close-reason" type="text" name="reason" maxlength="500" placeholder="종결 사유(선택)" />
|
||||
<button class="erp-btn erp-btn-outline erp-btn-sm" type="submit">잔량 종결</button>
|
||||
</form>
|
||||
{% endif %}
|
||||
{% if not order.receipts %}
|
||||
<form method="post" action="/inout/orders/{{ order.id }}/cancel" data-erp-confirm="이 발주서를 취소할까요? (입고 기록이 없을 때만)">
|
||||
<button class="erp-btn erp-btn-danger erp-btn-sm" type="submit">발주 취소</button>
|
||||
</form>
|
||||
{% endif %}
|
||||
</div>
|
||||
{% endif %}
|
||||
</div>
|
||||
|
||||
{% if error %}<div class="io-error" role="alert">{% for line in error.split('\n') %}<div>{{ line }}</div>{% endfor %}</div>{% endif %}
|
||||
|
||||
<form method="post" action="/inout/orders/{{ order.id }}/receipts" class="erp-card-block io-block" id="io-receipt-form" enctype="multipart/form-data">
|
||||
{# Enter 키 = 이 버튼(일반 저장). 없으면 폼의 첫 제출 버튼인 [초과 입고로 저장]이 눌려 확인 없이 초과가 저장된다 #}
|
||||
{% if receiving %}<button type="submit" class="io-default-submit" tabindex="-1" aria-hidden="true"{{ dis }}>입고 저장</button>{% endif %}
|
||||
<input type="hidden" name="confirm_over" value="" id="io-confirm-over" />
|
||||
<div class="erp-card-block-head">
|
||||
<h2>품목</h2>
|
||||
{% if receiving and recv_done %}<span class="erp-muted io-recv-done-note">✓ 전체 입고 완료 — 더 입고할 수 없습니다(잘못 넣은 입고는 아래 입고 기록에서 지운 뒤 다시 넣으세요)</span>
|
||||
{% elif receiving %}<span class="erp-muted">물류에 들어온 수량을 [이번 입고]에 넣고 저장 — 여러 번 나눠 넣어도 됩니다</span>
|
||||
{% elif perms.can_receive and order.closed_at %}<span class="erp-muted">종결된 발주서 — 입고하려면 발주 담당이 종결을 풀어야 합니다</span>{% endif %}
|
||||
</div>
|
||||
|
||||
{% if over %}
|
||||
<div class="io-over-box" role="alert">
|
||||
<b>발주보다 많이 입고하려고 합니다.</b> 맞으면 [초과 입고로 저장]을 누르세요.
|
||||
<ul>{% for o in over %}<li>{% if not items_limited %}<span class="io-code">{{ o.item_code }}</span> {% endif %}{{ o.item_name }} — 발주 {{ n(o.ordered) }}개, 입고 후 {{ n(o.after) }}개 (<b>+{{ n(o.over) }}</b>)</li>{% endfor %}</ul>
|
||||
{% if photos_lost %}<p class="io-photo-lost">고른 입고증 사진은 다시 첨부해야 합니다(화면이 다시 열리면서 빠졌습니다).</p>{% endif %}
|
||||
<button type="submit" class="io-btn-over" name="confirm_over" value="1">초과 입고로 저장</button>
|
||||
<span class="erp-muted">숫자를 고치려면 아래 칸을 고친 뒤 [입고 저장]</span>
|
||||
</div>
|
||||
{% elif photos_lost %}
|
||||
<p class="io-error">고른 입고증 사진은 다시 첨부해야 합니다(화면이 다시 열리면서 빠졌습니다).</p>
|
||||
{% endif %}
|
||||
|
||||
<div class="erp-table-wrap">
|
||||
<table class="erp-table io-table io-items-table">
|
||||
{# 입고 담당(발주 담당 아님) = 제품 이름·발주 수량(+ 이번 입고)만, 발주 담당 = 단가·금액·PP·은 함께 #}
|
||||
<thead><tr><th class="io-col-no">#</th>{% if not items_limited %}<th>제품 코드</th>{% endif %}<th>제품</th><th class="io-num">발주</th>
|
||||
{% if show_prices %}<th class="io-num io-col-money">단가(원)</th><th class="io-num io-col-money">금액(원)</th><th class="io-num io-col-spec" title="발주 수량 전체 PP 사용량 = 전체 무게 − 은 무게(아래 작은 글씨 = 개당 무게)">PP 사용량</th><th class="io-num io-col-spec" title="발주 수량 전체 은 무게(아래 작은 글씨 = 함유량 %·개당 은)">은(Ag) 함유량</th>{% endif %}
|
||||
{% if not items_limited %}<th class="io-num">입고</th><th class="io-num">미입고</th><th>상태</th>{% endif %}
|
||||
{% if receiving %}<th class="io-col-recv">이번 입고</th>{% endif %}</tr></thead>
|
||||
<tbody>
|
||||
{% for ln in order.lines %}
|
||||
<tr>
|
||||
<td class="io-col-no">{{ loop.index }}</td>
|
||||
{% if not items_limited %}<td class="io-code">{{ ln.item_code }}</td>{% endif %}
|
||||
<td>{{ ln.item_name }}{% if ln.memo %}<div class="erp-row-sub">{{ ln.memo }}</div>{% endif %}</td>
|
||||
<td class="io-num">{{ n(ln.qty) }}</td>
|
||||
{% if show_prices %}
|
||||
{% set amt = line_amount(ln.qty, ln.unit_price) %}{% set ag = silver_g(ln.weight_g, ln.silver_pct) %}{% set use = line_usage(ln) %}
|
||||
<td class="io-num io-col-money">{{ fmt_num(ln.unit_price) if ln.unit_price is not none else '-' }}</td>
|
||||
<td class="io-num io-col-money">{{ fmt_num(amt) if amt is not none else '-' }}</td>
|
||||
{# 발주 수량 전체 사용량(2026-10-21) — PP 사용량·은 함유량 kg(메일 표와 같은 값), 아래 작은 글씨 = 개당 값 #}
|
||||
<td class="io-num io-col-spec">{% if use.pp_use_kg is not none %}{{ fmt_num(use.pp_use_kg, 3) }}kg{% else %}-{% endif %}{% if ln.weight_g is not none %}<div class="erp-row-sub">{{ fmt_num(ln.weight_g) }}g/개</div>{% endif %}</td>
|
||||
<td class="io-num io-col-spec">{% if use.ag_kg is not none %}{{ fmt_num(use.ag_kg, 3) }}kg{% else %}-{% endif %}{% if ln.silver_pct is not none %}<div class="erp-row-sub">{{ fmt_num(ln.silver_pct, 4) }}%{% if ag is not none %} · {{ fmt_num(ag, 4) }}g/개{% endif %}</div>{% endif %}</td>
|
||||
{% endif %}
|
||||
{% if not items_limited %}
|
||||
<td class="io-num">{{ n(ln.received) }}</td>
|
||||
<td class="io-num{% if ln.remaining and active %} io-remaining{% endif %}">{{ n(ln.remaining) }}{% if ln.over %}<div class="io-over-sub">초과 +{{ n(ln.over) }}</div>{% endif %}</td>
|
||||
<td>{{ status_badge(ln.status, ln.status_label) }}</td>
|
||||
{% endif %}
|
||||
{% if receiving %}<td class="io-col-recv"><input class="erp-input io-qty io-recv" type="text" inputmode="numeric" name="qty_{{ ln.id }}"
|
||||
value="{{ receipt_form.qty.get(ln.id, '') }}" data-remaining="{{ ln.remaining }}" data-ordered="{{ ln.qty }}" data-received="{{ ln.received }}"
|
||||
data-code="{{ ln.item_code }}" data-name="{{ ln.item_name }}" placeholder="{{ ln.remaining if ln.remaining and not items_limited else '' }}"
|
||||
aria-label="{{ ln.item_name }} 이번 입고 수량"{{ dis }} /></td>{% endif %}
|
||||
</tr>
|
||||
{% endfor %}
|
||||
</tbody>
|
||||
{% if show_prices and order.lines %}
|
||||
<tfoot><tr class="io-total-row">
|
||||
<td colspan="3" class="io-total-label">합계</td>
|
||||
<td class="io-num">{{ n(order.summary.ordered) }}</td>
|
||||
<td class="io-num io-col-money"></td>
|
||||
<td class="io-num io-col-money"><b>{{ fmt_num(totals.amount) ~ ' 원' if totals.amount is not none else '-' }}</b>{% if totals.missing_price %}<div class="erp-row-sub">단가 미입력 {{ totals.missing_price }}종 제외</div>{% endif %}</td>
|
||||
{# 합계 무게 = 소수 첫째 자리에서 반올림(정수 kg) #}
|
||||
<td class="io-num io-col-spec">{% if totals.pp_use_kg is not none %}{{ fmt_num(totals.pp_use_kg, 0) }} kg{% else %}-{% endif %}</td>
|
||||
<td class="io-num io-col-spec">{% if totals.silver_g is not none %}{{ fmt_num(totals.silver_g / 1000, 0) }} kg{% else %}-{% endif %}</td>
|
||||
{% if not items_limited %}<td colspan="3"></td>{% endif %}
|
||||
{% if receiving %}<td></td>{% endif %}
|
||||
</tr></tfoot>
|
||||
{% endif %}
|
||||
</table>
|
||||
</div>
|
||||
{% if receiving %}
|
||||
<div class="io-receipt-bar{% if recv_done %} is-locked{% endif %}"{% if recv_done %} aria-disabled="true" title="전체 입고 완료 — 더 입고할 수 없습니다"{% endif %}>
|
||||
<label class="erp-field"><span>입고일 *</span><input type="date" name="receipt_date" value="{{ receipt_form.receipt_date }}" aria-label="입고일" required{{ dis }} /></label>
|
||||
<label class="erp-field io-grow"><span>메모</span><input type="text" name="memo" value="{{ receipt_form.memo }}" maxlength="500" placeholder="차량·박스 수·검수 메모 등"{{ dis }} /></label>
|
||||
<div class="erp-field io-photo-field">
|
||||
<span>입고증 사진 <small>(최대 {{ max_photos }}장)</small></span>
|
||||
<label class="io-photo-pick">
|
||||
<input type="file" name="photos" accept="image/*" multiple id="io-photo-input" class="io-photo-input" data-max="{{ max_photos }}"{{ dis }} />
|
||||
<svg class="io-photo-pick-icon" viewBox="0 0 24 24" width="28" height="28" fill="none" stroke="currentColor" stroke-width="1.7" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="M4 8h3l2-3h6l2 3h3v11H4z"/><circle cx="12" cy="13" r="3.5"/></svg>
|
||||
입고증 업로드
|
||||
</label>
|
||||
</div>
|
||||
<button type="button" class="erp-btn erp-btn-outline" id="io-fill-remaining"{{ dis }}>남은 수량 모두 채우기</button>
|
||||
<button type="submit" class="erp-btn erp-btn-primary io-recv-save"{{ dis }}>입고 저장 <span id="io-recv-total"></span></button>
|
||||
<div class="io-photo-previews" id="io-photo-previews" aria-live="polite"></div>
|
||||
</div>
|
||||
{% endif %}
|
||||
</form>
|
||||
|
||||
<div class="erp-card-block io-block">
|
||||
<div class="erp-card-block-head"><h2>입고 기록</h2><span class="erp-muted">{{ order.receipts|length }}회</span></div>
|
||||
{% 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>
|
||||
<tbody>
|
||||
{% for r in order.receipts %}
|
||||
<tr>
|
||||
<td>{{ ymd(r.receipt_date) }}{% if r.memo %}<div class="erp-row-sub">{{ r.memo }}</div>{% endif %}</td>
|
||||
<td>{% for x in r.lines %}<span class="io-chip">{% if items_limited %}{{ x.item_name }}{% else %}<span class="io-code">{{ x.item_code }}</span>{% endif %} {{ n(x.qty) }}</span>{% endfor %}</td>
|
||||
<td class="io-num">{{ n(r.total) }}</td>
|
||||
<td class="io-photos-cell">
|
||||
{% for ph in r.photos %}
|
||||
<button type="button" class="io-thumb" data-photo="{{ ph.id }}" data-receipt="{{ r.id }}" data-type="{{ ph.content_type }}"
|
||||
data-name="{{ ph.filename }}" title="{{ ph.filename }} — 크게 보기" aria-label="입고증 사진 크게 보기 {{ loop.index }}">
|
||||
{% if ph.content_type == 'image/heic' %}<span class="io-thumb-heic">HEIC</span>{% else %}<img src="/inout/photos/{{ ph.id }}" alt="" loading="lazy" />{% endif %}
|
||||
</button>
|
||||
{% endfor %}
|
||||
{% if photo_admin and r.photos|length < max_photos %}
|
||||
<form method="post" action="/inout/orders/{{ order.id }}/receipts/{{ r.id }}/photos" enctype="multipart/form-data" class="io-add-photo-form">
|
||||
<label class="io-thumb io-thumb-add" title="입고증 사진 더하기">
|
||||
<input type="file" name="photos" accept="image/*" multiple class="io-photo-input io-photo-auto" data-max="{{ max_photos - r.photos|length }}" aria-label="입고증 사진 더하기" />
|
||||
<span aria-hidden="true">+</span>
|
||||
</label>
|
||||
</form>
|
||||
{% elif not r.photos %}<span class="erp-muted">-</span>{% endif %}
|
||||
</td>
|
||||
<td class="erp-muted">{{ r.created_by }}<div class="erp-row-sub">{{ ymdhm(r.created_at) }}</div></td>
|
||||
<td class="io-rmail-cell">
|
||||
{% if r.mails %}{% set lm = r.mails[-1] %}<span class="io-mail-sent">보냄 {{ ymdhm(lm.sent_at) }}</span>
|
||||
<div class="erp-row-sub">{{ lm.sent_by }}{% if r.mails|length > 1 %} · 모두 {{ r.mails|length }}번{% endif %}</div>{% endif %}
|
||||
{% if perms.can_receive %}<button type="button" class="erp-btn erp-btn-outline erp-btn-sm io-rmail-btn" aria-haspopup="dialog"
|
||||
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"
|
||||
data-erp-confirm="{{ ymd(r.receipt_date) }} 입고 {{ n(r.total) }}개 기록을 지울까요? 그만큼 다시 미입고가 되고 입고증 사진도 지워집니다.">
|
||||
<button type="submit" class="erp-btn erp-btn-outline erp-btn-sm">지우기</button></form></td>
|
||||
{% endif %}
|
||||
</tr>
|
||||
{% endfor %}
|
||||
</tbody>
|
||||
</table>
|
||||
</div>
|
||||
{% else %}
|
||||
<p class="erp-empty">아직 입고된 것이 없습니다.</p>
|
||||
{% endif %}
|
||||
</div>
|
||||
|
||||
{# 입고증 사진 크게 보기 — 앞뒤 넘기기(←/→), 원본 열기, 지우기(입고 담당) #}
|
||||
<dialog class="io-viewer" id="io-viewer" tabindex="-1" aria-label="입고증 사진" data-order="{{ order.id }}" data-can-delete="{{ '1' if photo_admin else '' }}">
|
||||
<div class="io-viewer-bar">
|
||||
<span class="io-viewer-title" id="io-viewer-title"></span>
|
||||
{% if photo_admin %}
|
||||
<button type="button" class="io-viewer-btn io-viewer-rot" data-rotate="270" title="왼쪽으로 돌리기" aria-label="왼쪽으로 돌리기"><svg viewBox="0 0 24 24" width="16" height="16" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="M3 4v6h6"/><path d="M3.5 15a9 9 0 1 0 2.1-9.4L3 10"/></svg></button>
|
||||
<button type="button" class="io-viewer-btn io-viewer-rot" data-rotate="90" title="오른쪽으로 돌리기" aria-label="오른쪽으로 돌리기"><svg viewBox="0 0 24 24" width="16" height="16" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="M21 4v6h-6"/><path d="M20.5 15a9 9 0 1 1-2.1-9.4L21 10"/></svg></button>
|
||||
{% endif %}
|
||||
<a class="io-viewer-btn" id="io-viewer-open" href="#" target="_blank" rel="noopener">원본</a>
|
||||
{% if photo_admin %}<form method="post" id="io-viewer-del" data-erp-confirm="이 입고증 사진을 지울까요?"><button type="submit" class="io-viewer-btn">지우기</button></form>{% endif %}
|
||||
<button type="button" class="io-viewer-btn" data-close aria-label="닫기">✕</button>
|
||||
</div>
|
||||
<button type="button" class="io-viewer-nav is-prev" data-step="-1" aria-label="이전 사진">‹</button>
|
||||
<img class="io-viewer-img" id="io-viewer-img" alt="입고증 사진" />
|
||||
<p class="io-viewer-heic" id="io-viewer-heic" hidden>HEIC 사진은 이 브라우저에서 미리 볼 수 없습니다 — [원본]으로 내려받으세요.</p>
|
||||
<button type="button" class="io-viewer-nav is-next" data-step="1" aria-label="다음 사진">›</button>
|
||||
</dialog>
|
||||
|
||||
{% if perms.can_order and not order.cancelled_at %}
|
||||
{# 발주 메일 — 열면 GET /inout/orders/{id}/mail 로 미리보기, [메일 발송]을 눌러야 보낸다(발주 담당 본인 Gmail) #}
|
||||
{{ mail_dialog('io-mail', '발주 메일 보내기 · ' ~ order.order_no) }}
|
||||
{% endif %}
|
||||
{% if perms.can_receive and order.receipts %}
|
||||
{# 입고 요청 메일(005) — 물류센터 입고 담당자에게 전산 등록 부탁(입고 담당 본인 Gmail). 입고 저장 뒤 ?rmail={입고 id} 면 바로 연다 #}
|
||||
{% set open_r = order.receipts | selectattr('id', 'equalto', open_rmail) | list if open_rmail else [] %}
|
||||
{% if open_r %}
|
||||
{{ mail_dialog('io-rmail', '입고 요청 메일', '/inout/orders/' ~ order.id ~ '/receipts/' ~ open_r[0].id ~ '/mail',
|
||||
'입고 요청 메일 · ' ~ ymd(open_r[0].receipt_date) ~ ' 입고 ' ~ n(open_r[0].total) ~ '개') }}
|
||||
{% else %}{{ mail_dialog('io-rmail', '입고 요청 메일') }}{% endif %}
|
||||
{% endif %}
|
||||
</section>
|
||||
{% include "inout/_calendar.html" %}
|
||||
</div>
|
||||
{% endblock %}
|
||||
{% block scripts %}{% include "inout/_datepop.html" %}<script src="/static/inout.js?v=20261105a" defer></script>{% endblock %}
|
||||
@@ -0,0 +1,105 @@
|
||||
{% extends "erp_base.html" %}
|
||||
{% block head_extra %}<link rel="stylesheet" href="/static/inout.css?v=20261105d" />{% endblock %}
|
||||
|
||||
{% block content %}
|
||||
<div class="io-split">{# 2열 — 왼쪽 화면 | 오른쪽 달력(2026-10-21) #}
|
||||
<section class="io">
|
||||
{% include "inout/_nav.html" %}
|
||||
|
||||
<form class="erp-card-block io-order-form" method="post" id="io-order-form"{% if boxes_ready %} data-pallet-boxes="{{ pallet_boxes }}"{% endif %}
|
||||
action="{% if order %}/inout/orders/{{ order.id }}/edit{% else %}/inout/orders/new{% endif %}">
|
||||
<div class="erp-card-block-head">
|
||||
<h2>{% if order %}발주서 고치기 · {{ order.order_no }}{% else %}새 발주서{% endif %}</h2>
|
||||
<span class="erp-muted">{% if from_catalog %}제품은 옵션 → 상품 정보의 단품에서 고릅니다(단가 함께){% else %}제품은 코드표의 단품에서 고릅니다{% endif %}</span>
|
||||
</div>
|
||||
{% if error %}<div class="io-error" role="alert">{% for line in error.split('\n') %}<div>{{ line }}</div>{% endfor %}</div>{% endif %}
|
||||
{% if not items_enabled %}<div class="io-error" role="alert">제품을 고를 목록이 없습니다 — 관리자가 옵션 → 상품 정보에서 단품을 불러오거나 코드표 DB(ITEMCODE_DB_URL)를 연결해야 합니다.</div>{% endif %}
|
||||
|
||||
<div class="erp-form-grid">
|
||||
<label class="erp-field"><span>공장 *</span>
|
||||
<select name="factory_id" required>
|
||||
<option value="">공장 고르기</option>
|
||||
{% for f in factories %}<option value="{{ f.id }}" {% if vals.factory_id|string == f.id|string %}selected{% endif %}>{{ f.name }}</option>{% endfor %}
|
||||
</select>
|
||||
{% if not factories %}<span class="io-hint">공장이 없습니다 — 관리자가 옵션에서 먼저 공장을 추가해야 합니다.</span>{% endif %}
|
||||
</label>
|
||||
<label class="erp-field"><span>발주일 *</span><input type="date" name="order_date" value="{{ vals.order_date }}" aria-label="발주일" required /></label>
|
||||
<label class="erp-field"><span>입고 예정일</span><input type="date" name="due_date" value="{{ vals.due_date }}" aria-label="입고 예정일" /></label>
|
||||
<label class="erp-field"><span>메모</span><input type="text" name="memo" value="{{ vals.memo }}" maxlength="500" placeholder="공장 전달 사항 등" /></label>
|
||||
</div>
|
||||
|
||||
<div class="erp-table-wrap">
|
||||
<table class="erp-table io-table io-lines" id="io-lines">
|
||||
<thead><tr><th class="io-col-no">#</th><th>제품(코드·이름으로 검색)</th><th class="io-col-qty">발주 수량</th><th class="io-col-money">단가(원)</th><th class="io-col-money">금액(원)</th>{% if boxes_ready %}<th class="io-col-box" title="통·뚜껑 박스 입수(옵션 → 상품 정보)로 계산 — 저장·메일에는 넣지 않습니다">통·뚜껑 박스</th>{% endif %}<th>줄 메모</th><th class="io-col-del"></th></tr></thead>
|
||||
<tbody>
|
||||
{% for ln in lines %}
|
||||
{% set received = (order.lines | selectattr('item_code', 'equalto', ln.code) | map(attribute='received') | first) if order else 0 %}
|
||||
<tr class="io-line" data-price="{{ ln.price if ln.price is not none else '' }}"{% if boxes_ready %} data-body-box="{{ ln.body_per_box or '' }}" data-lid-box="{{ ln.lid_per_box or '' }}" data-bag="{{ '1' if ln.is_bag else '' }}" data-pallet-box="{{ ln.boxes_per_pallet or '' }}"{% endif %}>
|
||||
<td class="io-col-no"></td>
|
||||
<td class="io-item-cell">
|
||||
<input type="hidden" name="item_code" value="{{ ln.code }}" />
|
||||
<input type="hidden" name="item_name" value="{{ ln.name }}" />
|
||||
<input class="erp-input io-item-search" type="text" value="{{ ln.code }}{% if ln.name %} · {{ ln.name }}{% endif %}" autocomplete="off"
|
||||
placeholder="코드 또는 이름" {% if received %}readonly title="입고된 제품은 바꿀 수 없습니다(수량은 바꿀 수 있음)"{% endif %} />
|
||||
{% if received %}<div class="erp-row-sub">입고 {{ '{:,}'.format(received) }}개 — 제품은 그대로, 수량만 바꿀 수 있습니다</div>{% endif %}
|
||||
</td>
|
||||
<td class="io-col-qty"><span class="io-qty-wrap"><input class="erp-input io-qty" type="text" inputmode="numeric" name="qty" value="{{ ln.qty }}" placeholder="0" />{% if boxes_ready %}<span class="io-steps"><button type="button" class="io-step" data-step="-1" aria-label="공배수만큼 줄이기" disabled><svg viewBox="0 0 24 24" width="16" height="16" fill="none" stroke="currentColor" stroke-width="2.2" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="M15 6l-6 6 6 6"/></svg></button><button type="button" class="io-step" data-step="1" aria-label="공배수만큼 늘리기" disabled><svg viewBox="0 0 24 24" width="16" height="16" fill="none" stroke="currentColor" stroke-width="2.2" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="M9 6l6 6-6 6"/></svg></button></span>{% endif %}</span></td>
|
||||
<td class="io-col-money io-price">{{ ln.price_label or '-' }}</td>
|
||||
<td class="io-col-money io-amount">-</td>
|
||||
{% if boxes_ready %}<td class="io-col-box io-box">-</td>{% endif %}
|
||||
<td><input class="erp-input" type="text" name="line_memo" value="{{ ln.memo }}" maxlength="500" /></td>
|
||||
<td class="io-col-del">{% if not received %}<button type="button" class="erp-btn erp-btn-outline erp-btn-sm io-del" aria-label="이 줄 지우기" title="이 줄 지우기">✕</button>{% endif %}</td>
|
||||
</tr>
|
||||
{% endfor %}
|
||||
</tbody>
|
||||
<tfoot><tr><td colspan="{{ 8 if boxes_ready else 7 }}">
|
||||
<button type="button" class="erp-btn erp-btn-outline erp-btn-sm" id="io-add-line">+ 제품 줄 추가</button>
|
||||
<span class="erp-muted io-total">합계 <b id="io-total-qty">0</b>개 · <b id="io-total-lines">0</b>종 · 금액 <b id="io-total-amount">0</b>원<span id="io-total-noprice"></span></span>
|
||||
{% if boxes_ready %}
|
||||
{# 박스·파렛트(2026-10-21) — 통·뚜껑 박스 수 합계 → 전체 파렛트(1파렛트 = {{ pallet_boxes }}박스, 올림). 화면 계산만(저장·메일 없음) #}
|
||||
<div class="io-pallet" id="io-pallet" aria-live="polite">
|
||||
<span>통 <b data-k="body">0</b>박스</span><span>뚜껑 <b data-k="lid">0</b>박스</span><span>전체 <b data-k="boxes">0</b>박스</span>
|
||||
<span class="io-pallet-main">→ <b data-k="pallets">0</b>파렛트</span>
|
||||
{# 파렛트 그림 — 꽉 찬 파렛트 + 잔량 파렛트(실린 박스만큼 색, %·몇 박스 더) #}
|
||||
<span class="io-pallet-vis" data-k="vis"></span>
|
||||
<span class="erp-muted" data-k="note">1파렛트 = {{ pallet_boxes }}박스</span>
|
||||
</div>
|
||||
{# 봉투·백(008) — 상품마다 1파렛트 박스 수가 달라 통·뚜껑 파렛트와 따로 셈 #}
|
||||
<div class="io-pallet" id="io-pallet-bag" aria-live="polite" hidden>
|
||||
<span>봉투·백 <b data-k="boxes">0</b>박스</span>
|
||||
<span class="io-pallet-main">→ <b data-k="pallets">0</b>파렛트</span>
|
||||
<span class="io-pallet-vis" data-k="vis"></span>
|
||||
<span class="erp-muted" data-k="note"></span>
|
||||
</div>
|
||||
{% endif %}
|
||||
</td></tr></tfoot>
|
||||
</table>
|
||||
</div>
|
||||
|
||||
<template id="io-line-tpl">
|
||||
<tr class="io-line"{% if boxes_ready %} data-body-box="" data-lid-box="" data-bag="" data-pallet-box=""{% endif %}>
|
||||
<td class="io-col-no"></td>
|
||||
<td class="io-item-cell">
|
||||
<input type="hidden" name="item_code" value="" />
|
||||
<input type="hidden" name="item_name" value="" />
|
||||
<input class="erp-input io-item-search" type="text" value="" autocomplete="off" placeholder="코드 또는 이름" />
|
||||
</td>
|
||||
<td class="io-col-qty"><span class="io-qty-wrap"><input class="erp-input io-qty" type="text" inputmode="numeric" name="qty" value="" placeholder="0" />{% if boxes_ready %}<span class="io-steps"><button type="button" class="io-step" data-step="-1" aria-label="공배수만큼 줄이기" disabled><svg viewBox="0 0 24 24" width="16" height="16" fill="none" stroke="currentColor" stroke-width="2.2" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="M15 6l-6 6 6 6"/></svg></button><button type="button" class="io-step" data-step="1" aria-label="공배수만큼 늘리기" disabled><svg viewBox="0 0 24 24" width="16" height="16" fill="none" stroke="currentColor" stroke-width="2.2" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="M9 6l6 6-6 6"/></svg></button></span>{% endif %}</span></td>
|
||||
<td class="io-col-money io-price">-</td>
|
||||
<td class="io-col-money io-amount">-</td>
|
||||
{% if boxes_ready %}<td class="io-col-box io-box">-</td>{% endif %}
|
||||
<td><input class="erp-input" type="text" name="line_memo" value="" maxlength="500" /></td>
|
||||
<td class="io-col-del"><button type="button" class="erp-btn erp-btn-outline erp-btn-sm io-del" aria-label="이 줄 지우기" title="이 줄 지우기">✕</button></td>
|
||||
</tr>
|
||||
</template>
|
||||
|
||||
<div class="io-form-actions">
|
||||
<a class="erp-btn erp-btn-outline" href="{% if order %}/inout/orders/{{ order.id }}{% else %}/inout/{% endif %}">취소</a>
|
||||
<button type="submit" class="erp-btn erp-btn-primary">{% if order %}고친 내용 저장{% else %}발주서 저장{% endif %}</button>
|
||||
</div>
|
||||
</form>
|
||||
</section>
|
||||
{% include "inout/_calendar.html" %}
|
||||
</div>
|
||||
{% endblock %}
|
||||
{% block scripts %}{% include "inout/_datepop.html" %}<script src="/static/inout.js?v=20261105a" defer></script>{% endblock %}
|
||||
@@ -0,0 +1,94 @@
|
||||
{% extends "erp_base.html" %}
|
||||
{% from "inout/_macros.html" import due, n, ymd %}
|
||||
{% block head_extra %}<link rel="stylesheet" href="/static/inout.css?v=20261105d" />{% endblock %}
|
||||
|
||||
{% block content %}
|
||||
<div class="io-split">{# 2열 — 왼쪽 화면 | 오른쪽 달력(2026-10-21) #}
|
||||
<section class="io">
|
||||
{% include "inout/_nav.html" %}
|
||||
|
||||
<form class="io-filter" method="get" action="/inout/pending">
|
||||
<select class="erp-select" name="factory" aria-label="공장" onchange="this.form.submit()">
|
||||
<option value="">전체 공장</option>
|
||||
{% for f in factories %}<option value="{{ f.id }}" {% if filters.factory == f.id %}selected{% endif %}>{{ f.name }}{% if not f.is_active %} (사용 안 함){% endif %}</option>{% endfor %}
|
||||
</select>
|
||||
<input class="erp-input io-search" type="search" name="q" value="{{ filters.q }}" placeholder="제품 코드·제품 이름·발주번호" />
|
||||
<button type="submit" class="erp-btn erp-btn-outline">찾기</button>
|
||||
<span class="io-nav-gap"></span>
|
||||
<span class="erp-muted">진행 중인 발주(종결·취소 제외)의 남은 수량</span>
|
||||
</form>
|
||||
|
||||
<div class="io-kpis">
|
||||
<div class="erp-summary-card erp-summary-card--mini"><div class="erp-summary-label">미입고 수량</div><div class="erp-summary-value">{{ n(total_remaining) }}</div></div>
|
||||
<div class="erp-summary-card erp-summary-card--mini"><div class="erp-summary-label">미입고 제품</div><div class="erp-summary-value">{{ n(items|length) }}종</div></div>
|
||||
<div class="erp-summary-card erp-summary-card--mini"><div class="erp-summary-label">미입고 발주 줄</div><div class="erp-summary-value">{{ n(rows|length) }}</div></div>
|
||||
<div class="erp-summary-card erp-summary-card--mini{% if over %} io-kpi-over{% endif %}"><div class="erp-summary-label">초과 입고</div><div class="erp-summary-value">{{ n(over|length) }}건</div></div>
|
||||
</div>
|
||||
|
||||
<div class="erp-card-block io-block">
|
||||
<div class="erp-card-block-head"><h2>제품별 미입고 합계</h2><span class="erp-muted">여러 발주에 걸친 남은 수량을 제품마다 더한 값</span></div>
|
||||
<div class="erp-table-wrap">
|
||||
<table class="erp-table io-table">
|
||||
<thead><tr><th>제품 코드</th><th>제품</th><th class="io-num">미입고</th><th class="io-num">발주 건수</th><th>가장 이른 입고 예정일</th></tr></thead>
|
||||
<tbody>
|
||||
{% for it in items %}
|
||||
<tr>
|
||||
<td class="io-code">{{ it.item_code }}</td><td>{{ it.item_name }}</td>
|
||||
<td class="io-num io-remaining">{{ n(it.remaining) }}</td><td class="io-num">{{ it.orders }}</td>
|
||||
<td>{{ due(it.earliest_due, today, True) }}</td>
|
||||
</tr>
|
||||
{% else %}
|
||||
<tr><td colspan="5" class="erp-empty">미입고된 제품이 없습니다. 모두 들어왔습니다.</td></tr>
|
||||
{% endfor %}
|
||||
</tbody>
|
||||
</table>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
{% if rows %}
|
||||
<div class="erp-card-block io-block">
|
||||
<div class="erp-card-block-head"><h2>발주별 미입고</h2><span class="erp-muted">입고 예정일이 이른 순 — 지난 것은 빨강</span></div>
|
||||
<div class="erp-table-wrap">
|
||||
<table class="erp-table io-table">
|
||||
<thead><tr><th>입고 예정일</th><th>발주번호</th><th>공장</th><th>제품 코드</th><th>제품</th>
|
||||
<th class="io-num">발주</th><th class="io-num">입고</th><th class="io-num">미입고</th></tr></thead>
|
||||
<tbody>
|
||||
{% for r in rows %}
|
||||
<tr class="io-row-link{% if r.due_date and r.due_date < today %} is-late{% endif %}" data-href="/inout/orders/{{ r.order_id }}">
|
||||
<td>{{ due(r.due_date, today, True) }}</td>
|
||||
<td><a href="/inout/orders/{{ r.order_id }}" class="io-order-no">{{ r.order_no }}</a><div class="erp-row-sub">발주 {{ ymd(r.order_date) }}</div></td>
|
||||
<td>{{ r.factory_name }}</td><td class="io-code">{{ r.item_code }}</td><td>{{ r.item_name }}</td>
|
||||
<td class="io-num">{{ n(r.qty) }}</td><td class="io-num">{{ n(r.received) }}</td>
|
||||
<td class="io-num io-remaining">{{ n(r.remaining) }}</td>
|
||||
</tr>
|
||||
{% endfor %}
|
||||
</tbody>
|
||||
</table>
|
||||
</div>
|
||||
</div>
|
||||
{% endif %}
|
||||
|
||||
{% if over %}
|
||||
<div class="erp-card-block io-block io-block-over">
|
||||
<div class="erp-card-block-head"><h2>초과 입고</h2><span class="erp-muted">발주보다 많이 들어온 제품 — 공장과 확인이 필요합니다</span></div>
|
||||
<div class="erp-table-wrap">
|
||||
<table class="erp-table io-table">
|
||||
<thead><tr><th>발주번호</th><th>공장</th><th>제품 코드</th><th>제품</th><th class="io-num">발주</th><th class="io-num">입고</th><th class="io-num">초과</th></tr></thead>
|
||||
<tbody>
|
||||
{% for r in over %}
|
||||
<tr class="io-row-link" data-href="/inout/orders/{{ r.order_id }}">
|
||||
<td><a href="/inout/orders/{{ r.order_id }}" class="io-order-no">{{ r.order_no }}</a></td><td>{{ r.factory_name }}</td>
|
||||
<td class="io-code">{{ r.item_code }}</td><td>{{ r.item_name }}</td>
|
||||
<td class="io-num">{{ n(r.qty) }}</td><td class="io-num">{{ n(r.received) }}</td><td class="io-num io-over">+{{ n(r.over) }}</td>
|
||||
</tr>
|
||||
{% endfor %}
|
||||
</tbody>
|
||||
</table>
|
||||
</div>
|
||||
</div>
|
||||
{% endif %}
|
||||
</section>
|
||||
{% include "inout/_calendar.html" %}
|
||||
</div>
|
||||
{% endblock %}
|
||||
{% block scripts %}<script src="/static/inout.js?v=20261105a" defer></script>{% endblock %}
|
||||
@@ -0,0 +1,38 @@
|
||||
# [라이브커머스] 라이브 커머스 모듈 — `app/modules/live/`, `live_db`(2026-11-04)
|
||||
|
||||
> 이 모듈만 고칠 때 읽는 요약. 별도 상세 문서 없음 — 코드가 기준.
|
||||
> 정적 파일: `app/static/live.js`, `live.css`. 템플릿: `templates/live/`. 테스트: `tests/test_live.py`(`LIVE_TEST_DB_URL` 이 localhost 일 때 실제 DB).
|
||||
> 다른 모듈과 연결: 이미지 검사 = 자산 모듈 `app/modules/asset/media.py prepare_photo` 재사용(바꾸면 양쪽 확인). 쇼핑몰 로고 = 말레이시아 배송 모듈 `app/static/dispatch/courier/tiktok.png`·`shopee.png`(지우거나 이름을 바꾸면 호스트 설정 로고도 깨짐).
|
||||
|
||||
- 말레이시아 라이브 커머스 방송의 호스트 정보·방송 스케줄. 권한키 `live`, DB `LIVE_DB_URL`(없으면 "설정 필요" 안내).
|
||||
- **호스트 설정** `/live/settings` — 간단한 이름(필수, `display_name`, 마이그레이션 004 — 말레이 이름은 끝이 아버지 이름이라 자동으로 줄이지 않고 사람이 입력, 빈 예전 호스트는 화면에 Full Name)·Full Name (as per IC)(필수)·Phone Number·Email·Address·Bank Name·Bank Account Number.
|
||||
**계좌 등 개인정보라 ERP 관리자만**(`is_admin`) — 화면·저장·지우기 모두. 스케줄 화면에는 `db.host_choices`(이름·사용 여부)만 넘긴다.
|
||||
**틱톡 계정은 호스트가 아니라 방송마다**(2026-11-05, 마이그레이션 003 `live_broadcasts.tiktok_handle`) — 호스트가 여러 계정에서 방송하므로. 방송 창에서 입력(선택), `@`·주소를 붙여 넣어도 계정명만 저장, 쓴 적 있는 계정을 제안(`db.account_choices`). `live_hosts.tiktok_handle` 은 값만 남아 있고 안 씀. 달력에서 옮기거나 맞바꿔도 계정은 그 방송에 그대로. 달력 카드 머리·스케줄표·방송 창의 호스트 = 간단한 이름, 카드 머리 아래 작은 글자 = 계정.
|
||||
**`live_host_edit` 칩**(+ `live`, 관리자 페이지 토글) = 호스트 **고치기**(사용 여부 포함): 지우기 불가, 개인정보는 페이지에 싣지 않아 빈칸으로 열리고 비워 두면 그대로·입력하면 바뀜(이 칩으로는 지울 수 없음).
|
||||
**`live_host` 칩**(+ `live` 칩 필요) = 새 호스트 **등록만**: 설정 화면에 이름·상태만 보이고, 입력한 계좌 등은 저장 후 못 봄. 고치기·지우기 불가, 사용 여부 못 고름(항상 사용).
|
||||
**쇼핑몰**(2026-11-06, 마이그레이션 005 `live_hosts.platform`, `store.PLATFORMS` = tiktok·shopee) — 창 맨 위 라디오 + 로고(같은 상자 88×26, 안 고르면 흑백·고르면 컬러), 저장 때 필수. 목록 첫 열 = 로고. 예전 호스트는 빈 값(고치기에서 고르면 저장).
|
||||
**목록의 사용 토글**(`POST /live/settings/hosts/{id}/active`, `db.set_host_active`) = 고치기 권한(관리자·`live_host_edit` 칩)만, 바로 저장·실패하면 되돌림. 권한 없으면 글자(사용/사용 안 함).
|
||||
사용 안 함 = 새 방송에서 못 고름(그 호스트로 이미 등록된 방송을 고칠 때만 보임). 방송 기록이 있는 호스트는 못 지움(FK RESTRICT).
|
||||
- **스케줄표** `/live/?month=YYYY-MM`(`live` 권한자 모두) — 호스트·날짜·시작/끝 시간·판매금액·시간 요금(Fee)·커미션·광고비·호스트 비용·결과 이미지. 호스트·날짜·시작·끝 시간 필수(판매금액은 방송 후 입력).
|
||||
시간은 입력한 말레이시아 시간 그대로(시간대 변환 없음, DATE·TIME). 금액 단위 RM(`NUMERIC(14,2)`, `store.parse_money(값, 이름)`). 끝 시간이 시작보다 이르면 자정을 넘긴 방송.
|
||||
표 첫 열 = 호스트 쇼핑몰 아이콘(`/static/live-icon-tiktok.png`·`live-icon-shopee.png` = 말레이시아 배송 로고에서 심볼만 잘라 64px, 쇼핑몰 안 고른 호스트는 빈칸), 머리글 = 가운데·굵게·검정·공용 크기 112%(`.lv-sched`, 스케줄표만).
|
||||
**방송 장소는 2026-11-06 에 창·표에서 뺌**(`venue` 열은 예전 값만 남고 저장 때 건드리지 않음, 달력 카드 말풍선에만 예전 값).
|
||||
- **방송 창 금액**(2026-11-06, 마이그레이션 006) — **Fee**(시간 × RM 25 `HOURLY_RATE`)·**커미션**(판매금액 × 10% `COMMISSION_PERCENT`) = 자동, 저장 안 함(`store.session_pay`, 창에서는 `live.js recalc` 가 같은 계산 — 시간·판매금액을 바꾸거나 결과 이미지에서 매출을 읽으면 다시 계산). 요율이 코드 상수라 바꾸면 지난 방송 값도 바뀐다.
|
||||
**광고비**(`live_broadcasts.ad_spend`)·**호스트 비용**(`host_fee`, 일단 수기 입력) = 입력·저장. 달력 카드 Fee·날짜/달 합계 호스트 비용 = `host_fee` 합(비우면 0).
|
||||
- **달력 보기** `/live/calendar?month=`(`store.build_calendar`, 사용자가 준 화면 참고, 글자도 영어 그대로) — 줄 = 1시간 칸(2026-11-06 `store.SLOT_HOURS` 2 → 1, 06:00~24:00 늘 보임, 그보다 이른 칸은 방송이 있을 때만, 칸은 시작 시간으로 정함), 열 = 날짜, 주말 노랑, 위 달 합계, 맨 아래 날짜별 TOTAL SALES·AD SPEND·HOST FEE·ROAS.
|
||||
카드 머리 왼쪽 위 = 호스트 쇼핑몰 작은 아이콘(2026-11-06, 예전 ✥ 대신 — 머리 전체가 끌기 손잡이), 카드 머리 = **Tiktok Handle**(없으면 이름, 색 = 호스트 id 순 `HOST_COLORS`), SALES·COM·Fee. 카드 머리를 끌어 빈 칸으로 = 옮기기(`move`, 방송 길이 유지) · 다른 카드 위 = 맞바꾸기(`swap_with`, 날짜·시간 교환). 다시 그린 뒤 가로 위치 유지(sessionStorage). 빈 칸 + = 그 날짜·시간이 채워진 추가 창.
|
||||
**AD SPEND** = 그날 방송 광고비(`ad_spend`) 합(2026-11-06 — 예전 날짜별 입력 `live_daily_ad_spend`·✎ 버튼·`/live/ad-spend` 없앰, 표는 값만 남김), ROAS = 판매금액 ÷ 광고비(광고비 없으면 `-`).
|
||||
- **한 화면 맞춤**(2026-11-05) — 달력 보기는 넓은 화면(1101px 이상)에서 페이지 세로 스크롤 없음: `.lv-cal-wrap` 이 남은 높이를 쓰고, 풀HD 브라우저(세로 880px 이상)면 방송이 없는 달은 18개 시간 칸·합계 줄이 표 안 스크롤 없이 들어간다(카드가 있는 줄은 카드 높이만큼 커져서 방송이 많으면 표 안에서 스크롤, 페이지는 안 움직임). **방송이 걸친 칸은 합친다**(2026-11-06, `store._covered_slots` → `rowspan`, 가려진 칸 `skip`) — 2시간 방송 = 두 칸, 끝이 정각이 아니면 그 칸까지, 자정 넘김은 그날 마지막 칸까지. 합친 칸 안에서 시작하는 다른 방송은 같은 칸에 들어가고 칸이 더 늘어난다(겹친 방송). 끌어 놓기는 합친 칸의 첫 시간으로. 카드·표 글자·칸 크기를 늘리면 `live_calendar.browser.test.js` 로 다시 확인.
|
||||
- **오른쪽 달력**(2026-11-05, 달력 보기만, 세로 2분할 `.lv-split`, 240px = 공용 달력의 80%, 예전 날짜로 이동 줄 대신, 공용 `erp-datepop` `mountRange` + `locale` 옵션으로 영문) — 날짜를 누르면 그 날이 표 맨 왼쪽(마지막 날까지 — `endGap` 이 표 끝에 여백), 다른 달이면 그 달 화면으로 가서 맨 왼쪽(sessionStorage `lv_cal_jump`). 표시만 하고 요금·일수에 안 씀. 글자 굵게, **방송 있는 날 = 숫자 오른쪽 위 초록 점**(2026-11-06, `db.broadcast_days` 보는 달 ±1년 → `#lv-live-days`, 공용 `mountRange` 의 `dayClass` 옵션 → `has-live`). 테스트 `tests/js/live_calendar.browser.test.js`(`render_live.py`).
|
||||
**말레이시아 공휴일 표 = `holidays.py`**(쿠알라룸푸르 기준, 2026·2027, 대체휴일 포함) — 이슬람 명절은 달 관측으로 바뀔 수 있고, 2028 은 공고되면 손으로 추가.
|
||||
- **결과 이미지 미리보기**(2026-11-06, 달력 보기) — 카드 오른쪽 아래 이미지 링크(`a[data-preview]`)에 마우스를 올리거나 탭으로 가면 오른쪽 달력 아래 빈 곳(`#lv-preview`, `.lv-side` 세로 줄)에 첫 장을 보여 주고 벗어나면 숨김. 좁은 화면(1100px 이하)은 미리보기 없음.
|
||||
링크를 **누르면 화면 가운데 보기 창**(`#lv-viewer` `<dialog>`) — 원본 크기(크면 창 안 스크롤), 회전(보기만, 90°씩, 다운로드는 원본), 다운로드(올린 파일 이름), 여러 장이면 ◀▶. Ctrl·가운데 클릭은 새 탭.
|
||||
- **카드 높이 = 합친 칸 높이**(2026-11-06) — `.lv-cell { height:1px }` + `.lv-cards { height:100% }` 로 칸 높이를 채운다(같은 칸 여러 카드는 나눠 가짐).
|
||||
- **결과 이미지 → 매출 자동 입력**(2026-11-06, `ocr.py`, `POST /live/broadcasts/read-sales`) — 창에서 이미지를 고르면 서버의 Tesseract(Dockerfile 에서 설치, 외부 전송 없음)가 이미지 **위 절반**을 읽어 첫 `RM` 금액(틱톡 LIVE 결과 화면의 Attr. GMV)을 판매금액 칸에 채운다(저장 안 함 — 사람이 확인 후 저장, 여러 장이면 찾을 때까지 한 장씩). `RM1.2K` 처럼 줄인 값·못 찾음 = 칸 그대로 + 안내. tesseract 가 없으면(로컬 개발 PC) 안내만.
|
||||
- **결과 이미지** — 방송 저장과 한 트랜잭션, JPG·PNG·WebP, 한 장 8MB, 방송당 10장(`store.MAX_IMAGES`). `prepare_photo` 가 실제 이미지 확인·긴 변 2400px·EXIF(GPS 등) 제거. BYTEA 저장.
|
||||
`GET /live/images/{id}`(권한 필요, 하루 private 캐시), `?thumb=1` = 160px JPEG(그때그때 만듦). 올린 뒤 내용이 안 바뀐다는 전제 — 이미지를 고치는 기능을 넣으면 캐시도 바꿀 것.
|
||||
- 라이브 커머스 화면은 공용 최대 폭(1550px)을 풀어 **화면 전체 너비**를 쓴다(`live.css` 맨 위, 스케줄표·달력·호스트 설정).
|
||||
- 저장은 `live.js` 가 fetch → JSON `{ok, message}`(틀려도 창의 입력값 유지). 창 하나로 추가·고치기(`data-edit` JSON).
|
||||
- **한글·영문 전환**(`i18n.py`) — 위 막대 [한글|EN], 쿠키 `live_lang`(브라우저마다, path=/live, 기본 한글). 한글 문구가 키, 템플릿 `t('…')`, 오류 `LiveError(틀, 값)`(라우터가 언어에 맞게), JS `LV_T`(`JS_KEYS`).
|
||||
**새 문구는 `i18n.EN` 에도 넣는다** — `tests/test_live.py` 가 빠진 문구와 영문 화면의 한글을 잡는다. 입력한 데이터(이름·장소 등)·ERP 공용 사이드바는 번역하지 않는다.
|
||||
- 메인 카드 제목 = `main.py` `card_title`(한글·영문), 사이드바는 `title` 그대로.
|
||||
@@ -0,0 +1,21 @@
|
||||
"""라이브 커머스(live) 모듈 — 말레이시아 라이브 방송의 호스트 정보와 방송 스케줄(2026-11-04).
|
||||
|
||||
- 라우터: `router.py` (prefix=/live) · 저장소: `db.py` (live_db) · 순수 함수: `store.py`(입력 검사·표시 형식)
|
||||
- 템플릿: `templates/live/`, 화면 스크립트·스타일 `static/live.{js,css}`
|
||||
|
||||
LIVE_DB_URL 미설정이면 build_live_store 가 None → 화면이 "설정 필요" 안내(앱은 죽지 않음). 권한키 `live`.
|
||||
"""
|
||||
|
||||
from typing import Any
|
||||
|
||||
from .router import router
|
||||
|
||||
__all__ = ["router", "build_live_store"]
|
||||
|
||||
|
||||
def build_live_store(*, dsn: str | None) -> Any:
|
||||
if not dsn:
|
||||
return None
|
||||
from .db import LiveDBStore # 지연 import
|
||||
|
||||
return LiveDBStore(dsn)
|
||||
@@ -0,0 +1,176 @@
|
||||
"""live_db PostgreSQL 저장소 — 라이브 커머스 호스트·방송 스케줄·결과 이미지(2026-11-04).
|
||||
|
||||
- 연결: 환경변수 `LIVE_DB_URL` (예: postgresql://live_app:<pwd>@postgres-db:5432/live_db)
|
||||
- 스키마는 앱이 만들지 않는다 — `scripts/sql/live_db_init.sql` 을 superuser 가 먼저 적용(앱 계정은 CRUD 만).
|
||||
- 연결 풀은 lazy open — 부팅 때 DB 가 잠시 끊겨도 컨테이너가 죽지 않게(다른 모듈과 같은 방식).
|
||||
"""
|
||||
|
||||
from __future__ import annotations
|
||||
|
||||
from datetime import date, time
|
||||
from typing import Any
|
||||
|
||||
from psycopg.errors import ForeignKeyViolation
|
||||
from psycopg.rows import dict_row
|
||||
from psycopg_pool import ConnectionPool
|
||||
|
||||
from . import store
|
||||
from .i18n import LiveError
|
||||
|
||||
_HOST_COLUMNS = ("platform", "display_name", "full_name", "phone", "email", "address", "bank_name", "bank_account")
|
||||
|
||||
|
||||
class LiveDBStore:
|
||||
def __init__(self, dsn: str, *, min_size: int = 1, max_size: int = 4):
|
||||
self._pool = ConnectionPool(conninfo=dsn, min_size=min_size, max_size=max_size,
|
||||
kwargs={"row_factory": dict_row, "autocommit": True}, open=False)
|
||||
self._pool.open(wait=False)
|
||||
|
||||
def close(self) -> None:
|
||||
self._pool.close()
|
||||
|
||||
# ── 호스트 ─────────────────────────────────────────────
|
||||
def list_hosts(self) -> list[dict[str, Any]]:
|
||||
"""전체 정보(계좌 포함) — 설정 화면(ERP 관리자)에서만 쓴다."""
|
||||
with self._pool.connection() as conn:
|
||||
return conn.execute("SELECT * FROM live_hosts ORDER BY is_active DESC, full_name, id").fetchall()
|
||||
|
||||
def host_choices(self) -> list[dict[str, Any]]:
|
||||
"""스케줄 화면 호스트 고르기 — 개인정보·계좌는 뺀다."""
|
||||
with self._pool.connection() as conn:
|
||||
return conn.execute("SELECT id, platform, display_name, full_name, is_active FROM live_hosts ORDER BY full_name, id").fetchall()
|
||||
|
||||
def get_host(self, host_id: int) -> dict[str, Any] | None:
|
||||
with self._pool.connection() as conn:
|
||||
return conn.execute("SELECT * FROM live_hosts WHERE id=%s", (host_id,)).fetchone()
|
||||
|
||||
def account_choices(self) -> list[str]:
|
||||
"""방송 창 틱톡 계정 입력 제안 — 지금까지 방송에 쓴 계정."""
|
||||
with self._pool.connection() as conn:
|
||||
rows = conn.execute("SELECT DISTINCT tiktok_handle FROM live_broadcasts WHERE tiktok_handle <> '' ORDER BY tiktok_handle").fetchall()
|
||||
return [r["tiktok_handle"] for r in rows]
|
||||
|
||||
def save_host(self, host_id: int | None, values: dict[str, str], *, is_active: bool, by: str) -> int:
|
||||
cols = [values[k] for k in _HOST_COLUMNS]
|
||||
with self._pool.connection() as conn:
|
||||
if host_id is None:
|
||||
row = conn.execute(
|
||||
"INSERT INTO live_hosts (platform, display_name, full_name, phone, email, address, bank_name, bank_account, "
|
||||
"is_active, created_by, updated_by) VALUES (%s,%s,%s,%s,%s,%s,%s,%s,%s,%s,%s) RETURNING id",
|
||||
(*cols, is_active, by, by)).fetchone()
|
||||
else:
|
||||
row = conn.execute(
|
||||
"UPDATE live_hosts SET platform=%s, display_name=%s, full_name=%s, phone=%s, email=%s, address=%s, bank_name=%s, bank_account=%s, "
|
||||
"is_active=%s, updated_by=%s WHERE id=%s RETURNING id",
|
||||
(*cols, is_active, by, host_id)).fetchone()
|
||||
if not row:
|
||||
raise LiveError("호스트를 찾을 수 없습니다.")
|
||||
return int(row["id"])
|
||||
|
||||
def set_host_active(self, host_id: int, is_active: bool, *, by: str) -> None:
|
||||
"""목록의 사용 토글 — 사용 여부만 바꾼다."""
|
||||
with self._pool.connection() as conn:
|
||||
if not conn.execute("UPDATE live_hosts SET is_active=%s, updated_by=%s WHERE id=%s RETURNING id",
|
||||
(is_active, by, host_id)).fetchone():
|
||||
raise LiveError("호스트를 찾을 수 없습니다.")
|
||||
|
||||
def delete_host(self, host_id: int) -> None:
|
||||
try:
|
||||
with self._pool.connection() as conn:
|
||||
row = conn.execute("DELETE FROM live_hosts WHERE id=%s RETURNING id", (host_id,)).fetchone()
|
||||
except ForeignKeyViolation:
|
||||
raise LiveError("방송 기록이 있는 호스트는 지울 수 없습니다 — 사용 안 함으로 바꾸세요.") from None
|
||||
if not row:
|
||||
raise LiveError("호스트를 찾을 수 없습니다.")
|
||||
|
||||
# ── 방송 스케줄 ─────────────────────────────────────────
|
||||
def list_broadcasts(self, start: date, end: date) -> list[dict[str, Any]]:
|
||||
"""start 이상 end 미만, 날짜·시간 순. 줄마다 images = [{id, filename}](내용 제외)."""
|
||||
with self._pool.connection() as conn:
|
||||
rows = conn.execute(
|
||||
"SELECT b.*, COALESCE(NULLIF(h.display_name, ''), h.full_name) AS host_name, h.platform AS host_platform FROM live_broadcasts b JOIN live_hosts h ON h.id = b.host_id "
|
||||
"WHERE b.broadcast_date >= %s AND b.broadcast_date < %s ORDER BY b.broadcast_date, b.start_time, b.id",
|
||||
(start, end)).fetchall()
|
||||
images = conn.execute(
|
||||
"SELECT id, broadcast_id, filename FROM live_broadcast_images WHERE broadcast_id = ANY(%s) ORDER BY id",
|
||||
([r["id"] for r in rows],)).fetchall()
|
||||
for r in rows:
|
||||
r["images"] = [i for i in images if i["broadcast_id"] == r["id"]]
|
||||
return rows
|
||||
|
||||
def broadcast_days(self, start: date, end: date) -> list[str]:
|
||||
"""start 이상 end 미만 방송이 있는 날(ISO) — 오른쪽 달력 점."""
|
||||
with self._pool.connection() as conn:
|
||||
rows = conn.execute("SELECT DISTINCT broadcast_date FROM live_broadcasts WHERE broadcast_date >= %s AND broadcast_date < %s ORDER BY 1",
|
||||
(start, end)).fetchall()
|
||||
return [r["broadcast_date"].isoformat() for r in rows]
|
||||
|
||||
def save_broadcast(self, broadcast_id: int | None, values: dict[str, Any], images: list[dict[str, Any]], *, by: str) -> int:
|
||||
"""방송·이미지를 한 트랜잭션으로. 사용 안 함 호스트는 이미 그 호스트인 방송을 고칠 때만 허용."""
|
||||
with self._pool.connection() as conn, conn.transaction():
|
||||
current = None
|
||||
if broadcast_id is not None:
|
||||
found = conn.execute("SELECT host_id FROM live_broadcasts WHERE id=%s FOR UPDATE", (broadcast_id,)).fetchone()
|
||||
if not found:
|
||||
raise LiveError("방송을 찾을 수 없습니다(다른 사람이 지웠을 수 있음).")
|
||||
current = found["host_id"]
|
||||
host = conn.execute("SELECT is_active FROM live_hosts WHERE id=%s", (values["host_id"],)).fetchone()
|
||||
if not host:
|
||||
raise LiveError("호스트를 찾을 수 없습니다.")
|
||||
if not host["is_active"] and values["host_id"] != current:
|
||||
raise LiveError("사용 안 함으로 바뀐 호스트입니다 — 다른 호스트를 고르세요.")
|
||||
# 방송 장소(venue)는 2026-11-06 부터 입력 안 받음 — 예전 값은 그대로 둔다
|
||||
args = (values["host_id"], values["broadcast_date"], values["start_time"], values["end_time"],
|
||||
values["tiktok_handle"], values["sales_amount"], values["ad_spend"], values["host_fee"], by)
|
||||
if broadcast_id is None:
|
||||
broadcast_id = int(conn.execute(
|
||||
"INSERT INTO live_broadcasts (host_id, broadcast_date, start_time, end_time, tiktok_handle, sales_amount, ad_spend, host_fee, updated_by, created_by) "
|
||||
"VALUES (%s,%s,%s,%s,%s,%s,%s,%s,%s,%s) RETURNING id", (*args, by)).fetchone()["id"])
|
||||
else:
|
||||
conn.execute("UPDATE live_broadcasts SET host_id=%s, broadcast_date=%s, start_time=%s, end_time=%s, "
|
||||
"tiktok_handle=%s, sales_amount=%s, ad_spend=%s, host_fee=%s, updated_by=%s WHERE id=%s", (*args, broadcast_id))
|
||||
have = conn.execute("SELECT count(*) AS n FROM live_broadcast_images WHERE broadcast_id=%s", (broadcast_id,)).fetchone()["n"]
|
||||
if have + len(images) > store.MAX_IMAGES:
|
||||
raise LiveError("방송 한 건에 이미지는 {max}장까지입니다(지금 {have}장).", max=store.MAX_IMAGES, have=have)
|
||||
for im in images:
|
||||
conn.execute("INSERT INTO live_broadcast_images (broadcast_id, filename, content_type, data, width, height, created_by) "
|
||||
"VALUES (%s,%s,%s,%s,%s,%s,%s)",
|
||||
(broadcast_id, im["filename"], im["content_type"], im["data"], im["width"], im["height"], by))
|
||||
return broadcast_id
|
||||
|
||||
def delete_broadcast(self, broadcast_id: int) -> None:
|
||||
with self._pool.connection() as conn:
|
||||
if not conn.execute("DELETE FROM live_broadcasts WHERE id=%s RETURNING id", (broadcast_id,)).fetchone():
|
||||
raise LiveError("방송을 찾을 수 없습니다.")
|
||||
|
||||
def move_broadcast(self, broadcast_id: int, day: date, start: time, *, by: str) -> None:
|
||||
"""달력에서 빈 칸으로 옮기기 — 방송 길이는 그대로."""
|
||||
with self._pool.connection() as conn, conn.transaction():
|
||||
row = conn.execute("SELECT start_time, end_time FROM live_broadcasts WHERE id=%s FOR UPDATE", (broadcast_id,)).fetchone()
|
||||
if not row:
|
||||
raise LiveError("방송을 찾을 수 없습니다(다른 사람이 지웠을 수 있음).")
|
||||
conn.execute("UPDATE live_broadcasts SET broadcast_date=%s, start_time=%s, end_time=%s, updated_by=%s WHERE id=%s",
|
||||
(day, start, store.moved_end(row["start_time"], row["end_time"], start), by, broadcast_id))
|
||||
|
||||
def swap_broadcasts(self, first_id: int, second_id: int, *, by: str) -> None:
|
||||
"""달력에서 다른 방송 위로 놓기 — 두 방송의 날짜·시간을 맞바꾼다(id 순서로 잠가 교착 방지)."""
|
||||
if first_id == second_id:
|
||||
return
|
||||
with self._pool.connection() as conn, conn.transaction():
|
||||
rows = conn.execute("SELECT id, broadcast_date, start_time, end_time FROM live_broadcasts WHERE id = ANY(%s) ORDER BY id FOR UPDATE",
|
||||
([first_id, second_id],)).fetchall()
|
||||
if len(rows) != 2:
|
||||
raise LiveError("방송을 찾을 수 없습니다(다른 사람이 지웠을 수 있음).")
|
||||
for mine, other in ((rows[0], rows[1]), (rows[1], rows[0])):
|
||||
conn.execute("UPDATE live_broadcasts SET broadcast_date=%s, start_time=%s, end_time=%s, updated_by=%s WHERE id=%s",
|
||||
(other["broadcast_date"], other["start_time"], other["end_time"], by, mine["id"]))
|
||||
|
||||
# ── 결과 이미지 ─────────────────────────────────────────
|
||||
def get_image(self, image_id: int) -> dict[str, Any] | None:
|
||||
with self._pool.connection() as conn:
|
||||
return conn.execute("SELECT content_type, data FROM live_broadcast_images WHERE id=%s", (image_id,)).fetchone()
|
||||
|
||||
def delete_image(self, image_id: int) -> None:
|
||||
with self._pool.connection() as conn:
|
||||
if not conn.execute("DELETE FROM live_broadcast_images WHERE id=%s RETURNING id", (image_id,)).fetchone():
|
||||
raise LiveError("이미지를 찾을 수 없습니다.")
|
||||
@@ -0,0 +1,59 @@
|
||||
"""말레이시아 공휴일 표(쿠알라룸푸르 기준, 2026-11-05) — 달력 보기 오른쪽 달력에 표시만 한다(요금·일수 계산에 안 씀).
|
||||
|
||||
출처: publicholidays.com.my(KL 2026·2027), 2027 대체휴일은 총리실(JPM) 목록을 옮긴 maukerja.my 기준 — 공식 PDF 원문은 확인하지 못했다.
|
||||
이슬람 명절(하리라야·이슬람 새해·예언자 탄신일 등)은 달 관측으로 며칠 바뀔 수 있고, 주마다 쉬는 날이 달라 다른 주 지사 생일 등은 넣지 않았다.
|
||||
shortcut: 해마다 손으로 추가한다 — 2028 목록이 공고되면 여기에 더한다.
|
||||
"""
|
||||
|
||||
from __future__ import annotations
|
||||
|
||||
_NAMES: dict[str, tuple[str, str]] = {
|
||||
"new_year": ("새해", "New Year's Day"),
|
||||
"thaipusam": ("타이푸삼", "Thaipusam"),
|
||||
"ft_day": ("연방직할구의 날", "Federal Territory Day"),
|
||||
"cny": ("음력 설", "Chinese New Year"),
|
||||
"nuzul": ("코란 계시일", "Nuzul Al-Quran"),
|
||||
"aidilfitri": ("하리라야 푸아사", "Hari Raya Aidilfitri"),
|
||||
"labour": ("노동절", "Labour Day"),
|
||||
"haji": ("하리라야 하지", "Hari Raya Haji"),
|
||||
"wesak": ("웨삭", "Wesak Day"),
|
||||
"agong": ("국왕 탄신일", "Agong's Birthday"),
|
||||
"muharram": ("이슬람 새해", "Awal Muharram"),
|
||||
"maulud": ("예언자 탄신일", "Maulidur Rasul"),
|
||||
"merdeka": ("독립기념일", "Merdeka Day"),
|
||||
"malaysia": ("말레이시아의 날", "Malaysia Day"),
|
||||
"deepavali": ("디파발리", "Deepavali"),
|
||||
"christmas": ("크리스마스", "Christmas Day"),
|
||||
}
|
||||
|
||||
# 날짜 → 공휴일. "@" 로 시작 = 대체휴일(일요일·겹친 공휴일 다음 평일).
|
||||
_DAYS: dict[str, str] = {
|
||||
"2026-01-01": "new_year", "2026-02-01": "thaipusam", "2026-02-02": "@thaipusam", "2026-02-03": "@ft_day",
|
||||
"2026-02-17": "cny", "2026-02-18": "cny", "2026-03-07": "nuzul",
|
||||
"2026-03-20": "aidilfitri", "2026-03-21": "aidilfitri", "2026-03-22": "aidilfitri", "2026-03-23": "@aidilfitri",
|
||||
"2026-05-01": "labour", "2026-05-27": "haji", "2026-05-31": "wesak", "2026-06-01": "agong", "2026-06-02": "@wesak",
|
||||
"2026-06-17": "muharram", "2026-08-25": "maulud", "2026-08-31": "merdeka", "2026-09-16": "malaysia",
|
||||
"2026-11-08": "deepavali", "2026-11-09": "@deepavali", "2026-12-25": "christmas",
|
||||
|
||||
"2027-01-01": "new_year", "2027-01-22": "thaipusam", "2027-02-01": "ft_day",
|
||||
"2027-02-06": "cny", "2027-02-07": "cny", "2027-02-08": "@cny", "2027-02-24": "nuzul",
|
||||
"2027-03-10": "aidilfitri", "2027-03-11": "aidilfitri", "2027-05-01": "labour", "2027-05-17": "haji", "2027-05-20": "wesak",
|
||||
"2027-06-06": "muharram", "2027-06-07": "agong", "2027-06-08": "@muharram", "2027-08-15": "maulud", "2027-08-16": "@maulud",
|
||||
"2027-08-31": "merdeka", "2027-09-16": "malaysia", "2027-10-28": "deepavali", "2027-12-25": "christmas",
|
||||
}
|
||||
# 같은 날 둘(2026-02-01 일요일 — 타이푸삼 + 연방직할구의 날)
|
||||
_ALSO = {"2026-02-01": "ft_day"}
|
||||
|
||||
|
||||
def holiday_names(lang: str = "ko") -> dict[str, str]:
|
||||
"""{날짜: 이름} — 달력에 넘기는 값. 대체휴일은 한글 '… 대체'(공용 달력이 '대체휴일'로 줄임)·영문 '… (Replacement)'."""
|
||||
i = 1 if lang == "en" else 0
|
||||
out = {}
|
||||
for day, key in _DAYS.items():
|
||||
name = _NAMES[key.lstrip("@")][i]
|
||||
if key.startswith("@"):
|
||||
name += " (Replacement)" if lang == "en" else " 대체"
|
||||
if day in _ALSO:
|
||||
name += " · " + _NAMES[_ALSO[day]][i]
|
||||
out[day] = name
|
||||
return out
|
||||
@@ -0,0 +1,125 @@
|
||||
"""라이브 커머스 한글·영문 전환(2026-11-04) — 한글 문구가 키, 없으면 한글 그대로. 언어는 쿠키 `live_lang`(브라우저마다).
|
||||
|
||||
새 문구는 여기에도 넣는다 — tests/test_live.py 가 템플릿·오류 문구가 모두 있는지, 영문 화면에 한글이 없는지 확인한다.
|
||||
"""
|
||||
|
||||
from __future__ import annotations
|
||||
|
||||
from typing import Any
|
||||
|
||||
LANG_COOKIE = "live_lang"
|
||||
|
||||
EN: dict[str, str] = {
|
||||
# 위 막대·보기
|
||||
"이전 달": "Previous month", "다음 달": "Next month", "보기 방식": "View", "표": "Table", "달력": "Calendar",
|
||||
"호스트 설정": "Host Settings", "+ 방송 추가": "+ Add Broadcast", "언어": "Language",
|
||||
"방송을 추가하려면 먼저 호스트를 등록해야 합니다.": "Register a host before adding a broadcast.",
|
||||
"ERP 관리자에게 등록을 요청하세요.": "Ask an ERP admin to register one.",
|
||||
# 방송 창
|
||||
"방송 추가": "Add Broadcast", "방송 고치기": "Edit Broadcast", "호스트": "Host", "호스트를 고르세요": "Select a host",
|
||||
"사용 안 함": "Inactive", "방송 날짜": "Broadcast Date", "시작 시간": "Start Time", "끝 시간": "End Time",
|
||||
"시간은 말레이시아 시간으로 입력합니다.": "Enter times in Malaysia time.", "판매금액 (RM)": "Sales (RM)",
|
||||
"방송 후 입력": "Enter after the broadcast",
|
||||
"시간 요금 (RM)": "Fee (RM)", "커미션 (RM)": "Commission (RM)", "광고비 (RM)": "Ad Spend (RM)", "호스트 비용 (RM)": "Host Fee (RM)",
|
||||
"시간 × RM {rate} — 자동": "Hours × RM {rate} — auto", "판매금액 × {percent}% — 자동": "Sales × {percent}% — auto", "직접 입력": "Enter manually",
|
||||
"방송 결과 이미지 (JPG·PNG·WebP, 한 장 8MB, 방송당 {n}장까지)": "Result images (JPG, PNG, WebP, 8 MB each, up to {n} per broadcast)",
|
||||
"취소": "Cancel", "저장": "Save", "확인": "OK",
|
||||
# 표
|
||||
"날짜": "Date", "시간": "Time", "판매금액(RM)": "Sales (RM)", "커미션 10%(RM)": "Commission 10% (RM)",
|
||||
"호스트 비용(RM)": "Host Fee (RM)", "방송 결과": "Result", "고치기": "Edit", "지우기": "Delete",
|
||||
"시간 요금(RM)": "Fee (RM)", "광고비(RM)": "Ad Spend (RM)",
|
||||
"{date} {host} 방송을 지울까요? 결과 이미지도 함께 지워집니다.": "Delete the {date} broadcast by {host}? Its result images will be deleted too.",
|
||||
"이 달에 등록한 방송이 없습니다.": "No broadcasts this month.",
|
||||
# 달력
|
||||
"판매금액": "Sales", "커미션": "Com", "비용": "Fee", "광고비": "Ad Spend", "호스트 비용": "Host Fee", "총 판매금액": "Total Sales",
|
||||
"ROAS": "ROAS", "합계 & ROAS": "Total & ROAS",
|
||||
"팁: 카드 머리를 끌어 옮기거나 맞바꿀 수 있습니다. 오른쪽으로 스크롤하면 이달 {n}일을 모두 볼 수 있습니다.":
|
||||
"Tip: Drag & drop any host header to move or swap dates. Scroll right to see all {n} days of the month.",
|
||||
"{date} {slot} 방송 추가": "Add broadcast on {date} {slot}", "{name} {date} {times} 고치기": "Edit {name} {date} {times}",
|
||||
"방송 결과 이미지": "Result images", "이미지 {n}": "IMG {n}",
|
||||
# 호스트 설정
|
||||
"◀ 스케줄표": "◀ Schedule", "+ 호스트 등록": "+ Add Host", "호스트 등록": "Add Host", "호스트 고치기": "Edit Host",
|
||||
"간단한 이름": "Short Name", "이름 (IC 기준)": "Full Name (as per IC)", "전화번호": "Phone Number", "이메일": "Email", "주소": "Address", "은행명": "Bank Name",
|
||||
"계좌번호": "Bank Account Number", "틱톡 핸들": "Tiktok Handle", "상태": "Status", "사용": "Active",
|
||||
"{name} 호스트를 지울까요?": "Delete host {name}?", "등록한 호스트가 없습니다.": "No hosts registered.",
|
||||
"사용 (끄면 새 방송에서 고를 수 없습니다)": "Active (when off, the host can't be selected for new broadcasts)",
|
||||
"이미지 매출이 줄인 값({value})이라 정확하지 않습니다. 판매금액을 직접 입력하세요.": "The sales in the image are abbreviated ({value}), so they're not exact. Please enter the Sales yourself.",
|
||||
"이미지에서 매출(RM)을 찾지 못했습니다. 판매금액을 직접 입력하세요.": "Couldn't find the sales (RM) in the image. Please enter the Sales yourself.",
|
||||
"이미지에서 매출 {value} 를 읽었습니다. 확인 후 저장하세요.": "Read sales {value} from the image. Please check it, then save.",
|
||||
"서버에 글자 인식 프로그램(tesseract)이 없습니다. 판매금액을 직접 입력하세요.": "Text recognition (tesseract) isn't installed on the server. Please enter the Sales yourself.",
|
||||
"이미지 글자 인식이 너무 오래 걸립니다. 판매금액을 직접 입력하세요.": "Reading the image took too long. Please enter the Sales yourself.",
|
||||
"이미지 글자를 읽지 못했습니다. 판매금액을 직접 입력하세요.": "Couldn't read the text in the image. Please enter the Sales yourself.",
|
||||
"이미지에서 매출을 읽는 중…": "Reading sales from the image…",
|
||||
"이전 이미지": "Previous image", "다음 이미지": "Next image", "회전": "Rotate", "다운로드": "Download", "닫기": "Close",
|
||||
"쇼핑몰": "Platform", "쇼핑몰(틱톡·쇼피)을 고르세요.": "Choose the platform (TikTok or Shopee).",
|
||||
"사용으로 바꿨습니다.": "Set to active.", "사용 안 함으로 바꿨습니다.": "Set to inactive.",
|
||||
# 화면 스크립트(live.js)
|
||||
"서버에 연결하지 못했습니다. 입력한 값은 그대로 있으니 다시 저장해 보세요.": "Could not reach the server. Your entries are kept — please try saving again.",
|
||||
"이 이미지": "this image", "{name} 를 지울까요?": "Delete {name}?",
|
||||
# 저장 결과·입력 오류
|
||||
"저장했습니다.": "Saved.", "옮겼습니다.": "Moved.","방송을 지웠습니다.": "Broadcast deleted.",
|
||||
"이미지를 지웠습니다.": "Image deleted.", "호스트를 저장했습니다.": "Host saved.", "호스트를 지웠습니다.": "Host deleted.",
|
||||
"잘못된 요청입니다.": "Invalid request.",
|
||||
"간단한 이름을 입력하세요.": "Enter the Short Name.", "이름 (IC 기준)을 입력하세요.": "Enter the Full Name (as per IC).",
|
||||
"개인정보는 보이지 않습니다. 비워 두면 그대로 유지됩니다.": "Personal details are hidden. Leave them blank to keep the current values.", "{label} 이(가) 너무 깁니다({limit}자까지).": "{label} is too long (up to {limit} characters).",
|
||||
"이메일 형식이 올바르지 않습니다.": "The email format is invalid.", "전화번호는 숫자·+·-·괄호만 입력하세요.": "Phone Number may contain only digits, +, - and brackets.",
|
||||
"계좌번호는 숫자·-만 입력하세요.": "Bank Account Number may contain only digits and -.",
|
||||
"틱톡 핸들은 영문·숫자·밑줄·점만 입력하세요.": "Tiktok Handle may contain only letters, digits, underscores and dots.",
|
||||
"{label}은(는) 숫자로 입력하세요.": "{label} must be a number.", "{label}은(는) 0 이상 숫자로 입력하세요.": "{label} must be a number of 0 or more.", "{label}이(가) 너무 큽니다.": "{label} is too large.",
|
||||
"{label}을 입력하세요.": "Enter the {label}.", "{label}이 올바르지 않습니다.": "The {label} is invalid.",
|
||||
"호스트를 고르세요.": "Select a host.", "방송 날짜를 입력하세요.": "Enter the broadcast date.",
|
||||
"끝 시간이 시작 시간과 같습니다.": "End time is the same as start time.", "날짜가 올바르지 않습니다.": "The date is invalid.",
|
||||
"호스트를 찾을 수 없습니다.": "Host not found.", "방송 기록이 있는 호스트는 지울 수 없습니다 — 사용 안 함으로 바꾸세요.": "A host with broadcasts can't be deleted — set the host to Inactive instead.",
|
||||
"방송을 찾을 수 없습니다(다른 사람이 지웠을 수 있음).": "Broadcast not found (someone may have deleted it).", "방송을 찾을 수 없습니다.": "Broadcast not found.",
|
||||
"사용 안 함으로 바뀐 호스트입니다 — 다른 호스트를 고르세요.": "This host is Inactive — select another host.",
|
||||
"방송 한 건에 이미지는 {max}장까지입니다(지금 {have}장).": "Up to {max} images per broadcast (currently {have}).", "방송 한 건에 이미지는 {max}장까지입니다.": "Up to {max} images per broadcast.",
|
||||
"이미지를 찾을 수 없습니다.": "Image not found.",
|
||||
"{name}: {detail}": "{name}: {detail}",
|
||||
# 권한·설정
|
||||
"로그인이 필요합니다.": "Please sign in.", "라이브 커머스 모듈 권한이 없습니다.": "You don't have access to the Live Commerce module.",
|
||||
"호스트 정보는 ERP 관리자만 볼 수 있습니다.": "Only ERP admins can view host information.", "라이브 커머스 DB(LIVE_DB_URL)가 설정되지 않았습니다.": "The Live Commerce DB (LIVE_DB_URL) is not configured.",
|
||||
"라이브 커머스 모듈 접근 권한이 없습니다.": "You don't have access to the Live Commerce module.",
|
||||
"라이브 커머스 모듈이 아직 설정되지 않았습니다. scripts/sql/live_db_init.sql 로 live_db 를 만들고 .env 에 LIVE_DB_URL 을 넣은 뒤 컨테이너를 다시 시작하세요.":
|
||||
"The Live Commerce module is not set up yet. Create live_db with scripts/sql/live_db_init.sql, add LIVE_DB_URL to .env and restart the container.",
|
||||
# 자산 모듈 prepare_photo 오류(이미지 검사를 함께 쓴다)
|
||||
"사진은 비어 있지 않은 8 MB 이하 파일이어야 합니다.": "The image must be a non-empty file of 8 MB or less.", "JPG, PNG, WebP 사진만 등록할 수 있습니다.": "Only JPG, PNG and WebP images are allowed.",
|
||||
"사진은 2천만 화소 이하로 등록하세요.": "The image must be 20 megapixels or less.", "사진을 압축해 다시 등록하세요. 저장 크기는 5 MB 이하입니다.": "Please compress the image and try again (5 MB or less once stored).",
|
||||
"사진을 읽을 수 없습니다. 정상적인 JPG, PNG, WebP 파일을 선택하세요.": "The image can't be read. Please choose a valid JPG, PNG or WebP file.",
|
||||
}
|
||||
|
||||
# 화면 스크립트에 넘기는 문구(window.LV_T)
|
||||
JS_KEYS = ("확인", "취소", "지우기", "서버에 연결하지 못했습니다. 입력한 값은 그대로 있으니 다시 저장해 보세요.", "이 이미지", "{name} 를 지울까요?",
|
||||
"이미지에서 매출을 읽는 중…")
|
||||
|
||||
_MONTH_NAMES = ("January", "February", "March", "April", "May", "June", "July", "August", "September", "October", "November", "December")
|
||||
|
||||
|
||||
def norm_lang(raw: Any) -> str:
|
||||
return "en" if raw == "en" else "ko"
|
||||
|
||||
|
||||
def t(text: str, lang: str = "ko") -> str:
|
||||
return EN.get(text, text) if lang == "en" else text
|
||||
|
||||
|
||||
def js_text(lang: str) -> dict[str, str]:
|
||||
return {k: t(k, lang) for k in JS_KEYS}
|
||||
|
||||
|
||||
def month_label(year: int, month: int, lang: str = "ko") -> str:
|
||||
return f"{_MONTH_NAMES[month - 1]} {year}" if lang == "en" else f"{year}년 {month}월"
|
||||
|
||||
|
||||
class LiveError(ValueError):
|
||||
"""입력·저장 오류 — 언어에 맞게 다시 쓸 수 있게 문구 틀과 값을 따로 둔다. str() = 한글."""
|
||||
|
||||
def __init__(self, template: str, **params: Any):
|
||||
self.template, self.params = template, params
|
||||
super().__init__(template.format(**params))
|
||||
|
||||
def text(self, lang: str) -> str:
|
||||
return t(self.template, lang).format(**{k: t(v, lang) if isinstance(v, str) else v for k, v in self.params.items()})
|
||||
|
||||
|
||||
def error_text(exc: Exception, lang: str) -> str:
|
||||
return exc.text(lang) if isinstance(exc, LiveError) else t(str(exc), lang)
|
||||
@@ -0,0 +1,71 @@
|
||||
"""방송 결과 이미지(틱톡 LIVE 결과 화면)에서 매출 읽기(2026-11-06).
|
||||
|
||||
틱톡 화면 맨 위 카드 `RM672.2 / Attr. GMV` 의 첫 `RM` 금액을 판매금액으로 쓴다. 글자 인식 = 서버의 Tesseract(`tesseract`
|
||||
명령, Dockerfile 에서 설치) — 외부로 보내지 않는다. 읽은 값은 창의 칸에 채워 줄 뿐이고, 사람이 확인한 뒤 저장한다.
|
||||
"""
|
||||
|
||||
from __future__ import annotations
|
||||
|
||||
import io
|
||||
import re
|
||||
import shutil
|
||||
import subprocess
|
||||
from decimal import Decimal, InvalidOperation
|
||||
|
||||
from PIL import Image, ImageOps
|
||||
|
||||
from app.modules.asset.media import prepare_photo
|
||||
|
||||
from .i18n import LiveError
|
||||
|
||||
TIMEOUT_SECONDS = 30
|
||||
# 'RM672.2', 'RM 1,234.50', 'RM1.2K'(줄인 값) — OCR 이 RM 사이에 빈칸을 넣기도 한다
|
||||
_RM_RE = re.compile(r"R\s?M\s*([0-9][0-9,]*(?:[.,][0-9]+)?)\s*([KkMm](?![A-Za-z]))?")
|
||||
|
||||
|
||||
def parse_sales(text: str) -> tuple[Decimal | None, str]:
|
||||
"""OCR 글자 → (금액, 읽은 원문). 첫 RM 금액을 쓴다(아래 Rewards 칸은 $). K·M 으로 줄인 값은 정확하지 않아 None."""
|
||||
m = _RM_RE.search(text or "")
|
||||
if not m:
|
||||
return None, ""
|
||||
raw, suffix = m.group(1), m.group(2)
|
||||
shown = "RM" + raw + (suffix or "")
|
||||
if suffix:
|
||||
return None, shown
|
||||
num = raw
|
||||
if "." not in num and "," in num and len(num.rsplit(",", 1)[1]) <= 2: # 'RM672,2' = 점을 쉼표로 읽음
|
||||
num = num[: num.rfind(",")] + "." + num.rsplit(",", 1)[1]
|
||||
try:
|
||||
value = Decimal(num.replace(",", ""))
|
||||
except InvalidOperation:
|
||||
return None, shown
|
||||
return value.quantize(Decimal("0.01")), shown
|
||||
|
||||
|
||||
def _ocr_text(img: Image.Image) -> str:
|
||||
exe = shutil.which("tesseract")
|
||||
if not exe:
|
||||
raise LiveError("서버에 글자 인식 프로그램(tesseract)이 없습니다. 판매금액을 직접 입력하세요.")
|
||||
gray = ImageOps.grayscale(img)
|
||||
if gray.width < 1000: # 작은 캡처는 키워야 잘 읽힌다
|
||||
gray = gray.resize((gray.width * 2, gray.height * 2), Image.LANCZOS)
|
||||
buf = io.BytesIO()
|
||||
gray.save(buf, format="PNG")
|
||||
try:
|
||||
res = subprocess.run([exe, "stdin", "stdout", "-l", "eng", "--psm", "11"], input=buf.getvalue(),
|
||||
capture_output=True, timeout=TIMEOUT_SECONDS, check=False)
|
||||
except subprocess.TimeoutExpired:
|
||||
raise LiveError("이미지 글자 인식이 너무 오래 걸립니다. 판매금액을 직접 입력하세요.") from None
|
||||
if res.returncode != 0:
|
||||
raise LiveError("이미지 글자를 읽지 못했습니다. 판매금액을 직접 입력하세요.")
|
||||
return res.stdout.decode("utf-8", "replace")
|
||||
|
||||
|
||||
def read_sales(raw: bytes) -> tuple[Decimal | None, str]:
|
||||
"""이미지 바이트 → (금액, 읽은 원문). 이미지가 아니면 ValueError(prepare_photo 문구)."""
|
||||
data, _ctype, _w, _h = prepare_photo(raw) # 실제 이미지 확인·크기 제한(저장과 같은 규칙)
|
||||
with Image.open(io.BytesIO(data)) as img:
|
||||
img.load()
|
||||
# 매출 카드는 화면 위쪽 — 위 절반만 읽어 빠르고, 아래 다른 금액을 잘못 잡지 않게
|
||||
top = img.crop((0, 0, img.width, max(1, img.height // 2)))
|
||||
return parse_sales(_ocr_text(top))
|
||||
@@ -0,0 +1,333 @@
|
||||
"""라이브 커머스(live) 라우터 — 말레이시아 라이브 방송의 호스트 정보·방송 스케줄(2026-11-04).
|
||||
|
||||
GET /live/ 스케줄표(?month=YYYY-MM) · GET /live/calendar 달력 보기(같은 달 값)
|
||||
POST /live/broadcasts 방송 추가·고치기(id 칸이 있으면 고치기) + 결과 이미지 올리기
|
||||
POST /live/broadcasts/{id}/delete 방송 지우기(이미지도 함께)
|
||||
POST /live/broadcasts/{id}/move 달력에서 끌어 옮기기(broadcast_date·start_time) 또는 맞바꾸기(swap_with)
|
||||
POST /live/ad-spend 날짜별 광고비(빈칸 = 지우기)
|
||||
GET /live/images/{id} 결과 이미지(?thumb=1 = 작은 그림) · POST /live/images/{id}/delete
|
||||
GET /live/settings 설정 — 호스트 정보(ERP 관리자만, 계좌 등 개인정보. `live_host` 칩은 이름·틱톡·상태만)
|
||||
POST /live/settings/hosts 호스트 추가·고치기 · POST /live/settings/hosts/{id}/delete
|
||||
권한: 모듈 권한키 `live`(스케줄), 설정은 ERP 관리자, `live` + `live_host` 칩 = 새 호스트 등록, `live` + `live_host_edit` 칩 = 고치기(둘 다 개인정보는 안 보임).
|
||||
DB: LIVE_DB_URL(live_db) — 없으면 "설정 필요" 안내.
|
||||
저장 요청은 live.js 가 fetch 로 보내고 JSON {ok, message} 를 받는다(틀려도 입력한 값이 창에 남게).
|
||||
"""
|
||||
|
||||
from __future__ import annotations
|
||||
|
||||
from datetime import timedelta
|
||||
from pathlib import PurePath
|
||||
from typing import Any
|
||||
|
||||
from fastapi import APIRouter, File, Form, HTTPException, Request, UploadFile
|
||||
from fastapi.responses import HTMLResponse, JSONResponse, Response
|
||||
|
||||
from app.modules.asset.media import MAX_PHOTO_BYTES, prepare_photo
|
||||
from app.timezone import today_kst
|
||||
|
||||
from . import holidays, i18n, ocr, store
|
||||
|
||||
router = APIRouter(prefix="/live", tags=["live"])
|
||||
|
||||
|
||||
def _store(request: Request) -> Any:
|
||||
return getattr(request.app.state, "live_store", None)
|
||||
|
||||
|
||||
def _lang(request: Request) -> str:
|
||||
return i18n.norm_lang(request.cookies.get(i18n.LANG_COOKIE))
|
||||
|
||||
|
||||
def _t(request: Request, text: str) -> str:
|
||||
return i18n.t(text, _lang(request))
|
||||
|
||||
|
||||
def _user(request: Request) -> dict[str, Any]:
|
||||
from app.main import get_current_user_record # noqa: WPS433
|
||||
from app.store import has_module # noqa: WPS433
|
||||
|
||||
user = get_current_user_record(request)
|
||||
if user is None:
|
||||
raise HTTPException(status_code=401, detail=_t(request, "로그인이 필요합니다."))
|
||||
if not has_module(user, "live"):
|
||||
raise HTTPException(status_code=403, detail=_t(request, "라이브 커머스 모듈 권한이 없습니다."))
|
||||
return user
|
||||
|
||||
|
||||
def _admin(request: Request) -> dict[str, Any]:
|
||||
from app.store import is_admin # noqa: WPS433
|
||||
|
||||
user = _user(request)
|
||||
if not is_admin(user):
|
||||
raise HTTPException(status_code=403, detail=_t(request, "호스트 정보는 ERP 관리자만 볼 수 있습니다."))
|
||||
return user
|
||||
|
||||
|
||||
def _can_add_host(user: dict[str, Any]) -> bool:
|
||||
from app.store import has_module, is_admin # noqa: WPS433
|
||||
|
||||
return is_admin(user) or has_module(user, "live_host")
|
||||
|
||||
|
||||
def _can_edit_host(user: dict[str, Any]) -> bool:
|
||||
from app.store import has_module, is_admin # noqa: WPS433
|
||||
|
||||
return is_admin(user) or has_module(user, "live_host_edit")
|
||||
|
||||
|
||||
def _db(request: Request) -> Any:
|
||||
st = _store(request)
|
||||
if st is None:
|
||||
raise HTTPException(status_code=503, detail=_t(request, "라이브 커머스 DB(LIVE_DB_URL)가 설정되지 않았습니다."))
|
||||
return st
|
||||
|
||||
|
||||
def _page(request: Request) -> Any:
|
||||
"""화면 공통 — (st, user) 또는 응답(로그인·권한·설정 필요)."""
|
||||
from app.main import build_erp_nav, get_current_user_record, render_template # noqa: WPS433
|
||||
from app.store import has_module, is_admin, login_redirect # noqa: WPS433
|
||||
|
||||
user = get_current_user_record(request)
|
||||
if user is None:
|
||||
return login_redirect(request)
|
||||
if not has_module(user, "live"):
|
||||
return render_template(request, "denied.html", {"reason": _t(request, "라이브 커머스 모듈 접근 권한이 없습니다."),
|
||||
"is_admin": is_admin(user)}, status_code=403)
|
||||
st = _store(request)
|
||||
if st is None:
|
||||
return render_template(request, "denied.html", {
|
||||
"reason": _t(request, "라이브 커머스 모듈이 아직 설정되지 않았습니다. scripts/sql/live_db_init.sql 로 live_db 를 만들고 "
|
||||
".env 에 LIVE_DB_URL 을 넣은 뒤 컨테이너를 다시 시작하세요."),
|
||||
"user": user, "is_admin": is_admin(user), "nav_items": build_erp_nav(user, active="live")}, status_code=503)
|
||||
return st, user
|
||||
|
||||
|
||||
def _render(request: Request, name: str, user: dict[str, Any], ctx: dict[str, Any]) -> HTMLResponse:
|
||||
from app.main import build_erp_nav, render_template # noqa: WPS433
|
||||
from app.store import is_admin # noqa: WPS433
|
||||
|
||||
lang = _lang(request)
|
||||
return render_template(request, name, {"user": user, "is_admin": is_admin(user), "can_add_host": _can_add_host(user),
|
||||
"can_edit_host": _can_edit_host(user), "lang": lang,
|
||||
"t": lambda text: i18n.t(text, lang), "js_text": i18n.js_text(lang),
|
||||
"hourly_rate": store.fmt_short(store.HOURLY_RATE), "commission_percent": store.fmt_short(store.COMMISSION_PERCENT),
|
||||
"nav_items": build_erp_nav(user, active="live"), **ctx})
|
||||
|
||||
|
||||
def _ok(request: Request, message: str) -> JSONResponse:
|
||||
return JSONResponse({"ok": True, "message": _t(request, message)})
|
||||
|
||||
|
||||
def _fail(request: Request, exc: Exception) -> JSONResponse:
|
||||
return JSONResponse({"ok": False, "message": i18n.error_text(exc, _lang(request))}, status_code=400)
|
||||
|
||||
|
||||
def _opt_id(raw: str) -> int | None:
|
||||
s = (raw or "").strip()
|
||||
if not s:
|
||||
return None
|
||||
if not s.isdigit():
|
||||
raise ValueError("잘못된 요청입니다.")
|
||||
return int(s)
|
||||
|
||||
|
||||
@router.get("/health")
|
||||
def health(request: Request) -> JSONResponse:
|
||||
return JSONResponse({"status": "ok" if _store(request) is not None else "not_configured"})
|
||||
|
||||
|
||||
# ────────────────────────────────────────────────────────────
|
||||
# 스케줄표
|
||||
# ────────────────────────────────────────────────────────────
|
||||
@router.get("/", response_class=HTMLResponse)
|
||||
def index(request: Request, month: str = "") -> Any:
|
||||
got = _page(request)
|
||||
if not isinstance(got, tuple):
|
||||
return got
|
||||
st, user = got
|
||||
lang = _lang(request)
|
||||
span = store.month_range(month, today_kst(), lang)
|
||||
rows = [store.broadcast_view(b, lang) for b in st.list_broadcasts(span["start"], span["end"])]
|
||||
return _render(request, "live/index.html", user, {"view": "table", "span": span, "rows": rows, "hosts": st.host_choices(),
|
||||
"accounts": st.account_choices(), "max_images": store.MAX_IMAGES})
|
||||
|
||||
|
||||
@router.get("/calendar", response_class=HTMLResponse)
|
||||
def calendar(request: Request, month: str = "") -> Any:
|
||||
got = _page(request)
|
||||
if not isinstance(got, tuple):
|
||||
return got
|
||||
st, user = got
|
||||
today, lang = today_kst(), _lang(request)
|
||||
span = store.month_range(month, today, lang)
|
||||
cal = store.build_calendar(span, st.list_broadcasts(span["start"], span["end"]), today, lang)
|
||||
return _render(request, "live/calendar.html", user, {"view": "calendar", "span": span, "cal": cal, "hosts": st.host_choices(),
|
||||
"accounts": st.account_choices(), "max_images": store.MAX_IMAGES,
|
||||
"my_holidays": holidays.holiday_names(lang),
|
||||
# 오른쪽 달력 점 — 앞뒤로 넘겨 볼 달까지(보는 달 ±1년)
|
||||
"live_days": st.broadcast_days(span["start"] - timedelta(days=366), span["end"] + timedelta(days=366))})
|
||||
|
||||
|
||||
@router.post("/broadcasts/{broadcast_id}/move")
|
||||
def broadcast_move(request: Request, broadcast_id: int, broadcast_date: str = Form(""), start_time: str = Form(""),
|
||||
swap_with: str = Form("")) -> JSONResponse:
|
||||
user = _user(request)
|
||||
st = _db(request)
|
||||
try:
|
||||
other = _opt_id(swap_with)
|
||||
if other is not None:
|
||||
st.swap_broadcasts(broadcast_id, other, by=user.get("email", ""))
|
||||
else:
|
||||
day, start = store.parse_move(broadcast_date, start_time)
|
||||
st.move_broadcast(broadcast_id, day, start, by=user.get("email", ""))
|
||||
except ValueError as exc:
|
||||
return _fail(request, exc)
|
||||
return _ok(request, "옮겼습니다.")
|
||||
|
||||
|
||||
def _read_images(files: list[UploadFile]) -> list[dict[str, Any]]:
|
||||
"""고른 파일을 실제 이미지로 확인·메타데이터 제거(GPS 등). 틀리면 ValueError — 아무것도 저장하지 않게 DB 전에."""
|
||||
picked = [f for f in files if f.filename]
|
||||
if len(picked) > store.MAX_IMAGES:
|
||||
raise i18n.LiveError("방송 한 건에 이미지는 {max}장까지입니다.", max=store.MAX_IMAGES)
|
||||
out = []
|
||||
for f in picked:
|
||||
name = PurePath(f.filename.replace("\\", "/")).name[:200]
|
||||
try:
|
||||
data, ctype, width, height = prepare_photo(f.file.read(MAX_PHOTO_BYTES + 1))
|
||||
except ValueError as exc:
|
||||
raise i18n.LiveError("{name}: {detail}", name=name, detail=str(exc)) from None
|
||||
out.append({"filename": name, "content_type": ctype, "data": data, "width": width, "height": height})
|
||||
return out
|
||||
|
||||
|
||||
@router.post("/broadcasts")
|
||||
def broadcast_save(request: Request, id: str = Form(""), host_id: str = Form(""), broadcast_date: str = Form(""),
|
||||
start_time: str = Form(""), end_time: str = Form(""), tiktok_handle: str = Form(""),
|
||||
sales_amount: str = Form(""), ad_spend: str = Form(""), host_fee: str = Form(""),
|
||||
images: list[UploadFile] = File(default=[])) -> JSONResponse:
|
||||
user = _user(request)
|
||||
st = _db(request)
|
||||
try:
|
||||
broadcast_id = _opt_id(id)
|
||||
values = store.clean_broadcast({"host_id": host_id, "broadcast_date": broadcast_date, "start_time": start_time, "end_time": end_time,
|
||||
"tiktok_handle": tiktok_handle, "sales_amount": sales_amount, "ad_spend": ad_spend, "host_fee": host_fee})
|
||||
st.save_broadcast(broadcast_id, values, _read_images(images), by=user.get("email", ""))
|
||||
except ValueError as exc:
|
||||
return _fail(request, exc)
|
||||
return _ok(request, "저장했습니다.")
|
||||
|
||||
|
||||
@router.post("/broadcasts/read-sales")
|
||||
def broadcast_read_sales(request: Request, image: UploadFile = File(...)) -> JSONResponse:
|
||||
"""결과 이미지(틱톡 LIVE 결과 화면)에서 매출 읽기 — 저장하지 않고 값만 돌려준다(창이 판매금액 칸에 채움)."""
|
||||
_user(request)
|
||||
try:
|
||||
amount, shown = ocr.read_sales(image.file.read(MAX_PHOTO_BYTES + 1))
|
||||
except ValueError as exc:
|
||||
return _fail(request, exc)
|
||||
if amount is None:
|
||||
msg = (_t(request, "이미지 매출이 줄인 값({value})이라 정확하지 않습니다. 판매금액을 직접 입력하세요.").format(value=shown) if shown
|
||||
else _t(request, "이미지에서 매출(RM)을 찾지 못했습니다. 판매금액을 직접 입력하세요."))
|
||||
return JSONResponse({"ok": True, "amount": None, "message": msg})
|
||||
return JSONResponse({"ok": True, "amount": str(amount), "message": _t(request, "이미지에서 매출 {value} 를 읽었습니다. 확인 후 저장하세요.").format(value=shown)})
|
||||
|
||||
|
||||
@router.post("/broadcasts/{broadcast_id}/delete")
|
||||
def broadcast_delete(request: Request, broadcast_id: int) -> JSONResponse:
|
||||
_user(request)
|
||||
try:
|
||||
_db(request).delete_broadcast(broadcast_id)
|
||||
except ValueError as exc:
|
||||
return _fail(request, exc)
|
||||
return _ok(request, "방송을 지웠습니다.")
|
||||
|
||||
|
||||
@router.get("/images/{image_id}")
|
||||
def image(request: Request, image_id: int, thumb: int = 0) -> Response:
|
||||
_user(request)
|
||||
row = _db(request).get_image(image_id)
|
||||
if not row:
|
||||
raise HTTPException(status_code=404, detail=_t(request, "이미지를 찾을 수 없습니다."))
|
||||
data, ctype = (store.thumbnail(row["data"]), "image/jpeg") if thumb else (bytes(row["data"]), row["content_type"])
|
||||
# 올린 뒤 내용이 바뀌지 않으므로 하루 캐시. 권한이 필요한 이미지라 private.
|
||||
return Response(data, media_type=ctype, headers={"Cache-Control": "private, max-age=86400", "X-Content-Type-Options": "nosniff"})
|
||||
|
||||
|
||||
@router.post("/images/{image_id}/delete")
|
||||
def image_delete(request: Request, image_id: int) -> JSONResponse:
|
||||
_user(request)
|
||||
try:
|
||||
_db(request).delete_image(image_id)
|
||||
except ValueError as exc:
|
||||
return _fail(request, exc)
|
||||
return _ok(request, "이미지를 지웠습니다.")
|
||||
|
||||
|
||||
# ────────────────────────────────────────────────────────────
|
||||
# 설정 — 호스트 정보(ERP 관리자만: 계좌 등 개인정보). `live_host` 칩 = 새 호스트 등록만.
|
||||
# ────────────────────────────────────────────────────────────
|
||||
@router.get("/settings", response_class=HTMLResponse)
|
||||
def settings(request: Request) -> Any:
|
||||
from app.main import render_template # noqa: WPS433
|
||||
from app.store import is_admin # noqa: WPS433
|
||||
|
||||
got = _page(request)
|
||||
if not isinstance(got, tuple):
|
||||
return got
|
||||
st, user = got
|
||||
if not (_can_add_host(user) or _can_edit_host(user)):
|
||||
return render_template(request, "denied.html", {"reason": _t(request, "호스트 정보는 ERP 관리자만 볼 수 있습니다."), "is_admin": False},
|
||||
status_code=403)
|
||||
# host_choices = 이름·상태뿐 — 계좌 등 개인정보는 칩이 있어도 관리자에게만
|
||||
return _render(request, "live/settings.html", user, {"hosts": st.list_hosts() if is_admin(user) else st.host_choices()})
|
||||
|
||||
|
||||
@router.post("/settings/hosts")
|
||||
def host_save(request: Request, id: str = Form(""), platform: str = Form(""), display_name: str = Form(""), full_name: str = Form(""), phone: str = Form(""), email: str = Form(""),
|
||||
address: str = Form(""), bank_name: str = Form(""), bank_account: str = Form(""),
|
||||
is_active: str = Form("")) -> JSONResponse:
|
||||
from app.store import is_admin # noqa: WPS433
|
||||
|
||||
# `live_host` 칩 = 새 등록, `live_host_edit` 칩 = 고치기(개인정보는 안 보이고, 비워 두면 그대로)
|
||||
user = _user(request)
|
||||
if not (_can_edit_host(user) if id.strip() else _can_add_host(user)):
|
||||
_admin(request)
|
||||
st = _db(request)
|
||||
try:
|
||||
values = store.clean_host({"platform": platform, "display_name": display_name, "full_name": full_name, "phone": phone, "email": email, "address": address, "bank_name": bank_name,
|
||||
"bank_account": bank_account})
|
||||
host_id = _opt_id(id)
|
||||
if host_id is not None and not is_admin(user): # 개인정보를 못 보므로 빈칸 = 지우기가 아니라 그대로
|
||||
old = st.get_host(host_id)
|
||||
if not old:
|
||||
raise i18n.LiveError("호스트를 찾을 수 없습니다.")
|
||||
values.update({k: values[k] or old[k] for k in store.PRIVATE_HOST_FIELDS})
|
||||
# 등록만 되는 칩 화면엔 사용 여부 칸이 없다 — 항상 사용(사용 안 함으로 만들면 본인이 되돌릴 수 없음)
|
||||
st.save_host(host_id, values, is_active=bool(is_active) or not _can_edit_host(user), by=user.get("email", ""))
|
||||
except ValueError as exc:
|
||||
return _fail(request, exc)
|
||||
return _ok(request, "호스트를 저장했습니다.")
|
||||
|
||||
|
||||
@router.post("/settings/hosts/{host_id}/active")
|
||||
def host_active(request: Request, host_id: int, is_active: str = Form("")) -> JSONResponse:
|
||||
"""목록의 사용 토글 — 고치기 권한(ERP 관리자·`live_host_edit` 칩)."""
|
||||
user = _user(request)
|
||||
if not _can_edit_host(user):
|
||||
_admin(request)
|
||||
try:
|
||||
_db(request).set_host_active(host_id, is_active == "1", by=user.get("email", ""))
|
||||
except ValueError as exc:
|
||||
return _fail(request, exc)
|
||||
return _ok(request, "사용으로 바꿨습니다." if is_active == "1" else "사용 안 함으로 바꿨습니다.")
|
||||
|
||||
|
||||
@router.post("/settings/hosts/{host_id}/delete")
|
||||
def host_delete(request: Request, host_id: int) -> JSONResponse:
|
||||
_admin(request)
|
||||
try:
|
||||
_db(request).delete_host(host_id)
|
||||
except ValueError as exc:
|
||||
return _fail(request, exc)
|
||||
return _ok(request, "호스트를 지웠습니다.")
|
||||
@@ -0,0 +1,269 @@
|
||||
"""라이브 커머스 순수 함수 — 입력 검사·표시 형식(DB 없이 시험 가능)."""
|
||||
|
||||
from __future__ import annotations
|
||||
|
||||
import io
|
||||
import re
|
||||
from datetime import date, datetime, time, timedelta
|
||||
from decimal import ROUND_HALF_UP, Decimal, InvalidOperation
|
||||
from typing import Any
|
||||
|
||||
from PIL import Image
|
||||
|
||||
from .i18n import LiveError, month_label
|
||||
|
||||
MAX_IMAGES = 10 # 방송 한 건에
|
||||
MAX_SALES = Decimal("999999999999.99")
|
||||
THUMB_SIZE = 160
|
||||
# shortcut: 요율이 코드 상수라 바꾸면 지난 방송 금액도 다시 계산된다 — 요율이 바뀌는 일이 생기면 방송마다 저장하도록 바꿀 것
|
||||
HOURLY_RATE = Decimal("25") # 호스트 시간당 요금(RM)
|
||||
COMMISSION_PERCENT = Decimal("10") # 판매금액의 %
|
||||
SLOT_HOURS = 1 # 달력 한 칸(2026-11-06, 2시간 → 1시간)
|
||||
FIRST_SLOT_HOUR = 6 # 달력에 늘 보이는 첫 칸(이보다 이른 칸은 방송이 있을 때만)
|
||||
HOST_COLORS = ("#66d4e6", "#6ee05a", "#d4f06a", "#e9cf7a", "#ec9d88", "#cdb9ea", "#f4a9c8", "#a9c4f5")
|
||||
_CENT = Decimal("0.01")
|
||||
_WEEKDAYS = ("MONDAY", "TUESDAY", "WEDNESDAY", "THURSDAY", "FRIDAY", "SATURDAY", "SUNDAY")
|
||||
_MONTHS = ("JAN", "FEB", "MAR", "APR", "MAY", "JUN", "JUL", "AUG", "SEP", "OCT", "NOV", "DEC")
|
||||
|
||||
HOST_LIMITS = {"display_name": 50, "full_name": 200, "phone": 40, "email": 254, "address": 500, "bank_name": 100, "bank_account": 40}
|
||||
HANDLE_LIMIT = 64
|
||||
PLATFORMS = ("tiktok", "shopee") # 호스트 쇼핑몰(005) — 로고 = /static/dispatch/courier/<값>.png(말레이시아 배송 모듈 이미지)
|
||||
PRIVATE_HOST_FIELDS = ("phone", "email", "address", "bank_name", "bank_account") # 화면에 보이는 사람 = ERP 관리자만
|
||||
_LABELS = {"display_name": "간단한 이름", "full_name": "이름 (IC 기준)", "phone": "전화번호", "email": "이메일", "address": "주소", "bank_name": "은행명",
|
||||
"bank_account": "계좌번호"}
|
||||
_EMAIL_RE = re.compile(r"^[A-Za-z0-9._%+\-']+@[A-Za-z0-9.\-]+\.[A-Za-z]{2,}$")
|
||||
_PHONE_RE = re.compile(r"^\+?[0-9()\-\s]+$")
|
||||
_ACCOUNT_RE = re.compile(r"^[0-9\-\s]+$")
|
||||
_HANDLE_RE = re.compile(r"^[A-Za-z0-9._]+$")
|
||||
_HANDLE_URL_RE = re.compile(r"^(?:https?://)?(?:www\.|m\.)?tiktok\.com/@?", re.I)
|
||||
WEEKDAYS_KO = "월화수목금토일"
|
||||
_WEEKDAYS_EN_SHORT = ("Mon", "Tue", "Wed", "Thu", "Fri", "Sat", "Sun")
|
||||
|
||||
|
||||
def clean_handle(raw: Any) -> str:
|
||||
"""'@name'·'https://www.tiktok.com/@name?lang=en' → 'name'."""
|
||||
s = _HANDLE_URL_RE.sub("", str(raw or "").strip())
|
||||
return re.split(r"[/?#]", s, maxsplit=1)[0].lstrip("@")
|
||||
|
||||
|
||||
def clean_host(values: dict[str, Any]) -> dict[str, str]:
|
||||
"""호스트 입력 검사 — 쇼핑몰·간단한 이름·이름만 필수, 나머지는 있으면 형식 확인. 틀리면 ValueError."""
|
||||
out = {k: str(values.get(k) or "").strip() for k in HOST_LIMITS}
|
||||
out["platform"] = str(values.get("platform") or "").strip().lower()
|
||||
if out["platform"] not in PLATFORMS:
|
||||
raise LiveError("쇼핑몰(틱톡·쇼피)을 고르세요.")
|
||||
if not out["display_name"]:
|
||||
raise LiveError("간단한 이름을 입력하세요.")
|
||||
if not out["full_name"]:
|
||||
raise LiveError("이름 (IC 기준)을 입력하세요.")
|
||||
for key, limit in HOST_LIMITS.items():
|
||||
if len(out[key]) > limit:
|
||||
raise LiveError("{label} 이(가) 너무 깁니다({limit}자까지).", label=_LABELS[key], limit=limit)
|
||||
if out["email"] and not _EMAIL_RE.match(out["email"]):
|
||||
raise LiveError("이메일 형식이 올바르지 않습니다.")
|
||||
if out["phone"] and not _PHONE_RE.match(out["phone"]):
|
||||
raise LiveError("전화번호는 숫자·+·-·괄호만 입력하세요.")
|
||||
if out["bank_account"] and not _ACCOUNT_RE.match(out["bank_account"]):
|
||||
raise LiveError("계좌번호는 숫자·-만 입력하세요.")
|
||||
return out
|
||||
|
||||
|
||||
def parse_money(raw: Any, label: str = "판매금액") -> Decimal | None:
|
||||
"""금액(RM) — 빈칸은 None(아직 입력 안 함), 0 이상, 소수 둘째 자리까지. 쉼표·RM 허용."""
|
||||
s = re.sub(r"(?i)^rm|[,\s]", "", str(raw if raw is not None else "").strip())
|
||||
if not s:
|
||||
return None
|
||||
try:
|
||||
n = Decimal(s)
|
||||
except InvalidOperation:
|
||||
raise LiveError("{label}은(는) 숫자로 입력하세요.", label=label) from None
|
||||
if not n.is_finite() or n < 0:
|
||||
raise LiveError("{label}은(는) 0 이상 숫자로 입력하세요.", label=label)
|
||||
if n > MAX_SALES:
|
||||
raise LiveError("{label}이(가) 너무 큽니다.", label=label)
|
||||
return n.quantize(Decimal("0.01"), rounding=ROUND_HALF_UP)
|
||||
|
||||
|
||||
def _parse_time(raw: Any, *, label: str, required: bool) -> time | None:
|
||||
s = str(raw or "").strip()
|
||||
if not s:
|
||||
if required:
|
||||
raise LiveError("{label}을 입력하세요.", label=label)
|
||||
return None
|
||||
try:
|
||||
return time.fromisoformat(s).replace(second=0, microsecond=0, tzinfo=None)
|
||||
except ValueError:
|
||||
raise LiveError("{label}이 올바르지 않습니다.", label=label) from None
|
||||
|
||||
|
||||
def clean_broadcast(values: dict[str, Any]) -> dict[str, Any]:
|
||||
"""방송 입력 검사 — 호스트·날짜·시작·끝 시간 필수(끝 시간으로 시간 요금 계산). 끝이 시작보다 이르면 자정을 넘긴 방송. 틀리면 ValueError."""
|
||||
host = str(values.get("host_id") or "").strip()
|
||||
if not host.isdigit():
|
||||
raise LiveError("호스트를 고르세요.")
|
||||
try:
|
||||
day = date.fromisoformat(str(values.get("broadcast_date") or "").strip())
|
||||
except ValueError:
|
||||
raise LiveError("방송 날짜를 입력하세요.") from None
|
||||
start = _parse_time(values.get("start_time"), label="시작 시간", required=True)
|
||||
end = _parse_time(values.get("end_time"), label="끝 시간", required=True)
|
||||
if start == end:
|
||||
raise LiveError("끝 시간이 시작 시간과 같습니다.")
|
||||
handle = clean_handle(values.get("tiktok_handle"))
|
||||
if len(handle) > HANDLE_LIMIT:
|
||||
raise LiveError("{label} 이(가) 너무 깁니다({limit}자까지).", label="틱톡 핸들", limit=HANDLE_LIMIT)
|
||||
if handle and not _HANDLE_RE.match(handle):
|
||||
raise LiveError("틱톡 핸들은 영문·숫자·밑줄·점만 입력하세요.")
|
||||
return {"host_id": int(host), "broadcast_date": day, "start_time": start, "end_time": end, "tiktok_handle": handle,
|
||||
"sales_amount": parse_money(values.get("sales_amount")), "ad_spend": parse_money(values.get("ad_spend"), "광고비"),
|
||||
"host_fee": parse_money(values.get("host_fee"), "호스트 비용")}
|
||||
|
||||
|
||||
def parse_move(day: Any, start: Any) -> tuple[date, time]:
|
||||
"""달력 칸 — 날짜·시작 시간. 틀리면 ValueError."""
|
||||
try:
|
||||
when = date.fromisoformat(str(day or "").strip())
|
||||
except ValueError:
|
||||
raise LiveError("날짜가 올바르지 않습니다.") from None
|
||||
return when, _parse_time(start, label="시간", required=True)
|
||||
|
||||
|
||||
def moved_end(old_start: time, old_end: time | None, new_start: time) -> time | None:
|
||||
"""칸을 옮겨도 방송 길이는 그대로."""
|
||||
if old_end is None:
|
||||
return None
|
||||
return (datetime.combine(date.min, new_start) + _duration(old_start, old_end)).time()
|
||||
|
||||
|
||||
def _duration(start: time, end: time) -> timedelta:
|
||||
minutes = (end.hour * 60 + end.minute - start.hour * 60 - start.minute) % 1440 # 끝이 더 이르면 자정을 넘긴 방송
|
||||
return timedelta(minutes=minutes)
|
||||
|
||||
|
||||
def session_pay(start: time, end: time | None, sales: Decimal | None) -> dict[str, Decimal]:
|
||||
"""참고 금액(저장 안 함) — Fee = 시간 × 시간당 요금, 커미션 = 판매금액 × %. 같은 계산이 방송 창에도(live.js recalc).
|
||||
호스트 비용은 2026-11-06 부터 수기 입력(live_broadcasts.host_fee)."""
|
||||
hours = Decimal(_duration(start, end).seconds) / 3600 if end else Decimal(0)
|
||||
base = (hours * HOURLY_RATE).quantize(_CENT, rounding=ROUND_HALF_UP)
|
||||
commission = ((sales or Decimal(0)) * COMMISSION_PERCENT / 100).quantize(_CENT, rounding=ROUND_HALF_UP)
|
||||
return {"hours": hours, "base": base, "commission": commission}
|
||||
|
||||
|
||||
def fmt_short(n: Decimal) -> str:
|
||||
"""카드·합계용 — 소수점 아래가 0 이면 뺀다(48, 4.80, 1,234.50)."""
|
||||
return f"{n:,.2f}".removesuffix(".00")
|
||||
|
||||
|
||||
def broadcast_view(b: dict[str, Any], lang: str = "ko") -> dict[str, Any]:
|
||||
"""방송 한 건 화면 값 — 표·달력 공통. b = db.list_broadcasts 한 줄."""
|
||||
pay = session_pay(b["start_time"], b["end_time"], b["sales_amount"])
|
||||
return {
|
||||
"date": fmt_date(b["broadcast_date"], lang), "times": fmt_times(b["start_time"], b["end_time"]),
|
||||
"host_name": b["host_name"], "tiktok_handle": b["tiktok_handle"], "venue": b["venue"],
|
||||
"platform": b["host_platform"], # 호스트 쇼핑몰(tiktok·shopee, '' = 아직 안 고름) — 아이콘 /static/live-icon-<값>.png
|
||||
"sales": fmt_money(b["sales_amount"]), "base": fmt_money(pay["base"]), "commission": fmt_money(pay["commission"]),
|
||||
"ad_spend": fmt_money(b["ad_spend"]), "host_fee": fmt_money(b["host_fee"]),
|
||||
"images": b["images"], "id": b["id"],
|
||||
"label": b["host_name"], "color": HOST_COLORS[b["host_id"] % len(HOST_COLORS)],
|
||||
"card_sales": fmt_short(b["sales_amount"] or Decimal(0)), "card_commission": fmt_short(pay["commission"]),
|
||||
"card_fee": fmt_short(b["host_fee"] or Decimal(0)),
|
||||
"edit": {"id": b["id"], "host_id": b["host_id"], "broadcast_date": b["broadcast_date"].isoformat(),
|
||||
"start_time": f"{b['start_time']:%H:%M}", "end_time": f"{b['end_time']:%H:%M}" if b["end_time"] else "",
|
||||
"tiktok_handle": b["tiktok_handle"],
|
||||
**{k: f"{b[k]:.2f}" if b[k] is not None else "" for k in ("sales_amount", "ad_spend", "host_fee")},
|
||||
"images": [{"id": i["id"], "filename": i["filename"]} for i in b["images"]]},
|
||||
}
|
||||
|
||||
|
||||
def _roas(sales: Decimal, ad_spend: Decimal) -> str:
|
||||
return f"{sales / ad_spend:.2f}" if ad_spend else "-"
|
||||
|
||||
|
||||
def _slot_of(hour: int) -> int:
|
||||
return hour // SLOT_HOURS * SLOT_HOURS
|
||||
|
||||
|
||||
def _covered_slots(b: dict[str, Any]) -> list[int]:
|
||||
"""방송이 걸친 칸(시작 칸 ~ 끝 시각 올림 직전 칸). 자정을 넘기거나 00:00 에 끝나면 그날 마지막 칸까지."""
|
||||
s, e = b["start_time"], b["end_time"]
|
||||
end = 24 if e <= s else e.hour + (1 if (e.minute or e.second) else 0)
|
||||
return sorted({_slot_of(h) for h in range(s.hour, max(end, s.hour + 1))})
|
||||
|
||||
|
||||
def build_calendar(span: dict[str, Any], broadcasts: list[dict[str, Any]], today: date, lang: str = "ko") -> dict[str, Any]:
|
||||
"""달력 보기 값 — 날짜(열)·SLOT_HOURS 칸(줄)·날짜별 합계(판매금액·광고비·호스트 비용 = 그날 방송 값 합, 2026-11-06)·달 합계.
|
||||
카드는 시작 칸에, 그 칸은 방송이 걸친 칸만큼 아래로 합친다
|
||||
(rowspan, 2026-11-06). 합친 칸 안에서 시작하는 다른 방송도 같은 칸에 들어가고 더 길면 칸이 더 늘어난다. 가려진 칸 = {"skip": True}."""
|
||||
views = [(b, broadcast_view(b, lang)) for b in broadcasts]
|
||||
used = {h for b, _ in views for h in _covered_slots(b)}
|
||||
days = []
|
||||
day = span["start"]
|
||||
while day < span["end"]:
|
||||
mine = [(b, v) for b, v in views if b["broadcast_date"] == day]
|
||||
sales, fee, spend = (sum((b[k] or Decimal(0) for b, _ in mine), Decimal(0)) for k in ("sales_amount", "host_fee", "ad_spend"))
|
||||
days.append({"iso": day.isoformat(), "date": day, "day": day.day, "weekday": _WEEKDAYS[day.weekday()] if lang == "en" else WEEKDAYS_KO[day.weekday()] + "요일",
|
||||
"label": f"{day.day} {_MONTHS[day.month - 1]}" if lang == "en" else f"{day.month}월 {day.day}일", "is_weekend": day.weekday() >= 5, "is_today": day == today,
|
||||
"count": len(mine), "sales": sales, "fee": fee, "spend": spend,
|
||||
"sales_text": fmt_short(sales), "fee_text": fmt_short(fee), "spend_text": fmt_short(spend), "roas": _roas(sales, spend)})
|
||||
day += timedelta(days=1)
|
||||
hours = sorted(set(range(FIRST_SLOT_HOUR, 24, SLOT_HOURS)) | used) # 방송이 걸친 칸은 늘 있음 → 합칠 칸이 이어져 있다
|
||||
columns = []
|
||||
for d in days:
|
||||
mine = [(b, v) for b, v in views if b["broadcast_date"] == d["date"]]
|
||||
col, i = [], 0
|
||||
while i < len(hours):
|
||||
group = [(b, v) for b, v in mine if _slot_of(b["start_time"].hour) == hours[i]]
|
||||
last, j = max((_covered_slots(b)[-1] for b, _ in group), default=hours[i]), i + 1
|
||||
while j < len(hours) and hours[j] <= last:
|
||||
more = [(b, v) for b, v in mine if _slot_of(b["start_time"].hour) == hours[j]]
|
||||
group += more
|
||||
last = max([last] + [_covered_slots(b)[-1] for b, _ in more])
|
||||
j += 1
|
||||
col.append({"iso": d["iso"], "is_weekend": d["is_weekend"], "cards": [v for _, v in group], "rowspan": j - i})
|
||||
col += [{"skip": True}] * (j - i - 1)
|
||||
i = j
|
||||
columns.append(col)
|
||||
slots = []
|
||||
for k, hour in enumerate(hours):
|
||||
end_hour = (hour + SLOT_HOURS) % 24
|
||||
slots.append({"start": f"{hour:02d}:00", "end": f"{end_hour:02d}:00", "label": f"{hour:02d}:00 - {end_hour:02d}:00",
|
||||
"cells": [col[k] for col in columns]})
|
||||
sales, fee, spend = (sum((d[k] for d in days), Decimal(0)) for k in ("sales", "fee", "spend"))
|
||||
return {"days": days, "slots": slots, "slot_note": f"{SLOT_HOURS} Hour{'s' if SLOT_HOURS > 1 else ''} (RM{fmt_short(HOURLY_RATE * SLOT_HOURS)} Base)" if lang == "en" else f"{SLOT_HOURS}시간 (기본 RM{fmt_short(HOURLY_RATE * SLOT_HOURS)})",
|
||||
"commission_percent": fmt_short(COMMISSION_PERCENT).split(".")[0],
|
||||
"totals": {"sales": fmt_short(sales), "fee": fmt_short(fee), "spend": fmt_short(spend), "roas": _roas(sales, spend)}}
|
||||
|
||||
|
||||
def month_range(raw: Any, today: date, lang: str = "ko") -> dict[str, Any]:
|
||||
"""'YYYY-MM'(틀리거나 없으면 이번 달) → 그 달 첫날·다음 달 첫날·앞뒤 달 주소 값·제목."""
|
||||
m = re.fullmatch(r"(\d{4})-(\d{2})", str(raw or "").strip())
|
||||
year, month = (int(m[1]), int(m[2])) if m and 2000 <= int(m[1]) <= 2100 and 1 <= int(m[2]) <= 12 else (today.year, today.month)
|
||||
start = date(year, month, 1)
|
||||
end = date(year + (month == 12), month % 12 + 1, 1)
|
||||
prev = date(year - (month == 1), (month - 2) % 12 + 1, 1)
|
||||
return {"start": start, "end": end, "prev": prev.strftime("%Y-%m"), "next": end.strftime("%Y-%m"),
|
||||
"label": month_label(year, month, lang)}
|
||||
|
||||
|
||||
def fmt_date(d: date, lang: str = "ko") -> str:
|
||||
return f"{d:%Y.%m.%d} ({_WEEKDAYS_EN_SHORT[d.weekday()]})" if lang == "en" else f"{d:%Y.%m.%d}({WEEKDAYS_KO[d.weekday()]})"
|
||||
|
||||
|
||||
def fmt_times(start: time, end: time | None) -> str:
|
||||
return f"{start:%H:%M}" + (f" ~ {end:%H:%M}" if end else "")
|
||||
|
||||
|
||||
def fmt_money(n: Decimal | None) -> str:
|
||||
return f"{n:,.2f}" if n is not None else ""
|
||||
|
||||
|
||||
def thumbnail(data: bytes) -> bytes:
|
||||
"""목록 작은 그림 — JPEG(투명은 흰 바탕). 저장할 때 이미 확인한 이미지만 들어온다."""
|
||||
with Image.open(io.BytesIO(data)) as source:
|
||||
source.thumbnail((THUMB_SIZE, THUMB_SIZE))
|
||||
rgba = source.convert("RGBA")
|
||||
canvas = Image.new("RGB", rgba.size, "white")
|
||||
canvas.paste(rgba, mask=rgba.getchannel("A"))
|
||||
out = io.BytesIO()
|
||||
canvas.save(out, format="JPEG", quality=80)
|
||||
return out.getvalue()
|
||||
@@ -0,0 +1,19 @@
|
||||
{#- 스케줄표·달력 공통 위 막대 — 달 이동, 표/달력 전환, 언어, 호스트 설정, 방송 추가. view = table | calendar -#}
|
||||
{% set here = '/live/calendar' if view == 'calendar' else '/live/' %}
|
||||
{% set can_add = hosts | selectattr('is_active') | list %}
|
||||
<div class="lv-bar">
|
||||
<a class="erp-btn erp-btn-outline" href="{{ here }}?month={{ span.prev }}" aria-label="{{ t('이전 달') }}">◀</a>
|
||||
<h2 class="lv-month">{{ span.label }}</h2>
|
||||
<a class="erp-btn erp-btn-outline" href="{{ here }}?month={{ span.next }}" aria-label="{{ t('다음 달') }}">▶</a>
|
||||
<nav class="lv-views" aria-label="{{ t('보기 방식') }}">
|
||||
<a class="erp-btn {{ 'erp-btn-primary' if view == 'table' else 'erp-btn-outline' }}" href="/live/?month={{ span.start.strftime('%Y-%m') }}"{% if view == 'table' %} aria-current="page"{% endif %}>{{ t('표') }}</a>
|
||||
<a class="erp-btn {{ 'erp-btn-primary' if view == 'calendar' else 'erp-btn-outline' }}" href="/live/calendar?month={{ span.start.strftime('%Y-%m') }}"{% if view == 'calendar' %} aria-current="page"{% endif %}>{{ t('달력') }}</a>
|
||||
</nav>
|
||||
<span class="lv-gap"></span>
|
||||
{% include "live/_lang.html" %}
|
||||
{% if can_add_host or can_edit_host %}<a class="erp-btn erp-btn-outline" href="/live/settings">{{ t('호스트 설정') }}</a>{% endif %}
|
||||
<button type="button" class="erp-btn erp-btn-primary" id="lv-add"{% if not can_add %} disabled{% endif %}>{{ t('+ 방송 추가') }}</button>
|
||||
</div>
|
||||
{% if not can_add %}
|
||||
<p class="lv-note">{{ t('방송을 추가하려면 먼저 호스트를 등록해야 합니다.') }} {% if can_add_host %}<a href="/live/settings">{{ t('호스트 설정') }}</a>{% else %}{{ t('ERP 관리자에게 등록을 요청하세요.') }}{% endif %}</p>
|
||||
{% endif %}
|
||||
@@ -0,0 +1,42 @@
|
||||
{#- 방송 추가·고치기 창 — 스케줄표·달력 공통(live.js). 호스트 고르기엔 이름만(계좌 등은 설정 화면). 틱톡 계정은 방송마다 — 쓴 적 있는 계정을 제안(새 계정도 입력 가능). -#}
|
||||
<dialog class="lv-dlg" id="lv-dlg" aria-labelledby="lv-dlg-title">
|
||||
<form id="lv-form" action="/live/broadcasts">
|
||||
<h3 id="lv-dlg-title" data-add="{{ t('방송 추가') }}" data-edit="{{ t('방송 고치기') }}"></h3>
|
||||
<input type="hidden" name="id" />
|
||||
<label class="lv-field">{{ t('호스트') }}
|
||||
<select class="erp-select" name="host_id" required>
|
||||
<option value="">{{ t('호스트를 고르세요') }}</option>
|
||||
{% for h in hosts %}<option value="{{ h.id }}"{% if not h.is_active %} data-inactive="1"{% endif %}>{{ h.display_name or h.full_name }}{% if not h.is_active %} — {{ t('사용 안 함') }}{% endif %}</option>{% endfor %}
|
||||
</select>
|
||||
</label>
|
||||
<label class="lv-field">{{ t('틱톡 핸들') }} <input class="erp-input" type="text" name="tiktok_handle" maxlength="200" placeholder="@handle" list="lv-accounts" autocomplete="off" /></label>
|
||||
<datalist id="lv-accounts">{% for a in accounts %}<option value="{{ a }}"></option>{% endfor %}</datalist>
|
||||
<div class="lv-row">
|
||||
<label class="lv-field">{{ t('방송 날짜') }} <input class="erp-input" type="date" name="broadcast_date" required /></label>
|
||||
<label class="lv-field">{{ t('시작 시간') }} <input class="erp-input" type="time" name="start_time" required /></label>
|
||||
<label class="lv-field">{{ t('끝 시간') }} <input class="erp-input" type="time" name="end_time" required /></label>
|
||||
</div>
|
||||
<p class="lv-sub">{{ t('시간은 말레이시아 시간으로 입력합니다.') }}</p>
|
||||
<label class="lv-field">{{ t('판매금액 (RM)') }} <input class="erp-input lv-num" type="text" name="sales_amount" inputmode="decimal" placeholder="{{ t('방송 후 입력') }}" /></label>
|
||||
{#- Fee·커미션 = 자동 계산(저장 안 함, live.js recalc — store.session_pay 와 같은 계산). 광고비·호스트 비용 = 입력(2026-11-06) -#}
|
||||
<div class="lv-row">
|
||||
<label class="lv-field">{{ t('시간 요금 (RM)') }} <input class="erp-input lv-num" type="text" data-fee="{{ hourly_rate }}" readonly />
|
||||
<small class="lv-sub">{{ t('시간 × RM {rate} — 자동').format(rate=hourly_rate) }}</small></label>
|
||||
<label class="lv-field">{{ t('커미션 (RM)') }} <input class="erp-input lv-num" type="text" data-commission="{{ commission_percent }}" readonly />
|
||||
<small class="lv-sub">{{ t('판매금액 × {percent}% — 자동').format(percent=commission_percent) }}</small></label>
|
||||
</div>
|
||||
<div class="lv-row">
|
||||
<label class="lv-field">{{ t('광고비 (RM)') }} <input class="erp-input lv-num" type="text" name="ad_spend" inputmode="decimal" /></label>
|
||||
<label class="lv-field">{{ t('호스트 비용 (RM)') }} <input class="erp-input lv-num" type="text" name="host_fee" inputmode="decimal" placeholder="{{ t('직접 입력') }}" /></label>
|
||||
</div>
|
||||
<label class="lv-field">{{ t('방송 결과 이미지 (JPG·PNG·WebP, 한 장 8MB, 방송당 {n}장까지)').format(n=max_images) }}
|
||||
<input type="file" name="images" accept="image/jpeg,image/png,image/webp" multiple />
|
||||
</label>
|
||||
<ul class="lv-saved" data-saved hidden></ul>
|
||||
<p class="lv-msg" data-msg role="alert" hidden></p>
|
||||
<div class="lv-foot">
|
||||
<button type="button" class="erp-btn erp-btn-outline" data-close>{{ t('취소') }}</button>
|
||||
<button type="submit" class="erp-btn erp-btn-primary">{{ t('저장') }}</button>
|
||||
</div>
|
||||
</form>
|
||||
</dialog>
|
||||
@@ -0,0 +1,5 @@
|
||||
{#- 한글·영문 전환 — 누르면 쿠키에 저장하고 다시 그린다(live.js). 언어 이름은 언어와 상관없이 그대로 보인다. -#}
|
||||
<div class="lv-lang" role="group" aria-label="{{ t('언어') }}">
|
||||
<button type="button" data-lang="ko"{% if lang != 'en' %} class="is-active" aria-pressed="true"{% else %} aria-pressed="false"{% endif %}>한글</button>
|
||||
<button type="button" data-lang="en"{% if lang == 'en' %} class="is-active" aria-pressed="true"{% else %} aria-pressed="false"{% endif %}>EN</button>
|
||||
</div>
|
||||
@@ -0,0 +1,2 @@
|
||||
<script>window.LV_T = {{ js_text | tojson }};</script>
|
||||
<script src="/static/live.js?v=20261106f" defer></script>
|
||||
@@ -0,0 +1,111 @@
|
||||
{% extends "erp_base.html" %}
|
||||
{#- 라이브 커머스 달력 보기(2026-11-04) — 줄 = 2시간 칸, 열 = 날짜, 맨 아래 = 날짜별 합계. 카드 머리 = 호스트 간단한 이름 + 그 방송의 틱톡 계정.
|
||||
카드 머리를 끌어 빈 칸으로 옮기거나 다른 카드 위에 놓아 맞바꾼다(live.js). 문구 = t()(i18n.py), 영문은 CSS 로 대문자(받은 화면과 같게). -#}
|
||||
{% block head_extra %}<link rel="stylesheet" href="/static/live.css?v=20261106h" />
|
||||
<link rel="stylesheet" href="/static/vendor/material-symbols/material-symbols.css" />
|
||||
<link rel="stylesheet" href="/static/erp-datepop.css?v=20261102a" />{% endblock %}
|
||||
|
||||
{% block content %}
|
||||
<div class="lv-split">
|
||||
<section class="lv" lang="{{ lang }}">
|
||||
{% include "live/_bar.html" %}
|
||||
|
||||
<div class="lv-kpis">
|
||||
<div class="lv-kpi"><span>{{ t('총 판매금액') }}</span><b>RM {{ cal.totals.sales }}</b></div>
|
||||
<div class="lv-kpi"><span>{{ t('광고비') }}</span><b>RM {{ cal.totals.spend }}</b></div>
|
||||
<div class="lv-kpi"><span>{{ t('호스트 비용') }}</span><b>RM {{ cal.totals.fee }}</b></div>
|
||||
<div class="lv-kpi"><span>ROAS</span><b>{{ cal.totals.roas }}</b></div>
|
||||
</div>
|
||||
|
||||
<p class="lv-tip">{{ t('팁: 카드 머리를 끌어 옮기거나 맞바꿀 수 있습니다. 오른쪽으로 스크롤하면 이달 {n}일을 모두 볼 수 있습니다.').format(n=cal.days | length) }}</p>
|
||||
|
||||
<div class="lv-cal-wrap" id="lv-cal-wrap">
|
||||
<table class="lv-cal">
|
||||
<thead>
|
||||
<tr>
|
||||
<th class="lv-cal-time" scope="col">{{ t('시간') }}</th>
|
||||
{% for d in cal.days %}
|
||||
<th scope="col" data-day="{{ d.iso }}"{% if d.is_today %} data-today="1"{% endif %} class="{% if d.is_weekend %}is-weekend{% endif %}{% if d.is_today %} is-today{% endif %}">
|
||||
<div class="lv-cal-weekday">{{ d.weekday }} <span class="lv-cal-count">{{ d.count }}</span></div>
|
||||
<div class="lv-cal-date">{{ d.label }}</div>
|
||||
</th>
|
||||
{% endfor %}
|
||||
</tr>
|
||||
</thead>
|
||||
<tbody>
|
||||
{% for slot in cal.slots %}
|
||||
<tr>
|
||||
<th class="lv-cal-time" scope="row">{{ slot.label }}<small>{{ cal.slot_note }}</small></th>
|
||||
{% for cell in slot.cells %}{% if not cell.skip %}{#- skip = 위 칸에 합쳐진 칸(방송이 걸친 시간만큼 rowspan) -#}
|
||||
<td class="lv-cell{% if cell.is_weekend %} is-weekend{% endif %}"{% if cell.rowspan > 1 %} rowspan="{{ cell.rowspan }}"{% endif %} data-drop data-day="{{ cell.iso }}" data-start="{{ slot.start }}">
|
||||
{% if cell.cards %}<div class="lv-cards">{% endif %}{#- 카드가 합친 칸 높이를 채움(live.css) -#}
|
||||
{% for c in cell.cards %}
|
||||
<article class="lv-card" data-card="{{ c.id }}">
|
||||
<header class="lv-card-head" draggable="true" style="background:{{ c.color }}" title="{{ c.host_name }} · {{ c.times }}{% if c.venue %} · {{ c.venue }}{% endif %}">
|
||||
{% if c.platform %}<img class="lv-card-pf" src="/static/live-icon-{{ c.platform }}.png" alt="{{ {'tiktok': 'TikTok', 'shopee': 'Shopee'}[c.platform] }}" />{% endif %}
|
||||
<span class="lv-card-name">{{ c.label }}{% if c.tiktok_handle %}<small>@{{ c.tiktok_handle }}</small>{% endif %}</span>
|
||||
<button type="button" class="lv-card-edit" data-edit='{{ c.edit | tojson }}' aria-label="{{ t('{name} {date} {times} 고치기').format(name=c.label, date=c.date, times=c.times) }}">✎</button>
|
||||
</header>
|
||||
<div class="lv-card-nums">
|
||||
<div><span>{{ t('판매금액') }}</span><b>{{ c.card_sales }}</b></div>
|
||||
<div><span>{{ t('커미션') }} ({{ cal.commission_percent }}%)</span><b>{{ c.card_commission }}</b></div>
|
||||
</div>
|
||||
<footer class="lv-card-foot"><span>{{ t('비용') }}: <b>RM{{ c.card_fee }}</b></span>{% if c.images %}<a href="/live/images/{{ c.images[0].id }}" target="_blank" rel="noopener" title="{{ t('방송 결과 이미지') }}" data-preview="{{ c.label }} · {{ c.date }} {{ c.times }}{% if c.images | length > 1 %} · 1/{{ c.images | length }}{% endif %}" data-images='{{ c.images | map(attribute="id") | list | tojson }}' data-names='{{ c.images | map(attribute="filename") | list | tojson }}'>{{ t('이미지 {n}').format(n=c.images | length) }}</a>{% endif %}</footer>
|
||||
</article>
|
||||
{% endfor %}
|
||||
{% if cell.cards %}</div>{% endif %}
|
||||
{% if not cell.cards and hosts | selectattr('is_active') | list %}
|
||||
<button type="button" class="lv-cell-add" data-new='{{ {"broadcast_date": cell.iso, "start_time": slot.start, "end_time": slot.end} | tojson }}' aria-label="{{ t('{date} {slot} 방송 추가').format(date=cell.iso, slot=slot.label) }}">+</button>
|
||||
{% endif %}
|
||||
</td>
|
||||
{% endif %}{% endfor %}
|
||||
</tr>
|
||||
{% endfor %}
|
||||
</tbody>
|
||||
<tfoot>
|
||||
<tr>
|
||||
<th class="lv-cal-time" scope="row">{{ t('합계 & ROAS') }}</th>
|
||||
{% for d in cal.days %}
|
||||
<td>
|
||||
<dl class="lv-total">
|
||||
<div><dt>{{ t('총 판매금액') }}:</dt><dd class="is-sales">RM {{ d.sales_text }}</dd></div>
|
||||
<div><dt>{{ t('광고비') }}:</dt><dd>RM {{ d.spend_text }}</dd></div>
|
||||
<div><dt>{{ t('호스트 비용') }}:</dt><dd>RM {{ d.fee_text }}</dd></div>
|
||||
<div><dt>ROAS:</dt><dd>{{ d.roas }}</dd></div>
|
||||
</dl>
|
||||
</td>
|
||||
{% endfor %}
|
||||
</tr>
|
||||
</tfoot>
|
||||
</table>
|
||||
</div>
|
||||
</section>
|
||||
{#- 화면 오른쪽 위에 붙는 달력 — 날짜를 누르면 그 날이 표 맨 왼쪽(live.js), 말레이시아 공휴일(holidays.py) -#}
|
||||
<div class="lv-side">
|
||||
<aside class="lv-side-cal" id="lv-side-cal"></aside>
|
||||
{#- 카드의 이미지 링크에 마우스를 올리면 달력 아래 빈 곳에 결과 이미지(live.js) -#}
|
||||
<figure class="lv-preview" id="lv-preview" hidden><img alt="" /><figcaption></figcaption></figure>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
{% include "live/_dialog.html" %}
|
||||
{#- 카드의 이미지 링크를 누르면 화면 가운데 원본 크기 이미지 — 회전(보기만)·다운로드(원본)·여러 장이면 앞뒤(live.js) -#}
|
||||
<dialog class="lv-viewer" id="lv-viewer" aria-labelledby="lv-viewer-cap">
|
||||
<div class="lv-viewer-bar">
|
||||
<span class="lv-viewer-cap" id="lv-viewer-cap"></span>
|
||||
<span class="lv-gap"></span>
|
||||
<button type="button" class="erp-btn erp-btn-outline erp-btn-sm" data-step="-1" aria-label="{{ t('이전 이미지') }}">◀</button>
|
||||
<span class="lv-viewer-count"></span>
|
||||
<button type="button" class="erp-btn erp-btn-outline erp-btn-sm" data-step="1" aria-label="{{ t('다음 이미지') }}">▶</button>
|
||||
<button type="button" class="erp-btn erp-btn-outline erp-btn-sm" data-rotate>↻ {{ t('회전') }}</button>
|
||||
<a class="erp-btn erp-btn-outline erp-btn-sm" data-download download>{{ t('다운로드') }}</a>
|
||||
<button type="button" class="erp-btn erp-btn-primary erp-btn-sm" data-viewer-close>{{ t('닫기') }}</button>
|
||||
</div>
|
||||
<div class="lv-viewer-body"><div class="lv-viewer-stage"><img alt="" /></div></div>
|
||||
</dialog>
|
||||
{% endblock %}
|
||||
|
||||
{% block scripts %}<script type="application/json" id="lv-my-holidays">{{ my_holidays | tojson }}</script>
|
||||
<script type="application/json" id="lv-live-days">{{ live_days | tojson }}</script>
|
||||
<script src="/static/erp-datepop.js?v=20261106a" defer></script>
|
||||
{% include "live/_scripts.html" %}{% endblock %}
|
||||
@@ -0,0 +1,44 @@
|
||||
{% extends "erp_base.html" %}
|
||||
{#- 라이브 커머스 스케줄표(2026-11-04) — 달마다 방송 목록. 추가·고치기 창은 달력과 공용(_dialog.html, live.js). 문구 = t()(i18n.py). -#}
|
||||
{% block head_extra %}<link rel="stylesheet" href="/static/live.css?v=20261106h" />{% endblock %}
|
||||
|
||||
{% block content %}
|
||||
<section class="lv" lang="{{ lang }}">
|
||||
{% include "live/_bar.html" %}
|
||||
|
||||
<div class="erp-card-block">
|
||||
<div class="erp-table-wrap">
|
||||
{% set platform_names = {"tiktok": "TikTok", "shopee": "Shopee"} %}
|
||||
<table class="erp-table lv-table lv-sched">
|
||||
<thead><tr><th>{{ t('쇼핑몰') }}</th><th>{{ t('날짜') }}</th><th>{{ t('시간') }}</th><th>{{ t('호스트') }}</th><th class="lv-r">{{ t('판매금액(RM)') }}</th><th class="lv-r">{{ t('시간 요금(RM)') }}</th><th class="lv-r">{{ t('커미션 10%(RM)') }}</th><th class="lv-r">{{ t('광고비(RM)') }}</th><th class="lv-r">{{ t('호스트 비용(RM)') }}</th><th>{{ t('방송 결과') }}</th><th></th></tr></thead>
|
||||
<tbody>
|
||||
{% for r in rows %}
|
||||
<tr>
|
||||
<td class="lv-c" data-label="{{ t('쇼핑몰') }}">{% if r.platform %}<img class="lv-pf" src="/static/live-icon-{{ r.platform }}.png" alt="{{ platform_names[r.platform] }}" title="{{ platform_names[r.platform] }}" />{% endif %}</td>
|
||||
<td class="lv-nowrap" data-label="{{ t('날짜') }}">{{ r.date }}</td>
|
||||
<td class="lv-nowrap" data-label="{{ t('시간') }}">{{ r.times }}</td>
|
||||
<td data-label="{{ t('호스트') }}">{{ r.host_name }}{% if r.tiktok_handle %}<div class="lv-sub">@{{ r.tiktok_handle }}</div>{% endif %}</td>
|
||||
<td class="lv-r lv-num" data-label="{{ t('판매금액(RM)') }}">{{ r.sales }}</td>
|
||||
<td class="lv-r lv-num" data-label="{{ t('시간 요금(RM)') }}">{{ r.base }}</td>
|
||||
<td class="lv-r lv-num" data-label="{{ t('커미션 10%(RM)') }}">{{ r.commission }}</td>
|
||||
<td class="lv-r lv-num" data-label="{{ t('광고비(RM)') }}">{{ r.ad_spend }}</td>
|
||||
<td class="lv-r lv-num" data-label="{{ t('호스트 비용(RM)') }}">{{ r.host_fee }}</td>
|
||||
<td data-label="{{ t('방송 결과') }}"><div class="lv-thumbs">{% for im in r.images %}<a href="/live/images/{{ im.id }}" target="_blank" rel="noopener" title="{{ im.filename }}"><img src="/live/images/{{ im.id }}?thumb=1" alt="{{ im.filename }}" loading="lazy" /></a>{% endfor %}</div></td>
|
||||
<td class="lv-actions">
|
||||
<button type="button" class="erp-btn erp-btn-outline erp-btn-sm" data-edit='{{ r.edit | tojson }}'>{{ t('고치기') }}</button>
|
||||
<button type="button" class="erp-btn erp-btn-outline erp-btn-sm" data-post="/live/broadcasts/{{ r.id }}/delete" data-confirm="{{ t('{date} {host} 방송을 지울까요? 결과 이미지도 함께 지워집니다.').format(date=r.date, host=r.host_name) }}">{{ t('지우기') }}</button>
|
||||
</td>
|
||||
</tr>
|
||||
{% else %}
|
||||
<tr><td colspan="11" class="erp-empty">{{ t('이 달에 등록한 방송이 없습니다.') }}</td></tr>
|
||||
{% endfor %}
|
||||
</tbody>
|
||||
</table>
|
||||
</div>
|
||||
</div>
|
||||
</section>
|
||||
|
||||
{% include "live/_dialog.html" %}
|
||||
{% endblock %}
|
||||
|
||||
{% block scripts %}{% include "live/_scripts.html" %}{% endblock %}
|
||||
@@ -0,0 +1,90 @@
|
||||
{% extends "erp_base.html" %}
|
||||
{#- 라이브 커머스 설정(2026-11-04) — 호스트 정보. 계좌 등 개인정보·지우기는 ERP 관리자만(router.settings), 칩 권한자는 이름·상태만 보임 — `live_host` = 새 등록, `live_host_edit` = 고치기(개인정보는 빈칸으로 열림, 비워 두면 그대로). 추가·고치기는 같은 창(live.js). 문구 = t()(i18n.py). -#}
|
||||
{% block head_extra %}<link rel="stylesheet" href="/static/live.css?v=20261106h" />{% endblock %}
|
||||
|
||||
{% block content %}
|
||||
{#- 쇼핑몰(005, store.PLATFORMS) — 로고는 말레이시아 배송 모듈 이미지 -#}
|
||||
{% set platform_names = {"tiktok": "TikTok", "shopee": "Shopee"} %}
|
||||
<section class="lv" lang="{{ lang }}">
|
||||
<div class="lv-bar">
|
||||
<a class="erp-btn erp-btn-outline" href="/live/">{{ t('◀ 스케줄표') }}</a>
|
||||
<h2 class="lv-month">{{ t('호스트 설정') }}</h2>
|
||||
<span class="lv-gap"></span>
|
||||
{% include "live/_lang.html" %}
|
||||
{% if can_add_host %}<button type="button" class="erp-btn erp-btn-primary" id="lv-add">{{ t('+ 호스트 등록') }}</button>{% endif %}
|
||||
</div>
|
||||
|
||||
<div class="erp-card-block">
|
||||
<div class="erp-table-wrap">
|
||||
<table class="erp-table lv-table">
|
||||
<thead><tr><th>{{ t('쇼핑몰') }}</th><th>{{ t('간단한 이름') }}</th><th>{{ t('이름 (IC 기준)') }}</th>{% if is_admin %}<th>{{ t('전화번호') }}</th><th>{{ t('이메일') }}</th><th>{{ t('주소') }}</th><th>{{ t('은행명') }}</th><th>{{ t('계좌번호') }}</th>{% endif %}<th>{{ t('상태') }}</th>{% if can_edit_host %}<th></th>{% endif %}</tr></thead>
|
||||
<tbody>
|
||||
{% for h in hosts %}
|
||||
<tr{% if not h.is_active %} class="lv-off"{% endif %}>
|
||||
<td data-label="{{ t('쇼핑몰') }}">{% if h.platform %}<img class="lv-logo" src="/static/dispatch/courier/{{ h.platform }}.png" alt="{{ platform_names[h.platform] }}" title="{{ platform_names[h.platform] }}" />{% endif %}</td>
|
||||
<td data-label="{{ t('간단한 이름') }}">{{ h.display_name }}</td>
|
||||
<td data-label="{{ t('이름 (IC 기준)') }}">{{ h.full_name }}</td>
|
||||
{% if is_admin %}
|
||||
<td class="lv-nowrap" data-label="{{ t('전화번호') }}">{{ h.phone }}</td>
|
||||
<td data-label="{{ t('이메일') }}">{{ h.email }}</td>
|
||||
<td data-label="{{ t('주소') }}">{{ h.address }}</td>
|
||||
<td data-label="{{ t('은행명') }}">{{ h.bank_name }}</td>
|
||||
<td class="lv-nowrap" data-label="{{ t('계좌번호') }}">{{ h.bank_account }}</td>
|
||||
{% endif %}
|
||||
{% if can_edit_host %}
|
||||
<td data-label="{{ t('상태') }}"><label class="erp-switch" title="{{ t('사용') }}"><input type="checkbox" data-active="/live/settings/hosts/{{ h.id }}/active" aria-label="{{ t('사용') }} — {{ h.display_name or h.full_name }}"{% if h.is_active %} checked{% endif %} /><span class="erp-switch-slider"></span></label></td>
|
||||
{% else %}
|
||||
<td class="lv-nowrap" data-label="{{ t('상태') }}">{{ t('사용') if h.is_active else t('사용 안 함') }}</td>
|
||||
{% endif %}
|
||||
{% if can_edit_host %}
|
||||
<td class="lv-actions">
|
||||
{% if is_admin %}
|
||||
<button type="button" class="erp-btn erp-btn-outline erp-btn-sm" data-edit='{{ {"id": h.id, "platform": h.platform, "display_name": h.display_name, "full_name": h.full_name, "phone": h.phone, "email": h.email, "address": h.address, "bank_name": h.bank_name, "bank_account": h.bank_account, "is_active": h.is_active} | tojson }}'>{{ t('고치기') }}</button>
|
||||
<button type="button" class="erp-btn erp-btn-outline erp-btn-sm" data-post="/live/settings/hosts/{{ h.id }}/delete" data-confirm="{{ t('{name} 호스트를 지울까요?').format(name=h.full_name) }}">{{ t('지우기') }}</button>
|
||||
{% else %}
|
||||
{#- 개인정보를 페이지에 싣지 않는다 -#}
|
||||
<button type="button" class="erp-btn erp-btn-outline erp-btn-sm" data-edit='{{ {"id": h.id, "platform": h.platform, "display_name": h.display_name, "full_name": h.full_name, "is_active": h.is_active} | tojson }}'>{{ t('고치기') }}</button>
|
||||
{% endif %}
|
||||
</td>
|
||||
{% endif %}
|
||||
</tr>
|
||||
{% else %}
|
||||
<tr><td colspan="{{ 10 if is_admin else 5 if can_edit_host else 4 }}" class="erp-empty">{{ t('등록한 호스트가 없습니다.') }}</td></tr>
|
||||
{% endfor %}
|
||||
</tbody>
|
||||
</table>
|
||||
</div>
|
||||
</div>
|
||||
</section>
|
||||
|
||||
<dialog class="lv-dlg" id="lv-dlg" aria-labelledby="lv-dlg-title">
|
||||
<form id="lv-form" action="/live/settings/hosts">
|
||||
<h3 id="lv-dlg-title" data-add="{{ t('호스트 등록') }}" data-edit="{{ t('호스트 고치기') }}"></h3>
|
||||
<input type="hidden" name="id" />
|
||||
<fieldset class="lv-platforms">
|
||||
<legend>{{ t('쇼핑몰') }}</legend>
|
||||
{% for p, name in platform_names.items() %}
|
||||
<label class="lv-platform"><input type="radio" name="platform" value="{{ p }}" required /><img class="lv-logo" src="/static/dispatch/courier/{{ p }}.png" alt="{{ name }}" /></label>
|
||||
{% endfor %}
|
||||
</fieldset>
|
||||
<label class="lv-field">{{ t('간단한 이름') }} <input class="erp-input" type="text" name="display_name" maxlength="50" required /></label>
|
||||
<label class="lv-field">{{ t('이름 (IC 기준)') }} <input class="erp-input" type="text" name="full_name" maxlength="200" required /></label>
|
||||
{% if not is_admin %}<p class="lv-sub" data-edit-only hidden>{{ t('개인정보는 보이지 않습니다. 비워 두면 그대로 유지됩니다.') }}</p>{% endif %}
|
||||
<label class="lv-field">{{ t('전화번호') }} <input class="erp-input" type="tel" name="phone" maxlength="40" /></label>
|
||||
<label class="lv-field">{{ t('이메일') }} <input class="erp-input" type="email" name="email" maxlength="254" /></label>
|
||||
<label class="lv-field">{{ t('주소') }} <textarea class="erp-input" name="address" rows="2" maxlength="500"></textarea></label>
|
||||
<div class="lv-row">
|
||||
<label class="lv-field">{{ t('은행명') }} <input class="erp-input" type="text" name="bank_name" maxlength="100" /></label>
|
||||
<label class="lv-field">{{ t('계좌번호') }} <input class="erp-input" type="text" name="bank_account" maxlength="40" inputmode="numeric" /></label>
|
||||
</div>
|
||||
{% if can_edit_host %}<label class="lv-check"><input type="checkbox" name="is_active" value="1" checked /> {{ t('사용 (끄면 새 방송에서 고를 수 없습니다)') }}</label>{% endif %}
|
||||
<p class="lv-msg" data-msg role="alert" hidden></p>
|
||||
<div class="lv-foot">
|
||||
<button type="button" class="erp-btn erp-btn-outline" data-close>{{ t('취소') }}</button>
|
||||
<button type="submit" class="erp-btn erp-btn-primary">{{ t('저장') }}</button>
|
||||
</div>
|
||||
</form>
|
||||
</dialog>
|
||||
{% endblock %}
|
||||
|
||||
{% block scripts %}{% include "live/_scripts.html" %}{% endblock %}
|
||||
@@ -0,0 +1,9 @@
|
||||
# [말레이시아재고] 말레이시아 창고 재고관리 — `app/modules/malaysia/`, `malaysia_stock_db`
|
||||
|
||||
> 이 모듈만 고칠 때 읽는 요약. 상세는 같은 폴더 `README.md`.
|
||||
> 정적 파일: `app/static/malaysia.js`, `malaysia_rack.js`, `malaysia_rack_view.js`. 템플릿: `templates/`.
|
||||
> 상품은 `itemcode_db` 읽기 전용(`itemcode.py`). 세트 BOM 이 "누락"이면 `itemcode_ro` 의 `set_components` SELECT 권한부터 점검.
|
||||
|
||||
- 낱개(MT/MX/MZ) 입출고·조정, 세트(MY) BOM, 일일 재고조사(세트 → 낱개 자동 분해), 현재고 현황.
|
||||
- 뚜껑(MD-)은 재고 집계 제외 — 단, 창고 랙에는 위치 확인용으로 배치 가능(`store.LID_ITEMS`).
|
||||
- 권한키 `malaysia`.
|
||||
@@ -90,11 +90,11 @@ def _render_config_needed(request: Request, user: dict[str, Any]) -> HTMLRespons
|
||||
def _guard(request: Request) -> tuple[Any, dict[str, Any]] | HTMLResponse | RedirectResponse:
|
||||
"""로그인+권한+store 점검. 페이지 핸들러 진입부에서 사용."""
|
||||
from app.main import get_current_user_record, render_template # noqa: WPS433
|
||||
from app.store import has_module, is_admin # noqa: WPS433
|
||||
from app.store import has_module, is_admin, login_redirect # noqa: WPS433
|
||||
|
||||
user = get_current_user_record(request)
|
||||
if user is None:
|
||||
return RedirectResponse(url="/login", status_code=303)
|
||||
return login_redirect(request)
|
||||
if not has_module(user, "malaysia"):
|
||||
return render_template(
|
||||
request,
|
||||
|
||||
@@ -0,0 +1,11 @@
|
||||
# [공지] 긴급 공지 모듈 — `app/modules/notice/`, `project_db`(마이그레이션 024 `urgent_notice*`)
|
||||
|
||||
> 이 모듈만 고칠 때 읽는 요약. 상세는 `docs/NOTICE_MODULE.md`.
|
||||
> 정적 파일: `app/static/erp-notice.js`, `erp-notice.css`, `erp-notice-admin.js`.
|
||||
|
||||
- 수퍼관리자만 작성(`/notice/`, 진입 = ERP 왼쪽 아래 · Project ⚙ 옵션).
|
||||
- 제목·내용(이미지 bytea)·띄울 시각·전체/고른 사람.
|
||||
- ERP 모든 화면(`erp_base.html`·`main.html`·`admin.html` 의 `static/erp-notice.js`) 가로·세로 정가운데에
|
||||
[확인] 누를 때까지 표시(Esc·바깥 클릭 무시), 확인 기록.
|
||||
- 연결 풀은 `ProjectStore.pool` 공유(→ Project 모듈 DB 변경 시 영향 확인), 새 환경변수 없음.
|
||||
- PC 알림 프로그램은 아직 미지원.
|
||||
@@ -2,7 +2,7 @@
|
||||
|
||||
{% block head_extra %}
|
||||
{# 프로젝트 화면 부품(설명 편집기·날짜 팝업·멤버 고르기)을 그대로 쓴다 — project.js 는 PJ_LIB_ONLY 로 부품만 #}
|
||||
<link rel="stylesheet" href="/static/project.css?v=20261013i" />
|
||||
<link rel="stylesheet" href="/static/project.css?v=20261111c" />
|
||||
<link rel="stylesheet" href="/static/vendor/material-symbols/material-symbols.css" />
|
||||
<script>window.PJ_LIB_ONLY = true; window.PJ_HOLIDAYS = {{ (pj_kr_holidays or {}) | tojson }};</script>
|
||||
{% endblock %}
|
||||
@@ -64,7 +64,7 @@
|
||||
</section>
|
||||
</div>
|
||||
<script>window.NTC_PEOPLE = {{ people | tojson }};</script>
|
||||
<script src="/static/project.js?v=20261015c" defer></script>
|
||||
<script src="/static/project.js?v=20261111b" defer></script>
|
||||
<script src="/static/erp-notice-admin.js?v=20261012b" defer></script>
|
||||
{% endif %}
|
||||
{% endblock %}
|
||||
|
||||
@@ -0,0 +1,40 @@
|
||||
# [안내문 발송] 안내문 발송 모듈 — `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, ` ` → 띄어쓰기, 빈 문단 = `<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`) — [발송 리스트](`/outreach/`) [DM 수동 보내기](`/outreach/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·대기·보냄·실패).
|
||||
@@ -0,0 +1,28 @@
|
||||
"""안내문 발송(outreach) 모듈 — 리스트(이메일·인스타그램 주소 + 이름)에 안내문을 보낸다(2026-10-27).
|
||||
|
||||
- 라우터: `router.py` (prefix=/outreach) · 저장소: `db.py` (outreach_db) · 순수 함수: `store.py`(주소 판별·{이름}·본문)
|
||||
- 메일 일괄 발송: `send.py` — 보내는 사람 본인 Gmail(입출고·휴가와 같은 Gmail 연결)
|
||||
- 인스타 DM: 반자동(문구 복사 + DM 창 열기 + [보냄] 기록) — 인스타 공식 API 는 처음 연락하는 사람에게 DM 을 보낼 수 없다.
|
||||
- 템플릿: `templates/outreach/`, 화면 스크립트·스타일 `static/outreach.{js,css}`
|
||||
|
||||
OUTREACH_DB_URL 미설정이면 build_outreach_store 가 None → 화면이 "설정 필요" 안내(앱은 죽지 않음). 권한키 `outreach`.
|
||||
"""
|
||||
|
||||
from typing import Any
|
||||
|
||||
from .router import router
|
||||
|
||||
__all__ = ["router", "build_outreach_store"]
|
||||
|
||||
|
||||
def build_outreach_store(*, dsn: str | None) -> Any:
|
||||
if not dsn:
|
||||
return None
|
||||
from .db import OutreachDBStore # 지연 import
|
||||
|
||||
st = OutreachDBStore(dsn)
|
||||
try:
|
||||
st.release_stuck() # 서버가 보내던 중 다시 시작됨 → 발송중 줄을 실패로(다시 보낼 수 있게)
|
||||
except Exception: # noqa: BLE001 — DB 가 잠시 없어도 앱은 뜬다
|
||||
pass
|
||||
return st
|
||||
@@ -0,0 +1,253 @@
|
||||
"""outreach_db PostgreSQL 저장소 — 안내문 발송(2026-10-27).
|
||||
|
||||
- 연결: 환경변수 `OUTREACH_DB_URL` (예: postgresql://outreach_app:<pwd>@postgres-db:5432/outreach_db)
|
||||
- 스키마는 앱이 만들지 않는다 — `scripts/sql/outreach_db_init.sql` 을 superuser 가 먼저 적용(앱 계정은 CRUD 만).
|
||||
- 연결 풀은 lazy open — 부팅 때 DB 가 잠시 끊겨도 컨테이너가 죽지 않게(다른 모듈과 같은 방식).
|
||||
"""
|
||||
|
||||
from __future__ import annotations
|
||||
|
||||
from datetime import datetime
|
||||
from typing import Any
|
||||
|
||||
from psycopg.errors import UndefinedTable
|
||||
from psycopg.rows import dict_row
|
||||
from psycopg.types.json import Jsonb
|
||||
from psycopg_pool import ConnectionPool
|
||||
|
||||
from app.timezone import KST
|
||||
|
||||
from . import store
|
||||
|
||||
MAX_IMAGES = 10
|
||||
|
||||
|
||||
def _iso(v: Any) -> str:
|
||||
return v.astimezone(KST).isoformat(timespec="seconds") if isinstance(v, datetime) else ""
|
||||
|
||||
|
||||
class OutreachDBStore:
|
||||
def __init__(self, dsn: str, *, min_size: int = 1, max_size: int = 4):
|
||||
self._pool = ConnectionPool(conninfo=dsn, min_size=min_size, max_size=max_size,
|
||||
kwargs={"row_factory": dict_row, "autocommit": True}, open=False)
|
||||
self._pool.open(wait=False)
|
||||
|
||||
def close(self) -> None:
|
||||
self._pool.close()
|
||||
|
||||
# ── 설정(제목·본문·보내는 이름·끝 문구·(광고)) ─────────────────
|
||||
def get_template(self) -> dict[str, Any]:
|
||||
with self._pool.connection() as conn:
|
||||
row = conn.execute("SELECT value, updated_by, updated_at FROM outreach_settings WHERE key = 'template'").fetchone()
|
||||
t = store.normalize_template(row["value"] if row and isinstance(row["value"], dict) else None)
|
||||
t["updated_by"] = row["updated_by"] if row else ""
|
||||
t["updated_at"] = _iso(row["updated_at"]) if row else ""
|
||||
t["is_default"] = row is None
|
||||
return t
|
||||
|
||||
def save_template(self, value: dict[str, Any], *, by: str) -> dict[str, Any]:
|
||||
t = store.normalize_template(value)
|
||||
if not t["subject"]:
|
||||
raise ValueError("메일 제목을 쓰세요.")
|
||||
if not store.html_to_text(t["body"]).strip():
|
||||
raise ValueError("본문을 쓰세요.")
|
||||
if len(t["body"]) > store.BODY_MAX:
|
||||
raise ValueError("본문이 너무 깁니다(서식 포함) — 줄여 주세요.")
|
||||
with self._pool.connection() as conn:
|
||||
conn.execute(
|
||||
"INSERT INTO outreach_settings (key, value, updated_by, updated_at) VALUES ('template', %s, %s, now()) "
|
||||
"ON CONFLICT (key) DO UPDATE SET value = EXCLUDED.value, updated_by = EXCLUDED.updated_by, updated_at = now()",
|
||||
(Jsonb({k: t[k] for k in store.DEFAULT_TEMPLATE}), (by or "").lower()),
|
||||
)
|
||||
return self.get_template()
|
||||
|
||||
# ── 메일 본문 아래 사진 ────────────────────────────────
|
||||
def list_images(self, *, with_data: bool = False) -> list[dict[str, Any]]:
|
||||
cols = "id, filename, width, height, sort_order" + (", data" if with_data else "")
|
||||
with self._pool.connection() as conn:
|
||||
rows = conn.execute(f"SELECT {cols} FROM outreach_images ORDER BY sort_order, id").fetchall()
|
||||
return [dict(r) for r in rows]
|
||||
|
||||
def get_image(self, image_id: int) -> dict[str, Any] | None:
|
||||
with self._pool.connection() as conn:
|
||||
return conn.execute("SELECT * FROM outreach_images WHERE id = %s", (image_id,)).fetchone()
|
||||
|
||||
def add_image(self, *, filename: str, data: bytes, width: int, height: int, by: str) -> int:
|
||||
with self._pool.connection() as conn:
|
||||
with conn.transaction():
|
||||
n = conn.execute("SELECT COUNT(*) AS n, COALESCE(MAX(sort_order), -1) + 1 AS nxt FROM outreach_images").fetchone()
|
||||
if n["n"] >= MAX_IMAGES:
|
||||
raise ValueError(f"사진은 {MAX_IMAGES}장까지 넣을 수 있습니다.")
|
||||
return int(conn.execute(
|
||||
"INSERT INTO outreach_images (filename, data, width, height, sort_order, created_by) "
|
||||
"VALUES (%s, %s, %s, %s, %s, %s) RETURNING id",
|
||||
(filename[:200], data, width, height, int(n["nxt"]), (by or "").lower()),
|
||||
).fetchone()["id"])
|
||||
|
||||
def delete_image(self, image_id: int) -> None:
|
||||
with self._pool.connection() as conn:
|
||||
conn.execute("DELETE FROM outreach_images WHERE id = %s", (image_id,))
|
||||
|
||||
def move_image(self, image_id: int, direction: int) -> None:
|
||||
"""사진 순서 한 칸 앞/뒤(-1/1)."""
|
||||
ids = [r["id"] for r in self.list_images()]
|
||||
if image_id not in ids:
|
||||
return
|
||||
i = ids.index(image_id)
|
||||
j = i + (-1 if direction < 0 else 1)
|
||||
if not 0 <= j < len(ids):
|
||||
return
|
||||
ids[i], ids[j] = ids[j], ids[i]
|
||||
with self._pool.connection() as conn:
|
||||
conn.execute("UPDATE outreach_images m SET sort_order = v.ord FROM unnest(%s::int[]) WITH ORDINALITY AS v(id, ord) "
|
||||
"WHERE m.id = v.id", (ids,))
|
||||
|
||||
# ── 리스트 ───────────────────────────────────────────
|
||||
@staticmethod
|
||||
def _row(r: dict[str, Any]) -> dict[str, Any]:
|
||||
d = dict(r)
|
||||
d["id"] = int(d["id"])
|
||||
for k in ("sent_at", "created_at", "updated_at"):
|
||||
d[k] = _iso(d.get(k))
|
||||
return d
|
||||
|
||||
def list_recipients(self) -> list[dict[str, Any]]:
|
||||
with self._pool.connection() as conn:
|
||||
rows = conn.execute("SELECT * FROM outreach_recipients ORDER BY id").fetchall()
|
||||
return [self._row(r) for r in rows]
|
||||
|
||||
def get_recipient(self, rid: int) -> dict[str, Any] | None:
|
||||
with self._pool.connection() as conn:
|
||||
r = conn.execute("SELECT * FROM outreach_recipients WHERE id = %s", (rid,)).fetchone()
|
||||
return self._row(r) if r else None
|
||||
|
||||
def add_recipients(self, rows: list[dict[str, Any]], *, by: str) -> dict[str, int]:
|
||||
"""[{address, name}] 추가 — 주소를 보고 메일/DM 을 정한다. 이미 있는 주소는 이름만 비어 있으면 채우고 건너뜀.
|
||||
반환 {added, existed, invalid}. 틀린 주소는 저장하지 않고 센다(화면이 미리 보여 줌)."""
|
||||
out = {"added": 0, "existed": 0, "invalid": 0}
|
||||
who = (by or "").lower()
|
||||
with self._pool.connection() as conn:
|
||||
with conn.transaction():
|
||||
for r in rows:
|
||||
d = store.detect(r.get("address"))
|
||||
if not d["kind"]:
|
||||
out["invalid"] += 1
|
||||
continue
|
||||
name = str(r.get("name") or "").strip()[:100]
|
||||
got = conn.execute(
|
||||
"INSERT INTO outreach_recipients (kind, handle, address, name, created_by) VALUES (%s, %s, %s, %s, %s) "
|
||||
"ON CONFLICT (kind, handle) DO UPDATE SET name = CASE WHEN outreach_recipients.name = '' "
|
||||
"THEN EXCLUDED.name ELSE outreach_recipients.name END RETURNING (xmax = 0) AS inserted",
|
||||
(d["kind"], d["handle"], str(r.get("address") or "").strip()[:320], name, who),
|
||||
).fetchone()
|
||||
out["added" if got["inserted"] else "existed"] += 1
|
||||
return out
|
||||
|
||||
def update_recipient(self, rid: int, *, name: Any = None, memo: Any = None, status: Any = None) -> dict[str, Any]:
|
||||
sets, params = [], []
|
||||
if name is not None:
|
||||
sets.append("name = %s")
|
||||
params.append(str(name).strip()[:100])
|
||||
if memo is not None:
|
||||
sets.append("memo = %s")
|
||||
params.append(str(memo).strip()[:500])
|
||||
if status is not None:
|
||||
if status != "대기":
|
||||
raise ValueError("상태는 '대기'(다시 보내기)로만 바꿀 수 있습니다.")
|
||||
sets += ["status = '대기'", "last_error = ''"]
|
||||
if not sets:
|
||||
raise ValueError("바꿀 내용이 없습니다.")
|
||||
with self._pool.connection() as conn:
|
||||
r = conn.execute(f"UPDATE outreach_recipients SET {', '.join(sets)} WHERE id = %s RETURNING *", (*params, rid)).fetchone()
|
||||
if not r:
|
||||
raise KeyError(rid)
|
||||
return self._row(r)
|
||||
|
||||
def delete_recipients(self, ids: list[int]) -> int:
|
||||
with self._pool.connection() as conn:
|
||||
cur = conn.execute("DELETE FROM outreach_recipients WHERE id = ANY(%s) AND status <> '발송중'", ([int(i) for i in ids],))
|
||||
return cur.rowcount
|
||||
|
||||
# ── 보내기 ───────────────────────────────────────────
|
||||
def claim_for_send(self, ids: list[int]) -> list[dict[str, Any]]:
|
||||
"""메일 일괄 발송 — 고른 줄 중 메일·대기/실패만 '발송중'으로 바꾸며 가져온다(한 UPDATE — 두 번 눌러도·두 사람이 눌러도 한 번만)."""
|
||||
with self._pool.connection() as conn:
|
||||
rows = conn.execute(
|
||||
"UPDATE outreach_recipients SET status = '발송중', last_error = '' "
|
||||
"WHERE id = ANY(%s) AND kind = 'email' AND status IN ('대기', '실패') RETURNING *",
|
||||
([int(i) for i in ids],),
|
||||
).fetchall()
|
||||
return sorted((self._row(r) for r in rows), key=lambda r: r["id"])
|
||||
|
||||
def finish_send(self, rid: int, *, ok: bool, via: str, by: str, subject: str, error: str = "") -> None:
|
||||
with self._pool.connection() as conn:
|
||||
with conn.transaction():
|
||||
r = conn.execute(
|
||||
"UPDATE outreach_recipients SET status = %s, sent_at = CASE WHEN %s THEN now() ELSE sent_at END, "
|
||||
"sent_by = CASE WHEN %s THEN %s ELSE sent_by END, sent_via = CASE WHEN %s THEN %s ELSE sent_via END, "
|
||||
"last_error = %s WHERE id = %s RETURNING kind, address, name",
|
||||
("보냄" if ok else "실패", ok, ok, (by or "").lower(), ok, via, (error or "")[:500], rid),
|
||||
).fetchone()
|
||||
if r:
|
||||
conn.execute(
|
||||
"INSERT INTO outreach_logs (recipient_id, kind, address, name, subject, via, sent_by, ok, error) "
|
||||
"VALUES (%s, %s, %s, %s, %s, %s, %s, %s, %s)",
|
||||
(rid, r["kind"], r["address"], r["name"], (subject or "")[:300], via, (by or "").lower(), ok, (error or "")[:500]),
|
||||
)
|
||||
|
||||
def mark_dm_sent(self, rid: int, *, by: str, subject: str) -> dict[str, Any]:
|
||||
"""DM [보냄] — 인스타 줄만(사람이 DM 창에서 보낸 뒤 누름)."""
|
||||
r = self.get_recipient(rid)
|
||||
if r is None:
|
||||
raise KeyError(rid)
|
||||
if r["kind"] != "instagram":
|
||||
raise ValueError("메일 줄은 [일괄 발송]으로 보냅니다.")
|
||||
self.finish_send(rid, ok=True, via="dm", by=by, subject=subject)
|
||||
return self.get_recipient(rid) # type: ignore[return-value]
|
||||
|
||||
def release_stuck(self) -> int:
|
||||
"""서버가 보내던 중 멈춘 줄(발송중)을 실패로 — 서버 시작 때(앱은 프로세스 하나, 보내기는 메모리 작업)."""
|
||||
with self._pool.connection() as conn:
|
||||
cur = conn.execute("UPDATE outreach_recipients SET status = '실패', last_error = '보내던 중 서버가 다시 시작됨 — 다시 보내세요' "
|
||||
"WHERE status = '발송중'")
|
||||
return cur.rowcount
|
||||
|
||||
# ── DM 수동 보내기 탭의 저장한 본문(마이그레이션 002) ──────────
|
||||
def list_dm_bodies(self) -> list[dict[str, Any]] | None:
|
||||
"""새로 고친 것부터. 표가 없으면(002 미적용) None — 화면이 저장 목록만 숨긴다."""
|
||||
try:
|
||||
with self._pool.connection() as conn:
|
||||
rows = conn.execute("SELECT id, title, body, created_by, updated_by, updated_at FROM outreach_dm_bodies "
|
||||
"ORDER BY updated_at DESC, id DESC").fetchall()
|
||||
except UndefinedTable:
|
||||
return None
|
||||
return [{**dict(r), "id": int(r["id"]), "updated_at": _iso(r["updated_at"])} for r in rows]
|
||||
|
||||
def save_dm_body(self, body: Any, *, by: str, body_id: int | None = None) -> int:
|
||||
"""새로 저장(body_id 없음) 또는 그 본문 고치기. 저장한 id. 없는 id = KeyError."""
|
||||
title, text = store.dm_saved_body(body)
|
||||
by = (by or "").lower()
|
||||
with self._pool.connection() as conn:
|
||||
if body_id is None:
|
||||
return int(conn.execute(
|
||||
"INSERT INTO outreach_dm_bodies (title, body, created_by, updated_by) VALUES (%s, %s, %s, %s) RETURNING id",
|
||||
(title, text, by, by)).fetchone()["id"])
|
||||
row = conn.execute("UPDATE outreach_dm_bodies SET title = %s, body = %s, updated_by = %s, updated_at = now() "
|
||||
"WHERE id = %s RETURNING id", (title, text, by, body_id)).fetchone()
|
||||
if row is None:
|
||||
raise KeyError(body_id)
|
||||
return int(row["id"])
|
||||
|
||||
def delete_dm_body(self, body_id: int) -> None:
|
||||
with self._pool.connection() as conn:
|
||||
conn.execute("DELETE FROM outreach_dm_bodies WHERE id = %s", (body_id,))
|
||||
|
||||
def list_logs(self, *, limit: int = 200) -> list[dict[str, Any]]:
|
||||
with self._pool.connection() as conn:
|
||||
rows = conn.execute("SELECT * FROM outreach_logs ORDER BY sent_at DESC, id DESC LIMIT %s", (limit,)).fetchall()
|
||||
out = []
|
||||
for r in rows:
|
||||
d = dict(r)
|
||||
d["sent_at"] = _iso(d["sent_at"])
|
||||
out.append(d)
|
||||
return out
|
||||
@@ -0,0 +1,450 @@
|
||||
"""안내문 발송(outreach) 라우터 — 리스트(이메일·인스타 주소 + 이름)에 안내문 메일 일괄 발송·인스타 DM 반자동(2026-10-27).
|
||||
|
||||
GET /outreach/ 리스트 + 보내기 화면
|
||||
GET /outreach/settings 설정 — 메일 제목·본문({이름})·보내는 이름·끝 문구·(광고)·본문 아래 사진
|
||||
POST /outreach/settings 설정 저장 · POST /settings/images(올리기) · /settings/images/{id}/delete · /move
|
||||
GET /outreach/images/{id} 사진(설정·미리보기)
|
||||
GET /outreach/api/recipients 리스트(JSON — 발송 중 진행 보기)
|
||||
POST /outreach/api/recipients/parse 붙여 넣은 글 해석 미리보기(메일/DM/오류)
|
||||
POST /outreach/api/recipients 리스트에 추가 {text}
|
||||
PUT /outreach/api/recipients/{id} 이름·메모 고치기, 다시 대기로 {status: "대기"}
|
||||
POST /outreach/api/recipients/delete 지우기 {ids}
|
||||
GET /outreach/api/recipients/{id}/preview 그 사람에게 갈 제목·HTML·DM 글
|
||||
POST /outreach/api/send 고른 메일 줄 일괄 발송 {ids} — 본인 Gmail, 백그라운드
|
||||
POST /outreach/api/recipients/{id}/dm-sent DM 보냄 표시(사람이 DM 창에서 보낸 뒤)
|
||||
GET /outreach/gmail/connect · POST /gmail/disconnect 내 Gmail 연결(입출고·휴가와 같은 연결, 같은 구글 콜백)
|
||||
권한: 모듈 권한키 `outreach`(보기·리스트·보내기·설정 모두). DB: OUTREACH_DB_URL(outreach_db) — 없으면 "설정 필요" 안내.
|
||||
"""
|
||||
|
||||
from __future__ import annotations
|
||||
|
||||
from io import BytesIO
|
||||
from typing import Any
|
||||
from urllib.parse import urlencode
|
||||
|
||||
from fastapi import APIRouter, BackgroundTasks, Body, File, Form, HTTPException, Request, UploadFile
|
||||
from fastapi.responses import HTMLResponse, JSONResponse, RedirectResponse, Response
|
||||
|
||||
from . import store
|
||||
|
||||
router = APIRouter(prefix="/outreach", tags=["outreach"])
|
||||
|
||||
IMAGE_MAX_W = 700
|
||||
IMAGE_MAX_BYTES = 15 * 1024 * 1024
|
||||
MAX_ADD = 2000
|
||||
|
||||
|
||||
def _store(request: Request) -> Any:
|
||||
return getattr(request.app.state, "outreach_store", None)
|
||||
|
||||
|
||||
def _inout(request: Request) -> Any:
|
||||
return getattr(request.app.state, "inout_store", None)
|
||||
|
||||
|
||||
def _user(request: Request) -> dict[str, Any]:
|
||||
from app.main import get_current_user_record # noqa: WPS433
|
||||
from app.store import has_module # noqa: WPS433
|
||||
|
||||
user = get_current_user_record(request)
|
||||
if user is None:
|
||||
raise HTTPException(status_code=401, detail="로그인이 필요합니다.")
|
||||
if not has_module(user, "outreach"):
|
||||
raise HTTPException(status_code=403, detail="안내문 발송 모듈 권한이 없습니다.")
|
||||
return user
|
||||
|
||||
|
||||
def _db(request: Request) -> Any:
|
||||
st = _store(request)
|
||||
if st is None:
|
||||
raise HTTPException(status_code=503, detail="안내문 발송 DB(OUTREACH_DB_URL)가 설정되지 않았습니다.")
|
||||
return st
|
||||
|
||||
|
||||
def _page(request: Request) -> Any:
|
||||
"""화면 공통 — (st, user) 또는 응답(로그인·권한·설정 필요)."""
|
||||
from app.main import build_erp_nav, get_current_user_record, render_template # noqa: WPS433
|
||||
from app.store import has_module, is_admin, login_redirect # noqa: WPS433
|
||||
|
||||
user = get_current_user_record(request)
|
||||
if user is None:
|
||||
return login_redirect(request)
|
||||
if not has_module(user, "outreach"):
|
||||
return render_template(request, "denied.html", {"reason": "안내문 발송 모듈 접근 권한이 없습니다.",
|
||||
"is_admin": is_admin(user)}, status_code=403)
|
||||
st = _store(request)
|
||||
if st is None:
|
||||
return render_template(request, "denied.html", {
|
||||
"reason": "안내문 발송 모듈이 아직 설정되지 않았습니다. scripts/sql/outreach_db_init.sql 로 outreach_db 를 만들고 "
|
||||
".env 에 OUTREACH_DB_URL 을 넣은 뒤 컨테이너를 다시 시작하세요.",
|
||||
"user": user, "is_admin": is_admin(user), "nav_items": build_erp_nav(user, active="outreach")}, status_code=503)
|
||||
return st, user
|
||||
|
||||
|
||||
def _render(request: Request, name: str, user: dict[str, Any], ctx: dict[str, Any]) -> HTMLResponse:
|
||||
from app.main import build_erp_nav, render_template # noqa: WPS433
|
||||
from app.store import is_admin # noqa: WPS433
|
||||
|
||||
return render_template(request, name, {"user": user, "is_admin": is_admin(user),
|
||||
"nav_items": build_erp_nav(user, active="outreach"), **ctx})
|
||||
|
||||
|
||||
def _gmail_state(request: Request, user: dict[str, Any]) -> dict[str, Any]:
|
||||
from app.modules.inout import gmail # noqa: WPS433
|
||||
|
||||
inout = _inout(request)
|
||||
connected = False
|
||||
if inout is not None:
|
||||
try:
|
||||
connected = inout.gmail_token(user["email"]) is not None
|
||||
except Exception: # noqa: BLE001
|
||||
connected = False
|
||||
return {"available": inout is not None and gmail.configured(), "connected": connected, "email": user["email"]}
|
||||
|
||||
|
||||
def _view(r: dict[str, Any], template: dict[str, Any]) -> dict[str, Any]:
|
||||
"""리스트 한 줄 화면용 — 구분 라벨, DM 이면 그 사람 이름을 넣은 DM 글·DM 창 주소(누르는 순간 복사·열기라 미리 담아 둔다)."""
|
||||
out = {k: r.get(k) for k in ("id", "kind", "handle", "address", "name", "memo", "status", "sent_at", "sent_by", "sent_via",
|
||||
"last_error")}
|
||||
out["kind_label"] = store.KIND_LABELS.get(r["kind"], "")
|
||||
out["needs_name"] = store.needs_name(template, r["kind"]) and not (r.get("name") or "").strip()
|
||||
if r["kind"] == "instagram":
|
||||
out["dm_link"] = store.dm_link(r["handle"])
|
||||
out["profile_link"] = store.profile_link(r["handle"])
|
||||
out["dm_text"] = store.dm_text(template, r.get("name") or "")
|
||||
return out
|
||||
|
||||
|
||||
# ════════════════════════════════════════════════════════════
|
||||
# 화면
|
||||
# ════════════════════════════════════════════════════════════
|
||||
@router.get("/health")
|
||||
def health(request: Request) -> JSONResponse:
|
||||
return JSONResponse({"status": "ok" if _store(request) is not None else "not_configured"})
|
||||
|
||||
|
||||
@router.get("/", response_class=HTMLResponse)
|
||||
def index(request: Request) -> Any:
|
||||
got = _page(request)
|
||||
if not isinstance(got, tuple):
|
||||
return got
|
||||
st, user = got
|
||||
template = st.get_template()
|
||||
rows = [_view(r, template) for r in st.list_recipients()]
|
||||
return _render(request, "outreach/index.html", user, {
|
||||
"page_title": "안내문 발송", "page_subtitle": "메일 일괄 발송 · 인스타 DM",
|
||||
"template": template, "body_text": store.html_to_text(template["body"]), "needs_name": store.needs_name(template),
|
||||
"images": st.list_images(), "rows": rows, "logs": st.list_logs(limit=50), "active_tab": "list",
|
||||
"gmail": _gmail_state(request, user), "msg": request.query_params.get("msg", ""),
|
||||
})
|
||||
|
||||
|
||||
@router.get("/dm", response_class=HTMLResponse)
|
||||
def dm_page(request: Request) -> Any:
|
||||
"""DM 수동 보내기 탭(2026-10-30) — 이름 목록 | 고칠 수 있는 본문(화면이 {이름} 을 바꿔 복사) | 저장한 본문 목록."""
|
||||
got = _page(request)
|
||||
if not isinstance(got, tuple):
|
||||
return got
|
||||
st, user = got
|
||||
return _render(request, "outreach/dm.html", user, {
|
||||
"page_title": "안내문 발송", "page_subtitle": "DM 수동 보내기", "active_tab": "dm",
|
||||
# {이름} 을 그대로 둔 DM 문구(리스트 줄 [DM 보내기]와 같은 글) + 저장한 본문 목록(002 미적용 = None)
|
||||
"dm_template": store.dm_text(st.get_template(), store.NAME_TAG),
|
||||
"dm_bodies": st.list_dm_bodies(), "dm_max": store.DM_MAX,
|
||||
})
|
||||
|
||||
|
||||
_DM_BODIES_MIGRATION_MSG = "본문 저장 표가 없습니다 — outreach_db 마이그레이션 002(scripts/sql/outreach_db_002_dm_bodies.sql)를 적용하세요."
|
||||
|
||||
|
||||
def _dm_body_save(request: Request, payload: dict[str, Any], body_id: int | None) -> JSONResponse:
|
||||
from psycopg.errors import UndefinedTable # noqa: WPS433
|
||||
|
||||
user = _user(request)
|
||||
st = _db(request)
|
||||
try:
|
||||
saved = st.save_dm_body(payload.get("body"), by=user.get("email", ""), body_id=body_id)
|
||||
except ValueError as exc:
|
||||
raise HTTPException(status_code=400, detail=str(exc))
|
||||
except KeyError:
|
||||
raise HTTPException(status_code=404, detail="저장한 본문이 없습니다(다른 사람이 지웠을 수 있음).")
|
||||
except UndefinedTable:
|
||||
raise HTTPException(status_code=503, detail=_DM_BODIES_MIGRATION_MSG)
|
||||
return JSONResponse({"id": saved, "items": st.list_dm_bodies() or []})
|
||||
|
||||
|
||||
@router.post("/api/dm-bodies")
|
||||
def api_dm_body_add(request: Request, payload: dict[str, Any] = Body(...)) -> JSONResponse:
|
||||
"""DM 수동 보내기 — 본문 새로 저장(제목 = 첫 줄)."""
|
||||
return _dm_body_save(request, payload, None)
|
||||
|
||||
|
||||
@router.put("/api/dm-bodies/{body_id:int}")
|
||||
def api_dm_body_update(request: Request, body_id: int, payload: dict[str, Any] = Body(...)) -> JSONResponse:
|
||||
"""DM 수동 보내기 — 고른 저장 본문 고치기."""
|
||||
return _dm_body_save(request, payload, body_id)
|
||||
|
||||
|
||||
@router.delete("/api/dm-bodies/{body_id:int}")
|
||||
def api_dm_body_delete(request: Request, body_id: int) -> JSONResponse:
|
||||
from psycopg.errors import UndefinedTable # noqa: WPS433
|
||||
|
||||
_user(request)
|
||||
st = _db(request)
|
||||
try:
|
||||
st.delete_dm_body(body_id)
|
||||
except UndefinedTable:
|
||||
raise HTTPException(status_code=503, detail=_DM_BODIES_MIGRATION_MSG)
|
||||
return JSONResponse({"items": st.list_dm_bodies() or []})
|
||||
|
||||
|
||||
@router.get("/settings", response_class=HTMLResponse)
|
||||
def settings_page(request: Request) -> Any:
|
||||
got = _page(request)
|
||||
if not isinstance(got, tuple):
|
||||
return got
|
||||
st, user = got
|
||||
return _render(request, "outreach/settings.html", user, {
|
||||
"page_title": "안내문 발송 — 설정", "page_subtitle": "메일 제목 · 본문 · DM 문구 · 사진",
|
||||
"template": st.get_template(), "default": store.normalize_template(None), "images": st.list_images(),
|
||||
"max_images": 10, "dm_max": store.DM_MAX, "msg": request.query_params.get("msg", ""),
|
||||
})
|
||||
|
||||
|
||||
@router.post("/settings")
|
||||
def settings_save(request: Request, subject: str = Form(""), body: str = Form(""), sender_name: str = Form(""),
|
||||
footer: str = Form(""), ad_label: str = Form(""), dm_body: str = Form(""),
|
||||
fmt: str = Form("text")) -> RedirectResponse:
|
||||
"""body = 설정 화면 편집기 HTML(fmt=html, 서버가 다시 정리) — fmt 없이 오면 글로 본다."""
|
||||
user = _user(request)
|
||||
st = _db(request)
|
||||
try:
|
||||
st.save_template({"subject": subject, "body": body, "sender_name": sender_name, "footer": footer, "dm_body": dm_body,
|
||||
"ad_label": ad_label in ("1", "on", "true"), "fmt": "html" if fmt == "html" else "text"},
|
||||
by=user["email"])
|
||||
except ValueError as exc:
|
||||
raise HTTPException(status_code=400, detail=str(exc))
|
||||
return RedirectResponse(url="/outreach/settings?" + urlencode({"msg": "설정을 저장했습니다."}), status_code=303)
|
||||
|
||||
|
||||
def _shrink(data: bytes) -> tuple[bytes, int, int]:
|
||||
"""사진 → 메일용 JPEG(가로 최대 700px, 회전 정보 반영, 투명 = 흰 바탕). 못 여는 파일(HEIC 등)은 ValueError."""
|
||||
from PIL import Image, ImageOps # noqa: WPS433
|
||||
|
||||
try:
|
||||
im = Image.open(BytesIO(data))
|
||||
im = ImageOps.exif_transpose(im)
|
||||
if im.mode not in ("RGB", "L"):
|
||||
rgba = im.convert("RGBA")
|
||||
bg = Image.new("RGB", rgba.size, (255, 255, 255))
|
||||
bg.paste(rgba, mask=rgba.split()[-1])
|
||||
im = bg
|
||||
if im.width > IMAGE_MAX_W:
|
||||
im = im.resize((IMAGE_MAX_W, max(1, round(im.height * IMAGE_MAX_W / im.width))), Image.LANCZOS)
|
||||
buf = BytesIO()
|
||||
im.convert("RGB").save(buf, "JPEG", quality=85, optimize=True)
|
||||
except Exception: # noqa: BLE001
|
||||
raise ValueError("사진을 열 수 없습니다(JPG·PNG·WEBP 를 올리세요 — HEIC 는 안 됩니다).") from None
|
||||
return buf.getvalue(), im.width, im.height
|
||||
|
||||
|
||||
@router.post("/settings/images")
|
||||
def images_upload(request: Request, files: list[UploadFile] = File(...)) -> RedirectResponse:
|
||||
user = _user(request)
|
||||
st = _db(request)
|
||||
added, errors = 0, []
|
||||
for f in files:
|
||||
data = f.file.read(IMAGE_MAX_BYTES + 1)
|
||||
if not data:
|
||||
continue
|
||||
if len(data) > IMAGE_MAX_BYTES:
|
||||
errors.append(f"{f.filename}: 15MB 보다 큽니다")
|
||||
continue
|
||||
try:
|
||||
jpg, w, h = _shrink(data)
|
||||
st.add_image(filename=f.filename or "photo.jpg", data=jpg, width=w, height=h, by=user["email"])
|
||||
added += 1
|
||||
except ValueError as exc:
|
||||
errors.append(f"{f.filename}: {exc}")
|
||||
msg = f"사진 {added}장을 넣었습니다." + (" · " + " · ".join(errors) if errors else "")
|
||||
return RedirectResponse(url="/outreach/settings?" + urlencode({"msg": msg}) + "#images", status_code=303)
|
||||
|
||||
|
||||
@router.post("/settings/images/{image_id:int}/delete")
|
||||
def images_delete(request: Request, image_id: int) -> RedirectResponse:
|
||||
_user(request)
|
||||
_db(request).delete_image(image_id)
|
||||
return RedirectResponse(url="/outreach/settings?" + urlencode({"msg": "사진을 뺐습니다."}) + "#images", status_code=303)
|
||||
|
||||
|
||||
@router.post("/settings/images/{image_id:int}/move")
|
||||
def images_move(request: Request, image_id: int, direction: int = Form(...)) -> RedirectResponse:
|
||||
_user(request)
|
||||
_db(request).move_image(image_id, direction)
|
||||
return RedirectResponse(url="/outreach/settings#images", status_code=303)
|
||||
|
||||
|
||||
@router.get("/images/{image_id:int}")
|
||||
def image_view(request: Request, image_id: int) -> Response:
|
||||
_user(request)
|
||||
im = _db(request).get_image(image_id)
|
||||
if im is None:
|
||||
raise HTTPException(status_code=404, detail="사진을 찾을 수 없습니다.")
|
||||
return Response(content=bytes(im["data"]), media_type="image/jpeg", headers={"Cache-Control": "private, max-age=3600"})
|
||||
|
||||
|
||||
# ════════════════════════════════════════════════════════════
|
||||
# 리스트 API
|
||||
# ════════════════════════════════════════════════════════════
|
||||
@router.get("/api/recipients")
|
||||
def api_list(request: Request) -> JSONResponse:
|
||||
_user(request)
|
||||
st = _db(request)
|
||||
template = st.get_template()
|
||||
return JSONResponse({"rows": [_view(r, template) for r in st.list_recipients()]})
|
||||
|
||||
|
||||
@router.post("/api/recipients/parse")
|
||||
def api_parse(request: Request, payload: dict[str, Any] = Body(...)) -> JSONResponse:
|
||||
"""붙여 넣은 글 → 줄마다 {address, name, kind, kind_label, handle, error, dup, exists} (저장 안 함)."""
|
||||
_user(request)
|
||||
st = _db(request)
|
||||
rows = store.parse_bulk(str(payload.get("text") or ""))[:MAX_ADD]
|
||||
have = {(r["kind"], r["handle"]) for r in st.list_recipients()}
|
||||
for r in rows:
|
||||
r["kind_label"] = store.KIND_LABELS.get(r["kind"] or "", "오류")
|
||||
r["exists"] = bool(r["kind"]) and (r["kind"], r["handle"]) in have
|
||||
return JSONResponse({"rows": rows})
|
||||
|
||||
|
||||
@router.post("/api/recipients")
|
||||
def api_add(request: Request, payload: dict[str, Any] = Body(...)) -> JSONResponse:
|
||||
user = _user(request)
|
||||
st = _db(request)
|
||||
rows = [r for r in store.parse_bulk(str(payload.get("text") or "")) if not r["dup"]]
|
||||
if len(rows) > MAX_ADD:
|
||||
raise HTTPException(status_code=400, detail=f"한 번에 {MAX_ADD}줄까지 넣을 수 있습니다.")
|
||||
res = st.add_recipients(rows, by=user["email"])
|
||||
return JSONResponse({"ok": True, **res})
|
||||
|
||||
|
||||
@router.put("/api/recipients/{rid:int}")
|
||||
def api_update(request: Request, rid: int, payload: dict[str, Any] = Body(...)) -> JSONResponse:
|
||||
_user(request)
|
||||
st = _db(request)
|
||||
try:
|
||||
r = st.update_recipient(rid, name=payload.get("name"), memo=payload.get("memo"), status=payload.get("status"))
|
||||
except KeyError:
|
||||
raise HTTPException(status_code=404, detail="리스트에 없는 줄입니다.")
|
||||
except ValueError as exc:
|
||||
raise HTTPException(status_code=400, detail=str(exc))
|
||||
return JSONResponse({"row": _view(r, st.get_template())})
|
||||
|
||||
|
||||
@router.post("/api/recipients/delete")
|
||||
def api_delete(request: Request, payload: dict[str, Any] = Body(...)) -> JSONResponse:
|
||||
_user(request)
|
||||
try:
|
||||
ids = [int(i) for i in payload.get("ids") or []]
|
||||
except (TypeError, ValueError):
|
||||
raise HTTPException(status_code=400, detail="ids 가 올바르지 않습니다.")
|
||||
return JSONResponse({"ok": True, "deleted": _db(request).delete_recipients(ids)})
|
||||
|
||||
|
||||
@router.get("/api/recipients/{rid:int}/preview")
|
||||
def api_preview(request: Request, rid: int) -> JSONResponse:
|
||||
"""그 사람에게 갈 제목·HTML(사진은 /outreach/images 주소로)·DM 글."""
|
||||
_user(request)
|
||||
st = _db(request)
|
||||
r = st.get_recipient(rid)
|
||||
if r is None:
|
||||
raise HTTPException(status_code=404, detail="리스트에 없는 줄입니다.")
|
||||
t = st.get_template()
|
||||
html = store.html_body(t, r["name"], [f"img-{im['id']}" for im in st.list_images()])
|
||||
for im in st.list_images():
|
||||
html = html.replace(f"cid:img-{im['id']}", f"/outreach/images/{im['id']}")
|
||||
return JSONResponse({"subject": store.subject_for(t, r["name"]), "html": html,
|
||||
"text": store.dm_text(t, r["name"]) if r["kind"] == "instagram" else store.plain_text(t, r["name"]),
|
||||
"kind": r["kind"], "to": r["handle"], "sender_name": t["sender_name"]})
|
||||
|
||||
|
||||
@router.post("/api/send")
|
||||
def api_send(request: Request, bg: BackgroundTasks, payload: dict[str, Any] = Body(...)) -> JSONResponse:
|
||||
"""고른 줄 중 메일·대기/실패를 '발송중'으로 잡고(한 번만) 백그라운드로 본인 Gmail 발송. 진행은 GET /api/recipients 로."""
|
||||
from . import send # noqa: WPS433
|
||||
|
||||
user = _user(request)
|
||||
st = _db(request)
|
||||
try:
|
||||
ids = [int(i) for i in payload.get("ids") or []]
|
||||
except (TypeError, ValueError):
|
||||
raise HTTPException(status_code=400, detail="ids 가 올바르지 않습니다.")
|
||||
if not ids:
|
||||
raise HTTPException(status_code=400, detail="보낼 줄을 고르세요.")
|
||||
gm = _gmail_state(request, user)
|
||||
if not gm["connected"]:
|
||||
return JSONResponse({"ok": False, "reconnect": True,
|
||||
"message": "Gmail 이 연결되지 않았습니다 — [Gmail 연결]을 먼저 하세요(내 Gmail 로 보냅니다)."},
|
||||
status_code=409)
|
||||
rows = st.claim_for_send(ids)
|
||||
if not rows:
|
||||
return JSONResponse({"ok": False, "message": "보낼 메일 줄이 없습니다(이미 보냈거나 보내는 중, 또는 DM 줄)."}, status_code=409)
|
||||
bg.add_task(send.send_batch, st, _inout(request), rows=rows, user=dict(user))
|
||||
return JSONResponse({"ok": True, "queued": len(rows)}, status_code=202)
|
||||
|
||||
|
||||
@router.post("/api/recipients/{rid:int}/dm-sent")
|
||||
def api_dm_sent(request: Request, rid: int) -> JSONResponse:
|
||||
user = _user(request)
|
||||
st = _db(request)
|
||||
t = st.get_template()
|
||||
r0 = st.get_recipient(rid)
|
||||
if r0 is None:
|
||||
raise HTTPException(status_code=404, detail="리스트에 없는 줄입니다.")
|
||||
try:
|
||||
r = st.mark_dm_sent(rid, by=user["email"], subject=store.subject_for(t, r0["name"]))
|
||||
except ValueError as exc:
|
||||
raise HTTPException(status_code=400, detail=str(exc))
|
||||
return JSONResponse({"row": _view(r, t)})
|
||||
|
||||
|
||||
# ════════════════════════════════════════════════════════════
|
||||
# 내 Gmail 연결 — 입출고·휴가와 같은 연결(inout_gmail_tokens), 같은 구글 콜백(/inout/gmail/callback)
|
||||
# ════════════════════════════════════════════════════════════
|
||||
@router.get("/gmail/connect")
|
||||
async def gmail_connect(request: Request) -> Any:
|
||||
from app.main import ALLOWED_DOMAIN, public_url_for # noqa: WPS433
|
||||
from app.modules.inout import gmail # noqa: WPS433
|
||||
|
||||
user = _user(request)
|
||||
if _inout(request) is None:
|
||||
return RedirectResponse(url="/outreach/?" + urlencode({"msg": "Gmail 연결 저장소(입출고 DB)가 설정되지 않아 연결할 수 없습니다."}),
|
||||
status_code=303)
|
||||
try:
|
||||
client = gmail.oauth_client()
|
||||
except gmail.GmailError as exc:
|
||||
return RedirectResponse(url="/outreach/?" + urlencode({"msg": str(exc)}), status_code=303)
|
||||
request.session["_gmail_origin"] = "outreach"
|
||||
request.session["_gmail_next"] = "/outreach/"
|
||||
return await client.authorize_redirect(
|
||||
request, public_url_for(request, "inout_gmail_callback"),
|
||||
access_type="offline", prompt="consent", include_granted_scopes="true",
|
||||
login_hint=user.get("email", ""), hd=ALLOWED_DOMAIN)
|
||||
|
||||
|
||||
@router.post("/gmail/disconnect")
|
||||
def gmail_disconnect(request: Request) -> RedirectResponse:
|
||||
from app.modules.inout import gmail # noqa: WPS433
|
||||
|
||||
user = _user(request)
|
||||
inout = _inout(request)
|
||||
if inout is not None:
|
||||
row = inout.gmail_token(user["email"])
|
||||
if row:
|
||||
try:
|
||||
gmail.revoke(gmail.decrypt_token(user["email"], row["refresh_token_enc"]))
|
||||
except (gmail.GmailError, gmail.GmailNotConnected):
|
||||
pass
|
||||
inout.delete_gmail_token(user["email"])
|
||||
return RedirectResponse(url="/outreach/?" + urlencode({"msg": "Gmail 연결을 끊었습니다(입출고·휴가 메일 연결도 함께)."}),
|
||||
status_code=303)
|
||||
@@ -0,0 +1,94 @@
|
||||
"""안내문 메일 일괄 발송(2026-10-27) — 보내는 사람 본인 Gmail(입출고·휴가와 같은 Gmail 연결, gmail.send 만)로 한 사람에 한 통.
|
||||
|
||||
라우터가 고른 줄을 '발송중'으로 잡은 뒤(db.claim_for_send — 두 번 눌러도 한 번) 응답하고, 이 함수가 백그라운드에서 차례로 보낸다.
|
||||
줄마다 {이름} 을 바꾼 제목·본문 + 설정 사진(본문 아래, cid)을 만들어 보내고 보냄/실패와 기록(outreach_logs)을 남긴다.
|
||||
본문에 {이름} 이 있는데 이름이 빈 줄은 보내지 않고 실패('이름 없음'). Gmail 연결이 끊기면 남은 줄은 실패(다시 연결 안내).
|
||||
"""
|
||||
|
||||
from __future__ import annotations
|
||||
|
||||
import logging
|
||||
import time
|
||||
from typing import Any
|
||||
|
||||
from . import store
|
||||
|
||||
logger = logging.getLogger("app.outreach.send")
|
||||
SEND_GAP_SECONDS = 1.0 # 한 통마다 쉬는 시간 — Gmail 이 짧은 시간에 몰린 발송을 막지 않게
|
||||
|
||||
|
||||
def _cid(image_id: int) -> str:
|
||||
return f"outreach-{image_id}@dbx"
|
||||
|
||||
|
||||
def build_mail(template: dict[str, Any], images: list[dict[str, Any]], *, name: str, sender_name: str, sender_email: str,
|
||||
to: str) -> bytes:
|
||||
from app.modules.inout import gmail # noqa: WPS433
|
||||
|
||||
cids = [_cid(int(im["id"])) for im in images]
|
||||
return gmail.build_message(
|
||||
sender_name=template.get("sender_name") or sender_name, sender_email=sender_email, to=[to], cc=[],
|
||||
subject=store.subject_for(template, name), text=store.plain_text(template, name),
|
||||
html=store.html_body(template, name, cids),
|
||||
inline_images=[{"cid": c, "data": bytes(im["data"])} for c, im in zip(cids, images)],
|
||||
)
|
||||
|
||||
|
||||
def send_batch(db: Any, inout_store: Any, *, rows: list[dict[str, Any]], user: dict[str, Any],
|
||||
gap: float = SEND_GAP_SECONDS) -> dict[str, int]:
|
||||
"""잡아 둔 줄(rows)을 차례로 보낸다 — {"sent", "failed"}. 예외를 밖으로 던지지 않는다(줄마다 결과를 남김)."""
|
||||
from app.modules.inout import gmail # noqa: WPS433
|
||||
|
||||
email = str(user.get("email") or "").lower()
|
||||
result = {"sent": 0, "failed": 0}
|
||||
try:
|
||||
template = db.get_template()
|
||||
images = db.list_images(with_data=True)
|
||||
subject_of = lambda r: store.subject_for(template, r["name"]) # noqa: E731
|
||||
row = inout_store.gmail_token(email) if inout_store is not None else None
|
||||
refresh = gmail.decrypt_token(email, row["refresh_token_enc"]) if row else None
|
||||
except Exception as exc: # noqa: BLE001 — 준비 실패 = 잡아 둔 줄 모두 실패(발송중으로 남지 않게)
|
||||
for r in rows:
|
||||
db.finish_send(r["id"], ok=False, via="gmail", by=email, subject="", error=f"보낼 준비 실패: {exc}")
|
||||
result["failed"] = len(rows)
|
||||
return result
|
||||
stop_reason = "" if refresh else "Gmail 이 연결되지 않았습니다 — 안내문 발송 → [Gmail 연결] 뒤 다시 보내세요."
|
||||
need_name = store.needs_name(template)
|
||||
for i, r in enumerate(rows):
|
||||
if stop_reason:
|
||||
db.finish_send(r["id"], ok=False, via="gmail", by=email, subject=subject_of(r), error=stop_reason)
|
||||
result["failed"] += 1
|
||||
continue
|
||||
if need_name and not (r.get("name") or "").strip():
|
||||
db.finish_send(r["id"], ok=False, via="gmail", by=email, subject=subject_of(r),
|
||||
error="이름 없음 — 본문에 {이름} 이 있어 이름을 넣은 뒤 다시 보내세요.")
|
||||
result["failed"] += 1
|
||||
continue
|
||||
try:
|
||||
raw = build_mail(template, images, name=r["name"], sender_name=str(user.get("name") or ""),
|
||||
sender_email=email, to=r["handle"])
|
||||
gmail.send(refresh, raw)
|
||||
except gmail.GmailNotConnected as exc:
|
||||
try:
|
||||
inout_store.delete_gmail_token(email)
|
||||
except Exception: # noqa: BLE001
|
||||
pass
|
||||
stop_reason = f"Gmail 연결이 끊겼습니다 — 다시 연결한 뒤 보내세요. ({exc})"
|
||||
db.finish_send(r["id"], ok=False, via="gmail", by=email, subject=subject_of(r), error=stop_reason)
|
||||
result["failed"] += 1
|
||||
continue
|
||||
except Exception as exc: # noqa: BLE001 — 그 사람만 실패(받는 주소 오류 등), 다음 사람은 계속
|
||||
db.finish_send(r["id"], ok=False, via="gmail", by=email, subject=subject_of(r), error=str(exc)[:300])
|
||||
result["failed"] += 1
|
||||
continue
|
||||
db.finish_send(r["id"], ok=True, via="gmail", by=email, subject=subject_of(r))
|
||||
result["sent"] += 1
|
||||
if gap and i < len(rows) - 1:
|
||||
time.sleep(gap)
|
||||
try:
|
||||
if inout_store is not None and result["sent"]:
|
||||
inout_store.mark_gmail(email)
|
||||
except Exception: # noqa: BLE001
|
||||
pass
|
||||
logger.info("안내문 메일 %s: 보냄 %s · 실패 %s", email, result["sent"], result["failed"])
|
||||
return result
|
||||
@@ -0,0 +1,369 @@
|
||||
"""안내문 발송 — 순수 함수(DB 없음): 주소 판별(이메일 / 인스타그램), 리스트 붙여넣기 해석, {이름} 바꾸기, 메일 HTML·DM 글.
|
||||
|
||||
- 주소를 보고 정한다: `name@domain.tld` = 메일, `@계정`·`instagram.com/계정`·`ig.me/m/계정`·계정명만(영문·숫자·.·_) = 인스타 DM.
|
||||
- 본문 `{이름}` = 그 줄 이름. 메일 본문 = 설정 화면 편집기의 HTML(`fmt: "html"`) — 저장·읽을 때마다 `sanitize_html`(허용 태그·스타일만).
|
||||
예전 글·기본 문구(`fmt` 없음 = 글)는 `text_to_html`(`**굵게**` → 굵게, 주소 → 링크, 줄마다 문단).
|
||||
- DM 글 = 설정 `dm_body`(인스타 DM 용 글, 서식 없음). 비어 있으면 메일 본문 글 + 끝 문구.
|
||||
"""
|
||||
|
||||
from __future__ import annotations
|
||||
|
||||
import re
|
||||
from html import escape
|
||||
from html.parser import HTMLParser
|
||||
from typing import Any
|
||||
|
||||
NAME_TAG = "{이름}"
|
||||
KINDS = ("email", "instagram")
|
||||
KIND_LABELS = {"email": "메일", "instagram": "DM"}
|
||||
STATUSES = ("대기", "발송중", "보냄", "실패")
|
||||
|
||||
_EMAIL_RE = re.compile(r"^[A-Za-z0-9.!#$%&'*+/=?^_`{|}~-]+@[A-Za-z0-9-]+(\.[A-Za-z0-9-]+)+$")
|
||||
_IG_USER_RE = re.compile(r"^[A-Za-z0-9._]{1,30}$")
|
||||
_IG_URL_RE = re.compile(r"^(?:https?://)?(?:www\.|m\.)?(?:instagram\.com|instagr\.am)/([^/?#\s]+)", re.IGNORECASE)
|
||||
_IG_ME_RE = re.compile(r"^(?:https?://)?ig\.me/m/([^/?#\s]+)", re.IGNORECASE)
|
||||
# instagram.com 아래 계정이 아닌 주소(게시물·릴스 등)
|
||||
_IG_RESERVED = {"p", "reel", "reels", "tv", "explore", "stories", "direct", "accounts", "about", "legal", "developer"}
|
||||
|
||||
DEFAULT_TEMPLATE: dict[str, Any] = {
|
||||
"subject": "누적매출 300억. 800만개 판매 신화 미라클통 '미라네주방'입니다.",
|
||||
"sender_name": "미라네주방",
|
||||
"ad_label": False,
|
||||
"footer": "",
|
||||
"dm_body": "",
|
||||
"fmt": "text", # body 형식 — 기본 문구는 글, 설정 화면에서 저장하면 "html"
|
||||
"body": """안녕하세요, {이름}님.
|
||||
주방의 본질을 지키며 6년간 묵묵히 300억 매출의 신화를 써온 **'미라네주방'**입니다.
|
||||
저희는 지난 6년간 제품력 하나로 국내/해외 800만 개 판매를 돌파하고 호주, 동남아 등 글로벌 시장에서 인정받았습니다.
|
||||
브랜드의 가치를 지키기 위해 공동구매를 극도로 자제해왔으나,
|
||||
최근 'ㅎ 인플루언서'와의 PPL 및 전용 상품 협업을 통해 단일 프로젝트 매출 약3억, 누적 약 8억원이라는 놀라운 기록을 확인하였고,
|
||||
ㄷ'인플루언서'님과는 약 2억원의 매출을 달성하는 등 인플루언서 파트너십의 새로운 가능성을 보았습니다.
|
||||
|
||||
이에, 압도적인 신뢰도와 감각을 보유하신 {이름}님과의 공동구매 파트너십을 정중히 제안드립니다.
|
||||
|
||||
왜 '미라네주방'이어야 하는가?
|
||||
시장 점유율로 증명된 '미라클통'의 힘: 누적 800만 개 판매. 이미 시장에서 검증된 제품은 팔로워들에게 구구절절 설명할 필요가 없습니다.
|
||||
희소성의 가치: 아무나 할 수 있는 공구가 아닙니다. 공구를 지양해온 브랜드이기에 {이름}님의 피드에서 진행되는 공구는 팔로워들에게 더욱 특별한 기회로 인식될 것입니다.
|
||||
|
||||
1단계: 검증된 베스트셀러로 화력 확인 (Existing Product)
|
||||
이미 800만 개가 팔려나가며 시장성이 검증된 ‘미라클통’ 등 기존 베스트셀러 라인으로 공동구매를 진행합니다.
|
||||
팔로워들에게는 '구하고 싶어도 공구로 만나기 힘들었던 제품'이라는 명분을, 인플루언서님께는 확실한 수익과 유입을 보장합니다.
|
||||
|
||||
2단계: 화력 입증 시 {이름}님 전용 상품 개발 (Exclusive Product)
|
||||
첫 공구에서 유의미한 매출 성과가 확인될 경우, 저희는 즉시 {이름}님만을 위한 전용 상품(PB/콜라보) 개발에 착수합니다.
|
||||
전용 컬러, 단독 구성, 혹은 니즈를 반영한 신규 기능을 담아, 어디에서도 볼 수 없는 '귀하만의 제품'을 시장에 선보이게 됩니다.
|
||||
이는 인플루언서로서의 브랜드 가치를 한 단계 높이는 결정적인 계기가 될 것입니다.
|
||||
"'ㅎ인플루언서님'과의 콜라보 사례를 하단과 같이 사진 공유드립니다."
|
||||
|
||||
미라네주방은 단순히 한 번의 공구로 끝나는 관계를 원하지 않습니다.
|
||||
{이름}님의 감각과 저희의 기술력이 만나 주방용품 시장의 판도를 바꿀 '전용 브랜드'를 함께 만들어가길 희망합니다.
|
||||
긍정적인 검토 부탁드리며, 미라네주방의 성공 신화에 함께 올라타실 파트너가 되어주시길 기다리겠습니다.
|
||||
|
||||
감사합니다.
|
||||
|
||||
|
||||
미라네주방 팀 드림
|
||||
https://miras.co.kr/""",
|
||||
}
|
||||
SUBJECT_MAX, BODY_MAX, FOOTER_MAX = 200, 100000, 2000 # BODY_MAX = 정리한 HTML 길이
|
||||
DM_MAX = 1000 # 인스타 DM 한 통 글자 수 한도
|
||||
|
||||
|
||||
def _ig_user(value: str) -> str | None:
|
||||
v = value.strip().strip("/")
|
||||
if v.startswith("@"):
|
||||
v = v[1:]
|
||||
if not _IG_USER_RE.match(v) or v.startswith(".") or v.endswith(".") or ".." in v:
|
||||
return None
|
||||
if v.lower() in _IG_RESERVED:
|
||||
return None
|
||||
return v.lower()
|
||||
|
||||
|
||||
def detect(address: Any) -> dict[str, Any]:
|
||||
"""주소 → {"kind": "email"|"instagram"|None, "handle", "error"}. handle = 이메일 소문자 / 인스타 계정명 소문자."""
|
||||
raw = str(address or "").strip().strip("<>").strip()
|
||||
if raw.lower().startswith("mailto:"):
|
||||
raw = raw[7:]
|
||||
if not raw:
|
||||
return {"kind": None, "handle": "", "error": "주소가 비었습니다."}
|
||||
if "@" in raw and not raw.startswith("@") and "/" not in raw:
|
||||
if _EMAIL_RE.match(raw) and len(raw) <= 320:
|
||||
return {"kind": "email", "handle": raw.lower(), "error": ""}
|
||||
return {"kind": None, "handle": "", "error": f"이메일 주소가 올바르지 않습니다: {raw}"}
|
||||
for rx in (_IG_ME_RE, _IG_URL_RE):
|
||||
m = rx.match(raw)
|
||||
if m:
|
||||
user = _ig_user(m.group(1))
|
||||
if user:
|
||||
return {"kind": "instagram", "handle": user, "error": ""}
|
||||
return {"kind": None, "handle": "", "error": f"인스타그램 계정 주소가 아닙니다: {raw}"}
|
||||
user = _ig_user(raw)
|
||||
if user and (raw.startswith("@") or re.search(r"[A-Za-z]", raw)):
|
||||
return {"kind": "instagram", "handle": user, "error": ""}
|
||||
return {"kind": None, "handle": "", "error": f"이메일도 인스타그램 주소도 아닙니다: {raw}"}
|
||||
|
||||
|
||||
def _looks_explicit(part: str) -> bool:
|
||||
"""이메일·@계정·인스타 주소처럼 '주소'가 분명한 칸인가(계정명만 쓴 칸보다 먼저 주소로 고른다)."""
|
||||
p = part.strip()
|
||||
return "@" in p or "instagram.com" in p.lower() or "instagr.am" in p.lower() or "ig.me/" in p.lower()
|
||||
|
||||
|
||||
def parse_line(line: str) -> dict[str, Any] | None:
|
||||
"""붙여 넣은 한 줄 → {"address", "name", ...detect}. 빈 줄·#주석 = None.
|
||||
칸 나누기 = 탭 · 쉼표 · (둘 다 없으면) 공백. 주소가 분명한 칸(이메일·@·인스타 링크)을 주소로, 나머지는 이름.
|
||||
둘 다 분명하지 않으면 '주소, 이름' 순서로 본다."""
|
||||
s = line.strip()
|
||||
if not s or s.startswith("#"):
|
||||
return None
|
||||
parts = [p.strip() for p in re.split(r"\t|,", s) if p.strip()]
|
||||
if len(parts) == 1:
|
||||
parts = s.split()
|
||||
addr_i = next((i for i, p in enumerate(parts) if _looks_explicit(p) and detect(p)["kind"]), None)
|
||||
if addr_i is None:
|
||||
addr_i = next((i for i, p in enumerate(parts) if detect(p)["kind"]), 0)
|
||||
address = parts[addr_i]
|
||||
name = " ".join(p for i, p in enumerate(parts) if i != addr_i).strip()
|
||||
return {"address": address, "name": name[:100], **detect(address)}
|
||||
|
||||
|
||||
def parse_bulk(text: str) -> list[dict[str, Any]]:
|
||||
"""여러 줄 붙여넣기 → 줄마다 parse_line(빈 줄 건너뜀), 같은 주소는 처음 것만(dup=True 표시)."""
|
||||
out: list[dict[str, Any]] = []
|
||||
seen: set[tuple[str, str]] = set()
|
||||
for i, line in enumerate(str(text or "").splitlines(), 1):
|
||||
r = parse_line(line)
|
||||
if r is None:
|
||||
continue
|
||||
r["line"] = i
|
||||
key = (r["kind"] or "", r["handle"])
|
||||
r["dup"] = bool(r["kind"]) and key in seen
|
||||
seen.add(key)
|
||||
out.append(r)
|
||||
return out
|
||||
|
||||
|
||||
def normalize_template(value: dict[str, Any] | None) -> dict[str, Any]:
|
||||
"""설정 값 정리 — 빠진 칸은 기본값, 길이 제한."""
|
||||
v = dict(DEFAULT_TEMPLATE)
|
||||
for k, val in (value or {}).items():
|
||||
if k in v:
|
||||
v[k] = val
|
||||
v["subject"] = str(v["subject"] or "").strip()[:SUBJECT_MAX]
|
||||
body = str(v["body"] or "")[:BODY_MAX * 3]
|
||||
v["body"] = sanitize_html(body if v["fmt"] == "html" else text_to_html(body))
|
||||
v["fmt"] = "html"
|
||||
v["footer"] = str(v["footer"] or "").replace("\r\n", "\n").strip()[:FOOTER_MAX]
|
||||
v["dm_body"] = str(v["dm_body"] or "").replace("\r\n", "\n").strip()[:DM_MAX]
|
||||
v["sender_name"] = str(v["sender_name"] or "").strip()[:60]
|
||||
v["ad_label"] = bool(v["ad_label"])
|
||||
return v
|
||||
|
||||
|
||||
def needs_name(template: dict[str, Any], kind: str = "email") -> bool:
|
||||
"""그 구분(메일/DM)으로 갈 글에 {이름}이 있는가 — DM 은 DM 문구(없으면 메일 본문)만 본다."""
|
||||
if kind == "instagram" and (template.get("dm_body") or "").strip():
|
||||
return NAME_TAG in template["dm_body"]
|
||||
body = html_to_text(template.get("body") or "")
|
||||
if kind == "instagram":
|
||||
return NAME_TAG in body or NAME_TAG in (template.get("footer") or "")
|
||||
return NAME_TAG in (template.get("subject") or "") or NAME_TAG in body
|
||||
|
||||
|
||||
def fill(text: str, name: str) -> str:
|
||||
return str(text or "").replace(NAME_TAG, str(name or "").strip())
|
||||
|
||||
|
||||
def subject_for(template: dict[str, Any], name: str) -> str:
|
||||
s = fill(template.get("subject") or "", name)
|
||||
return ("(광고) " + s) if template.get("ad_label") and not s.startswith("(광고)") else s
|
||||
|
||||
|
||||
def plain_text(template: dict[str, Any], name: str) -> str:
|
||||
"""메일 글 부분(HTML 메일의 글 버전)·DM 문구가 없을 때의 DM 글 — 본문 글 + 끝 문구."""
|
||||
body = fill(html_to_text(template.get("body") or ""), name).rstrip()
|
||||
footer = (template.get("footer") or "").strip()
|
||||
return body + ("\n\n" + fill(footer, name) if footer else "")
|
||||
|
||||
|
||||
def dm_text(template: dict[str, Any], name: str) -> str:
|
||||
"""인스타 DM 글 — DM 문구가 있으면 그것, 없으면 메일 글(plain_text). **굵게** 는 별표만 뺀다."""
|
||||
dm = (template.get("dm_body") or "").strip()
|
||||
if not dm:
|
||||
return plain_text(template, name)
|
||||
return re.sub(r"\*\*(.+?)\*\*", r"\1", fill(dm, name))
|
||||
|
||||
|
||||
def dm_saved_body(value: Any) -> tuple[str, str]:
|
||||
"""DM 수동 보내기 탭에 저장할 본문 → (제목, 본문). 제목 = 첫 글 줄 40자(목록 표시용). 비었거나 너무 길면 ValueError."""
|
||||
body = str(value or "").replace("\r\n", "\n").strip()
|
||||
if not body:
|
||||
raise ValueError("본문을 쓰세요.")
|
||||
if len(body) > DM_MAX:
|
||||
raise ValueError(f"본문은 {DM_MAX}자까지입니다(인스타 DM 한도) — 지금 {len(body)}자.")
|
||||
title = next((ln.strip() for ln in body.split("\n") if ln.strip()), "")
|
||||
return (title[:40] + ("…" if len(title) > 40 else "")), body
|
||||
|
||||
|
||||
# ── 메일 본문 HTML ─────────────────────────────────────────
|
||||
_URL_RE = re.compile(r"https?://[^\s<>\"']+")
|
||||
_ALLOWED_TAGS = {"p", "br", "strong", "b", "em", "i", "u", "s", "strike", "span", "a", "ul", "ol", "li",
|
||||
"h1", "h2", "h3", "blockquote", "sub", "sup"}
|
||||
_DROP_WITH_CONTENT = {"script", "style", "iframe", "object", "head", "title", "template", "noscript", "svg", "math",
|
||||
"textarea", "select"}
|
||||
_STYLE_PROPS = {"color", "background-color", "font-size", "font-weight", "font-style", "text-decoration", "text-align"}
|
||||
_STYLE_VALUE_RE = re.compile(r"^[#\w\s.,%()-]{1,60}$")
|
||||
# {이름} — 편집기에서 글자마다 서식이 달라 태그가 끼어도 찾는다(태그는 남기고 글자만 이름으로)
|
||||
_NAME_IN_HTML_RE = re.compile(r"\{((?:<[^>]*>)*)이((?:<[^>]*>)*)름((?:<[^>]*>)*)\}")
|
||||
|
||||
|
||||
def _clean_style(value: str) -> str:
|
||||
out = []
|
||||
for decl in value.split(";"):
|
||||
prop, _, val = decl.partition(":")
|
||||
prop, val = prop.strip().lower(), val.strip()
|
||||
if prop in _STYLE_PROPS and _STYLE_VALUE_RE.match(val) and not re.search(r"url|expression", val, re.I):
|
||||
out.append(f"{prop}: {val}")
|
||||
return "; ".join(out)
|
||||
|
||||
|
||||
class _Sanitizer(HTMLParser):
|
||||
"""허용 태그·속성(style 은 글자 서식만, a 는 http(s)/mailto 링크만)만 남기고 글은 escape. 태그 짝은 맞춰 닫는다.
|
||||
편집기(Quill getSemanticHTML)가 띄어쓰기를 로 내보내 보통 띄어쓰기로 바꾼다(메일은 pre-wrap 이라 여러 칸도 그대로)."""
|
||||
|
||||
def __init__(self) -> None:
|
||||
super().__init__(convert_charrefs=True)
|
||||
self.out: list[str] = []
|
||||
self.stack: list[str] = []
|
||||
self.skip = 0
|
||||
self.empty_p = False # 지금 연 <p> 에 아직 글이 없다 — 닫을 때 <br> 을 넣어 빈 줄 높이를 지킨다
|
||||
|
||||
def handle_starttag(self, tag: str, attrs: list[tuple[str, str | None]]) -> None:
|
||||
if tag in _DROP_WITH_CONTENT:
|
||||
self.skip += 1
|
||||
return
|
||||
if self.skip or tag not in _ALLOWED_TAGS:
|
||||
return
|
||||
if tag == "br":
|
||||
self.out.append("<br>")
|
||||
self.empty_p = False
|
||||
return
|
||||
a = {k: v or "" for k, v in attrs}
|
||||
extra = ""
|
||||
style = _clean_style(a.get("style", ""))
|
||||
if style:
|
||||
extra += f' style="{escape(style)}"'
|
||||
href = a.get("href", "").strip()
|
||||
if tag == "a" and re.match(r"^(https?:|mailto:)", href, re.I):
|
||||
extra += f' href="{escape(href)}"'
|
||||
self.out.append(f"<{tag}{extra}>")
|
||||
self.stack.append(tag)
|
||||
if tag == "p":
|
||||
self.empty_p = True
|
||||
|
||||
def handle_endtag(self, tag: str) -> None:
|
||||
if tag in _DROP_WITH_CONTENT:
|
||||
self.skip = max(0, self.skip - 1)
|
||||
return
|
||||
if self.skip or tag not in self.stack:
|
||||
return
|
||||
while self.stack:
|
||||
t = self.stack.pop()
|
||||
if t == "p" and self.empty_p:
|
||||
self.out.append("<br>")
|
||||
self.empty_p = False
|
||||
self.out.append(f"</{t}>")
|
||||
if t == tag:
|
||||
break
|
||||
|
||||
def handle_data(self, data: str) -> None:
|
||||
if self.skip:
|
||||
return
|
||||
text = data.replace("\r", "").replace("\n", " ").replace("\xa0", " ")
|
||||
if not text.strip() and (not self.stack or self.stack[-1] in ("ul", "ol")):
|
||||
return
|
||||
if text:
|
||||
self.out.append(escape(text, quote=False))
|
||||
self.empty_p = False
|
||||
|
||||
def result(self) -> str:
|
||||
self.close()
|
||||
while self.stack:
|
||||
self.handle_endtag(self.stack[-1])
|
||||
return "".join(self.out)
|
||||
|
||||
|
||||
def sanitize_html(html: str) -> str:
|
||||
p = _Sanitizer()
|
||||
p.feed(str(html or ""))
|
||||
return p.result()
|
||||
|
||||
|
||||
def text_to_html(text: str) -> str:
|
||||
"""글(예전 본문·기본 문구) → 본문 HTML — 줄마다 문단, 빈 줄 = <p><br></p>, **굵게** → <strong>, 주소 → 링크."""
|
||||
out = []
|
||||
for line in str(text or "").replace("\r\n", "\n").rstrip("\n").split("\n"):
|
||||
h = re.sub(r"\*\*(.+?)\*\*", r"<strong>\1</strong>", escape(line, quote=False))
|
||||
h = _URL_RE.sub(lambda m: f'<a href="{m.group(0)}">{m.group(0)}</a>', h)
|
||||
out.append(f"<p>{h or '<br>'}</p>")
|
||||
return "".join(out)
|
||||
|
||||
|
||||
class _Text(HTMLParser):
|
||||
def __init__(self) -> None:
|
||||
super().__init__(convert_charrefs=True)
|
||||
self.parts: list[str] = []
|
||||
|
||||
def handle_starttag(self, tag: str, attrs: list[tuple[str, str | None]]) -> None:
|
||||
if tag == "br":
|
||||
self.parts.append("\x00") # 문단 끝 바로 앞의 <br>(빈 줄 표시)은 줄을 하나 더 만들지 않는다
|
||||
elif tag == "li":
|
||||
self.parts.append("- ")
|
||||
|
||||
def handle_endtag(self, tag: str) -> None:
|
||||
if tag in ("p", "li", "h1", "h2", "h3", "blockquote"):
|
||||
if self.parts and self.parts[-1] == "\x00":
|
||||
self.parts.pop()
|
||||
self.parts.append("\n")
|
||||
|
||||
def handle_data(self, data: str) -> None:
|
||||
self.parts.append(data.replace("\xa0", " "))
|
||||
|
||||
|
||||
def html_to_text(html: str) -> str:
|
||||
"""본문 HTML → 글(메일 글 버전·DM·{이름} 찾기·리스트 화면 요약)."""
|
||||
p = _Text()
|
||||
p.feed(str(html or ""))
|
||||
p.close()
|
||||
return "".join(p.parts).replace("\x00", "\n").rstrip()
|
||||
|
||||
|
||||
def fill_html(html: str, name: str) -> str:
|
||||
return _NAME_IN_HTML_RE.sub(lambda m: escape(str(name or "").strip()) + m.group(1) + m.group(2) + m.group(3), str(html or ""))
|
||||
|
||||
|
||||
def _p_margin(html: str) -> str:
|
||||
"""메일 프로그램은 <p> 에 위아래 여백을 줘 편집기보다 줄 간격이 벌어진다 — margin:0 을 붙인다."""
|
||||
return re.sub(r'<p( style=")?', lambda m: '<p style="margin:0;' if m.group(1) else '<p style="margin:0"', html)
|
||||
|
||||
|
||||
def html_body(template: dict[str, Any], name: str, image_cids: list[str] | None = None) -> str:
|
||||
"""메일 HTML — 본문(정리된 편집기 HTML, {이름} 바꿈) + 끝 문구(글 → escape·링크) + 사진은 본문 아래(cid)."""
|
||||
body = fill_html(sanitize_html(template.get("body") or ""), name)
|
||||
footer = (template.get("footer") or "").strip()
|
||||
if footer:
|
||||
body += "<p><br></p>" + text_to_html(fill(footer, name))
|
||||
imgs = "".join(f'<p style="margin:12px 0 0"><img src="cid:{c}" alt="" style="max-width:100%;height:auto;border-radius:6px"></p>'
|
||||
for c in (image_cids or []))
|
||||
return ('<div style="font-family:Pretendard,\'Malgun Gothic\',sans-serif;font-size:14px;line-height:1.7;color:#111;white-space:pre-wrap">'
|
||||
f"{_p_margin(body)}</div>{imgs}")
|
||||
|
||||
|
||||
def dm_link(handle: str) -> str:
|
||||
"""인스타 DM 창 — ig.me/m/계정(앱·웹 모두 그 사람과의 대화로)."""
|
||||
return f"https://ig.me/m/{handle}"
|
||||
|
||||
|
||||
def profile_link(handle: str) -> str:
|
||||
return f"https://www.instagram.com/{handle}/"
|
||||
@@ -0,0 +1,13 @@
|
||||
{#- 안내문 발송 탭(2026-10-30) — [발송 리스트] [DM 수동 보내기] + 맨 오른쪽 설정 톱니(실적·프로젝트와 같은 Material Symbols "settings") -#}
|
||||
<nav class="otr-tabs" aria-label="안내문 발송 메뉴">
|
||||
<div class="otr-tabs-main" role="tablist">
|
||||
<a class="otr-tab{% if active_tab == 'list' %} is-active{% endif %}" href="/outreach/" role="tab"
|
||||
aria-selected="{{ 'true' if active_tab == 'list' else 'false' }}">
|
||||
<span class="material-symbols-outlined" aria-hidden="true">forward_to_inbox</span>발송 리스트</a>
|
||||
<a class="otr-tab{% if active_tab == 'dm' %} is-active{% endif %}" href="/outreach/dm" role="tab"
|
||||
aria-selected="{{ 'true' if active_tab == 'dm' else 'false' }}">
|
||||
<span class="material-symbols-outlined" aria-hidden="true">chat</span>DM 수동 보내기</a>
|
||||
</div>
|
||||
<a class="otr-gear" href="/outreach/settings" title="설정" aria-label="설정">
|
||||
<span class="material-symbols-outlined" aria-hidden="true">settings</span></a>
|
||||
</nav>
|
||||
@@ -0,0 +1,51 @@
|
||||
{% extends "erp_base.html" %}
|
||||
|
||||
{#- DM 수동 보내기 탭(2026-10-30) — 왼쪽 = 이름 넣기(붙여 넣기·.txt/.csv 첫 칸) + 이름 목록(한 명씩·전체 지우기),
|
||||
가운데 = 본문(고칠 수 있음, {이름} 자리는 분홍 이름 칩), 오른쪽 = 저장한 본문 목록(고르기·하나씩 지우기, outreach_db 002).
|
||||
이름을 누르면 본문의 {이름} 이 그 이름으로 바뀌고 바로 클립보드에 복사. 이름 목록은 저장하지 않음(브라우저만). -#}
|
||||
{% block head_extra %}<link rel="stylesheet" href="/static/vendor/material-symbols/material-symbols.css" />
|
||||
<link rel="stylesheet" href="/static/outreach.css?v=20261030c" />{% endblock %}
|
||||
|
||||
{% block content %}
|
||||
<section class="otr otr-dm-page" id="otr-dm">
|
||||
{% include "outreach/_tabs.html" %}
|
||||
|
||||
<div class="otr-dm-split">
|
||||
<div class="erp-card otr-dm-left">
|
||||
<div class="otr-add-head"><b>이름</b>
|
||||
<span class="erp-muted">한 줄에 한 이름 — 붙여 넣거나 파일(.txt·.csv, 첫 칸)을 올리세요. 엑셀은 이름 칸을 복사해 붙여 넣으면 됩니다.</span></div>
|
||||
<textarea class="erp-input otr-add-text" id="otr-dm-text" rows="4" placeholder="김철수 미라네 이수진"></textarea>
|
||||
<div class="otr-add-actions">
|
||||
<button type="button" class="erp-btn erp-btn-primary" id="otr-dm-load">이름 넣기</button>
|
||||
<label class="erp-btn erp-btn-outline otr-dm-file">파일 올리기<input type="file" id="otr-dm-file" accept=".txt,.csv,text/plain,text/csv" hidden /></label>
|
||||
</div>
|
||||
<div class="otr-dm-listhead"><span class="erp-muted" id="otr-dm-sum">0명</span>
|
||||
<button type="button" class="erp-btn erp-btn-outline erp-btn-sm otr-danger" id="otr-dm-clear" disabled>전체 삭제</button></div>
|
||||
<ul class="otr-dm-names" id="otr-dm-names" aria-label="이름 목록"></ul>
|
||||
</div>
|
||||
|
||||
<div class="erp-card otr-dm-right">
|
||||
<div class="otr-add-head"><b>본문 <span class="otr-dm-cur" id="otr-dm-cur"></span></b>
|
||||
<span class="erp-muted">바로 고칠 수 있습니다. 분홍 글자 = <code>{이름}</code> 자리(왼쪽 이름을 누르면 바뀌고 복사됨, 새 자리는 <code>{이름}</code> 이라고 쓰면 됨).</span></div>
|
||||
<div class="otr-add-actions otr-dm-actions">
|
||||
<button type="button" class="erp-btn erp-btn-primary" id="otr-dm-save" disabled title="오른쪽 목록에서 고른 본문을 이 글로 바꿉니다">저장</button>
|
||||
<button type="button" class="erp-btn erp-btn-outline" id="otr-dm-saveas">새 본문으로 저장</button>
|
||||
<span class="erp-muted" id="otr-dm-count"></span>
|
||||
</div>
|
||||
<div class="otr-dm-body" id="otr-dm-body" contenteditable="plaintext-only" spellcheck="false" role="textbox" aria-multiline="true" aria-label="본문"></div>
|
||||
</div>
|
||||
|
||||
<div class="erp-card otr-dm-saved">
|
||||
<div class="otr-add-head"><b>저장한 본문</b><span class="erp-muted">누르면 가운데 본문으로 불러옵니다.</span></div>
|
||||
{% if dm_bodies is none %}
|
||||
<p class="otr-msg">본문 저장 표가 아직 없습니다 — 관리자가 outreach_db 마이그레이션 002(<code>scripts/sql/outreach_db_002_dm_bodies.sql</code>)를 적용하면 저장할 수 있습니다.</p>
|
||||
{% endif %}
|
||||
<ul class="otr-dm-names otr-dm-bodies" id="otr-dm-bodies" aria-label="저장한 본문 목록"></ul>
|
||||
</div>
|
||||
</div>
|
||||
</section>
|
||||
|
||||
<script type="application/json" id="otr-data">{{ {"dm_template": dm_template, "dm_bodies": dm_bodies, "dm_max": dm_max} | tojson }}</script>
|
||||
{% endblock %}
|
||||
|
||||
{% block scripts %}<script src="/static/outreach.js?v=20261030c" defer></script>{% endblock %}
|
||||
@@ -0,0 +1,103 @@
|
||||
{% extends "erp_base.html" %}
|
||||
|
||||
{#- 안내문 발송(2026-10-27) — 리스트(주소 + 이름) → 메일은 [선택한 메일 보내기](본인 Gmail, 한 사람에 한 통), 인스타는 [DM 보내기](문구 복사 + DM 창)
|
||||
→ 보낸 뒤 [보냄]. 주소를 보고 메일/DM 을 정한다(store.detect). 본문 {이름} = 그 줄 이름. -#}
|
||||
{% block head_extra %}<link rel="stylesheet" href="/static/vendor/material-symbols/material-symbols.css" />
|
||||
<link rel="stylesheet" href="/static/outreach.css?v=20261030c" />{% endblock %}
|
||||
|
||||
{% block content %}
|
||||
<section class="otr" id="otr" data-needs-name="{{ '1' if needs_name else '' }}">
|
||||
{% include "outreach/_tabs.html" %}
|
||||
|
||||
<div class="otr-top">
|
||||
<div class="otr-top-main">
|
||||
<button type="button" class="erp-btn erp-btn-primary" id="otr-add-open">+ 리스트 추가</button>
|
||||
</div>
|
||||
<div class="otr-gmail">
|
||||
{% if gmail.connected %}
|
||||
<span class="otr-gmail-on">보내는 메일: <b>{{ gmail.email }}</b> (Gmail 연결됨)</span>
|
||||
<form method="post" action="/outreach/gmail/disconnect" onsubmit="return confirm('Gmail 연결을 끊을까요? 입출고·휴가 메일 연결도 함께 끊깁니다.');">
|
||||
<button type="submit" class="erp-btn erp-btn-outline erp-btn-sm">연결 끊기</button></form>
|
||||
{% elif gmail.available %}
|
||||
<span class="otr-gmail-off">메일은 내 Gmail 로 보냅니다 —</span>
|
||||
<a class="erp-btn erp-btn-primary erp-btn-sm" href="/outreach/gmail/connect">Gmail 연결</a>
|
||||
{% else %}
|
||||
<span class="otr-gmail-off">Gmail 연결을 쓸 수 없는 서버입니다(입출고 DB·구글 OAuth·APP_ENCRYPTION_KEY 필요) — 메일은 보낼 수 없고 DM 만 됩니다.</span>
|
||||
{% endif %}
|
||||
</div>
|
||||
</div>
|
||||
|
||||
{% if msg %}<p class="otr-msg" role="status">{{ msg }}</p>{% endif %}
|
||||
|
||||
<div class="erp-card otr-tpl">
|
||||
<div class="otr-tpl-head"><b>보낼 내용</b><span class="erp-muted">(설정에서 바꿉니다)</span></div>
|
||||
<div class="otr-tpl-subject">{% if template.ad_label %}(광고) {% endif %}{{ template.subject }}</div>
|
||||
<div class="otr-tpl-body">{{ body_text[:160] }}{% if body_text | length > 160 %}…{% endif %}</div>
|
||||
<div class="erp-muted otr-tpl-meta">보내는 이름 {{ template.sender_name or '—' }} · 본문 아래 사진 {{ images | length }}장 · <code>{이름}</code> = 줄마다 그 사람 이름</div>
|
||||
</div>
|
||||
|
||||
{#- 리스트 추가 — 붙여 넣기 → [미리보기](메일/DM/오류 판별) → [리스트에 추가] -#}
|
||||
<div class="erp-card otr-add" id="otr-add" hidden>
|
||||
<div class="otr-add-head"><b>리스트 추가</b>
|
||||
<span class="erp-muted">한 줄에 한 사람 — <code>주소, 이름</code> (쉼표·탭·띄어쓰기). 주소 = 이메일(<code>name@domain.com</code>) 또는
|
||||
인스타(<code>@계정</code> · <code>instagram.com/계정</code> · 계정명). 엑셀에서 두 칸을 복사해 붙여도 됩니다.</span></div>
|
||||
<textarea class="erp-input otr-add-text" id="otr-add-text" rows="6" placeholder="kim@miras.co.kr, 김철수 @mira.kitchen 미라네 https://www.instagram.com/lee_s/ 이수진"></textarea>
|
||||
<div class="otr-add-actions">
|
||||
<button type="button" class="erp-btn erp-btn-outline" id="otr-add-preview">미리보기</button>
|
||||
<button type="button" class="erp-btn erp-btn-primary" id="otr-add-save" disabled>리스트에 추가</button>
|
||||
<button type="button" class="erp-btn erp-btn-outline" id="otr-add-close">닫기</button>
|
||||
<span class="erp-muted" id="otr-add-sum"></span>
|
||||
</div>
|
||||
<div class="erp-table-wrap otr-add-preview" id="otr-add-result" hidden></div>
|
||||
</div>
|
||||
|
||||
<div class="erp-card otr-list">
|
||||
<div class="otr-filter" role="tablist" aria-label="보기">
|
||||
{% for key, label in (('all', '전체'), ('email', '메일'), ('instagram', 'DM'), ('대기', '대기'), ('보냄', '보냄'), ('실패', '실패')) %}
|
||||
<button type="button" class="otr-seg{% if key == 'all' %} is-active{% endif %}" data-filter="{{ key }}">{{ label }} <span class="otr-cnt" data-cnt="{{ key }}"></span></button>
|
||||
{% endfor %}
|
||||
</div>
|
||||
<div class="erp-table-wrap">
|
||||
<table class="erp-table otr-table">
|
||||
<thead><tr><th class="otr-c-check"><input type="checkbox" id="otr-check-all" aria-label="전체 고르기" /></th>
|
||||
<th>구분</th><th>이름</th><th>주소</th><th>상태</th><th>보낸 때</th><th class="otr-c-acts"></th></tr></thead>
|
||||
<tbody id="otr-tbody"></tbody>
|
||||
</table>
|
||||
</div>
|
||||
<p class="erp-muted otr-empty" id="otr-empty" hidden>리스트가 비었습니다 — [+ 리스트 추가]로 넣으세요.</p>
|
||||
<div class="otr-send-bar">
|
||||
<span id="otr-selected">고른 줄 0</span>
|
||||
<button type="button" class="erp-btn erp-btn-primary" id="otr-send"{% if not gmail.connected %} disabled title="Gmail 연결 뒤 보낼 수 있습니다"{% endif %}>고른 메일 보내기</button>
|
||||
<button type="button" class="erp-btn erp-btn-outline" id="otr-reset">고른 줄 다시 대기로</button>
|
||||
<button type="button" class="erp-btn erp-btn-outline otr-danger" id="otr-delete">고른 줄 지우기</button>
|
||||
<span class="erp-muted otr-send-note">메일 = 한 사람에 한 통(본인 Gmail, 1초 간격). DM = 줄의 [DM 보내기] → 문구가 복사되고 인스타 DM 창이 열리면 붙여 넣어 보낸 뒤 [보냄].</span>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
{% if logs %}
|
||||
<div class="erp-card otr-logs">
|
||||
<div class="otr-tpl-head"><b>최근 보낸 기록</b><span class="erp-muted">({{ logs | length }})</span></div>
|
||||
<ul>
|
||||
{% for l in logs %}
|
||||
<li class="{{ 'is-ok' if l.ok else 'is-fail' }}"><span class="otr-when">{{ l.sent_at[5:16] | replace('T', ' ') }}</span>
|
||||
<b>{{ '메일' if l.kind == 'email' else 'DM' }}</b> {{ l.name or '(이름 없음)' }} · {{ l.address }}
|
||||
<span class="erp-muted">— {{ l.sent_by }}{% if not l.ok %} · <span class="otr-err">{{ l.error }}</span>{% endif %}</span></li>
|
||||
{% endfor %}
|
||||
</ul>
|
||||
</div>
|
||||
{% endif %}
|
||||
</section>
|
||||
|
||||
{#- 미리보기 창 -#}
|
||||
<div class="otr-modal" id="otr-preview" hidden>
|
||||
<div class="otr-modal-card" role="dialog" aria-modal="true" aria-label="미리보기">
|
||||
<div class="otr-modal-head"><b id="otr-pv-title">미리보기</b><button type="button" class="erp-btn erp-btn-outline erp-btn-sm" data-close>닫기</button></div>
|
||||
<div class="otr-pv-subject" id="otr-pv-subject"></div>
|
||||
<iframe class="otr-pv-frame" id="otr-pv-frame" title="본문 미리보기" sandbox></iframe>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<script type="application/json" id="otr-data">{{ {"rows": rows} | tojson }}</script>
|
||||
{% endblock %}
|
||||
|
||||
{% block scripts %}<script src="/static/outreach.js?v=20261030c" defer></script>{% endblock %}
|
||||
@@ -0,0 +1,93 @@
|
||||
{% extends "erp_base.html" %}
|
||||
|
||||
{#- 안내문 발송 설정(2026-10-27) — 화면 세로 2단: 왼쪽 = 메일(제목·(광고)·보내는 이름·본문 서식 편집기·끝 문구·본문 아래 사진),
|
||||
오른쪽 = 인스타 DM(서식 없는 편집기, 비우면 메일 본문 글 + 끝 문구). 두 편집기 모두 {이름} = 빨강 굵게(화면에서만).
|
||||
편집기 = Quill(/static/vendor/quill). 입력 칸은 form="otr-set-form" 으로 위 막대의 저장 폼에 묶는다(사진 폼과 겹치지 않게). -#}
|
||||
{% block head_extra %}
|
||||
<link rel="stylesheet" href="/static/vendor/quill/quill.snow.css" />
|
||||
<link rel="stylesheet" href="/static/outreach.css?v=20261030c" />
|
||||
{% endblock %}
|
||||
|
||||
{% block content %}
|
||||
<section class="otr otr-settings">
|
||||
<form method="post" action="/outreach/settings" id="otr-set-form" class="otr-set-bar">
|
||||
<a class="erp-btn erp-btn-outline" href="/outreach/">◀ 리스트</a>
|
||||
<span class="erp-muted otr-set-saved">{% if template.is_default %}기본 문구(아직 저장 안 함){% else %}마지막 저장 {{ template.updated_by }} · {{ template.updated_at[:16] | replace('T', ' ') }}{% endif %}</span>
|
||||
<span class="otr-set-bar-gap"></span>
|
||||
<input type="hidden" name="fmt" value="html" />
|
||||
<input type="hidden" name="body" id="otr-body-input" />
|
||||
<input type="hidden" name="dm_body" id="otr-dm-input" />
|
||||
<button type="button" class="erp-btn erp-btn-outline" id="otr-default" title="칸만 바꿉니다 — [저장]을 눌러야 적용">기본 문구로 되돌리기</button>
|
||||
<button type="submit" class="erp-btn erp-btn-primary">저장</button>
|
||||
</form>
|
||||
{% if msg %}<p class="otr-msg" role="status">{{ msg }}</p>{% endif %}
|
||||
|
||||
<div class="otr-split">
|
||||
{#- 왼쪽 — 메일 -#}
|
||||
<div class="otr-col">
|
||||
<div class="erp-card otr-set-card">
|
||||
<div class="otr-col-head"><span class="otr-kind is-email">메일</span><b>이메일 안내문</b>
|
||||
<span class="erp-muted">[고른 메일 보내기]로 내 Gmail 에서 한 사람에 한 통씩</span></div>
|
||||
<label class="erp-field otr-field"><span>메일 제목</span>
|
||||
<input class="erp-input" type="text" name="subject" form="otr-set-form" maxlength="200" required value="{{ template.subject }}" /></label>
|
||||
<label class="otr-check"><input type="checkbox" name="ad_label" form="otr-set-form" value="1"{% if template.ad_label %} checked{% endif %} />
|
||||
<span>제목 앞에 <b>(광고)</b> 붙이기 <span class="erp-muted">— 영리 목적 광고성 메일은 정보통신망법 제50조에 따라 제목 앞 "(광고)"·수신 거부 방법을 적어야 합니다(법무 확인 권장)</span></span></label>
|
||||
<label class="erp-field otr-field"><span>보내는 이름</span>
|
||||
<input class="erp-input" type="text" name="sender_name" form="otr-set-form" maxlength="60" value="{{ template.sender_name }}" placeholder="받는 사람 메일함에 보이는 이름" /></label>
|
||||
<div class="erp-field otr-field"><span>본문 <small class="erp-muted"><code class="otr-tag">{이름}</code> = 그 사람 이름(빨강은 이 화면에서만 — 메일에는 이름이 본문 서식대로) · 되돌리기 Ctrl+Z</small></span>
|
||||
<div class="otr-editor" id="otr-body-editor"></div></div>
|
||||
<label class="erp-field otr-field"><span>끝 문구 <small class="erp-muted">(본문 맨 아래 — 수신 거부 안내 등, 비워도 됨)</small></span>
|
||||
<textarea class="erp-input" name="footer" form="otr-set-form" rows="2" maxlength="2000" placeholder="예: 더 이상 받기를 원하지 않으시면 이 메일에 '수신 거부'라고 회신해 주세요.">{{ template.footer }}</textarea></label>
|
||||
</div>
|
||||
|
||||
<div class="erp-card otr-set-card" id="images">
|
||||
<div class="otr-tpl-head"><b>본문 아래 사진</b><span class="erp-muted">메일 본문 맨 아래에 순서대로(최대 {{ max_images }}장, 가로 700px 로 줄여 저장). DM 에는 붙지 않습니다.</span></div>
|
||||
<div class="otr-images">
|
||||
{% for im in images %}
|
||||
<figure class="otr-image">
|
||||
<img src="/outreach/images/{{ im.id }}" alt="{{ im.filename }}" loading="lazy" />
|
||||
<figcaption>{{ loop.index }}. {{ im.filename }}</figcaption>
|
||||
<div class="otr-image-acts">
|
||||
{% if not loop.first %}<form method="post" action="/outreach/settings/images/{{ im.id }}/move"><input type="hidden" name="direction" value="-1" /><button class="erp-btn erp-btn-outline erp-btn-sm" title="앞으로">◀</button></form>{% endif %}
|
||||
{% if not loop.last %}<form method="post" action="/outreach/settings/images/{{ im.id }}/move"><input type="hidden" name="direction" value="1" /><button class="erp-btn erp-btn-outline erp-btn-sm" title="뒤로">▶</button></form>{% endif %}
|
||||
<form method="post" action="/outreach/settings/images/{{ im.id }}/delete" onsubmit="return confirm('이 사진을 뺄까요?');"><button class="erp-btn erp-btn-outline erp-btn-sm otr-danger">빼기</button></form>
|
||||
</div>
|
||||
</figure>
|
||||
{% else %}
|
||||
<p class="erp-muted">사진이 없습니다.</p>
|
||||
{% endfor %}
|
||||
</div>
|
||||
{% if images | length < max_images %}
|
||||
<form method="post" action="/outreach/settings/images" enctype="multipart/form-data" class="otr-upload">
|
||||
<input type="file" name="files" accept="image/jpeg,image/png,image/webp,image/gif" multiple required />
|
||||
<button type="submit" class="erp-btn erp-btn-primary">사진 넣기</button>
|
||||
</form>
|
||||
{% endif %}
|
||||
</div>
|
||||
</div>
|
||||
|
||||
{#- 오른쪽 — 인스타 DM -#}
|
||||
<div class="otr-col">
|
||||
<div class="erp-card otr-set-card otr-dm-card">
|
||||
<div class="otr-col-head"><span class="otr-kind is-instagram">DM</span><b>인스타 DM 문구</b>
|
||||
<span class="erp-muted">[DM 보내기]를 누르면 복사되는 글</span></div>
|
||||
<p class="erp-muted otr-note">인스타 DM 은 글자 서식·사진이 없어 글만 씁니다. <code class="otr-tag">{이름}</code> = 그 사람 이름.
|
||||
비워 두면 메일 본문 글 + 끝 문구가 그대로 복사됩니다.</p>
|
||||
<div class="otr-editor otr-editor-plain" id="otr-dm-editor"
|
||||
data-placeholder="예: 안녕하세요, {이름}님! 누적 800만 개 판매 미라클통 '미라네주방'입니다. {이름}님과 공동구매를 함께하고 싶어 연락드렸어요. 자세한 제안서는 메일로 보내드릴 수 있습니다 — 편하신 메일 주소 알려주시면 감사하겠습니다 :)"></div>
|
||||
<div class="otr-dm-foot">
|
||||
<button type="button" class="erp-btn erp-btn-outline erp-btn-sm" id="otr-dm-from-mail">메일 본문 글 가져오기</button>
|
||||
<small class="erp-muted otr-count" id="otr-dm-count" data-max="{{ dm_max }}"></small>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
</section>
|
||||
<script type="application/json" id="otr-default-data">{{ default | tojson }}</script>
|
||||
<script type="application/json" id="otr-current-data">{{ {"body": template.body, "dm_body": template.dm_body} | tojson }}</script>
|
||||
{% endblock %}
|
||||
|
||||
{% block scripts %}
|
||||
<script src="/static/vendor/quill/quill.js"></script>
|
||||
<script src="/static/outreach.js?v=20261030c" defer></script>
|
||||
{% endblock %}
|
||||
@@ -0,0 +1,145 @@
|
||||
# [실적] 실적 모듈 — `app/modules/performance/`, `performance_db`
|
||||
|
||||
> 이 모듈만 고칠 때 읽는 요약. 상세는 `docs/PERFORMANCE_MODULE.md`(큰 문서 — `grep -n '^#'` 로 목차 보고 필요한 절만 읽기).
|
||||
> 정적 파일: `app/static/performance.css`, `performance.js`. 템플릿: `templates/`. 테스트: `tests/`.
|
||||
> 다른 모듈과 연결: 카페24 어댑터는 `app/integrations/cafe24` 토큰 재사용 · Project 주간 회의록 머리 카드가 `performance_store` 매출을 읽기 전용으로 씀 · `APP_ENCRYPTION_KEY` 는 입출고(Gmail 토큰)와 공유.
|
||||
|
||||
## 구조 (네 영역 분리)
|
||||
|
||||
1. 수집 — `adapters/`(쇼핑몰 하나 = 어댑터 파일 하나 + `registry.py` 한 줄 + SQL seed 한 줄) + `sync.py`(공통 동기화, 같은 쇼핑몰 동시 실행 차단, 쇼핑몰별 실패 격리).
|
||||
2. 보안 — `security/`(AES-256-GCM, 키 버전, 비밀값 가리기) + `credentials.py`.
|
||||
3. 계산 — `calc.py`(주 = 월~일, 수수료 반올림은 `commission()` 한 곳, 요율 이력) + `db.py`.
|
||||
4. 화면 — `dashboard.py`/`router.py`/템플릿.
|
||||
|
||||
## 규칙
|
||||
|
||||
- 쇼핑몰 API 인증정보는 `.env` 가 아니라 **설정 화면에서 입력 → 마스터 키 `APP_ENCRYPTION_KEY` 로 암호화해 DB 저장**, secret 원문은 화면으로 다시 보내지 않는다.
|
||||
- 쇼핑몰 API 는 백엔드에서만 호출, 오류·로그·raw 는 `redact` 후 저장.
|
||||
- 매출 기준일: 결제 = 결제일, 취소·반품 = 발생일(`sync.sales_date_for`). 금액은 원 단위 정수.
|
||||
- 권한키 `performance`. 설정 화면은 모듈 권한자 누구나(일반 사용자는 수수료율만), 수수료 외 설정 API 는 `is_admin`.
|
||||
- 1단계는 모의 데이터(`is_sample`)·구조까지, 실제 수집은 쇼핑몰별로 공식 문서 확인 후 순차 구현.
|
||||
- 쇼핑몰 화면 수치와 맞출 때는 필드 추측 말고 붙여넣기 비교 + 원본 필드 합계로 진단부터.
|
||||
|
||||
## 카페24 적립금 · 네이버 배송비·환불 (2026-10-19 규칙 변경)
|
||||
|
||||
- **카페24** 매출 = 결제합계 − 적립금 사용, 환불 = 실제 + 예치금(적립금 환불 제외). raw `points`. 주문 내역 창 **적립금 사용** 칸·합계.
|
||||
- **네이버** 매출 = 판매금액(총) + 배송비(raw `goods`·`ship` — 배송 묶음마다 `deliveryFeeAmount` 한 번, 할인 안 뺌 = 판매분석 배송비, 10/18 87,500 확인), 환불 = 클레임 완료일(`CLAIM_COMPLETED_DATETIME`) 조회의 취소·반품 완료 상품주문 −결제금액(`naver:{상품주문}-RF`, raw `refund`). 주문 내역 창 **판매금액**(배송비 뺀 raw `goods` — 저장 금액은 판매금액+배송비)·**배송비·환불금액** 칸·합계 + 맨 아래 "그날 매출 = 판매금액 + 배송비 − 환불".
|
||||
- 예전 규칙으로 받은 날은 [과거 매출 가져오기]로 다시 받아야 바뀜(최근 10일은 자동). 사용자 확인값 10/18: 카페24 적립금 16,820 · 네이버 배송비 87,500 · 환불 66,100 — 배포 뒤 대조.
|
||||
|
||||
## 매출 업데이트
|
||||
|
||||
- 진행 창에서 쇼핑몰별 [중지](그 쇼핑몰만 멈추고 다음 쇼핑몰로).
|
||||
- **업데이트 중에도 [매출 업데이트] 누르기 가능**(2026-10-19) — 버튼이 "업데이트 중 · 진행 보기"로 바뀌고, 누르면 `GET /api/sync/current` 의 진행 중 작업(수동·자동)을 새로 시작하지 않고 진행 창으로 다시 연다.
|
||||
- 서버 시작 때 남은 `perf_sync_runs` running 행은 `abandon_running_runs` 로 "중단됨(서버 재시작)" 정리(앱은 프로세스 하나 — 진행 작업은 메모리에만). 예전엔 30분(`STALE_RUN_AFTER`) 동안 버튼이 '업데이트 중'으로 막히고 그 쇼핑몰이 '이미 진행 중'으로 건너뛰어졌다.
|
||||
- **자동 업데이트**(`auto_sync.py`, 웹 프로세스 데몬 스레드) — 오늘 포함 최근 10일, 진행 창 작업으로 돌고 다른 업데이트 중이면 그 회차 건너뜀. env `PERFORMANCE_AUTO_SYNC`(끄기)·`_DAYS`·`_HOURS`(일정 저장 전 기본 시간대).
|
||||
- **일정 = 실적 설정 "자동 업데이트" 카드**(2026-10-26, 관리자, 마이그레이션 011 `perf_settings` key `auto_sync`) — 매출 실적·광고비 **따로**:
|
||||
사용·요일(0=월…6=일, [매일]·[평일])·시작/끝 시각(5분 단위)·간격(5~720분, 5분 단위, 기본 30). 회차 = 고른 요일의 시작, 시작+간격, … 끝까지(끝과 맞으면 끝도).
|
||||
`PUT /api/auto-sync-schedule {sales, ads}`(`auto_sync.validate_schedule`, 011 미적용 503). 스레드(`auto_sync.Scheduler`)가 1분마다 일정을 다시 읽어
|
||||
바뀐 종류만 지금부터 다시 계산, 종류마다 따로 스레드(`run_once(kinds=(kind,))`). 저장 값 없음·011 미적용 = 기본(매일 9~19시 30분마다).
|
||||
- 쿠팡은 판매자배송 발주서 + 로켓그로스 주문을 결제일로 합산(WING 판매분석 대조는 원본 데이터 확인으로).
|
||||
|
||||
## 수동 입력
|
||||
|
||||
- 설정의 쇼핑몰별 **수동 입력** 토글(마이그레이션 002 `manual_input`·`perf_manual_sales`) — 켜면 일자별 표 날짜 칸에 총매출 직접 입력, 넣은 날은 API 값 대신(`daily_amounts` 한 곳).
|
||||
수동 입력 켠 쇼핑몰은 **API 가 설정돼 있어도 매출 업데이트(수동·자동·과거 매출 가져오기)에서 빠진다**(2026-10-21, `sync.sync_all` 대상 고르기 한 곳) — 예전에 받은 API 값은 그대로 남음.
|
||||
- 일자별 표 [엑셀 업로드] 팝업(`manual_upload.py`, `POST /performance/api/manual-sales/upload`) — 1열 날짜·2열부터 쇼핑몰 이름 머리글, 수동 입력 켜진 쇼핑몰 열의 값 있는 칸만 반영(덮어씀, 빈 칸 그대로), 잘못된 칸이 하나라도 있으면 전부 저장 안 함, 샘플 = 모듈 폴더 `upload_sample.xlsx`.
|
||||
- **앞으로의 날짜도 입력·업로드 가능**(2026-10-21) — 매출 수동 입력·광고비 날짜 칸, 매출 엑셀 업로드, 광고 보고서 업로드 모두(가져오기 API 는 여전히 오늘까지).
|
||||
- **계산식 입력**(2026-10-21, `formula.py` `parse_amount`, 마이그레이션 008 `formula` 열) — 매출·광고비 날짜 칸에 = 없이 `1000+2000`(+ - * / 괄호, ×·÷)을 넣으면
|
||||
서버가 계산(원 반올림)해 금액으로, 식은 `formula` 열에 저장 → 칸 `is-formula` 파랑 굵은 숫자, 다시 누르면 식. 숫자 입력·업로드·광고 API 로 덮으면 식 지움(`db._set_formulas`, 008 미적용이면 조용히 건너뜀).
|
||||
광고비 탭 직접 입력값은 파랑 **보통 굵기**(굵게는 계산식만), 매출 탭 수동 입력값은 예전처럼 파랑 굵게.
|
||||
- 일자별 표 **기간 합계 행은 맨 위**(제목 행 바로 아래, 2026-10-21 `calc.main_table`) — 매출·광고비 공통, 연간 보기 "연간 합계"는 그대로 맨 아래.
|
||||
- **기간 빠른 선택 = 이번달·올해·직접선택**(2026-10-26 — 오늘·이번주 버튼 삭제, `dashboard.build_dashboard`·`ad_spend.build_ad_dashboard` 의 `nav.quick`),
|
||||
매출 실적 기본 기간도 **이번달**(`router.dashboard_page` `period="month"`, 광고비는 원래 이번달). day·week 주소(`?period=week`)는 그대로 열린다.
|
||||
- **일자별 표 스크롤 고정**(2026-10-26, **10-27 다시** `.perf-main-wrap`) — 페이지(`.erp-page`)를 스크롤해도 제목 행 + 맨 위 기간 합계 행
|
||||
(`tbody tr.perf-row-total:first-child`)이 화면 위에 붙어 있다. 표 상자는 가로 스크롤 상자라 CSS sticky 가 페이지 스크롤에 안 먹어서
|
||||
`performance.js stickyHead` 가 스크롤(capture)·창 크기·표 크기마다 두 줄 칸을 `translateY` 로 내린다(표 끝에서 멈춤, 내려온 동안 `is-stuck` →
|
||||
제목 칸 `::after` 가 아래 1px 선 — 표 칸 선(border-collapse)은 안 움직여 틈이 비쳤다). **표 상자 세로 스크롤 금지** — 10-26 판은 상자를 화면 높이로
|
||||
묶어 상자 안에서 스크롤했는데, 진짜 셸에서는 상자 아래가 화면 밖에 잘리고(`overscroll-behavior: contain`) 휠이 페이지로 안 넘어갔다.
|
||||
스크롤 막대 배경(트랙) 투명 = `scrollbar-color: #c3c6cb transparent`(표 상자·실적 화면 `.erp-page`). 테스트 `tests/js/perf_sticky.browser.test.js`
|
||||
(진짜 `erp_base.html` 셸 렌더 `perf_*_shell.html` 로 휠 스크롤 — 스텁 셸로는 이 문제가 안 보였다).
|
||||
- **새로고침해도 스크롤 유지**(2026-11-02) — 수기 입력을 마치면 합계를 다시 계산하려고 새로고침하는데, 세로 스크롤은 `.erp-page` 상자라 브라우저가 복원하지 않아 맨 위로 돌아갔다.
|
||||
`performance.js keepScroll` 이 떠날 때 세로·가로 위치를 sessionStorage `perf_scroll` 에 저장 → **새로고침일 때만** 복원(같은 주소, 메뉴·기간 이동은 맨 위부터). 자동 새로 고침·업로드 뒤 새로고침도 같음.
|
||||
- 열 순서 카페24·네이버·쿠팡(윙)·쿠팡(로켓)·오늘의집·G마켓·카카오·GS샵·11번가·롯데ON·토스·애터미아자몰(마이그레이션 003).
|
||||
- 쿠팡(로켓)·애터미아자몰은 **수동 입력 전용**(`adapters/manual.py`, `manual_only` — 매출 업데이트에서 빠지고 인증 설정·연결 테스트 없음, 수동 입력 늘 켜짐).
|
||||
- **직접 추가 쇼핑몰·그룹·순서 드래그**(2026-10-22, 마이그레이션 009 `is_custom`·`is_group`·`parent_code`) — 설정 [+ 쇼핑몰 추가(수동 입력)]
|
||||
(코드 `custom_…`, `get_adapter` 가 `CustomManualAdapter` = 수동 입력 전용)·[+ 그룹 추가](`group_…`, 매출 없음·`include_in_sales` 꺼짐),
|
||||
직접 추가 쇼핑몰만 그룹 select 로 묶음, 이름 변경·삭제(삭제 = 그 쇼핑몰 수동 입력·수수료도). 매출 실적 표 그룹 열 = 보이는 하위 합계(일 합계엔 안 더함),
|
||||
▾/▸ 하위 열 접기(localStorage). ⠿ 드래그 → `PUT /api/marketplace-order` → `sort_order`, 화면 순서는 `dashboard.ordered_marketplaces`
|
||||
(그룹 바로 뒤 하위) 한 곳. 상세 `docs/PERFORMANCE_MODULE.md` "직접 추가 쇼핑몰·그룹".
|
||||
- **카페24(전체)·카페24(실적) 열**(2026-11-02, 예전 "공구 제외") — 카페24 열 이름 = 카페24(전체)(`_short_name`), 바로 오른쪽 카페24(실적) = 카페24 − 직접 추가 쇼핑몰 "자사몰(공동구매)"("카페24 공동구매"도, 이름으로 찾음·띄어쓰기 무시 — 없으면 전체 그대로, 쇼핑몰 필터·숨김과 무관하게 뺌).
|
||||
광고비 줄은 카페24(전체)와 같은 구글·메타(`dashboard._cafe24_real_column`, kind `diff`, 표 열만 — 일 합계엔 안 더함, 클릭·메모 없음). 공동구매 칸을 저장하면 그 줄 칸이 바로 바뀜(`performance.js saveManual`, td `data-diff-minus`·`data-base`), 합계 줄은 입력 마친 뒤 새로고침 때. 상세 `docs/PERFORMANCE_MODULE.md` "직접 추가 쇼핑몰·그룹".
|
||||
- **합계 기준**(2026-11-02) — 일 합계 = 카페24(실적) + 공동구매 + 나머지 쇼핑몰(카페24(전체)는 안 더함 — 공동구매가 들어 있어 중복). 일 합계·ROAS·KPI·추이·비중·월/연 누적 모두 `dashboard._summary_cells`(카페24 칸 = 실적, 그래프·누적의 카페24 줄 이름도 `summary_names` = 카페24(실적)), 표의 카페24(전체) 열만 원래 값. 광고비 탭 매출 대비 광고비·합계 ROAS = `total_sales_codes`(카페24 있으면 공동구매 코드 뺌, 같은 금액). **프로젝트 회의록 머리 카드는 아직 예전 합계**(`project/router.py` `total` — 공동구매 중복).
|
||||
- **매출 실적 표 열 숨기기**(2026-11-02) — 실적 설정 "공통 보기 설정" 카드(관리자만, `PUT /api/hidden-marketplaces`, `perf_settings` key `hidden_marketplaces`, 011 미적용 503) → **모든 사용자에게 적용**. **열만** 숨김(`dashboard.load_hidden`) — 일 합계·KPI·그래프·누적은 그대로, 그룹 열 = 보이는 하위 합계(다 숨기면 그룹 열도 없음). 쇼핑몰 필터(합계까지 바뀜)와 다름. 광고비 탭은 적용 안 함.
|
||||
- **일 합계 열 위치**(2026-11-02) — 매출 실적·광고비 표 모두 날짜 바로 오른쪽, 날짜 열과 함께 가로 고정(왼쪽 위치 `--perf-label-w` = 날짜 열 너비, `performance.js stickyHead`).
|
||||
- **기간 이동**(2026-11-02, `_period_nav.html` 공통) — 날짜 바로 좌우 화살표 SVG(글자 높이, 진한 회색), 글자 버튼 없음.
|
||||
- **매출 실적 표 모양(2026-10-22)** — `table.perf-autofit`(매출 탭만, 모든 기간 같음): 표가 100% 로 늘지 않고 **열 너비 = 내용 길이**, 날짜 열은 고정 210px 대신 자동 +
|
||||
**가로 스크롤해도 고정**(sticky left, 오른쪽 그림자). 그룹 열 = 진한 보라 머리·왼쪽 묶음 선, 하위 열 = 옅은 보라 머리(위 띠)·옅은 칸, 마지막 하위(`is-glast`, 접히면 그룹 열 `is-gclosed`) = 오른쪽 선.
|
||||
접기 단추 = 22px ⊟/⊞(SVG, 세로 막대가 돌아 바뀜). 접기·펴기 애니메이션 = 하위 칸 내용 `.perf-gc` 너비·칸 여백·투명도 260ms(`setGroup(code, fold, animate)`,
|
||||
끝나면 `is-gfolded` display:none, 빠르게 연속 클릭은 `groupRun` 번호로 마지막만, 움직임 줄이기면 바로).
|
||||
|
||||
## 매출 실적 화면 (2026-10-19)
|
||||
|
||||
- KPI 는 **수수료 차감 매출 하나만** 화면 왼쪽 한 줄(`.perf-kpi-line` — 금액 + 비교 기간 대비 %, 모든 기간 공통). 총매출·수수료·월/연 누적 카드는 뺐다.
|
||||
- 일자별 표 기본 보기 = **수수료 차감 매출**(라우터 기본 `metric=net`, 예전에 고른 보기 localStorage 는 안 씀).
|
||||
- 마지막 업데이트 옆 **다음 업데이트까지 남은 시간** 초 단위 실시간(`router._auto_sync_ctx(store, kind)` — 매출 탭 = 매출 일정, 광고비 탭 = 광고비 일정 → `performance.js initNextUpdate`·`nextScheduleSlot`, `auto_sync.next_slot` 과 같은 규칙으로 화면이 다음 회차 계산, 서버 시각으로 PC 시계 보정, 자동 업데이트(env·그 종류 일정) 꺼지면 숨김).
|
||||
- **화면 자동 새로 고침**(2026-10-26) — 자동 업데이트(다른 사람이 누른 업데이트 포함)가 끝나면 매출 실적·광고비 화면이 20초 안에 reload.
|
||||
화면 데이터 `update_watch`(`router._update_watch` = 그린 때 마지막으로 끝난 작업 id, 보는 사람 것 제외) ↔ `GET /api/update-status?kind=sales|ads`
|
||||
(`jobs.last_finished` — 메모리 작업만, DB 안 읽음). 도는 중이면 끝날 때까지, 칸 입력·창(`.perf-modal`)·메뉴·확인 창이 열려 있으면 닫힐 때까지 기다림
|
||||
(마지막 업데이트 옆 안내), 탭이 안 보이면 안 묻고 다시 보이면 바로. 보는 사람이 직접 누른 업데이트는 진행 창이 새로 그린다. `performance.js initUpdateWatch`.
|
||||
|
||||
- 일자별 표 매출 칸 아래 **광고비(ROAS%)** 주황 줄(`--perf-ad`, `dashboard._ad_lines`) — 광고비 탭과 같은 값(`ad_spend.channel_roas`). 쇼핑몰 → 광고 채널은 `dashboard.sales_ad_channels`: 카페24 = 구글·메타 두 줄(이름 붙임), 네이버 = 네이버, 나머지는 `ROAS_SALES_CODE`(쿠팡 ← 쿠팡(윙)). 일 합계 = 보이는 쇼핑몰 광고비 합, ROAS = **일 합계 금액 ÷ 일 합계 광고비**(2026-10-19 — 예전엔 광고비 있는 쇼핑몰 매출만 더했다; `roas` 총매출·`roas_net` 수수료 차감 매출 기준, 보기 기준에 따라 하나만). 광고비 표 없으면 줄 없음.
|
||||
- **열 접기**(2026-11-06) — 매출 실적·광고비 일자별 표 머리글 위 작은 화살표 버튼(`.perf-cfold`, `performance.js initColFold`)으로 열 하나씩 접기/펴기(날짜 열 빼고, 일 합계·그룹 열 포함).
|
||||
접은 열 = 26px 띠(`is-cfold`, 칸 내용 숨김·클릭/메모 안 됨, 너비는 JS `CFOLD_W` 와 CSS 같게, 수동 열 너비 표도 같음). **로그인한 사람 본인에게만** —
|
||||
`PUT /api/my-col-fold {kind: sales|ads, cols}` → `perf_settings` key `col_fold:<이메일 sha1>`(key 64자 제한) = `{sales, ads}`, 화면은 표 `data-col-fold`(라우터 `_load_col_fold`). 011 미적용이면 다 펼침·저장 503.
|
||||
버튼 위 말풍선 = 커서 바로 위를 따라다니는 `.perf-cfold-tip`(열 이름, 12px 굵게 = 제목 글자), 버튼 `title=""` 로 머리글 기본 말풍선 막음.
|
||||
그룹 하위 열 접기(⊟, localStorage)와는 별개. 테스트 `tests/js/perf_colfold.browser.test.js`, `test_custom_groups.py::test_api_my_col_fold_per_user`.
|
||||
- **표 열 너비 자동/수동**(2026-10-27) — 설정 "보기 설정" **표 열 너비** [자동(글자 길이)]·[수동 조절](누구나, 이 브라우저 쿠키 `perf_colw`, `router._colw_ctx` → 템플릿 `colw`).
|
||||
수동 = 매출 실적·광고비 일자별 표에 `perf-colw-manual` → `performance.js initColWidths` 가 자동 너비를 잰 뒤 `table-layout:fixed`(`is-colw-fixed`, 넘치는 글자 …),
|
||||
머리글 오른쪽 경계 `.perf-colw-grip` 드래그(최소 36px)·두 번 누르면 그 열만 자동. **날짜 열(`label`)은 조절 불가 — 늘 자동 너비, 손잡이 없음, 저장값 무시**. 너비 = localStorage `perf_colw_sales`/`perf_colw_ads`(th `data-col` = 쇼핑몰·채널 코드·`label`·`total`)에 계속 유지,
|
||||
설정 [조절한 너비 초기화]가 둘 다 지움. 그룹 접기·펴기 때 열 너비도 함께 움직임(`colw.animate/settle`). 테스트 `tests/js/perf_colw.browser.test.js`.
|
||||
- **매출 단위** 원·천원·백만원(2026-11-02 모든 사용자 공통) — 설정 "공통 보기 설정"(관리자, `PUT /api/display-unit`, `perf_settings` key `display_unit`, 저장 값 없음·011 미적용 = 원, 예전 쿠키 `perf_unit` 은 안 봄), 서버가 `amount_text`(천원 정수·백만원 소수 한 자리)로 그림(`router._unit_ctx` → 템플릿 `amt`). 광고비 탭은 원 그대로. 표 열 너비는 사람(브라우저)마다 그대로.
|
||||
- 설정의 진단 카드(쇼핑몰 원본 데이터 확인·카페24 매출 대조·일별 한 번에 비교)는 2026-10-19 화면에서 뺐다(서버 API `marketplaces/{code}/reconcile`·`daily-check` 는 진단용으로 남김).
|
||||
|
||||
## 날짜 칸 메모 (2026-10-22, 마이그레이션 010 `perf_cell_memos`)
|
||||
|
||||
- 매출 실적·광고비 일자별 표의 **쇼핑몰(광고 채널) 날짜 칸 전부**(`td[data-memo-code]` — 매출 탭은 수동 입력 칸 + API 쇼핑몰 칸, 같은 날 넓힘; 그룹 열·주간합계·합계 줄은 아님)
|
||||
우클릭 → [메모 삽입] / [메모 수정]·[메모 삭제](`.perf-ctx` 메뉴, 창에서 입력, Ctrl+Enter 저장). 왼쪽 클릭은 그대로(입력 칸 = 금액 입력, API 칸 = 주문 내역).
|
||||
`PUT /performance/api/cell-memos/{kind}/{코드}/{날짜}` (kind = `sales` 쇼핑몰 / `ad` 광고 채널, 빈 메모 = 지움, 1,000자), 모듈 권한자 누구나.
|
||||
- 메모 있는 칸 = 오른쪽 위 빨간 삼각형(`has-memo`, 엑셀 메모처럼), 마우스 올리면 노란 메모 상자(`.perf-memo-tip`). 금액과 따로 저장(금액 지워도 남음).
|
||||
화면 데이터 `memo_cells`("날짜|코드" → 메모, `db.cell_memos`), 010 미적용이면 표시 없음·저장만 503. 표를 스크롤하면 열린 메뉴는 닫힌다.
|
||||
- 테스트 `test_cell_memos.py`, `tests/js/perf_memo_ads.browser.test.js`.
|
||||
- **표 몸통 칸에는 풍선 도움말(title) 없음**(2026-10-22 사용자 요청) — 입력 칸·날짜 칸(공휴일은 칸 안 글자)·광고비 줄 모두. 열 머리글 말풍선은 그대로.
|
||||
새 칸 기능에 title 을 다시 달지 말 것(설명은 표 아래 안내 문구에).
|
||||
|
||||
## 틱톡 (`/performance/tiktok`, 2026-11-05, 마이그레이션 없음)
|
||||
|
||||
- 광고비 탭 틀(기간 이동·KPI·표·그래프·연 누적), 표 열 = ROAS·광고비·매출. 값은 광고 API 만(읽기 전용, 칸 입력·메모 없음). 화면 데이터 `ad_spend.build_tiktok_dashboard`.
|
||||
- **틱톡 탭에서만 보임** — 채널 코드 `tiktok` 은 `ad_sources` 에는 있지만 `ad_spend.CHANNELS` 에는 넣지 않는다(넣으면 광고비 탭 합계에 들어감). 쇼핑몰 표(`perf_marketplaces`)에도 없어 매출 실적 합계·열과 무관. 저장은 다른 광고 API 처럼 `perf_ad_spend`(`source='api'`), 매출 = `metrics["매출"]`.
|
||||
- 설정 = 실적 설정 **광고 API 연동** 카드 → 틱톡 — 광고 계정 ID·장기 액세스 토큰·틱톡샵 ID(선택). [광고비 업데이트]·광고비 자동 업데이트에 함께 돈다.
|
||||
- `ad_sources/tiktok_ads.py` — `report/integrated/get`(30일씩), 매출 = 웹 구매금액 + 틱톡샵 매출, 틱톡샵 ID 가 있으면 `gmv_max/report/get` 비용·매출도 더함(항목별 값은 metrics 에 따로 저장). 외화 계정은 그날 환율로 원화(`fx`). ROAS = 매출 ÷ 광고비.
|
||||
**실제 토큰 대조 전**(2026-11-05) — 공식 문서를 읽지 못해 지표 이름은 이차 자료로 확인. 일반 보고서에 GMV Max 가 이미 들어 있으면 틱톡샵 ID 를 넣었을 때 중복되므로, 처음 쓸 때 광고 관리자 화면과 대조할 것.
|
||||
|
||||
## 광고비 (`/performance/ads`)
|
||||
|
||||
- 탭은 [매출 실적]·[광고비]·[틱톡] + 맨 오른쪽 설정 톱니.
|
||||
- **표 모양(2026-10-22)** — 매출 실적 표와 같은 `perf-autofit`(열 너비 = 내용 길이, 날짜 열 가로 스크롤 고정).
|
||||
- **기타광고비** 열(`etc`, 애터미아자몰 오른쪽, 2026-10-22) — 쇼핑몰에 딸리지 않은 광고비 직접 입력. 매출 쇼핑몰이 없어(`ad_spend.NO_SALES`) ROAS 없음·매출 탭 광고비 줄에 안 나옴, 광고비 합계·매출 대비 광고비에는 들어감.
|
||||
- `ad_spend.py`, 마이그레이션 005 `perf_ad_spend`. 구글·메타·네이버·쿠팡(윙)·쿠팡(로켓)·오늘의집·G마켓·카카오·GS샵·11번가·롯데ON·토스·애터미아자몰 일 광고비를 연·월·일로.
|
||||
- 칸 = "광고비(ROAS%)"(ROAS = 그 쇼핑몰 매출 ÷ 광고비). 구글·메타·네이버는 계산 안 함 — 광고 보고서 ROAS(마이그레이션 006 `roas`·`metrics`).
|
||||
- 날짜 칸 직접 입력 + 쿠팡(윙)·쿠팡(로켓)·네이버 광고 보고서 업로드.
|
||||
- 쿠팡: 1열 날짜·19열 청구금액(+부가가치세).
|
||||
- 네이버: 3열 기간·4열 총비용·12열 ROAS(구매완료 광고수익률(%)), 머리글 클릭 = 일자별 보고서 항목.
|
||||
총비용·광고수익률은 **머리글 이름으로 찾음**(열 구성 바뀐 보고서 — 고정 12열이 비어 ROAS 누락됐던 문제, 2026-10-20). 광고수익률 칸이 없거나 비면 구매완료 전환매출액 ÷ 총비용. 저장된 `roas` 가 빈 예전 행은 `db.ad_roas` 가 metrics 에서 다시 구함(`ad_spend.roas_from_metrics`).
|
||||
- 일자별 보고서 창: ROAS 열은 **광고비 열 바로 오른쪽**, 네이버 "구매완료 광고수익률(%)" 머리글은 "ROAS(%)"로 표기(`ad_spend._roas_next_to_spend` → `labels`, 저장 키는 파일 머리글 그대로 — 예전 업로드도 그대로 적용).
|
||||
- KPI 는 **한 줄**(2026-10-30, 매출 실적처럼 `.perf-kpi-line` — 항목 `.perf-kpi-item` 을 세로 선으로 나눔, 좁은 화면은 한 항목씩): 광고비(전 기간 대비) · 매출 대비 광고비 · 연 누적 광고비. 월 누적 광고비 카드는 뺐다.
|
||||
- 광고 API 연동(마이그레이션 007 `perf_ad_credentials`·`perf_ad_source_status`) — 실적 설정 **광고 API 연동** 카드, 쇼핑몰과 같은 마스터 키로 암호화(AAD `perf:ad:…`), `ad_sources/`(채널 하나 = 파일 하나) + `ad_sync.py`, 광고비 자동 업데이트 일정(실적 설정 "자동 업데이트")대로.
|
||||
- **[광고비 업데이트]**(2026-10-20, 예전 채널별 [구글/메타 광고 불러오기] 버튼 삭제) — 광고비 탭 오른쪽 위, 매출 탭과 같은 모양:
|
||||
마지막 업데이트(광고 API 마지막 성공 가져오기 `ad_sync.last_ad_update_at`) · 다음 업데이트까지(광고비 일정 카운트다운) · 버튼.
|
||||
설정된 광고 API 전부를 진행 창 작업으로(`POST /api/ad-sync` → `jobs` kind="ads", 채널별 막대 수집 50% → 저장 → 완료, 채널별 [중지]·[업데이트 취소]는
|
||||
저장 직전까지, 진행·취소·중지 API 는 매출과 같은 `/api/sync/jobs/…`). 진행 중이면 새로 시작 안 하고 합류(`GET /api/ad-sync/current`, 매출 업데이트와 별개).
|
||||
자동 업데이트(`auto_sync.run_once`)는 매출·광고비를 각자 일정대로 각각 진행 창 작업으로(같은 시각이면 동시에), 이미 돌고 있는 종류는 그 회차 건너뜀. 결과는 `perf_ad_spend` `source='api'`(초록 숫자, API 가 안 준 날은 예전 API 값만 지움).
|
||||
- **구글 = Google Ads API**(2026-10-15) — 고객 ID·(MCC)·서비스 계정 JSON·API 버전(기본 v26). 개발자 토큰은 2026-09-09 구글 폐지 — 접근 등급은 서비스 계정의 Cloud 프로젝트, 머리글 안 보냄. [광고비 업데이트]·자동 업데이트. 광고비 = 비용 × 1.1(부가세 포함)·ROAS(전환 가치 ÷ 비용, 구글 값 그대로)·항목.
|
||||
- **메타 = 메타 마케팅 API**(2026-10-16, `ad_sources/meta_ads.py`, 새 마이그레이션 없음) — 광고 계정 ID(여러 개, 날짜별 합산)·액세스 토큰(ads_read, 시스템 사용자 토큰 권장)·앱 시크릿(선택)·API 버전(기본 v26.0). 광고비 = 지출 금액 그대로(메타는 이미 부가세 포함 — × 1.1 은 구글만)·ROAS = 구매 전환값 ÷ 지출 금액(광고 관리자 구매 ROAS). USD 등 외화 계정은 그날 환율로 원화 환산(`fx.py`, Frankfurter 중앙은행 고시 환율 종합, 키 없음). 상세보기 [합계 | 계정별] 탭, [광고비 업데이트]·자동 업데이트 회차.
|
||||
**기간으로 물으면 메타가 지출·노출·클릭을 0 으로 주는 문제**(2026-10-21 운영 확인, v26.0 — 링크 클릭·구매는 정상, 하루만 물으면 정상) →
|
||||
"지출·노출 0 인데 링크 클릭·구매가 있는" 날만 하루씩 다시 물어 바꾼다(`meta_ads._refetch_suspect_days`). 원본 진단: `scripts/meta_insights_raw.py`
|
||||
(`docker exec -i dbx-main python - 시작일 [종료일] < scripts/meta_insights_raw.py`, 읽기 전용).
|
||||
@@ -16,6 +16,12 @@ from typing import Any
|
||||
from ..adapters.base import AdapterContext, CredentialField, NotConfigured
|
||||
|
||||
|
||||
# AdDay.metrics 안의 계정별 값(여러 광고 계정을 합치는 채널 — 메타, 2026-10-16):
|
||||
# {ACCOUNTS_KEY: {계정 ID: {"name", "amount", "roas", "metrics"}}} — 상세보기 [합계 | 계정…] 탭(ad_spend.detail_tabs).
|
||||
# "_" 로 시작하는 metrics 키는 일자별 표 열·합계에 넣지 않는다(ad_spend.detail_table).
|
||||
ACCOUNTS_KEY = "_accounts"
|
||||
|
||||
|
||||
@dataclass
|
||||
class AdDay:
|
||||
"""광고 API 가 돌려준 하루치 — 금액은 원 단위 정수, ROAS 는 %(없으면 None), 나머지 항목은 화면 이름 그대로."""
|
||||
|
||||
@@ -0,0 +1,414 @@
|
||||
"""메타 광고(Meta Marketing API — Insights) — 날짜별 광고비·ROAS·보고서 항목.
|
||||
|
||||
인증(2026-10-16 사용자: 토큰·광고 계정 ID 준비 완료)
|
||||
- 액세스 토큰 하나(시스템 사용자 토큰 권장 — 만료 없음. 사용자 토큰은 약 60일 뒤 만료) + 광고 계정 ID 여러 개.
|
||||
토큰에 ads_read 권한이 있어야 하고, 토큰 주인(시스템 사용자 등)이 각 광고 계정에 배정돼 있어야 한다.
|
||||
- 메타 문서대로 토큰은 access_token 매개변수로 보낸다. 앱 설정에서 "앱 시크릿 필요"를 켰다면 앱 시크릿을 넣어
|
||||
appsecret_proof(HMAC-SHA256)를 같이 보낸다. 토큰은 오류 문구에 넣지 않고(주소도 넣지 않음),
|
||||
ad_sync 가 저장된 비밀값을 다시 한 번 가린다. httpx 요청 로그(INFO)는 주소에 토큰이 들어가므로 켜지 않는다.
|
||||
|
||||
조회(GET /{버전}/act_{계정}/insights)
|
||||
level=account · time_increment=1(하루씩) · time_range={since, until} · fields=spend·노출·클릭·구매 전환 등.
|
||||
- 날짜는 광고 계정 시간대 기준. 광고가 없던 날은 행이 없다. 여러 계정은 날짜별로 더한다.
|
||||
- 원화가 아닌 계정(USD 등, 2026-10-16)은 지출 금액·구매 전환값을 그날 환율로 원화 환산(fx.krw_rates — Frankfurter 중앙은행 고시 환율 종합,
|
||||
그날 값이 없으면 앞 가장 가까운 날). 계정 탭에 원래 통화 지출·적용 환율. ROAS 는 비율이라 환율과 무관.
|
||||
- 기여(어트리뷰션)는 메타가 광고 관리자 설정을 그대로 따른다(2025-06 부터 API 의 기여 매개변수는 무시됨) — 화면 값과 같다.
|
||||
- 구매 전환값·구매수 = action_values·actions 의 구매 항목 하나(omni_purchase → purchase → 픽셀 구매 순서로 처음 있는 것).
|
||||
메타는 같은 구매를 여러 action_type 에 같은 값으로 겹쳐 주므로 더하지 않는다.
|
||||
- 금액(광고비) = 지출 금액 그대로(원 반올림) — **메타 지출 금액은 이미 부가세 포함**(2026-10-16 사용자 확인).
|
||||
부가세를 더하는(× 1.1) 것은 비용이 부가세 별도인 구글만이다.
|
||||
- ROAS(%) = 구매 전환값 ÷ 지출 금액 × 100 — 광고 관리자 "구매 ROAS" 와 같은 값, 지출 0 이면 없음.
|
||||
- 나머지 항목(노출수·클릭수·클릭률·링크 클릭·구매수·구매 전환값)은 광고비 탭 메타 머리글 → 일자별 표.
|
||||
- **기간으로 물으면 지출·노출·클릭이 0 으로 오는 메타 응답(2026-10-21 운영 확인, v26.0)** — 10/01~10/21 을 한 번에 물으면 날마다
|
||||
spend='0'·impressions='0'·clicks='0' 인데 링크 클릭·구매는 들어오고, 같은 날을 하루만 물으면 정상(10/20 지출 817,212원). 그래서 기간 응답에서
|
||||
"지출·노출 0 인데 링크 클릭·구매가 있는" 날(실제로는 있을 수 없는 조합)은 그날 하루만 다시 물어 그 값으로 바꾼다(_refetch_suspect_days).
|
||||
집행이 없는 계정·날은 행이 없거나 다 0 이라 다시 묻지 않는다. 진단: scripts/meta_insights_raw.py.
|
||||
API 버전은 설정 칸(기본 DEFAULT_VERSION) — 메타는 버전을 약 2년 뒤 종료하므로 종료 안내가 오면 설정에서 올린다.
|
||||
"""
|
||||
|
||||
from __future__ import annotations
|
||||
|
||||
import hashlib
|
||||
import hmac
|
||||
import json
|
||||
import re
|
||||
from datetime import date
|
||||
from decimal import ROUND_HALF_UP, Decimal
|
||||
from typing import Any
|
||||
|
||||
import httpx
|
||||
|
||||
from ..adapters.base import AdapterContext, AdapterError, ApiError, AuthFailed, CredentialField, NotConfigured, TokenExpired
|
||||
from .. import fx
|
||||
from .base import ACCOUNTS_KEY, AdDay, AdSource
|
||||
|
||||
API_BASE = "https://graph.facebook.com"
|
||||
DEFAULT_VERSION = "v26.0" # 2026-07-29 출시(2026-10 기준 최신)
|
||||
MAX_DAYS = 366
|
||||
MAX_ACCOUNTS = 30
|
||||
MAX_PAGES = 50 # 계정 하나 페이지 상한(하루 한 줄이라 366일도 몇 쪽)
|
||||
PURCHASE_TYPES = ("omni_purchase", "purchase", "offsite_conversion.fb_pixel_purchase")
|
||||
INSIGHT_FIELDS = "date_start,account_id,account_name,account_currency,spend,impressions,clicks,inline_link_clicks,actions,action_values"
|
||||
|
||||
# 일자별 표(광고비 탭 메타 머리글) 항목 — 순서 = 열 순서. 클릭률·ROAS 합계는 ad_spend.detail_table 이 이름으로 다시 계산.
|
||||
M_SPEND = "지출 금액(부가세 포함)" # = 광고비(메타 지출 금액은 부가세 포함 — 구글처럼 따로 더하지 않음)
|
||||
M_IMPR, M_CLICKS, M_CTR, M_LINK = "노출수", "클릭수", "클릭률(%)", "링크 클릭"
|
||||
M_PURCHASES, M_VALUE, M_ROAS = "구매수", "구매 전환값", "ROAS(%)"
|
||||
M_FX = "적용 환율(원)" # 외화 계정 탭에만 — 그날 1 계정 통화 = ? 원(fx.krw_rates)
|
||||
|
||||
# 메타 오류 코드 → 고칠 곳 안내(오류 문구 뒤에 붙임). 권한 오류는 연결 테스트가 원인을 진단한다(_diagnose) —
|
||||
# 불러오기에서 난 오류엔 그 안내를 붙이고, 연결 테스트 자체에서는 진단 결과로 바꿔 쓴다.
|
||||
_DIAG_HINT = "(실적 설정 → 광고 API 연동 → 메타 [연결 테스트]가 원인을 진단합니다)"
|
||||
_HINTS = {
|
||||
190: "토큰이 만료됐거나 무효입니다. 비즈니스 설정 → 시스템 사용자에서 토큰을 다시 만들어 [액세스 토큰]에 넣으세요(시스템 사용자 토큰은 만료 없음).",
|
||||
102: "토큰을 읽을 수 없습니다. 토큰을 다시 복사해 넣으세요.",
|
||||
200: "토큰에 권한이 없습니다. 토큰을 만들 때 ads_read 권한을 고르고, 토큰 주인(시스템 사용자)을 이 광고 계정에 배정했는지 확인하세요"
|
||||
+ _DIAG_HINT + ".",
|
||||
10: "토큰에 권한이 없습니다(ads_read). 앱·토큰 권한을 확인하세요.",
|
||||
100: "요청 값이 올바르지 않습니다 — 광고 계정 ID 가 맞는지, 토큰 주인이 그 계정을 볼 수 있는지 확인하세요.",
|
||||
803: "광고 계정 ID 를 찾을 수 없습니다(숫자만, act_ 는 있어도 됨).",
|
||||
4: "메타 API 호출 한도에 걸렸습니다. 잠시 뒤 다시 누르세요.",
|
||||
17: "메타 API 호출 한도에 걸렸습니다. 잠시 뒤 다시 누르세요.",
|
||||
613: "메타 API 호출 한도에 걸렸습니다. 잠시 뒤 다시 누르세요.",
|
||||
80000: "광고 계정 호출 한도에 걸렸습니다. 잠시 뒤 다시 누르세요.",
|
||||
80004: "광고 계정 호출 한도에 걸렸습니다. 잠시 뒤 다시 누르세요.",
|
||||
2635: "API 버전이 종료됐습니다 — 실적 설정에서 API 버전을 최신으로 바꾸세요.",
|
||||
}
|
||||
_RATE_LIMIT = {4, 17, 613, 80000, 80004}
|
||||
_AUTH = {10, 102, 200}
|
||||
_ACCOUNT_STATUS = {1: "운영 중", 2: "사용 중지", 3: "미결제", 7: "검토 대기", 8: "결제 대기", 9: "유예 기간", 100: "종료 대기", 101: "종료"}
|
||||
|
||||
|
||||
def _http(ctx: AdapterContext) -> httpx.Client:
|
||||
"""HTTP 클라이언트 — 테스트가 바꿔 끼운다."""
|
||||
return httpx.Client(timeout=ctx.timeout_sec)
|
||||
|
||||
|
||||
def parse_account_ids(raw: str) -> list[str]:
|
||||
"""'act_123, 456\\n789' → ['123', '456', '789'](순서 유지·중복 제거). 형식이 틀리면 ValueError."""
|
||||
out: list[str] = []
|
||||
for part in re.split(r"[\s,;]+", raw or ""):
|
||||
if not part:
|
||||
continue
|
||||
v = part[4:] if part.lower().startswith("act_") else part
|
||||
if not re.fullmatch(r"\d{5,20}", v):
|
||||
raise ValueError("광고 계정 ID 는 숫자여야 합니다(act_ 는 있어도 됨, 여러 개는 쉼표나 줄바꿈으로 구분).")
|
||||
if v not in out:
|
||||
out.append(v)
|
||||
if len(out) > MAX_ACCOUNTS:
|
||||
raise ValueError(f"광고 계정은 {MAX_ACCOUNTS}개까지 넣을 수 있습니다.")
|
||||
return out
|
||||
|
||||
|
||||
def _num(v: Any) -> Decimal:
|
||||
"""메타 응답 숫자(문자열로 옴, 0 이면 빠지기도 함) → Decimal."""
|
||||
if v is None or v == "":
|
||||
return Decimal(0)
|
||||
try:
|
||||
return Decimal(str(v))
|
||||
except ArithmeticError:
|
||||
return Decimal(0)
|
||||
|
||||
|
||||
def _won(v: Decimal) -> int:
|
||||
return int(v.quantize(Decimal(1), rounding=ROUND_HALF_UP))
|
||||
|
||||
|
||||
def _purchase(items: Any) -> Decimal:
|
||||
"""actions / action_values 목록에서 구매 값 하나(PURCHASE_TYPES 순서로 처음 있는 것 — 겹친 값을 더하지 않는다)."""
|
||||
by_type = {str((i or {}).get("action_type")): (i or {}).get("value") for i in (items or []) if isinstance(i, dict)}
|
||||
for t in PURCHASE_TYPES:
|
||||
if t in by_type:
|
||||
return _num(by_type[t])
|
||||
return Decimal(0)
|
||||
|
||||
|
||||
def _meta_error(resp: httpx.Response) -> tuple[int, str]:
|
||||
"""메타 오류 응답 {"error": {"message", "code", "error_subcode", ...}} → (코드, 문구)."""
|
||||
try:
|
||||
err = (resp.json() or {}).get("error") or {}
|
||||
except ValueError:
|
||||
return 0, f"HTTP {resp.status_code}"
|
||||
if not isinstance(err, dict):
|
||||
return 0, f"HTTP {resp.status_code}"
|
||||
msg = str(err.get("error_user_msg") or err.get("message") or f"HTTP {resp.status_code}")
|
||||
try:
|
||||
code = int(err.get("code") or 0)
|
||||
except (TypeError, ValueError):
|
||||
code = 0
|
||||
return code, msg
|
||||
|
||||
|
||||
class MetaAdsSource(AdSource):
|
||||
code = "meta"
|
||||
name = "메타 광고"
|
||||
docs_url = "https://developers.facebook.com/docs/marketing-api/insights"
|
||||
note = ("메타 마케팅 API(Insights)로 광고 계정별 날짜별 지출 금액·구매 ROAS·노출수·클릭수·구매를 가져와 계정을 합칩니다. "
|
||||
"준비: ① ads_read 권한이 있는 액세스 토큰(비즈니스 설정 → 시스템 사용자 토큰 권장 — 만료 없음) "
|
||||
"② 토큰 주인을 각 광고 계정에 배정. 광고비 = 메타 지출 금액 그대로(이미 부가세 포함)입니다.")
|
||||
|
||||
def credential_fields(self) -> list[CredentialField]:
|
||||
return [
|
||||
CredentialField("account_ids", "광고 계정 ID", multiline=True, placeholder="act_1234567890\nact_9876543210",
|
||||
help="광고비를 가져올 광고 계정 번호(광고 관리자 주소의 act= 뒤 숫자). 여러 개면 줄바꿈이나 쉼표로 — "
|
||||
"날짜별로 합쳐서 메타 한 칸에 들어갑니다."),
|
||||
CredentialField("access_token", "액세스 토큰", secret=True,
|
||||
help="ads_read 권한이 있는 토큰. 저장 후에는 화면에 다시 보이지 않습니다."),
|
||||
CredentialField("app_secret", "앱 시크릿", secret=True, required=False, placeholder="앱에서 '앱 시크릿 필요'를 켰을 때만",
|
||||
help="메타 앱 설정 → 고급에서 'API 호출에 앱 시크릿 필요'를 켰다면 넣습니다(appsecret_proof). 아니면 비워 둡니다."),
|
||||
CredentialField("api_version", "API 버전", required=False, placeholder=DEFAULT_VERSION,
|
||||
help=f"비워 두면 {DEFAULT_VERSION}. 메타가 버전 종료를 알리면 새 버전(예: v27.0)으로 바꿉니다."),
|
||||
]
|
||||
|
||||
def validate_credentials(self, values: dict[str, str]) -> list[str]:
|
||||
errors = super().validate_credentials(values)
|
||||
ids = (values.get("account_ids") or "").strip()
|
||||
if ids and ids != "__stored__":
|
||||
try:
|
||||
parse_account_ids(ids)
|
||||
except ValueError as exc:
|
||||
errors.append(str(exc))
|
||||
token = (values.get("access_token") or "").strip()
|
||||
if token and token != "__stored__" and (len(token) < 20 or re.search(r"\s", token)):
|
||||
errors.append("액세스 토큰 형식이 아닙니다(공백 없이 통째로 붙여 넣으세요).")
|
||||
ver = (values.get("api_version") or "").strip()
|
||||
if ver and ver != "__stored__" and not re.fullmatch(r"v\d{2,3}\.0", ver):
|
||||
errors.append("API 버전은 v26.0 처럼 입력하세요.")
|
||||
return errors
|
||||
|
||||
# ── 요청 ──────────────────────────────────────────────
|
||||
def _setup(self, ctx: AdapterContext) -> tuple[list[str], str, dict[str, str]]:
|
||||
self.require_configured(ctx)
|
||||
try:
|
||||
accounts = parse_account_ids(ctx.credentials.get("account_ids"))
|
||||
except ValueError as exc:
|
||||
raise NotConfigured(str(exc)) from None
|
||||
if not accounts:
|
||||
raise NotConfigured("광고 계정 ID 를 입력하세요.")
|
||||
token = (ctx.credentials.get("access_token") or "").strip()
|
||||
auth = {"access_token": token}
|
||||
secret = (ctx.credentials.get("app_secret") or "").strip()
|
||||
if secret:
|
||||
auth["appsecret_proof"] = hmac.new(secret.encode(), token.encode(), hashlib.sha256).hexdigest()
|
||||
version = (ctx.credentials.get("api_version") or "").strip() or DEFAULT_VERSION
|
||||
return accounts, version, auth
|
||||
|
||||
def _get(self, ctx: AdapterContext, client: httpx.Client, url: str, params: dict[str, Any] | None) -> dict[str, Any]:
|
||||
ctx.progress.check()
|
||||
try:
|
||||
resp = client.get(url, params=params)
|
||||
except httpx.HTTPError as exc:
|
||||
raise ApiError(f"메타 API 에 연결하지 못했습니다({type(exc).__name__}).") from None # 주소(토큰 포함)는 넣지 않는다
|
||||
if resp.status_code != 200:
|
||||
code, msg = _meta_error(resp)
|
||||
hint = _HINTS.get(code, "")
|
||||
text = f"메타 API 오류({code or resp.status_code}): {msg[:200]}" + (f" — {hint}" if hint else "")
|
||||
if code == 190:
|
||||
raise TokenExpired(text)
|
||||
auth_problem = code in _AUTH or (resp.status_code in (401, 403) and code not in _RATE_LIMIT)
|
||||
raise (AuthFailed if auth_problem else ApiError)(text)
|
||||
try:
|
||||
body = resp.json()
|
||||
except ValueError:
|
||||
raise ApiError("메타 API 응답을 읽을 수 없습니다.") from None
|
||||
return body if isinstance(body, dict) else {}
|
||||
|
||||
# ── 권한 진단(연결 테스트가 권한 오류를 받았을 때) ─────────
|
||||
def _diagnose(self, ctx: AdapterContext, client: httpx.Client, version: str, auth: dict[str, str],
|
||||
accounts: list[str]) -> str:
|
||||
"""토큰이 받은 권한·권한 대상 계정·볼 수 있는 광고 계정을 메타에 물어 원인을 짚는다(2026-10-16 #200 오류).
|
||||
조회가 실패해도 예외를 내지 않는다(진단은 덧붙이는 정보). 토큰 값은 문구에 넣지 않는다."""
|
||||
lines: list[str] = []
|
||||
scopes: set[str] | None = None
|
||||
ads_targets: set[str] | None = None # ads_read/ads_management 가 특정 계정에만 걸려 있으면 그 계정들
|
||||
try: # ① 토큰 점검 — 앱 개발자 토큰·시스템 사용자 토큰이면 같은 토큰으로 된다
|
||||
d = (self._get(ctx, client, f"{API_BASE}/{version}/debug_token",
|
||||
{**auth, "input_token": auth["access_token"]}).get("data") or {})
|
||||
scopes = {str(s) for s in d.get("scopes") or []}
|
||||
for g in d.get("granular_scopes") or []:
|
||||
if str((g or {}).get("scope")) in ("ads_read", "ads_management") and (g or {}).get("target_ids"):
|
||||
ads_targets = (ads_targets or set()) | {str(t) for t in g["target_ids"]}
|
||||
exp = int(d.get("expires_at") or 0)
|
||||
expires = "만료 없음" if exp == 0 else date.fromtimestamp(exp).isoformat() + " 만료"
|
||||
lines.append(f"토큰: 앱 {d.get('application') or d.get('app_id') or '?'}({d.get('app_id') or '?'}) · {expires}"
|
||||
+ ("" if d.get("is_valid", True) else " · 무효"))
|
||||
except AdapterError:
|
||||
try: # ② 토큰 점검을 못 하면 받은 권한 목록만
|
||||
rows = self._get(ctx, client, f"{API_BASE}/{version}/me/permissions", dict(auth)).get("data") or []
|
||||
scopes = {str(r.get("permission")) for r in rows if r.get("status") == "granted"}
|
||||
except AdapterError:
|
||||
pass
|
||||
if scopes is not None:
|
||||
has = sorted(scopes & {"ads_read", "ads_management"})
|
||||
lines.append("광고 권한: " + (", ".join(has) if has else "없음(ads_read·ads_management 둘 다 없음)"))
|
||||
visible: set[str] | None = None
|
||||
try: # ③ 이 토큰으로 볼 수 있는 광고 계정
|
||||
rows = self._get(ctx, client, f"{API_BASE}/{version}/me/adaccounts",
|
||||
{**auth, "fields": "account_id,name", "limit": 200}).get("data") or []
|
||||
visible = {str(r.get("account_id") or "") for r in rows}
|
||||
lines.append(f"이 토큰으로 보이는 광고 계정 {len(visible)}개")
|
||||
except AdapterError:
|
||||
pass
|
||||
missing = [a for a in accounts if visible is not None and a not in visible]
|
||||
not_target = [a for a in accounts if ads_targets is not None and a not in ads_targets]
|
||||
# 결론 — 가장 앞선 원인 하나
|
||||
if scopes is not None and not scopes & {"ads_read", "ads_management"}:
|
||||
todo = ("토큰에 ads_read 권한이 없습니다 → 토큰을 새로 만들면서 ads_read 를 체크하세요"
|
||||
"(비즈니스 설정 → 사용자 → 시스템 사용자 → 새 토큰 생성 → 권한에서 ads_read).")
|
||||
elif missing:
|
||||
todo = ("입력한 계정 중 이 토큰 주인에게 배정되지 않은 계정: " + ", ".join("act_" + a for a in missing)
|
||||
+ " → 비즈니스 설정 → 사용자 → 시스템 사용자(토큰 주인) → [자산 할당] → 광고 계정에서 그 계정을 고르고 "
|
||||
"'성과 보기'(또는 전체 권한)를 켠 뒤, 토큰을 새로 만들어 넣으세요(배정 전에 만든 토큰은 권한이 안 바뀔 수 있음).")
|
||||
elif not_target:
|
||||
todo = ("토큰의 ads_read 권한이 다른 계정에만 걸려 있습니다(대상 아님: " + ", ".join("act_" + a for a in not_target)
|
||||
+ ") → 토큰을 새로 만들 때 이 광고 계정도 대상에 포함하세요.")
|
||||
elif visible is not None:
|
||||
todo = ("토큰 권한·계정 배정은 맞습니다 → 앱 쪽 문제일 가능성이 큽니다: 앱이 이 광고 계정을 가진 비즈니스에 연결돼 있는지"
|
||||
"(비즈니스 설정 → 계정 → 앱), 앱 대시보드에 Marketing API 제품이 추가돼 있는지, 앱이 '제한 액세스'라면 토큰 주인이 앱의 "
|
||||
"관리자·개발자 역할인지 확인하세요.")
|
||||
else:
|
||||
todo = "토큰 정보를 메타에서 읽지 못해 원인을 좁히지 못했습니다 — 토큰 권한(ads_read)과 광고 계정 배정을 확인하세요."
|
||||
return "[진단] " + " · ".join(lines + [todo])
|
||||
|
||||
# ── 연결 테스트 · 가져오기 ─────────────────────────────
|
||||
def test_connection(self, ctx: AdapterContext) -> str:
|
||||
accounts, version, auth = self._setup(ctx)
|
||||
parts: list[str] = []
|
||||
not_krw = False
|
||||
with _http(ctx) as client:
|
||||
for acc in accounts:
|
||||
try:
|
||||
info = self._get(ctx, client, f"{API_BASE}/{version}/act_{acc}",
|
||||
{**auth, "fields": "name,currency,timezone_name,account_status"})
|
||||
except AuthFailed as exc: # 권한 오류(#200 등) — 메타에 토큰 정보를 물어 원인을 덧붙인다
|
||||
# 진단(고칠 곳)을 맨 앞에, 메타 원문은 짧게 뒤에 — 길면 화면·기록에서 뒤가 잘리므로(2026-10-16 "[진…" 잘림)
|
||||
original = str(exc).split(" — ")[0]
|
||||
original = re.sub(r",?\s*refer to https?://\S+(?: for details)?", "", original)
|
||||
raise AuthFailed(self._diagnose(ctx, client, version, auth, accounts)
|
||||
+ f" (메타 원문: {original})") from None
|
||||
cur = str(info.get("currency") or "?")
|
||||
not_krw = not_krw or cur != "KRW"
|
||||
status = _ACCOUNT_STATUS.get(info.get("account_status"), "")
|
||||
parts.append(f"{info.get('name') or acc}({cur}·{info.get('timezone_name') or '?'}{'·' + status if status else ''})")
|
||||
msg = f"연결됨 — 광고 계정 {len(accounts)}개: " + ", ".join(parts)
|
||||
if not_krw:
|
||||
msg += f" (원화가 아닌 계정은 날마다 그날 환율로 원화로 바꿔 넣습니다 — {fx.SOURCE_LABEL})"
|
||||
return msg
|
||||
|
||||
def _refetch_suspect_days(self, ctx: AdapterContext, client: httpx.Client, version: str, params: dict[str, Any],
|
||||
raw: list[tuple[str, date, str, dict[str, Any]]]) -> list[tuple[str, date, str, dict[str, Any]]]:
|
||||
"""_suspect 줄은 그 계정·그날 하루만 다시 물어 바꾼다(하루 조회는 지출·노출·클릭이 정상). 하루 조회도 같으면 그대로 둔다."""
|
||||
out = []
|
||||
for acc, day, cur, r in raw:
|
||||
if _suspect(r):
|
||||
one = {**params, "time_range": json.dumps({"since": day.isoformat(), "until": day.isoformat()})}
|
||||
rows = self._get(ctx, client, f"{API_BASE}/{version}/act_{acc}/insights", one).get("data") or []
|
||||
fresh = next((x for x in rows if str(x.get("date_start")) == day.isoformat()), None)
|
||||
if fresh is not None:
|
||||
r, cur = fresh, str(fresh.get("account_currency") or cur).upper()
|
||||
out.append((acc, day, cur, r))
|
||||
return out
|
||||
|
||||
def fetch_days(self, ctx: AdapterContext, start: date, end: date) -> list[AdDay]:
|
||||
if end < start:
|
||||
start, end = end, start
|
||||
if (end - start).days + 1 > MAX_DAYS:
|
||||
raise ApiError(f"한 번에 {MAX_DAYS}일까지 가져올 수 있습니다.")
|
||||
accounts, version, auth = self._setup(ctx)
|
||||
params = {**auth, "level": "account", "time_increment": 1, "limit": 100, "fields": INSIGHT_FIELDS,
|
||||
"time_range": json.dumps({"since": start.isoformat(), "until": end.isoformat()})}
|
||||
raw: list[tuple[str, date, str, dict[str, Any]]] = [] # (계정, 날짜, 통화, insights 한 줄)
|
||||
names: dict[str, str] = {}
|
||||
with _http(ctx) as client:
|
||||
for acc in accounts:
|
||||
url: str | None = f"{API_BASE}/{version}/act_{acc}/insights"
|
||||
page_params: dict[str, Any] | None = params
|
||||
for _ in range(MAX_PAGES):
|
||||
body = self._get(ctx, client, url, page_params)
|
||||
for r in body.get("data") or []:
|
||||
try:
|
||||
day = date.fromisoformat(str(r.get("date_start")))
|
||||
except ValueError:
|
||||
continue
|
||||
if r.get("account_name"):
|
||||
names[acc] = str(r["account_name"])[:100]
|
||||
raw.append((acc, day, str(r.get("account_currency") or "KRW").upper(), r))
|
||||
nxt = ((body.get("paging") or {}).get("next") or "").strip()
|
||||
if not nxt:
|
||||
break
|
||||
if not nxt.startswith(API_BASE + "/"):
|
||||
raise ApiError("메타 API 다음 쪽 주소가 올바르지 않습니다.")
|
||||
url, page_params = nxt, None # next 주소에 매개변수(토큰 포함)가 다 들어 있다
|
||||
else:
|
||||
raise ApiError("메타 API 응답 쪽수가 너무 많습니다. 기간을 줄여 다시 시도하세요.")
|
||||
raw = self._refetch_suspect_days(ctx, client, version, params, raw)
|
||||
# 원화가 아닌 계정(USD 등) — 그날 환율로 원화 환산(2026-10-16). 통화마다 기간 환율을 한 번에.
|
||||
rates: dict[str, dict[date, Decimal]] = {}
|
||||
for cur in sorted({c for _a, _d, c, _r in raw if c != "KRW"}):
|
||||
if not re.fullmatch(r"[A-Z]{3}", cur):
|
||||
raise ApiError(f"광고 계정 통화({cur[:10]})를 알 수 없습니다.")
|
||||
try:
|
||||
rates[cur] = fx.krw_rates(client, cur, start, end)
|
||||
except fx.FxError as exc:
|
||||
raise ApiError(f"{cur} 광고 계정을 원화로 바꿀 환율을 가져오지 못했습니다 — {exc}") from None
|
||||
sums: dict[date, dict[str, Decimal]] = {} # 날짜 → 모든 계정 합(원화)
|
||||
per_acc: dict[date, dict[str, dict[str, Any]]] = {} # 날짜 → 계정 → 그 계정 값(상세보기 계정별 탭)
|
||||
for acc, day, cur, r in raw:
|
||||
rate = Decimal(1) if cur == "KRW" else rates[cur][day]
|
||||
one = per_acc.setdefault(day, {}).setdefault(acc, {**_zero(), "cur": cur, "rate": rate, "orig": Decimal(0)})
|
||||
_add(one, r, rate)
|
||||
one["orig"] += _num(r.get("spend")) # 그 계정 통화 그대로의 지출 금액
|
||||
_add(sums.setdefault(day, _zero()), r, rate)
|
||||
out: list[AdDay] = []
|
||||
for day in sorted(sums):
|
||||
amount, roas, metrics = _convert(sums[day])
|
||||
# 계정별 값 — 화면 표 열이 아니라 상세보기 계정별 탭용(ad_spend.detail_tabs, "_" 로 시작하는 키는 표 열에서 빠짐).
|
||||
# 계정마다 따로 반올림하므로 계정 광고비 합이 합계와 1원 다를 수 있다.
|
||||
accounts_out: dict[str, Any] = {}
|
||||
for acc, a in per_acc.get(day, {}).items():
|
||||
a_amount, a_roas, a_metrics = _convert(a)
|
||||
if a["cur"] != "KRW": # 외화 계정 — 원래 통화 지출과 적용 환율도 보여 준다(계정 탭)
|
||||
a_metrics[f"지출 금액({a['cur']})"] = float(a["orig"].quantize(Decimal("0.01"), rounding=ROUND_HALF_UP))
|
||||
a_metrics[M_FX] = float(a["rate"])
|
||||
accounts_out[acc] = {"name": names.get(acc) or f"act_{acc}", "amount": a_amount,
|
||||
"roas": float(a_roas) if a_roas is not None else None, "metrics": a_metrics}
|
||||
metrics[ACCOUNTS_KEY] = accounts_out
|
||||
out.append(AdDay(day=day, amount=amount, roas=roas, metrics=metrics))
|
||||
return out
|
||||
|
||||
|
||||
def _suspect(r: dict[str, Any]) -> bool:
|
||||
"""기간 응답에서 지출·노출이 0 인데 링크 클릭·구매가 있는 줄 — 메타 기간 조회가 핵심 칸을 0 으로 준 경우(2026-10-21)."""
|
||||
return (_num(r.get("spend")) == 0 and _num(r.get("impressions")) == 0
|
||||
and (_num(r.get("inline_link_clicks")) > 0 or _purchase(r.get("actions")) > 0))
|
||||
|
||||
|
||||
def _zero() -> dict[str, Decimal]:
|
||||
return {k: Decimal(0) for k in ("spend", "impr", "clicks", "link", "purchases", "value")}
|
||||
|
||||
|
||||
def _add(acc: dict[str, Any], r: dict[str, Any], rate: Decimal = Decimal(1)) -> None:
|
||||
"""insights 한 줄(계정 하나·하루)을 더한다 — 금액(지출·구매 전환값)은 × rate(그날 1 계정 통화 = ? 원)로 원화."""
|
||||
acc["spend"] += _num(r.get("spend")) * rate
|
||||
acc["impr"] += _num(r.get("impressions"))
|
||||
acc["clicks"] += _num(r.get("clicks"))
|
||||
acc["link"] += _num(r.get("inline_link_clicks"))
|
||||
acc["purchases"] += _purchase(r.get("actions"))
|
||||
acc["value"] += _purchase(r.get("action_values")) * rate
|
||||
|
||||
|
||||
def _convert(a: dict[str, Decimal]) -> tuple[int, Decimal | None, dict[str, Any]]:
|
||||
"""더한 값 → (광고비 원, ROAS %, 일자별 표 항목). 광고비 = 지출 금액 그대로(메타 지출은 부가세 포함, 2026-10-16)."""
|
||||
amount = _won(a["spend"])
|
||||
roas = (a["value"] / a["spend"] * 100).quantize(Decimal("0.01"), rounding=ROUND_HALF_UP) if a["spend"] > 0 else None
|
||||
ctr = (a["clicks"] / a["impr"] * 100).quantize(Decimal("0.01"), rounding=ROUND_HALF_UP) if a["impr"] > 0 else None
|
||||
return amount, roas, {
|
||||
M_SPEND: amount,
|
||||
M_IMPR: int(a["impr"]),
|
||||
M_CLICKS: int(a["clicks"]),
|
||||
M_CTR: float(ctr) if ctr is not None else None,
|
||||
M_LINK: int(a["link"]),
|
||||
M_PURCHASES: int(a["purchases"]),
|
||||
M_VALUE: _won(a["value"]),
|
||||
M_ROAS: float(roas) if roas is not None else None,
|
||||
}
|
||||
@@ -1,11 +1,14 @@
|
||||
"""광고 API 연동 목록 — 새 광고 채널은 파일 하나 + 여기 한 줄(채널 코드는 ad_spend.CHANNELS 와 같아야 한다)."""
|
||||
"""광고 API 연동 목록 — 새 광고 채널은 파일 하나 + 여기 한 줄(채널 코드는 ad_spend.CHANNELS 와 같아야 한다 —
|
||||
틱톡만 예외: 광고비 탭에 안 나오게 CHANNELS 에 넣지 않고 틱톡 탭이 따로 읽는다)."""
|
||||
|
||||
from __future__ import annotations
|
||||
|
||||
from .base import AdSource
|
||||
from .google_ads import GoogleAdsSource
|
||||
from .meta_ads import MetaAdsSource
|
||||
from .tiktok_ads import TiktokAdsSource
|
||||
|
||||
_SOURCES: tuple[AdSource, ...] = (GoogleAdsSource(),)
|
||||
_SOURCES: tuple[AdSource, ...] = (GoogleAdsSource(), MetaAdsSource(), TiktokAdsSource())
|
||||
_BY_CODE = {s.code: s for s in _SOURCES}
|
||||
|
||||
|
||||
|
||||
@@ -0,0 +1,202 @@
|
||||
"""틱톡 광고(TikTok API for Business v1.3) — 날짜별 광고비·매출·ROAS. 화면은 틱톡 탭(광고비 탭·매출 실적에는 안 나옴).
|
||||
|
||||
인증(2026-11-05): 광고 계정(advertiser) ID 하나 + 장기 액세스 토큰(머리글 Access-Token). 토큰 앱에 보고서·광고 계정 읽기 권한이 있어야 한다.
|
||||
|
||||
조회
|
||||
GET /report/integrated/get/ — report_type=BASIC · data_level=AUCTION_ADVERTISER · 차원 advertiser_id·stat_time_day.
|
||||
매출 = 웹 구매금액(total_complete_payment_rate — 이름과 달리 금액) + 틱톡샵 매출(total_onsite_shopping_value).
|
||||
GET /gmv_max/report/get/ — 틱톡샵 ID 를 넣었을 때만. 비용(cost)·매출(gross_revenue)을 더한다.
|
||||
- 하루 단위 조회는 기간 제한이 있어 30일씩 나눠 묻는다.
|
||||
- 금액은 광고 계정 통화 → 그날 환율로 원화(fx.krw_rates, 메타와 같음).
|
||||
- ROAS(%) = 매출 ÷ 광고비 × 100(합친 값으로 계산 — 틱톡의 ROAS 칸은 더할 수 없다).
|
||||
공식 문서가 스크립트 화면이라 지표 이름을 이차 자료로 확인했다 — 연결 테스트가 어제 하루를 실제로 물어 지표 이름 오류까지 잡는다.
|
||||
"""
|
||||
|
||||
from __future__ import annotations
|
||||
|
||||
import json
|
||||
import re
|
||||
from datetime import date, timedelta
|
||||
from decimal import ROUND_HALF_UP, Decimal
|
||||
from typing import Any
|
||||
|
||||
import httpx
|
||||
|
||||
from app.timezone import today_kst
|
||||
|
||||
from .. import fx
|
||||
from ..adapters.base import AdapterContext, ApiError, AuthFailed, CredentialField, TokenExpired
|
||||
from .base import AdDay, AdSource
|
||||
from .meta_ads import _num, _won
|
||||
|
||||
API_BASE = "https://business-api.tiktok.com/open_api/v1.3"
|
||||
MAX_DAYS = 366
|
||||
SPAN_DAYS = 30
|
||||
PAGE_SIZE = 100 # 계정 하나·30일 = 많아야 30줄이라 한 쪽이면 된다
|
||||
RATE_LIMIT = 40100
|
||||
|
||||
REPORT_METRICS = ("spend", "impressions", "clicks", "complete_payment", "total_complete_payment_rate",
|
||||
"onsite_shopping", "total_onsite_shopping_value")
|
||||
GMV_METRICS = ("cost", "gross_revenue", "orders")
|
||||
|
||||
# metrics 키 — 화면 이름 그대로 저장. 틱톡 탭은 M_REVENUE 를 매출로 읽는다(ad_spend.build_tiktok_dashboard).
|
||||
M_SPEND, M_REVENUE, M_ROAS = "광고비", "매출", "ROAS(%)"
|
||||
M_IMPR, M_CLICKS, M_ORDERS = "노출수", "클릭수", "구매수"
|
||||
M_WEB, M_SHOP, M_GMV_COST, M_GMV_REVENUE = "웹 구매금액", "틱톡샵 매출", "GMV Max 비용", "GMV Max 매출"
|
||||
|
||||
|
||||
def _http(ctx: AdapterContext) -> httpx.Client:
|
||||
"""HTTP 클라이언트 — 테스트가 바꿔 끼운다."""
|
||||
return httpx.Client(timeout=ctx.timeout_sec)
|
||||
|
||||
|
||||
def _spans(start: date, end: date) -> list[tuple[date, date]]:
|
||||
"""기간을 SPAN_DAYS 일씩 나눈다."""
|
||||
out = []
|
||||
while start <= end:
|
||||
stop = min(start + timedelta(days=SPAN_DAYS - 1), end)
|
||||
out.append((start, stop))
|
||||
start = stop + timedelta(days=1)
|
||||
return out
|
||||
|
||||
|
||||
class TiktokAdsSource(AdSource):
|
||||
code = "tiktok"
|
||||
name = "틱톡"
|
||||
docs_url = "https://business-api.tiktok.com/portal/docs"
|
||||
note = ("TikTok API for Business 로 날짜별 광고비·매출·ROAS 를 가져와 틱톡 탭에 보여 줍니다(매출 실적·광고비 탭 합계에는 들어가지 않음). "
|
||||
"준비: 개발자 앱에서 광고 계정을 승인해 장기 액세스 토큰 발급(보고서·광고 계정 읽기 권한). 외화 계정은 그날 환율로 원화로 바꿉니다.")
|
||||
|
||||
def credential_fields(self) -> list[CredentialField]:
|
||||
return [
|
||||
CredentialField("advertiser_id", "광고 계정 ID", placeholder="7123456789012345678",
|
||||
help="틱톡 광고 관리자 주소의 aadvid= 뒤 숫자."),
|
||||
CredentialField("access_token", "액세스 토큰", secret=True,
|
||||
help="광고 계정을 승인할 때 받은 장기 액세스 토큰. 저장 후에는 화면에 다시 보이지 않습니다."),
|
||||
CredentialField("shop_id", "틱톡샵 ID", required=False, placeholder="GMV Max 캠페인을 쓸 때만",
|
||||
help="GMV Max 캠페인은 일반 보고서와 따로 조회합니다 — 넣으면 그 비용·매출도 더합니다. 안 쓰면 비워 둡니다."),
|
||||
]
|
||||
|
||||
def validate_credentials(self, values: dict[str, str]) -> list[str]:
|
||||
errors = super().validate_credentials(values)
|
||||
advertiser = (values.get("advertiser_id") or "").strip()
|
||||
if advertiser and advertiser != "__stored__" and not re.fullmatch(r"\d{5,30}", advertiser):
|
||||
errors.append("광고 계정 ID 는 숫자여야 합니다.")
|
||||
shop = (values.get("shop_id") or "").strip()
|
||||
if shop and shop != "__stored__" and not re.fullmatch(r"\d{5,30}", shop):
|
||||
errors.append("틱톡샵 ID 는 숫자여야 합니다.")
|
||||
token = (values.get("access_token") or "").strip()
|
||||
if token and token != "__stored__" and (len(token) < 20 or re.search(r"\s", token)):
|
||||
errors.append("액세스 토큰 형식이 아닙니다(공백 없이 통째로 붙여 넣으세요).")
|
||||
return errors
|
||||
|
||||
def _get(self, ctx: AdapterContext, client: httpx.Client, path: str, params: dict[str, Any]) -> dict[str, Any]:
|
||||
"""틱톡은 오류도 HTTP 200 + code 로 준다. 토큰은 머리글로만 보내 주소·오류 문구에 들어가지 않는다."""
|
||||
ctx.progress.check()
|
||||
token = (ctx.credentials.get("access_token") or "").strip()
|
||||
try:
|
||||
resp = client.get(API_BASE + path, params=params, headers={"Access-Token": token})
|
||||
except httpx.HTTPError as exc:
|
||||
raise ApiError(f"틱톡 API 에 연결하지 못했습니다({type(exc).__name__}).") from None
|
||||
try:
|
||||
body = resp.json()
|
||||
except ValueError:
|
||||
raise ApiError(f"틱톡 API 응답을 읽을 수 없습니다(HTTP {resp.status_code}).") from None
|
||||
code = body.get("code") if isinstance(body, dict) else None
|
||||
if resp.status_code == 200 and code == 0:
|
||||
return body.get("data") or {}
|
||||
text = f"틱톡 API 오류({code if code is not None else resp.status_code}): {str((body or {}).get('message') or '')[:200]}"
|
||||
if code == 40102:
|
||||
raise TokenExpired(text + " — 액세스 토큰을 다시 발급해 넣으세요.")
|
||||
if code == RATE_LIMIT:
|
||||
raise ApiError(text + " — 호출 한도에 걸렸습니다. 잠시 뒤 다시 누르세요.")
|
||||
if resp.status_code in (401, 403) or (isinstance(code, int) and 40100 < code < 40200):
|
||||
raise AuthFailed(text + " — 토큰과 광고 계정 ID, 앱 권한을 확인하세요.")
|
||||
raise ApiError(text)
|
||||
|
||||
def _info(self, ctx: AdapterContext, client: httpx.Client) -> dict[str, Any]:
|
||||
advertiser = (ctx.credentials.get("advertiser_id") or "").strip()
|
||||
rows = self._get(ctx, client, "/advertiser/info/", {
|
||||
"advertiser_ids": json.dumps([advertiser]), "fields": json.dumps(["name", "currency", "timezone"])}).get("list") or []
|
||||
if not rows:
|
||||
raise AuthFailed("이 토큰으로 볼 수 없는 광고 계정입니다 — 광고 계정 ID 와 승인 여부를 확인하세요.")
|
||||
return rows[0]
|
||||
|
||||
def _rows(self, ctx: AdapterContext, client: httpx.Client, path: str, metrics: tuple[str, ...], start: date, end: date,
|
||||
**extra: Any) -> list[tuple[date, dict[str, Any]]]:
|
||||
"""보고서 하나를 30일씩 물어 (날짜, 지표) 목록으로."""
|
||||
advertiser = (ctx.credentials.get("advertiser_id") or "").strip()
|
||||
out = []
|
||||
for s, e in _spans(start, end):
|
||||
data = self._get(ctx, client, path, {
|
||||
"advertiser_id": advertiser, "dimensions": json.dumps(["advertiser_id", "stat_time_day"]), "metrics": json.dumps(metrics),
|
||||
"start_date": s.isoformat(), "end_date": e.isoformat(), "page": 1, "page_size": PAGE_SIZE, **extra})
|
||||
for r in data.get("list") or []:
|
||||
try:
|
||||
day = date.fromisoformat(str((r.get("dimensions") or {}).get("stat_time_day"))[:10])
|
||||
except ValueError:
|
||||
continue
|
||||
out.append((day, r.get("metrics") or {}))
|
||||
return out
|
||||
|
||||
def _collect(self, ctx: AdapterContext, client: httpx.Client, start: date, end: date) -> dict[date, dict[str, Decimal]]:
|
||||
"""날짜 → 항목 합(계정 통화)."""
|
||||
sums: dict[date, dict[str, Decimal]] = {}
|
||||
|
||||
def day_of(d: date) -> dict[str, Decimal]:
|
||||
return sums.setdefault(d, {k: Decimal(0) for k in ("spend", "impr", "clicks", "orders", "web", "shop", "gmv_cost", "gmv")})
|
||||
|
||||
for d, m in self._rows(ctx, client, "/report/integrated/get/", REPORT_METRICS, start, end,
|
||||
report_type="BASIC", data_level="AUCTION_ADVERTISER"):
|
||||
one = day_of(d)
|
||||
one["spend"] += _num(m.get("spend"))
|
||||
one["impr"] += _num(m.get("impressions"))
|
||||
one["clicks"] += _num(m.get("clicks"))
|
||||
one["orders"] += _num(m.get("complete_payment")) + _num(m.get("onsite_shopping"))
|
||||
one["web"] += _num(m.get("total_complete_payment_rate"))
|
||||
one["shop"] += _num(m.get("total_onsite_shopping_value"))
|
||||
shop_id = (ctx.credentials.get("shop_id") or "").strip()
|
||||
if shop_id:
|
||||
for d, m in self._rows(ctx, client, "/gmv_max/report/get/", GMV_METRICS, start, end, store_ids=json.dumps([shop_id])):
|
||||
one = day_of(d)
|
||||
one["orders"] += _num(m.get("orders"))
|
||||
one["gmv_cost"] += _num(m.get("cost"))
|
||||
one["gmv"] += _num(m.get("gross_revenue"))
|
||||
return sums
|
||||
|
||||
def test_connection(self, ctx: AdapterContext) -> str:
|
||||
self.require_configured(ctx)
|
||||
yesterday = today_kst() - timedelta(days=1)
|
||||
with _http(ctx) as client:
|
||||
info = self._info(ctx, client)
|
||||
self._collect(ctx, client, yesterday, yesterday) # 지표 이름·GMV Max 권한까지 실제로 확인
|
||||
return f"연결됨 — {info.get('name') or '광고 계정'}({info.get('currency') or '?'}·{info.get('timezone') or '?'})"
|
||||
|
||||
def fetch_days(self, ctx: AdapterContext, start: date, end: date) -> list[AdDay]:
|
||||
if end < start:
|
||||
start, end = end, start
|
||||
if (end - start).days + 1 > MAX_DAYS:
|
||||
raise ApiError(f"한 번에 {MAX_DAYS}일까지 가져올 수 있습니다.")
|
||||
self.require_configured(ctx)
|
||||
with _http(ctx) as client:
|
||||
currency = str(self._info(ctx, client).get("currency") or "").upper()
|
||||
if not re.fullmatch(r"[A-Z]{3}", currency):
|
||||
raise ApiError(f"광고 계정 통화({currency[:10] or '없음'})를 알 수 없습니다.")
|
||||
sums = self._collect(ctx, client, start, end)
|
||||
try:
|
||||
rates = fx.krw_rates(client, currency, start, end) if sums else {}
|
||||
except fx.FxError as exc:
|
||||
raise ApiError(f"{currency} 광고 계정을 원화로 바꿀 환율을 가져오지 못했습니다 — {exc}") from None
|
||||
return [_day(d, sums[d], rates[d]) for d in sorted(sums)]
|
||||
|
||||
|
||||
def _day(day: date, a: dict[str, Decimal], rate: Decimal) -> AdDay:
|
||||
"""합친 값(계정 통화) → 하루치(원화). ROAS 는 비율이라 반올림 전 값으로."""
|
||||
spend = (a["spend"] + a["gmv_cost"]) * rate
|
||||
revenue = (a["web"] + a["shop"] + a["gmv"]) * rate
|
||||
roas = (revenue / spend * 100).quantize(Decimal("0.01"), rounding=ROUND_HALF_UP) if spend > 0 else None
|
||||
return AdDay(day=day, amount=_won(spend), roas=roas, metrics={
|
||||
M_SPEND: _won(spend), M_REVENUE: _won(revenue), M_ROAS: float(roas) if roas is not None else None,
|
||||
M_WEB: _won(a["web"] * rate), M_SHOP: _won(a["shop"] * rate), M_GMV_COST: _won(a["gmv_cost"] * rate), M_GMV_REVENUE: _won(a["gmv"] * rate),
|
||||
M_IMPR: int(a["impr"]), M_CLICKS: int(a["clicks"]), M_ORDERS: int(a["orders"]),
|
||||
})
|
||||
@@ -22,11 +22,13 @@ from __future__ import annotations
|
||||
import csv
|
||||
import io
|
||||
from dataclasses import dataclass, field
|
||||
from datetime import date
|
||||
from datetime import date, timedelta
|
||||
from decimal import ROUND_HALF_UP, Decimal, InvalidOperation
|
||||
from typing import Any, Callable, Mapping, Sequence
|
||||
|
||||
from . import calc
|
||||
from .ad_sources.base import ACCOUNTS_KEY
|
||||
from .ad_sources.tiktok_ads import M_REVENUE as TIKTOK_REVENUE_KEY
|
||||
from .manual_upload import MAX_AMOUNT, MAX_DATA_ROWS, MAX_ERRORS, MAX_FILE_BYTES, UploadError, parse_amount, parse_date
|
||||
|
||||
# 채널 — 표 열 순서(2026-10-14 사용자 지정). 쇼핑몰 채널 코드는 실적 쇼핑몰 코드와 같다(쿠팡(윙)만 coupang_wing ↔ 매출 coupang).
|
||||
@@ -44,6 +46,7 @@ CHANNELS: tuple[tuple[str, str], ...] = (
|
||||
("lotteon", "롯데ON"),
|
||||
("toss", "토스"),
|
||||
("atomy", "애터미아자몰"),
|
||||
("etc", "기타광고비"), # 2026-10-22 — 쇼핑몰에 딸리지 않은 광고비(직접 입력), ROAS 없음
|
||||
)
|
||||
CHANNEL_NAMES = dict(CHANNELS)
|
||||
CHANNEL_CODES = tuple(c for c, _ in CHANNELS)
|
||||
@@ -52,8 +55,10 @@ CHANNEL_CODES = tuple(c for c, _ in CHANNELS)
|
||||
# 여러 날(주·월·합계)의 ROAS = Σ(그날 ROAS × 그날 광고비) ÷ Σ광고비(ROAS 가 있는 날만) = 광고 매출 합 ÷ 광고비 합.
|
||||
FILE_ROAS = frozenset({"google", "meta", "naver"})
|
||||
NO_ROAS = FILE_ROAS # 예전 이름(계산 안 하는 채널)
|
||||
ROAS_SALES_CODE: dict[str, str] = {c: c for c in CHANNEL_CODES if c not in FILE_ROAS}
|
||||
NO_SALES = frozenset({"etc"}) # 매출 쇼핑몰이 없는 채널 — ROAS 를 계산하지 않고 매출 탭 광고비 줄에도 안 나온다
|
||||
ROAS_SALES_CODE: dict[str, str] = {c: c for c in CHANNEL_CODES if c not in FILE_ROAS and c not in NO_SALES}
|
||||
ROAS_SALES_CODE["coupang_wing"] = "coupang"
|
||||
TIKTOK = "tiktok" # 광고 API 채널이지만 CHANNELS 에 없다 — 틱톡 탭(build_tiktok_dashboard)에서만 보인다
|
||||
|
||||
|
||||
def roas(sales: int, spend: int) -> int | None:
|
||||
@@ -188,8 +193,6 @@ def parse_coupang_rocket(content: bytes, *, today: date, filename: str = "") ->
|
||||
res.skipped += 1 # 날짜는 있지만 19열이 빈 줄(캠페인 줄 등) — 건너뜀
|
||||
elif abs(amt) > MAX_AMOUNT:
|
||||
res.errors.append(f"{r}행 19열: 금액이 너무 큽니다.")
|
||||
elif day > today:
|
||||
res.errors.append(f"{r}행: 앞으로의 날짜({day.isoformat()})는 입력할 수 없습니다.")
|
||||
else:
|
||||
sums[day] = sums.get(day, 0) + amt # 같은 날짜에 값이 있는 줄이 여럿이면 더한다
|
||||
if len(sums) > MAX_DATA_ROWS:
|
||||
@@ -227,11 +230,50 @@ def _json_num(num: Decimal | None) -> Any:
|
||||
return int(num) if num == num.to_integral_value() else float(round(num, 2))
|
||||
|
||||
|
||||
def _norm(name: Any) -> str:
|
||||
return str(name or "").replace(" ", "")
|
||||
|
||||
|
||||
# 네이버 보고서 ROAS = "구매완료 광고수익률(%)"(2026-10-20 사용자 확인). 그 칸이 없거나 비면
|
||||
# 구매완료 전환매출액 ÷ 총비용 × 100 으로 계산한다(같은 정의 — 총 전환매출액은 정의가 달라 쓰지 않음).
|
||||
NAVER_ROAS_KEY = "구매완료광고수익률"
|
||||
NAVER_REVENUE_KEY = "구매완료전환매출액"
|
||||
|
||||
|
||||
def roas_from_metrics(metrics: Mapping[str, Any] | None, amount: int | None) -> Decimal | None:
|
||||
"""보고서 항목(머리글 → 값)에서 ROAS(%) — 광고수익률 칸, 없으면 전환매출액 ÷ 광고비. 못 구하면 None.
|
||||
저장된 roas 가 빈 예전 업로드(열 위치가 달라 12열이 비었던 파일)도 이것으로 다시 구한다(db.ad_roas)."""
|
||||
if not isinstance(metrics, Mapping):
|
||||
return None
|
||||
for key in (NAVER_ROAS_KEY, NAVER_REVENUE_KEY):
|
||||
for k, v in metrics.items():
|
||||
if key not in _norm(k) or isinstance(v, bool) or not isinstance(v, (int, float, Decimal)):
|
||||
continue
|
||||
if key == NAVER_ROAS_KEY:
|
||||
return Decimal(str(v))
|
||||
if amount and int(amount) > 0:
|
||||
return (Decimal(str(v)) * 100 / int(amount)).quantize(Decimal("0.01"), rounding=ROUND_HALF_UP)
|
||||
return None
|
||||
|
||||
|
||||
def _naver_cols(header: tuple[str, ...]) -> tuple[int, int | None]:
|
||||
"""머리글로 (총비용 열, ROAS 열) 찾기 — 네이버 보고서는 열 구성을 바꿀 수 있어 고정 위치(4열·12열)가 어긋난다.
|
||||
머리글에 없으면 예전 고정 위치. ROAS 는 머리글은 있는데 광고수익률 칸이 없으면 None(전환매출액으로 계산)."""
|
||||
names = [_norm(h) for h in header]
|
||||
amount = next((i for i, n in enumerate(names) if n.startswith("총비용")), NAVER_AMOUNT_COL)
|
||||
roas_col = next((i for i, n in enumerate(names) if NAVER_ROAS_KEY in n), None)
|
||||
if roas_col is None and not any(names):
|
||||
roas_col = NAVER_ROAS_COL
|
||||
return amount, roas_col
|
||||
|
||||
|
||||
def parse_naver(content: bytes, *, today: date, filename: str = "") -> ParseResult:
|
||||
"""네이버 광고 보고서 → (날짜, 총비용) + 그날 ROAS(12열) + 나머지 항목. 잘못된 줄이 있으면 errors."""
|
||||
"""네이버 광고 보고서 → (날짜, 총비용) + 그날 ROAS(구매완료 광고수익률) + 나머지 항목. 잘못된 줄이 있으면 errors.
|
||||
총비용·ROAS 열은 머리글 이름으로 찾는다(없으면 4열·12열)."""
|
||||
rows = read_rows(content, filename)
|
||||
res = ParseResult()
|
||||
header: tuple[Any, ...] = ()
|
||||
amount_col, roas_col = NAVER_AMOUNT_COL, NAVER_ROAS_COL
|
||||
seen: dict[date, int] = {}
|
||||
for r, row in enumerate(rows, start=1):
|
||||
raw_day = row[NAVER_DATE_COL] if len(row) > NAVER_DATE_COL else None
|
||||
@@ -244,6 +286,7 @@ def parse_naver(content: bytes, *, today: date, filename: str = "") -> ParseResu
|
||||
except ValueError:
|
||||
if not header: # 머리글(1행 "기간")
|
||||
header = tuple(str(h or "").strip() for h in row)
|
||||
amount_col, roas_col = _naver_cols(header)
|
||||
res.columns = [h for i, h in enumerate(header) if i not in NAVER_SKIP_COLS and h]
|
||||
res.skipped += 1
|
||||
continue
|
||||
@@ -253,28 +296,24 @@ def parse_naver(content: bytes, *, today: date, filename: str = "") -> ParseResu
|
||||
res.skipped += 1
|
||||
continue
|
||||
try:
|
||||
amt = parse_amount(row[NAVER_AMOUNT_COL] if len(row) > NAVER_AMOUNT_COL else None)
|
||||
amt = parse_amount(row[amount_col] if len(row) > amount_col else None)
|
||||
except ValueError:
|
||||
res.errors.append(f"{r}행 4열: 총비용이 숫자가 아닙니다.")
|
||||
res.errors.append(f"{r}행 {amount_col + 1}열: 총비용이 숫자가 아닙니다.")
|
||||
continue
|
||||
try:
|
||||
ro = _number(row[NAVER_ROAS_COL] if len(row) > NAVER_ROAS_COL else None)
|
||||
ro = _number(row[roas_col] if roas_col is not None and len(row) > roas_col else None)
|
||||
except ValueError:
|
||||
res.errors.append(f"{r}행 12열: 광고수익률(ROAS)이 숫자가 아닙니다.")
|
||||
res.errors.append(f"{r}행 {(roas_col or 0) + 1}열: 광고수익률(ROAS)이 숫자가 아닙니다.")
|
||||
continue
|
||||
if amt is None:
|
||||
res.errors.append(f"{r}행 4열: {day.isoformat()} 총비용이 비어 있습니다.")
|
||||
res.errors.append(f"{r}행 {amount_col + 1}열: {day.isoformat()} 총비용이 비어 있습니다.")
|
||||
elif abs(amt) > MAX_AMOUNT or (ro is not None and abs(ro) > Decimal("10000000")):
|
||||
res.errors.append(f"{r}행: 금액·ROAS 가 너무 큽니다.")
|
||||
elif day > today:
|
||||
res.errors.append(f"{r}행: 앞으로의 날짜({day.isoformat()})는 입력할 수 없습니다.")
|
||||
elif day in seen:
|
||||
res.errors.append(f"{r}행: {day.isoformat()} 이 {seen[day]}행과 겹칩니다.")
|
||||
else:
|
||||
seen[day] = r
|
||||
res.entries.append((day, amt))
|
||||
if ro is not None:
|
||||
res.roas[day] = ro
|
||||
m: dict[str, Any] = {}
|
||||
for i, v in enumerate(row):
|
||||
name = header[i] if i < len(header) else f"{i + 1}열"
|
||||
@@ -285,6 +324,10 @@ def parse_naver(content: bytes, *, today: date, filename: str = "") -> ParseResu
|
||||
except ValueError:
|
||||
m[name] = str(v)[:100]
|
||||
res.metrics[day] = m
|
||||
if ro is None:
|
||||
ro = roas_from_metrics(m, amt) # 광고수익률 칸이 없거나 빈 파일 — 전환매출액 ÷ 총비용
|
||||
if ro is not None:
|
||||
res.roas[day] = ro
|
||||
if len(res.entries) > MAX_DATA_ROWS:
|
||||
raise UploadError(f"한 번에 {MAX_DATA_ROWS:,}일까지 올릴 수 있습니다.")
|
||||
if len(res.errors) > MAX_ERRORS:
|
||||
@@ -341,8 +384,8 @@ def merge_results(parsed: list[tuple[str, float, ParseResult]]) -> tuple[ParseRe
|
||||
return merged, sorted(overlap)
|
||||
|
||||
|
||||
# 머리글을 누르면 일자별 상세 표가 열리는 채널(보고서 항목을 보관하는 채널) — 구글은 광고 API 로 가져온 항목(2026-10-15)
|
||||
DETAIL_CHANNELS = frozenset({"naver", "google"})
|
||||
# 머리글을 누르면 일자별 상세 표가 열리는 채널(보고서 항목을 보관하는 채널) — 구글(2026-10-15)·메타(2026-10-16)는 광고 API 로 가져온 항목
|
||||
DETAIL_CHANNELS = frozenset({"naver", "google", "meta"})
|
||||
|
||||
|
||||
def detail_table(rows: list[dict[str, Any]]) -> dict[str, Any]:
|
||||
@@ -351,11 +394,13 @@ def detail_table(rows: list[dict[str, Any]]) -> dict[str, Any]:
|
||||
cols: list[str] = []
|
||||
for r in rows:
|
||||
for k in (r.get("metrics") or {}):
|
||||
if k not in cols:
|
||||
if k not in cols and not k.startswith("_"): # "_" 키 = 표 열이 아닌 내부 값(계정별 등)
|
||||
cols.append(k)
|
||||
sums: dict[str, Decimal] = {}
|
||||
for r in rows:
|
||||
for k, v in (r.get("metrics") or {}).items():
|
||||
if k.startswith("_"):
|
||||
continue
|
||||
if isinstance(v, (int, float)) and not isinstance(v, bool):
|
||||
sums[k] = sums.get(k, Decimal(0)) + Decimal(str(v))
|
||||
total: dict[str, Any] = {k: _json_num(v) for k, v in sums.items()}
|
||||
@@ -367,15 +412,151 @@ def detail_table(rows: list[dict[str, Any]]) -> dict[str, Any]:
|
||||
rev = sum(Decimal(str(r["roas"])) * int(r.get("amount") or 0) for r in rows
|
||||
if r.get("roas") is not None and int(r.get("amount") or 0) > 0)
|
||||
total[k] = float(round(rev / spend, 2)) if spend else None
|
||||
elif "환율" in k: # 외화 광고 계정 적용 환율(메타 USD 계정, 2026-10-16) — 더하지 않고 광고비 가중 평균
|
||||
pairs = [(Decimal(str((r.get("metrics") or {})[k])), int(r.get("amount") or 0)) for r in rows
|
||||
if isinstance((r.get("metrics") or {}).get(k), (int, float)) and int(r.get("amount") or 0) > 0]
|
||||
weight = sum(w for _v, w in pairs)
|
||||
total[k] = float(round(sum(v * w for v, w in pairs) / weight, 2)) if weight else None
|
||||
out_rows = [{"date": r["date"], "amount": int(r.get("amount") or 0),
|
||||
"roas": float(r["roas"]) if r.get("roas") is not None else None,
|
||||
"values": r.get("metrics") or {}} for r in rows]
|
||||
return {"columns": cols, "rows": out_rows, "total": total}
|
||||
"values": {k: v for k, v in (r.get("metrics") or {}).items() if not k.startswith("_")}} for r in rows]
|
||||
cols, labels = _roas_next_to_spend(cols)
|
||||
return {"columns": cols, "labels": labels, "rows": out_rows, "total": total}
|
||||
|
||||
|
||||
# 상세 표의 광고비 열 — 네이버 "총비용"(4열), 구글 "광고비(부가세 포함)", 메타 "지출 금액(부가세 포함)"
|
||||
_SPEND_COL_MARKS = ("총비용", "광고비(", "지출 금액(부가세")
|
||||
|
||||
|
||||
def _roas_next_to_spend(cols: list[str]) -> tuple[list[str], dict[str, str]]:
|
||||
"""ROAS 열을 광고비 열 바로 오른쪽으로 옮긴다(2026-10-20 사용자 요청 — 네이버 파일은 12열이라 멀리 떨어져 있었다).
|
||||
네이버 "구매완료 광고수익률(%)" 은 머리글을 "ROAS(%)" 로 보여 준다(값·키는 파일 머리글 그대로, labels 로만).
|
||||
반환: (열 순서, {열: 화면 머리글})."""
|
||||
roas_col = next((k for k in cols if "수익률" in k or "ROAS" in k.upper()), None)
|
||||
spend_col = next((k for k in cols if any(m in k for m in _SPEND_COL_MARKS)), None)
|
||||
labels: dict[str, str] = {}
|
||||
if roas_col is None:
|
||||
return cols, labels
|
||||
if "ROAS" not in roas_col.upper():
|
||||
labels[roas_col] = "ROAS(%)"
|
||||
if spend_col is None:
|
||||
return cols, labels
|
||||
out = [k for k in cols if k != roas_col]
|
||||
out.insert(out.index(spend_col) + 1, roas_col)
|
||||
return out, labels
|
||||
|
||||
|
||||
def detail_tabs(rows: list[dict[str, Any]]) -> dict[str, Any]:
|
||||
"""상세보기 탭 — 계정별 값(ACCOUNTS_KEY)이 있는 채널(메타, 2026-10-16)은 [합계 | 계정…], 없으면 탭 없음.
|
||||
계정 탭 = 그 계정이 광고를 낸 날만(그날 행의 계정 값으로 detail_table). 계정 이름은 가장 최근 날의 이름,
|
||||
순서는 기간 광고비가 큰 계정부터(같으면 이름). accounts_missing = 광고비가 있는데 계정별 값이 없는 날 수
|
||||
(계정별 저장 전에 가져온 날 — 다시 불러오면 생긴다)."""
|
||||
per: dict[str, list[dict[str, Any]]] = {}
|
||||
names: dict[str, str] = {}
|
||||
missing = 0
|
||||
for r in rows:
|
||||
accs = (r.get("metrics") or {}).get(ACCOUNTS_KEY)
|
||||
if not isinstance(accs, dict):
|
||||
if int(r.get("amount") or 0):
|
||||
missing += 1
|
||||
continue
|
||||
for acc, a in accs.items():
|
||||
if not isinstance(a, dict):
|
||||
continue
|
||||
names[acc] = str(a.get("name") or f"act_{acc}")
|
||||
per.setdefault(acc, []).append({"date": r["date"], "amount": int(a.get("amount") or 0),
|
||||
"roas": a.get("roas"), "metrics": a.get("metrics") or {}})
|
||||
if not per:
|
||||
return {"tabs": [], "accounts_missing": 0}
|
||||
spend = {acc: sum(x["amount"] for x in days) for acc, days in per.items()}
|
||||
order = sorted(per, key=lambda acc: (-spend[acc], names[acc]))
|
||||
tabs = [{"key": "total", "label": "합계", **detail_table(rows)}]
|
||||
tabs += [{"key": acc, "label": names[acc], "account_id": acc, **detail_table(per[acc])} for acc in order]
|
||||
return {"tabs": tabs, "accounts_missing": missing}
|
||||
|
||||
|
||||
# ════════════════════════════════════════════════════════════
|
||||
# 화면 데이터
|
||||
# ════════════════════════════════════════════════════════════
|
||||
def _period_word(period: Any, today: date) -> str:
|
||||
"""KPI 이름 앞 말 — 이번달·해당 월 등."""
|
||||
return {"day": "오늘" if period.start == today else "해당일",
|
||||
"week": "이번주" if period.start <= today <= period.end else "해당 주",
|
||||
"month": "이번달" if period.start <= today <= period.end else "해당 월",
|
||||
"year": "올해" if period.start <= today <= period.end else "해당 연도",
|
||||
"custom": "선택 기간"}[period.kind]
|
||||
|
||||
|
||||
def _period_nav(period: Any, today: date) -> dict[str, Any]:
|
||||
"""기간 이동 화살표·빠른 선택(이번달·올해만 — 2026-10-26 오늘·이번주 버튼 삭제, 매출 실적과 같게)."""
|
||||
def url(k: str, anchor_d: date | None = None, start: date | None = None, end: date | None = None) -> str:
|
||||
if k == "custom":
|
||||
return f"?period=custom&from={start.isoformat()}&to={end.isoformat()}"
|
||||
return f"?period={k}&d={anchor_d.isoformat()}"
|
||||
|
||||
if period.kind == "custom":
|
||||
length = timedelta(days=period.days)
|
||||
prev_url = url("custom", start=period.start - length, end=period.start - timedelta(days=1))
|
||||
next_url = url("custom", start=period.end + timedelta(days=1), end=period.end + length)
|
||||
else:
|
||||
prev_url, next_url = url(period.kind, period.prev_anchor), url(period.kind, period.next_anchor)
|
||||
return {"prev": prev_url, "next": next_url, "quick": [
|
||||
{"label": "이번달", "url": url("month", today), "active": period.kind == "month" and period.start <= today <= period.end},
|
||||
{"label": "올해", "url": url("year", today), "active": period.kind == "year" and period.start <= today <= period.end},
|
||||
]}
|
||||
|
||||
|
||||
def build_tiktok_dashboard(store: Any, *, kind: str, anchor: date, today: date, custom_from: date | None = None,
|
||||
custom_to: date | None = None, holidays: Mapping[str, str] | None = None) -> dict[str, Any]:
|
||||
"""틱톡 탭(2026-11-05) — 광고비 탭과 같은 기간 이동·표·그래프, 열 = ROAS·광고비·매출. 광고 API 가 저장한 perf_ad_spend 만 읽는다.
|
||||
CHANNELS 에 없어 광고비 탭·매출 실적 합계에는 들어가지 않는다."""
|
||||
period = calc.resolve_period(kind, anchor, custom_from=custom_from, custom_to=custom_to)
|
||||
cmp_start, cmp_end, cmp_label = period.compare_range(today)
|
||||
ref = period.end if period.end < today else today if period.start <= today else period.start
|
||||
year_period = calc.resolve_period("year", ref)
|
||||
migration_needed = False
|
||||
try:
|
||||
rows = store.ad_details(TIKTOK, min(period.start, cmp_start, year_period.start), max(period.end, year_period.end))
|
||||
except AdMigrationNeeded:
|
||||
rows, migration_needed = [], True
|
||||
cells: dict[tuple[date, str], calc.Money] = {}
|
||||
for r in rows:
|
||||
d = date.fromisoformat(r["date"])
|
||||
cells[(d, "spend")] = calc.Money(gross=int(r["amount"] or 0))
|
||||
cells[(d, "sales")] = calc.Money(gross=int((r["metrics"] or {}).get(TIKTOK_REVENUE_KEY) or 0))
|
||||
|
||||
table = calc.main_table(period, ("spend", "sales"), cells, today=today, holidays=holidays)
|
||||
for row in table:
|
||||
row["roas"] = roas(row["cells"]["sales"]["gross"], row["cells"]["spend"]["gross"])
|
||||
cur = {c: calc.sum_range(cells, [c], period.start, period.end).gross for c in ("spend", "sales")}
|
||||
prev = {c: calc.sum_range(cells, [c], cmp_start, cmp_end).gross for c in ("spend", "sales")}
|
||||
word = _period_word(period, today)
|
||||
spend_y = calc.year_months(year_period.start.year, ["spend"], cells, today=today)
|
||||
sales_y = calc.year_months(year_period.start.year, ["sales"], cells, today=today)
|
||||
year_rows = [{"label": a["label"], "future": a["future"], "spend": a["gross"], "sales": b["gross"],
|
||||
"roas": None if a["future"] else roas(b["gross"], a["gross"])}
|
||||
for a, b in zip(spend_y["rows"], sales_y["rows"])]
|
||||
return {
|
||||
"nav": _period_nav(period, today),
|
||||
"period": period,
|
||||
"period_kind": period.kind,
|
||||
"today": today.isoformat(),
|
||||
"kpis": [
|
||||
{"key": "spend", "label": f"{word} 광고비", "value": cur["spend"], "primary": True,
|
||||
"delta": calc.pct_change(cur["spend"], prev["spend"]), "cmp": cmp_label, "invert": True},
|
||||
{"key": "sales", "label": f"{word} 매출", "value": cur["sales"],
|
||||
"delta": calc.pct_change(cur["sales"], prev["sales"]), "cmp": cmp_label},
|
||||
{"key": "roas", "label": f"{word} ROAS", "pct": roas(cur["sales"], cur["spend"])},
|
||||
],
|
||||
"table": table,
|
||||
"chart_sales": calc.daily_series(period, ["sales"], cells),
|
||||
"chart_spend": calc.daily_series(period, ["spend"], cells),
|
||||
"year": {"year": year_period.start.year, "rows": year_rows, "spend": spend_y["total"]["gross"], "sales": sales_y["total"]["gross"],
|
||||
"roas": roas(sales_y["total"]["gross"], spend_y["total"]["gross"])},
|
||||
"migration_needed": migration_needed,
|
||||
}
|
||||
|
||||
|
||||
def build_ad_dashboard(store: Any, *, kind: str, anchor: date, today: date,
|
||||
custom_from: date | None = None, custom_to: date | None = None,
|
||||
holidays: Mapping[str, str] | None = None,
|
||||
@@ -407,8 +588,6 @@ def build_ad_dashboard(store: Any, *, kind: str, anchor: date, today: date,
|
||||
|
||||
cur = calc.sum_range(cells, codes, period.start, period.end)
|
||||
prev = calc.sum_range(cells, codes, cmp_start, cmp_end)
|
||||
mtd = calc.sum_range(cells, codes, month_period.start, month_period.end)
|
||||
m_prev = calc.sum_range(cells, codes, m_cmp_start, m_cmp_end)
|
||||
ytd = calc.sum_range(cells, codes, year_period.start, year_period.end)
|
||||
y_prev = calc.sum_range(cells, codes, y_cmp_start, y_cmp_end)
|
||||
|
||||
@@ -424,42 +603,17 @@ def build_ad_dashboard(store: Any, *, kind: str, anchor: date, today: date,
|
||||
sales_total = sales_sum(total_codes, period.start, period.end) if total_codes else None
|
||||
ratio = round(cur.gross / sales_total * 100, 1) if sales_total and sales_total > 0 else None
|
||||
|
||||
word = {"day": "오늘" if period.start == today else "해당일",
|
||||
"week": "이번주" if period.start <= today <= period.end else "해당 주",
|
||||
"month": "이번달" if period.start <= today <= period.end else "해당 월",
|
||||
"year": "올해" if period.start <= today <= period.end else "해당 연도",
|
||||
"custom": "선택 기간"}[period.kind]
|
||||
word = _period_word(period, today)
|
||||
kpis = [
|
||||
{"key": "spend", "label": f"{word} 광고비", "value": cur.gross, "primary": True,
|
||||
"delta": calc.pct_change(cur.gross, prev.gross), "cmp": cmp_label, "invert": True},
|
||||
{"key": "ratio", "label": f"{word} 매출 대비 광고비", "pct": ratio,
|
||||
"note": f"총매출 ₩{sales_total:,}" if sales_total else "매출 없음"},
|
||||
{"key": "mtd", "label": f"{month_period.label} 누적 광고비", "value": mtd.gross,
|
||||
"delta": calc.pct_change(mtd.gross, m_prev.gross), "cmp": m_cmp_label, "invert": True},
|
||||
{"key": "ytd", "label": f"{year_period.label} 누적 광고비", "value": ytd.gross,
|
||||
"delta": calc.pct_change(ytd.gross, y_prev.gross), "cmp": y_cmp_label, "invert": True},
|
||||
]
|
||||
|
||||
def url(k: str, anchor_d: date | None = None, start: date | None = None, end: date | None = None) -> str:
|
||||
if k == "custom":
|
||||
return f"?period=custom&from={start.isoformat()}&to={end.isoformat()}"
|
||||
return f"?period={k}&d={anchor_d.isoformat()}"
|
||||
|
||||
if period.kind == "custom":
|
||||
from datetime import timedelta # noqa: WPS433
|
||||
|
||||
length = timedelta(days=period.days)
|
||||
prev_url = url("custom", start=period.start - length, end=period.start - timedelta(days=1))
|
||||
next_url = url("custom", start=period.end + timedelta(days=1), end=period.end + length)
|
||||
else:
|
||||
prev_url, next_url = url(period.kind, period.prev_anchor), url(period.kind, period.next_anchor)
|
||||
nav = {"prev": prev_url, "next": next_url, "quick": [
|
||||
{"label": "오늘", "url": url("day", today), "active": period.kind == "day" and period.start == today},
|
||||
{"label": "이번주", "url": url("week", today), "active": period.kind == "week" and period.start <= today <= period.end},
|
||||
{"label": "이번달", "url": url("month", today), "active": period.kind == "month" and period.start <= today <= period.end},
|
||||
{"label": "올해", "url": url("year", today), "active": period.kind == "year" and period.start <= today <= period.end},
|
||||
]}
|
||||
|
||||
nav = _period_nav(period, today)
|
||||
share = calc.by_code(cells, codes, period.start, period.end)
|
||||
month = calc.month_summary(month_period.start.year, month_period.start.month, codes, cells)
|
||||
table = calc.main_table(period, codes, cells, today=today, holidays=holidays)
|
||||
@@ -501,6 +655,13 @@ def build_ad_dashboard(store: Any, *, kind: str, anchor: date, today: date,
|
||||
# 광고 API(구글 광고 등)로 가져온 칸 — 표시용(초록 숫자)
|
||||
"api_cells": sorted(f"{d.isoformat()}|{c}" for (d, c), s in sources.items()
|
||||
if s == "api" and period.start <= d <= period.end),
|
||||
# 계산식으로 입력한 칸(마이그레이션 008) — "날짜|채널" → 식(파랑 굵은 숫자, 누르면 식)
|
||||
"formula_cells": {f"{d.isoformat()}|{c}": f for (d, c), f in
|
||||
(store.ad_formulas(period.start, period.end) if hasattr(store, "ad_formulas")
|
||||
and not migration_needed else {}).items()},
|
||||
"upload_channels": [{"code": c, "name": CHANNEL_NAMES[c], "help": UPLOAD_HELP.get(c, "")} for c in PARSERS],
|
||||
"migration_needed": migration_needed,
|
||||
# 날짜 칸 메모(마이그레이션 010) — "날짜|채널" → 메모
|
||||
"memo_cells": {f"{d.isoformat()}|{c}": m for (d, c), m in
|
||||
(store.cell_memos("ad", period.start, period.end) if hasattr(store, "cell_memos") else {}).items()},
|
||||
}
|
||||
|
||||
@@ -1,6 +1,7 @@
|
||||
"""광고 API 가져오기 — 인증정보(perf_ad_credentials) → 광고 연동(ad_sources) → perf_ad_spend(source='api').
|
||||
|
||||
- 광고비 탭 [구글 광고 불러오기](보고 있는 기간) · 매출 자동 업데이트 회차(최근 N일, auto_sync) · 실적 설정 연결 테스트가 쓴다.
|
||||
- 광고비 탭 [광고비 업데이트](보고 있는 기간, 진행 창 — jobs kind="ads", 2026-10-20) · 매출 자동 업데이트와 같은 회차
|
||||
(최근 N일, auto_sync) · 실적 설정 연결 테스트가 쓴다. 진행 창에서 채널별 [중지]·[업데이트 취소] = 저장 직전까지 받아들임.
|
||||
- 같은 광고 채널은 동시에 한 번만(프로세스 안 잠금) — 두 번째 요청은 바로 "진행 중" 오류.
|
||||
- 저장은 기간 단위 한 트랜잭션(db.replace_ad_api_range): API 가 준 날은 덮어쓰고, 안 준 날은 예전 API 값만 지운다.
|
||||
- 오류 문구는 저장된 비밀값을 가린 뒤 기록·반환한다(security.redact).
|
||||
@@ -14,7 +15,7 @@ from datetime import date
|
||||
from typing import Any, Callable
|
||||
|
||||
from .ad_sources.registry import all_sources, get_source
|
||||
from .adapters.base import STATUS_LABELS, AdapterContext, AdapterError
|
||||
from .adapters.base import STATUS_LABELS, AdapterContext, AdapterError, Cancelled
|
||||
from .credentials import CredentialService
|
||||
from .db import AdCredentialTable
|
||||
from .security.redact import redact_text
|
||||
@@ -22,6 +23,7 @@ from .security.redact import redact_text
|
||||
logger = logging.getLogger("performance.ad_sync")
|
||||
|
||||
AD_NS = "ad:" # 광고 인증정보 암호문 이름 공간(credentials.aad_for)
|
||||
AD_MESSAGE_MAX = 1200 # 광고 연동 오류 문구 길이 한도(비밀값 가린 뒤)
|
||||
_locks: dict[str, threading.Lock] = {}
|
||||
_locks_guard = threading.Lock()
|
||||
|
||||
@@ -57,7 +59,8 @@ class AdSyncService:
|
||||
@staticmethod
|
||||
def _message(exc: Exception, ctx: AdapterContext) -> str:
|
||||
known = getattr(ctx.credentials, "known_secrets", lambda: [])()
|
||||
return redact_text(str(getattr(exc, "message", "") or exc), known)
|
||||
# 광고 연동 오류는 고칠 곳 안내·진단이 붙어 길다 — 기본 300자에서 자르면 안내가 잘린다(2026-10-16 메타 #200 진단)
|
||||
return redact_text(str(getattr(exc, "message", "") or exc), known, max_len=AD_MESSAGE_MAX)
|
||||
|
||||
def test_connection(self, code: str, *, values: dict[str, str] | None = None, user: str = "",
|
||||
cleared: set[str] | None = None) -> dict[str, Any]:
|
||||
@@ -82,8 +85,9 @@ class AdSyncService:
|
||||
return {"ok": ok, "status": status, "label": STATUS_LABELS.get(status, status), "message": msg,
|
||||
"unsaved": trial}
|
||||
|
||||
def sync(self, code: str, start: date, end: date, *, user: str = "") -> dict[str, Any]:
|
||||
"""기간 가져오기 → 저장. 결과 {ok, days, total, from, to} 또는 {ok: False, status, message}. 진행 중이면 AdSyncBusy."""
|
||||
def sync(self, code: str, start: date, end: date, *, user: str = "", progress: Any = None) -> dict[str, Any]:
|
||||
"""기간 가져오기 → 저장. 결과 {ok, days, total, from, to} 또는 {ok: False, status, message}. 진행 중이면 AdSyncBusy.
|
||||
progress(jobs.ShopProgress) 를 주면 수집(절반) → 저장 → 완료로 알리고, 저장 직전 중지·취소를 받아 Cancelled."""
|
||||
src = get_source(code)
|
||||
if src is None:
|
||||
raise KeyError(code)
|
||||
@@ -94,7 +98,14 @@ class AdSyncService:
|
||||
ctx = self._ctx(code, user=user)
|
||||
try:
|
||||
src.require_configured(ctx)
|
||||
if progress is not None:
|
||||
progress.plan(2, "단계")
|
||||
days = src.fetch_days(ctx, start, end)
|
||||
if progress is not None:
|
||||
progress.step(1, items=len(days))
|
||||
progress.begin_saving() # 여기까지 받은 [중지]·[취소]는 저장하지 않고 멈춤
|
||||
except Cancelled:
|
||||
raise # 오류가 아니다 — 상태 기록 없이 sync_all 이 "중지됨/취소됨"
|
||||
except AdapterError as exc:
|
||||
msg = self._message(exc, ctx)
|
||||
self._store.record_ad_status(code, status=exc.status, ok=False, error=msg, kind="sync")
|
||||
@@ -108,17 +119,65 @@ class AdSyncService:
|
||||
finally:
|
||||
lock.release()
|
||||
|
||||
def sync_all(self, start: date, end: date, *, user: str = "") -> list[dict[str, Any]]:
|
||||
"""설정이 끝난 광고 연동 전부(자동 업데이트 회차). 채널별로 실패를 격리한다."""
|
||||
def sync_all(self, start: date, end: date, *, user: str = "", job: Any = None) -> list[dict[str, Any]]:
|
||||
"""설정이 끝난 광고 연동 전부([광고비 업데이트]·자동 업데이트 회차). 채널별로 실패를 격리한다.
|
||||
job(jobs.SyncJob kind="ads") 을 주면 채널별 진행 막대로 알린다."""
|
||||
codes = [c for c, ok in self.configured().items() if ok]
|
||||
shops = job.set_targets([(c, get_source(c).name, True) for c in codes], start, end) if job is not None else {}
|
||||
out = []
|
||||
for code, ok in self.configured().items():
|
||||
if not ok:
|
||||
for code in codes:
|
||||
prog = shops.get(code)
|
||||
if prog is not None and prog.cancel_requested: # 차례가 오기 전에 중지·취소됨
|
||||
prog.cancelled()
|
||||
out.append({"ok": False, "code": code, "cancelled": True})
|
||||
continue
|
||||
if prog is not None:
|
||||
prog.start()
|
||||
try:
|
||||
out.append(self.sync(code, start, end, user=user))
|
||||
res = self.sync(code, start, end, user=user, progress=prog)
|
||||
except Cancelled:
|
||||
if prog is not None:
|
||||
prog.cancelled()
|
||||
out.append({"ok": False, "code": code, "cancelled": True})
|
||||
continue
|
||||
except AdSyncBusy as exc:
|
||||
out.append({"ok": False, "code": code, "skipped": True, "message": str(exc)})
|
||||
res = {"ok": False, "code": code, "skipped": True, "message": str(exc)}
|
||||
except Exception as exc: # noqa: BLE001 — 다음 채널은 계속
|
||||
logger.exception("ad sync failed: %s", code)
|
||||
out.append({"ok": False, "code": code, "message": f"가져오기 중 오류: {type(exc).__name__}"})
|
||||
res = {"ok": False, "code": code, "status": "api_error", "label": STATUS_LABELS["api_error"],
|
||||
"message": f"가져오기 중 오류: {type(exc).__name__}"}
|
||||
if prog is not None:
|
||||
if res.get("ok"):
|
||||
prog.finish(upserted=int(res.get("days") or 0),
|
||||
message=f"광고비 ₩{int(res.get('total') or 0):,}")
|
||||
elif res.get("skipped"):
|
||||
prog.skip(str(res.get("message") or ""))
|
||||
else:
|
||||
prog.fail(status=str(res.get("status") or "api_error"), label=str(res.get("label") or ""),
|
||||
message=str(res.get("message") or ""))
|
||||
out.append(res)
|
||||
return out
|
||||
|
||||
|
||||
def run_ad_job(store: Any, ring_loader: Callable[[], Any], job: Any, start: date, end: date, *,
|
||||
user: str = "") -> list[dict[str, Any]]:
|
||||
"""광고비 업데이트 작업 하나를 끝까지 돌리고 job.finish — [광고비 업데이트] 스레드·자동 업데이트 회차가 쓴다."""
|
||||
error, results = "", []
|
||||
try:
|
||||
results = AdSyncService(store, ad_credentials(store, ring_loader)).sync_all(start, end, user=user, job=job)
|
||||
except Exception as exc: # noqa: BLE001 — 스레드 밖으로 새지 않게, 화면에는 "오류"로
|
||||
logger.exception("ad sync job failed")
|
||||
error = f"광고비 업데이트 중 오류: {type(exc).__name__}"
|
||||
if job is not None:
|
||||
job.finish(error=error, last_update_at=last_ad_update_at(store))
|
||||
return results
|
||||
|
||||
|
||||
def last_ad_update_at(store: Any) -> str | None:
|
||||
"""광고비 마지막 업데이트 — 광고 API 채널의 마지막 성공 가져오기 시각 중 가장 최근(없으면 None)."""
|
||||
try:
|
||||
rows = store.ad_source_statuses()
|
||||
except Exception: # noqa: BLE001 — 007 미적용 등
|
||||
return None
|
||||
times = [str(r.get("last_success_sync_at")) for r in rows.values() if r.get("last_success_sync_at")]
|
||||
return max(times) if times else None
|
||||
|
||||
@@ -488,23 +488,27 @@ class Cafe24Adapter(MarketplaceAdapter):
|
||||
marketplace_code=target,
|
||||
event_type="SALE", external_event_id=f"{EVENT_PREFIX}{oid}-PAY", external_order_id=oid,
|
||||
order_date=_day(order.get("order_date")), payment_date=pay_day, event_date=pay_day,
|
||||
amount=max(0, order_total(order)), product_name=name,
|
||||
# 적립금 사용분은 매출에서 뺀다(2026-10-19 사용자 요청) — 결제합계 − 적립금(points_spent_amount)
|
||||
amount=max(0, order_total(order) - order_amounts(order)["points_spent_amount"]), product_name=name,
|
||||
quantity=sum(int(i.get("quantity") or 0) for i in items), order_status="결제완료",
|
||||
discount_amount=sum(order_amounts(order)[k] for k in DISCOUNT_FIELDS + COUPON_FIELDS),
|
||||
raw={"order_id": oid, "market_id": order.get("market_id"), "order_place_id": order.get("order_place_id"),
|
||||
"items": len(items), **{f"initial_{k}": v for k, v in order_amounts(order).items()}},
|
||||
"items": len(items), **{f"initial_{k}": v for k, v in order_amounts(order).items()},
|
||||
"points": order_amounts(order)["points_spent_amount"], "points_excluded": True},
|
||||
)]
|
||||
|
||||
def normalize_refund(self, refund: dict[str, Any]) -> list[SaleEvent]:
|
||||
"""환불 → CANCEL/RETURN(−). 원 주문의 market_id 로 결제와 같은 쇼핑몰 열에 넣는다.
|
||||
금액 = 실제 환불액 + 적립금·예치금 환불(카페24 일별 매출 환불합계와 같음, 실데이터 확인)."""
|
||||
금액 = 실제 환불액 + 예치금 환불 — 적립금으로 돌려준 금액은 뺀다(2026-10-19, 결제에서 적립금을 빼므로 앞뒤를 맞춤.
|
||||
예전 = 카페24 일별 매출 환불합계와 같은 실제 + 적립금·예치금)."""
|
||||
if refund.get("_kind") == "claim":
|
||||
return self.normalize_claim(refund)
|
||||
day = _day(refund.get("refund_date"))
|
||||
code = str(refund.get("refund_code") or "")
|
||||
if day is None or not code:
|
||||
return []
|
||||
amount = refund_total(refund)
|
||||
points = _won(refund.get("used_points"))
|
||||
amount = refund_total(refund) - points
|
||||
return [SaleEvent(
|
||||
marketplace_code=target_code(refund.get("_market_id"), refund.get("_order_place_id")),
|
||||
event_type="RETURN" if code.upper().startswith("R") else "CANCEL",
|
||||
@@ -515,7 +519,8 @@ class Cafe24Adapter(MarketplaceAdapter):
|
||||
raw={"refund_code": code, "order_id": refund.get("order_id"), "status": refund.get("status"),
|
||||
"actual_refund_amount": refund.get("actual_refund_amount"),
|
||||
"used_points": refund.get("used_points"), "used_credits": refund.get("used_credits"),
|
||||
"quantity": refund.get("quantity"), "order_item_code": refund.get("order_item_code")},
|
||||
"quantity": refund.get("quantity"), "order_item_code": refund.get("order_item_code"),
|
||||
"points": -points, "points_excluded": True},
|
||||
)]
|
||||
|
||||
def normalize_claim(self, c: dict[str, Any]) -> list[SaleEvent]:
|
||||
|
||||
@@ -23,3 +23,10 @@ class CoupangRocketAdapter(ManualOnlyAdapter):
|
||||
class AtomyAzmallAdapter(ManualOnlyAdapter):
|
||||
code = "atomy"
|
||||
name = "애터미아자몰"
|
||||
|
||||
|
||||
class CustomManualAdapter(ManualOnlyAdapter):
|
||||
"""실적 설정에서 사용자가 직접 추가한 쇼핑몰(마이그레이션 009, 코드 custom_…) — 이름은 DB(perf_marketplaces.name)."""
|
||||
|
||||
def __init__(self, code: str) -> None:
|
||||
self.code = code
|
||||
|
||||
@@ -13,9 +13,12 @@
|
||||
?from=…&to=…&rangeType=PAYED_DATETIME&pageSize=&page= — 결제일 기준, 한 번에 24시간까지(하루씩 부른다),
|
||||
from 부터 180일 안의 주문만. 응답에 주문·상품주문 상세가 바로 들어 있다(네이버 안내: 소량·조회용 권장 API).
|
||||
- SALE = 주문 하나(`naver:{orderId}`), 날짜 = 결제일(order.paymentDate).
|
||||
금액 = 상품주문들의 결제금액(productOrder.totalPaymentAmount) 합 — 배송비 제외.
|
||||
금액 = 상품주문들의 결제금액(productOrder.totalPaymentAmount) 합 **+ 배송비**(배송 묶음마다 deliveryFeeAmount 한 번, 할인 안 뺌 =
|
||||
판매분석 '배송비', 2026-10-19 사용자 요청·10/18 실데이터 87,500 확인 — 예전엔 배송비 제외). raw = {goods: 상품 결제금액, ship: 배송비}.
|
||||
- 결제 뒤 취소·반품된 상품주문도 결제일 매출에 그대로 둔다(판매금액(총)). 입금대기·미입금 취소만 뺀다.
|
||||
그래서 지난 날짜 매출이 나중에 줄지 않는다. 환불(판매금액(순))은 아직 따로 만들지 않는다.
|
||||
- **환불 = 환불된 날(클레임 완료일)에 뺀다**(2026-10-19): 같은 조회를 rangeType=CLAIM_COMPLETED_DATETIME 으로 하루씩 —
|
||||
그날 취소·반품 완료(CANCELED·RETURNED)된 상품주문마다 CANCEL/RETURN(`naver:{productOrderId}-RF`), 금액 = −totalPaymentAmount.
|
||||
판매분석의 환불금액처럼 결제일이 아니라 환불일 매출에서 빠진다.
|
||||
- 구매자 이름·연락처·주소는 저장하지 않는다.
|
||||
"""
|
||||
|
||||
@@ -173,7 +176,9 @@ def field_summary(records: list[dict[str, str]]) -> list[dict[str, Any]]:
|
||||
def group_orders(items: Iterable[dict[str, Any]], start: date, end: date) -> dict[str, dict[str, Any]]:
|
||||
"""상품주문 → 주문 하나로 합침(결제일이 [start, end] 이고 결제된 것 — 나중에 취소·반품된 것도 포함).
|
||||
금액 = totalPaymentAmount 합(할인 뒤 상품 결제금액, 배송비 제외) = 판매분석 "판매금액(총)".
|
||||
배송비·취소/반품분은 참고용(ship·claimed)으로만 모은다."""
|
||||
배송비(ship) = **배송 묶음(packageNumber, 없으면 주문)마다 deliveryFeeAmount 한 번**(묶음 안 최댓값), 배송비 할인은 빼지 않음 —
|
||||
네이버는 배송비·할인을 상품주문마다 반복해 적는다. 10/18 실데이터: 묶음당 한 번 = 87,500 = 판매분석 배송비
|
||||
(상품주문마다 배송비 − 할인 = 38,500 은 틀림, 2026-10-19 ship_check 로 확인). 취소/반품분은 참고용(claimed)."""
|
||||
orders: dict[str, dict[str, Any]] = {}
|
||||
for c in items:
|
||||
po, od = c.get("productOrder") or {}, c.get("order") or {}
|
||||
@@ -183,13 +188,15 @@ def group_orders(items: Iterable[dict[str, Any]], start: date, end: date) -> dic
|
||||
if not oid or day is None or not (start <= day <= end) or status in EXCLUDED_STATUS:
|
||||
continue
|
||||
o = orders.setdefault(oid, {"orderId": oid, "_day": day, "amount": 0, "ship": 0, "claimed": 0, "qty": 0,
|
||||
"discount": 0, "names": [], "opt": "", "statuses": [],
|
||||
"discount": 0, "names": [], "opt": "", "statuses": [], "_ship_pkg": {},
|
||||
"order_day": _day(od.get("orderDate"))})
|
||||
paid = _won(po.get("totalPaymentAmount"))
|
||||
o["amount"] += paid
|
||||
if status in CLAIMED_STATUS:
|
||||
o["claimed"] += paid
|
||||
o["ship"] += _won(po.get("deliveryFeeAmount")) - _won(po.get("deliveryDiscountAmount"))
|
||||
pkg = str(po.get("packageNumber") or oid)
|
||||
o["_ship_pkg"][pkg] = max(o["_ship_pkg"].get(pkg, 0), _won(po.get("deliveryFeeAmount")))
|
||||
o["ship"] = sum(o["_ship_pkg"].values())
|
||||
o["qty"] += _won(po.get("quantity"))
|
||||
o["discount"] += _won(po.get("productDiscountAmount"))
|
||||
name = str(po.get("productName") or "")
|
||||
@@ -201,6 +208,61 @@ def group_orders(items: Iterable[dict[str, Any]], start: date, end: date) -> dic
|
||||
return orders
|
||||
|
||||
|
||||
def ship_check(items: Iterable[dict[str, Any]], start: date, end: date) -> dict[str, Any]:
|
||||
"""배송비 계산 후보 비교(진단, 2026-10-19) — 네이버는 배송비·배송비 할인을 상품주문마다 적어 같은 주문·배송 묶음 안에서
|
||||
반복될 수 있다. 판매분석 '배송비'와 맞는 셈을 실데이터로 고르려고 후보 합계 + 주문별 상품주문 값(개인정보 없음)을 돌려준다."""
|
||||
rows = []
|
||||
for c in items:
|
||||
po, od = c.get("productOrder") or {}, c.get("order") or {}
|
||||
day = _day(od.get("paymentDate") or po.get("paymentDate"))
|
||||
status = str(po.get("productOrderStatus") or "")
|
||||
if day is None or not (start <= day <= end) or status in EXCLUDED_STATUS:
|
||||
continue
|
||||
rows.append({"order": str(od.get("orderId") or po.get("orderId") or ""), "package": str(po.get("packageNumber") or ""),
|
||||
"status": status, "fee": _won(po.get("deliveryFeeAmount")), "discount": _won(po.get("deliveryDiscountAmount")),
|
||||
"section": _won(po.get("sectionDeliveryFee")), "policy": str(po.get("deliveryPolicyType") or ""),
|
||||
"pay": _won(po.get("totalPaymentAmount")), "qty": _won(po.get("quantity"))})
|
||||
|
||||
def per(key: str) -> dict[str, int]:
|
||||
groups: dict[str, list[dict[str, Any]]] = {}
|
||||
for r in rows:
|
||||
groups.setdefault(r[key] or r["order"], []).append(r)
|
||||
return {"groups": len(groups),
|
||||
"max_fee": sum(max(x["fee"] for x in g) for g in groups.values()),
|
||||
"max_fee_minus_max_discount": sum(max(0, max(x["fee"] for x in g) - max(x["discount"] for x in g)) for g in groups.values()),
|
||||
"sum_fee_minus_sum_discount": sum(max(0, sum(x["fee"] - x["discount"] for x in g)) for g in groups.values()),
|
||||
"with_fee": sum(1 for g in groups.values() if max(x["fee"] for x in g) > 0)}
|
||||
|
||||
orders: dict[str, list[dict[str, Any]]] = {}
|
||||
for r in rows:
|
||||
orders.setdefault(r["order"], []).append({k: r[k] for k in ("package", "status", "fee", "discount", "section", "policy", "pay", "qty")})
|
||||
return {
|
||||
"product_orders": len(rows),
|
||||
"per_product_order": {"fee": sum(r["fee"] for r in rows), "discount": sum(r["discount"] for r in rows),
|
||||
"fee_minus_discount": sum(r["fee"] - r["discount"] for r in rows),
|
||||
"section": sum(r["section"] for r in rows)},
|
||||
"per_order": per("order"), "per_package": per("package"),
|
||||
"orders": [{"order": k, "lines": v} for k, v in sorted(orders.items())],
|
||||
"note": "판매분석 '배송비'와 같은 값의 후보 — 지금 매출 규칙은 per_package.max_fee(묶음마다 배송비 한 번, 할인 안 뺌)",
|
||||
}
|
||||
|
||||
|
||||
def refund_items(items: Iterable[dict[str, Any]], day: date) -> list[dict[str, Any]]:
|
||||
"""클레임 완료일 조회 결과 → 환불 줄(상품주문 하나 = 한 줄). 취소·반품 완료만, 금액 = 그 상품주문 결제금액."""
|
||||
out = []
|
||||
for c in items:
|
||||
po, od = c.get("productOrder") or {}, c.get("order") or {}
|
||||
status = str(po.get("productOrderStatus") or "")
|
||||
if status not in CLAIMED_STATUS:
|
||||
continue
|
||||
out.append({"product_order_id": str(po.get("productOrderId") or c.get("productOrderId") or ""),
|
||||
"order_id": str(od.get("orderId") or po.get("orderId") or ""), "day": day, "status": status,
|
||||
"amount": _won(po.get("totalPaymentAmount")), "qty": _won(po.get("quantity")),
|
||||
"name": str(po.get("productName") or ""), "opt": str(po.get("productOption") or ""),
|
||||
"order_day": _day(od.get("orderDate")), "pay_day": _day(od.get("paymentDate") or po.get("paymentDate"))})
|
||||
return out
|
||||
|
||||
|
||||
# 토큰을 발급한 인증정보 — 이 값들이 바뀌면 저장된 토큰을 쓰지 않고 새로 받는다(credential_fingerprint)
|
||||
TOKEN_KEYS = ("client_id", "client_secret", "account_id")
|
||||
|
||||
@@ -335,11 +397,12 @@ class NaverAdapter(MarketplaceAdapter):
|
||||
return body
|
||||
raise ApiError("네이버 API 호출 제한(429)이 계속됩니다. 잠시 뒤 다시 시도하세요.")
|
||||
|
||||
def _day_items(self, ctx: AdapterContext, d: date) -> list[dict[str, Any]]:
|
||||
"""결제일이 d(한국 시간 0시~23:59:59.999)인 상품주문 전체 — 모든 상태."""
|
||||
def _day_items(self, ctx: AdapterContext, d: date, range_type: str = "PAYED_DATETIME") -> list[dict[str, Any]]:
|
||||
"""기준일(range_type — 결제일 PAYED_DATETIME · 클레임 완료일 CLAIM_COMPLETED_DATETIME)이 d(한국 시간 0시~23:59:59.999)인
|
||||
상품주문 전체 — 모든 상태."""
|
||||
params: dict[str, Any] = {
|
||||
"from": f"{d.isoformat()}T00:00:00.000+09:00", "to": f"{d.isoformat()}T23:59:59.999+09:00",
|
||||
"rangeType": "PAYED_DATETIME", "pageSize": PAGE_SIZE,
|
||||
"rangeType": range_type, "pageSize": PAGE_SIZE,
|
||||
}
|
||||
out: list[dict[str, Any]] = []
|
||||
for page in range(1, MAX_PAGES + 1):
|
||||
@@ -352,8 +415,9 @@ class NaverAdapter(MarketplaceAdapter):
|
||||
raise ApiError(f"네이버 {d.isoformat()} 주문이 {MAX_PAGES}쪽을 넘어 끝까지 받지 못했습니다 — 저장하지 않았습니다.")
|
||||
return out
|
||||
|
||||
def _items(self, ctx: AdapterContext, start: date, end: date) -> Iterable[dict[str, Any]]:
|
||||
ctx.progress.plan((end - start).days + 1, "일") # 진행 막대: 하루 = 한 단계
|
||||
def _items(self, ctx: AdapterContext, start: date, end: date, *, plan: tuple[int, str] | None = None) -> Iterable[dict[str, Any]]:
|
||||
days = (end - start).days + 1
|
||||
ctx.progress.plan(*(plan or (days, "일"))) # 진행 막대: 하루 = 한 단계(매출 업데이트는 결제 + 환불 조회 = 하루 두 단계)
|
||||
d = start
|
||||
while d <= end:
|
||||
rows = self._day_items(ctx, d)
|
||||
@@ -363,7 +427,30 @@ class NaverAdapter(MarketplaceAdapter):
|
||||
|
||||
# ── 수집 ──────────────────────────────────────────────
|
||||
def fetch_orders(self, ctx: AdapterContext, start: date, end: date) -> Iterable[dict[str, Any]]:
|
||||
yield from group_orders(self._items(ctx, start, end), start, end).values()
|
||||
days = (end - start).days + 1
|
||||
yield from group_orders(self._items(ctx, start, end, plan=(days * 2, "일 조회")), start, end).values()
|
||||
|
||||
def fetch_refunds(self, ctx: AdapterContext, start: date, end: date) -> Iterable[dict[str, Any]]:
|
||||
"""환불 — 클레임 완료일이 그날인 상품주문 중 취소·반품 완료(CANCELED·RETURNED)된 것(2026-10-19). 교환·미입금 취소는 아님."""
|
||||
d = start
|
||||
while d <= end:
|
||||
rows = self._day_items(ctx, d, "CLAIM_COMPLETED_DATETIME")
|
||||
ctx.progress.step(items=len(rows))
|
||||
yield from refund_items(rows, d)
|
||||
d += timedelta(days=1)
|
||||
|
||||
def normalize_refund(self, r: dict[str, Any]) -> list[SaleEvent]:
|
||||
if not r.get("amount") or not r.get("product_order_id"):
|
||||
return []
|
||||
is_return = r.get("status") == "RETURNED"
|
||||
return [SaleEvent(
|
||||
event_type="RETURN" if is_return else "CANCEL", external_event_id=f"{EVENT_PREFIX}{r['product_order_id']}-RF",
|
||||
external_order_id=str(r.get("order_id") or r["product_order_id"]), external_line_id=str(r["product_order_id"]),
|
||||
order_date=r.get("order_day"), payment_date=r.get("pay_day"), event_date=r["day"], amount=-int(r["amount"]),
|
||||
product_name=str(r.get("name") or "")[:200], option_name=str(r.get("opt") or "")[:200],
|
||||
quantity=-int(r.get("qty") or 0), order_status="반품완료" if is_return else "취소완료",
|
||||
raw={"product_order_id": r["product_order_id"], "status": r.get("status"), "refund": int(r["amount"])},
|
||||
)]
|
||||
|
||||
def normalize_order(self, o: dict[str, Any]) -> list[SaleEvent]:
|
||||
oid, day = str(o.get("orderId") or ""), o.get("_day")
|
||||
@@ -372,9 +459,12 @@ class NaverAdapter(MarketplaceAdapter):
|
||||
names = o.get("names") or []
|
||||
name = names[0] + (f" 외 {len(names) - 1}건" if len(names) > 1 else "") if names else ""
|
||||
statuses = [STATUS_KO.get(s, s) for s in o.get("statuses") or []]
|
||||
goods, ship = max(0, int(o.get("amount") or 0)), max(0, int(o.get("ship") or 0))
|
||||
return [SaleEvent(
|
||||
event_type="SALE", external_event_id=f"{EVENT_PREFIX}{oid}", external_order_id=oid,
|
||||
order_date=o.get("order_day"), payment_date=day, event_date=day, amount=max(0, int(o.get("amount") or 0)),
|
||||
# 판매금액(총) + 배송비(2026-10-19) — 환불은 환불일에 따로(fetch_refunds)
|
||||
order_date=o.get("order_day"), payment_date=day, event_date=day, amount=goods + ship,
|
||||
raw={"goods": goods, "ship": ship},
|
||||
product_name=name[:200], option_name=str(o.get("opt") or "")[:200], quantity=int(o.get("qty") or 0),
|
||||
discount_amount=max(0, int(o.get("discount") or 0)), order_status="/".join(statuses)[:50],
|
||||
)]
|
||||
@@ -420,5 +510,6 @@ class NaverAdapter(MarketplaceAdapter):
|
||||
"claimed": sum(o["claimed"] for o in day_orders), "ship": sum(o["ship"] for o in day_orders)})
|
||||
d += timedelta(days=1)
|
||||
return {"date": day.isoformat(), "to": to.isoformat(), "probes": probes, "days": days,
|
||||
"ship_check": ship_check(items, day, to),
|
||||
"rule": "결제일 기준 상품주문 totalPaymentAmount 합(할인 뒤, 배송비 제외, 결제 뒤 취소·반품분 포함, "
|
||||
"미입금 제외) = 판매분석 '판매금액(총)'. 취소·반품분·배송비는 참고"}
|
||||
|
||||
@@ -14,7 +14,7 @@ from .gmarket import GmarketAdapter
|
||||
from .gsshop import GsshopAdapter
|
||||
from .kakao import KakaoAdapter
|
||||
from .lotteon import LotteonAdapter
|
||||
from .manual import AtomyAzmallAdapter, CoupangRocketAdapter
|
||||
from .manual import AtomyAzmallAdapter, CoupangRocketAdapter, CustomManualAdapter
|
||||
from .naver import NaverAdapter
|
||||
from .ohouse import OhouseAdapter
|
||||
from .toss import TossAdapter
|
||||
@@ -36,10 +36,18 @@ _ADAPTERS: tuple[MarketplaceAdapter, ...] = (
|
||||
)
|
||||
_BY_CODE = {a.code: a for a in _ADAPTERS}
|
||||
|
||||
# 실적 설정에서 직접 추가한 행(마이그레이션 009) — 쇼핑몰은 수동 입력 전용 어댑터, 그룹은 어댑터 없음(매출 없음)
|
||||
CUSTOM_PREFIX = "custom_"
|
||||
GROUP_PREFIX = "group_"
|
||||
|
||||
|
||||
def all_adapters() -> tuple[MarketplaceAdapter, ...]:
|
||||
return _ADAPTERS
|
||||
|
||||
|
||||
def get_adapter(code: str) -> MarketplaceAdapter | None:
|
||||
return _BY_CODE.get(code)
|
||||
"""코드 → 어댑터. 직접 추가 쇼핑몰(custom_…)은 수동 입력 전용 어댑터, 그룹·모르는 코드는 None."""
|
||||
adapter = _BY_CODE.get(code)
|
||||
if adapter is None and code.startswith(CUSTOM_PREFIX):
|
||||
return CustomManualAdapter(code)
|
||||
return adapter
|
||||
|
||||
@@ -1,16 +1,20 @@
|
||||
"""매출 자동 업데이트 — 웹 프로세스 안 데몬 스레드(프로젝트 마감 알림과 같은 방식).
|
||||
"""매출·광고비 자동 업데이트 — 웹 프로세스 안 데몬 스레드(프로젝트 마감 알림과 같은 방식).
|
||||
|
||||
기본: 매일 09:00 ~ 19:00(KST) 정각·30분마다, 오늘 포함 최근 10일을 [매출 업데이트] 와 같은 방식으로 다시 가져온다.
|
||||
- 매출이 끝나면 설정된 광고 API(구글 광고)도 같은 기간으로 가져온다(ad_sync, 실패해도 매출과 무관).
|
||||
- 진행 창 작업(jobs)으로 돌린다 — 그동안 누가 [매출 업데이트] 를 누르면 새로 시작하지 않고 이 진행 상황을 본다.
|
||||
- 그 시각에 이미 다른 업데이트가 돌고 있으면 그 회차는 건너뛴다(같은 쇼핑몰 동시 실행은 어차피 막혀 있음).
|
||||
- 한 회차가 30분을 넘기면 지나간 회차는 건너뛰고 다음 정각/30분을 기다린다(밀린 회차를 몰아서 돌리지 않음).
|
||||
일정(2026-10-26) — 실적 설정 "자동 업데이트" 카드에서 매출 실적·광고비를 **따로** 정한다(마이그레이션 011 perf_settings,
|
||||
key 'auto_sync'). 종류마다 {enabled, interval(분, 5분 단위, 기본 30), days(0=월 … 6=일), start "HH:MM", end "HH:MM"}.
|
||||
- 회차 = 고른 요일의 start, start+interval, … end 까지(end 와 딱 맞으면 end 도). 시각은 5분 단위, KST.
|
||||
- 저장한 일정은 1분 안에 반영(스레드가 1분마다 다시 읽는다). 저장 값이 없으면(011 미적용 포함) 기본 일정 =
|
||||
매일 env PERFORMANCE_AUTO_SYNC_HOURS(기본 9-19)시 정각 ~ 마지막 시 정각, 30분마다.
|
||||
- 매출 = 진행 창 작업(jobs kind="sales") — 그동안 누가 [매출 업데이트] 를 누르면 새로 시작하지 않고 이 진행 상황을 본다.
|
||||
- 광고비 = 설정된 광고 API(구글·메타) — 광고비 진행 창 작업(jobs kind="ads"). 광고비 탭 [광고비 업데이트]도 같은 진행 상황.
|
||||
- 두 종류의 회차가 같은 시각이면 동시에 돈다(따로 스레드). 그 시각에 이미 같은 종류 업데이트가 돌고 있으면 그 종류는 그 회차를
|
||||
건너뛴다. 한 회차가 간격을 넘기면 지나간 회차는 건너뛰고 다음 회차를 기다린다(밀린 회차를 몰아서 돌리지 않음).
|
||||
- 서버를 켠 시각의 회차는 돌리지 않고 다음 회차부터.
|
||||
|
||||
환경변수(.env)
|
||||
PERFORMANCE_AUTO_SYNC=false 끄기(기본 켜짐)
|
||||
PERFORMANCE_AUTO_SYNC=false 끄기(기본 켜짐) — 끄면 설정 화면 일정과 상관없이 안 돈다
|
||||
PERFORMANCE_AUTO_SYNC_DAYS=10 가져올 기간(오늘 포함 최근 N일, 1~90)
|
||||
PERFORMANCE_AUTO_SYNC_HOURS=9-19 돌리는 시간대(시작시-마지막시, 마지막 시는 정각 회차까지)
|
||||
PERFORMANCE_AUTO_SYNC_HOURS=9-19 설정 화면에서 일정을 저장하기 전 기본 시간대(시작시-마지막시)
|
||||
"""
|
||||
|
||||
from __future__ import annotations
|
||||
@@ -30,7 +34,13 @@ logger = logging.getLogger("performance.auto_sync")
|
||||
AUTO_USER = "자동 업데이트"
|
||||
DEFAULT_DAYS = 10
|
||||
DEFAULT_HOURS = (9, 19)
|
||||
SLOT_MINUTES = 30
|
||||
DEFAULT_INTERVAL = 30
|
||||
INTERVAL_STEP = 5
|
||||
INTERVAL_MAX = 720
|
||||
SETTING_KEY = "auto_sync"
|
||||
KINDS = ("sales", "ads")
|
||||
KIND_NAMES = {"sales": "매출 실적", "ads": "광고비"}
|
||||
WEEKDAYS = ("월", "화", "수", "목", "금", "토", "일")
|
||||
|
||||
_started = False
|
||||
_start_lock = threading.Lock()
|
||||
@@ -61,90 +71,253 @@ def hour_window() -> tuple[int, int]:
|
||||
return first, last
|
||||
|
||||
|
||||
def is_slot(t: datetime, hours: tuple[int, int]) -> bool:
|
||||
"""t(분 단위로 자른 시각)가 회차인가 — 정각·30분, first시 정각 ~ last시 정각."""
|
||||
first, last = hours
|
||||
if t.minute % SLOT_MINUTES:
|
||||
# ════════════════════════════════════════════════════════════
|
||||
# 일정
|
||||
# ════════════════════════════════════════════════════════════
|
||||
def default_schedule() -> dict[str, Any]:
|
||||
first, last = hour_window()
|
||||
return {"enabled": True, "interval": DEFAULT_INTERVAL, "days": list(range(7)),
|
||||
"start": f"{first:02d}:00", "end": f"{last:02d}:00"}
|
||||
|
||||
|
||||
def _minutes(hhmm: str) -> int:
|
||||
h, m = hhmm.split(":")
|
||||
return int(h) * 60 + int(m)
|
||||
|
||||
|
||||
def _time(raw: Any, label: str) -> str:
|
||||
m = re.fullmatch(r"(\d{1,2}):(\d{2})", str(raw or "").strip())
|
||||
if not m or not (0 <= int(m.group(1)) <= 23 and 0 <= int(m.group(2)) <= 59):
|
||||
raise ValueError(f"{label}을 HH:MM 으로 넣어 주세요.")
|
||||
if int(m.group(2)) % INTERVAL_STEP:
|
||||
raise ValueError(f"{label}은 {INTERVAL_STEP}분 단위로 정할 수 있습니다.")
|
||||
return f"{int(m.group(1)):02d}:{m.group(2)}"
|
||||
|
||||
|
||||
def validate_schedule(raw: Any) -> dict[str, Any]:
|
||||
"""설정 화면에서 받은 일정 하나 → 정리한 값. 잘못되면 ValueError(화면에 그대로 보여 줄 문구)."""
|
||||
if not isinstance(raw, dict):
|
||||
raise ValueError("일정 형식이 잘못되었습니다.")
|
||||
on = bool(raw.get("enabled"))
|
||||
try:
|
||||
interval = int(raw.get("interval"))
|
||||
except (TypeError, ValueError):
|
||||
raise ValueError("간격(분)을 숫자로 넣어 주세요.") from None
|
||||
if not (INTERVAL_STEP <= interval <= INTERVAL_MAX) or interval % INTERVAL_STEP:
|
||||
raise ValueError(f"간격은 {INTERVAL_STEP}분 ~ {INTERVAL_MAX}분, {INTERVAL_STEP}분 단위로 정할 수 있습니다.")
|
||||
days = raw.get("days")
|
||||
if not isinstance(days, list) or any(not isinstance(d, int) or isinstance(d, bool) or not 0 <= d <= 6 for d in days):
|
||||
raise ValueError("요일이 잘못되었습니다.")
|
||||
days = sorted(set(days))
|
||||
if on and not days:
|
||||
raise ValueError("요일을 하나 이상 고르세요(자동 업데이트를 쓰지 않으려면 [사용]을 끄세요).")
|
||||
start, end = _time(raw.get("start"), "시작 시각"), _time(raw.get("end"), "끝 시각")
|
||||
if _minutes(end) < _minutes(start):
|
||||
raise ValueError("끝 시각은 시작 시각과 같거나 뒤여야 합니다(밤을 넘기는 시간대는 안 됩니다).")
|
||||
return {"enabled": on, "interval": interval, "days": days, "start": start, "end": end}
|
||||
|
||||
|
||||
def normalize(raw: Any) -> dict[str, dict[str, Any]]:
|
||||
"""DB 에 저장된 값 → 종류마다 일정. 없거나 잘못된 종류는 기본 일정."""
|
||||
out = {}
|
||||
for k in KINDS:
|
||||
try:
|
||||
out[k] = validate_schedule((raw or {}).get(k)) if isinstance(raw, dict) else default_schedule()
|
||||
except ValueError:
|
||||
out[k] = default_schedule()
|
||||
return out
|
||||
|
||||
|
||||
def load_schedules(store: Any) -> tuple[dict[str, dict[str, Any]], bool]:
|
||||
"""(종류 → 일정, 011 적용 여부). DB 오류는 그대로 올린다(스레드는 직전 일정을 계속 쓴다)."""
|
||||
from .db import SettingsMigrationNeeded # noqa: WPS433
|
||||
|
||||
getter = getattr(store, "get_setting", None)
|
||||
if getter is None: # 테스트용 가짜 저장소 등
|
||||
return normalize(None), True
|
||||
try:
|
||||
return normalize(getter(SETTING_KEY)), True
|
||||
except SettingsMigrationNeeded:
|
||||
return normalize(None), False
|
||||
|
||||
|
||||
def describe(sched: dict[str, Any]) -> str:
|
||||
"""'매일 09:00~19:00 · 30분마다' / '평일 …' / '월·수·금 …' / '꺼짐'."""
|
||||
if not sched.get("enabled") or not sched.get("days"):
|
||||
return "꺼짐"
|
||||
days = sched["days"]
|
||||
if days == list(range(7)):
|
||||
when = "매일"
|
||||
elif days == list(range(5)):
|
||||
when = "평일"
|
||||
elif days == [5, 6]:
|
||||
when = "주말"
|
||||
else:
|
||||
when = "·".join(WEEKDAYS[d] for d in days)
|
||||
span = sched["start"] if sched["start"] == sched["end"] else f"{sched['start']}~{sched['end']}"
|
||||
every = sched["interval"]
|
||||
every_txt = f"{every // 60}시간" + (f" {every % 60}분" if every % 60 else "") if every >= 60 else f"{every}분"
|
||||
return f"{when} {span}" + ("" if sched["start"] == sched["end"] else f" · {every_txt}마다")
|
||||
|
||||
|
||||
def is_slot(t: datetime, sched: dict[str, Any]) -> bool:
|
||||
"""t(분 단위로 자른 KST 시각)가 회차인가."""
|
||||
if not sched.get("enabled") or t.weekday() not in sched["days"]:
|
||||
return False
|
||||
return first <= t.hour < last or (t.hour == last and t.minute == 0)
|
||||
m, start, end = t.hour * 60 + t.minute, _minutes(sched["start"]), _minutes(sched["end"])
|
||||
return start <= m <= end and (m - start) % sched["interval"] == 0
|
||||
|
||||
|
||||
def next_slot(after: datetime, hours: tuple[int, int]) -> datetime:
|
||||
"""after 보다 뒤의 첫 회차 시각."""
|
||||
t = after.replace(second=0, microsecond=0)
|
||||
t += timedelta(minutes=SLOT_MINUTES - t.minute % SLOT_MINUTES)
|
||||
for _ in range(48 * 2 + 2): # 하루치 회차를 넘기기 전에 반드시 찾는다
|
||||
if is_slot(t, hours):
|
||||
return t
|
||||
t += timedelta(minutes=SLOT_MINUTES)
|
||||
raise ValueError("회차를 찾을 수 없습니다")
|
||||
def next_slot(after: datetime, sched: dict[str, Any]) -> datetime | None:
|
||||
"""after 보다 뒤의 첫 회차 시각(KST). 꺼져 있거나 요일이 없으면 None."""
|
||||
if not sched.get("enabled") or not sched.get("days"):
|
||||
return None
|
||||
start, end, step = _minutes(sched["start"]), _minutes(sched["end"]), sched["interval"]
|
||||
day0 = after.replace(hour=0, minute=0, second=0, microsecond=0)
|
||||
for d in range(8):
|
||||
base = day0 + timedelta(days=d)
|
||||
if base.weekday() not in sched["days"]:
|
||||
continue
|
||||
first = base + timedelta(minutes=start)
|
||||
k = 0 if first > after else int((after - first).total_seconds() // (step * 60)) + 1
|
||||
m = start + k * step
|
||||
if m <= end:
|
||||
return base + timedelta(minutes=m)
|
||||
return None
|
||||
|
||||
|
||||
def run_once(store: Any, app_state: Any, *, today: Any, days: int) -> dict[str, Any]:
|
||||
"""한 회차 — 진행 창 작업으로 오늘 포함 최근 days 일 업데이트. 이미 돌고 있으면 건너뜀."""
|
||||
# ════════════════════════════════════════════════════════════
|
||||
# 회차 실행
|
||||
# ════════════════════════════════════════════════════════════
|
||||
def run_once(store: Any, app_state: Any, *, today: Any, days: int,
|
||||
kinds: tuple[str, ...] = KINDS) -> dict[str, Any]:
|
||||
"""한 회차 — 오늘 포함 최근 days 일. kinds 의 매출(진행 창 작업)·광고비(광고 진행 창 작업)를 동시에.
|
||||
각각 이미 돌고 있으면 그 종류만 건너뜀."""
|
||||
from . import common, jobs # noqa: WPS433
|
||||
from .ad_sync import run_ad_job # noqa: WPS433
|
||||
from .credentials import CredentialService # noqa: WPS433
|
||||
from .sync import SyncService # noqa: WPS433
|
||||
|
||||
if jobs.running_job() is not None:
|
||||
return {"skipped": True, "reason": "다른 업데이트 진행 중"}
|
||||
start, end = today - timedelta(days=days - 1), today
|
||||
job = jobs.create_job(user=AUTO_USER, start=start, end=end)
|
||||
sync = SyncService(store, CredentialService(store, common.key_ring), app_state=app_state)
|
||||
ads: list[dict[str, Any]] = []
|
||||
ad_thread = None
|
||||
ads_skipped = "ads" not in kinds or jobs.running_job("ads") is not None
|
||||
if not ads_skipped:
|
||||
ad_job = jobs.create_job(user=AUTO_USER, start=start, end=end, kind="ads")
|
||||
|
||||
def _ads() -> None:
|
||||
ads.extend(run_ad_job(store, common.key_ring, ad_job, start, end, user=AUTO_USER))
|
||||
|
||||
ad_thread = threading.Thread(target=_ads, name=f"perf-auto-ads-{ad_job.id}", daemon=True)
|
||||
ad_thread.start()
|
||||
|
||||
sales_skipped = "sales" not in kinds or jobs.running_job("sales") is not None
|
||||
error = ""
|
||||
results: list[dict[str, Any]] = []
|
||||
try:
|
||||
results = sync.sync_all(start=start, end=end, trigger="schedule", user=AUTO_USER, job=job)
|
||||
except Exception as exc: # noqa: BLE001 — 스레드가 죽지 않게
|
||||
logger.exception("auto sync failed")
|
||||
error = f"업데이트 중 오류: {type(exc).__name__}"
|
||||
last = None
|
||||
try:
|
||||
last = store.last_update_at()
|
||||
except Exception: # noqa: BLE001
|
||||
pass
|
||||
job.finish(error=error, last_update_at=last)
|
||||
# 광고 API(구글 광고 등)도 같은 회차·같은 기간으로 — 설정된 연동만, 실패해도 매출 업데이트와 무관(2026-10-15)
|
||||
ads: list[dict[str, Any]] = []
|
||||
try:
|
||||
from .ad_sync import AdSyncService, ad_credentials # noqa: WPS433
|
||||
|
||||
ads = AdSyncService(store, ad_credentials(store, common.key_ring)).sync_all(start, end, user=AUTO_USER)
|
||||
except Exception: # noqa: BLE001 — 스레드가 죽지 않게
|
||||
logger.exception("auto ad sync failed")
|
||||
if not sales_skipped:
|
||||
job = jobs.create_job(user=AUTO_USER, start=start, end=end)
|
||||
sync = SyncService(store, CredentialService(store, common.key_ring), app_state=app_state)
|
||||
try:
|
||||
results = sync.sync_all(start=start, end=end, trigger="schedule", user=AUTO_USER, job=job)
|
||||
except Exception as exc: # noqa: BLE001 — 스레드가 죽지 않게
|
||||
logger.exception("auto sync failed")
|
||||
error = f"업데이트 중 오류: {type(exc).__name__}"
|
||||
last = None
|
||||
try:
|
||||
last = store.last_update_at()
|
||||
except Exception: # noqa: BLE001
|
||||
pass
|
||||
job.finish(error=error, last_update_at=last)
|
||||
if ad_thread is not None:
|
||||
ad_thread.join()
|
||||
if sales_skipped and ads_skipped:
|
||||
return {"skipped": True, "reason": "다른 업데이트 진행 중"}
|
||||
ok = sum(1 for r in results if r.get("ok"))
|
||||
return {"skipped": False, "from": start.isoformat(), "to": end.isoformat(), "ok": ok,
|
||||
return {"skipped": False, "sales_skipped": sales_skipped, "ads_skipped": ads_skipped,
|
||||
"from": start.isoformat(), "to": end.isoformat(), "ok": ok,
|
||||
"failed": [r.get("code") for r in results if not r.get("ok") and not r.get("skipped")], "error": error,
|
||||
"ads": [{"code": a.get("code"), "ok": bool(a.get("ok"))} for a in ads]}
|
||||
|
||||
|
||||
class Scheduler:
|
||||
"""종류마다 다음 회차(due)를 들고 있다가 시각이 되면 그 종류만 따로 스레드로 돌린다.
|
||||
tick(now) 이 1분마다 불리며 일정이 바뀐 종류는 지금부터 다시 계산(서버 시작·저장 직후 회차는 안 돌림)."""
|
||||
|
||||
def __init__(self, fire: Any):
|
||||
self.fire = fire # fire(kind, due)
|
||||
self.schedules: dict[str, dict[str, Any]] = {}
|
||||
self.due: dict[str, datetime | None] = {}
|
||||
|
||||
def update(self, schedules: dict[str, dict[str, Any]], now: datetime) -> None:
|
||||
for k in KINDS:
|
||||
s = schedules.get(k) or default_schedule()
|
||||
if self.schedules.get(k) != s:
|
||||
self.schedules[k] = s
|
||||
self.due[k] = next_slot(now, s)
|
||||
|
||||
def tick(self, now: datetime) -> None:
|
||||
for k in KINDS:
|
||||
due = self.due.get(k)
|
||||
if due is not None and due <= now:
|
||||
self.fire(k, due)
|
||||
self.due[k] = next_slot(max(now, due), self.schedules[k])
|
||||
|
||||
def wait_seconds(self, now: datetime) -> float:
|
||||
dues = [d for d in self.due.values() if d is not None]
|
||||
if not dues:
|
||||
return 60.0
|
||||
return max(0.0, min(60.0, min((d - now).total_seconds() for d in dues)))
|
||||
|
||||
|
||||
def start_auto_sync_thread(app_state: Any) -> bool:
|
||||
"""웹 프로세스 시작 시 1번. 저장소가 없거나 꺼져 있거나 이미 돌고 있으면 False."""
|
||||
global _started # noqa: PLW0603
|
||||
store = getattr(app_state, "performance_store", None)
|
||||
if store is not None and not _started:
|
||||
try: # 지난 프로세스가 업데이트 도중 끝나 남은 '진행 중' 기록 정리(자동 업데이트를 꺼 둬도)
|
||||
n = store.abandon_running_runs()
|
||||
if n:
|
||||
logger.warning("매출 업데이트 '진행 중' 기록 %d건 정리(서버 재시작으로 중단)", n)
|
||||
except Exception: # noqa: BLE001 — DB 가 아직 안 붙었어도 앱은 뜬다
|
||||
logger.exception("매출 업데이트 진행 기록 정리 실패")
|
||||
if store is None or not enabled():
|
||||
return False
|
||||
with _start_lock:
|
||||
if _started:
|
||||
return False
|
||||
_started = True
|
||||
hours, days = hour_window(), sync_days()
|
||||
days = sync_days()
|
||||
|
||||
def _fire(kind: str, due: datetime) -> None:
|
||||
def _run() -> None:
|
||||
try:
|
||||
res = run_once(store, app_state, today=due.date(), days=days, kinds=(kind,))
|
||||
logger.info("%s 자동 업데이트 %s: %s", KIND_NAMES[kind], due.strftime("%H:%M"), res)
|
||||
except Exception: # noqa: BLE001
|
||||
logger.exception("%s 자동 업데이트 실패 — 다음 회차에 다시", KIND_NAMES[kind])
|
||||
|
||||
threading.Thread(target=_run, name=f"performance-auto-{kind}", daemon=True).start()
|
||||
|
||||
sched = Scheduler(_fire)
|
||||
|
||||
def _reload(now: datetime) -> None:
|
||||
try:
|
||||
schedules, _ = load_schedules(store)
|
||||
except Exception: # noqa: BLE001 — DB 가 잠시 끊기면 직전 일정 그대로(처음이면 기본 일정)
|
||||
logger.warning("자동 업데이트 일정 읽기 실패 — 직전 일정 사용", exc_info=True)
|
||||
schedules = sched.schedules or normalize(None)
|
||||
sched.update(schedules, now)
|
||||
|
||||
def _loop() -> None:
|
||||
due = next_slot(now_kst(), hours)
|
||||
logger.info("매출 자동 업데이트 시작 — %02d~%02d시 30분마다, 최근 %d일, 다음 %s", hours[0], hours[1], days,
|
||||
due.strftime("%m-%d %H:%M"))
|
||||
_reload(now_kst())
|
||||
logger.info("실적 자동 업데이트 시작 — 최근 %d일, %s", days, ", ".join(
|
||||
f"{KIND_NAMES[k]} {describe(sched.schedules[k])} 다음 "
|
||||
f"{sched.due[k].strftime('%m-%d %H:%M') if sched.due[k] else '없음'}" for k in KINDS))
|
||||
while True:
|
||||
wait = (due - now_kst()).total_seconds()
|
||||
if wait > 0:
|
||||
time.sleep(min(wait, 60)) # 시계 변경·절전에도 1분 안에 다시 확인
|
||||
continue
|
||||
try:
|
||||
res = run_once(store, app_state, today=due.date(), days=days)
|
||||
logger.info("매출 자동 업데이트 %s: %s", due.strftime("%H:%M"), res)
|
||||
except Exception: # noqa: BLE001
|
||||
logger.exception("매출 자동 업데이트 실패 — 다음 회차에 다시")
|
||||
due = next_slot(max(now_kst(), due), hours)
|
||||
time.sleep(max(1.0, sched.wait_seconds(now_kst()))) # 시계 변경·절전·일정 저장에도 1분 안에 다시 확인
|
||||
now = now_kst()
|
||||
_reload(now)
|
||||
sched.tick(now)
|
||||
|
||||
threading.Thread(target=_loop, name="performance-auto-sync", daemon=True).start()
|
||||
return True
|
||||
|
||||
@@ -234,7 +234,7 @@ def _row(kind: str, label: str, per_code: dict[str, Money], **extra) -> dict:
|
||||
|
||||
def main_table(period: Period, codes: Sequence[str], cells: Mapping[tuple[date, str], Money],
|
||||
*, today: date, holidays: Mapping[str, str] | None = None) -> list[dict]:
|
||||
"""일자 × 쇼핑몰 표. 일 행 + 주간합계(일요일 뒤 / 기간 끝) + 기간 합계.
|
||||
"""일자 × 쇼핑몰 표. 기간 합계(맨 위 — 제목 행 바로 아래, 2026-10-21) + 일 행 + 주간합계(일요일 뒤 / 기간 끝).
|
||||
|
||||
연간 보기는 일 대신 월 행(1~12월)으로 줄인다.
|
||||
"""
|
||||
@@ -264,7 +264,7 @@ def main_table(period: Period, codes: Sequence[str], cells: Mapping[tuple[date,
|
||||
rows.append(_row("week", label, week_codes, **{"from": ws.isoformat(), "to": d.isoformat()}))
|
||||
week_codes = {c: Money() for c in codes}
|
||||
if period.kind != "week" and period.days > 1:
|
||||
rows.append(_row("total", "기간 합계", by_code(cells, codes, period.start, period.end)))
|
||||
rows.insert(0, _row("total", "기간 합계", by_code(cells, codes, period.start, period.end)))
|
||||
return rows
|
||||
|
||||
|
||||
|
||||
@@ -85,11 +85,11 @@ def require_store(request: Request, *, admin: bool = False) -> tuple[Any, dict[s
|
||||
def guard(request: Request, *, admin: bool = False):
|
||||
"""페이지 진입부. tuple(store, user) 이 아니면 그대로 응답으로 돌려준다."""
|
||||
from app.main import get_current_user_record, render_template # noqa: WPS433
|
||||
from app.store import has_module, is_admin # noqa: WPS433
|
||||
from app.store import has_module, is_admin, login_redirect # noqa: WPS433
|
||||
|
||||
user = get_current_user_record(request)
|
||||
if user is None:
|
||||
return RedirectResponse(url="/login", status_code=303)
|
||||
return login_redirect(request)
|
||||
if not has_module(user, MODULE_KEY) or (admin and not is_admin(user)):
|
||||
reason = "실적 설정은 관리자만 볼 수 있습니다." if admin else f"{MODULE_NAME} 접근 권한이 없습니다."
|
||||
return render_template(request, "denied.html",
|
||||
|
||||
Some files were not shown because too many files have changed in this diff Show More
Reference in New Issue
Block a user