Compare commits
330 Commits
| Author | SHA1 | Date | |
|---|---|---|---|
| c7cc94a09c | |||
| edd5a97a9b | |||
| 5a4ceead3e | |||
| fa6bb33f11 | |||
| 5eaeee2f57 | |||
| 2e428aa07f | |||
| 4eda10df00 | |||
| 42d2671f80 | |||
| 66a99e2733 | |||
| 3ead7aa9f6 | |||
| e7b1e17579 | |||
| cd33c67df9 | |||
| 0bb23c32de | |||
| f0aae513af | |||
| 8ad8242c41 | |||
| 32877b1ce8 | |||
| 1550b5bb51 | |||
| 35c05e1b81 | |||
| 8b5498bc19 | |||
| bdd03a9ea4 | |||
| 0396cd6639 | |||
| f1f0db1bbe | |||
| 3061d44236 | |||
| 5e70ec1819 | |||
| e5d6a1188c | |||
| c23d1e3ce5 | |||
| bab495d9f2 | |||
| bbe27eac8b | |||
| 53896f0425 | |||
| db73faf270 | |||
| e3bc9d518d | |||
| 15a5eddf20 | |||
| e9fb1c3407 | |||
| 240d61c903 | |||
| e645f4beef | |||
| 4466601c58 | |||
| c3cab212b6 | |||
| b61c0897cc | |||
| 5c05f471b3 | |||
| 4e159e94e7 | |||
| db05538664 | |||
| ea7817752d | |||
| 67001f0a6e | |||
| c30ef72c6e | |||
| 581e0cf325 | |||
| e6b2812624 | |||
| 30fd2c5470 | |||
| 2df86983da | |||
| 90332bcb59 | |||
| 1c42ed5dd3 | |||
| 779cc79a87 | |||
| 1ba494dab8 | |||
| ef38140673 | |||
| 099271fdb2 | |||
| e6d38f342f | |||
| f8245b4499 | |||
| 9a8aea6435 | |||
| eab6b836d2 | |||
| deb5bfb9a1 | |||
| 4d3b747ab7 | |||
| 5471cbc32b | |||
| 4c94bf1293 | |||
| f36f7d3ad4 | |||
| 5bd0a5c406 | |||
| c317d7bb5d | |||
| 941b35a7a6 | |||
| ecc6405299 | |||
| 028831694a | |||
| 542e7fb7d1 | |||
| ac0f48bfce | |||
| 68bf43ea2f | |||
| cf7c44ce49 | |||
| db3b7d500d | |||
| d5fd617425 | |||
| bed3d4fc89 | |||
| 822c955bb6 | |||
| 20a79f5719 | |||
| b4edc16785 | |||
| 66db501170 | |||
| ac01a33c47 | |||
| 513aece27e | |||
| 1d3573a44a | |||
| 410d4fe05c | |||
| c15a746ae4 | |||
| da46abd678 | |||
| d38d00b4d2 | |||
| 8201fde606 | |||
| 70bf263a80 | |||
| 5a2c6ba2ad | |||
| 6ebf705e27 | |||
| 22490664d6 | |||
| 0c6dacb824 | |||
| 6345b69816 | |||
| 3882836fd5 | |||
| 59add598fa | |||
| ca2821464f | |||
| 24950c94ce | |||
| 454b3cc700 | |||
| dd1bc310dc | |||
| 53bead6691 | |||
| 36283ae265 | |||
| 89d204b2fe | |||
| 724b590868 | |||
| e130bbe577 | |||
| bc62e53270 | |||
| 6fd01314d5 | |||
| 1bdcd59287 | |||
| b7c0f28ad2 | |||
| 4320766abd | |||
| e934dd6abf | |||
| 18ac8f0761 | |||
| b5be26089d | |||
| 3a9a94f97b | |||
| c69bc0e9f3 | |||
| 833dbb5fdf | |||
| 2aa6b6efae | |||
| 1759e00213 | |||
| fa6e7066ae | |||
| 7cdca852bd | |||
| ee09e8bfd1 | |||
| ae6b6ec603 | |||
| 89ad338024 | |||
| c07a3466a0 | |||
| 5d054e59b6 | |||
| 061f18d081 | |||
| ee9c04147a | |||
| 6a1c437635 | |||
| 8045d06362 | |||
| 85e91ca882 | |||
| 11e9803965 | |||
| 90fb06c48c | |||
| ac3b90f2be | |||
| a664c4a9fc | |||
| 64aabdfbda | |||
| 98fda9923e | |||
| 53c7c85caf | |||
| c380b5e411 | |||
| 84113d1fd7 | |||
| 4715de9b5b | |||
| d7d4f61bfb | |||
| 69e594ac54 | |||
| f69219919d | |||
| 972c94d86c | |||
| f4606bddc6 | |||
| 06af036f86 | |||
| 8f46d6c13a | |||
| 701f43a1f8 | |||
| 9eea1a073a | |||
| 5278d568de | |||
| 21fc78adb9 | |||
| 4bdab1de3d | |||
| f90884e028 | |||
| 6959941128 | |||
| 18dd9531ad | |||
| 28d56fc3c5 | |||
| b8d944b3ef | |||
| a0722f26ca | |||
| 261267a523 | |||
| da27c9990a | |||
| 50153139fc | |||
| c4fb7761ad | |||
| fb7b25ba2c | |||
| e9be17faab | |||
| 133df472d1 | |||
| 569b33ece4 | |||
| 452e8a9093 | |||
| 1cfcec2bef | |||
| 2d638804d1 | |||
| b6dc82c0b3 | |||
| 2a01d97dd0 | |||
| fc3a2d0b9b | |||
| c766af691a | |||
| b7c24c07e7 | |||
| fbb6c648a5 | |||
| 8b664fc216 | |||
| 5f10f9ce45 | |||
| 46dc038e26 | |||
| c0b742af8a | |||
| 80c9904771 | |||
| 8885bbce6b | |||
| e9618d93d6 | |||
| cbf59d9bf0 | |||
| c9d5e6e017 | |||
| 15e84ba5bc | |||
| 3045944200 | |||
| e1f50e0ca5 | |||
| 9528f735b8 | |||
| 7417e661e0 | |||
| 38d0a87d6b | |||
| cd3577b299 | |||
| 9194487217 | |||
| e958743e65 | |||
| 85cf0a28b1 | |||
| 39dcda66b4 | |||
| f09b8fa2f9 | |||
| df36a5a917 | |||
| d18e801e08 | |||
| b576dd1a38 | |||
| bd0c47e6fc | |||
| 75c0370e54 | |||
| a2a39671b9 | |||
| 2a1a3e7bd9 | |||
| 5bf8c9c160 | |||
| 86622cc4dd | |||
| ed7da57066 | |||
| e2fc14a584 | |||
| d89875db7e | |||
| 321bf11f65 | |||
| 3e4c6dfad3 | |||
| d3c1ca12e9 | |||
| 090e508bf3 | |||
| 193da56edf | |||
| cd0a509215 | |||
| 7647e4b20f | |||
| 2c8542339d | |||
| b32f2ac3a3 | |||
| e726f986db | |||
| 36a6866b96 | |||
| db39d3b383 | |||
| dc2008c5b3 | |||
| 494d84f7c2 | |||
| 44f6ca4ef7 | |||
| 7f9c7a24d3 | |||
| 22af196d56 | |||
| 20232baf06 | |||
| 035cb83d6f | |||
| 114af59b26 | |||
| 6a38fdb06a | |||
| d387048ebf | |||
| 71516713c5 | |||
| d21670f6af | |||
| 2434bce35e | |||
| f02742497a | |||
| 968892d811 | |||
| a3a9444c3b | |||
| e1006c63de | |||
| 21981eb946 | |||
| ac4f2653af | |||
| 51727e419a | |||
| b791f7be68 | |||
| 334b83c973 | |||
| 6ea4a2e0f9 | |||
| ec5d7e2efe | |||
| 737191c170 | |||
| f199eda322 | |||
| 9161e0901f | |||
| 5460c7f676 | |||
| 2a9f6f5628 | |||
| 58dbb7ef3e | |||
| 75b82024de | |||
| 4af1ad8848 | |||
| 164153dc9c | |||
| ac0672bc11 | |||
| 24dd3acd09 | |||
| 4efe7cef58 | |||
| 2dab20f718 | |||
| be298777af | |||
| 45a671940b | |||
| 601971d43d | |||
| c9bce7c976 | |||
| 614747ffca | |||
| 931cc0d1d9 | |||
| b6b4f8c360 | |||
| ff81d80cf9 | |||
| 01000757f3 | |||
| d75dec2a50 | |||
| a45f78217c | |||
| d3761183c3 | |||
| 5d07770ce2 | |||
| 91bdc12e78 | |||
| 81b1204693 | |||
| ae2e3eb943 | |||
| da63b93302 | |||
| a2d2382d71 | |||
| 8b3e6dffc5 | |||
| 898dc1153c | |||
| b765fb8fb8 | |||
| 7c283312b4 | |||
| f4fadec0a4 | |||
| 74f59c0a94 | |||
| e56c5685ca | |||
| 67cd73b963 | |||
| 3203ff87a4 | |||
| e398e9d906 | |||
| 077c92fa32 | |||
| e845f47043 | |||
| a5f90a0343 | |||
| 21019ac5f1 | |||
| 7a9f55c804 | |||
| ac2615805b | |||
| 220fb6e7d1 | |||
| 7de93e78d7 | |||
| 86ee50b2e6 | |||
| ec78dd328d | |||
| f037ea7de0 | |||
| 40d94e2892 | |||
| 7d96f2e738 | |||
| 1952e4f0b1 | |||
| 6376092bb7 | |||
| c93ab2fbd8 | |||
| dd6a849fbd | |||
| b52b182d47 | |||
| 1129db9e21 | |||
| bfa55bf367 | |||
| 643ff25f27 | |||
| 2f86445077 | |||
| 398e5181fd | |||
| 20d19792dd | |||
| 6f43f8066a | |||
| 614332a1e6 | |||
| 1d12ac878b | |||
| b3ee219858 | |||
| 1eca66838b | |||
| 370834b58b | |||
| a19c1f4cab | |||
| fb7c29833e | |||
| ef12a34600 | |||
| f63f82d642 | |||
| 19396f1745 | |||
| 4cb37688ed | |||
| 27ee92c0a6 | |||
| 04a1fddd95 | |||
| 6e175d0bac | |||
| aa669553db | |||
| b95206dcf4 | |||
| 52c1b004e6 | |||
| 6dfc6109a4 | |||
| d2a65e5c37 | |||
| 72c23011fe | |||
| 2c904ebd3e |
@@ -43,6 +43,12 @@ CUSTOMER_ORDER_LIST_URL=/orderlist/
|
||||
# GOOGLE_SHEETS_CREDENTIALS=/opt/www/main/secrets/google-sheets-sa.json
|
||||
# 또는 파일 대신 JSON 본문을 통째로 (한 줄):
|
||||
# GOOGLE_SHEETS_CREDENTIALS_JSON={"type":"service_account", ...}
|
||||
#
|
||||
# 주간 회의록 "회의록 보드"(주차마다 빈 Google 슬라이드) — 위 Google 인증을 같이 쓴다.
|
||||
# OAuth 토큰은 Drive·Slides 권한까지 필요: scripts/google_sheets_authorize.py 로 다시 발급(시트 권한도 함께 들어감)
|
||||
# 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 — 비우면 이 기본값
|
||||
|
||||
# ─── 휴가 관리 모듈 (vacation_db) ───
|
||||
# 설정해야 모듈이 동작한다(미설정 시 "설정 필요" 안내, JSON 폴백 없음).
|
||||
@@ -146,3 +152,28 @@ CUSTOMER_ORDER_LIST_URL=/orderlist/
|
||||
# 읽기 전용 역할 itemcode_ro 를 먼저 생성하고(아래 DSN), 낱개+세트 UNION 검색 SQL 사용:
|
||||
# ITEMCODE_DB_URL=postgresql://itemcode_ro:replace-me@postgres-db:5432/itemcode_db
|
||||
# ITEMCODE_SEARCH_SQL=SELECT item_code AS code, name AS name, '낱개' AS type FROM single_items WHERE item_code ILIKE %(q)s OR name ILIKE %(q)s UNION ALL SELECT item_code AS code, name AS name, '세트' AS type FROM set_items WHERE item_code ILIKE %(q)s OR name ILIKE %(q)s ORDER BY code ASC LIMIT %(limit)s
|
||||
|
||||
# ─── 실적(쇼핑몰 통합 매출) — app/modules/performance ───
|
||||
# performance_db 전용. 미설정 시 모듈이 "설정 필요" 안내만 표시.
|
||||
# 초기화: scripts/sql/performance_db_init.sql (docs/DATABASES.md 참고)
|
||||
# PERFORMANCE_DB_URL=postgresql://performance_app:replace-me@postgres-db:5432/performance_db
|
||||
#
|
||||
# 쇼핑몰 API 인증정보(ID·Key·Secret·Token)는 여기에 넣지 않는다 —
|
||||
# 실적 → 설정 화면에서 입력하면 아래 마스터 키로 AES-256-GCM 암호화해 DB 에 저장한다.
|
||||
# 마스터 키는 DB 에 저장되지 않으며, 잃어버리면 저장된 인증정보를 복구할 수 없다(별도 안전 보관).
|
||||
# 생성: openssl rand -hex 32 (64자 hex, 또는 32바이트 base64)
|
||||
# APP_ENCRYPTION_KEY=
|
||||
# APP_ENCRYPTION_KEY_VERSION=1
|
||||
# 키 교체(rotation) 시: 새 키를 APP_ENCRYPTION_KEY 에, 버전을 올리고(예: 2),
|
||||
# 예전 키는 APP_ENCRYPTION_KEY_V1= 로 남긴 뒤 설정 화면 [현재 키로 다시 암호화] → 완료 후 V1 삭제.
|
||||
# APP_ENCRYPTION_KEY_V1=
|
||||
# [매출 업데이트] 가 가져오는 기간(오늘 포함 최근 N일, 기본 7, 최대 90)
|
||||
# PERFORMANCE_SYNC_DAYS=7
|
||||
# 매출 자동 업데이트(웹 프로세스 안 스레드) — 기본 켜짐, 매일 09:00~19:00 정각·30분마다 오늘 포함 최근 10일.
|
||||
# PERFORMANCE_AUTO_SYNC=false # 끄기
|
||||
# PERFORMANCE_AUTO_SYNC_DAYS=10 # 가져올 기간(1~90일)
|
||||
# PERFORMANCE_AUTO_SYNC_HOURS=9-19 # 시간대(시작시-마지막시, 마지막 시는 정각 회차까지)
|
||||
|
||||
# 자산관리 — 별도 asset_db. 사용자가 서버에서 asset_db_init.sql로 직접 초기화.
|
||||
# 미설정 시 등록/배정은 비활성, HWiNFO XML 분석 미리보기는 사용 가능.
|
||||
# ASSET_DB_URL=postgresql://asset_app:replace-me@postgres-db:5432/asset_db
|
||||
|
||||
@@ -16,3 +16,6 @@ PUBLIC_BASE_URL=http://localhost:8080
|
||||
|
||||
CS_ORDER_URL=https://cs.example.com
|
||||
CUSTOMER_ORDER_LIST_URL=https://orders.example.com
|
||||
|
||||
# 자산관리 개발용 DB (사용자가 직접 생성). 운영 DB 접속정보를 사용하지 마세요.
|
||||
# ASSET_DB_URL=postgresql://asset_app:replace-me@host.docker.internal:5432/asset_db
|
||||
|
||||
+11
@@ -24,3 +24,14 @@ __pycache__/
|
||||
# dispatch 라벨 PDF 샘플(실제 고객 PII — 커밋 금지)
|
||||
docs/samples/
|
||||
tests/js/.out/
|
||||
|
||||
# HWiNFO 실물 보고서: 시리얼/MAC/사용자 정보가 포함되어 소스에 보관하지 않음
|
||||
KING-DESKTOP.XML
|
||||
|
||||
# Excel 가 파일을 열 때 만드는 잠금 파일
|
||||
~$*
|
||||
|
||||
# 테스트 도구(docs/TESTING.md)
|
||||
.pytest_cache/
|
||||
tests/js/node_modules/
|
||||
tests/js/package-lock.json
|
||||
|
||||
@@ -36,10 +36,15 @@ Codex는 이 저장소에서 작업을 시작하기 전에 **반드시 아래
|
||||
- 말레이시아 창고 재고관리 (`app/modules/malaysia/`, `malaysia_stock_db`) — 낱개(MT/MX/MZ) 입출고·조정, 세트(MY) BOM, 일일 재고조사(세트→낱개 자동 분해), 현재고 현황. 뚜껑(MD-)은 재고 집계 제외 — 단, 창고 랙에는 위치 확인용으로 배치 가능(`store.LID_ITEMS`). 상품은 `itemcode_db` 읽기 전용. 권한키 `malaysia`
|
||||
- 말레이시아 배송 (`app/modules/dispatch/`, `dispatch_db`) — TikTok·Shopee 출고관리. 플랫폼별 데이터 엑셀 업로드(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`) 포함. 엑셀은 openpyxl 파싱/생성. 권한키 `dispatch`. 상세는 `docs/DISPATCH_MODULE.md`
|
||||
- 카페24 상품관리 (`app/modules/cafe24/`, `cafe24_db`) — 카페24 관리자에 들어가지 않고 상품 상세페이지(description HTML) 조회·편집·즉시적용·예약적용·자동복원·버전 롤백·일괄수정. 카페24 OAuth/API 클라이언트는 향후 주문관리와 공유하기 위해 **공통 계층 `app/integrations/cafe24/`** 에 둔다 — 라우터에서 `httpx`/`requests` 직접 호출 금지. 토큰은 Fernet 암호화 저장(`CAFE24_TOKEN_SECRET`), 로그/화면에 토큰·시크릿 절대 미출력. 쓰기 직전 항상 카페24 현재 HTML 을 다시 읽어 `BACKUP` revision 생성(로컬 값을 현재값으로 가정 금지). 예약은 DB 저장 + 별도 worker(`app/modules/cafe24/worker.py`, compose 서비스 `dbx-cafe24-worker`)가 처리 — 웹 프로세스에서 대기하지 않는다. 권한키 `cafe24`(연결/해제는 admin 전용). 상세는 `docs/CAFE24_MODULE.md`
|
||||
- 프로젝트 관리 (`app/modules/project/`, `project_db`) — 아사나식. 프로젝트/서브프로젝트(self-FK `parent_id`, CASCADE)·업무(`tasks`: 담당자·우선순위·시작/마감)·진행단계(`project_stages` 칸반, 생성시 기본 4단계 seed)·멤버 배정(`project_members`)·활동이력(`project_activity`). 메인 뷰 달력(FullCalendar)/타임라인(vis-timeline) 버튼 토글 + 보드(드래그로 단계 이동)/리스트. 진입 권한키 `project`(관리자 페이지 토글로 직원별 부여, admin 자동). 프로젝트 생성/삭제·사용자 배정은 `is_admin` 만, 배정 멤버(또는 owner)는 서브프로젝트/업무/단계 CRUD. 멤버 배정 후보는 `project` 권한 보유 등록 사용자에서 자동 목록(`GET /project/api/assignable-users`). 업무 배정·완료 시 관리자에게 메일(`app/mail.py` stdlib smtplib, `SMTP_*`+`PROJECT_NOTIFY_EMAIL` env, 미설정 시 조용히 skip, `BackgroundTasks` 비동기). 상세는 `docs/PROJECT_MODULE.md`
|
||||
- 프로젝트 관리 (`app/modules/project/`, `project_db`) — 아사나식. 프로젝트/서브프로젝트(self-FK `parent_id`, CASCADE)·업무(`tasks`: 담당자·우선순위·시작/마감)·진행단계(`project_stages` 칸반, 새 프로젝트는 섹션 없이 시작)·멤버 배정(`project_members`)·활동이력(`project_activity`). 메인 뷰 달력(FullCalendar)/타임라인(vis-timeline) 버튼 토글 + 보드(드래그로 단계 이동)/리스트. 진입 권한키 `project`(관리자 페이지 토글로 직원별 부여, admin 자동). 권한은 등급(수퍼관리자 > Admin > Pro user > User, 2026-10-12)과 멤버십 기준 — 표는 `docs/PROJECT_MODULE.md` 6-14, 공통 판단 `access.py`(관리자도 멤버가 아니면 프로젝트가 안 보임, 예외는 수퍼관리자). 멤버 배정 후보는 `project` 권한 보유 등록 사용자에서 자동 목록(`GET /project/api/assignable-users`). 업무 배정·완료 시 관리자에게 메일(`app/mail.py` stdlib smtplib, `SMTP_*`+`PROJECT_NOTIFY_EMAIL` env, 미설정 시 조용히 skip, `BackgroundTasks` 비동기). 상세는 `docs/PROJECT_MODULE.md`
|
||||
|
||||
상세는 `docs/PROJECT_OVERVIEW.md`.
|
||||
|
||||
- 자산관리 (`app/modules/asset/`, `asset_db`) — 사무집기·전산장비 등록/배정/반납/상태·구매/보증·이력.
|
||||
HWiNFO XML 분석·사양 조회·이전 보고서와 원본 보존. 권한키 `asset`, 환경변수 `ASSET_DB_URL`.
|
||||
사진 등록/갤러리·모니터 자산 조회/등록/연결·수퍼 관리자 삭제(이력/원본 보존). 기존 설치는 마이그레이션 `asset_db_002_photos_monitors.sql` 필요.
|
||||
DB 미설정 시 저장 비활성, XML 분석 미리보기 가능. DB 생성은 사용자가 서버 명령으로 직접 진행. 상세 `docs/ASSET_MODULE.md`.
|
||||
|
||||
---
|
||||
|
||||
## 개발 원칙
|
||||
@@ -47,7 +52,7 @@ Codex는 이 저장소에서 작업을 시작하기 전에 **반드시 아래
|
||||
- 기존 코드를 수정하기 전 관련 파일을 먼저 읽고 구조를 파악한다.
|
||||
- 위험 명령은 **반드시 사용자 확인 후** 실행한다 (아래 "위험 명령" 절 참고).
|
||||
- `.env`, API 키, DB 비밀번호, OAuth Secret, 토큰은 절대 Git에 올리지 않는다.
|
||||
- 신규 DB가 필요하면 **승인 요청 후** 생성하며, DB명은 반드시 `_db`로 끝낸다 (예: `inventory_db`).
|
||||
- 신규 DB가 필요하면 **서버에서 실행할 명령을 제공하고 생성은 사용자가 직접 진행한다** (사용자 지시: 2026-10-06). DB명은 반드시 `_db`로 끝낸다 (예: `inventory_db`). 대상 서버·현재 DB·백업 상태와 생성 후 스키마·앱 계정 권한·연결 확인 명령을 함께 제공한다. 기존 DB 삭제·덮어쓰기 등 위험 명령은 아래의 별도 승인 원칙을 그대로 따른다.
|
||||
- 예전 문서/코드의 `orderlist_app`은 현재 기준 `orderlist_db`이다. 발견 시 수정 대상.
|
||||
|
||||
---
|
||||
|
||||
@@ -45,6 +45,7 @@ from .errors import (
|
||||
Cafe24AuthError,
|
||||
Cafe24ConfigError,
|
||||
Cafe24Error,
|
||||
Cafe24FtpConflict,
|
||||
Cafe24FtpError,
|
||||
Cafe24RateLimitError,
|
||||
)
|
||||
@@ -80,6 +81,7 @@ __all__ = [
|
||||
"Cafe24RateLimitError",
|
||||
"Cafe24ApiError",
|
||||
"Cafe24FtpError",
|
||||
"Cafe24FtpConflict",
|
||||
]
|
||||
|
||||
|
||||
|
||||
@@ -164,6 +164,10 @@ class Cafe24Client:
|
||||
method = method.upper()
|
||||
forced_refresh = False
|
||||
last_error: Exception | None = None
|
||||
# 쓰기 요청이 카페24에 도달했을 수도 있는 시도가 있었나(5xx 응답·응답 전 끊김).
|
||||
# 최종 오류에 실어 호출부가 "반영 여부 모름"을 구분하게 한다(errors.Cafe24ApiError).
|
||||
writes = method in ("PUT", "POST", "DELETE", "PATCH")
|
||||
maybe_applied = False
|
||||
|
||||
for attempt in range(self._max_retries + 1):
|
||||
self._pace()
|
||||
@@ -224,7 +228,9 @@ class Cafe24Client:
|
||||
time.sleep(wait)
|
||||
continue
|
||||
|
||||
error = Cafe24ApiError(message, status=status, endpoint=endpoint)
|
||||
if writes and status >= 500:
|
||||
maybe_applied = True
|
||||
error = Cafe24ApiError(message, status=status, endpoint=endpoint, maybe_applied=maybe_applied)
|
||||
if error.retryable and attempt < self._max_retries:
|
||||
last_error = error
|
||||
time.sleep(min(8.0, 0.5 * (2**attempt)))
|
||||
@@ -241,7 +247,11 @@ class Cafe24Client:
|
||||
http_status=status, result="ERROR", error_message=message,
|
||||
duration_ms=elapsed,
|
||||
)
|
||||
last_error = Cafe24ApiError(message, status=0, endpoint=endpoint)
|
||||
# 연결조차 안 된 경우만 "도달하지 않음"이 확실하다. 그 밖(읽기 타임아웃,
|
||||
# 응답 도중 끊김)은 카페24가 요청을 처리했을 수 있다.
|
||||
if writes and not isinstance(exc, (httpx.ConnectError, httpx.ConnectTimeout)):
|
||||
maybe_applied = True
|
||||
last_error = Cafe24ApiError(message, status=0, endpoint=endpoint, maybe_applied=maybe_applied)
|
||||
if attempt < self._max_retries:
|
||||
time.sleep(min(8.0, 0.5 * (2**attempt)))
|
||||
continue
|
||||
|
||||
@@ -33,7 +33,10 @@ STORE_SCOPES: tuple[str, ...] = ("mall.read_store", "mall.write_store")
|
||||
# 실제로 요청하는 scope 묶음. 개발자센터 앱에 등록된 권한과 어긋나면 인증이
|
||||
# 거부되므로, 여기에 추가할 때는 앱 권한도 함께 확인해야 한다.
|
||||
# 쓰지 않는 권한은 요청하지 않는다 — 토큰이 유출돼도 피해 범위를 좁히기 위함.
|
||||
DEFAULT_SCOPES: tuple[str, ...] = PRODUCT_SCOPES
|
||||
# 주문은 읽기만(실적 모듈의 매출 수집) — 앱에 쓰기 권한이 있어도 요청하지 않는다.
|
||||
# 이 목록을 바꾸면 카페24 상품관리 → 시스템에서 한 번 다시 연결해야 새 권한이 토큰에 붙는다
|
||||
# (기존 토큰은 예전 권한 그대로 계속 동작).
|
||||
DEFAULT_SCOPES: tuple[str, ...] = PRODUCT_SCOPES + ("mall.read_order",)
|
||||
|
||||
DEFAULT_API_VERSION = "2026-03-01"
|
||||
|
||||
|
||||
@@ -7,15 +7,28 @@ Admin API(OAuth)로는 스킨 파일을 다루지 못한다(`config.py` 상단
|
||||
|
||||
실물 확인(스크린샷): 호스트 `{mall_id}.ftp.cafe24.com`, 포트 21, SSL/TLS 미사용
|
||||
(평문 FTP). 파일은 텍스트(UTF-8)로 다룬다.
|
||||
|
||||
쓰기는 원본에 직접 STOR 하지 않는다 (write_text_file)
|
||||
직접 STOR 는 전송 도중 끊기면 원본이 **앞부분만 남은 채** 잘린다(스킨 템플릿이면
|
||||
모든 상품 페이지가 깨진다). 그래서
|
||||
1) 같은 폴더의 임시 파일에 올리고 (원본은 아직 그대로)
|
||||
2) 다시 받아 바이트 단위로 검증하고
|
||||
3) 교체 직전 원본을 다시 읽어 편집 시작 값과 같은지 확인하고(충돌 방지)
|
||||
4) RNFR/RNTO 로 이름을 바꿔 교체한다
|
||||
서버가 "이미 있는 이름으로 바꾸기"를 거부하면 원본을 옆 이름으로 비킨 뒤 교체하고,
|
||||
실패하면 원본을 제자리로 되돌린다. 이름 바꾸기 자체를 지원하지 않으면 **중단**한다
|
||||
(직접 STOR 로 물러서지 않는다).
|
||||
"""
|
||||
|
||||
from __future__ import annotations
|
||||
|
||||
import ftplib
|
||||
import io
|
||||
import posixpath
|
||||
import uuid
|
||||
|
||||
from .config import Cafe24FtpConfig
|
||||
from .errors import Cafe24FtpError
|
||||
from .errors import Cafe24FtpConflict, Cafe24FtpError
|
||||
|
||||
# 응답이 없을 때 무한 대기하지 않도록 — 관리 화면 요청 안에서 동기 호출되므로
|
||||
# 너무 길면 안 되지만, 파일 하나(수십 KB) 전송에는 충분히 넉넉해야 한다.
|
||||
@@ -35,37 +48,135 @@ def _connect(config: Cafe24FtpConfig) -> ftplib.FTP:
|
||||
raise Cafe24FtpError(f"FTP 연결/로그인에 실패했습니다: {exc}") from exc
|
||||
|
||||
|
||||
def _close(ftp: ftplib.FTP) -> None:
|
||||
try:
|
||||
ftp.quit()
|
||||
except Exception: # noqa: BLE001 — 정리 실패는 무시
|
||||
ftp.close()
|
||||
|
||||
|
||||
def _retr(ftp: ftplib.FTP, path: str) -> bytes:
|
||||
buf = io.BytesIO()
|
||||
ftp.retrbinary(f"RETR {path}", buf.write)
|
||||
return buf.getvalue()
|
||||
|
||||
|
||||
def _delete_quiet(ftp: ftplib.FTP, path: str) -> None:
|
||||
try:
|
||||
ftp.delete(path)
|
||||
except ftplib.all_errors:
|
||||
pass # 임시 파일 정리 실패는 무시(이름에 cf24tmp 가 붙어 있어 구분된다)
|
||||
|
||||
|
||||
def read_text_file(config: Cafe24FtpConfig, path: str) -> str:
|
||||
"""디자인 보관함의 파일 1개를 읽어 텍스트로 돌려준다."""
|
||||
ftp = _connect(config)
|
||||
try:
|
||||
buf = io.BytesIO()
|
||||
try:
|
||||
ftp.retrbinary(f"RETR {path}", buf.write)
|
||||
raw = _retr(ftp, path)
|
||||
except ftplib.all_errors as exc:
|
||||
raise Cafe24FtpError(f"파일을 읽지 못했습니다({path}): {exc}") from exc
|
||||
try:
|
||||
return buf.getvalue().decode("utf-8")
|
||||
return raw.decode("utf-8")
|
||||
except UnicodeDecodeError as exc:
|
||||
raise Cafe24FtpError(f"파일 인코딩을 UTF-8로 해석하지 못했습니다({path}): {exc}") from exc
|
||||
finally:
|
||||
try:
|
||||
ftp.quit()
|
||||
except Exception: # noqa: BLE001 — 정리 실패는 무시
|
||||
ftp.close()
|
||||
_close(ftp)
|
||||
|
||||
|
||||
def write_text_file(config: Cafe24FtpConfig, path: str, content: str) -> None:
|
||||
"""디자인 보관함의 파일 1개를 통째로 덮어쓴다."""
|
||||
def temp_names(path: str, tag: str) -> tuple[str, str]:
|
||||
"""(임시 업로드 이름, 원본을 잠시 비킬 이름) — 같은 폴더, 원본 이름 + 표식."""
|
||||
folder, name = posixpath.split(path)
|
||||
return (posixpath.join(folder, f"{name}.cf24tmp-{tag}"),
|
||||
posixpath.join(folder, f"{name}.cf24old-{tag}"))
|
||||
|
||||
|
||||
def write_text_file(
|
||||
config: Cafe24FtpConfig, path: str, content: str, *, expected_current: str | None = None
|
||||
) -> None:
|
||||
"""디자인 보관함의 파일 1개를 안전하게 교체한다(모듈 설명 참고).
|
||||
|
||||
expected_current: 편집 시작(또는 백업) 때 읽은 원본. 주면 교체 직전 원본을 다시
|
||||
읽어 다르면 Cafe24FtpConflict 로 멈춘다(원본 그대로).
|
||||
실패 시 Cafe24FtpError — maybe_applied=True 면 원본이 이미 바뀌었을 수 있다.
|
||||
"""
|
||||
data = content.encode("utf-8")
|
||||
tmp, aside = temp_names(path, uuid.uuid4().hex[:10])
|
||||
ftp = _connect(config)
|
||||
try:
|
||||
buf = io.BytesIO(content.encode("utf-8"))
|
||||
# 1) 임시 파일에 올린다 — 원본은 아직 그대로다.
|
||||
try:
|
||||
ftp.storbinary(f"STOR {path}", buf)
|
||||
ftp.storbinary(f"STOR {tmp}", io.BytesIO(data))
|
||||
except ftplib.all_errors as exc:
|
||||
raise Cafe24FtpError(f"파일을 쓰지 못했습니다({path}): {exc}") from exc
|
||||
finally:
|
||||
_delete_quiet(ftp, tmp)
|
||||
raise Cafe24FtpError(f"임시 파일을 올리지 못했습니다 — 원본은 그대로입니다({path}): {exc}") from exc
|
||||
|
||||
# 2) 검증 — 다시 받아 바이트 단위로 비교한다(전송이 잘렸으면 여기서 잡힌다).
|
||||
try:
|
||||
ftp.quit()
|
||||
except Exception: # noqa: BLE001 — 정리 실패는 무시
|
||||
ftp.close()
|
||||
uploaded = _retr(ftp, tmp)
|
||||
except ftplib.all_errors as exc:
|
||||
_delete_quiet(ftp, tmp)
|
||||
raise Cafe24FtpError(f"올린 임시 파일을 확인하지 못했습니다 — 원본은 그대로입니다: {exc}") from exc
|
||||
if uploaded != data:
|
||||
_delete_quiet(ftp, tmp)
|
||||
raise Cafe24FtpError(
|
||||
f"올린 임시 파일이 보낸 내용과 다릅니다({len(uploaded)}/{len(data)}바이트) — 원본은 그대로입니다."
|
||||
)
|
||||
|
||||
# 3) 충돌 확인 — 교체 직전의 원본이 편집 시작 값 그대로인가.
|
||||
if expected_current is not None:
|
||||
try:
|
||||
now = _retr(ftp, path)
|
||||
except ftplib.all_errors as exc:
|
||||
_delete_quiet(ftp, tmp)
|
||||
raise Cafe24FtpError(f"교체 직전 원본을 다시 읽지 못했습니다 — 원본은 그대로입니다: {exc}") from exc
|
||||
if now != expected_current.encode("utf-8"):
|
||||
_delete_quiet(ftp, tmp)
|
||||
raise Cafe24FtpConflict(
|
||||
"적용하는 사이 FTP 파일이 바뀌었습니다 — 원본은 그대로입니다. 새로고침해 확인한 뒤 다시 적용하세요."
|
||||
)
|
||||
|
||||
# 4) 교체 — 이름 바꾸기. 덮어쓰기를 거부하는 서버면 원본을 비킨 뒤 교체한다.
|
||||
moved_aside = False
|
||||
try:
|
||||
ftp.rename(tmp, path)
|
||||
except ftplib.all_errors as first:
|
||||
try:
|
||||
ftp.rename(path, aside)
|
||||
except ftplib.all_errors as exc:
|
||||
_delete_quiet(ftp, tmp)
|
||||
raise Cafe24FtpError(
|
||||
"이 FTP 서버가 파일 이름 바꾸기(rename)를 지원하지 않아 중단했습니다 — 원본은 그대로입니다. "
|
||||
f"({first} / {exc})"
|
||||
) from exc
|
||||
try:
|
||||
ftp.rename(tmp, path)
|
||||
except ftplib.all_errors as exc:
|
||||
try:
|
||||
ftp.rename(aside, path)
|
||||
except ftplib.all_errors as exc2:
|
||||
raise Cafe24FtpError(
|
||||
f"교체에 실패했고 원본 되돌리기도 실패했습니다. FTP 에서 {aside} 를 {path} 로 "
|
||||
f"직접 되돌리세요: {exc} / {exc2}",
|
||||
maybe_applied=True,
|
||||
) from exc2
|
||||
_delete_quiet(ftp, tmp)
|
||||
raise Cafe24FtpError(f"교체에 실패해 원본을 되돌렸습니다: {exc}") from exc
|
||||
moved_aside = True
|
||||
|
||||
# 5) 확인 — 교체 뒤 원본 경로가 새 내용인가.
|
||||
try:
|
||||
final = _retr(ftp, path)
|
||||
except ftplib.all_errors as exc:
|
||||
raise Cafe24FtpError(
|
||||
f"교체 뒤 확인 조회에 실패했습니다 — 적용됐을 수 있으니 파일을 다시 열어 확인하세요: {exc}",
|
||||
maybe_applied=True,
|
||||
) from exc
|
||||
if final != data:
|
||||
raise Cafe24FtpError(
|
||||
"교체 뒤 파일 내용이 보낸 것과 다릅니다 — 파일을 다시 열어 확인하세요.", maybe_applied=True
|
||||
)
|
||||
if moved_aside:
|
||||
_delete_quiet(ftp, aside)
|
||||
finally:
|
||||
_close(ftp)
|
||||
|
||||
@@ -32,16 +32,35 @@ class Cafe24RateLimitError(Cafe24Error):
|
||||
|
||||
|
||||
class Cafe24FtpError(Cafe24Error):
|
||||
"""디자인 보관함 FTP 연결/전송 실패 (product-swiper.js 편집 등)."""
|
||||
"""디자인 보관함 FTP 연결/전송 실패 (product-swiper.js 편집 등).
|
||||
|
||||
maybe_applied: 원본 경로가 이미 새 내용으로 바뀌었을 수 있다(교체 뒤 확인 단계 실패).
|
||||
False 면 원본은 그대로다(임시 파일 단계에서 멈춤).
|
||||
"""
|
||||
|
||||
def __init__(self, message: str, *, maybe_applied: bool = False):
|
||||
super().__init__(message)
|
||||
self.maybe_applied = maybe_applied
|
||||
|
||||
|
||||
class Cafe24FtpConflict(Cafe24FtpError):
|
||||
"""교체 직전 다시 읽은 원본이 편집 시작 때와 다르다 — 남의 수정을 덮지 않고 멈춘다."""
|
||||
|
||||
|
||||
class Cafe24ApiError(Cafe24Error):
|
||||
"""그 외 API 오류(4xx/5xx). status 로 재시도 가능 여부를 판단한다."""
|
||||
"""그 외 API 오류(4xx/5xx). status 로 재시도 가능 여부를 판단한다.
|
||||
|
||||
def __init__(self, message: str, *, status: int = 0, endpoint: str = ""):
|
||||
maybe_applied: 쓰기 요청(PUT/POST/DELETE)이 카페24에 **도달했을 수도** 있는가.
|
||||
응답을 받기 전에 끊겼거나(읽기 타임아웃 등) 5xx 를 받은 시도가 한 번이라도
|
||||
있으면 True — 반영됐는지 모르므로 호출부는 재적용하지 말고 "확인 필요"로 둔다.
|
||||
연결 자체가 안 된 경우(ConnectError)와 4xx 는 반영되지 않은 것이 확실하다.
|
||||
"""
|
||||
|
||||
def __init__(self, message: str, *, status: int = 0, endpoint: str = "", maybe_applied: bool = False):
|
||||
super().__init__(message)
|
||||
self.status = status
|
||||
self.endpoint = endpoint
|
||||
self.maybe_applied = maybe_applied
|
||||
|
||||
@property
|
||||
def retryable(self) -> bool:
|
||||
|
||||
@@ -22,6 +22,7 @@ from dataclasses import dataclass
|
||||
from typing import Any
|
||||
|
||||
from .client import Cafe24Client
|
||||
from .errors import Cafe24Error
|
||||
|
||||
# 카페24 상품 목록 API 의 1회 최대 조회 수
|
||||
PAGE_LIMIT = 100
|
||||
@@ -476,26 +477,55 @@ def wait_for_variants(
|
||||
return latest
|
||||
|
||||
|
||||
VARIANT_CHUNK = 100 # 카페24 문서상 PUT variants 1회 최대 건수
|
||||
|
||||
# update_variants 행별 결과 상태
|
||||
VARIANT_OK = "ok" # 카페24가 받아들임
|
||||
VARIANT_FAILED = "failed" # 거절 — 반영되지 않음이 확실
|
||||
VARIANT_UNKNOWN = "unknown" # 요청이 도달했을 수 있으나 응답을 못 받음 — 반영 여부 모름
|
||||
|
||||
|
||||
def update_variants(
|
||||
client: Cafe24Client, product_no: int, requests: list[dict[str, Any]]
|
||||
) -> list[dict[str, Any]]:
|
||||
"""여러 품목 부분 수정. 100건씩 나눠 보낸다(문서상 1회 100건 제한)."""
|
||||
"""여러 품목 부분 수정 — **행별 결과**를 돌려준다(요청 순서 그대로).
|
||||
|
||||
[{"variant_code": "...", "status": "ok"|"failed"|"unknown",
|
||||
"error": "", "variant": {카페24 응답의 그 품목 — 없으면 {}}}]
|
||||
|
||||
100건씩 나눠 보낸다(문서상 1회 100건 제한). 한 묶음이 실패해도 멈추지 않고 다음
|
||||
묶음을 보낸다 — 앞 묶음이 이미 반영됐는데 전체를 실패로 알리면 화면과 카페24가
|
||||
어긋나고, 사용자가 반영된 행까지 다시 보내게 된다. 호출부는 ok 인 행만 반영됨으로
|
||||
기록한다.
|
||||
"""
|
||||
no = int(product_no)
|
||||
out: list[dict[str, Any]] = []
|
||||
for start in range(0, len(requests), 100):
|
||||
chunk = requests[start : start + 100]
|
||||
for start in range(0, len(requests), VARIANT_CHUNK):
|
||||
chunk = requests[start : start + VARIANT_CHUNK]
|
||||
if not chunk:
|
||||
continue
|
||||
payload = client.put(
|
||||
f"/admin/products/{no}/variants", json={"shop_no": 1, "requests": chunk}, product_no=no
|
||||
)
|
||||
try:
|
||||
payload = client.put(
|
||||
f"/admin/products/{no}/variants", json={"shop_no": 1, "requests": chunk}, product_no=no
|
||||
)
|
||||
except Cafe24Error as exc:
|
||||
status = VARIANT_UNKNOWN if getattr(exc, "maybe_applied", False) else VARIANT_FAILED
|
||||
for row in chunk:
|
||||
out.append({"variant_code": str(row.get("variant_code") or ""), "status": status,
|
||||
"error": str(exc), "variant": {}})
|
||||
continue
|
||||
result = payload.get("variants") if isinstance(payload, dict) else None
|
||||
returned: list[dict[str, Any]] = []
|
||||
if isinstance(result, list):
|
||||
out.extend(result)
|
||||
returned = [r for r in result if isinstance(r, dict)]
|
||||
elif isinstance(result, dict):
|
||||
out.append(result)
|
||||
elif isinstance(payload.get("variant"), dict):
|
||||
out.append(payload["variant"])
|
||||
returned = [result]
|
||||
elif isinstance(payload, dict) and isinstance(payload.get("variant"), dict):
|
||||
returned = [payload["variant"]]
|
||||
by_code = {str(r.get("variant_code") or ""): r for r in returned}
|
||||
for row in chunk:
|
||||
code = str(row.get("variant_code") or "")
|
||||
out.append({"variant_code": code, "status": VARIANT_OK, "error": "", "variant": by_code.get(code, {})})
|
||||
return out
|
||||
|
||||
|
||||
|
||||
@@ -0,0 +1,184 @@
|
||||
"""Google 슬라이드(회의록 보드) 공통 계층 — 공유 드라이브 폴더에 빈 슬라이드를 만들거나 찾는다.
|
||||
|
||||
인증은 google_sheets 와 같은 설정을 쓰되 권한 범위(scope)가 다르다(Drive + Slides).
|
||||
설정된 쪽을 자동 선택(서비스 계정 우선).
|
||||
|
||||
1) 사용자 OAuth 리프레시 토큰
|
||||
· `GOOGLE_SLIDES_OAUTH_REFRESH_TOKEN` — 없으면 `GOOGLE_SHEETS_OAUTH_REFRESH_TOKEN`
|
||||
토큰은 Drive·Slides 권한까지 받아야 한다: `python scripts/google_sheets_authorize.py`(스프레드시트·Drive·Slides 한 번에)
|
||||
· `GOOGLE_SHEETS_OAUTH_CLIENT_ID` / `..._SECRET`(없으면 로그인용 `GOOGLE_CLIENT_ID` / `GOOGLE_CLIENT_SECRET`)
|
||||
2) 서비스 계정 JSON — `GOOGLE_SHEETS_CREDENTIALS` / `GOOGLE_SHEETS_CREDENTIALS_JSON`
|
||||
서비스 계정 이메일을 대상 공유 드라이브의 **콘텐츠 관리자** 이상으로 추가해야 한다.
|
||||
|
||||
- 회의록 보드 폴더: `MEETING_BOARD_FOLDER_ID`(기본 = 회의록 보드 공유 드라이브).
|
||||
- 같은 주차 보드를 다시 누르면 새로 만들지 않고 Drive 파일 appProperties(`dbxMeetingWeek` = 주차 시작일)로 찾는다
|
||||
— 파일 이름을 바꿔도 같은 보드가 열린다. 휴지통에 버리면 다음에 새로 만든다.
|
||||
- 비밀값(키/토큰)은 로그·화면에 절대 출력하지 않는다. 라이브러리·설정이 없으면 `enabled = False`.
|
||||
"""
|
||||
|
||||
from __future__ import annotations
|
||||
|
||||
import json
|
||||
import os
|
||||
import re
|
||||
import threading
|
||||
from typing import Any
|
||||
|
||||
SCOPES = ["https://www.googleapis.com/auth/drive", "https://www.googleapis.com/auth/presentations"]
|
||||
TOKEN_URI = "https://oauth2.googleapis.com/token"
|
||||
DEFAULT_BOARD_FOLDER_ID = "0AGF3CIEboPQiUk9PVA"
|
||||
PRESENTATION_MIME = "application/vnd.google-apps.presentation"
|
||||
WEEK_KEY = "dbxMeetingWeek"
|
||||
|
||||
# googleapiclient 의 HTTP 클라이언트는 스레드 안전하지 않고, 같은 주차를 두 사람이 동시에 누르면
|
||||
# 보드가 두 개 생길 수 있으므로 찾기·만들기는 한 번에 하나씩.
|
||||
_LOCK = threading.Lock()
|
||||
|
||||
|
||||
class GoogleSlidesError(RuntimeError):
|
||||
"""화면에 보여도 되는 사유(비밀값 없음)."""
|
||||
|
||||
|
||||
def board_folder_id() -> str:
|
||||
return (os.getenv("MEETING_BOARD_FOLDER_ID") or "").strip() or DEFAULT_BOARD_FOLDER_ID
|
||||
|
||||
|
||||
def board_url(file_id: str) -> str:
|
||||
return f"https://docs.google.com/presentation/d/{file_id}/edit"
|
||||
|
||||
|
||||
class GoogleSlidesClient:
|
||||
def __init__(self) -> None:
|
||||
self.enabled = False
|
||||
self.reason = ""
|
||||
self.auth_mode = ""
|
||||
self._drive: Any = None
|
||||
self._slides: Any = None
|
||||
try:
|
||||
from googleapiclient.discovery import build
|
||||
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_SLIDES_OAUTH_REFRESH_TOKEN 또는 GOOGLE_SHEETS_* 설정 필요)"
|
||||
return
|
||||
try:
|
||||
self._drive = build("drive", "v3", credentials=creds, cache_discovery=False)
|
||||
self._slides = build("slides", "v1", credentials=creds, cache_discovery=False)
|
||||
except Exception as exc: # noqa: BLE001 — 사유만(비밀값 미출력)
|
||||
self.reason = f"Google 클라이언트 생성 실패: {type(exc).__name__}"
|
||||
return
|
||||
self.enabled = True
|
||||
|
||||
# ── 인증(google_sheets 와 같은 설정, 범위만 Drive·Slides) ──
|
||||
def _service_account_creds(self) -> Any:
|
||||
raw = (os.getenv("GOOGLE_SHEETS_CREDENTIALS_JSON") or "").strip()
|
||||
path = (os.getenv("GOOGLE_SHEETS_CREDENTIALS") or "").strip()
|
||||
if not raw and not path:
|
||||
return None
|
||||
try:
|
||||
info = json.loads(raw) if raw else json.loads(open(path, encoding="utf-8").read())
|
||||
from google.oauth2.service_account import Credentials
|
||||
|
||||
creds = Credentials.from_service_account_info(info, scopes=SCOPES)
|
||||
except Exception as exc: # noqa: BLE001
|
||||
self.reason = f"서비스 계정 인증 실패: {type(exc).__name__}"
|
||||
return None
|
||||
self.auth_mode = "service_account"
|
||||
return creds
|
||||
|
||||
def _oauth_creds(self) -> Any:
|
||||
token = (os.getenv("GOOGLE_SLIDES_OAUTH_REFRESH_TOKEN") or os.getenv("GOOGLE_SHEETS_OAUTH_REFRESH_TOKEN") or "").strip()
|
||||
if not token:
|
||||
return None
|
||||
cid = (os.getenv("GOOGLE_SHEETS_OAUTH_CLIENT_ID") or os.getenv("GOOGLE_CLIENT_ID") or "").strip()
|
||||
secret = (os.getenv("GOOGLE_SHEETS_OAUTH_CLIENT_SECRET") or os.getenv("GOOGLE_CLIENT_SECRET") or "").strip()
|
||||
if not cid or not secret:
|
||||
self.reason = "GOOGLE_SHEETS_OAUTH_CLIENT_ID/SECRET 미설정"
|
||||
return None
|
||||
try:
|
||||
from google.oauth2.credentials import Credentials
|
||||
|
||||
creds = Credentials(token=None, refresh_token=token, token_uri=TOKEN_URI,
|
||||
client_id=cid, client_secret=secret, scopes=SCOPES)
|
||||
except Exception as exc: # noqa: BLE001
|
||||
self.reason = f"OAuth 자격 생성 실패: {type(exc).__name__}"
|
||||
return None
|
||||
self.auth_mode = "oauth"
|
||||
return creds
|
||||
|
||||
# ────────────────────────────────────────────────
|
||||
def open_week_board(self, *, folder_id: str, week_key: str, title: str) -> dict[str, Any]:
|
||||
"""그 주차 보드(빈 슬라이드)를 찾고, 없으면 폴더에 만든다 → {id, url, created}."""
|
||||
if not self.enabled:
|
||||
raise GoogleSlidesError(self.reason or "Google 슬라이드 연동이 꺼져 있습니다.")
|
||||
with _LOCK:
|
||||
try:
|
||||
found = self._find(folder_id, week_key)
|
||||
if found:
|
||||
return {"id": found, "url": board_url(found), "created": False}
|
||||
file_id = self._create_blank(folder_id, week_key, title)
|
||||
except GoogleSlidesError:
|
||||
raise
|
||||
except Exception as exc: # noqa: BLE001
|
||||
raise GoogleSlidesError(_friendly(exc)) from None
|
||||
return {"id": file_id, "url": board_url(file_id), "created": True}
|
||||
|
||||
def _find(self, folder_id: str, week_key: str) -> str | None:
|
||||
q = (f"'{folder_id}' in parents and trashed = false and mimeType = '{PRESENTATION_MIME}' "
|
||||
f"and appProperties has {{ key='{WEEK_KEY}' and value='{week_key}' }}")
|
||||
res = self._drive.files().list(
|
||||
q=q, fields="files(id)", pageSize=1, supportsAllDrives=True, includeItemsFromAllDrives=True,
|
||||
corpora="allDrives",
|
||||
).execute()
|
||||
files = res.get("files") or []
|
||||
return files[0]["id"] if files else None
|
||||
|
||||
def _create_blank(self, folder_id: str, week_key: str, title: str) -> str:
|
||||
meta = {"name": title, "mimeType": PRESENTATION_MIME, "parents": [folder_id],
|
||||
"appProperties": {WEEK_KEY: week_key}}
|
||||
file_id = self._drive.files().create(body=meta, fields="id", supportsAllDrives=True).execute()["id"]
|
||||
# 새 프레젠테이션의 첫 장은 "제목·부제목" 틀(TITLE 레이아웃) — 틀 없는 빈 장(BLANK) 하나만 남긴다
|
||||
pres = self._slides.presentations().get(presentationId=file_id, fields="slides.objectId").execute()
|
||||
reqs: list[dict[str, Any]] = [{"createSlide": {"insertionIndex": 0, "slideLayoutReference": {"predefinedLayout": "BLANK"}}}]
|
||||
reqs += [{"deleteObject": {"objectId": s["objectId"]}} for s in pres.get("slides") or []]
|
||||
self._slides.presentations().batchUpdate(presentationId=file_id, body={"requests": reqs}).execute()
|
||||
return file_id
|
||||
|
||||
|
||||
def _friendly(exc: Exception) -> str:
|
||||
"""Google API 오류 → 화면용 문구(비밀값·원문 응답 미포함)."""
|
||||
status = getattr(getattr(exc, "resp", None), "status", None)
|
||||
text = str(exc)
|
||||
# 토큰 갱신 실패(RefreshError) — Google 이 준 OAuth 오류 코드(비밀값 아님)를 보여 원인을 바로 알 수 있게
|
||||
m = re.search(r"\b(invalid_scope|invalid_grant|invalid_client|unauthorized_client|deleted_client|access_denied|invalid_request)\b", text)
|
||||
code = m.group(1) if m else ""
|
||||
if code in ("unauthorized_client", "invalid_client", "deleted_client"):
|
||||
return (f"Google 토큰 갱신 실패({code}) — 토큰을 발급한 OAuth 클라이언트와 서버 .env 의 "
|
||||
"GOOGLE_SHEETS_OAUTH_CLIENT_ID/SECRET(없으면 GOOGLE_CLIENT_ID/SECRET)이 다릅니다.")
|
||||
if "invalid_scope" in text or "insufficient" in text.lower() or "ACCESS_TOKEN_SCOPE_INSUFFICIENT" in text:
|
||||
return "Google 권한(Drive·Slides)이 없는 토큰입니다. 토큰을 다시 발급해 주세요(scripts/google_sheets_authorize.py)."
|
||||
if "invalid_grant" in text:
|
||||
return "Google 토큰이 만료·폐기되었습니다. 토큰을 다시 발급해 주세요."
|
||||
if status == 404:
|
||||
return "회의록 보드 폴더를 찾을 수 없습니다(MEETING_BOARD_FOLDER_ID·공유 드라이브 접근 권한 확인)."
|
||||
if status == 403:
|
||||
return "Google Drive·Slides 접근이 거부되었습니다(API 사용 설정·공유 드라이브 권한 확인)."
|
||||
return f"Google 슬라이드 처리 실패({type(exc).__name__}{f' {status}' if status else ''}{f' {code}' if code else ''})."
|
||||
|
||||
|
||||
_CLIENT: GoogleSlidesClient | None = None
|
||||
_CLIENT_LOCK = threading.Lock()
|
||||
|
||||
|
||||
def get_client() -> GoogleSlidesClient:
|
||||
"""프로세스당 하나(설정이 비어 있으면 매번 다시 확인 — .env 를 고치고 재시작 없이도 사유가 갱신되게)."""
|
||||
global _CLIENT
|
||||
with _CLIENT_LOCK:
|
||||
if _CLIENT is None or not _CLIENT.enabled:
|
||||
_CLIENT = GoogleSlidesClient()
|
||||
return _CLIENT
|
||||
+69
-4
@@ -15,6 +15,8 @@ from pydantic import BaseModel
|
||||
from starlette.middleware.sessions import SessionMiddleware
|
||||
|
||||
from .modules.cafe24 import build_cafe24_store
|
||||
from .modules.asset import build_asset_store
|
||||
from .modules.asset import router as asset_router
|
||||
from .modules.cafe24 import router as cafe24_router
|
||||
from .modules.cupang import build_cupang_store, build_itemcode_reader
|
||||
from .modules.cupang import router as cupang_router
|
||||
@@ -24,6 +26,10 @@ from .modules.expense import CategoryStore, build_expense_store
|
||||
from .modules.expense import router as expense_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.performance import build_performance_store
|
||||
from .modules.performance import router as performance_router
|
||||
from .modules.project import build_project_store
|
||||
from .modules.project import router as project_router
|
||||
from .modules.vacation import build_vacation_store
|
||||
@@ -31,6 +37,8 @@ from .modules.vacation import router as vacation_router
|
||||
from .store import (
|
||||
APPROVER_KEYS,
|
||||
MODULE_KEYS,
|
||||
ROLE_LABELS,
|
||||
ROLES,
|
||||
SUPER_ADMIN_EMAIL,
|
||||
UserStore,
|
||||
allowed_modules,
|
||||
@@ -49,6 +57,8 @@ MODULE_LABELS: dict[str, str] = {
|
||||
"dispatch": "말레이시아 배송",
|
||||
"project": "프로젝트 관리",
|
||||
"cafe24": "카페24 상품관리",
|
||||
"performance": "실적",
|
||||
"asset": "자산관리",
|
||||
"expense_approver": "개인경비",
|
||||
"vacation_approver": "휴가",
|
||||
}
|
||||
@@ -107,10 +117,14 @@ def build_google_oauth() -> OAuth:
|
||||
async def _lifespan(app_: FastAPI): # noqa: ANN201
|
||||
"""앱 시작 시 백그라운드 작업 시작.
|
||||
- 프로젝트 업무 마감 알림(매일 1회, 기본 09시 KST) 스레드.
|
||||
PROJECT_REMINDERS=false 면 안 돈다. 상세는 app/modules/project/reminders.py."""
|
||||
PROJECT_REMINDERS=false 면 안 돈다. 상세는 app/modules/project/reminders.py.
|
||||
- 실적 매출 자동 업데이트(09~19시 정각·30분, 최근 10일) 스레드.
|
||||
PERFORMANCE_AUTO_SYNC=false 면 안 돈다. 상세는 app/modules/performance/auto_sync.py."""
|
||||
from .modules.performance.auto_sync import start_auto_sync_thread # noqa: WPS433
|
||||
from .modules.project.reminders import start_reminder_thread # noqa: WPS433
|
||||
|
||||
start_reminder_thread(getattr(app_.state, "project_store", None))
|
||||
start_auto_sync_thread(app_.state)
|
||||
yield
|
||||
|
||||
|
||||
@@ -136,6 +150,9 @@ _MODULE_TEMPLATE_DIRS = [
|
||||
BASE_DIR / "modules" / "dispatch" / "templates",
|
||||
BASE_DIR / "modules" / "project" / "templates",
|
||||
BASE_DIR / "modules" / "cafe24" / "templates",
|
||||
BASE_DIR / "modules" / "performance" / "templates",
|
||||
BASE_DIR / "modules" / "asset" / "templates",
|
||||
BASE_DIR / "modules" / "notice" / "templates",
|
||||
]
|
||||
templates = Jinja2Templates(directory=str(BASE_DIR / "templates"))
|
||||
templates.env.loader = ChoiceLoader(
|
||||
@@ -195,6 +212,12 @@ app.state.project_store = build_project_store(dsn=env("PROJECT_DB_URL") or None)
|
||||
# 카페24 상품관리: CAFE24_DB_URL 없으면 store=None(라우터가 "설정 필요" 안내).
|
||||
# 카페24 API 호출/토큰은 app/integrations/cafe24 공통 계층(CAFE24_* 환경변수).
|
||||
app.state.cafe24_store = build_cafe24_store(dsn=env("CAFE24_DB_URL") or None)
|
||||
# 실적(쇼핑몰 통합 매출): PERFORMANCE_DB_URL 없으면 store=None(라우터가 "설정 필요" 안내).
|
||||
# 쇼핑몰 API 인증정보는 설정 화면에서 입력 → APP_ENCRYPTION_KEY 로 암호화해 performance_db 에 저장.
|
||||
app.state.performance_store = build_performance_store(dsn=env("PERFORMANCE_DB_URL") or None)
|
||||
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)
|
||||
|
||||
# 모듈 라우터 등록 — 신규 모듈 추가 시 여기 한 줄.
|
||||
app.include_router(expense_router)
|
||||
@@ -204,6 +227,9 @@ app.include_router(malaysia_router)
|
||||
app.include_router(dispatch_router)
|
||||
app.include_router(project_router)
|
||||
app.include_router(cafe24_router)
|
||||
app.include_router(performance_router)
|
||||
app.include_router(asset_router)
|
||||
app.include_router(notice_router)
|
||||
|
||||
|
||||
def public_url_for(request: Request, route_name: str) -> str:
|
||||
@@ -368,7 +394,7 @@ def _menu_items_for(user_rec: dict[str, Any]) -> list[dict[str, Any]]:
|
||||
},
|
||||
{
|
||||
"key": "project",
|
||||
"title": "프로젝트 관리",
|
||||
"title": "Project",
|
||||
"subtitle": "Projects",
|
||||
"description": "프로젝트·서브프로젝트·업무를 달력/타임라인/보드로 관리합니다(아사나식).",
|
||||
"url": "/project/",
|
||||
@@ -386,7 +412,22 @@ def _menu_items_for(user_rec: dict[str, Any]) -> list[dict[str, Any]]:
|
||||
"status": "ready",
|
||||
"category": "운영",
|
||||
},
|
||||
{
|
||||
"key": "performance",
|
||||
"title": "실적",
|
||||
"subtitle": "Sales Performance",
|
||||
"description": "여러 쇼핑몰의 매출을 일자·쇼핑몰별로 한 화면에서 보고 수수료 차감 매출을 계산합니다.",
|
||||
"url": "/performance/",
|
||||
"health_url": "/performance/health",
|
||||
"status": "ready",
|
||||
"category": "관리",
|
||||
},
|
||||
]
|
||||
items.append({
|
||||
"key": "asset", "title": "자산관리", "subtitle": "Asset Management",
|
||||
"description": "사무집기·전산장비의 배정·반납·구매 이력과 HWiNFO 컴퓨터 사양을 관리합니다.",
|
||||
"url": "/asset/", "health_url": "/asset/health", "status": "ready", "category": "관리",
|
||||
})
|
||||
allowed = allowed_modules(user_rec)
|
||||
for item in items:
|
||||
item["allowed"] = item["key"] in allowed
|
||||
@@ -396,6 +437,7 @@ def _menu_items_for(user_rec: dict[str, Any]) -> list[dict[str, Any]]:
|
||||
def _icon_svg(name: str) -> str:
|
||||
"""좌측 사이드바용 인라인 아이콘. 외부 의존 없는 작은 SVG."""
|
||||
paths = {
|
||||
"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"/>',
|
||||
"vacation": '<path d="M8 2v4"/><path d="M16 2v4"/><rect x="3" y="6" width="18" height="15" rx="2"/><path d="M3 11h18"/>',
|
||||
@@ -406,6 +448,7 @@ def _icon_svg(name: str) -> str:
|
||||
"dispatch": '<rect x="1" y="3" width="15" height="13"/><path d="M16 8h4l3 3v5h-7V8z"/><circle cx="5.5" cy="18.5" r="2.5"/><circle cx="18.5" cy="18.5" r="2.5"/>',
|
||||
"project": '<rect x="3" y="4" width="18" height="16" rx="2"/><line x1="3" y1="9" x2="21" y2="9"/><line x1="8" y1="13" x2="13" y2="13"/><line x1="8" y1="16" x2="11" y2="16"/>',
|
||||
"cafe24": '<rect x="3" y="4" width="18" height="16" rx="2"/><path d="M7 9h10"/><path d="M7 13h7"/><path d="M7 17h4"/>',
|
||||
"performance": '<path d="M3 3v18h18"/><rect x="7" y="12" width="3" height="6"/><rect x="12" y="8" width="3" height="10"/><rect x="17" y="5" width="3" height="13"/>',
|
||||
"modules": '<rect x="3" y="3" width="7" height="7"/><rect x="14" y="3" width="7" height="7"/><rect x="3" y="14" width="7" height="7"/><rect x="14" y="14" width="7" height="7"/>',
|
||||
}
|
||||
body = paths.get(name, paths["modules"])
|
||||
@@ -457,16 +500,36 @@ def build_erp_nav(
|
||||
return items
|
||||
|
||||
|
||||
def _login_orbit_names(limit: int = 40) -> list[str]:
|
||||
"""로그인 화면 왼쪽 패널 — King 주위를 도는 사용자 아이디(이메일 @ 앞, 첫 글자 대문자). 이메일·실명은 내보내지 않는다."""
|
||||
names: set[str] = set()
|
||||
try:
|
||||
users = user_store.list_all()
|
||||
except Exception: # noqa: BLE001 — 장식이라 실패해도 로그인 화면은 그대로
|
||||
return []
|
||||
for u in users:
|
||||
email = str(u.get("email") or "").lower().strip()
|
||||
local = email.split("@", 1)[0]
|
||||
if not local or email == SUPER_ADMIN_EMAIL:
|
||||
continue
|
||||
names.add(local[:1].upper() + local[1:])
|
||||
return sorted(names)[:limit]
|
||||
|
||||
|
||||
def _render_login(request: Request) -> HTMLResponse:
|
||||
return render_template(request, "login.html", {"orbit_names": _login_orbit_names()})
|
||||
|
||||
|
||||
@app.get("/", response_class=HTMLResponse)
|
||||
async def home(request: Request) -> HTMLResponse:
|
||||
sess = get_session_user(request)
|
||||
if not sess:
|
||||
return render_template(request, "login.html")
|
||||
return _render_login(request)
|
||||
user_rec = user_store.get(sess["email"])
|
||||
if user_rec is None:
|
||||
# 도메인은 통과했으나 저장소에 없음 — 세션 정리 후 재로그인
|
||||
request.session.clear()
|
||||
return render_template(request, "login.html")
|
||||
return _render_login(request)
|
||||
|
||||
# 슈퍼 관리자 → 업무 모듈 선택 화면(main.html).
|
||||
# 일반 사용자 → ERP 메인(좌측 메뉴 + 우측 콘텐츠).
|
||||
@@ -612,6 +675,8 @@ async def admin_page(request: Request) -> HTMLResponse:
|
||||
"module_keys": list(MODULE_KEYS),
|
||||
"module_labels": MODULE_LABELS,
|
||||
"approver_keys": list(APPROVER_KEYS),
|
||||
"roles": list(ROLES),
|
||||
"role_labels": ROLE_LABELS,
|
||||
"super_admin_email": SUPER_ADMIN_EMAIL,
|
||||
"is_admin": True,
|
||||
},
|
||||
|
||||
@@ -0,0 +1,9 @@
|
||||
"""Company asset management; PostgreSQL only, never creates databases at startup."""
|
||||
from .router import router
|
||||
|
||||
|
||||
def build_asset_store(*, dsn: str | None):
|
||||
if not dsn:
|
||||
return None
|
||||
from .db import AssetStore
|
||||
return AssetStore(dsn)
|
||||
@@ -0,0 +1,282 @@
|
||||
"""자산·보고서·이력을 함께 저장합니다. DB 생성은 사용자가 서버에서 SQL로 진행합니다."""
|
||||
from __future__ import annotations
|
||||
|
||||
import uuid
|
||||
from datetime import date, datetime
|
||||
from decimal import Decimal
|
||||
|
||||
from psycopg.rows import dict_row
|
||||
from psycopg.types.json import Jsonb
|
||||
from psycopg_pool import ConnectionPool
|
||||
|
||||
from .store import AssetConflict, transition
|
||||
from .media import MAX_PHOTOS
|
||||
from .monitors import compatible_monitor, monitor_devices
|
||||
|
||||
FIELDS = ("tag", "name", "category", "manufacturer", "model", "serial", "location", "department",
|
||||
"purchased_on", "purchase_cost", "vendor", "warranty_until", "notes")
|
||||
SORTS = {"updated": "a.updated_at DESC", "name": "a.name ASC", "tag": "a.tag ASC",
|
||||
"cost": "a.purchase_cost DESC NULLS LAST", "warranty": "a.warranty_until ASC NULLS LAST"}
|
||||
|
||||
|
||||
def serialize(row):
|
||||
if row is None:
|
||||
return None
|
||||
return {k: (v.isoformat() if isinstance(v, (date, datetime)) else str(v) if isinstance(v, Decimal) else v)
|
||||
for k, v in row.items()}
|
||||
|
||||
|
||||
def filters(q="", category="", status="", location="", assignee="", warranty=False, group=""):
|
||||
conditions, params = ["a.deleted_at IS NULL"], []
|
||||
if q:
|
||||
# %와 _도 입력한 글자 그대로 검색합니다. 검색어는 SQL과 분리해서 전달합니다.
|
||||
value = "%" + q.replace("\\", "\\\\").replace("%", "\\%").replace("_", "\\_") + "%"
|
||||
conditions.append("(concat_ws(' ',a.tag,a.name,a.model,a.serial,a.manufacturer,a.location,a.department,a.assignee_email) ILIKE %s)")
|
||||
params.append(value)
|
||||
for col, value in (("category", category), ("status", status), ("location", location), ("assignee_email", assignee)):
|
||||
if value:
|
||||
conditions.append(f"a.{col} = %s")
|
||||
params.append(value)
|
||||
if warranty:
|
||||
conditions.append("a.warranty_until BETWEEN (now() AT TIME ZONE 'Asia/Seoul')::date AND (now() AT TIME ZONE 'Asia/Seoul')::date + 30 AND a.status <> 'retired'")
|
||||
if group == "furniture":
|
||||
conditions.append("a.category IN ('desk','chair','furniture')")
|
||||
elif group == "computer":
|
||||
conditions.append("a.category NOT IN ('desk','chair','furniture')")
|
||||
return " AND ".join(conditions), params
|
||||
|
||||
|
||||
class AssetStore:
|
||||
def __init__(self, dsn):
|
||||
self._pool = ConnectionPool(dsn, min_size=0, max_size=5, timeout=5, open=False,
|
||||
kwargs={"row_factory": dict_row, "autocommit": True})
|
||||
self._pool.open(wait=False)
|
||||
|
||||
def close(self):
|
||||
self._pool.close()
|
||||
|
||||
def health(self):
|
||||
with self._pool.connection(timeout=5) as conn:
|
||||
conn.execute("SELECT id,deleted_at FROM assets LIMIT 1")
|
||||
conn.execute("SELECT id FROM asset_photos LIMIT 0")
|
||||
conn.execute("SELECT monitor_key FROM asset_monitor_links LIMIT 0")
|
||||
|
||||
def list_assets(self, *, page=1, page_size=25, sort="updated", **kwargs):
|
||||
# 전체 개수와 목록을 같은 시점의 데이터로 읽어 페이지 숫자가 어긋나지 않게 합니다.
|
||||
where, params = filters(**kwargs)
|
||||
with self._pool.connection() as conn, conn.transaction():
|
||||
conn.execute("SET TRANSACTION ISOLATION LEVEL REPEATABLE READ READ ONLY")
|
||||
total = conn.execute(f"SELECT count(*) AS n FROM assets a WHERE {where}", params).fetchone()["n"]
|
||||
rows = conn.execute(
|
||||
f"SELECT a.*,r.parsed->'summary' AS specs,r.uploaded_at AS report_at FROM assets a "
|
||||
"LEFT JOIN asset_reports r ON r.id=a.latest_report_id "
|
||||
f"WHERE {where} ORDER BY {SORTS.get(sort, SORTS['updated'])},a.id LIMIT %s OFFSET %s",
|
||||
[*params, page_size, (page - 1) * page_size]).fetchall()
|
||||
return {"items": [serialize(r) for r in rows], "total": total, "page": page, "page_size": page_size}
|
||||
|
||||
def dashboard(self):
|
||||
with self._pool.connection() as conn, conn.transaction():
|
||||
conn.execute("SET TRANSACTION ISOLATION LEVEL REPEATABLE READ READ ONLY")
|
||||
totals = conn.execute("""SELECT count(*) AS total,
|
||||
count(*) FILTER(WHERE status='available') AS available,
|
||||
count(*) FILTER(WHERE status='in_use') AS in_use,
|
||||
count(*) FILTER(WHERE status='maintenance') AS maintenance,
|
||||
count(*) FILTER(WHERE status='lost') AS lost,
|
||||
count(*) FILTER(WHERE status='retired') AS retired,
|
||||
coalesce(sum(purchase_cost) FILTER(WHERE status<>'retired'),0) AS purchase_total,
|
||||
count(*) FILTER(WHERE status<>'retired' AND warranty_until BETWEEN
|
||||
(now() AT TIME ZONE 'Asia/Seoul')::date AND (now() AT TIME ZONE 'Asia/Seoul')::date+30) AS warranty_soon
|
||||
FROM assets WHERE deleted_at IS NULL""").fetchone()
|
||||
categories = conn.execute("SELECT category,count(*) AS count FROM assets WHERE deleted_at IS NULL GROUP BY category ORDER BY count(*) DESC,category").fetchall()
|
||||
locations = conn.execute("SELECT DISTINCT location FROM assets WHERE location<>'' AND deleted_at IS NULL ORDER BY location").fetchall()
|
||||
activity = conn.execute("SELECT e.*,a.tag,a.name FROM asset_events e JOIN assets a ON a.id=e.asset_id WHERE a.deleted_at IS NULL ORDER BY e.id DESC LIMIT 12").fetchall()
|
||||
return {"totals": serialize(totals), "categories": categories, "locations": [r["location"] for r in locations],
|
||||
"activity": [serialize(r) for r in activity]}
|
||||
|
||||
def detail(self, asset_id):
|
||||
with self._pool.connection() as conn, conn.transaction():
|
||||
conn.execute("SET TRANSACTION ISOLATION LEVEL REPEATABLE READ READ ONLY")
|
||||
asset = conn.execute("SELECT * FROM assets WHERE id=%s AND deleted_at IS NULL", (asset_id,)).fetchone()
|
||||
if not asset:
|
||||
raise KeyError(asset_id)
|
||||
reports = conn.execute("SELECT id,filename,sha256,uploaded_at,actor,parsed->'summary' AS summary,parsed->>'scan_time' AS scan_time FROM asset_reports WHERE asset_id=%s ORDER BY uploaded_at DESC,id DESC", (asset_id,)).fetchall()
|
||||
report = conn.execute("SELECT id,filename,uploaded_at,parsed FROM asset_reports WHERE id=%s AND asset_id=%s", (asset["latest_report_id"], asset_id)).fetchone() if asset["latest_report_id"] else None
|
||||
events = conn.execute("SELECT * FROM asset_events WHERE asset_id=%s ORDER BY id DESC LIMIT 200", (asset_id,)).fetchall()
|
||||
photos = conn.execute("SELECT id,filename,width,height,uploaded_at,actor FROM asset_photos WHERE asset_id=%s ORDER BY uploaded_at DESC,id", (asset_id,)).fetchall()
|
||||
monitors = self._monitor_matches(conn, asset_id, report["parsed"]) if report else []
|
||||
return {"asset": serialize(asset), "report": serialize(report), "reports": [serialize(r) for r in reports],
|
||||
"events": [serialize(r) for r in events], "photos": [serialize(r) for r in photos], "monitors": monitors}
|
||||
|
||||
@staticmethod
|
||||
def _lock(conn, asset_id, version):
|
||||
# 같은 자산을 동시에 변경할 때 먼저 저장한 사용자의 값을 보호합니다.
|
||||
asset = conn.execute("SELECT * FROM assets WHERE id=%s AND deleted_at IS NULL FOR UPDATE", (asset_id,)).fetchone()
|
||||
if not asset or asset.get("deleted_at"):
|
||||
raise KeyError(asset_id)
|
||||
if asset["version"] != version:
|
||||
raise AssetConflict("다른 사용자가 수정했습니다. 상세 화면을 새로 열고 다시 시도하세요.")
|
||||
return asset
|
||||
|
||||
@staticmethod
|
||||
def _event(conn, asset_id, actor, kind, note, changes):
|
||||
conn.execute("INSERT INTO asset_events(asset_id,actor,kind,note,changes) VALUES(%s,%s,%s,%s,%s)",
|
||||
(asset_id, actor, kind, note, Jsonb(changes)))
|
||||
|
||||
def create(self, payload, actor, report=None):
|
||||
with self._pool.connection() as conn, conn.transaction():
|
||||
return self._create(conn, payload, actor, report)
|
||||
|
||||
def _create(self, conn, payload, actor, report=None):
|
||||
# 모니터 등록도 같은 트랜잭션 안에서 자산 생성과 연결을 함께 처리합니다.
|
||||
data = payload.model_dump()
|
||||
asset_id = uuid.uuid4().hex
|
||||
if not data["tag"]:
|
||||
data["tag"] = "AST-" + str(conn.execute("SELECT nextval('asset_tag_seq') AS n").fetchone()["n"]).zfill(6)
|
||||
conn.execute(f"INSERT INTO assets(id,{','.join(FIELDS)}) VALUES({','.join(['%s'] * (len(FIELDS) + 1))})",
|
||||
[asset_id, *[data[k] for k in FIELDS]])
|
||||
self._event(conn, asset_id, actor, "create", "자산 등록", {"after": serialize(data)})
|
||||
if report:
|
||||
if data["category"] != "computer":
|
||||
raise ValueError("HWiNFO 보고서는 컴퓨터 자산에만 연결할 수 있습니다.")
|
||||
self._save_report(conn, asset_id, actor, *report)
|
||||
return asset_id
|
||||
|
||||
def update(self, asset_id, payload, actor):
|
||||
data = payload.model_dump(exclude={"version"})
|
||||
with self._pool.connection() as conn, conn.transaction():
|
||||
old = self._lock(conn, asset_id, payload.version)
|
||||
if old["latest_report_id"] and data["category"] != "computer":
|
||||
raise ValueError("사양 보고서가 연결된 자산은 컴퓨터 분류를 유지해야 합니다.")
|
||||
if not data["tag"]:
|
||||
data["tag"] = old["tag"]
|
||||
changes = {k: {"before": serialize(old)[k], "after": serialize(data)[k]} for k in FIELDS if old[k] != data[k]}
|
||||
if changes:
|
||||
conn.execute(f"UPDATE assets SET {','.join(k+'=%s' for k in FIELDS)},version=version+1,updated_at=now() WHERE id=%s",
|
||||
[*[data[k] for k in FIELDS], asset_id])
|
||||
self._event(conn, asset_id, actor, "update", "자산 정보 수정", changes)
|
||||
|
||||
def action(self, asset_id, payload, actor):
|
||||
with self._pool.connection() as conn, conn.transaction():
|
||||
old = self._lock(conn, asset_id, payload.version)
|
||||
status, assignee = transition(old, payload)
|
||||
location = payload.location or old["location"]
|
||||
conn.execute("UPDATE assets SET status=%s,assignee_email=%s,location=%s,version=version+1,updated_at=now() WHERE id=%s",
|
||||
(status, assignee, location, asset_id))
|
||||
changes = {k: {"before": old[k], "after": value} for k, value in
|
||||
(("status", status), ("assignee_email", assignee), ("location", location)) if old[k] != value}
|
||||
self._event(conn, asset_id, actor, payload.action, payload.note, changes)
|
||||
|
||||
def _save_report(self, conn, asset_id, actor, filename, raw, parsed):
|
||||
# 원본과 분석 결과를 함께 저장하고 최신 보고서만 교체합니다. 이전 보고서는 남습니다.
|
||||
existing = conn.execute("SELECT id FROM asset_reports WHERE asset_id=%s AND sha256=%s", (asset_id, parsed["sha256"])).fetchone()
|
||||
if existing:
|
||||
raise AssetConflict("이 자산에 동일한 보고서가 이미 등록되어 있습니다.")
|
||||
report_id = uuid.uuid4().hex
|
||||
conn.execute("INSERT INTO asset_reports(id,asset_id,filename,sha256,raw_xml,parsed,actor) VALUES(%s,%s,%s,%s,%s,%s,%s)",
|
||||
(report_id, asset_id, filename, parsed["sha256"], raw, Jsonb(parsed), actor))
|
||||
conn.execute("UPDATE assets SET latest_report_id=%s,version=version+1,updated_at=now() WHERE id=%s", (report_id, asset_id))
|
||||
self._event(conn, asset_id, actor, "report", filename, {"report_id": report_id, "summary": parsed["summary"]})
|
||||
return report_id
|
||||
|
||||
def attach_report(self, asset_id, version, actor, filename, raw, parsed):
|
||||
with self._pool.connection() as conn, conn.transaction():
|
||||
asset = self._lock(conn, asset_id, version)
|
||||
if asset["category"] != "computer":
|
||||
raise ValueError("HWiNFO 보고서는 컴퓨터 자산에만 연결할 수 있습니다.")
|
||||
return self._save_report(conn, asset_id, actor, filename, raw, parsed)
|
||||
|
||||
def report(self, asset_id, report_id, *, raw=False):
|
||||
columns = "r.filename,r.raw_xml" if raw else "r.id,r.filename,r.parsed,r.uploaded_at"
|
||||
with self._pool.connection() as conn:
|
||||
row = conn.execute(f"SELECT {columns} FROM asset_reports r JOIN assets a ON a.id=r.asset_id WHERE r.asset_id=%s AND r.id=%s AND a.deleted_at IS NULL", (asset_id, report_id)).fetchone()
|
||||
if not row:
|
||||
raise KeyError(report_id)
|
||||
return serialize(row)
|
||||
|
||||
def delete(self, asset_id, version, actor, note):
|
||||
# 수퍼 관리자 삭제도 이력과 원본은 보존하고 대장·다운로드에서 제외합니다.
|
||||
with self._pool.connection() as conn, conn.transaction():
|
||||
self._lock(conn, asset_id, version)
|
||||
self._event(conn, asset_id, actor, "delete", note, {})
|
||||
conn.execute("UPDATE assets SET deleted_at=now(),deleted_by=%s,version=version+1,updated_at=now() WHERE id=%s", (actor, asset_id))
|
||||
|
||||
def add_photo(self, asset_id, version, actor, filename, image, mime, width, height):
|
||||
with self._pool.connection() as conn, conn.transaction():
|
||||
self._lock(conn, asset_id, version)
|
||||
count = conn.execute("SELECT count(*) AS n FROM asset_photos WHERE asset_id=%s", (asset_id,)).fetchone()["n"]
|
||||
if count >= MAX_PHOTOS:
|
||||
raise ValueError(f"사진은 자산당 {MAX_PHOTOS}개까지 등록할 수 있습니다.")
|
||||
photo_id = uuid.uuid4().hex
|
||||
conn.execute("INSERT INTO asset_photos(id,asset_id,filename,image,mime,width,height,actor) VALUES(%s,%s,%s,%s,%s,%s,%s,%s)",
|
||||
(photo_id, asset_id, filename, image, mime, width, height, actor))
|
||||
conn.execute("UPDATE assets SET version=version+1,updated_at=now() WHERE id=%s", (asset_id,))
|
||||
self._event(conn, asset_id, actor, "photo", filename, {"photo_id": photo_id})
|
||||
return photo_id
|
||||
|
||||
def photo(self, asset_id, photo_id):
|
||||
with self._pool.connection() as conn:
|
||||
row = conn.execute("SELECT p.image,p.mime FROM asset_photos p JOIN assets a ON a.id=p.asset_id WHERE p.asset_id=%s AND p.id=%s AND a.deleted_at IS NULL", (asset_id, photo_id)).fetchone()
|
||||
if not row:
|
||||
raise KeyError(photo_id)
|
||||
return row
|
||||
|
||||
@staticmethod
|
||||
def _monitor_matches(conn, computer_id, parsed):
|
||||
result = []
|
||||
for device in monitor_devices(parsed):
|
||||
linked = conn.execute("SELECT a.* FROM asset_monitor_links l JOIN assets a ON a.id=l.monitor_asset_id WHERE l.computer_id=%s AND l.monitor_key=%s AND a.category='monitor' AND a.deleted_at IS NULL", (computer_id, device["key"])).fetchone()
|
||||
matches = conn.execute("SELECT * FROM assets WHERE category='monitor' AND deleted_at IS NULL AND lower(btrim(serial))=%s ORDER BY id LIMIT 21", (device["serial"].casefold(),)).fetchall() if device["serial"] else []
|
||||
compatible = [a for a in matches if compatible_monitor(a, device)]
|
||||
asset = linked or (compatible[0] if len(compatible) == 1 else None)
|
||||
candidates = matches if not asset else []
|
||||
# candidate_by — 후보가 같은 시리얼(같은 실물일 가능성)인지, 참고용 같은 모델·이름인지.
|
||||
# 같은 모델은 여러 대일 수 있으므로(듀얼 모니터 등) 새 등록을 막지 않는다(2026-10-07).
|
||||
candidate_by = "serial" if candidates else ""
|
||||
if not asset and not candidates:
|
||||
candidates = conn.execute("SELECT * FROM assets WHERE category='monitor' AND deleted_at IS NULL AND (lower(btrim(model))=%s OR lower(btrim(name))=%s) ORDER BY id LIMIT 20", (device["model"].casefold(), device["name"].casefold())).fetchall()
|
||||
candidate_by = "model" if candidates else ""
|
||||
result.append({**device, "asset": serialize(asset), "candidates": [serialize(r) for r in candidates],
|
||||
"candidate_by": candidate_by,
|
||||
"match": "linked" if linked else "serial" if asset else "unconfirmed"})
|
||||
return result
|
||||
|
||||
def report_monitors(self, asset_id, report_id):
|
||||
with self._pool.connection() as conn, conn.transaction():
|
||||
conn.execute("SET TRANSACTION ISOLATION LEVEL REPEATABLE READ READ ONLY")
|
||||
row = conn.execute("SELECT r.parsed FROM asset_reports r JOIN assets a ON a.id=r.asset_id WHERE r.asset_id=%s AND r.id=%s AND a.deleted_at IS NULL", (asset_id, report_id)).fetchone()
|
||||
if not row:
|
||||
raise KeyError(report_id)
|
||||
return self._monitor_matches(conn, asset_id, row["parsed"])
|
||||
|
||||
def register_monitor(self, computer_id, index, payload, actor):
|
||||
with self._pool.connection() as conn, conn.transaction():
|
||||
computer = self._lock(conn, computer_id, payload.version)
|
||||
if computer["category"] != "computer" or computer["latest_report_id"] != payload.report_id:
|
||||
raise AssetConflict("최신 컴퓨터 보고서를 다시 열고 모니터를 등록하세요.")
|
||||
row = conn.execute("SELECT parsed FROM asset_reports WHERE asset_id=%s AND id=%s", (computer_id, payload.report_id)).fetchone()
|
||||
devices = monitor_devices(row["parsed"]) if row else []
|
||||
if index < 0 or index >= len(devices):
|
||||
raise KeyError(index)
|
||||
device = devices[index]
|
||||
# 서로 다른 컴퓨터에서 동일 시리얼을 동시에 등록하는 경우도 중복을 막습니다.
|
||||
if device["serial"]:
|
||||
conn.execute("SELECT pg_advisory_xact_lock(hashtextextended(%s,0))", ("asset-monitor:" + device["serial"].casefold(),))
|
||||
if payload.asset_id:
|
||||
target = conn.execute("SELECT * FROM assets WHERE id=%s AND deleted_at IS NULL FOR UPDATE", (payload.asset_id,)).fetchone()
|
||||
if not target or target["category"] != "monitor":
|
||||
raise ValueError("등록된 모니터 자산을 선택하세요.")
|
||||
monitor_id = target["id"]
|
||||
else:
|
||||
match = self._monitor_matches(conn, computer_id, row["parsed"])[index]
|
||||
# 같은 시리얼(같은 실물)만 막는다 — 같은 모델이지만 시리얼이 다른 모니터는 새 자산으로 등록된다.
|
||||
if match["asset"] or match["candidate_by"] == "serial":
|
||||
raise AssetConflict(f"같은 시리얼({device['serial']})의 모니터가 이미 등록되어 있습니다. 기존 자산에 연결하세요."
|
||||
if device["serial"] else "이 모니터는 이미 자산에 연결되어 있습니다.")
|
||||
# 보고서의 실제 시리얼을 유지해야 이후 보고서에서도 같은 장비를 찾습니다.
|
||||
data = payload.asset.model_copy(update={"serial": device["serial"] or payload.asset.serial})
|
||||
monitor_id = self._create(conn, data, actor)
|
||||
conn.execute("INSERT INTO asset_monitor_links(computer_id,monitor_key,monitor_asset_id,actor) VALUES(%s,%s,%s,%s) ON CONFLICT(computer_id,monitor_key) DO UPDATE SET monitor_asset_id=EXCLUDED.monitor_asset_id,actor=EXCLUDED.actor,linked_at=now()",
|
||||
(computer_id, device["key"], monitor_id, actor))
|
||||
conn.execute("UPDATE assets SET version=version+1,updated_at=now() WHERE id=%s", (computer_id,))
|
||||
self._event(conn, computer_id, actor, "monitor", "모니터 자산 연결", {"monitor_asset_id": monitor_id, "model": device["model"]})
|
||||
return monitor_id
|
||||
@@ -0,0 +1,129 @@
|
||||
"""HWiNFO XML을 부품별로 읽습니다. 외부 파일이나 엔티티는 열지 않습니다."""
|
||||
from __future__ import annotations
|
||||
|
||||
import hashlib
|
||||
import re
|
||||
from datetime import datetime
|
||||
from xml.etree.ElementTree import ParseError
|
||||
|
||||
from defusedxml.ElementTree import fromstring
|
||||
from defusedxml.common import DefusedXmlException
|
||||
|
||||
MAX_REPORT_BYTES = 10 * 1024 * 1024
|
||||
SECTION_LABELS = {
|
||||
"SYSTEM": "시스템", "CPU": "프로세서", "MOBO": "메인보드 · BIOS",
|
||||
"MEMORY": "메모리", "VIDEO": "그래픽", "MONITOR": "모니터",
|
||||
"DRIVES": "저장장치", "NETWORK": "네트워크", "SOUND": "오디오",
|
||||
"PORTS": "포트 · USB", "BUS": "버스 · 컨트롤러",
|
||||
}
|
||||
|
||||
|
||||
def _text(node, tag):
|
||||
return (node.findtext(tag) or "").strip()
|
||||
|
||||
|
||||
def _props(node):
|
||||
return [{"label": _text(p, "Entry"), "value": _text(p, "Description"),
|
||||
"type": _text(p, "PropertyType")} for p in node.findall("Property")]
|
||||
|
||||
|
||||
def _pick(nodes, *, types=(), labels=()):
|
||||
# 언어와 무관한 PropertyType을 먼저 사용하고, 없을 때 한글/영문 항목명을 찾습니다.
|
||||
properties = [p for n in nodes for p in n["properties"]]
|
||||
for kind in types:
|
||||
for p in properties:
|
||||
if p["type"] == kind and p["value"]:
|
||||
return p["value"]
|
||||
for label in labels:
|
||||
for p in properties:
|
||||
if p["label"].casefold() == label.casefold() and p["value"]:
|
||||
return p["value"]
|
||||
return ""
|
||||
|
||||
|
||||
def parse_hwinfo(raw: bytes) -> dict:
|
||||
if not raw or len(raw) > MAX_REPORT_BYTES:
|
||||
raise ValueError("XML 보고서는 비어 있지 않은 10 MB 이하 파일이어야 합니다.")
|
||||
try:
|
||||
# HWiNFO의 DTD 선언은 허용하되 파일을 읽지 않습니다. 엔티티는 모두 차단합니다.
|
||||
root = fromstring(raw, forbid_dtd=False, forbid_entities=True, forbid_external=True)
|
||||
except (ParseError, DefusedXmlException, ValueError, LookupError) as exc:
|
||||
raise ValueError("XML을 읽을 수 없습니다. HWiNFO XML 보고서인지 확인하세요.") from exc
|
||||
if root.tag != "HWINFO" or len(root.findall("COMPUTER")) != 1:
|
||||
raise ValueError("컴퓨터 한 대의 HWiNFO XML 보고서만 업로드할 수 있습니다.")
|
||||
computer = root.find("COMPUTER")
|
||||
sections = [{"key": "SYSTEM", "label": "시스템", "nodes": []}]
|
||||
count = 0
|
||||
|
||||
def walk(node, path, result, depth=0):
|
||||
nonlocal count
|
||||
count += 1
|
||||
if count > 30000 or depth > 64:
|
||||
raise ValueError("보고서 구조가 너무 크거나 깊습니다.")
|
||||
name = _text(node, "NodeName")
|
||||
trail = path + ([name] if name else [])
|
||||
props = _props(node)
|
||||
if props:
|
||||
result.append({"name": name or node.tag, "path": " › ".join(trail), "properties": props})
|
||||
for child in node:
|
||||
if child.tag in {"SubNodes", "SubNode"}:
|
||||
walk(child, trail, result, depth + 1)
|
||||
elif child.find("NodeName") is not None:
|
||||
walk(child, trail, result, depth + 1)
|
||||
|
||||
sections[0]["nodes"] = [{"name": _text(computer, "NodeName") or "컴퓨터",
|
||||
"path": "시스템", "properties": _props(computer)}]
|
||||
subnodes = computer.find("SubNodes")
|
||||
if subnodes is not None:
|
||||
for node in subnodes:
|
||||
group = {"key": node.tag, "label": SECTION_LABELS.get(node.tag, _text(node, "NodeName") or node.tag), "nodes": []}
|
||||
walk(node, [], group["nodes"])
|
||||
sections.append(group)
|
||||
by_key = {s["key"]: s["nodes"] for s in sections}
|
||||
get = lambda key, **kw: _pick(by_key.get(key, []), **kw)
|
||||
summary = {
|
||||
"computer_name": _text(computer, "NodeName") or get("SYSTEM", labels=("컴퓨터 이름", "Computer Name")),
|
||||
"os": get("SYSTEM", labels=("운영 체제", "Operating System")),
|
||||
"manufacturer": get("SYSTEM", labels=("컴퓨터 브랜드", "Computer Brand Name")),
|
||||
"cpu": get("CPU", types=("CPU_NAME",), labels=("프로세서 이름", "Processor Name")),
|
||||
"cores": get("CPU", labels=("프로세서 코어 수", "CPU 코어 수", "Number of CPU Cores", "Number of Processor Cores")),
|
||||
"threads": get("CPU", labels=("논리 프로세서 수", "논리 CPU 수", "Number of Logical CPUs", "Number of Logical Processors")),
|
||||
"motherboard": get("MOBO", types=("SYSTEM_MAINBOARD",)),
|
||||
"bios": get("MOBO", labels=("BIOS 버전", "BIOS Version")),
|
||||
"memory": get("MEMORY", labels=("총 메모리 크기", "Total Memory Size")),
|
||||
"gpu": get("VIDEO", types=("GFXCARD_CHIPSET", "GFXCARD")),
|
||||
"gpu_memory": get("VIDEO", labels=("그래픽 메모리", "Video Memory", "Video Memory Size")),
|
||||
"serial": get("MOBO", labels=("제품 일련 번호", "Product Serial Number", "System Serial Number")),
|
||||
}
|
||||
if summary["serial"].casefold() in {"system serial number", "to be filled by o.e.m.", "default string", "none", "n/a"}:
|
||||
summary["serial"] = ""
|
||||
if not summary["memory"]:
|
||||
mb = get("MEMORY", types=("SYSTEM_MEMORY",))
|
||||
if re.fullmatch(r"\d+(\.\d+)?", mb):
|
||||
summary["memory"] = f"{float(mb) / 1024:g} GiB"
|
||||
devices = {}
|
||||
for key, types, labels in [
|
||||
("DRIVES", ("HDD",), ("드라이브 모델", "Drive Model")),
|
||||
("MEMORY", (), ("모듈 부품 번호", "Module Part Number")),
|
||||
("MONITOR", ("MONITOR",), ("모니터 이름", "Monitor Name")),
|
||||
("NETWORK", ("NETCARD",), ("네트워크 카드", "Network Card")),
|
||||
("VIDEO", ("GFXCARD_CHIPSET", "GFXCARD"), ("그래픽 프로세서", "Video Chipset")),
|
||||
]:
|
||||
devices[key] = []
|
||||
for node in by_key.get(key, []):
|
||||
model = _pick([node], types=types, labels=labels)
|
||||
if model:
|
||||
devices[key].append({"name": model, "node": node["name"], "properties": node["properties"]})
|
||||
summary["drive_count"] = len(devices["DRIVES"])
|
||||
summary["monitor_count"] = len(devices["MONITOR"])
|
||||
if not summary["computer_name"] or not any(summary[k] for k in ("cpu", "motherboard", "memory", "gpu")):
|
||||
raise ValueError("컴퓨터 이름과 하드웨어 사양이 포함된 HWiNFO 보고서가 필요합니다.")
|
||||
scan_time = _text(computer, "ScanTime")
|
||||
try:
|
||||
scan_time = datetime.strptime(scan_time, "%d.%m.%Y %H:%M").isoformat(timespec="minutes")
|
||||
except ValueError:
|
||||
pass # 날짜 형식이 다르면 원래 보고서에 적힌 시각을 그대로 보존합니다.
|
||||
warnings = [p["value"] for p in _props(computer) if p["label"] in ("가상 머신 경고", "Virtual Machine Warning") and p["value"]]
|
||||
return {"summary": summary, "sections": sections, "devices": devices, "scan_time": scan_time,
|
||||
"warnings": warnings, "sha256": hashlib.sha256(raw).hexdigest(),
|
||||
"property_count": sum(len(n["properties"]) for s in sections for n in s["nodes"])}
|
||||
@@ -0,0 +1,38 @@
|
||||
"""사진을 실제 이미지로 확인하고 위치 정보 등 메타데이터를 제거합니다."""
|
||||
import io
|
||||
import warnings
|
||||
|
||||
from PIL import Image, ImageOps, UnidentifiedImageError
|
||||
|
||||
MAX_PHOTO_BYTES = 8 * 1024 * 1024
|
||||
MAX_STORED_BYTES = 5 * 1024 * 1024
|
||||
MAX_PHOTOS = 10
|
||||
|
||||
|
||||
def prepare_photo(raw):
|
||||
if not raw or len(raw) > MAX_PHOTO_BYTES:
|
||||
raise ValueError("사진은 비어 있지 않은 8 MB 이하 파일이어야 합니다.")
|
||||
try:
|
||||
with warnings.catch_warnings():
|
||||
warnings.simplefilter("error", Image.DecompressionBombWarning)
|
||||
with Image.open(io.BytesIO(raw)) as source:
|
||||
if source.format not in {"JPEG", "PNG", "WEBP"}:
|
||||
raise ValueError("JPG, PNG, WebP 사진만 등록할 수 있습니다.")
|
||||
if source.width * source.height > 20_000_000:
|
||||
raise ValueError("사진은 2천만 화소 이하로 등록하세요.")
|
||||
source.load()
|
||||
image = ImageOps.exif_transpose(source)
|
||||
image.thumbnail((2400, 2400))
|
||||
transparent = "A" in image.getbands() or "transparency" in image.info
|
||||
mode = "RGBA" if transparent else "RGB"
|
||||
# 새 캔버스에 복사해 EXIF, GPS, 촬영기기 정보를 저장하지 않습니다.
|
||||
clean = Image.new(mode, image.size)
|
||||
clean.paste(image.convert(mode))
|
||||
output = io.BytesIO()
|
||||
clean.save(output, format="PNG" if transparent else "JPEG", **({} if transparent else {"quality": 88}))
|
||||
data = output.getvalue()
|
||||
if len(data) > MAX_STORED_BYTES:
|
||||
raise ValueError("사진을 압축해 다시 등록하세요. 저장 크기는 5 MB 이하입니다.")
|
||||
return data, "image/png" if transparent else "image/jpeg", clean.width, clean.height
|
||||
except (UnidentifiedImageError, OSError, SyntaxError, Image.DecompressionBombError, Image.DecompressionBombWarning) as exc:
|
||||
raise ValueError("사진을 읽을 수 없습니다. 정상적인 JPG, PNG, WebP 파일을 선택하세요.") from exc
|
||||
@@ -0,0 +1,47 @@
|
||||
"""이전 보고서에도 적용할 수 있도록 저장된 모니터 항목에서 식별 정보를 읽습니다."""
|
||||
import hashlib
|
||||
import re
|
||||
|
||||
|
||||
def usable_serial(value):
|
||||
value = value.strip()
|
||||
if value.casefold() in {"", "unknown", "n/a", "none", "not specified", "serial number", "알 수 없음"}:
|
||||
return ""
|
||||
if re.fullmatch(r"[0\s-]+", value):
|
||||
return ""
|
||||
return value
|
||||
|
||||
|
||||
def compatible_monitor(asset, device):
|
||||
"""다른 제조사나 다른 모델이 같은 시리얼을 쓰면 자동 연결하지 않습니다."""
|
||||
def normalized(value):
|
||||
return "".join(c for c in value.casefold() if c.isalnum())
|
||||
brand = normalized(asset.get("manufacturer", ""))
|
||||
reported_brand = normalized(device["manufacturer"])
|
||||
if brand and reported_brand and brand != reported_brand:
|
||||
return False
|
||||
model = normalized(asset.get("model", ""))
|
||||
if not model:
|
||||
return True
|
||||
return any(model == value or len(model) >= 4 and model in value
|
||||
for value in (normalized(device["model"]), normalized(device["name"])))
|
||||
|
||||
|
||||
def monitor_devices(parsed):
|
||||
devices = []
|
||||
for index, item in enumerate(parsed.get("devices", {}).get("MONITOR", [])):
|
||||
props = item.get("properties", [])
|
||||
def pick(*labels, kind=""):
|
||||
return next((p["value"].strip() for p in props if p.get("label", "").casefold() in
|
||||
{label.casefold() for label in labels} or kind and p.get("type") == kind), "")
|
||||
name = item.get("name", "모니터")
|
||||
model = pick("모니터 이름(제조업체)", "Monitor Name (Manuf)", "Monitor Name (Manufacturer)") or name
|
||||
serial = usable_serial(pick("일련 번호", "Serial Number", "Monitor Serial Number"))
|
||||
instance = pick("디바이스 인스턴스 ID", "Device Instance ID", kind="DeviceInstanceId")
|
||||
# 시리얼이 없는 장치는 모델명만으로 동일 자산이라고 판단하지 않습니다.
|
||||
identity = ("serial:" + serial.casefold() + ":" + model.casefold()) if serial else (
|
||||
"instance:" + instance.casefold() if instance else f"report:{parsed.get('sha256', '')}:{index}")
|
||||
devices.append({"index": index, "key": hashlib.sha256(identity.encode()).hexdigest(),
|
||||
"name": name, "model": model[:200], "serial": serial[:200],
|
||||
"manufacturer": name.split(" ", 1)[0][:150], "properties": props})
|
||||
return devices
|
||||
@@ -0,0 +1,304 @@
|
||||
from __future__ import annotations
|
||||
|
||||
# 화면, 권한 검사, 파일 업로드를 담당합니다. 실제 저장은 db.py에서 처리합니다.
|
||||
|
||||
import io
|
||||
import secrets
|
||||
from contextlib import contextmanager
|
||||
from typing import Annotated
|
||||
from urllib.parse import quote
|
||||
|
||||
from fastapi import APIRouter, Depends, File, Form, HTTPException, Query, Request, UploadFile
|
||||
from fastapi.responses import RedirectResponse, Response
|
||||
from openpyxl import Workbook
|
||||
from pydantic import ValidationError
|
||||
from psycopg import Error as DBError
|
||||
from psycopg.errors import UniqueViolation
|
||||
from psycopg_pool import PoolTimeout
|
||||
from starlette.concurrency import run_in_threadpool
|
||||
|
||||
from .hwinfo import MAX_REPORT_BYTES, parse_hwinfo
|
||||
from .store import ActionInput, AssetConflict, AssetInput, AssetUpdate, CATEGORIES, STATUSES
|
||||
from .store import DeleteInput, MonitorInput
|
||||
from .media import MAX_PHOTO_BYTES, prepare_photo
|
||||
|
||||
router = APIRouter(prefix="/asset", tags=["asset"])
|
||||
|
||||
|
||||
def _user(request: Request):
|
||||
from app.main import get_current_user_record
|
||||
from app.store import has_module
|
||||
user = get_current_user_record(request)
|
||||
if not user:
|
||||
raise HTTPException(401, "로그인이 필요합니다.")
|
||||
if not has_module(user, "asset"):
|
||||
raise HTTPException(403, "자산관리 권한이 없습니다.")
|
||||
return user
|
||||
|
||||
|
||||
def _write(request: Request, user=Depends(_user)):
|
||||
expected = request.session.get("asset_csrf", "")
|
||||
token = request.headers.get("x-asset-csrf", "")
|
||||
if not expected or not secrets.compare_digest(expected, token):
|
||||
raise HTTPException(403, "화면을 새로 열고 다시 시도하세요.")
|
||||
return user
|
||||
|
||||
|
||||
def _super(user):
|
||||
from app.store import SUPER_ADMIN_EMAIL
|
||||
return user.get("email", "").lower() == SUPER_ADMIN_EMAIL
|
||||
|
||||
|
||||
def _super_write(user=Depends(_write)):
|
||||
if not _super(user):
|
||||
raise HTTPException(403, "수퍼 관리자만 자산을 삭제할 수 있습니다.")
|
||||
return user
|
||||
|
||||
|
||||
def _store(request):
|
||||
store = getattr(request.app.state, "asset_store", None)
|
||||
if store is None:
|
||||
raise HTTPException(503, "자산관리 DB 설정이 필요합니다. 관리자에게 문의하세요.")
|
||||
return store
|
||||
|
||||
|
||||
@contextmanager
|
||||
def _errors():
|
||||
try:
|
||||
yield
|
||||
except AssetConflict as exc:
|
||||
raise HTTPException(409, str(exc)) from exc
|
||||
except KeyError as exc:
|
||||
raise HTTPException(404, "자산 또는 보고서를 찾을 수 없습니다.") from exc
|
||||
except ValueError as exc:
|
||||
raise HTTPException(422, str(exc)) from exc
|
||||
except UniqueViolation as exc:
|
||||
raise HTTPException(409, "이미 등록된 자산번호입니다. 다른 번호를 사용하세요.") from exc
|
||||
except (DBError, PoolTimeout) as exc:
|
||||
# DB 오류에 접속 비밀번호가 섞일 수 있어 원문 대신 일반 안내만 보여줍니다.
|
||||
raise HTTPException(503, "자산관리 DB에 연결할 수 없습니다. 설정과 초기화를 확인하세요.") from exc
|
||||
|
||||
|
||||
@router.get("/")
|
||||
def index(request: Request):
|
||||
from app.main import build_erp_nav, get_current_user_record, render_template
|
||||
from app.store import has_module, is_admin
|
||||
user = get_current_user_record(request)
|
||||
if not user:
|
||||
return RedirectResponse("/login", 303)
|
||||
if not has_module(user, "asset"):
|
||||
return render_template(request, "denied.html", {"reason": "자산관리 권한이 없습니다.", "user": user,
|
||||
"is_admin": is_admin(user)}, status_code=403)
|
||||
request.session.setdefault("asset_csrf", secrets.token_urlsafe(32))
|
||||
return render_template(request, "asset/index.html", {
|
||||
"user": user, "is_admin": is_admin(user), "nav_items": build_erp_nav(user, active="asset"),
|
||||
"page_title": "자산관리", "page_subtitle": "사무집기부터 컴퓨터 사양까지, 회사 자산을 한곳에서",
|
||||
"categories": CATEGORIES, "statuses": STATUSES, "csrf_token": request.session["asset_csrf"],
|
||||
"configured": getattr(request.app.state, "asset_store", None) is not None,
|
||||
"can_delete": _super(user),
|
||||
})
|
||||
|
||||
|
||||
@router.get("/health")
|
||||
def health(request: Request, user=Depends(_user)):
|
||||
with _errors():
|
||||
_store(request).health()
|
||||
return {"ok": True}
|
||||
|
||||
|
||||
@router.get("/api/bootstrap")
|
||||
def bootstrap(request: Request, user=Depends(_user)):
|
||||
from app.main import user_store
|
||||
with _errors():
|
||||
data = _store(request).dashboard()
|
||||
data["users"] = [{"email": u["email"], "name": u.get("name") or u["email"]} for u in user_store.list_all()]
|
||||
return data
|
||||
|
||||
|
||||
def _query(q="", category="", status="", location="", assignee="", warranty=False, group=""):
|
||||
if category and category not in CATEGORIES or status and status not in STATUSES:
|
||||
raise HTTPException(422, "분류 또는 상태 필터가 올바르지 않습니다.")
|
||||
if group not in {"", "computer", "furniture"}:
|
||||
raise HTTPException(422, "자산 구분 필터가 올바르지 않습니다.")
|
||||
return dict(q=q, category=category, status=status, location=location, assignee=assignee, warranty=warranty, group=group)
|
||||
|
||||
|
||||
@router.get("/api/assets")
|
||||
def assets(request: Request, q: str = Query("", max_length=200), category: str = "", status: str = "",
|
||||
location: str = Query("", max_length=150), assignee: str = Query("", max_length=254), warranty: bool = False,
|
||||
page: int = Query(1, ge=1, le=100000), page_size: int = Query(25, ge=1, le=100),
|
||||
sort: str = "updated", group: str = "", user=Depends(_user)):
|
||||
with _errors():
|
||||
return _store(request).list_assets(page=page, page_size=page_size, sort=sort,
|
||||
**_query(q, category, status, location, assignee, warranty, group))
|
||||
|
||||
|
||||
@router.get("/api/export")
|
||||
def export(request: Request, q: str = Query("", max_length=200), category: str = "", status: str = "",
|
||||
location: str = Query("", max_length=150), assignee: str = Query("", max_length=254), warranty: bool = False,
|
||||
group: str = "", user=Depends(_user)):
|
||||
from app.timezone import today_kst
|
||||
with _errors():
|
||||
data = _store(request).list_assets(page=1, page_size=10001, **_query(q, category, status, location, assignee, warranty, group))
|
||||
if data["total"] > 10000:
|
||||
raise HTTPException(422, "한 번에 10,000개까지 내보낼 수 있습니다. 필터를 좁혀주세요.")
|
||||
book = Workbook()
|
||||
sheet = book.active
|
||||
sheet.title = "자산대장"
|
||||
headers = ["자산번호", "자산명", "분류", "상태", "제조사", "모델", "시리얼", "위치", "부서", "사용자", "구매일", "구매금액(원)", "구매처", "보증종료", "메모", "CPU", "메모리", "GPU", "운영체제"]
|
||||
sheet.append(headers)
|
||||
for row in data["items"]:
|
||||
specs = row.get("specs") or {}
|
||||
values = [row["tag"], row["name"], CATEGORIES[row["category"]], STATUSES[row["status"]],
|
||||
*[row[k] for k in ("manufacturer", "model", "serial", "location", "department", "assignee_email", "purchased_on")],
|
||||
float(row["purchase_cost"]) if row["purchase_cost"] is not None else None,
|
||||
row["vendor"], row["warranty_until"], row["notes"], *[specs.get(k, "") for k in ("cpu", "memory", "gpu", "os")]]
|
||||
sheet.append(values)
|
||||
# =로 시작하는 자산명도 엑셀 수식 대신 일반 글자로 저장합니다.
|
||||
for cell in sheet[sheet.max_row]:
|
||||
if isinstance(cell.value, str):
|
||||
cell.data_type = "s"
|
||||
sheet.freeze_panes = "C2"
|
||||
sheet.auto_filter.ref = sheet.dimensions
|
||||
from openpyxl.styles import Font, PatternFill
|
||||
from openpyxl.utils import get_column_letter
|
||||
for cell in sheet[1]:
|
||||
cell.font = Font(bold=True, color="FFFFFF")
|
||||
cell.fill = PatternFill("solid", fgColor="171717")
|
||||
for i in range(1, len(headers) + 1):
|
||||
sheet.column_dimensions[get_column_letter(i)].width = 22 if i > 2 else 28
|
||||
buffer = io.BytesIO()
|
||||
book.save(buffer)
|
||||
return Response(buffer.getvalue(), media_type="application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
|
||||
headers={"Content-Disposition": f'attachment; filename="assets-{today_kst().isoformat()}.xlsx"'})
|
||||
|
||||
|
||||
@router.post("/api/assets")
|
||||
def create(request: Request, payload: AssetInput, user=Depends(_write)):
|
||||
with _errors():
|
||||
asset_id = _store(request).create(payload, user["email"])
|
||||
return {"id": asset_id}
|
||||
|
||||
|
||||
@router.get("/api/assets/{asset_id}")
|
||||
def detail(request: Request, asset_id: str, user=Depends(_user)):
|
||||
with _errors():
|
||||
return _store(request).detail(asset_id)
|
||||
|
||||
|
||||
@router.put("/api/assets/{asset_id}")
|
||||
def update(request: Request, asset_id: str, payload: AssetUpdate, user=Depends(_write)):
|
||||
with _errors():
|
||||
_store(request).update(asset_id, payload, user["email"])
|
||||
return {"ok": True}
|
||||
|
||||
|
||||
@router.delete("/api/assets/{asset_id}")
|
||||
def delete(request: Request, asset_id: str, payload: DeleteInput, user=Depends(_super_write)):
|
||||
with _errors():
|
||||
_store(request).delete(asset_id, payload.version, user["email"], payload.note)
|
||||
return {"ok": True}
|
||||
|
||||
|
||||
@router.post("/api/assets/{asset_id}/photos")
|
||||
async def add_photo(request: Request, asset_id: str, file: Annotated[UploadFile, File()],
|
||||
version: Annotated[int, Form(ge=1)], user=Depends(_write)):
|
||||
filename = (file.filename or "photo.jpg").replace("\\", "/").rsplit("/", 1)[-1]
|
||||
try:
|
||||
if len(filename) > 200 or any(ord(c) < 32 for c in filename):
|
||||
raise HTTPException(422, "사진 파일 이름을 확인하세요.")
|
||||
raw = await file.read(MAX_PHOTO_BYTES + 1)
|
||||
finally:
|
||||
await file.close()
|
||||
with _errors():
|
||||
image, mime, width, height = await run_in_threadpool(prepare_photo, raw)
|
||||
photo_id = await run_in_threadpool(_store(request).add_photo, asset_id, version, user["email"], filename, image, mime, width, height)
|
||||
return {"id": photo_id}
|
||||
|
||||
|
||||
@router.get("/api/assets/{asset_id}/photos/{photo_id}")
|
||||
def photo(request: Request, asset_id: str, photo_id: str, user=Depends(_user)):
|
||||
with _errors():
|
||||
row = _store(request).photo(asset_id, photo_id)
|
||||
return Response(bytes(row["image"]), media_type=row["mime"],
|
||||
headers={"X-Content-Type-Options": "nosniff", "Cache-Control": "no-store"})
|
||||
|
||||
|
||||
@router.get("/api/assets/{asset_id}/reports/{report_id}/monitors")
|
||||
def report_monitors(request: Request, asset_id: str, report_id: str, user=Depends(_user)):
|
||||
with _errors():
|
||||
return {"items": _store(request).report_monitors(asset_id, report_id)}
|
||||
|
||||
|
||||
@router.post("/api/assets/{asset_id}/monitors/{index}")
|
||||
def register_monitor(request: Request, asset_id: str, index: int, payload: MonitorInput, user=Depends(_write)):
|
||||
with _errors():
|
||||
monitor_id = _store(request).register_monitor(asset_id, index, payload, user["email"])
|
||||
return {"id": monitor_id}
|
||||
|
||||
|
||||
@router.post("/api/assets/{asset_id}/actions")
|
||||
def action(request: Request, asset_id: str, payload: ActionInput, user=Depends(_write)):
|
||||
from app.main import user_store
|
||||
if payload.action == "checkout" and not user_store.get(payload.assignee_email.lower()):
|
||||
raise HTTPException(422, "등록된 회사 사용자를 선택하세요.")
|
||||
with _errors():
|
||||
_store(request).action(asset_id, payload, user["email"])
|
||||
return {"ok": True}
|
||||
|
||||
|
||||
async def _report_file(file):
|
||||
filename = (file.filename or "report.xml").replace("\\", "/").rsplit("/", 1)[-1]
|
||||
if not filename.lower().endswith(".xml") or len(filename) > 200 or any(ord(c) < 32 for c in filename):
|
||||
raise HTTPException(422, "이름이 200자 이하인 XML 보고서를 선택하세요.")
|
||||
try:
|
||||
raw = await file.read(MAX_REPORT_BYTES + 1)
|
||||
finally:
|
||||
await file.close()
|
||||
with _errors():
|
||||
parsed = await run_in_threadpool(parse_hwinfo, raw)
|
||||
return filename, raw, parsed
|
||||
|
||||
|
||||
@router.post("/api/reports/preview")
|
||||
async def preview(file: Annotated[UploadFile, File()], user=Depends(_write)):
|
||||
filename, raw, parsed = await _report_file(file)
|
||||
return {"filename": filename, "summary": parsed["summary"], "scan_time": parsed["scan_time"],
|
||||
"property_count": parsed["property_count"], "warnings": parsed["warnings"]}
|
||||
|
||||
|
||||
@router.post("/api/reports/import")
|
||||
async def import_report(request: Request, file: Annotated[UploadFile, File()], payload: Annotated[str, Form(max_length=20000)], user=Depends(_write)):
|
||||
with _errors():
|
||||
try:
|
||||
data = AssetInput.model_validate_json(payload)
|
||||
except ValidationError as exc:
|
||||
raise HTTPException(422, "자산명·분류·구매일·금액을 확인하세요.") from exc
|
||||
report = await _report_file(file)
|
||||
with _errors():
|
||||
asset_id = await run_in_threadpool(_store(request).create, data, user["email"], report)
|
||||
return {"id": asset_id}
|
||||
|
||||
|
||||
@router.post("/api/assets/{asset_id}/reports")
|
||||
async def attach(request: Request, asset_id: str, file: Annotated[UploadFile, File()],
|
||||
version: Annotated[int, Form(ge=1)], user=Depends(_write)):
|
||||
filename, raw, parsed = await _report_file(file)
|
||||
with _errors():
|
||||
report_id = await run_in_threadpool(_store(request).attach_report, asset_id, version, user["email"], filename, raw, parsed)
|
||||
return {"id": report_id}
|
||||
|
||||
|
||||
@router.get("/api/assets/{asset_id}/reports/{report_id}")
|
||||
def report_detail(request: Request, asset_id: str, report_id: str, user=Depends(_user)):
|
||||
with _errors():
|
||||
return _store(request).report(asset_id, report_id)
|
||||
|
||||
|
||||
@router.get("/api/assets/{asset_id}/reports/{report_id}/download")
|
||||
def download(request: Request, asset_id: str, report_id: str, user=Depends(_user)):
|
||||
with _errors():
|
||||
row = _store(request).report(asset_id, report_id, raw=True)
|
||||
return Response(bytes(row["raw_xml"]), media_type="application/octet-stream",
|
||||
headers={"Content-Disposition": f"attachment; filename=hwinfo.xml; filename*=UTF-8''{quote(row['filename'], safe='')}",
|
||||
"X-Content-Type-Options": "nosniff", "Cache-Control": "no-store"})
|
||||
@@ -0,0 +1,106 @@
|
||||
"""Asset validation and lifecycle rules, shared by API and storage."""
|
||||
from datetime import date
|
||||
from decimal import Decimal
|
||||
|
||||
from pydantic import BaseModel, ConfigDict, Field, field_validator, model_validator
|
||||
|
||||
CATEGORIES = {"computer": "컴퓨터", "monitor": "모니터", "mouse": "마우스", "keyboard": "키보드",
|
||||
"camera": "카메라", "hub": "허브 · 네트워크", "lighting": "조명", "desk": "책상",
|
||||
"chair": "의자", "furniture": "기타 사무집기", "equipment": "기타 전산장비"}
|
||||
STATUSES = {"available": "사용 가능", "in_use": "사용 중", "maintenance": "수리 중", "lost": "분실", "retired": "폐기"}
|
||||
|
||||
|
||||
class AssetInput(BaseModel):
|
||||
model_config = ConfigDict(extra="forbid", str_strip_whitespace=True)
|
||||
tag: str = Field(default="", max_length=64)
|
||||
name: str = Field(min_length=1, max_length=200)
|
||||
category: str
|
||||
manufacturer: str = Field(default="", max_length=150)
|
||||
model: str = Field(default="", max_length=200)
|
||||
serial: str = Field(default="", max_length=200)
|
||||
location: str = Field(default="", max_length=150)
|
||||
department: str = Field(default="", max_length=100)
|
||||
purchased_on: date | None = None
|
||||
purchase_cost: Decimal | None = Field(default=None, ge=0, le=10**12, decimal_places=2)
|
||||
vendor: str = Field(default="", max_length=200)
|
||||
warranty_until: date | None = None
|
||||
notes: str = Field(default="", max_length=10000)
|
||||
|
||||
@field_validator("category")
|
||||
@classmethod
|
||||
def valid_category(cls, value):
|
||||
if value not in CATEGORIES:
|
||||
raise ValueError("자산 분류가 올바르지 않습니다.")
|
||||
return value
|
||||
|
||||
@model_validator(mode="after")
|
||||
def valid_dates(self):
|
||||
if self.purchased_on and self.warranty_until and self.warranty_until < self.purchased_on:
|
||||
raise ValueError("보증 종료일은 구매일 이후여야 합니다.")
|
||||
return self
|
||||
|
||||
|
||||
class AssetUpdate(AssetInput):
|
||||
version: int = Field(ge=1)
|
||||
|
||||
|
||||
class DeleteInput(BaseModel):
|
||||
model_config = ConfigDict(extra="forbid", str_strip_whitespace=True)
|
||||
version: int = Field(ge=1)
|
||||
note: str = Field(min_length=1, max_length=2000)
|
||||
|
||||
|
||||
class MonitorInput(BaseModel):
|
||||
model_config = ConfigDict(extra="forbid", str_strip_whitespace=True)
|
||||
version: int = Field(ge=1)
|
||||
report_id: str = Field(min_length=1, max_length=64)
|
||||
asset: AssetInput | None = None
|
||||
asset_id: str = Field(default="", max_length=64)
|
||||
|
||||
@model_validator(mode="after")
|
||||
def require_target(self):
|
||||
if bool(self.asset) == bool(self.asset_id):
|
||||
raise ValueError("등록할 정보 또는 연결할 모니터 자산 중 하나를 지정하세요.")
|
||||
if self.asset and self.asset.category != "monitor":
|
||||
raise ValueError("모니터 분류로 등록하세요.")
|
||||
return self
|
||||
|
||||
|
||||
class ActionInput(BaseModel):
|
||||
model_config = ConfigDict(extra="forbid", str_strip_whitespace=True)
|
||||
version: int = Field(ge=1)
|
||||
action: str
|
||||
assignee_email: str = Field(default="", max_length=254)
|
||||
location: str = Field(default="", max_length=150)
|
||||
note: str = Field(default="", max_length=2000)
|
||||
|
||||
@model_validator(mode="after")
|
||||
def require_reason(self):
|
||||
if self.action in {"lost", "retired"} and not self.note:
|
||||
raise ValueError("분실·폐기 사유를 입력하세요.")
|
||||
return self
|
||||
|
||||
|
||||
class AssetConflict(ValueError):
|
||||
pass
|
||||
|
||||
|
||||
def transition(asset, payload: ActionInput):
|
||||
state = asset["status"]
|
||||
if payload.action == "checkout":
|
||||
if state != "available" or not payload.assignee_email:
|
||||
raise ValueError("사용 가능한 자산을 선택하고 배정할 사용자를 지정하세요.")
|
||||
return "in_use", payload.assignee_email.lower()
|
||||
if payload.action == "checkin":
|
||||
if state != "in_use":
|
||||
raise ValueError("사용 중인 자산만 반납할 수 있습니다.")
|
||||
return "available", ""
|
||||
if payload.action == "maintenance" and state == "available":
|
||||
return "maintenance", ""
|
||||
if payload.action == "available" and state in {"maintenance", "lost", "retired"}:
|
||||
return "available", ""
|
||||
if payload.action == "lost" and state in {"available", "in_use", "maintenance"}:
|
||||
return "lost", asset.get("assignee_email", "")
|
||||
if payload.action == "retired" and state in {"available", "maintenance", "lost"}:
|
||||
return "retired", ""
|
||||
raise ValueError("현재 상태에서 처리할 수 없습니다. 배정된 자산은 먼저 반납하세요.")
|
||||
@@ -0,0 +1,70 @@
|
||||
{% extends "erp_base.html" %}
|
||||
{% set force_sidebar_collapsed = true %}
|
||||
{% block head_extra %}<link rel="stylesheet" href="/static/asset.css?v=20261006c">{% endblock %}
|
||||
{% block content %}
|
||||
<div id="asset-app" class="am-workspace" data-csrf="{{ csrf_token }}" data-configured="{{ 'true' if configured else 'false' }}" data-can-delete="{{ 'true' if can_delete else 'false' }}">
|
||||
<aside class="am-nav" aria-label="자산관리 탐색">
|
||||
<div class="am-nav-brand"><span class="am-mark">A</span><div><strong>회사 자산</strong><small>ASSET MANAGEMENT</small></div></div>
|
||||
<button class="am-nav-link is-active" data-view="all"><span>전체 자산</span><span id="am-nav-total" class="am-count">—</span></button>
|
||||
<button class="am-nav-link" data-view="computer"><span>컴퓨터 · 전산장비</span></button>
|
||||
<button class="am-nav-link" data-view="furniture"><span>사무실 · 집기</span></button>
|
||||
<p class="am-nav-label">자산 상태</p>
|
||||
{% for key,label in statuses.items() %}<button class="am-nav-link" data-state="{{ key }}"><span><i class="am-dot am-dot-{{ key }}"></i>{{ label }}</span><span class="am-count" id="am-count-{{ key }}">—</span></button>{% endfor %}
|
||||
<p class="am-nav-label">확인할 항목</p>
|
||||
<button class="am-nav-link" data-view="warranty"><span>보증 만료 예정</span><span class="am-count" id="am-count-warranty">—</span></button>
|
||||
<div class="am-nav-foot"><strong>자산 한 개, 기록 하나</strong><p>개별 자산번호로 등록하고<br>배정부터 폐기까지 추적하세요.</p><button class="am-text-btn" id="am-help-open">사용 안내 ↗</button></div>
|
||||
</aside>
|
||||
<section class="am-main" aria-label="자산대장">
|
||||
<div class="am-heading"><div><p class="am-eyebrow">COMPANY INVENTORY</p><h2>회사 자산 대장</h2><p>어떤 자산이, 어디에, 누구에게 있는지 확인하세요.</p></div><div class="am-heading-actions"><button class="erp-btn erp-btn-outline" id="am-import">↑ HWiNFO 보고서</button><button class="erp-btn erp-btn-primary" id="am-create" {% if not configured %}disabled{% endif %}>+ 자산 등록</button></div></div>
|
||||
{% if not configured %}<div class="am-notice" role="status"><strong>자산관리 저장소 설정이 필요합니다.</strong><p>관리자가 자산관리 DB를 연결하면 등록·배정·반납을 사용할 수 있습니다. HWiNFO 보고서는 지금도 분석 결과를 미리 볼 수 있습니다.</p></div>{% endif %}
|
||||
<div id="am-message" class="am-message" role="status" aria-live="polite" hidden></div>
|
||||
<div class="am-kpis" aria-label="자산 현황">
|
||||
<button data-kpi="all" class="am-kpi"><span>전체 자산</span><strong id="am-total">—</strong><small>회사에 등록된 자산</small></button>
|
||||
<button data-kpi="in_use" class="am-kpi"><span><i class="am-dot am-dot-in_use"></i>사용 중</span><strong id="am-in_use">—</strong><small>직원에게 배정된 자산</small></button>
|
||||
<button data-kpi="available" class="am-kpi"><span><i class="am-dot am-dot-available"></i>사용 가능</span><strong id="am-available">—</strong><small>새로 배정할 수 있는 자산</small></button>
|
||||
<button data-kpi="maintenance" class="am-kpi"><span><i class="am-dot am-dot-maintenance"></i>수리 중</span><strong id="am-maintenance">—</strong><small>점검 · 수리 중인 자산</small></button>
|
||||
<button data-kpi="warranty" class="am-kpi"><span>보증 만료 예정</span><strong id="am-warranty_soon">—</strong><small>오늘부터 30일 이내</small></button>
|
||||
</div>
|
||||
<div class="am-register">
|
||||
<div class="am-register-head"><div><h3 id="am-list-title">전체 자산</h3><span id="am-result-count">자산을 불러오는 중</span></div><div><button class="am-text-btn" id="am-refresh" aria-label="자산 새로고침">↻ 새로고침</button><button class="erp-btn erp-btn-outline" id="am-export" {% if not configured %}disabled{% endif %}>엑셀 내보내기 ↓</button></div></div>
|
||||
<form class="am-filters" id="am-filters" role="search">
|
||||
<label class="am-search"><span aria-hidden="true">⌕</span><input id="am-query" type="search" maxlength="200" placeholder="자산명, 번호, 모델, 시리얼 검색" aria-label="자산 검색"></label>
|
||||
<select id="am-category" aria-label="분류"><option value="">모든 분류</option>{% for key,label in categories.items() %}<option value="{{ key }}">{{ label }}</option>{% endfor %}</select>
|
||||
<select id="am-status" aria-label="상태"><option value="">모든 상태</option>{% for key,label in statuses.items() %}<option value="{{ key }}">{{ label }}</option>{% endfor %}</select>
|
||||
<select id="am-location" aria-label="위치"><option value="">모든 위치</option></select>
|
||||
<select id="am-assignee" aria-label="배정 사용자"><option value="">모든 사용자</option></select>
|
||||
<select id="am-sort" aria-label="정렬"><option value="updated">최근 변경순</option><option value="name">자산명순</option><option value="tag">자산번호순</option><option value="cost">구매금액순</option><option value="warranty">보증종료순</option></select>
|
||||
<button type="button" class="am-text-btn" id="am-reset">초기화</button>
|
||||
</form>
|
||||
<div class="am-table-scroll"><table class="am-table"><thead><tr><th>자산</th><th>분류</th><th>상태</th><th>사용자 / 위치</th><th>구매금액</th><th>보증 종료</th><th>사양</th></tr></thead><tbody id="am-rows"><tr><td colspan="7" class="am-empty">{% if configured %}자산을 불러오는 중입니다.{% else %}등록된 자산이 여기에 표시됩니다.{% endif %}</td></tr></tbody></table></div>
|
||||
<div class="am-pagination"><span id="am-page-info">—</span><div><button class="erp-btn erp-btn-outline" id="am-prev" disabled>← 이전</button><span id="am-page-number">1</span><button class="erp-btn erp-btn-outline" id="am-next" disabled>다음 →</button></div></div>
|
||||
</div>
|
||||
<div class="am-bottom"><section class="am-panel"><div class="am-panel-head"><h3>자산 구성</h3><span>분류별 등록 수</span></div><div id="am-breakdown" class="am-breakdown"><p class="am-muted">등록된 자산이 없습니다.</p></div><div class="am-value"><span>보유 자산 구매금액 <small>폐기 제외 · 입력된 금액 기준</small></span><strong id="am-value">—</strong></div></section><section class="am-panel"><div class="am-panel-head"><h3>최근 활동</h3><span>등록 · 배정 · 반납 · 변경</span></div><div id="am-activity" class="am-activity"><p class="am-muted">활동 이력이 여기에 표시됩니다.</p></div></section></div>
|
||||
</section>
|
||||
</div>
|
||||
<dialog id="am-detail" class="am-drawer" aria-labelledby="am-detail-title"><div class="am-dialog-head"><div><small id="am-detail-tag">자산 상세</small><h2 id="am-detail-title">자산 정보</h2></div><button type="button" class="am-close" data-close="am-detail" aria-label="자산 상세 닫기">×</button></div><div id="am-detail-content"></div></dialog>
|
||||
<dialog id="am-editor" class="am-dialog" aria-labelledby="am-editor-title"><div class="am-dialog-head"><div><small>ASSET REGISTER</small><h2 id="am-editor-title">자산 등록</h2></div><button type="button" class="am-close" data-close="am-editor" aria-label="등록 창 닫기">×</button></div><form id="am-editor-form" class="am-form"><div class="am-form-grid">
|
||||
<label>자산명 <span>*</span><input name="name" maxlength="200" required placeholder="예: 디자인팀 데스크톱"></label>
|
||||
<label>자산번호<input name="tag" maxlength="64" placeholder="비워두면 자동 발급 (AST-000001)"></label>
|
||||
<label>분류 <span>*</span><select name="category" required>{% for key,label in categories.items() %}<option value="{{ key }}">{{ label }}</option>{% endfor %}</select></label>
|
||||
<label>제조사<input name="manufacturer" maxlength="150" placeholder="예: Dell, 시디즈"></label>
|
||||
<label>모델<input name="model" maxlength="200"></label><label>시리얼 번호<input name="serial" maxlength="200"></label>
|
||||
<label>위치<input name="location" maxlength="150" list="am-locations" placeholder="예: 본사 3층 디자인팀"></label><label>부서<input name="department" maxlength="100"></label>
|
||||
<label>구매일<input type="date" name="purchased_on"></label><label>구매금액 (원)<input type="number" name="purchase_cost" min="0" max="1000000000000" step="0.01" placeholder="미입력 가능"></label>
|
||||
<label>구매처<input name="vendor" maxlength="200"></label><label>보증 종료일<input type="date" name="warranty_until"></label>
|
||||
<label class="am-wide">메모<textarea name="notes" maxlength="10000" rows="3" placeholder="관리에 필요한 추가 정보를 입력하세요."></textarea></label>
|
||||
</div><p class="am-form-hint">같은 모델도 자산번호를 각각 발급합니다. 사용자 배정은 등록 후 상세 화면에서 진행합니다.</p><div class="am-form-error" role="alert" hidden></div><div class="am-dialog-footer"><button type="button" class="erp-btn erp-btn-outline" data-close="am-editor">취소</button><button type="submit" class="erp-btn erp-btn-primary">자산 저장</button></div></form></dialog>
|
||||
<dialog id="am-upload" class="am-dialog am-upload-dialog" aria-labelledby="am-upload-title"><div class="am-dialog-head"><div><small>HWiNFO XML IMPORT</small><h2 id="am-upload-title">컴퓨터 보고서 가져오기</h2></div><button type="button" class="am-close" data-close="am-upload" aria-label="업로드 창 닫기">×</button></div><form id="am-upload-form" class="am-form">
|
||||
<p class="am-form-hint" id="am-upload-hint">HWiNFO에서 저장한 XML 보고서를 선택하세요. 사양을 분석한 뒤 자산으로 등록합니다.</p>
|
||||
<label class="am-drop" id="am-drop"><span class="am-upload-icon">↑</span><strong>XML 보고서 선택</strong><span>파일을 여기에 놓거나 클릭하세요 · 최대 10 MB</span><input type="file" id="am-report-file" accept=".xml" aria-label="HWiNFO XML 보고서 선택" required></label>
|
||||
<div id="am-report-preview" hidden></div>
|
||||
<div id="am-import-fields" class="am-form-grid" hidden><label>자산명 <span>*</span><input id="am-import-name" maxlength="200" required></label><label>위치<input id="am-import-location" maxlength="150" list="am-locations" placeholder="예: 본사 3층"></label></div>
|
||||
<div class="am-form-error" role="alert" hidden></div><div class="am-dialog-footer"><span id="am-upload-status" class="am-muted"></span><button type="button" class="erp-btn erp-btn-outline" data-close="am-upload">취소</button><button type="submit" class="erp-btn erp-btn-primary" id="am-import-save" disabled>자산으로 등록</button></div>
|
||||
</form></dialog>
|
||||
<dialog id="am-action" class="am-dialog am-action-dialog" aria-labelledby="am-action-title"><div class="am-dialog-head"><div><small id="am-action-tag"></small><h2 id="am-action-title">자산 배정</h2></div><button type="button" class="am-close" data-close="am-action" aria-label="처리 창 닫기">×</button></div><form id="am-action-form" class="am-form"><p id="am-action-hint" class="am-form-hint"></p><label id="am-action-user-label">배정할 사용자 <span>*</span><select id="am-action-user"><option value="">사용자 선택</option></select></label><label>자산 위치<input id="am-action-location" list="am-locations" maxlength="150"></label><label>처리 메모<textarea id="am-action-note" maxlength="2000" rows="3" placeholder="배정 사유, 반납 상태, 수리 내용 등을 기록하세요."></textarea></label><div class="am-form-error" role="alert" hidden></div><div class="am-dialog-footer"><button type="button" class="erp-btn erp-btn-outline" data-close="am-action">취소</button><button type="submit" class="erp-btn erp-btn-primary" id="am-action-save">처리하기</button></div></form></dialog>
|
||||
<dialog id="am-help" class="am-dialog" aria-labelledby="am-help-title"><div class="am-dialog-head"><h2 id="am-help-title">자산관리 사용 안내</h2><button class="am-close" data-close="am-help" aria-label="사용 안내 닫기">×</button></div><div class="am-form am-help"><h3>01. 자산 등록</h3><p>책상·의자·마우스 등은 개별 자산으로 등록합니다. 자산번호를 비워두면 자동 발급합니다. 컴퓨터는 HWiNFO 보고서를 가져오면 이름과 주요 사양을 확인하고 등록할 수 있습니다.</p><h3>02. 배정과 반납</h3><p>사용 가능한 자산을 등록된 회사 사용자에게 배정합니다. 사용 중인 자산은 반납 후 수리·폐기할 수 있습니다. 위치·사유와 처리자가 이력에 남습니다. 분실 처리 시 기존 배정 사용자도 기록됩니다.</p><h3>03. 컴퓨터 사양</h3><p>HWiNFO → 보고서 저장 → XML 형식을 선택합니다. 핵심 사양, 부품별 상세와 보고서 전체 항목을 볼 수 있습니다. 재업로드할 때 컴퓨터 이름을 확인하세요. 이전 보고서와 원본 XML은 보존됩니다.</p><h3>04. 찾기와 내보내기</h3><p>검색·분류·상태·위치·사용자 필터를 조합합니다. 엑셀 내보내기는 현재 필터에 해당하는 자산 전체를 포함하며 최대 10,000개입니다. 보증 만료 예정은 오늘부터 30일 이내입니다.</p><p class="am-form-hint">보고서에는 시리얼·MAC 주소 등 회사 장비 정보가 포함될 수 있습니다. 자산관리 권한을 가진 사용자만 조회할 수 있습니다.</p></div></dialog>
|
||||
<datalist id="am-locations"></datalist>
|
||||
<dialog id="am-photo" class="am-dialog" aria-labelledby="am-photo-title"><div class="am-dialog-head"><h2 id="am-photo-title">자산 사진 등록</h2><button type="button" class="am-close" data-close="am-photo" aria-label="사진 등록 닫기">×</button></div><form id="am-photo-form" class="am-form"><p class="am-form-hint">JPG · PNG · WebP, 파일당 8 MB 이하 · 자산당 최대 10장. 촬영 위치 정보는 제거해 보관합니다.</p><label>사진 선택<input id="am-photo-file" type="file" accept="image/jpeg,image/png,image/webp" required></label><div class="am-form-error" role="alert" hidden></div><div class="am-dialog-footer"><button type="button" class="erp-btn erp-btn-outline" data-close="am-photo">취소</button><button type="submit" class="erp-btn erp-btn-primary">사진 저장</button></div></form></dialog>
|
||||
<dialog id="am-delete" class="am-dialog" aria-labelledby="am-delete-title"><div class="am-dialog-head"><h2 id="am-delete-title">자산 삭제</h2><button type="button" class="am-close" data-close="am-delete" aria-label="삭제 창 닫기">×</button></div><form id="am-delete-form" class="am-form"><p class="am-warning" id="am-delete-hint"></p><p class="am-form-hint">자산대장과 현황에서 제외됩니다. 사진·보고서·처리 이력은 보존됩니다.</p><label>삭제할 자산번호 확인<input id="am-delete-confirm" required autocomplete="off"></label><label>삭제 사유<textarea id="am-delete-note" required maxlength="2000" rows="3"></textarea></label><div class="am-form-error" role="alert" hidden></div><div class="am-dialog-footer"><button type="button" class="erp-btn erp-btn-outline" data-close="am-delete">취소</button><button type="submit" class="erp-btn am-danger">자산 삭제</button></div></form></dialog>
|
||||
{% endblock %}
|
||||
{% block scripts %}<script id="am-config" type="application/json">{{ {"categories":categories,"statuses":statuses}|tojson }}</script><script src="/static/asset.js?v=20261007a" defer></script>{% endblock %}
|
||||
+503
-96
@@ -14,10 +14,12 @@ API 로그에는 토큰/시크릿을 넣지 않는다.
|
||||
from __future__ import annotations
|
||||
|
||||
import logging
|
||||
import uuid
|
||||
from contextlib import contextmanager
|
||||
from datetime import date, datetime
|
||||
from typing import Any, Iterator
|
||||
|
||||
from psycopg import errors as pg_errors
|
||||
from psycopg.rows import dict_row
|
||||
from psycopg_pool import ConnectionPool
|
||||
|
||||
@@ -97,6 +99,315 @@ class Cafe24Store:
|
||||
def close(self) -> None:
|
||||
self._pool.close()
|
||||
|
||||
# ════════════════════════════════════════════════════════════
|
||||
# 마이그레이션 005(쓰기 안전장치) 적용 여부
|
||||
# 쓰기 경로는 잠금·시도 기록 없이 카페24에 쓰지 않는다 — 적용 전이면 거부한다.
|
||||
# 읽기 경로는 005 가 없어도 동작하게 둔다(배포 순서가 어긋나도 화면은 열린다).
|
||||
# ════════════════════════════════════════════════════════════
|
||||
_schema_ok = False
|
||||
|
||||
def write_schema_ready(self) -> bool:
|
||||
if self._schema_ok:
|
||||
return True
|
||||
with self._pool.connection() as conn:
|
||||
row = conn.execute(
|
||||
"""
|
||||
SELECT to_regclass('public.cafe24_write_locks') IS NOT NULL
|
||||
AND to_regclass('public.cafe24_write_attempts') IS NOT NULL
|
||||
AND EXISTS (SELECT 1 FROM information_schema.columns
|
||||
WHERE table_name = 'cafe24_product_schedules'
|
||||
AND column_name = 'lease_token')
|
||||
AND EXISTS (SELECT 1 FROM information_schema.columns
|
||||
WHERE table_name = 'cafe24_product_revisions'
|
||||
AND column_name = 'source') AS ok
|
||||
"""
|
||||
).fetchone()
|
||||
self._schema_ok = bool(row and row.get("ok"))
|
||||
return self._schema_ok
|
||||
|
||||
# ════════════════════════════════════════════════════════════
|
||||
# 쓰기 잠금 (lease) — 웹 여러 프로세스 + 예약 worker 가 공유한다.
|
||||
# 같은 lock_key 는 한 번에 하나만 잡는다. 만료(expires_at)가 지나면 다른 쪽이
|
||||
# 가져갈 수 있다(잡은 프로세스가 죽어도 영구히 막히지 않는다). 원격 쓰기 직전
|
||||
# renew_lock 으로 "아직 내 잠금인가"를 확인한다(펜싱) — 아니면 쓰지 않는다.
|
||||
# ════════════════════════════════════════════════════════════
|
||||
def acquire_lock(self, key: str, *, owner: str, purpose: str, ttl_seconds: int) -> str | None:
|
||||
"""잠금을 잡으면 token, 남이 잡고 있으면 None."""
|
||||
token = uuid.uuid4().hex
|
||||
with self._pool.connection() as conn:
|
||||
row = conn.execute(
|
||||
"""
|
||||
INSERT INTO cafe24_write_locks (lock_key, owner, token, purpose, acquired_at, expires_at)
|
||||
VALUES (%s, %s, %s, %s, now(), now() + %s * interval '1 second')
|
||||
ON CONFLICT (lock_key) DO UPDATE SET
|
||||
owner = EXCLUDED.owner, token = EXCLUDED.token, purpose = EXCLUDED.purpose,
|
||||
acquired_at = now(), expires_at = EXCLUDED.expires_at
|
||||
WHERE cafe24_write_locks.expires_at < now()
|
||||
RETURNING token
|
||||
""",
|
||||
(key, (owner or "")[:200], token, (purpose or "")[:200], max(1, int(ttl_seconds))),
|
||||
).fetchone()
|
||||
return str(row["token"]) if row else None
|
||||
|
||||
def renew_lock(self, key: str, token: str, *, ttl_seconds: int) -> bool:
|
||||
"""아직 내 잠금이고 만료 전이면 연장하고 True. 이미 넘어갔으면 False."""
|
||||
with self._pool.connection() as conn:
|
||||
row = conn.execute(
|
||||
"""
|
||||
UPDATE cafe24_write_locks
|
||||
SET expires_at = now() + %s * interval '1 second'
|
||||
WHERE lock_key = %s AND token = %s AND expires_at > now()
|
||||
RETURNING lock_key
|
||||
""",
|
||||
(max(1, int(ttl_seconds)), key, token),
|
||||
).fetchone()
|
||||
return row is not None
|
||||
|
||||
def release_lock(self, key: str, token: str) -> None:
|
||||
with self._pool.connection() as conn:
|
||||
conn.execute(
|
||||
"DELETE FROM cafe24_write_locks WHERE lock_key = %s AND token = %s",
|
||||
(key, token),
|
||||
)
|
||||
|
||||
def lock_holder(self, key: str) -> dict[str, Any]:
|
||||
"""지금 잠금을 잡고 있는 쪽(안내 문구용). 없거나 만료됐으면 {}."""
|
||||
with self._pool.connection() as conn:
|
||||
row = conn.execute(
|
||||
"""
|
||||
SELECT owner, purpose, acquired_at, expires_at FROM cafe24_write_locks
|
||||
WHERE lock_key = %s AND expires_at > now()
|
||||
""",
|
||||
(key,),
|
||||
).fetchone()
|
||||
return self._serialize(row)
|
||||
|
||||
# ════════════════════════════════════════════════════════════
|
||||
# 쓰기 시도 기록 (cafe24_write_attempts) — 운영용 가변 표.
|
||||
# 원격 PUT 직전에 STARTED 로 남기고, 결과에 따라 상태를 바꾼다.
|
||||
# ════════════════════════════════════════════════════════════
|
||||
_ATTEMPT_FIELDS: tuple[str, ...] = (
|
||||
"product_no", "mall_id", "shop_no", "origin", "schedule_id", "actor",
|
||||
"backup_revision_id", "observed_digest", "base_digest", "target_digest",
|
||||
"target_html", "target_revision_id", "set_display", "set_selling", "memo",
|
||||
)
|
||||
|
||||
def start_attempt(self, **fields: Any) -> int:
|
||||
cols = [k for k in self._ATTEMPT_FIELDS if k in fields]
|
||||
values = [fields[k] for k in cols]
|
||||
with self._pool.connection() as conn:
|
||||
row = conn.execute(
|
||||
f"""
|
||||
INSERT INTO cafe24_write_attempts ({", ".join(cols)}, status)
|
||||
VALUES ({", ".join(["%s"] * len(cols))}, %s)
|
||||
RETURNING id
|
||||
""",
|
||||
(*values, store.ATTEMPT_STARTED),
|
||||
).fetchone()
|
||||
return int(row["id"]) if row else 0
|
||||
|
||||
def update_attempt(
|
||||
self,
|
||||
attempt_id: int,
|
||||
*,
|
||||
status: str | None = None,
|
||||
error: str | None = None,
|
||||
remote_updated_at: str | None = None,
|
||||
remote_ok: bool = False,
|
||||
resolved_by: str | None = None,
|
||||
only_from: tuple[str, ...] | None = None,
|
||||
) -> bool:
|
||||
"""상태 전이. only_from 을 주면 그 상태에서만 바꾼다(늦게 도착한 갱신 무시)."""
|
||||
sets: list[str] = []
|
||||
args: list[Any] = []
|
||||
if status is not None:
|
||||
sets.append("status = %s")
|
||||
args.append(status)
|
||||
if error is not None:
|
||||
sets.append("error = %s")
|
||||
args.append((error or "")[:1000])
|
||||
if remote_updated_at is not None:
|
||||
sets.append("remote_updated_at = %s")
|
||||
args.append(str(remote_updated_at or ""))
|
||||
if remote_ok:
|
||||
sets.append("remote_at = COALESCE(remote_at, now())")
|
||||
if resolved_by is not None:
|
||||
sets.append("resolved_by = %s")
|
||||
args.append(resolved_by[:200])
|
||||
if not sets:
|
||||
return False
|
||||
where = "id = %s"
|
||||
args.append(int(attempt_id))
|
||||
if only_from:
|
||||
where += " AND status = ANY(%s)"
|
||||
args.append(list(only_from))
|
||||
with self._pool.connection() as conn:
|
||||
row = conn.execute(
|
||||
f"UPDATE cafe24_write_attempts SET {', '.join(sets)} WHERE {where} RETURNING id",
|
||||
args,
|
||||
).fetchone()
|
||||
return row is not None
|
||||
|
||||
def record_attempt_revision(
|
||||
self,
|
||||
attempt_id: int,
|
||||
*,
|
||||
revision_type: str,
|
||||
memo: str,
|
||||
created_by: str,
|
||||
source: str = "",
|
||||
source_revision_id: int | None = None,
|
||||
) -> int:
|
||||
"""원격 반영된 시도의 버전(MANUAL/SCHEDULED/ROLLBACK)을 남기고 RECORDED 로 바꾼다.
|
||||
|
||||
한 트랜잭션에서 한다 — 시도 행을 잠그고, 이미 기록돼 있으면 그 버전 id 를 돌려준다
|
||||
(기록 복구가 두 번 돌아도 버전이 둘 생기지 않는다). 내용은 시도에 보관한
|
||||
target_html(없으면 target_revision_id 의 내용)이다. 기록 뒤 target_html 은 비운다.
|
||||
"""
|
||||
with self._pool.connection() as conn:
|
||||
with conn.transaction():
|
||||
att = conn.execute(
|
||||
"""
|
||||
SELECT a.*, COALESCE(NULLIF(a.target_html, ''), t.html_content, '') AS body
|
||||
FROM cafe24_write_attempts a
|
||||
LEFT JOIN cafe24_product_revisions t ON t.id = a.target_revision_id
|
||||
WHERE a.id = %s
|
||||
FOR UPDATE OF a
|
||||
""",
|
||||
(int(attempt_id),),
|
||||
).fetchone()
|
||||
if att is None:
|
||||
return 0
|
||||
if att.get("applied_revision_id"):
|
||||
return int(att["applied_revision_id"])
|
||||
row = conn.execute(
|
||||
"""
|
||||
INSERT INTO cafe24_product_revisions
|
||||
(product_no, html_content, revision_type, memo, created_by,
|
||||
mall_id, shop_no, source, source_revision_id)
|
||||
VALUES (%s,%s,%s,%s,%s,%s,%s,%s,%s)
|
||||
RETURNING id
|
||||
""",
|
||||
(
|
||||
int(att["product_no"]), att["body"] or "",
|
||||
store.normalize_revision_type(revision_type), (memo or "")[:500],
|
||||
created_by or "", att.get("mall_id") or "", int(att.get("shop_no") or 1),
|
||||
source or "", source_revision_id,
|
||||
),
|
||||
).fetchone()
|
||||
revision_id = int(row["id"])
|
||||
conn.execute(
|
||||
"""
|
||||
UPDATE cafe24_write_attempts
|
||||
SET status = %s, applied_revision_id = %s, target_html = '',
|
||||
remote_at = COALESCE(remote_at, now())
|
||||
WHERE id = %s
|
||||
""",
|
||||
(store.ATTEMPT_RECORDED, revision_id, int(attempt_id)),
|
||||
)
|
||||
return revision_id
|
||||
|
||||
def get_attempt(self, attempt_id: int) -> dict[str, Any]:
|
||||
with self._pool.connection() as conn:
|
||||
row = conn.execute(
|
||||
"SELECT * FROM cafe24_write_attempts WHERE id = %s", (int(attempt_id),)
|
||||
).fetchone()
|
||||
return self._serialize(row)
|
||||
|
||||
def latest_attempt_for_schedule(self, schedule_id: int) -> dict[str, Any]:
|
||||
with self._pool.connection() as conn:
|
||||
row = conn.execute(
|
||||
"""
|
||||
SELECT * FROM cafe24_write_attempts WHERE schedule_id = %s
|
||||
ORDER BY created_at DESC, id DESC LIMIT 1
|
||||
""",
|
||||
(int(schedule_id),),
|
||||
).fetchone()
|
||||
return self._serialize(row)
|
||||
|
||||
def open_attempts(self, product_no: int, *, since: datetime) -> list[dict[str, Any]]:
|
||||
"""결과 확정이 필요한 시도(STARTED/REMOTE_OK/UNKNOWN), 유예시간 안, 오래된 순.
|
||||
|
||||
005 적용 전이면 빈 목록(읽기 경로는 막지 않는다)."""
|
||||
try:
|
||||
with self._pool.connection() as conn:
|
||||
rows = conn.execute(
|
||||
"""
|
||||
SELECT id, product_no, origin, schedule_id, actor, status, target_digest,
|
||||
target_revision_id, backup_revision_id, set_display, set_selling,
|
||||
error, created_at, remote_at, memo
|
||||
FROM cafe24_write_attempts
|
||||
WHERE product_no = %s AND status = ANY(%s) AND created_at >= %s
|
||||
ORDER BY created_at ASC, id ASC
|
||||
""",
|
||||
(int(product_no), list(store.ATTEMPT_OPEN), since),
|
||||
).fetchall()
|
||||
except (pg_errors.UndefinedTable, pg_errors.UndefinedColumn):
|
||||
return []
|
||||
return [self._serialize(r) for r in rows]
|
||||
|
||||
def attempts_needing_record(self, *, since: datetime, limit: int = 20) -> list[dict[str, Any]]:
|
||||
"""원격 반영됐는데 버전 기록이 안 된 시도(REMOTE_OK) — worker 가 기록을 채운다."""
|
||||
with self._pool.connection() as conn:
|
||||
rows = conn.execute(
|
||||
"""
|
||||
SELECT id, product_no, origin, schedule_id, actor, memo, target_revision_id, target_digest
|
||||
FROM cafe24_write_attempts
|
||||
WHERE status = %s AND created_at >= %s
|
||||
ORDER BY created_at ASC, id ASC LIMIT %s
|
||||
""",
|
||||
(store.ATTEMPT_REMOTE_OK, since, max(1, int(limit))),
|
||||
).fetchall()
|
||||
return [self._serialize(r) for r in rows]
|
||||
|
||||
def write_lineage(self, product_no: int, *, since: datetime, limit: int = 30) -> list[dict[str, Any]]:
|
||||
"""원격 반영이 **확인된** 상세설명 쓰기(REMOTE_OK/RECORDED), 최신 순.
|
||||
|
||||
읽기 지연 판정의 유일한 근거다. 충돌로 거절된 적용의 백업, 예약 초안, 실패·결과
|
||||
모름 시도는 들어오지 않는다. 첫 행에만 html_content(마지막으로 쓴 HTML)를 채운다.
|
||||
created_at 은 원격 반영 시각(remote_at)이다. 005 적용 전이면 빈 목록.
|
||||
"""
|
||||
try:
|
||||
with self._pool.connection() as conn:
|
||||
rows = conn.execute(
|
||||
"""
|
||||
SELECT id, origin, actor, status, schedule_id, observed_digest, base_digest,
|
||||
target_digest, remote_updated_at, remote_at, applied_revision_id,
|
||||
target_revision_id
|
||||
FROM cafe24_write_attempts
|
||||
WHERE product_no = %s AND status = ANY(%s) AND target_digest <> ''
|
||||
AND remote_at >= %s
|
||||
ORDER BY remote_at DESC, id DESC
|
||||
LIMIT %s
|
||||
""",
|
||||
(int(product_no), list(store.ATTEMPT_CONFIRMED), since, max(1, int(limit))),
|
||||
).fetchall()
|
||||
if not rows:
|
||||
return []
|
||||
top = conn.execute(
|
||||
"""
|
||||
SELECT COALESCE(NULLIF(a.target_html, ''), r.html_content, t.html_content, '') AS body
|
||||
FROM cafe24_write_attempts a
|
||||
LEFT JOIN cafe24_product_revisions r ON r.id = a.applied_revision_id
|
||||
LEFT JOIN cafe24_product_revisions t ON t.id = a.target_revision_id
|
||||
WHERE a.id = %s
|
||||
""",
|
||||
(rows[0]["id"],),
|
||||
).fetchone()
|
||||
except (pg_errors.UndefinedTable, pg_errors.UndefinedColumn):
|
||||
return []
|
||||
out: list[dict[str, Any]] = []
|
||||
for index, row in enumerate(rows):
|
||||
item = dict(row)
|
||||
at = item.get("remote_at")
|
||||
if isinstance(at, datetime) and at.tzinfo is None:
|
||||
at = at.replace(tzinfo=KST)
|
||||
item["created_at"] = at
|
||||
item["created_by"] = item.get("actor") or ""
|
||||
item["html_content"] = (top or {}).get("body", "") if index == 0 else ""
|
||||
out.append(item)
|
||||
return out
|
||||
|
||||
# ════════════════════════════════════════════════════════════
|
||||
# OAuth 토큰 — app/integrations/cafe24/tokens.py 가 요구하는 3개 메서드
|
||||
# ════════════════════════════════════════════════════════════
|
||||
@@ -281,31 +592,38 @@ class Cafe24Store:
|
||||
# 마이그레이션 004 의 두 컬럼(last_write_snapshot, last_written_at)을 쓴다.
|
||||
# 스냅샷 JSON 모양:
|
||||
# {"product": {"data": {...store.SNAPSHOT_FIELDS...}, "written_at": ISO},
|
||||
# "options": {"data": {...GET/PUT options 응답...}, "written_at": ISO},
|
||||
# "variants": {"data": {variant_code: {...}}, "written_at": ISO}}
|
||||
# "options": {"data": {...GET/PUT options 응답..., "_before_signature", "_recent_values"},
|
||||
# "written_at": ISO},
|
||||
# "variants": {"data": {variant_code: {필드..., "_at", "_deleted"?}}, "written_at": ISO}}
|
||||
# 섹션별로 따로 갱신한다(가격만 바꿨는데 옵션 스냅샷이 사라지면 안 된다).
|
||||
def save_write_snapshot(self, product_no: int, section: str, data: Any) -> None:
|
||||
# 품목은 코드별·필드별로 병합한다(store.merge_variant_snapshot). 품목 전체 초기화
|
||||
# (옵션 삭제·재생성)는 replace=True 로 명시한다 — {} 를 넘기는 것은 "변경 없음"이다.
|
||||
def save_write_snapshot(self, product_no: int, section: str, data: Any, *, replace: bool = False) -> None:
|
||||
from psycopg.types.json import Jsonb # noqa: WPS433
|
||||
|
||||
no = int(product_no)
|
||||
if no <= 0 or section not in ("product", "options", "variants"):
|
||||
return
|
||||
now_iso = datetime.now(KST).isoformat(timespec="seconds")
|
||||
with self._pool.connection() as conn:
|
||||
with conn.transaction():
|
||||
# 행이 없으면 먼저 만든다 — FOR UPDATE 가 잠글 행이 있어야 동시 저장이
|
||||
# 서로의 병합 결과를 덮지 않는다.
|
||||
conn.execute(
|
||||
"INSERT INTO cafe24_products (product_no) VALUES (%s) ON CONFLICT (product_no) DO NOTHING",
|
||||
(no,),
|
||||
)
|
||||
row = conn.execute(
|
||||
"SELECT last_write_snapshot FROM cafe24_products WHERE product_no = %s FOR UPDATE",
|
||||
(no,),
|
||||
).fetchone()
|
||||
current = dict(row["last_write_snapshot"]) if row and row.get("last_write_snapshot") else {}
|
||||
if section == "variants" and isinstance(data, dict):
|
||||
# 품목은 코드별로 누적 병합 — 일부만 바꿔도 이전에 바꾼 것을 잃지 않게.
|
||||
merged = dict((current.get("variants") or {}).get("data") or {})
|
||||
merged.update(data)
|
||||
data = merged
|
||||
current[section] = {
|
||||
"data": data,
|
||||
"written_at": datetime.now(KST).isoformat(timespec="seconds"),
|
||||
}
|
||||
if section == "variants":
|
||||
previous = (current.get("variants") or {}).get("data") or {}
|
||||
data = store.merge_variant_snapshot(
|
||||
previous, data if isinstance(data, dict) else {}, at=now_iso, replace=replace
|
||||
)
|
||||
current[section] = {"data": data, "written_at": now_iso}
|
||||
product = data if section == "product" and isinstance(data, dict) else {}
|
||||
conn.execute(
|
||||
"""
|
||||
@@ -345,51 +663,14 @@ class Cafe24Store:
|
||||
return {}
|
||||
return dict(row["last_write_snapshot"])
|
||||
|
||||
# ── 읽기 지연 판정용 revision 조회 ──
|
||||
def latest_write_revision(self, product_no: int, *, since: datetime) -> dict[str, Any] | None:
|
||||
"""유예시간 안의 가장 최근 '쓰기' revision(MANUAL/SCHEDULED/ROLLBACK) — HTML 포함."""
|
||||
with self._pool.connection() as conn:
|
||||
row = conn.execute(
|
||||
"""
|
||||
SELECT id, product_no, revision_type, html_content, memo, created_by, created_at
|
||||
FROM cafe24_product_revisions
|
||||
WHERE product_no = %s
|
||||
AND revision_type = ANY(%s)
|
||||
AND created_at >= %s
|
||||
ORDER BY created_at DESC, id DESC
|
||||
LIMIT 1
|
||||
""",
|
||||
(int(product_no), list(store.WRITE_REVISION_TYPES), since),
|
||||
).fetchone()
|
||||
if not row:
|
||||
return None
|
||||
out = dict(row)
|
||||
at = out.get("created_at")
|
||||
if isinstance(at, datetime) and at.tzinfo is None:
|
||||
out["created_at"] = at.replace(tzinfo=KST)
|
||||
return out
|
||||
|
||||
def revision_digests(self, product_no: int, *, since: datetime) -> set[str]:
|
||||
"""유예시간 안의 revision 들의 내용 해시(store.content_digest 와 같은 md5 hex).
|
||||
|
||||
내용을 통째로 옮기지 않고 DB 에서 해시만 계산한다(상세페이지는 수 MB 일 수 있다).
|
||||
md5 를 쓰는 이유: 모든 PostgreSQL 버전에 있고, 여기서는 충돌 저항이 아니라
|
||||
"같은 내용인가"만 필요하다.
|
||||
"""
|
||||
with self._pool.connection() as conn:
|
||||
rows = conn.execute(
|
||||
"""
|
||||
SELECT md5(html_content) AS digest
|
||||
FROM cafe24_product_revisions
|
||||
WHERE product_no = %s AND created_at >= %s
|
||||
""",
|
||||
(int(product_no), since),
|
||||
).fetchall()
|
||||
return {str(r["digest"]) for r in rows if r.get("digest")}
|
||||
|
||||
# ════════════════════════════════════════════════════════════
|
||||
# 상세페이지 HTML 버전 (append-only — UPDATE/DELETE 하지 않는다)
|
||||
# 쓰기 직전 BACKUP 을 남기는 것이 유일한 복구 수단이다.
|
||||
# 읽기 지연 판정은 이 표가 아니라 cafe24_write_attempts(확인된 쓰기)를 본다 —
|
||||
# 여기에는 충돌로 거절된 적용의 백업·예약 초안처럼 카페24에 올라간 적 없는 값도
|
||||
# 들어 있기 때문이다(write_lineage 참고).
|
||||
# 메타데이터(마이그레이션 005): mall_id·shop_no(복원 시 일치 검사), source
|
||||
# (BACKUP 이 카페24 관측값인지, 지연 중이라 마지막 확인된 쓰기인지), source_revision_id.
|
||||
# ════════════════════════════════════════════════════════════
|
||||
def add_revision(
|
||||
self,
|
||||
@@ -399,13 +680,18 @@ class Cafe24Store:
|
||||
revision_type: str,
|
||||
memo: str = "",
|
||||
created_by: str = "",
|
||||
mall_id: str = "",
|
||||
shop_no: int = 1,
|
||||
source: str = "",
|
||||
source_revision_id: int | None = None,
|
||||
) -> int:
|
||||
with self._pool.connection() as conn:
|
||||
row = conn.execute(
|
||||
"""
|
||||
INSERT INTO cafe24_product_revisions
|
||||
(product_no, html_content, revision_type, memo, created_by)
|
||||
VALUES (%s,%s,%s,%s,%s)
|
||||
(product_no, html_content, revision_type, memo, created_by,
|
||||
mall_id, shop_no, source, source_revision_id)
|
||||
VALUES (%s,%s,%s,%s,%s,%s,%s,%s,%s)
|
||||
RETURNING id
|
||||
""",
|
||||
(
|
||||
@@ -414,24 +700,33 @@ class Cafe24Store:
|
||||
store.normalize_revision_type(revision_type),
|
||||
(memo or "")[:500],
|
||||
created_by or "",
|
||||
mall_id or "",
|
||||
int(shop_no or 1),
|
||||
source or "",
|
||||
source_revision_id,
|
||||
),
|
||||
).fetchone()
|
||||
return int(row["id"]) if row else 0
|
||||
|
||||
def list_revisions(self, product_no: int, *, limit: int = 20) -> list[dict[str, Any]]:
|
||||
"""버전 목록. html_content 는 수 MB 일 수 있어 길이만 계산해서 준다."""
|
||||
with self._pool.connection() as conn:
|
||||
rows = conn.execute(
|
||||
"""
|
||||
SELECT id, product_no, revision_type, memo, created_by, created_at,
|
||||
length(html_content) AS html_length
|
||||
FROM cafe24_product_revisions
|
||||
WHERE product_no = %s
|
||||
ORDER BY created_at DESC, id DESC
|
||||
LIMIT %s
|
||||
""",
|
||||
(int(product_no), max(1, min(int(limit), 200))),
|
||||
).fetchall()
|
||||
"""버전 목록. html_content 는 수 MB 일 수 있어 길이만 계산해서 준다.
|
||||
|
||||
005 적용 전이면 출처(source) 없이 돌려준다(읽기 경로는 막지 않는다)."""
|
||||
sql = """
|
||||
SELECT id, product_no, revision_type, memo, created_by, created_at,
|
||||
length(html_content) AS html_length{extra}
|
||||
FROM cafe24_product_revisions
|
||||
WHERE product_no = %s
|
||||
ORDER BY created_at DESC, id DESC
|
||||
LIMIT %s
|
||||
"""
|
||||
args = (int(product_no), max(1, min(int(limit), 200)))
|
||||
try:
|
||||
with self._pool.connection() as conn:
|
||||
rows = conn.execute(sql.format(extra=", source, source_revision_id, mall_id"), args).fetchall()
|
||||
except pg_errors.UndefinedColumn:
|
||||
with self._pool.connection() as conn:
|
||||
rows = conn.execute(sql.format(extra=""), args).fetchall()
|
||||
return [self._serialize(r) for r in rows]
|
||||
|
||||
def get_revision(self, revision_id: int) -> dict[str, Any]:
|
||||
@@ -568,18 +863,24 @@ class Cafe24Store:
|
||||
)
|
||||
return True
|
||||
|
||||
@contextmanager
|
||||
def claim_due_schedule(self, *, now: datetime) -> Iterator[dict[str, Any] | None]:
|
||||
"""실행할 예약 1건을 잡아 PROCESSING 으로 바꾼다(worker 전용).
|
||||
# ── 예약 실행 lease (마이그레이션 005) ──
|
||||
# PROCESSING 은 lease_expires_at 까지만 유효하다. worker 가 죽으면 만료 후
|
||||
# claim_expired_schedules 로 다른(또는 재기동한) worker 가 가져가 시도 기록을 보고
|
||||
# 성공/재시도/확인 필요로 나눈다(worker.recover_expired). 모든 상태 변경은
|
||||
# lease_token 이 맞을 때만 한다 — 만료 뒤 늦게 끝난 worker 가 결과를 덮지 않게.
|
||||
def claim_due_schedule(self, *, now: datetime, owner: str, ttl_seconds: int) -> dict[str, Any] | None:
|
||||
"""실행할 예약 1건을 잡아 PROCESSING + lease 로 바꾼다(worker 전용).
|
||||
|
||||
`FOR UPDATE SKIP LOCKED` 로 잠그므로 worker 가 여러 개 떠 있어도 같은 예약을
|
||||
두 번 실행하지 않는다. 재시도 대기(next_retry_at)가 남아 있으면 건너뛴다.
|
||||
두 번 잡지 않는다. 재시도 대기(next_retry_at)가 남아 있으면 건너뛴다.
|
||||
반환 행의 lease_token 으로 renew/finish 한다.
|
||||
"""
|
||||
token = uuid.uuid4().hex
|
||||
with self._pool.connection() as conn:
|
||||
with conn.transaction():
|
||||
row = conn.execute(
|
||||
"""
|
||||
SELECT * FROM cafe24_product_schedules
|
||||
SELECT id FROM cafe24_product_schedules
|
||||
WHERE status = 'PENDING'
|
||||
AND scheduled_at <= %s
|
||||
AND (next_retry_at IS NULL OR next_retry_at <= %s)
|
||||
@@ -589,48 +890,154 @@ class Cafe24Store:
|
||||
""",
|
||||
(now, now),
|
||||
).fetchone()
|
||||
if row is not None:
|
||||
conn.execute(
|
||||
"""
|
||||
UPDATE cafe24_product_schedules
|
||||
SET status = 'PROCESSING', started_at = now(), last_error = ''
|
||||
WHERE id = %s
|
||||
""",
|
||||
(row["id"],),
|
||||
if row is None:
|
||||
return None
|
||||
claimed = conn.execute(
|
||||
"""
|
||||
UPDATE cafe24_product_schedules
|
||||
SET status = 'PROCESSING', started_at = now(), last_error = '',
|
||||
lease_owner = %s, lease_token = %s,
|
||||
lease_expires_at = now() + %s * interval '1 second'
|
||||
WHERE id = %s
|
||||
RETURNING *
|
||||
""",
|
||||
((owner or "")[:200], token, max(1, int(ttl_seconds)), row["id"]),
|
||||
).fetchone()
|
||||
return dict(claimed) if claimed else None
|
||||
|
||||
def claim_expired_schedules(
|
||||
self, *, owner: str, ttl_seconds: int, legacy_minutes: int, limit: int = 20
|
||||
) -> list[dict[str, Any]]:
|
||||
"""lease 가 만료된 PROCESSING 예약을 이 worker 에게 다시 lease 한다(복구 전용).
|
||||
|
||||
lease 컬럼이 비어 있는 옛 행(005 이전에 PROCESSING 이 된 것)은 started_at 이
|
||||
legacy_minutes 보다 오래됐으면 만료로 본다.
|
||||
"""
|
||||
with self._pool.connection() as conn:
|
||||
with conn.transaction():
|
||||
rows = conn.execute(
|
||||
"""
|
||||
WITH picked AS (
|
||||
SELECT id FROM cafe24_product_schedules
|
||||
WHERE status = 'PROCESSING'
|
||||
AND (lease_expires_at < now()
|
||||
OR (lease_expires_at IS NULL
|
||||
AND COALESCE(started_at, updated_at)
|
||||
< now() - %s * interval '1 minute'))
|
||||
ORDER BY id
|
||||
LIMIT %s
|
||||
FOR UPDATE SKIP LOCKED
|
||||
)
|
||||
yield dict(row) if row is not None else None
|
||||
UPDATE cafe24_product_schedules s
|
||||
SET lease_owner = %s,
|
||||
lease_token = md5(random()::text || clock_timestamp()::text || s.id::text),
|
||||
lease_expires_at = now() + %s * interval '1 second'
|
||||
FROM picked
|
||||
WHERE s.id = picked.id
|
||||
RETURNING s.*
|
||||
""",
|
||||
(max(1, int(legacy_minutes)), max(1, int(limit)), (owner or "")[:200],
|
||||
max(1, int(ttl_seconds))),
|
||||
).fetchall()
|
||||
return [dict(r) for r in rows]
|
||||
|
||||
def renew_schedule_lease(self, schedule_id: int, token: str, *, ttl_seconds: int) -> bool:
|
||||
"""아직 내 lease 면 연장하고 True. 만료돼 넘어갔으면 False — 카페24에 쓰지 않는다."""
|
||||
with self._pool.connection() as conn:
|
||||
row = conn.execute(
|
||||
"""
|
||||
UPDATE cafe24_product_schedules
|
||||
SET lease_expires_at = now() + %s * interval '1 second'
|
||||
WHERE id = %s AND status = 'PROCESSING' AND lease_token = %s
|
||||
AND lease_expires_at > now()
|
||||
RETURNING id
|
||||
""",
|
||||
(max(1, int(ttl_seconds)), int(schedule_id), token),
|
||||
).fetchone()
|
||||
return row is not None
|
||||
|
||||
def finish_schedule(
|
||||
self,
|
||||
schedule_id: int,
|
||||
*,
|
||||
token: str,
|
||||
status: str,
|
||||
error: str = "",
|
||||
next_retry_at: datetime | None = None,
|
||||
retry_count: int | None = None,
|
||||
) -> None:
|
||||
"""예약 종료 처리. 재시도로 되돌릴 때는 status='PENDING' + next_retry_at."""
|
||||
) -> bool:
|
||||
"""예약 종료 처리(lease 가 내 것일 때만). 재시도로 되돌릴 때는 status='PENDING' + next_retry_at.
|
||||
|
||||
반환: 반영했으면 True. lease 를 잃었으면 False(다른 worker 가 복구 중 — 덮지 않는다).
|
||||
"""
|
||||
normalized = store.normalize_schedule_status(status)
|
||||
with self._pool.connection() as conn:
|
||||
conn.execute(
|
||||
row = conn.execute(
|
||||
"""
|
||||
UPDATE cafe24_product_schedules
|
||||
SET status = %s,
|
||||
last_error = %s,
|
||||
next_retry_at = %s,
|
||||
retry_count = COALESCE(%s, retry_count),
|
||||
lease_owner = '', lease_token = '', lease_expires_at = NULL,
|
||||
completed_at = CASE WHEN %s IN ('SUCCESS','FAILED','CANCELLED')
|
||||
THEN now() ELSE completed_at END
|
||||
WHERE id = %s
|
||||
WHERE id = %s AND status = 'PROCESSING' AND lease_token = %s
|
||||
RETURNING id
|
||||
""",
|
||||
(
|
||||
store.normalize_schedule_status(status),
|
||||
(error or "")[:1000],
|
||||
next_retry_at,
|
||||
retry_count,
|
||||
store.normalize_schedule_status(status),
|
||||
int(schedule_id),
|
||||
),
|
||||
)
|
||||
(normalized, (error or "")[:1000], next_retry_at, retry_count, normalized,
|
||||
int(schedule_id), token),
|
||||
).fetchone()
|
||||
return row is not None
|
||||
|
||||
def get_schedule(self, schedule_id: int) -> dict[str, Any]:
|
||||
with self._pool.connection() as conn:
|
||||
row = conn.execute(
|
||||
"SELECT * FROM cafe24_product_schedules WHERE id = %s", (int(schedule_id),)
|
||||
).fetchone()
|
||||
return self._serialize(row)
|
||||
|
||||
def review_schedule(
|
||||
self, schedule_id: int, *, status: str, note: str, actor: str, action: str
|
||||
) -> dict[str, Any]:
|
||||
"""확인 필요(NEEDS_REVIEW) 예약을 사람이 확정한다 — SUCCESS / FAILED / PENDING(다시 실행).
|
||||
|
||||
SUCCESS 가 아니면 그 예약의 열린 쓰기 시도(STARTED/UNKNOWN)를 ABANDONED 로 닫는다
|
||||
(반영 안 됨으로 확정 / 재실행으로 대체). SUCCESS 면 호출부가 버전 기록을 채운다.
|
||||
반환: 바뀐 예약 행. NEEDS_REVIEW 가 아니었으면 {}.
|
||||
"""
|
||||
normalized = store.normalize_schedule_status(status)
|
||||
with self._pool.connection() as conn:
|
||||
with conn.transaction():
|
||||
row = conn.execute(
|
||||
"""
|
||||
UPDATE cafe24_product_schedules
|
||||
SET status = %s, last_error = %s,
|
||||
next_retry_at = CASE WHEN %s = 'PENDING' THEN now() ELSE NULL END,
|
||||
completed_at = CASE WHEN %s IN ('SUCCESS','FAILED') THEN now() ELSE NULL END
|
||||
WHERE id = %s AND status = 'NEEDS_REVIEW'
|
||||
RETURNING *
|
||||
""",
|
||||
(normalized, (note or "")[:1000], normalized, normalized, int(schedule_id)),
|
||||
).fetchone()
|
||||
if row is None:
|
||||
return {}
|
||||
if normalized != store.STATUS_SUCCESS:
|
||||
conn.execute(
|
||||
"""
|
||||
UPDATE cafe24_write_attempts
|
||||
SET status = %s, resolved_by = %s
|
||||
WHERE schedule_id = %s AND status = ANY(%s)
|
||||
""",
|
||||
(store.ATTEMPT_ABANDONED, (actor or "")[:200], int(schedule_id),
|
||||
[store.ATTEMPT_STARTED, store.ATTEMPT_UNKNOWN]),
|
||||
)
|
||||
self._insert_audit(
|
||||
conn, actor=actor, action=f"schedule_review:{action}",
|
||||
product_no=row["product_no"], schedule_id=row["id"], result="SUCCESS",
|
||||
detail=note,
|
||||
)
|
||||
return self._serialize(row)
|
||||
|
||||
# ════════════════════════════════════════════════════════════
|
||||
# 직렬화 — datetime → KST ISO, date → ISO (다른 모듈과 동일)
|
||||
|
||||
@@ -13,8 +13,11 @@
|
||||
다른 데이터를 다루지만, 여기는 파일마다 경로만 다르고 나머지는 동일하다).
|
||||
|
||||
쓰기 순서는 상세페이지 적용과 동일한 원칙을 따른다:
|
||||
FTP 에서 현재 내용을 다시 읽는다(로컬 값을 현재값으로 가정하지 않는다)
|
||||
→ BACKUP 버전 저장 → 지문 대조(충돌 시 거부) → FTP 에 쓴다
|
||||
파일별 DB 잠금(writes.write_lock, 'design:{file_key}')
|
||||
→ FTP 에서 현재 내용을 다시 읽는다(로컬 값을 현재값으로 가정하지 않는다)
|
||||
→ BACKUP 버전 저장 → 지문 대조(충돌 시 거부)
|
||||
→ 임시 파일 업로드·검증 → 교체 직전 원본 재확인 → 이름 바꾸기로 교체
|
||||
(design_ftp.write_text_file — 원본에 직접 STOR 하지 않는다)
|
||||
→ MANUAL 버전 + 감사로그
|
||||
|
||||
핸들러는 `async def` 가 아니라 `def`(동기)다 — FTP 호출이 블로킹이므로
|
||||
@@ -24,12 +27,14 @@ FastAPI 스레드풀에서 돌게 둔다(다른 cafe24 라우트와 동일한
|
||||
from __future__ import annotations
|
||||
|
||||
import logging
|
||||
from urllib.parse import quote
|
||||
|
||||
from fastapi import APIRouter, Form, HTTPException, Request
|
||||
from fastapi.responses import HTMLResponse, RedirectResponse
|
||||
|
||||
from app.integrations.cafe24 import (
|
||||
DESIGN_FILE_SPECS,
|
||||
Cafe24FtpConflict,
|
||||
Cafe24FtpError,
|
||||
design_file_label,
|
||||
design_file_path,
|
||||
@@ -38,7 +43,7 @@ from app.integrations.cafe24 import (
|
||||
load_ftp_config,
|
||||
)
|
||||
|
||||
from . import store
|
||||
from . import store, writes
|
||||
from .common import base_ctx, guard
|
||||
from .routes_products import _no_store
|
||||
|
||||
@@ -128,74 +133,76 @@ def design_file_apply(
|
||||
st, user = checked
|
||||
actor = str(user.get("email") or "")
|
||||
back = f"/cafe24/design/{file_key}"
|
||||
action = f"apply_design:{file_key}"
|
||||
|
||||
def go(*, msg: str = "", err: str = "") -> RedirectResponse:
|
||||
key, text = ("err", err) if err else ("msg", msg)
|
||||
return RedirectResponse(url=f"{back}?{key}={quote(text, safe='')}", status_code=303)
|
||||
|
||||
path = design_file_path(file_key)
|
||||
ftp_config = _ftp_config()
|
||||
if not ftp_config.configured:
|
||||
return RedirectResponse(
|
||||
url=f"{back}?err=" + "FTP 설정이 필요합니다: " + ", ".join(ftp_config.missing),
|
||||
status_code=303,
|
||||
)
|
||||
return go(err="FTP 설정이 필요합니다: " + ", ".join(ftp_config.missing))
|
||||
|
||||
# 브라우저 textarea 는 줄바꿈을 CRLF 로 보낸다 — 그대로 저장하면 실제 수정이
|
||||
# 없어도 매번 파일 전체의 줄바꿈이 바뀌어(지문 비교·"변경 없음" 판정이 어긋난다).
|
||||
submitted = content.replace("\r\n", "\n")
|
||||
if not submitted.strip():
|
||||
return RedirectResponse(
|
||||
url=f"{back}?err=" + "내용이 비어 있습니다. 파일을 비우려면 FTP 로 직접 하세요.",
|
||||
status_code=303,
|
||||
)
|
||||
return go(err="내용이 비어 있습니다. 파일을 비우려면 FTP 로 직접 하세요.")
|
||||
|
||||
# 같은 파일을 두 사람이 동시에 적용하지 못하게 파일별 DB 잠금 안에서 한다.
|
||||
try:
|
||||
current = design_ftp.read_text_file(ftp_config, path)
|
||||
except Cafe24FtpError as exc:
|
||||
st.log_audit(
|
||||
actor=actor, action=f"apply_design:{file_key}", result="FAIL",
|
||||
detail=f"현재값 조회 실패: {exc}",
|
||||
)
|
||||
return RedirectResponse(url=f"{back}?err=현재 파일을 읽지 못해 중단했습니다: {exc}", status_code=303)
|
||||
with writes.write_lock(st, writes.design_lock_key(file_key), actor=actor, purpose=f"{file_key} 적용"):
|
||||
try:
|
||||
current = design_ftp.read_text_file(ftp_config, path)
|
||||
except Cafe24FtpError as exc:
|
||||
writes.audit_safe(st, actor=actor, action=action, result="FAIL", detail=f"현재값 조회 실패: {exc}")
|
||||
return go(err=f"현재 파일을 읽지 못해 중단했습니다: {exc}")
|
||||
|
||||
backup_id = st.add_design_revision(
|
||||
file_key=file_key, content=current, revision_type=store.REVISION_BACKUP,
|
||||
memo="적용 직전 자동 백업", created_by=actor,
|
||||
)
|
||||
backup_id = st.add_design_revision(
|
||||
file_key=file_key, content=current, revision_type=store.REVISION_BACKUP,
|
||||
memo="적용 직전 자동 백업", created_by=actor,
|
||||
)
|
||||
|
||||
if base_fingerprint and base_fingerprint != store.fingerprint(current):
|
||||
st.log_audit(
|
||||
actor=actor, action=f"apply_design:{file_key}", revision_id=backup_id,
|
||||
result="FAIL", detail="충돌 — 편집 중 파일이 변경됨",
|
||||
)
|
||||
return RedirectResponse(
|
||||
url=f"{back}?err=편집하는 동안 파일이 변경되었습니다. 새로고침해 현재 내용을 확인한 뒤 다시 적용하세요.",
|
||||
status_code=303,
|
||||
)
|
||||
if base_fingerprint and base_fingerprint != store.fingerprint(current):
|
||||
writes.audit_safe(st, actor=actor, action=action, revision_id=backup_id,
|
||||
result="FAIL", detail="충돌 — 편집 중 파일이 변경됨")
|
||||
return go(err="편집하는 동안 파일이 변경되었습니다. 새로고침해 현재 내용을 확인한 뒤 다시 적용하세요.")
|
||||
|
||||
if submitted == current:
|
||||
return RedirectResponse(url=f"{back}?msg=변경된 내용이 없어 적용하지 않았습니다.", status_code=303)
|
||||
if submitted == current:
|
||||
return go(msg="변경된 내용이 없어 적용하지 않았습니다.")
|
||||
|
||||
try:
|
||||
design_ftp.write_text_file(ftp_config, path, submitted)
|
||||
except Cafe24FtpError as exc:
|
||||
st.log_audit(
|
||||
actor=actor, action=f"apply_design:{file_key}", revision_id=backup_id,
|
||||
result="FAIL", detail=str(exc),
|
||||
)
|
||||
logger.warning("디자인 파일 적용 실패(%s): %s", file_key, exc)
|
||||
return RedirectResponse(
|
||||
url=f"{back}?err=적용에 실패했습니다: {exc} (직전 내용은 버전 {backup_id} 로 보관됨)",
|
||||
status_code=303,
|
||||
)
|
||||
try:
|
||||
# 임시 파일 업로드 → 검증 → 교체 직전 원본 재확인(current 와 같아야) → 이름 바꾸기.
|
||||
design_ftp.write_text_file(ftp_config, path, submitted, expected_current=current)
|
||||
except Cafe24FtpConflict as exc:
|
||||
writes.audit_safe(st, actor=actor, action=action, revision_id=backup_id,
|
||||
result="FAIL", detail=f"충돌 — 교체 직전 파일이 변경됨: {exc}")
|
||||
return go(err=f"{exc} (직전 내용은 버전 {backup_id} 로 보관됨)")
|
||||
except Cafe24FtpError as exc:
|
||||
maybe = bool(getattr(exc, "maybe_applied", False))
|
||||
writes.audit_safe(st, actor=actor, action=action, revision_id=backup_id,
|
||||
result="UNKNOWN" if maybe else "FAIL", detail=str(exc))
|
||||
logger.warning("디자인 파일 적용 실패(%s): %s", file_key, exc)
|
||||
return go(err=f"적용에 실패했습니다: {exc} (직전 내용은 버전 {backup_id} 로 보관됨)")
|
||||
|
||||
revision_id = st.add_design_revision(
|
||||
file_key=file_key, content=submitted, revision_type=store.REVISION_MANUAL,
|
||||
memo=memo, created_by=actor,
|
||||
)
|
||||
st.log_audit(
|
||||
actor=actor, action=f"apply_design:{file_key}", revision_id=revision_id, result="SUCCESS",
|
||||
detail=f"{len(submitted)}자 적용 (백업 {backup_id})",
|
||||
# 파일은 이미 바뀌었다 — 여기서의 기록 실패는 "적용 실패"가 아니다.
|
||||
record_note = ""
|
||||
try:
|
||||
revision_id = st.add_design_revision(
|
||||
file_key=file_key, content=submitted, revision_type=store.REVISION_MANUAL,
|
||||
memo=memo, created_by=actor,
|
||||
)
|
||||
except Exception: # noqa: BLE001
|
||||
logger.exception("디자인 파일(%s) 적용 후 버전 기록 실패", file_key)
|
||||
revision_id = None
|
||||
record_note = " ※ 파일은 적용됐지만 버전 기록 저장에 실패했습니다 — 다시 적용하지 마세요."
|
||||
except (writes.WriteBusy, writes.WriteSetupError) as exc:
|
||||
return go(err=str(exc))
|
||||
|
||||
writes.audit_safe(
|
||||
st, actor=actor, action=action, revision_id=revision_id, result="SUCCESS",
|
||||
detail=f"{len(submitted)}자 적용 (백업 {backup_id}, 임시 파일 교체 방식)" + (" / 버전 기록 실패" if record_note else ""),
|
||||
)
|
||||
logger.info("디자인 파일 적용(%s) (%s)", file_key, actor)
|
||||
return RedirectResponse(
|
||||
url=f"{back}?msg=적용했습니다. 직전 내용은 버전 {backup_id} 로 보관됩니다.",
|
||||
status_code=303,
|
||||
)
|
||||
return go(msg=f"적용했습니다. 직전 내용은 버전 {backup_id} 로 보관됩니다.{record_note}")
|
||||
|
||||
@@ -9,15 +9,20 @@
|
||||
PUT /products/{no}/options 옵션명 · 옵션값 이름/이미지/표시방식 수정
|
||||
DELETE /products/{no}/options 옵션 삭제 (품목도 함께 삭제 — 확인 후)
|
||||
POST /products/{no}/options/image 옵션값 썸네일 업로드만 (경로 반환)
|
||||
PUT /products/{no}/variants 품목 자체코드 · 추가금액 · 진열 · 판매
|
||||
PUT /products/{no}/variants 품목 자체코드 · 추가금액 · 진열 · 판매 (행별 결과)
|
||||
|
||||
공통 규칙
|
||||
- 카페24 호출은 `app.integrations.cafe24` 만 통한다(httpx 직접 호출 금지).
|
||||
- 쓰기는 상품별 DB 잠금(writes.write_lock) 안에서 한다 — 같은 상품을 웹 여러
|
||||
프로세스·예약 worker 가 동시에 쓰지 않게. 못 잡으면 409.
|
||||
- 쓰기 전에 현재값을 읽되, **읽기 지연을 보정한 유효 현재값**과 비교해 바뀐
|
||||
것만 보낸다(routes_products.load_product). 이걸 안 하면 "A→B 로 바꾼 직후
|
||||
다시 B→A" 가 카페24의 예전 값(A)과 같다고 판단돼 무시된다.
|
||||
- PUT 응답이 곧 현재값이다. 응답을 스냅샷(`save_write_snapshot`)에 남기고 화면도
|
||||
응답으로 그린다 — 다시 GET 하지 않는다(GET 은 한동안 예전 값을 돌려준다).
|
||||
PUT 이 성공한 뒤의 기록 실패는 쓰기 실패로 알리지 않는다(재전송을 부르지 않게).
|
||||
- 품목은 **품목코드**(안정 식별자)로 짝짓는다. 옵션값 이름을 바꾼 직후 GET 품목이
|
||||
예전 이름을 돌려줘도 스냅샷의 품목코드별 표기로 바로잡는다(store.apply_variant_patch).
|
||||
- 모든 쓰기는 감사로그(`cafe24_audit_logs`)에 남긴다.
|
||||
"""
|
||||
|
||||
@@ -31,9 +36,9 @@ from fastapi import APIRouter, Body, File, HTTPException, Request, UploadFile
|
||||
from app.integrations.cafe24 import Cafe24Error, build_cafe24_api, products
|
||||
from app.timezone import now_kst
|
||||
|
||||
from . import store
|
||||
from . import store, writes
|
||||
from .common import read_lag_grace_minutes, require_store
|
||||
from .routes_products import load_product, remember_write
|
||||
from .routes_products import load_product, locked_json, remember_write
|
||||
|
||||
logger = logging.getLogger("cafe24.product_info")
|
||||
|
||||
@@ -110,39 +115,40 @@ def product_basic(
|
||||
raise HTTPException(status_code=400, detail="바꿀 항목이 없습니다.")
|
||||
|
||||
api = build_cafe24_api(st)
|
||||
try:
|
||||
current, _ = load_product(st, api, product_no)
|
||||
except Cafe24Error as exc:
|
||||
st.log_audit(actor=actor, action="update_basic", product_no=product_no,
|
||||
result="FAIL", detail=f"현재값 조회 실패: {exc}")
|
||||
raise _http_from_cafe24(exc) from exc
|
||||
if not current:
|
||||
raise HTTPException(status_code=404, detail="카페24에서 상품을 찾지 못했습니다.")
|
||||
with locked_json(st, product_no, actor=actor, purpose="상품명·가격 변경"):
|
||||
try:
|
||||
current, _ = load_product(st, api, product_no)
|
||||
except Cafe24Error as exc:
|
||||
writes.audit_safe(st, actor=actor, action="update_basic", product_no=product_no,
|
||||
result="FAIL", detail=f"현재값 조회 실패: {exc}")
|
||||
raise _http_from_cafe24(exc) from exc
|
||||
if not current:
|
||||
raise HTTPException(status_code=404, detail="카페24에서 상품을 찾지 못했습니다.")
|
||||
|
||||
changes: dict[str, str] = {}
|
||||
before: dict[str, str] = {}
|
||||
for key, value in want.items():
|
||||
old = str(current.get(key) or "")
|
||||
same = old == value if key == "product_name" else store.price_equal(old, value)
|
||||
if not same:
|
||||
changes[key] = value
|
||||
before[key] = old
|
||||
if not changes:
|
||||
return {"ok": True, "changed": [], "product": _scalar_view(current)}
|
||||
changes: dict[str, str] = {}
|
||||
before: dict[str, str] = {}
|
||||
for key, value in want.items():
|
||||
old = str(current.get(key) or "")
|
||||
same = old == value if key == "product_name" else store.price_equal(old, value)
|
||||
if not same:
|
||||
changes[key] = value
|
||||
before[key] = old
|
||||
if not changes:
|
||||
return {"ok": True, "changed": [], "product": _scalar_view(current)}
|
||||
|
||||
try:
|
||||
updated = products.update_product(api.client, product_no, **changes)
|
||||
except Cafe24Error as exc:
|
||||
st.log_audit(actor=actor, action="update_basic", product_no=product_no,
|
||||
result="FAIL", detail=f"{changes} 실패: {exc}")
|
||||
logger.warning("카페24 상품 %s 기본정보 변경 실패: %s", product_no, exc)
|
||||
raise _http_from_cafe24(exc) from exc
|
||||
try:
|
||||
updated = products.update_product(api.client, product_no, **changes)
|
||||
except Cafe24Error as exc:
|
||||
writes.audit_safe(st, actor=actor, action="update_basic", product_no=product_no,
|
||||
result="FAIL", detail=f"{changes} 실패: {exc}")
|
||||
logger.warning("카페24 상품 %s 기본정보 변경 실패: %s", product_no, exc)
|
||||
raise _http_from_cafe24(exc) from exc
|
||||
|
||||
remember_write(st, product_no, updated if isinstance(updated, dict) else {})
|
||||
remember_write(st, product_no, updated if isinstance(updated, dict) else {})
|
||||
merged = {**current, **(updated if isinstance(updated, dict) else {}), **changes}
|
||||
detail = ", ".join(f"{k}: '{before[k]}' → '{v}'" for k, v in changes.items())
|
||||
st.log_audit(actor=actor, action="update_basic", product_no=product_no,
|
||||
result="SUCCESS", detail=detail)
|
||||
writes.audit_safe(st, actor=actor, action="update_basic", product_no=product_no,
|
||||
result="SUCCESS", detail=detail)
|
||||
logger.info("카페24 상품 %s 기본정보 변경 (%s): %s", product_no, actor, detail)
|
||||
return {"ok": True, "changed": list(changes.keys()), "product": _scalar_view(merged)}
|
||||
|
||||
@@ -169,30 +175,31 @@ def product_image(
|
||||
data = _read_image(file)
|
||||
|
||||
api = build_cafe24_api(st)
|
||||
try:
|
||||
current, _ = load_product(st, api, product_no)
|
||||
except Cafe24Error as exc:
|
||||
raise _http_from_cafe24(exc) from exc
|
||||
if not current:
|
||||
raise HTTPException(status_code=404, detail="카페24에서 상품을 찾지 못했습니다.")
|
||||
before = str(current.get("detail_image") or "")
|
||||
with locked_json(st, product_no, actor=actor, purpose="대표 이미지 교체"):
|
||||
try:
|
||||
current, _ = load_product(st, api, product_no)
|
||||
except Cafe24Error as exc:
|
||||
raise _http_from_cafe24(exc) from exc
|
||||
if not current:
|
||||
raise HTTPException(status_code=404, detail="카페24에서 상품을 찾지 못했습니다.")
|
||||
before = str(current.get("detail_image") or "")
|
||||
|
||||
try:
|
||||
images = products.set_main_image(
|
||||
api.client, product_no, data, content_type=(file.content_type or "").lower()
|
||||
)
|
||||
if not images.get("detail_image"):
|
||||
raise Cafe24Error("카페24가 등록된 이미지 경로를 돌려주지 않았습니다.")
|
||||
except Cafe24Error as exc:
|
||||
st.log_audit(actor=actor, action="set_main_image", product_no=product_no,
|
||||
result="FAIL", detail=f"등록 실패: {exc}")
|
||||
logger.warning("카페24 상품 %s 대표이미지 변경 실패: %s", product_no, exc)
|
||||
raise _http_from_cafe24(exc) from exc
|
||||
try:
|
||||
images = products.set_main_image(
|
||||
api.client, product_no, data, content_type=(file.content_type or "").lower()
|
||||
)
|
||||
if not images.get("detail_image"):
|
||||
raise Cafe24Error("카페24가 등록된 이미지 경로를 돌려주지 않았습니다.")
|
||||
except Cafe24Error as exc:
|
||||
writes.audit_safe(st, actor=actor, action="set_main_image", product_no=product_no,
|
||||
result="FAIL", detail=f"등록 실패: {exc}")
|
||||
logger.warning("카페24 상품 %s 대표이미지 변경 실패: %s", product_no, exc)
|
||||
raise _http_from_cafe24(exc) from exc
|
||||
|
||||
merged = {**current, **images, "updated_date": now_kst().isoformat(timespec="seconds")}
|
||||
remember_write(st, product_no, merged)
|
||||
st.log_audit(actor=actor, action="set_main_image", product_no=product_no,
|
||||
result="SUCCESS", detail=f"'{before}' → '{images['detail_image']}'")
|
||||
merged = {**current, **images, "updated_date": now_kst().isoformat(timespec="seconds")}
|
||||
remember_write(st, product_no, merged)
|
||||
writes.audit_safe(st, actor=actor, action="set_main_image", product_no=product_no,
|
||||
result="SUCCESS", detail=f"'{before}' → '{images['detail_image']}'")
|
||||
logger.info("카페24 상품 %s 대표이미지 변경 (%s)", product_no, actor)
|
||||
return {"ok": True, "product": _scalar_view(merged)}
|
||||
|
||||
@@ -208,6 +215,8 @@ def _variant_view(v: dict[str, Any]) -> dict[str, Any]:
|
||||
{"name": str(o.get("name") or ""), "value": str(o.get("value") or "")}
|
||||
for o in opts if isinstance(o, dict)
|
||||
],
|
||||
# 첫 옵션의 옵션값 번호(value_no) — 화면이 이름보다 먼저 이것으로 옵션값과 짝짓는다.
|
||||
"value_no": v.get("value_no"),
|
||||
"custom_variant_code": str(v.get("custom_variant_code") or ""),
|
||||
"additional_amount": str(v.get("additional_amount") or "0.00"),
|
||||
"display": products._flag(v.get("display")), # noqa: SLF001
|
||||
@@ -238,6 +247,7 @@ def _options_view(option: dict[str, Any]) -> dict[str, Any]:
|
||||
"option_link_image": str(v.get("option_link_image") or ""),
|
||||
"option_color": str(v.get("option_color") or ""),
|
||||
"value_no": v.get("value_no"),
|
||||
"pending": bool(v.get("pending")),
|
||||
}
|
||||
for v in values if isinstance(v, dict)
|
||||
],
|
||||
@@ -252,43 +262,125 @@ def _options_view(option: dict[str, Any]) -> dict[str, Any]:
|
||||
}
|
||||
|
||||
|
||||
def _apply_variant_snapshot(st: Any, product_no: int, variants: list[dict[str, Any]]) -> list[dict[str, Any]]:
|
||||
"""GET 품목 목록에 유예시간 안의 우리 쓰기(스냅샷)를 덮어씌운다.
|
||||
def _snapshot_sections(st: Any, product_no: int) -> tuple[dict[str, Any], dict[str, Any]]:
|
||||
"""(옵션 섹션, 품목 섹션) — 각각 {"data":…, "written_at":…} 또는 {}."""
|
||||
snap = st.get_write_snapshot(product_no) or {}
|
||||
return snap.get("options") or {}, snap.get("variants") or {}
|
||||
|
||||
삭제한 품목(`{"_deleted": true}`)은 카페24 GET 이 한동안 계속 돌려주므로 걸러낸다.
|
||||
"""
|
||||
section = (st.get_write_snapshot(product_no) or {}).get("variants") or {}
|
||||
|
||||
def _within(written_at: object) -> bool:
|
||||
return store.within_grace(written_at, grace_minutes=read_lag_grace_minutes())
|
||||
|
||||
|
||||
def _patch_variants(section: dict[str, Any], variants: list[dict[str, Any]]) -> list[dict[str, Any]]:
|
||||
"""GET 품목 목록에 품목코드별 쓰기 기록을 덮어씌운다(삭제한 품목은 뺀다)."""
|
||||
data = section.get("data") or {}
|
||||
if not data or not store.within_grace(section.get("written_at"), grace_minutes=read_lag_grace_minutes()):
|
||||
return variants
|
||||
if not isinstance(data, dict) or not data:
|
||||
return list(variants)
|
||||
out = []
|
||||
for v in variants:
|
||||
code = str(v.get("variant_code") or "")
|
||||
patch = data.get(code)
|
||||
if isinstance(patch, dict) and patch.get("_deleted"):
|
||||
continue
|
||||
out.append({**v, **patch} if isinstance(patch, dict) else v)
|
||||
patched = store.apply_variant_patch(
|
||||
v, data.get(str(v.get("variant_code") or "")),
|
||||
section_written_at=section.get("written_at"), grace_minutes=read_lag_grace_minutes(),
|
||||
)
|
||||
if patched is not None:
|
||||
out.append(patched)
|
||||
return out
|
||||
|
||||
|
||||
def _apply_options_snapshot(st: Any, product_no: int, option: dict[str, Any]) -> dict[str, Any]:
|
||||
"""GET 옵션이 우리 마지막 쓰기와 다르고 유예시간 안이면 스냅샷(우리 쓰기)을 쓴다."""
|
||||
section = (st.get_write_snapshot(product_no) or {}).get("options") or {}
|
||||
data = section.get("data")
|
||||
if not isinstance(data, dict) or not store.within_grace(
|
||||
section.get("written_at"), grace_minutes=read_lag_grace_minutes()
|
||||
):
|
||||
return option
|
||||
return data
|
||||
def _annotate(option: dict[str, Any], variants: list[dict[str, Any]], recent: list[str]) -> tuple[dict, list]:
|
||||
"""옵션 1개 상품: 품목에 첫 옵션값 번호(value_no)를, 품목이 아직 안 보이는 최근 추가
|
||||
옵션값에 pending 표시를 붙인다(화면이 "품목 없는 옵션값"으로 오해하지 않게)."""
|
||||
groups = option.get("options") if isinstance(option.get("options"), list) else []
|
||||
if len(groups) != 1 or not isinstance(groups[0], dict):
|
||||
return option, variants
|
||||
values = [v for v in (groups[0].get("option_value") or []) if isinstance(v, dict)]
|
||||
by_text = {str(v.get("option_text") or ""): v.get("value_no") for v in values}
|
||||
used: set[str] = set()
|
||||
out_variants = []
|
||||
for v in variants:
|
||||
opts = v.get("options") if isinstance(v.get("options"), list) else []
|
||||
first = str(opts[0].get("value") or "") if opts and isinstance(opts[0], dict) else ""
|
||||
used.add(first)
|
||||
out_variants.append({**v, "value_no": by_text.get(first)} if first in by_text else v)
|
||||
recent_set = set(recent or [])
|
||||
new_values = [
|
||||
{**v, "pending": True} if str(v.get("option_text") or "") in recent_set
|
||||
and str(v.get("option_text") or "") not in used else v
|
||||
for v in values
|
||||
]
|
||||
return {**option, "options": [{**groups[0], "option_value": new_values}]}, out_variants
|
||||
|
||||
|
||||
def _load_options_and_variants(st: Any, api: Any, product_no: int) -> dict[str, Any]:
|
||||
option = _apply_options_snapshot(st, product_no, products.get_options(api.client, product_no))
|
||||
view = _options_view(option)
|
||||
raw_option = products.get_options(api.client, product_no)
|
||||
osec, vsec = _snapshot_sections(st, product_no)
|
||||
option, _stale = store.overlay_options(
|
||||
raw_option, snapshot=osec.get("data"), written_at=osec.get("written_at"),
|
||||
grace_minutes=read_lag_grace_minutes(),
|
||||
)
|
||||
raw_variants: list[dict[str, Any]] = []
|
||||
variants: list[dict[str, Any]] = []
|
||||
if view["has_option"]:
|
||||
variants = _apply_variant_snapshot(st, product_no, products.list_variants(api.client, product_no))
|
||||
return {"option": view, "variants": [_variant_view(v) for v in variants], "raw_options": option}
|
||||
if products._flag(option.get("has_option"), default=False): # noqa: SLF001
|
||||
raw_variants = products.list_variants(api.client, product_no)
|
||||
variants = _patch_variants(vsec, raw_variants)
|
||||
recent = _recent_values(osec)
|
||||
shown_option, shown_variants = _annotate(option, variants, recent)
|
||||
return {
|
||||
"option": _options_view(shown_option),
|
||||
"variants": [_variant_view(v) for v in shown_variants],
|
||||
"raw_option": raw_option,
|
||||
"effective_option": option,
|
||||
"raw_variants": raw_variants,
|
||||
"effective_variants": variants,
|
||||
"options_section": osec,
|
||||
"variants_section": vsec,
|
||||
}
|
||||
|
||||
|
||||
def _recent_values(osec: dict[str, Any]) -> list[str]:
|
||||
data = osec.get("data") if isinstance(osec.get("data"), dict) else {}
|
||||
if not data or not _within(osec.get("written_at")):
|
||||
return []
|
||||
return [str(v) for v in (data.get("_recent_values") or [])]
|
||||
|
||||
|
||||
def _prior_signatures(osec: dict[str, Any]) -> list[str]:
|
||||
data = osec.get("data") if isinstance(osec.get("data"), dict) else {}
|
||||
if not data or not _within(osec.get("written_at")):
|
||||
return []
|
||||
return [str(s) for s in (data.get("_before_signatures") or []) if isinstance(s, str)]
|
||||
|
||||
|
||||
def _unique(items: list[Any]) -> list[Any]:
|
||||
out: list[Any] = []
|
||||
for item in items:
|
||||
if item not in out:
|
||||
out.append(item)
|
||||
return out
|
||||
|
||||
|
||||
def _options_snapshot(
|
||||
written: dict[str, Any], *, befores: list[dict[str, Any]], osec: dict[str, Any], recent: list[str]
|
||||
) -> dict[str, Any]:
|
||||
"""옵션 스냅샷 = 카페24 응답 + 쓰기 직전 모양들의 서명 + 최근 추가한 옵션값."""
|
||||
signatures = _unique(_prior_signatures(osec) + [store.options_signature(b) for b in befores if b])
|
||||
texts = {
|
||||
str(v.get("option_text") or "")
|
||||
for o in (written.get("options") or []) if isinstance(o, dict)
|
||||
for v in (o.get("option_value") or []) if isinstance(v, dict)
|
||||
}
|
||||
keep = [t for t in _unique(_recent_values(osec) + list(recent)) if t in texts]
|
||||
return {**written, "_before_signatures": signatures, "_recent_values": keep}
|
||||
|
||||
|
||||
def _save_snapshot_safe(st: Any, product_no: int, section: str, data: Any, **kw: Any) -> str:
|
||||
try:
|
||||
st.save_write_snapshot(product_no, section, data, **kw)
|
||||
except Exception as exc: # noqa: BLE001 — 카페24에는 이미 반영됐다
|
||||
logger.exception("상품 %s %s 스냅샷 저장 실패", product_no, section)
|
||||
return f"{type(exc).__name__}: {exc}"
|
||||
return ""
|
||||
|
||||
|
||||
@product_info_router.get("/products/{product_no}/options")
|
||||
@@ -322,29 +414,40 @@ def options_create(
|
||||
)
|
||||
except ValueError as exc:
|
||||
raise HTTPException(status_code=400, detail=str(exc)) from exc
|
||||
values = [v["option_text"] for v in body["options"][0]["option_value"]]
|
||||
|
||||
api = build_cafe24_api(st)
|
||||
try:
|
||||
existing = products.get_options(api.client, product_no)
|
||||
if products._flag(existing.get("has_option"), default=False): # noqa: SLF001
|
||||
raise HTTPException(status_code=409, detail="이미 옵션이 있는 상품입니다. 수정하거나 삭제한 뒤 다시 만드세요.")
|
||||
created = products.create_options(api.client, product_no, body)
|
||||
except Cafe24Error as exc:
|
||||
st.log_audit(actor=actor, action="create_options", product_no=product_no,
|
||||
result="FAIL", detail=f"{body['options'][0]['option_name']} 실패: {exc}")
|
||||
raise _http_from_cafe24(exc) from exc
|
||||
with locked_json(st, product_no, actor=actor, purpose="옵션 생성"):
|
||||
try:
|
||||
existing = products.get_options(api.client, product_no)
|
||||
if products._flag(existing.get("has_option"), default=False): # noqa: SLF001
|
||||
raise HTTPException(status_code=409, detail="이미 옵션이 있는 상품입니다. 수정하거나 삭제한 뒤 다시 만드세요.")
|
||||
created = products.create_options(api.client, product_no, body)
|
||||
except Cafe24Error as exc:
|
||||
writes.audit_safe(st, actor=actor, action="create_options", product_no=product_no,
|
||||
result="FAIL", detail=f"{body['options'][0]['option_name']} 실패: {exc}")
|
||||
raise _http_from_cafe24(exc) from exc
|
||||
|
||||
st.save_write_snapshot(product_no, "options", created)
|
||||
values = [v["option_text"] for v in body["options"][0]["option_value"]]
|
||||
st.log_audit(actor=actor, action="create_options", product_no=product_no, result="SUCCESS",
|
||||
detail=f"옵션 '{body['options'][0]['option_name']}' 생성: {', '.join(values)}")
|
||||
osec, _vsec = _snapshot_sections(st, product_no)
|
||||
record_error = _save_snapshot_safe(
|
||||
st, product_no, "options",
|
||||
_options_snapshot(created, befores=[existing], osec=osec, recent=values),
|
||||
)
|
||||
# 새 옵션의 품목은 새 품목코드다 — 이전 품목 기록은 모두 버린다(전체 초기화).
|
||||
record_error = record_error or _save_snapshot_safe(st, product_no, "variants", {}, replace=True)
|
||||
# 카페24가 자동 생성한 품목(코드 부여)을 바로 돌려준다 — 읽기 지연이 있어 짧게 재시도.
|
||||
# 화면은 이 코드로 자체코드·추가금액을 이어서 PUT 한다. 다 안 보이면 pending 으로 표시.
|
||||
variants = products.wait_for_variants(api.client, product_no, len(values))
|
||||
writes.audit_safe(st, actor=actor, action="create_options", product_no=product_no, result="SUCCESS",
|
||||
detail=f"옵션 '{body['options'][0]['option_name']}' 생성: {', '.join(values)}")
|
||||
logger.info("카페24 상품 %s 옵션 생성 (%s)", product_no, actor)
|
||||
# 카페24가 자동 생성한 품목(코드 부여)을 바로 돌려준다 — 읽기 지연이 있어 짧게 재시도.
|
||||
# 화면은 이 코드로 자체코드·추가금액을 이어서 PUT 한다.
|
||||
variants = products.wait_for_variants(api.client, product_no, len(values))
|
||||
if len(variants) < len(values):
|
||||
logger.warning("카페24 상품 %s 옵션 생성 후 품목 %s/%s 건만 조회됨", product_no, len(variants), len(values))
|
||||
return {"ok": True, "option": _options_view(created), "variants": [_variant_view(v) for v in variants]}
|
||||
shown_option, shown_variants = _annotate(created, variants, values)
|
||||
return {"ok": True, "option": _options_view(shown_option),
|
||||
"variants": [_variant_view(v) for v in shown_variants],
|
||||
"missing_variants": max(0, len(values) - len(variants)),
|
||||
"record_warning": record_error}
|
||||
|
||||
|
||||
@product_info_router.put("/products/{product_no}/options")
|
||||
@@ -358,6 +461,8 @@ def options_update(
|
||||
카페24 PUT 은 `original_options`(수정 전)와 `options`(수정 후)를 짝지어 받는다.
|
||||
수정 전 값은 화면이 들고 있던 것이 아니라 **지금 카페24에서 다시 읽은 값**(읽기
|
||||
지연 보정 후)을 쓴다 — 그래야 다른 곳에서 바뀐 이름과 어긋나지 않는다.
|
||||
이름을 바꾸면 품목코드별로 새 표기를 스냅샷에 남긴다(GET 품목이 예전 이름을
|
||||
돌려주는 동안에도 품목이 옵션값과 제대로 짝지어 보이게).
|
||||
"""
|
||||
st, user = require_store(request)
|
||||
actor = str(user.get("email") or "")
|
||||
@@ -366,64 +471,99 @@ def options_update(
|
||||
raise HTTPException(status_code=400, detail="옵션 목록이 비어 있습니다.")
|
||||
|
||||
api = build_cafe24_api(st)
|
||||
try:
|
||||
loaded = _load_options_and_variants(st, api, product_no)
|
||||
except Cafe24Error as exc:
|
||||
raise _http_from_cafe24(exc) from exc
|
||||
if not loaded["option"]["has_option"]:
|
||||
raise HTTPException(status_code=409, detail="옵션이 없는 상품입니다. 먼저 옵션을 만드세요.")
|
||||
original = loaded["option"]["options"]
|
||||
try:
|
||||
body = store.build_update_options_request(
|
||||
original, edited, option_list_type=str(payload.get("option_list_type") or ""),
|
||||
allow_append=True,
|
||||
with locked_json(st, product_no, actor=actor, purpose="옵션 수정"):
|
||||
try:
|
||||
loaded = _load_options_and_variants(st, api, product_no)
|
||||
except Cafe24Error as exc:
|
||||
raise _http_from_cafe24(exc) from exc
|
||||
if not loaded["option"]["has_option"]:
|
||||
raise HTTPException(status_code=409, detail="옵션이 없는 상품입니다. 먼저 옵션을 만드세요.")
|
||||
original = loaded["option"]["options"]
|
||||
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)
|
||||
except Cafe24Error as exc:
|
||||
writes.audit_safe(st, actor=actor, action="update_options", product_no=product_no,
|
||||
result="FAIL", detail=str(exc))
|
||||
logger.warning("카페24 상품 %s 옵션 수정 실패: %s", product_no, exc)
|
||||
raise _http_from_cafe24(exc) from exc
|
||||
|
||||
# ── 여기부터는 카페24에 반영된 뒤 — 기록 실패는 경고로만 알린다 ──
|
||||
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),
|
||||
)
|
||||
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 = sum(
|
||||
max(0, len(n["option_value"]) - len(o["option_value"]))
|
||||
for o, n in zip(body["original_options"], body["options"])
|
||||
)
|
||||
# 이름 바꾸기 표(수정 전 → 수정 후) — 위치로 짝지어진다(build_update_options_request).
|
||||
rename: dict[tuple[str, str], tuple[str, str]] = {}
|
||||
for o, n in zip(original, body["options"]):
|
||||
for ov, nv in zip(o["option_value"], n["option_value"]):
|
||||
rename[(o["option_name"], ov["option_text"])] = (n["option_name"], nv["option_text"])
|
||||
raw_labels = {str(v.get("variant_code") or ""): v.get("options") for v in loaded["raw_variants"]}
|
||||
previous = (loaded["variants_section"].get("data") or {}) if _within(
|
||||
loaded["variants_section"].get("written_at")) else {}
|
||||
label_patch: dict[str, Any] = {}
|
||||
renamed_variants: list[dict[str, Any]] = []
|
||||
for v in loaded["effective_variants"]:
|
||||
code = str(v.get("variant_code") or "")
|
||||
current = store.labels_as_json(v.get("options"))
|
||||
new = [
|
||||
dict(zip(("name", "value"), rename.get((o["name"], o["value"]), (o["name"], o["value"]))))
|
||||
for o in current
|
||||
]
|
||||
renamed_variants.append({**v, "options": new})
|
||||
if new != current and code:
|
||||
prior = previous.get(code) if isinstance(previous.get(code), dict) else {}
|
||||
history = [
|
||||
[{"name": a, "value": b} for a, b in labels]
|
||||
for labels in store.label_history(prior.get("_options_before"))
|
||||
]
|
||||
befores = _unique(history + [current, store.labels_as_json(raw_labels.get(code))])
|
||||
label_patch[code] = {"options": new, "_options_before": [b for b in befores if b != new]}
|
||||
if label_patch:
|
||||
record_error = record_error or _save_snapshot_safe(st, product_no, "variants", label_patch)
|
||||
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 "")
|
||||
|
||||
try:
|
||||
updated = products.update_options(api.client, product_no, body)
|
||||
except Cafe24Error as exc:
|
||||
st.log_audit(actor=actor, action="update_options", product_no=product_no,
|
||||
result="FAIL", detail=str(exc))
|
||||
logger.warning("카페24 상품 %s 옵션 수정 실패: %s", product_no, exc)
|
||||
raise _http_from_cafe24(exc) from exc
|
||||
|
||||
st.save_write_snapshot(product_no, "options", updated)
|
||||
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 "")
|
||||
st.log_audit(actor=actor, action="update_options", product_no=product_no,
|
||||
result="SUCCESS", detail=summary[:900])
|
||||
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:
|
||||
# 새 옵션값의 품목코드를 받아 돌려준다 — 화면이 자체코드/추가금액을 이어서 PUT 한다.
|
||||
fresh = products.wait_for_variants(api.client, product_no, len(loaded["variants"]) + added)
|
||||
fresh = _apply_variant_snapshot(st, product_no, fresh)
|
||||
return {"ok": True, "option": _options_view(updated), "variants": [_variant_view(v) for v in fresh],
|
||||
"added": added}
|
||||
|
||||
# 품목의 옵션값 표기는 이름을 바꾼 만큼 달라진다 — 응답값으로 다시 맞춘다.
|
||||
variants = loaded["variants"]
|
||||
rename: dict[tuple[str, str], tuple[str, str]] = {}
|
||||
for o, n in zip(original, body["options"]):
|
||||
for ov, nv in zip(o["option_value"], n["option_value"]):
|
||||
rename[(o["option_name"], ov["option_text"])] = (n["option_name"], nv["option_text"])
|
||||
for v in variants:
|
||||
v["options"] = [
|
||||
dict(zip(("name", "value"), rename.get((opt["name"], opt["value"]), (opt["name"], opt["value"]))))
|
||||
for opt in v["options"]
|
||||
]
|
||||
return {"ok": True, "option": _options_view(updated), "variants": variants}
|
||||
out["added"] = added
|
||||
return out
|
||||
|
||||
|
||||
@product_info_router.delete("/products/{product_no}/options")
|
||||
@@ -432,22 +572,29 @@ def options_delete(request: Request, product_no: int) -> dict[str, Any]:
|
||||
st, user = require_store(request)
|
||||
actor = str(user.get("email") or "")
|
||||
api = build_cafe24_api(st)
|
||||
try:
|
||||
before = products.get_options(api.client, product_no)
|
||||
products.delete_options(api.client, product_no)
|
||||
except Cafe24Error as exc:
|
||||
st.log_audit(actor=actor, action="delete_options", product_no=product_no,
|
||||
result="FAIL", detail=str(exc))
|
||||
raise _http_from_cafe24(exc) from exc
|
||||
names = ", ".join(
|
||||
str(o.get("option_name") or "") for o in (before.get("options") or []) if isinstance(o, dict)
|
||||
)
|
||||
st.save_write_snapshot(product_no, "options", {"has_option": "F", "options": []})
|
||||
st.save_write_snapshot(product_no, "variants", {})
|
||||
st.log_audit(actor=actor, action="delete_options", product_no=product_no,
|
||||
result="SUCCESS", detail=f"삭제된 옵션: {names or '(없음)'}")
|
||||
with locked_json(st, product_no, actor=actor, purpose="옵션 삭제"):
|
||||
try:
|
||||
before = products.get_options(api.client, product_no)
|
||||
products.delete_options(api.client, product_no)
|
||||
except Cafe24Error as exc:
|
||||
writes.audit_safe(st, actor=actor, action="delete_options", product_no=product_no,
|
||||
result="FAIL", detail=str(exc))
|
||||
raise _http_from_cafe24(exc) from exc
|
||||
names = ", ".join(
|
||||
str(o.get("option_name") or "") for o in (before.get("options") or []) if isinstance(o, dict)
|
||||
)
|
||||
osec, _vsec = _snapshot_sections(st, product_no)
|
||||
record_error = _save_snapshot_safe(
|
||||
st, product_no, "options",
|
||||
_options_snapshot({"has_option": "F", "options": []}, befores=[before], osec=osec, recent=[]),
|
||||
)
|
||||
# 품목 전체 초기화 — 빈 dict 병합(=변경 없음)이 아니라 명시적 replace.
|
||||
record_error = record_error or _save_snapshot_safe(st, product_no, "variants", {}, replace=True)
|
||||
writes.audit_safe(st, actor=actor, action="delete_options", product_no=product_no,
|
||||
result="SUCCESS", detail=f"삭제된 옵션: {names or '(없음)'}")
|
||||
logger.info("카페24 상품 %s 옵션 삭제 (%s)", product_no, actor)
|
||||
return {"ok": True, "option": _options_view({"has_option": "F"}), "variants": []}
|
||||
return {"ok": True, "option": _options_view({"has_option": "F"}), "variants": [],
|
||||
"record_warning": record_error}
|
||||
|
||||
|
||||
@product_info_router.post("/products/{product_no}/options/image")
|
||||
@@ -464,13 +611,13 @@ def option_image_upload(
|
||||
try:
|
||||
path = products.upload_image_bytes(api.client, data)
|
||||
except Cafe24Error as exc:
|
||||
st.log_audit(actor=actor, action="upload_option_image", product_no=product_no,
|
||||
result="FAIL", detail=str(exc))
|
||||
writes.audit_safe(st, actor=actor, action="upload_option_image", product_no=product_no,
|
||||
result="FAIL", detail=str(exc))
|
||||
raise _http_from_cafe24(exc) from exc
|
||||
if not path:
|
||||
raise HTTPException(status_code=502, detail="카페24가 업로드 경로를 돌려주지 않았습니다.")
|
||||
st.log_audit(actor=actor, action="upload_option_image", product_no=product_no,
|
||||
result="SUCCESS", detail=path)
|
||||
writes.audit_safe(st, actor=actor, action="upload_option_image", product_no=product_no,
|
||||
result="SUCCESS", detail=path)
|
||||
return {"ok": True, "path": path}
|
||||
|
||||
|
||||
@@ -483,18 +630,20 @@ def variant_delete(request: Request, product_no: int, variant_code: str) -> dict
|
||||
if not store.VARIANT_CODE_RE.match(code):
|
||||
raise HTTPException(status_code=400, detail=f"품목코드 형식이 올바르지 않습니다: {code}")
|
||||
api = build_cafe24_api(st)
|
||||
try:
|
||||
products.delete_variant(api.client, product_no, code)
|
||||
except Cafe24Error as exc:
|
||||
st.log_audit(actor=actor, action="delete_variant", product_no=product_no,
|
||||
result="FAIL", detail=f"{code}: {exc}")
|
||||
raise _http_from_cafe24(exc) from exc
|
||||
# 카페24 GET 은 한동안 삭제된 품목을 계속 돌려준다 — 스냅샷에 삭제 표식을 남겨 걸러낸다.
|
||||
st.save_write_snapshot(product_no, "variants", {code: {"_deleted": True}})
|
||||
st.log_audit(actor=actor, action="delete_variant", product_no=product_no,
|
||||
result="SUCCESS", detail=code)
|
||||
with locked_json(st, product_no, actor=actor, purpose="품목 삭제"):
|
||||
try:
|
||||
products.delete_variant(api.client, product_no, code)
|
||||
except Cafe24Error as exc:
|
||||
writes.audit_safe(st, actor=actor, action="delete_variant", product_no=product_no,
|
||||
result="FAIL", detail=f"{code}: {exc}")
|
||||
raise _http_from_cafe24(exc) from exc
|
||||
# 카페24 GET 은 한동안 삭제된 품목을 계속 돌려준다 — 삭제 표식을 남겨 걸러낸다.
|
||||
# 표식은 이후 늦게 도착한 수정이 있어도 유지된다(store.merge_variant_snapshot).
|
||||
record_error = _save_snapshot_safe(st, product_no, "variants", {code: {"_deleted": True}})
|
||||
writes.audit_safe(st, actor=actor, action="delete_variant", product_no=product_no,
|
||||
result="SUCCESS", detail=code)
|
||||
logger.info("카페24 상품 %s 품목 %s 삭제 (%s)", product_no, code, actor)
|
||||
return {"ok": True, "variant_code": code}
|
||||
return {"ok": True, "variant_code": code, "record_warning": record_error}
|
||||
|
||||
|
||||
@product_info_router.put("/products/{product_no}/variants")
|
||||
@@ -503,7 +652,13 @@ def variants_update(
|
||||
product_no: int,
|
||||
payload: dict[str, Any] = Body(default_factory=dict),
|
||||
) -> dict[str, Any]:
|
||||
"""품목 여러 건의 자체코드 · 추가금액 · 진열 · 판매를 한 번에 바꾼다."""
|
||||
"""품목 여러 건의 자체코드 · 추가금액 · 진열 · 판매를 한 번에 바꾼다 — **행별 결과**.
|
||||
|
||||
응답 {"ok": 전부 성공?, "partial": 일부만?, "updated": {code: 반영된 값},
|
||||
"failed": {code: 사유}, "unknown": {code: 사유}}
|
||||
100건 묶음 중 일부가 실패해도 성공한 행은 성공으로 기록·표시한다(화면이 그 행을
|
||||
다시 보내지 않게). 하나도 반영되지 않았으면 502.
|
||||
"""
|
||||
st, user = require_store(request)
|
||||
actor = str(user.get("email") or "")
|
||||
rows = payload.get("rows")
|
||||
@@ -517,31 +672,51 @@ def variants_update(
|
||||
raise HTTPException(status_code=400, detail="바뀐 값이 없습니다.")
|
||||
|
||||
api = build_cafe24_api(st)
|
||||
try:
|
||||
with locked_json(st, product_no, actor=actor, purpose="품목 수정"):
|
||||
results = products.update_variants(api.client, product_no, requests)
|
||||
except Cafe24Error as exc:
|
||||
st.log_audit(actor=actor, action="update_variants", product_no=product_no,
|
||||
result="FAIL", detail=f"{len(requests)}건 실패: {exc}")
|
||||
logger.warning("카페24 상품 %s 품목 수정 실패: %s", product_no, exc)
|
||||
raise _http_from_cafe24(exc) from exc
|
||||
|
||||
# 우리가 보낸 값이 곧 현재값이다(카페24가 받아들였으므로). 응답에 담긴 값이 있으면
|
||||
# 그것을 우선한다.
|
||||
by_code: dict[str, dict[str, Any]] = {}
|
||||
for r in requests:
|
||||
by_code[r["variant_code"]] = {k: v for k, v in r.items() if k != "variant_code"}
|
||||
for r in results:
|
||||
code = str(r.get("variant_code") or "")
|
||||
if code in by_code:
|
||||
for key in ("custom_variant_code", "additional_amount", "display", "selling", "display_order"):
|
||||
if key in r and r[key] is not None:
|
||||
by_code[code][key] = r[key]
|
||||
st.save_write_snapshot(product_no, "variants", by_code)
|
||||
# 카페24가 받아들인 행만 현재값으로 기록한다. 응답에 담긴 값이 있으면 그것을 우선한다.
|
||||
sent = {r["variant_code"]: {k: v for k, v in r.items() if k != "variant_code"} for r in requests}
|
||||
by_code: dict[str, dict[str, Any]] = {}
|
||||
failed: dict[str, str] = {}
|
||||
unknown: dict[str, str] = {}
|
||||
for result in results:
|
||||
code = result["variant_code"]
|
||||
if result["status"] == products.VARIANT_OK:
|
||||
patch = dict(sent.get(code) or {})
|
||||
for key in ("custom_variant_code", "additional_amount", "display", "selling", "display_order"):
|
||||
value = (result.get("variant") or {}).get(key)
|
||||
if value is not None:
|
||||
patch[key] = value
|
||||
by_code[code] = patch
|
||||
elif result["status"] == products.VARIANT_UNKNOWN:
|
||||
unknown[code] = result["error"]
|
||||
else:
|
||||
failed[code] = result["error"]
|
||||
record_error = _save_snapshot_safe(st, product_no, "variants", by_code) if by_code else ""
|
||||
|
||||
detail = "; ".join(
|
||||
f"{code}: " + ", ".join(f"{k}={v}" for k, v in patch.items()) for code, patch in by_code.items()
|
||||
)
|
||||
st.log_audit(actor=actor, action="update_variants", product_no=product_no,
|
||||
result="SUCCESS", detail=detail[:900])
|
||||
logger.info("카페24 상품 %s 품목 %s건 수정 (%s)", product_no, len(by_code), actor)
|
||||
return {"ok": True, "updated": {code: _variant_view({"variant_code": code, **patch})
|
||||
for code, patch in by_code.items()}}
|
||||
if failed or unknown:
|
||||
detail = (f"성공 {len(by_code)} / 실패 {len(failed)} / 결과 모름 {len(unknown)} — " + detail)
|
||||
first = next(iter({**failed, **unknown}.values()), "")
|
||||
detail += f" / 오류: {first}"
|
||||
result_label = "SUCCESS" if not (failed or unknown) else ("PARTIAL" if by_code else "FAIL")
|
||||
writes.audit_safe(st, actor=actor, action="update_variants", product_no=product_no,
|
||||
result=result_label, detail=detail[:900])
|
||||
if not by_code:
|
||||
first = next(iter({**failed, **unknown}.values()), "알 수 없는 오류")
|
||||
note = " (일부는 반영됐을 수 있습니다 — 다시 불러와 확인하세요)" if unknown else ""
|
||||
logger.warning("카페24 상품 %s 품목 수정 실패: %s", product_no, first)
|
||||
raise HTTPException(status_code=502, detail=f"{first}{note}")
|
||||
logger.info("카페24 상품 %s 품목 %s건 수정 (%s, 실패 %s, 모름 %s)",
|
||||
product_no, len(by_code), actor, len(failed), len(unknown))
|
||||
return {
|
||||
"ok": not (failed or unknown),
|
||||
"partial": bool(failed or unknown),
|
||||
"updated": {code: _variant_view({"variant_code": code, **patch}) for code, patch in by_code.items()},
|
||||
"failed": failed,
|
||||
"unknown": unknown,
|
||||
"record_warning": record_error,
|
||||
}
|
||||
|
||||
@@ -50,10 +50,11 @@ PC/모바일은 구분하지 않는다 — 적용 시 `description` 만 쓰고
|
||||
from __future__ import annotations
|
||||
|
||||
import logging
|
||||
from contextlib import contextmanager
|
||||
from datetime import timedelta
|
||||
from decimal import Decimal
|
||||
from typing import Any
|
||||
from urllib.parse import urlencode
|
||||
from typing import Any, Iterator
|
||||
from urllib.parse import quote, urlencode
|
||||
|
||||
from fastapi import APIRouter, Body, Form, HTTPException, Request
|
||||
from fastapi.responses import HTMLResponse, RedirectResponse
|
||||
@@ -61,7 +62,7 @@ from fastapi.responses import HTMLResponse, RedirectResponse
|
||||
from app.integrations.cafe24 import Cafe24Error, build_cafe24_api, products
|
||||
from app.timezone import now_kst
|
||||
|
||||
from . import store
|
||||
from . import store, writes
|
||||
from .common import base_ctx, guard, read_lag_grace_minutes, require_store
|
||||
|
||||
logger = logging.getLogger("cafe24.products")
|
||||
@@ -121,6 +122,16 @@ def _short_dt(value: Any) -> str:
|
||||
return text.replace("T", " ")[:16]
|
||||
|
||||
|
||||
def _iso(value: Any) -> str:
|
||||
"""datetime 이면 KST ISO, 아니면 문자열 그대로."""
|
||||
if hasattr(value, "astimezone"):
|
||||
from app.timezone import KST # noqa: WPS433
|
||||
|
||||
aware = value if value.tzinfo else value.replace(tzinfo=KST)
|
||||
return aware.astimezone(KST).isoformat(timespec="seconds")
|
||||
return str(value or "")
|
||||
|
||||
|
||||
def _row_for_list(raw: dict[str, Any]) -> dict[str, Any]:
|
||||
"""왼쪽 목록에 쓸 필드만 — 상품번호·상품명·진열·판매·최근수정."""
|
||||
normalized = products.normalize_product(raw)
|
||||
@@ -187,30 +198,34 @@ def load_product(st: Any, api: Any, product_no: int) -> tuple[dict[str, Any], bo
|
||||
|
||||
|
||||
def resolve_description(
|
||||
st: Any, product_no: int, cafe24_html: str
|
||||
st: Any, product_no: int, cafe24_html: str, *, fetched_updated: object = None
|
||||
) -> tuple[str, str, dict[str, Any] | None]:
|
||||
"""(유효 HTML, 상태, 마지막 쓰기 revision). 상태는 store.SYNC_*."""
|
||||
grace = read_lag_grace_minutes()
|
||||
since = now_kst() - timedelta(minutes=grace)
|
||||
last_write = st.latest_write_revision(product_no, since=since)
|
||||
if not last_write:
|
||||
return cafe24_html, store.SYNC_NONE, None
|
||||
digests = st.revision_digests(product_no, since=since)
|
||||
effective, state = store.resolve_description(
|
||||
cafe24_html, last_write=last_write, known_digests=digests, grace_minutes=grace
|
||||
)
|
||||
return effective, state, last_write
|
||||
"""(유효 HTML, 상태, 마지막 확인된 쓰기). 상태는 store.SYNC_*.
|
||||
|
||||
근거는 원격 반영이 확인된 쓰기(cafe24_write_attempts)뿐이다 — writes.resolve_effective.
|
||||
"""
|
||||
return writes.resolve_effective(st, product_no, cafe24_html, fetched_updated=fetched_updated)
|
||||
|
||||
|
||||
def remember_write(st: Any, product_no: int, updated: dict[str, Any]) -> dict[str, Any]:
|
||||
"""PUT 응답(상품 dict)을 캐시·스냅샷에 남긴다. 정규화된 캐시 행을 돌려준다."""
|
||||
info = products.normalize_product(updated) if updated else {}
|
||||
if info.get("product_no"):
|
||||
st.upsert_products([info])
|
||||
st.save_write_snapshot(product_no, "product", store.product_snapshot(updated))
|
||||
"""PUT 응답(상품 dict)을 캐시·스냅샷에 남긴다. 정규화된 캐시 행을 돌려준다.
|
||||
|
||||
카페24에는 이미 반영된 뒤라 기록 실패로 예외를 내지 않는다(로그만 — writes 참고).
|
||||
"""
|
||||
info, _error = writes.remember_product_write(st, product_no, updated)
|
||||
return info
|
||||
|
||||
|
||||
@contextmanager
|
||||
def locked_json(st: Any, product_no: int, *, actor: str, purpose: str) -> Iterator[Any]:
|
||||
"""JSON API 용 상품 쓰기 잠금 — 못 잡으면 409, 스키마가 없으면 503."""
|
||||
try:
|
||||
with writes.write_lock(st, writes.product_lock_key(product_no), actor=actor, purpose=purpose) as lock:
|
||||
yield lock
|
||||
except (writes.WriteBusy, writes.WriteSetupError) as exc:
|
||||
raise HTTPException(status_code=exc.http_status, detail=str(exc)) from exc
|
||||
|
||||
|
||||
def _info(product: dict[str, Any]) -> dict[str, Any]:
|
||||
"""편집기·정보 패널 공용 상품 요약."""
|
||||
info = products.normalize_product(product) if product else {}
|
||||
@@ -245,11 +260,27 @@ def _editor_ctx(st: Any, product_no: int) -> dict[str, Any]:
|
||||
product, scalar_stale = load_product(st, api, product_no)
|
||||
desc = products.descriptions_from_product(product)
|
||||
st.upsert_products([products.normalize_product(product)])
|
||||
html_effective, sync_state, last_write = resolve_description(st, product_no, desc.description)
|
||||
html_effective, sync_state, last_write = resolve_description(
|
||||
st, product_no, desc.description, fetched_updated=product.get("updated_date")
|
||||
)
|
||||
except Cafe24Error as exc:
|
||||
error = str(exc)
|
||||
logger.warning("카페24 상품 %s 조회 실패: %s", product_no, exc)
|
||||
|
||||
# 반영 여부를 모르는 이전 시도 — 편집기 위에 확정 버튼과 함께 보여준다.
|
||||
# (REMOTE_OK 는 반영이 확인된 것이라 여기 올리지 않는다 — 기록은 자동 복구된다.)
|
||||
since = now_kst() - timedelta(minutes=read_lag_grace_minutes())
|
||||
open_attempts = [
|
||||
{**a, "label": writes.describe_attempt(a),
|
||||
"status_label": "결과 모름" if a.get("status") == store.ATTEMPT_UNKNOWN else "중단됨"}
|
||||
for a in st.open_attempts(product_no, since=since)
|
||||
if a.get("status") in (store.ATTEMPT_STARTED, store.ATTEMPT_UNKNOWN)
|
||||
]
|
||||
revisions = [
|
||||
{**r, "type_label": store.REVISION_LABELS.get(str(r.get("revision_type") or ""), "")}
|
||||
for r in st.list_revisions(product_no, limit=20)
|
||||
]
|
||||
|
||||
return {
|
||||
"product_no": product_no,
|
||||
# 고객이 보는 상세페이지 주소 (CAFE24_SHOP_URL, 없으면 카페24 기본 도메인)
|
||||
@@ -268,9 +299,10 @@ def _editor_ctx(st: Any, product_no: int) -> dict[str, Any]:
|
||||
"sync_pending": sync_state == store.SYNC_PENDING,
|
||||
"sync_external": sync_state == store.SYNC_EXTERNAL,
|
||||
"scalar_stale": scalar_stale,
|
||||
"last_write_at": _short_dt(last_write.get("created_at").isoformat() if last_write and last_write.get("created_at") else ""),
|
||||
"last_write_at": _short_dt(_iso(last_write.get("created_at")) if last_write else ""),
|
||||
"last_write_by": (last_write or {}).get("created_by") or "",
|
||||
"revisions": st.list_revisions(product_no, limit=20),
|
||||
"revisions": revisions,
|
||||
"open_attempts": open_attempts,
|
||||
"editor_error": error,
|
||||
"option_display_types": store.OPTION_DISPLAY_LABELS,
|
||||
}
|
||||
@@ -384,33 +416,34 @@ def product_rename(
|
||||
raise HTTPException(status_code=400, detail=f"상품명은 {NAME_MAX}자를 넘을 수 없습니다.")
|
||||
|
||||
api = build_cafe24_api(st)
|
||||
try:
|
||||
current, _ = load_product(st, api, product_no)
|
||||
except Cafe24Error as exc:
|
||||
st.log_audit(
|
||||
actor=actor, action="rename_product", product_no=product_no,
|
||||
result="FAIL", detail=f"현재값 조회 실패: {exc}",
|
||||
)
|
||||
raise HTTPException(status_code=502, detail=f"카페24 현재값을 읽지 못했습니다: {exc}") from exc
|
||||
with locked_json(st, product_no, actor=actor, purpose="상품명 변경"):
|
||||
try:
|
||||
current, _ = load_product(st, api, product_no)
|
||||
except Cafe24Error as exc:
|
||||
writes.audit_safe(
|
||||
st, actor=actor, action="rename_product", product_no=product_no,
|
||||
result="FAIL", detail=f"현재값 조회 실패: {exc}",
|
||||
)
|
||||
raise HTTPException(status_code=502, detail=f"카페24 현재값을 읽지 못했습니다: {exc}") from exc
|
||||
|
||||
before = str(current.get("product_name") or "")
|
||||
if before == name:
|
||||
return {"ok": True, "product_name": before, "changed": False}
|
||||
before = str(current.get("product_name") or "")
|
||||
if before == name:
|
||||
return {"ok": True, "product_name": before, "changed": False}
|
||||
|
||||
try:
|
||||
updated = products.update_product(api.client, product_no, product_name=name)
|
||||
except Cafe24Error as exc:
|
||||
st.log_audit(
|
||||
actor=actor, action="rename_product", product_no=product_no,
|
||||
result="FAIL", detail=f"'{before}' → '{name}' 실패: {exc}",
|
||||
)
|
||||
logger.warning("카페24 상품 %s 이름 변경 실패: %s", product_no, exc)
|
||||
raise HTTPException(status_code=502, detail=str(exc)) from exc
|
||||
try:
|
||||
updated = products.update_product(api.client, product_no, product_name=name)
|
||||
except Cafe24Error as exc:
|
||||
writes.audit_safe(
|
||||
st, actor=actor, action="rename_product", product_no=product_no,
|
||||
result="FAIL", detail=f"'{before}' → '{name}' 실패: {exc}",
|
||||
)
|
||||
logger.warning("카페24 상품 %s 이름 변경 실패: %s", product_no, exc)
|
||||
raise HTTPException(status_code=502, detail=str(exc)) from exc
|
||||
|
||||
info = remember_write(st, product_no, updated)
|
||||
info = remember_write(st, product_no, updated)
|
||||
after = str(info.get("product_name") or name)
|
||||
st.log_audit(
|
||||
actor=actor, action="rename_product", product_no=product_no,
|
||||
writes.audit_safe(
|
||||
st, actor=actor, action="rename_product", product_no=product_no,
|
||||
result="SUCCESS", detail=f"'{before}' → '{after}'",
|
||||
)
|
||||
logger.info("카페24 상품 %s 이름 변경 (%s)", product_no, actor)
|
||||
@@ -442,31 +475,32 @@ def product_status(
|
||||
want = bool(payload.get("value"))
|
||||
|
||||
api = build_cafe24_api(st)
|
||||
try:
|
||||
updated = products.update_product(api.client, product_no, **{field: want})
|
||||
except Cafe24Error as exc:
|
||||
st.log_audit(
|
||||
actor=actor, action=f"set_{field}", product_no=product_no,
|
||||
result="FAIL", detail=f"{want} 설정 실패: {exc}",
|
||||
)
|
||||
logger.warning("카페24 상품 %s %s 변경 실패: %s", product_no, field, exc)
|
||||
raise HTTPException(status_code=502, detail=str(exc)) from exc
|
||||
|
||||
# 응답이 상품 dict 면 그것이 곧 현재 상태다. 모양이 다르면(방어) 다시 조회한다.
|
||||
if "display" not in updated or "selling" not in updated:
|
||||
with locked_json(st, product_no, actor=actor, purpose="진열/판매 변경"):
|
||||
try:
|
||||
updated, _ = load_product(st, api, product_no)
|
||||
except Cafe24Error as exc: # 쓰기는 됐다 — 화면만 요청값으로 맞춘다.
|
||||
logger.warning("카페24 상품 %s 상태 재조회 실패: %s", product_no, exc)
|
||||
updated = {}
|
||||
updated = products.update_product(api.client, product_no, **{field: want})
|
||||
except Cafe24Error as exc:
|
||||
writes.audit_safe(
|
||||
st, actor=actor, action=f"set_{field}", product_no=product_no,
|
||||
result="FAIL", detail=f"{want} 설정 실패: {exc}",
|
||||
)
|
||||
logger.warning("카페24 상품 %s %s 변경 실패: %s", product_no, field, exc)
|
||||
raise HTTPException(status_code=502, detail=str(exc)) from exc
|
||||
|
||||
info = remember_write(st, product_no, updated)
|
||||
# 응답이 상품 dict 면 그것이 곧 현재 상태다. 모양이 다르면(방어) 다시 조회한다.
|
||||
if "display" not in updated or "selling" not in updated:
|
||||
try:
|
||||
updated, _ = load_product(st, api, product_no)
|
||||
except Cafe24Error as exc: # 쓰기는 됐다 — 화면만 요청값으로 맞춘다.
|
||||
logger.warning("카페24 상품 %s 상태 재조회 실패: %s", product_no, exc)
|
||||
updated = {}
|
||||
|
||||
info = remember_write(st, product_no, updated)
|
||||
state = {
|
||||
"display": bool(info.get("display", want if field == "display" else True)),
|
||||
"selling": bool(info.get("selling", want if field == "selling" else True)),
|
||||
}
|
||||
st.log_audit(
|
||||
actor=actor, action=f"set_{field}", product_no=product_no,
|
||||
writes.audit_safe(
|
||||
st, actor=actor, action=f"set_{field}", product_no=product_no,
|
||||
result="SUCCESS", detail=f"{field}={'T' if want else 'F'}",
|
||||
)
|
||||
logger.info("카페24 상품 %s %s=%s (%s)", product_no, field, want, actor)
|
||||
@@ -479,6 +513,95 @@ def product_redirect(request: Request, product_no: int):
|
||||
return RedirectResponse(url=f"/cafe24/?selected={product_no}", status_code=303)
|
||||
|
||||
|
||||
def _back_url(product_no: int, list_query: str) -> str:
|
||||
"""적용 후 돌아갈 주소 — 검색·필터를 유지한 채 같은 상품이 선택된 화면."""
|
||||
base = f"/cafe24/?{list_query}" if list_query else f"/cafe24/?selected={product_no}"
|
||||
return base if f"selected={product_no}" in base else f"{base}&selected={product_no}"
|
||||
|
||||
|
||||
def _with_msg(back: str, *, msg: str = "", err: str = "") -> str:
|
||||
"""안내 문구를 쿼리에 붙인다. 문구 안의 &·#·% 가 주소를 깨지 않게 인코딩한다."""
|
||||
key, text = ("err", err) if err else ("msg", msg)
|
||||
return f"{back}&{key}={quote(text, safe='')}"
|
||||
|
||||
|
||||
def _run_description_write(
|
||||
st: Any,
|
||||
user: dict[str, Any],
|
||||
product_no: int,
|
||||
*,
|
||||
html: str,
|
||||
base_fingerprint: str,
|
||||
memo: str,
|
||||
list_query: str,
|
||||
origin: str,
|
||||
action: str,
|
||||
target_revision_id: int | None = None,
|
||||
) -> RedirectResponse:
|
||||
"""즉시 적용·버전 복원 공용 — writes.write_product 를 잠금 안에서 부르고 결과를 안내한다."""
|
||||
actor = str(user.get("email") or "")
|
||||
back = _back_url(product_no, list_query)
|
||||
verb = "복원" if origin == store.ORIGIN_ROLLBACK else "적용"
|
||||
api = build_cafe24_api(st)
|
||||
try:
|
||||
with writes.write_lock(
|
||||
st, writes.product_lock_key(product_no), actor=actor, purpose=f"상세설명 {verb}"
|
||||
) as lock:
|
||||
outcome = writes.write_product(
|
||||
st, api, product_no,
|
||||
lock=lock, origin=origin, actor=actor, html=html,
|
||||
base_fingerprint=base_fingerprint, target_revision_id=target_revision_id,
|
||||
memo=memo, skip_if_same=True,
|
||||
)
|
||||
except (writes.WriteSetupError, writes.WriteBusy, writes.WriteBlocked, writes.WriteConflict) as exc:
|
||||
detail = "충돌 — 편집 중 카페24 값이 변경됨" if isinstance(exc, writes.WriteConflict) else str(exc)
|
||||
writes.audit_safe(st, actor=actor, action=action, product_no=product_no,
|
||||
revision_id=exc.backup_id or None, result="FAIL", detail=detail)
|
||||
return RedirectResponse(url=_with_msg(back, err=str(exc)), status_code=303)
|
||||
except writes.RemoteWriteUnknown as exc:
|
||||
writes.audit_safe(st, actor=actor, action=action, product_no=product_no,
|
||||
revision_id=exc.backup_id or None, result="UNKNOWN",
|
||||
detail=f"시도 #{exc.attempt_id} 반영 여부 모름: {exc}")
|
||||
logger.warning("카페24 상품 %s %s 결과 모름(시도 #%s): %s", product_no, verb, exc.attempt_id, exc)
|
||||
return RedirectResponse(url=_with_msg(back, err=(
|
||||
f"카페24 응답을 받지 못해 {verb} 여부를 알 수 없습니다({exc}). 다시 {verb}하지 말고 "
|
||||
f"쇼핑몰에서 확인한 뒤 편집기 위 안내에서 결과를 확정하세요. "
|
||||
f"(직전 내용은 버전 {exc.backup_id} 로 보관됨)")), status_code=303)
|
||||
except writes.RemoteWriteFailed as exc:
|
||||
writes.audit_safe(st, actor=actor, action=action, product_no=product_no,
|
||||
revision_id=exc.backup_id or None, result="FAIL", detail=str(exc))
|
||||
logger.warning("카페24 상품 %s %s 실패: %s", product_no, verb, exc)
|
||||
return RedirectResponse(url=_with_msg(back, err=(
|
||||
f"{verb}에 실패했습니다: {exc} (직전 내용은 버전 {exc.backup_id} 로 보관됨)")), status_code=303)
|
||||
except Cafe24Error as exc:
|
||||
writes.audit_safe(st, actor=actor, action=action, product_no=product_no,
|
||||
result="FAIL", detail=f"현재값 조회 실패: {exc}")
|
||||
return RedirectResponse(url=_with_msg(back, err=f"카페24 현재값을 읽지 못해 중단했습니다: {exc}"),
|
||||
status_code=303)
|
||||
|
||||
if not outcome.changed:
|
||||
return RedirectResponse(url=_with_msg(back, msg=f"변경된 내용이 없어 {verb}하지 않았습니다."), status_code=303)
|
||||
|
||||
detail = (
|
||||
f"{len(html)}자 {verb} (백업 {outcome.backup_id}, 시도 #{outcome.attempt_id}, 모바일 PC와 동일 유지, "
|
||||
f"카페24 재조회 {'확인' if outcome.confirmed else '지연 — 마지막 적용값 표시'})"
|
||||
)
|
||||
if target_revision_id:
|
||||
detail += f" / 원본 버전 {target_revision_id}"
|
||||
if outcome.record_error:
|
||||
detail += f" / 기록 실패(자동 복구 예정): {outcome.record_error}"
|
||||
writes.audit_safe(st, actor=actor, action=action, product_no=product_no,
|
||||
revision_id=outcome.revision_id or None, result="SUCCESS", detail=detail)
|
||||
logger.info("카페24 상품 %s 상세설명 %s (%s, 재조회 확인=%s)", product_no, verb, actor, outcome.confirmed)
|
||||
note = "" if outcome.confirmed else " 카페24 관리자 API 반영은 잠시 늦을 수 있어 방금 적용한 내용을 표시합니다."
|
||||
if outcome.record_error:
|
||||
note += " ※ 카페24에는 반영됐지만 버전 기록 저장에 실패했습니다 — 자동으로 복구하니 다시 적용하지 마세요."
|
||||
return RedirectResponse(
|
||||
url=_with_msg(back, msg=f"카페24에 {verb}했습니다. 직전 내용은 버전 {outcome.backup_id} 로 보관됩니다.{note}"),
|
||||
status_code=303,
|
||||
)
|
||||
|
||||
|
||||
@products_router.post("/products/{product_no}/apply")
|
||||
def product_apply(
|
||||
request: Request,
|
||||
@@ -490,125 +613,165 @@ def product_apply(
|
||||
):
|
||||
"""편집한 HTML 을 카페24에 즉시 적용한다.
|
||||
|
||||
순서를 지키는 것이 이 함수의 핵심이다.
|
||||
1) 카페24에서 **현재** HTML 을 다시 읽는다(로컬 값을 현재값으로 믿지 않는다)
|
||||
2) 읽기 지연을 판정해 **유효 현재값**을 정한다(예전 값을 돌려주는 중이면
|
||||
우리 마지막 쓰기가 현재값이다)
|
||||
3) 그 값으로 BACKUP 버전을 남긴다 ← 유일한 복구 수단
|
||||
4) 편집 시작 시점의 지문과 비교해 충돌이면 거부한다
|
||||
5) 쓰고, 스냅샷·MANUAL 버전·감사로그를 남긴다
|
||||
순서(writes.write_product): 상품 잠금 → 카페24 현재값 재조회(로컬 값을 현재값으로
|
||||
믿지 않는다) → 결과 모르는 이전 시도 확인 → 유효 현재값(읽기 지연 보정) → BACKUP
|
||||
← 유일한 복구 수단 → 지문 대조(충돌 거부) → 시도 기록 → PUT → 버전·스냅샷 기록.
|
||||
|
||||
PC/모바일을 구분하지 않는다 — 두 필드에 같은 HTML 을 쓴다. 분리 사용 상품의
|
||||
모바일 내용이 PC 와 달랐다면 덮어쓰기 전에 그 내용도 BACKUP 으로 남긴다.
|
||||
PC/모바일을 구분하지 않는다 — description 만 쓰고 separated_mobile_description="F".
|
||||
분리 사용 상품의 모바일 내용이 PC 와 달랐다면 덮어쓰기 전에 그 내용도 BACKUP 으로 남긴다.
|
||||
"""
|
||||
checked = guard(request)
|
||||
if not isinstance(checked, tuple):
|
||||
return checked
|
||||
st, user = checked
|
||||
|
||||
actor = str(user.get("email") or "")
|
||||
# 적용 후에는 검색·필터를 유지한 채 같은 상품이 선택된 화면으로 돌아온다.
|
||||
base = f"/cafe24/?{list_query}" if list_query else f"/cafe24/?selected={product_no}"
|
||||
back = base if f"selected={product_no}" in base else f"{base}&selected={product_no}"
|
||||
|
||||
# 화면에서 보던 그대로(정리된 소스)를 카페24에 반영한다. 한글 이미지 경로는
|
||||
# 원래의 퍼센트 인코딩으로 되돌린다.
|
||||
submitted = store.format_html(store.encode_html_urls(html or ""))
|
||||
if not submitted.strip():
|
||||
return RedirectResponse(
|
||||
url=f"{back}&err=내용이 비어 있습니다. 상세페이지를 비우려면 카페24 관리자에서 하세요.",
|
||||
url=_with_msg(_back_url(product_no, list_query),
|
||||
err="내용이 비어 있습니다. 상세페이지를 비우려면 카페24 관리자에서 하세요."),
|
||||
status_code=303,
|
||||
)
|
||||
return _run_description_write(
|
||||
st, user, product_no,
|
||||
html=submitted, base_fingerprint=base_fingerprint, memo=memo, list_query=list_query,
|
||||
origin=store.ORIGIN_MANUAL, action="apply_description",
|
||||
)
|
||||
|
||||
api = build_cafe24_api(st)
|
||||
|
||||
# ════════════════════════════════════════════════════════════
|
||||
# 버전 이력 — 원문 확인 · 선택 복원
|
||||
# 자동 복원(예약 종료 후 되돌리기)은 쓰지 않는다. 사람이 버전을 골라 누를 때만
|
||||
# 정상 쓰기 경로(잠금·백업·지문 대조·시도 기록)로 한 번 적용하고 ROLLBACK 을 남긴다.
|
||||
# ════════════════════════════════════════════════════════════
|
||||
def _revision_for(st: Any, product_no: int, revision_id: int) -> dict[str, Any]:
|
||||
"""이 쇼핑몰·이 상품의 버전만 돌려준다. 아니면 404(다른 상품 버전을 주소로 못 끌어온다)."""
|
||||
from app.integrations.cafe24 import load_config # noqa: WPS433
|
||||
|
||||
revision = st.get_revision(revision_id)
|
||||
if not revision or int(revision.get("product_no") or 0) != int(product_no):
|
||||
raise HTTPException(status_code=404, detail="이 상품의 버전을 찾을 수 없습니다.")
|
||||
mall = load_config().mall_id
|
||||
rev_mall = str(revision.get("mall_id") or "")
|
||||
# mall_id 가 빈 행은 005 이전 기록이다 — cafe24_db 는 쇼핑몰 1개 전용이라 같은 쇼핑몰로 본다.
|
||||
if rev_mall and mall and rev_mall != mall:
|
||||
raise HTTPException(status_code=404, detail="다른 쇼핑몰의 버전입니다.")
|
||||
if int(revision.get("shop_no") or 1) != 1:
|
||||
raise HTTPException(status_code=404, detail="다른 멀티쇼핑몰(shop_no)의 버전입니다.")
|
||||
return revision
|
||||
|
||||
|
||||
@products_router.get("/products/{product_no}/revisions/{revision_id}")
|
||||
def revision_detail(request: Request, product_no: int, revision_id: int) -> dict[str, Any]:
|
||||
"""버전 원문(JSON). 화면은 textContent 로만 넣는다(HTML 로 해석하지 않는다)."""
|
||||
st, _user = require_store(request)
|
||||
revision = _revision_for(st, product_no, revision_id)
|
||||
body = str(revision.get("html_content") or "")
|
||||
rtype = str(revision.get("revision_type") or "")
|
||||
return {
|
||||
"ok": True,
|
||||
"revision": {
|
||||
"id": revision.get("id"),
|
||||
"product_no": revision.get("product_no"),
|
||||
"revision_type": rtype,
|
||||
"type_label": store.REVISION_LABELS.get(rtype, rtype),
|
||||
"source": revision.get("source") or "",
|
||||
"created_at": revision.get("created_at") or "",
|
||||
"created_by": revision.get("created_by") or "",
|
||||
"memo": revision.get("memo") or "",
|
||||
"length": len(body),
|
||||
# 편집기와 같은 표시(이미지 경로의 %EC… 를 한글로). 복원은 저장된 원문 그대로 쓴다.
|
||||
"html": store.decode_html_urls(body),
|
||||
},
|
||||
}
|
||||
|
||||
|
||||
@products_router.post("/products/{product_no}/revisions/{revision_id}/restore")
|
||||
def revision_restore(
|
||||
request: Request,
|
||||
product_no: int,
|
||||
revision_id: int,
|
||||
base_fingerprint: str = Form(""),
|
||||
memo: str = Form(""),
|
||||
list_query: str = Form(""),
|
||||
):
|
||||
"""고른 버전을 카페24에 다시 적용한다(ROLLBACK). 즉시 적용과 같은 경로·같은 보호."""
|
||||
checked = guard(request)
|
||||
if not isinstance(checked, tuple):
|
||||
return checked
|
||||
st, user = checked
|
||||
back = _back_url(product_no, list_query)
|
||||
try:
|
||||
current = products.fetch_descriptions(api.client, product_no)
|
||||
except Cafe24Error as exc:
|
||||
st.log_audit(
|
||||
actor=actor, action="apply_description", product_no=product_no,
|
||||
result="FAIL", detail=f"현재값 조회 실패: {exc}",
|
||||
)
|
||||
return RedirectResponse(url=f"{back}&err=카페24 현재값을 읽지 못해 중단했습니다: {exc}", status_code=303)
|
||||
|
||||
# 읽기 지연 판정 — 카페24가 아직 예전 값을 돌려주면 우리 마지막 쓰기가 현재값이다.
|
||||
effective, sync_state, _ = resolve_description(st, product_no, current.description)
|
||||
pending = sync_state == store.SYNC_PENDING
|
||||
|
||||
backup_id = st.add_revision(
|
||||
product_no=product_no,
|
||||
html_content=effective,
|
||||
revision_type=store.REVISION_BACKUP,
|
||||
memo="적용 직전 자동 백업" + (" (카페24 읽기 지연 — 마지막 적용값 기준)" if pending else ""),
|
||||
created_by=actor,
|
||||
)
|
||||
# 모바일 내용이 PC 와 달랐다면 그것도 따로 남긴다. 아래에서 모바일을 PC 와 같게
|
||||
# 덮어쓰므로, 백업하지 않으면 그 내용을 되찾을 방법이 없다.
|
||||
if current.mobile_description and current.mobile_description != current.description:
|
||||
st.add_revision(
|
||||
product_no=product_no,
|
||||
html_content=current.mobile_description,
|
||||
revision_type=store.REVISION_BACKUP,
|
||||
memo="적용 직전 자동 백업 (모바일 — PC와 달랐던 내용)",
|
||||
created_by=actor,
|
||||
)
|
||||
|
||||
if base_fingerprint and base_fingerprint != store.fingerprint(effective):
|
||||
st.log_audit(
|
||||
actor=actor, action="apply_description", product_no=product_no,
|
||||
revision_id=backup_id, result="FAIL", detail="충돌 — 편집 중 카페24 값이 변경됨",
|
||||
)
|
||||
revision = _revision_for(st, product_no, revision_id)
|
||||
except HTTPException as exc:
|
||||
return RedirectResponse(url=_with_msg(back, err=str(exc.detail)), status_code=303)
|
||||
body = str(revision.get("html_content") or "")
|
||||
if not body.strip():
|
||||
return RedirectResponse(url=_with_msg(back, err="내용이 빈 버전은 복원할 수 없습니다."), status_code=303)
|
||||
if not base_fingerprint:
|
||||
# 편집기가 본 현재값 없이 복원하면 그 사이 바뀐 내용을 모르고 덮는다.
|
||||
return RedirectResponse(
|
||||
url=f"{back}&err=편집하는 동안 카페24 값이 변경되었습니다. 새로고침해 현재 내용을 확인한 뒤 다시 적용하세요.",
|
||||
status_code=303,
|
||||
url=_with_msg(back, err="편집기를 새로고침한 뒤 버전 이력에서 다시 복원하세요."), status_code=303
|
||||
)
|
||||
note = f"버전 {revision_id} 복원" + (f" — {memo.strip()}" if memo.strip() else "")
|
||||
return _run_description_write(
|
||||
st, user, product_no,
|
||||
html=body, base_fingerprint=base_fingerprint, memo=note, list_query=list_query,
|
||||
origin=store.ORIGIN_ROLLBACK, action="restore_revision", target_revision_id=int(revision_id),
|
||||
)
|
||||
|
||||
if submitted == effective:
|
||||
return RedirectResponse(url=f"{back}&msg=변경된 내용이 없어 적용하지 않았습니다.", status_code=303)
|
||||
|
||||
# ════════════════════════════════════════════════════════════
|
||||
# 반영 여부를 모르는 시도 — 사람이 쇼핑몰을 확인하고 확정한다
|
||||
# ════════════════════════════════════════════════════════════
|
||||
@products_router.post("/products/{product_no}/attempts/{attempt_id}/resolve")
|
||||
def attempt_resolve(
|
||||
request: Request,
|
||||
product_no: int,
|
||||
attempt_id: int,
|
||||
result: str = Form(""),
|
||||
list_query: str = Form(""),
|
||||
):
|
||||
"""applied = 반영됨(그 내용을 마지막 쓰기로 기록) / not_applied = 반영 안 됨(닫기).
|
||||
|
||||
예약에서 난 시도면 그 예약도 함께 완료/실패로 바꾼다. 다시 적용하는 것은 사람이
|
||||
편집기에서 한다(자동 재적용 없음).
|
||||
"""
|
||||
checked = guard(request)
|
||||
if not isinstance(checked, tuple):
|
||||
return checked
|
||||
st, user = checked
|
||||
actor = str(user.get("email") or "")
|
||||
back = _back_url(product_no, list_query)
|
||||
if result not in ("applied", "not_applied"):
|
||||
return RedirectResponse(url=_with_msg(back, err="확정할 결과를 고르세요."), status_code=303)
|
||||
open_states = (store.ATTEMPT_STARTED, store.ATTEMPT_UNKNOWN)
|
||||
try:
|
||||
# mobile_description 은 보내지 않는다 — update_descriptions 가
|
||||
# separated_mobile_description="F" 로 "PC 상세설명과 동일"을 강제하고
|
||||
# 카페24가 모바일 값을 자동으로 맞춰준다(모바일도 항상 PC와 같다).
|
||||
updated = products.update_descriptions(api.client, product_no, description=submitted)
|
||||
except Cafe24Error as exc:
|
||||
st.log_audit(
|
||||
actor=actor, action="apply_description", product_no=product_no,
|
||||
revision_id=backup_id, result="FAIL", detail=str(exc),
|
||||
)
|
||||
logger.warning("카페24 상품 %s 적용 실패: %s", product_no, exc)
|
||||
return RedirectResponse(
|
||||
url=f"{back}&err=적용에 실패했습니다: {exc} (직전 내용은 버전 {backup_id} 로 보관됨)",
|
||||
status_code=303,
|
||||
)
|
||||
|
||||
# PUT 응답은 쓰기 직후의 실제 값 — 스냅샷으로 남긴다(상품명·가격·updated_date 등).
|
||||
remember_write(st, product_no, updated if isinstance(updated, dict) else {})
|
||||
|
||||
# MANUAL revision 을 **먼저** 남긴다. 이것이 "마지막 쓰기" 기준이 되어, 카페24 GET 이
|
||||
# 한동안 예전 값을 돌려줘도 편집기는 방금 적용한 내용을 보여준다.
|
||||
revision_id = st.add_revision(
|
||||
product_no=product_no,
|
||||
html_content=submitted,
|
||||
revision_type=store.REVISION_MANUAL,
|
||||
memo=memo,
|
||||
created_by=actor,
|
||||
)
|
||||
|
||||
# 카페24 관리자 API 는 쓰기 직후 몇 초간 이전 값을 돌려줄 때가 있다(쇼핑몰
|
||||
# 화면에는 바로 반영됨). 여기서 짧게 확인만 한다 — 확인이 안 돼도 화면은 위
|
||||
# MANUAL revision 을 기준으로 그리므로 문제없다.
|
||||
confirmed = products.wait_for_description(api.client, product_no, submitted)
|
||||
|
||||
st.log_audit(
|
||||
actor=actor, action="apply_description", product_no=product_no,
|
||||
revision_id=revision_id, result="SUCCESS",
|
||||
detail=(
|
||||
f"{len(submitted)}자 적용 (백업 {backup_id}, 모바일 PC와 동일 유지, "
|
||||
f"카페24 재조회 {'확인' if confirmed else '지연 — 마지막 적용값 표시'})"
|
||||
),
|
||||
)
|
||||
logger.info("카페24 상품 %s 상세설명 적용 (%s, 재조회 확인=%s)", product_no, actor, confirmed)
|
||||
note = "" if confirmed else " 카페24 관리자 API 반영은 잠시 늦을 수 있어 방금 적용한 내용을 표시합니다."
|
||||
return RedirectResponse(
|
||||
url=f"{back}&msg=카페24에 적용했습니다. 직전 내용은 버전 {backup_id} 로 보관됩니다.{note}",
|
||||
status_code=303,
|
||||
)
|
||||
with writes.write_lock(st, writes.product_lock_key(product_no), actor=actor, purpose="적용 결과 확정"):
|
||||
attempt = st.get_attempt(attempt_id)
|
||||
if (not attempt or int(attempt.get("product_no") or 0) != int(product_no)
|
||||
or attempt.get("status") not in open_states):
|
||||
return RedirectResponse(url=_with_msg(back, err="이미 확정됐거나 없는 시도입니다."), status_code=303)
|
||||
schedule_id = attempt.get("schedule_id")
|
||||
if result == "applied":
|
||||
st.update_attempt(attempt_id, status=store.ATTEMPT_REMOTE_OK, remote_ok=True,
|
||||
resolved_by=actor, only_from=open_states)
|
||||
revision_id = writes.record_attempt(st, attempt)
|
||||
if schedule_id:
|
||||
st.review_schedule(int(schedule_id), status=store.STATUS_SUCCESS,
|
||||
note=f"{actor} 가 반영됨으로 확정", actor=actor, action="applied")
|
||||
text = f"시도 #{attempt_id} 를 반영됨으로 확정했습니다(버전 {revision_id})."
|
||||
else:
|
||||
st.update_attempt(attempt_id, status=store.ATTEMPT_ABANDONED, resolved_by=actor,
|
||||
only_from=open_states)
|
||||
if schedule_id:
|
||||
st.review_schedule(int(schedule_id), status=store.STATUS_FAILED,
|
||||
note=f"{actor} 가 반영 안 됨으로 확정", actor=actor, action="not_applied")
|
||||
text = f"시도 #{attempt_id} 를 반영 안 됨으로 확정했습니다. 필요하면 다시 적용하세요."
|
||||
except (writes.WriteBusy, writes.WriteSetupError) as exc:
|
||||
return RedirectResponse(url=_with_msg(back, err=str(exc)), status_code=303)
|
||||
writes.audit_safe(st, actor=actor, action=f"resolve_attempt:{result}", product_no=product_no,
|
||||
result="SUCCESS", detail=f"시도 #{attempt_id}")
|
||||
return RedirectResponse(url=_with_msg(back, msg=text), status_code=303)
|
||||
|
||||
@@ -22,9 +22,9 @@ import logging
|
||||
from fastapi import APIRouter, Form, Request
|
||||
from fastapi.responses import HTMLResponse, RedirectResponse
|
||||
|
||||
from app.integrations.cafe24 import Cafe24Error, build_cafe24_api, products
|
||||
from app.integrations.cafe24 import Cafe24Error, build_cafe24_api, load_config, products
|
||||
|
||||
from . import store
|
||||
from . import store, writes
|
||||
from .common import base_ctx, guard
|
||||
from .routes_products import _no_store
|
||||
|
||||
@@ -55,6 +55,7 @@ def schedules_page(request: Request) -> HTMLResponse:
|
||||
set_selling=row.get("set_selling"),
|
||||
),
|
||||
"editable": store.is_editable(row.get("status") or ""),
|
||||
"needs_review": row.get("status") == store.STATUS_NEEDS_REVIEW,
|
||||
}
|
||||
)
|
||||
|
||||
@@ -65,6 +66,7 @@ def schedules_page(request: Request) -> HTMLResponse:
|
||||
"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"]),
|
||||
"flash": request.query_params.get("msg", ""),
|
||||
"flash_error": request.query_params.get("err", ""),
|
||||
}
|
||||
@@ -114,6 +116,12 @@ def schedule_create(
|
||||
except ValueError as exc:
|
||||
return RedirectResponse(url=f"{back}&err={exc}", status_code=303)
|
||||
|
||||
# 예약은 worker 가 잠금·시도 기록(마이그레이션 005)으로 실행한다 — 없으면 등록도 받지 않는다.
|
||||
try:
|
||||
writes.require_schema(st)
|
||||
except writes.WriteSetupError as exc:
|
||||
return RedirectResponse(url=f"{back}&err={exc}", status_code=303)
|
||||
|
||||
revision_id: int | None = None
|
||||
if want_html:
|
||||
body = store.format_html(store.encode_html_urls(html or ""))
|
||||
@@ -127,6 +135,7 @@ def schedule_create(
|
||||
revision_type=store.REVISION_DRAFT,
|
||||
memo=f"예약 등록 ({run_at.strftime('%Y-%m-%d %H:%M')} 적용 예정)",
|
||||
created_by=actor,
|
||||
mall_id=load_config().mall_id,
|
||||
)
|
||||
|
||||
schedule_id = st.create_schedule(
|
||||
@@ -187,3 +196,51 @@ def schedule_current_flags(request: Request, product_no: int) -> dict:
|
||||
"display": normalized["display"],
|
||||
"selling": normalized["selling"],
|
||||
}
|
||||
|
||||
|
||||
# 확인 필요(NEEDS_REVIEW) 예약의 사람 확정 — 반영 여부를 모르는 채로 worker 가 멈춘 것.
|
||||
# applied = 쇼핑몰에 반영돼 있음(완료 + 버전 기록) / rerun = 다시 실행 / close = 실패로 종료.
|
||||
_REVIEW_ACTIONS = {
|
||||
"applied": (store.STATUS_SUCCESS, "반영됨으로 확정"),
|
||||
"rerun": (store.STATUS_PENDING, "다시 실행"),
|
||||
"close": (store.STATUS_FAILED, "실패로 종료"),
|
||||
}
|
||||
|
||||
|
||||
@schedules_router.post("/schedules/{schedule_id}/review")
|
||||
def schedule_review(request: Request, schedule_id: int, action: str = Form("")):
|
||||
"""확인 필요 예약을 확정한다. 자동으로 다시 실행하지 않는다 — 사람이 쇼핑몰을 보고 고른다."""
|
||||
checked = guard(request)
|
||||
if not isinstance(checked, tuple):
|
||||
return checked
|
||||
st, user = checked
|
||||
actor = str(user.get("email") or "")
|
||||
if action not in _REVIEW_ACTIONS:
|
||||
return RedirectResponse(url="/cafe24/schedules?err=확정할 동작을 고르세요.", status_code=303)
|
||||
status, label = _REVIEW_ACTIONS[action]
|
||||
row = st.get_schedule(schedule_id)
|
||||
if not row or row.get("status") != store.STATUS_NEEDS_REVIEW:
|
||||
return RedirectResponse(
|
||||
url=f"/cafe24/schedules?err=예약 #{schedule_id} 은 확인 필요 상태가 아닙니다.", status_code=303
|
||||
)
|
||||
product_no = int(row.get("product_no") or 0)
|
||||
try:
|
||||
with writes.write_lock(st, writes.product_lock_key(product_no), actor=actor, purpose="예약 결과 확정"):
|
||||
attempt = st.latest_attempt_for_schedule(schedule_id)
|
||||
open_attempt = attempt if attempt.get("status") in (store.ATTEMPT_STARTED, store.ATTEMPT_UNKNOWN) else {}
|
||||
if action == "applied":
|
||||
if not open_attempt:
|
||||
return RedirectResponse(
|
||||
url=f"/cafe24/schedules?err=예약 #{schedule_id} 에는 확정할 적용 시도가 없습니다 — "
|
||||
"다시 실행하거나 실패로 종료하세요.",
|
||||
status_code=303,
|
||||
)
|
||||
st.update_attempt(int(open_attempt["id"]), status=store.ATTEMPT_REMOTE_OK, remote_ok=True,
|
||||
resolved_by=actor,
|
||||
only_from=(store.ATTEMPT_STARTED, store.ATTEMPT_UNKNOWN))
|
||||
writes.record_attempt(st, open_attempt)
|
||||
st.review_schedule(schedule_id, status=status, note=f"{actor} — {label}", actor=actor, action=action)
|
||||
except (writes.WriteBusy, writes.WriteSetupError) as exc:
|
||||
return RedirectResponse(url=f"/cafe24/schedules?err={exc}", status_code=303)
|
||||
logger.info("카페24 예약 #%s 확인 필요 → %s (%s)", schedule_id, label, actor)
|
||||
return RedirectResponse(url=f"/cafe24/schedules?msg=예약 #{schedule_id} — {label}", status_code=303)
|
||||
|
||||
+228
-2
@@ -6,6 +6,7 @@
|
||||
from __future__ import annotations
|
||||
|
||||
import hashlib
|
||||
import json
|
||||
import re
|
||||
from datetime import datetime, timedelta
|
||||
from urllib.parse import quote
|
||||
@@ -44,6 +45,9 @@ STATUS_PROCESSING = "PROCESSING"
|
||||
STATUS_SUCCESS = "SUCCESS"
|
||||
STATUS_FAILED = "FAILED"
|
||||
STATUS_CANCELLED = "CANCELLED"
|
||||
# 원격 반영 여부를 모른다(네트워크 끊김·worker 중단) — 사람이 카페24를 보고 확정한다.
|
||||
# 자동으로 PENDING 에 돌려 재적용하지 않는다(마이그레이션 005).
|
||||
STATUS_NEEDS_REVIEW = "NEEDS_REVIEW"
|
||||
|
||||
SCHEDULE_STATUSES: tuple[str, ...] = (
|
||||
STATUS_PENDING,
|
||||
@@ -51,6 +55,7 @@ SCHEDULE_STATUSES: tuple[str, ...] = (
|
||||
STATUS_SUCCESS,
|
||||
STATUS_FAILED,
|
||||
STATUS_CANCELLED,
|
||||
STATUS_NEEDS_REVIEW,
|
||||
)
|
||||
|
||||
SCHEDULE_STATUS_LABELS: dict[str, str] = {
|
||||
@@ -59,8 +64,36 @@ SCHEDULE_STATUS_LABELS: dict[str, str] = {
|
||||
STATUS_SUCCESS: "완료",
|
||||
STATUS_FAILED: "실패",
|
||||
STATUS_CANCELLED: "취소",
|
||||
STATUS_NEEDS_REVIEW: "확인 필요",
|
||||
}
|
||||
|
||||
# ── 쓰기 시도 상태 (cafe24_write_attempts.status, 마이그레이션 005) ──
|
||||
ATTEMPT_STARTED = "STARTED" # PUT 직전 기록. 이대로 남으면 결과를 모른다.
|
||||
ATTEMPT_REMOTE_OK = "REMOTE_OK" # 카페24 반영 성공, 로컬 버전 기록 전(기록 복구 필요)
|
||||
ATTEMPT_RECORDED = "RECORDED" # 반영 성공 + 버전 기록 완료
|
||||
ATTEMPT_REMOTE_FAILED = "REMOTE_FAILED" # 카페24가 거절 — 반영되지 않은 것이 확실
|
||||
ATTEMPT_UNKNOWN = "UNKNOWN" # 반영 여부 모름 → 사람 확인
|
||||
ATTEMPT_ABANDONED = "ABANDONED" # 사람이 "반영 안 됨"으로 확정 / 재실행으로 대체
|
||||
# 원격 반영이 확인된 시도 — 읽기 지연 판정의 근거는 이것뿐이다.
|
||||
ATTEMPT_CONFIRMED: tuple[str, ...] = (ATTEMPT_REMOTE_OK, ATTEMPT_RECORDED)
|
||||
# 결과 확정이 필요한 시도 — 이것이 남아 있으면 같은 상품 상세설명을 다시 쓰지 않는다.
|
||||
ATTEMPT_OPEN: tuple[str, ...] = (ATTEMPT_STARTED, ATTEMPT_REMOTE_OK, ATTEMPT_UNKNOWN)
|
||||
|
||||
ORIGIN_MANUAL = "MANUAL"
|
||||
ORIGIN_SCHEDULED = "SCHEDULED"
|
||||
ORIGIN_ROLLBACK = "ROLLBACK"
|
||||
# 시도 출처 → 성공 시 남길 버전 종류
|
||||
ORIGIN_REVISION_TYPE: dict[str, str] = {
|
||||
ORIGIN_MANUAL: "MANUAL",
|
||||
ORIGIN_SCHEDULED: "SCHEDULED",
|
||||
ORIGIN_ROLLBACK: "ROLLBACK",
|
||||
}
|
||||
|
||||
# ── BACKUP 출처 (cafe24_product_revisions.source) ──
|
||||
SOURCE_OBSERVED = "OBSERVED" # 카페24 GET 으로 읽은 값 그대로
|
||||
SOURCE_LAST_WRITE = "LAST_WRITE" # 카페24가 읽기 지연 중 — 우리 마지막(확인된) 쓰기를 현재값으로 봄
|
||||
SOURCE_REVISION = "REVISION" # ROLLBACK — 과거 버전을 그대로 다시 올림
|
||||
|
||||
# 사용자가 손댈 수 있는 상태 — PROCESSING/SUCCESS 는 임의 변경 금지
|
||||
EDITABLE_STATUSES: tuple[str, ...] = (STATUS_PENDING,)
|
||||
|
||||
@@ -509,11 +542,20 @@ def resolve_description(
|
||||
known_digests: set[str] | frozenset[str],
|
||||
grace_minutes: int,
|
||||
now: datetime | None = None,
|
||||
fetched_updated: object = None,
|
||||
) -> tuple[str, str]:
|
||||
"""(화면·적용에 쓸 유효 HTML, 상태) 를 돌려준다.
|
||||
|
||||
last_write: 최근 쓰기 revision — {"html_content", "created_at"}.
|
||||
known_digests: 유예시간 안의 revision 들의 내용 해시(`content_digest()` 결과) 집합.
|
||||
last_write: **원격 반영이 확인된** 마지막 쓰기 — {"html_content", "created_at",
|
||||
"remote_updated_at"(선택: 그 PUT 응답의 updated_date)}.
|
||||
known_digests: 확인된 쓰기들이 **덮어쓴 값**(쓰기 직전 관측값·기준값)과 쓴 값의
|
||||
내용 해시(`content_digest()`) 집합. 충돌로 거절된 적용의 백업, 예약 초안처럼
|
||||
카페24에 올라간 적 없는 값은 넣지 않는다 — 넣으면 관리자에서 직접 고친 값이
|
||||
우연히 그와 같을 때 "읽기 지연"으로 오판해 그 수정을 덮어쓴다.
|
||||
fetched_updated: 이번 GET 의 updated_date. 마지막 쓰기의 PUT 응답 updated_date 보다
|
||||
**뒤**라면 GET 은 우리 쓰기 이후의 레코드다 — 지연이 아니므로 카페24 값을 믿는다
|
||||
(관리자가 우리 적용 뒤 예전 값으로 되돌린 경우를 구분한다). 같거나 판단할 수
|
||||
없으면 내용 해시로 판정한다.
|
||||
"""
|
||||
if not last_write:
|
||||
return cafe24_html, SYNC_NONE
|
||||
@@ -523,11 +565,29 @@ def resolve_description(
|
||||
last_html = str(last_write.get("html_content") or "")
|
||||
if cafe24_html == last_html:
|
||||
return cafe24_html, SYNC_SYNCED
|
||||
fetched_at = _as_aware(fetched_updated)
|
||||
written_at = _as_aware(last_write.get("remote_updated_at"))
|
||||
if fetched_at is not None and written_at is not None and fetched_at > written_at:
|
||||
return cafe24_html, SYNC_EXTERNAL
|
||||
if content_digest(cafe24_html) in known_digests:
|
||||
return last_html, SYNC_PENDING
|
||||
return cafe24_html, SYNC_EXTERNAL
|
||||
|
||||
|
||||
def lineage_digests(lineage: list[dict]) -> set[str]:
|
||||
"""확인된 쓰기 목록 → 읽기 지연 판정에 쓸 내용 해시 집합.
|
||||
|
||||
각 쓰기의 직전 관측값(observed)·기준값(base)·쓴 값(target). 빈 해시는 뺀다.
|
||||
"""
|
||||
out: set[str] = set()
|
||||
for item in lineage or []:
|
||||
for key in ("observed_digest", "base_digest", "target_digest"):
|
||||
value = str(item.get(key) or "")
|
||||
if value:
|
||||
out.add(value)
|
||||
return out
|
||||
|
||||
|
||||
def content_digest(html: str) -> str:
|
||||
"""revision 내용 대조용 md5 hex — DB 의 `md5(html_content)` 와 같은 값.
|
||||
|
||||
@@ -598,6 +658,172 @@ def overlay_recent_write(
|
||||
return merged, True
|
||||
|
||||
|
||||
# ── 품목 스냅샷: 코드별 · 필드별 병합 ──
|
||||
# 스냅샷 모양: {variant_code: {필드: 값, ..., "_at": ISO, "_deleted": bool,
|
||||
# "options": [{name,value}...], "_options_before": [...]}}
|
||||
def merge_variant_snapshot(current: dict | None, patch: dict | None, *, at: str, replace: bool = False) -> dict:
|
||||
"""품목 스냅샷 병합.
|
||||
|
||||
- 같은 품목의 이전 필드는 유지하고 새로 쓴 필드만 덮는다. (예전에는 품목 단위로
|
||||
통째로 바꿔서, 자체코드를 고친 뒤 진열만 바꾸면 자체코드 기록이 사라졌다.)
|
||||
- replace=True 는 전체 초기화(옵션 삭제·재생성) — 이전 품목 기록을 모두 버린다.
|
||||
빈 patch({}) 를 "초기화" 로 해석하지 않는다(병합에서 {} 는 아무것도 안 바꾼다).
|
||||
- 삭제 표식(_deleted)은 한 번 붙으면 유지한다. 삭제 뒤에 늦게 도착한 수정이
|
||||
그 품목을 되살리지 않게 한다.
|
||||
- 품목마다 기록 시각(_at)을 남겨 유예시간을 품목별로 판정한다.
|
||||
"""
|
||||
base: dict = {} if replace else {
|
||||
str(code): dict(fields) for code, fields in (current or {}).items() if isinstance(fields, dict)
|
||||
}
|
||||
for code, fields in (patch or {}).items():
|
||||
if not isinstance(fields, dict):
|
||||
continue
|
||||
code = str(code)
|
||||
entry = base.get(code, {})
|
||||
if entry.get("_deleted") and not fields.get("_deleted"):
|
||||
continue # 삭제된 품목에 대한 늦은 수정 — 되살리지 않는다
|
||||
if fields.get("_deleted"):
|
||||
base[code] = {"_deleted": True, "_at": at}
|
||||
continue
|
||||
entry.update(fields)
|
||||
entry["_at"] = at
|
||||
base[code] = entry
|
||||
return base
|
||||
|
||||
|
||||
def _labels(options: object) -> list[tuple[str, str]]:
|
||||
if not isinstance(options, list):
|
||||
return []
|
||||
return [
|
||||
(str(o.get("name") or ""), str(o.get("value") or ""))
|
||||
for o in options if isinstance(o, dict)
|
||||
]
|
||||
|
||||
|
||||
def apply_variant_patch(
|
||||
variant: dict,
|
||||
patch: dict | None,
|
||||
*,
|
||||
section_written_at: object,
|
||||
grace_minutes: int,
|
||||
now: datetime | None = None,
|
||||
) -> dict | None:
|
||||
"""GET 품목 1건에 우리 쓰기 기록을 덮어씌운다. 삭제한 품목이면 None.
|
||||
|
||||
옵션 표기(options)는 **품목코드**(안정 식별자)로 짝지은 기록이다. 옵션값 이름을
|
||||
바꾼 직후 GET 품목이 아직 예전 이름을 돌려주면(읽기 지연) 이름으로는 짝이 안 맞아
|
||||
정상 품목이 "품목 없는 옵션값"으로 보였다. 그래서
|
||||
- GET 표기가 쓰기 직전 표기들(_options_before) 중 하나 → 지연 → 우리가 쓴 표기로
|
||||
- GET 표기 == 우리가 쓴 표기 → 이미 따라잡음
|
||||
- 둘 다 아님 → 관리자에서 다시 고침 → GET 을 믿는다
|
||||
_options_before 는 유예시간 안에 연달아 바꾼 이전 표기를 모두 담은 목록이다
|
||||
(A→B→C 직후 GET 이 A 를 돌려줘도 지연으로 본다).
|
||||
"""
|
||||
if not isinstance(patch, dict) or not patch:
|
||||
return variant
|
||||
at = patch.get("_at") or section_written_at
|
||||
if not within_grace(at, grace_minutes=grace_minutes, now=now):
|
||||
return variant
|
||||
if patch.get("_deleted"):
|
||||
return None
|
||||
out = dict(variant)
|
||||
for key, value in patch.items():
|
||||
if key.startswith("_") or key == "options":
|
||||
continue
|
||||
out[key] = value
|
||||
if "options" in patch:
|
||||
current = _labels(variant.get("options"))
|
||||
wanted = _labels(patch.get("options"))
|
||||
befores = label_history(patch.get("_options_before"))
|
||||
if current != wanted and (patch.get("_options_before") is None or current in befores):
|
||||
out["options"] = [{"name": n, "value": v} for n, v in wanted]
|
||||
return out
|
||||
|
||||
|
||||
def label_history(raw: object) -> list[list[tuple[str, str]]]:
|
||||
"""_options_before → 표기 목록의 목록. 옛 모양(표기 하나 = dict 목록)도 받는다."""
|
||||
if not isinstance(raw, list) or not raw:
|
||||
return []
|
||||
if all(isinstance(item, dict) for item in raw):
|
||||
return [_labels(raw)]
|
||||
return [_labels(item) for item in raw if isinstance(item, list)]
|
||||
|
||||
|
||||
def labels_as_json(options: object) -> list[dict]:
|
||||
"""표기(options) → 스냅샷 저장 모양 [{name, value}]."""
|
||||
return [{"name": n, "value": v} for n, v in _labels(options)]
|
||||
|
||||
|
||||
# ── 옵션 스냅샷: 쓰기 직전 모양과 비교해 지연/외부 변경을 가린다 ──
|
||||
def options_signature(option: object) -> str:
|
||||
"""옵션 dict 의 비교용 서명 — 옵션 사용 여부, 옵션명·표시방식, 옵션값 이름·이미지."""
|
||||
if not isinstance(option, dict):
|
||||
return ""
|
||||
raw = option.get("has_option")
|
||||
has = raw is True or str(raw or "").strip().upper() in ("T", "TRUE", "1", "Y")
|
||||
groups = []
|
||||
if has:
|
||||
for o in option.get("options") or []:
|
||||
if not isinstance(o, dict):
|
||||
continue
|
||||
values = [
|
||||
[str(v.get("option_text") or ""), str(v.get("option_image_file") or ""),
|
||||
str(v.get("option_link_image") or "")]
|
||||
for v in (o.get("option_value") or []) if isinstance(v, dict)
|
||||
]
|
||||
groups.append([str(o.get("option_name") or ""), str(o.get("option_display_type") or ""), values])
|
||||
return json.dumps([has, groups], ensure_ascii=False, sort_keys=True)
|
||||
|
||||
|
||||
def overlay_options(
|
||||
fetched: dict,
|
||||
*,
|
||||
snapshot: dict | None,
|
||||
written_at: object,
|
||||
grace_minutes: int,
|
||||
now: datetime | None = None,
|
||||
) -> tuple[dict, bool]:
|
||||
"""(보여줄 옵션 dict, 지연 여부). 스냅샷에 `_before_signatures`(쓰기 직전 모양들의
|
||||
서명 — 유예시간 안에 연달아 바꾼 이전 모양 포함)가 있으면 GET 이 그중 하나일 때만
|
||||
지연으로 본다 — 관리자에서 다시 고친 옵션을 유예시간 동안 덮지 않게.
|
||||
서명 목록이 없는 옛 스냅샷은 예전처럼 유예시간 안이면 스냅샷을 쓴다."""
|
||||
if not isinstance(snapshot, dict) or not snapshot:
|
||||
return fetched, False
|
||||
if not within_grace(written_at, grace_minutes=grace_minutes, now=now):
|
||||
return fetched, False
|
||||
got = options_signature(fetched)
|
||||
if got == options_signature(snapshot):
|
||||
return fetched, False
|
||||
befores = snapshot.get("_before_signatures")
|
||||
if isinstance(befores, list) and got not in befores:
|
||||
return fetched, False
|
||||
return snapshot, True
|
||||
|
||||
|
||||
# ── 예약 worker 가 lease 만료된 PROCESSING 을 복구할 때의 판정 ──
|
||||
RECOVER_SUCCESS = "SUCCESS" # 이미 반영·기록됨
|
||||
RECOVER_RECORD = "RECORD" # 반영됨 — 버전 기록만 채우고 SUCCESS
|
||||
RECOVER_RETRY = "RETRY" # 반영 안 됨이 확실 — 재시도 예산 안에서 다시 대기
|
||||
RECOVER_FAIL = "FAIL" # 반영 안 됨 + 재시도 예산 소진
|
||||
RECOVER_REVIEW = "REVIEW" # 반영 여부 모름 — NEEDS_REVIEW (자동 재적용 금지)
|
||||
|
||||
|
||||
def recovery_decision(attempt: dict | None, retry_count: object) -> tuple[str, str]:
|
||||
"""(판정, 사람이 읽을 사유). attempt 는 그 예약의 가장 최근 쓰기 시도(없으면 None)."""
|
||||
if not attempt:
|
||||
note = "worker 가 카페24에 쓰기 전에 중단되었습니다"
|
||||
return (RECOVER_RETRY if can_retry(retry_count) else RECOVER_FAIL), note
|
||||
status = str(attempt.get("status") or "")
|
||||
if status == ATTEMPT_RECORDED:
|
||||
return RECOVER_SUCCESS, "카페24 반영·기록이 끝난 뒤 중단되었습니다"
|
||||
if status == ATTEMPT_REMOTE_OK:
|
||||
return RECOVER_RECORD, "카페24에는 반영됐고 로컬 기록 전에 중단되었습니다"
|
||||
if status in (ATTEMPT_REMOTE_FAILED, ATTEMPT_ABANDONED):
|
||||
note = "카페24가 요청을 반영하지 않았습니다"
|
||||
return (RECOVER_RETRY if can_retry(retry_count) else RECOVER_FAIL), note
|
||||
return RECOVER_REVIEW, "카페24에 쓰는 도중 중단되어 반영 여부를 알 수 없습니다 — 쇼핑몰에서 확인하세요"
|
||||
|
||||
|
||||
# ════════════════════════════════════════════════════════════
|
||||
# 기본 정보(상품명·가격) 입력 검증 — 오른쪽 정보 패널
|
||||
# ════════════════════════════════════════════════════════════
|
||||
|
||||
@@ -14,6 +14,33 @@
|
||||
{# 읽기 지연 배너 — 카페24 관리자 API 가 아직 이전 값을 돌려주는 동안에는 마지막으로
|
||||
적용한 내용(MANUAL/SCHEDULED revision)을 편집기에 보여준다. 쇼핑몰 화면에는 이미
|
||||
반영돼 있다(실물 관찰). 지문도 이 값으로 만들어 다음 적용이 충돌로 오판되지 않는다. #}
|
||||
{# 반영 여부를 모르는 이전 적용 — 네트워크가 끊겼거나 처리 도중 멈춘 것. 확정 전에는 이 상품
|
||||
상세설명을 다시 쓰지 않는다(재적용 금지). 쇼핑몰을 보고 사람이 결과를 고른다.
|
||||
카페24 값이 그 적용 내용과 같아지면 다음 적용 때 자동으로 "반영됨"이 된다. #}
|
||||
{% for att in open_attempts or [] %}
|
||||
<div class="cf24-flash cf24-flash-err cf24-attempt" data-attempt-id="{{ att.id }}">
|
||||
<strong>적용 결과 확인 필요</strong> — {{ att.label }} · {{ att.status_label }}{% if att.error %} ({{ att.error }}){% endif %}.
|
||||
쇼핑몰 상세페이지를 열어 이 적용이 반영됐는지 확인한 뒤 고르세요. 확정하기 전에는 이 상품 상세설명을 다시 적용할 수 없습니다.
|
||||
<span class="cf24-attempt-actions">
|
||||
<form method="post" action="/cafe24/products/{{ product_no }}/attempts/{{ att.id }}/resolve" style="display:inline;"
|
||||
data-erp-confirm="쇼핑몰에서 이 적용 내용이 보이는 것을 확인했나요? 반영됨으로 기록합니다.">
|
||||
<input type="hidden" name="result" value="applied" />
|
||||
<input type="hidden" name="list_query" value="{{ list_query }}" />
|
||||
<button type="submit" class="erp-btn erp-btn-outline cf24-btn-inline">반영됨</button>
|
||||
</form>
|
||||
<form method="post" action="/cafe24/products/{{ product_no }}/attempts/{{ att.id }}/resolve" style="display:inline;"
|
||||
data-erp-confirm="이 적용이 쇼핑몰에 반영되지 않은 것을 확인했나요? 반영 안 됨으로 닫습니다(다시 적용은 직접 하세요).">
|
||||
<input type="hidden" name="result" value="not_applied" />
|
||||
<input type="hidden" name="list_query" value="{{ list_query }}" />
|
||||
<button type="submit" class="erp-btn erp-btn-outline cf24-btn-inline">반영 안 됨</button>
|
||||
</form>
|
||||
</span>
|
||||
</div>
|
||||
{% endfor %}
|
||||
|
||||
{# 적용·예약이 오류로 돌아왔을 때 브라우저에 남겨 둔 편집본을 여기서 되살린다(products.html JS). #}
|
||||
<div id="cf24-draft-slot"></div>
|
||||
|
||||
{% if sync_pending %}
|
||||
<div class="cf24-flash cf24-flash-warn" id="cf24-sync-banner">
|
||||
<strong>카페24 반영 대기 중</strong> — 카페24 관리자 API 가 아직 이전 소스를 돌려주고 있어
|
||||
@@ -199,28 +226,40 @@
|
||||
</form>
|
||||
</details>
|
||||
|
||||
<details class="cf24-details">
|
||||
<details class="cf24-details" id="cf24-history">
|
||||
<summary>버전 이력 {% if revisions %}({{ revisions | length }}건){% endif %}</summary>
|
||||
{% if revisions %}
|
||||
<div class="cf24-scroll">
|
||||
<table class="erp-table cf24-compact">
|
||||
<thead>
|
||||
<tr><th>시각</th><th>유형</th><th>길이</th><th>작업자</th><th>메모</th></tr>
|
||||
<tr><th>시각</th><th>유형</th><th>길이</th><th>작업자</th><th>메모</th><th></th></tr>
|
||||
</thead>
|
||||
<tbody>
|
||||
{% for rev in revisions %}
|
||||
<tr>
|
||||
<td class="cf24-nowrap">{{ rev.created_at }}</td>
|
||||
<td class="cf24-nowrap"><code>{{ rev.revision_type }}</code></td>
|
||||
<td class="cf24-nowrap" title="{{ rev.type_label }}">
|
||||
<code>{{ rev.revision_type }}</code>
|
||||
{% if rev.source == 'LAST_WRITE' %}<span class="cf24-muted" title="카페24가 읽기 지연 중이라 마지막으로 확인된 적용값을 백업했습니다">지연</span>{% endif %}
|
||||
</td>
|
||||
<td class="cf24-nowrap">{{ rev.html_length }}자</td>
|
||||
<td class="cf24-nowrap">{{ rev.created_by or '—' }}</td>
|
||||
<td>{{ rev.memo or '' }}</td>
|
||||
<td class="cf24-nowrap">
|
||||
{% if rev.html_length %}
|
||||
<button type="button" class="erp-btn erp-btn-outline cf24-btn-inline" data-rev-view="{{ rev.id }}">원문</button>
|
||||
{% endif %}
|
||||
</td>
|
||||
</tr>
|
||||
{% endfor %}
|
||||
</tbody>
|
||||
</table>
|
||||
</div>
|
||||
<p class="cf24-muted">버전 선택 복원은 Phase 6 에서 붙습니다. 내용은 모두 보관됩니다.</p>
|
||||
<p class="cf24-muted">
|
||||
「원문」에서 그 버전의 소스를 확인·복사하고, 필요하면 「이 버전으로 복원」으로 카페24에 다시 적용합니다.
|
||||
복원도 적용과 같은 순서(현재값 재조회 → 직전 내용 자동 백업 → 편집 중 변경 확인)를 거치며 이력에
|
||||
<code>ROLLBACK</code> 으로 남습니다. 자동 복원(예약 종료 후 되돌리기)은 쓰지 않습니다.
|
||||
</p>
|
||||
{% else %}
|
||||
<p class="cf24-muted">아직 이 상품의 변경 이력이 없습니다.</p>
|
||||
{% endif %}
|
||||
|
||||
@@ -1,7 +1,7 @@
|
||||
{% extends "erp_base.html" %}
|
||||
|
||||
{% block head_extra %}
|
||||
<link rel="stylesheet" href="/static/cafe24.css?v=20260819c" />
|
||||
<link rel="stylesheet" href="/static/cafe24.css?v=20261015a" />
|
||||
{% endblock %}
|
||||
|
||||
{% block content %}
|
||||
|
||||
@@ -1,7 +1,7 @@
|
||||
{% extends "erp_base.html" %}
|
||||
|
||||
{% block head_extra %}
|
||||
<link rel="stylesheet" href="/static/cafe24.css?v=20260918e" />
|
||||
<link rel="stylesheet" href="/static/cafe24.css?v=20261015a" />
|
||||
{% endblock %}
|
||||
|
||||
{% block content %}
|
||||
|
||||
@@ -1,7 +1,7 @@
|
||||
{% extends "erp_base.html" %}
|
||||
|
||||
{% block head_extra %}
|
||||
<link rel="stylesheet" href="/static/cafe24.css?v=20260819c" />
|
||||
<link rel="stylesheet" href="/static/cafe24.css?v=20261015a" />
|
||||
{% endblock %}
|
||||
|
||||
{% block content %}
|
||||
@@ -13,7 +13,7 @@
|
||||
<div class="erp-card cf24-card">
|
||||
<div class="cf24-card-head">
|
||||
<h3>예약 목록</h3>
|
||||
<span class="cf24-muted">대기 {{ pending }}건 · 최근 200건</span>
|
||||
<span class="cf24-muted">대기 {{ pending }}건{% if review %} · <strong class="cf24-err">확인 필요 {{ review }}건</strong>{% endif %} · 최근 200건</span>
|
||||
</div>
|
||||
|
||||
<p class="cf24-note">
|
||||
@@ -22,6 +22,11 @@
|
||||
적용 직전 내용은 상품별 <code>BACKUP</code> 버전으로 보관됩니다.
|
||||
<strong>대기</strong> 상태인 예약만 취소할 수 있습니다.
|
||||
</p>
|
||||
<p class="cf24-note">
|
||||
<strong>확인 필요</strong> — 카페24에 쓰는 도중 응답이 끊겼거나 worker 가 멈춰 반영 여부를 알 수 없는 예약입니다.
|
||||
자동으로 다시 실행하지 않습니다. 쇼핑몰에서 상세페이지·진열/판매를 확인한 뒤
|
||||
「반영됨」(완료로 기록) · 「다시 실행」 · 「실패로 종료」 중 하나를 고르세요.
|
||||
</p>
|
||||
|
||||
{% if rows %}
|
||||
<div class="cf24-scroll">
|
||||
@@ -53,12 +58,13 @@
|
||||
{% 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>
|
||||
{% elif r.status == 'PENDING' %}<span class="cf24-warn">{{ r.status_label }}</span>
|
||||
{% elif r.status == 'NEEDS_REVIEW' %}<span class="erp-badge cf24-badge-off">{{ r.status_label }}</span>
|
||||
{% else %}<span class="cf24-muted">{{ r.status_label }}</span>{% endif %}
|
||||
{% if r.retry_count %}<span class="cf24-muted">({{ r.retry_count }}회)</span>{% endif %}
|
||||
</td>
|
||||
<td>
|
||||
{{ r.memo or '' }}
|
||||
{% if r.last_error %}<div class="cf24-err">{{ r.last_error }}</div>{% endif %}
|
||||
{% if r.last_error %}<div class="{{ 'cf24-muted' if r.status == 'SUCCESS' else 'cf24-err' }}">{{ r.last_error }}</div>{% endif %}
|
||||
</td>
|
||||
<td class="cf24-nowrap">{{ r.created_by or '—' }}</td>
|
||||
<td class="cf24-nowrap">
|
||||
@@ -67,6 +73,22 @@
|
||||
data-erp-confirm="예약 #{{ r.id }} 을 취소할까요?">
|
||||
<button type="submit" class="erp-btn erp-btn-outline">취소</button>
|
||||
</form>
|
||||
{% elif r.needs_review %}
|
||||
<form method="post" action="/cafe24/schedules/{{ r.id }}/review" class="cf24-review-form"
|
||||
data-erp-confirm="쇼핑몰에서 반영된 것을 확인했나요? 예약 #{{ r.id }} 을 완료로 기록합니다.">
|
||||
<input type="hidden" name="action" value="applied" />
|
||||
<button type="submit" class="erp-btn erp-btn-outline">반영됨</button>
|
||||
</form>
|
||||
<form method="post" action="/cafe24/schedules/{{ r.id }}/review" class="cf24-review-form"
|
||||
data-erp-confirm="예약 #{{ r.id }} 을 다시 실행합니다. 이미 반영돼 있었다면 같은 내용을 한 번 더 적용합니다. 계속할까요?">
|
||||
<input type="hidden" name="action" value="rerun" />
|
||||
<button type="submit" class="erp-btn erp-btn-outline">다시 실행</button>
|
||||
</form>
|
||||
<form method="post" action="/cafe24/schedules/{{ r.id }}/review" class="cf24-review-form"
|
||||
data-erp-confirm="예약 #{{ r.id }} 을 실패로 종료할까요?">
|
||||
<input type="hidden" name="action" value="close" />
|
||||
<button type="submit" class="erp-btn erp-btn-outline">실패로 종료</button>
|
||||
</form>
|
||||
{% endif %}
|
||||
</td>
|
||||
</tr>
|
||||
|
||||
@@ -1,7 +1,7 @@
|
||||
{% extends "erp_base.html" %}
|
||||
|
||||
{% block head_extra %}
|
||||
<link rel="stylesheet" href="/static/cafe24.css?v=20260819c" />
|
||||
<link rel="stylesheet" href="/static/cafe24.css?v=20261015a" />
|
||||
{% endblock %}
|
||||
|
||||
{% block content %}
|
||||
|
||||
@@ -0,0 +1,523 @@
|
||||
"""카페24 모듈 단위 테스트용 대역 — 메모리 저장소 · 가짜 카페24 · 가짜 FTP.
|
||||
|
||||
실제 DB 의 동작(잠금 만료, SKIP LOCKED, JSONB 병합 등)은 이 대역으로 증명되지 않는다.
|
||||
그 부분은 test_cafe24_db.py(격리된 로컬 PostgreSQL)가 검증한다. 여기서는 쓰기 순서와
|
||||
분기(백업·충돌·결과 분류·복구 판정)를 빠르게 확인한다.
|
||||
"""
|
||||
|
||||
from __future__ import annotations
|
||||
|
||||
import copy
|
||||
import ftplib
|
||||
import itertools
|
||||
import uuid
|
||||
from contextlib import contextmanager
|
||||
from datetime import datetime, timedelta
|
||||
from typing import Any
|
||||
|
||||
from app.integrations.cafe24.errors import Cafe24ApiError
|
||||
from app.modules.cafe24 import store
|
||||
from app.timezone import KST, now_kst
|
||||
|
||||
|
||||
class MemoryStore:
|
||||
"""Cafe24Store 가 writes/worker/라우터에 주는 메서드를 메모리로 흉내낸다."""
|
||||
|
||||
def __init__(self) -> None:
|
||||
self._ids = itertools.count(1)
|
||||
self.revisions: dict[int, dict[str, Any]] = {}
|
||||
self.attempts: dict[int, dict[str, Any]] = {}
|
||||
self.locks: dict[str, dict[str, Any]] = {}
|
||||
self.schedules: dict[int, dict[str, Any]] = {}
|
||||
self.snapshots: dict[int, dict[str, Any]] = {}
|
||||
self.audits: list[dict[str, Any]] = []
|
||||
self.products: dict[int, dict[str, Any]] = {}
|
||||
self.fail_on: set[str] = set() # 이 메서드 이름이 들어 있으면 예외(기록 실패 재현)
|
||||
self.schema_ok = True
|
||||
|
||||
def _maybe_fail(self, name: str) -> None:
|
||||
if name in self.fail_on:
|
||||
raise RuntimeError(f"DB 장애({name})")
|
||||
|
||||
# ── 스키마 ──
|
||||
def write_schema_ready(self) -> bool:
|
||||
return self.schema_ok
|
||||
|
||||
# ── 잠금 ──
|
||||
def acquire_lock(self, key, *, owner, purpose, ttl_seconds):
|
||||
now = now_kst()
|
||||
held = self.locks.get(key)
|
||||
if held and held["expires_at"] > now:
|
||||
return None
|
||||
token = uuid.uuid4().hex
|
||||
self.locks[key] = {"owner": owner, "purpose": purpose, "token": token,
|
||||
"expires_at": now + timedelta(seconds=ttl_seconds)}
|
||||
return token
|
||||
|
||||
def renew_lock(self, key, token, *, ttl_seconds):
|
||||
held = self.locks.get(key)
|
||||
if not held or held["token"] != token or held["expires_at"] <= now_kst():
|
||||
return False
|
||||
held["expires_at"] = now_kst() + timedelta(seconds=ttl_seconds)
|
||||
return True
|
||||
|
||||
def release_lock(self, key, token):
|
||||
if self.locks.get(key, {}).get("token") == token:
|
||||
del self.locks[key]
|
||||
|
||||
def lock_holder(self, key):
|
||||
held = self.locks.get(key)
|
||||
return dict(held) if held and held["expires_at"] > now_kst() else {}
|
||||
|
||||
def expire_lock(self, key):
|
||||
if key in self.locks:
|
||||
self.locks[key]["expires_at"] = now_kst() - timedelta(seconds=1)
|
||||
|
||||
# ── 버전 ──
|
||||
def add_revision(self, *, product_no, html_content, revision_type, memo="", created_by="",
|
||||
mall_id="", shop_no=1, source="", source_revision_id=None):
|
||||
self._maybe_fail("add_revision")
|
||||
rid = next(self._ids)
|
||||
self.revisions[rid] = {
|
||||
"id": rid, "product_no": int(product_no), "html_content": html_content or "",
|
||||
"revision_type": store.normalize_revision_type(revision_type), "memo": memo,
|
||||
"created_by": created_by, "mall_id": mall_id, "shop_no": shop_no, "source": source,
|
||||
"source_revision_id": source_revision_id, "created_at": now_kst().isoformat(),
|
||||
}
|
||||
return rid
|
||||
|
||||
def get_revision(self, revision_id):
|
||||
return dict(self.revisions.get(int(revision_id), {}))
|
||||
|
||||
def list_revisions(self, product_no, *, limit=20):
|
||||
rows = [dict(r, html_length=len(r["html_content"])) for r in self.revisions.values()
|
||||
if r["product_no"] == int(product_no)]
|
||||
return sorted(rows, key=lambda r: -r["id"])[:limit]
|
||||
|
||||
def of_type(self, revision_type):
|
||||
return [r for r in self.revisions.values() if r["revision_type"] == revision_type]
|
||||
|
||||
# ── 쓰기 시도 ──
|
||||
def start_attempt(self, **fields):
|
||||
self._maybe_fail("start_attempt")
|
||||
aid = next(self._ids)
|
||||
row = {"id": aid, "status": store.ATTEMPT_STARTED, "error": "", "remote_updated_at": "",
|
||||
"remote_at": None, "resolved_by": "", "applied_revision_id": None,
|
||||
"created_at": now_kst(), "target_html": "", "target_revision_id": None,
|
||||
"observed_digest": "", "base_digest": "", "target_digest": "", "schedule_id": None,
|
||||
"set_display": None, "set_selling": None, "memo": "", "actor": "", "origin": "MANUAL"}
|
||||
row.update(fields)
|
||||
self.attempts[aid] = row
|
||||
return aid
|
||||
|
||||
def update_attempt(self, attempt_id, *, status=None, error=None, remote_updated_at=None,
|
||||
remote_ok=False, resolved_by=None, only_from=None):
|
||||
self._maybe_fail("update_attempt")
|
||||
row = self.attempts.get(int(attempt_id))
|
||||
if not row or (only_from and row["status"] not in only_from):
|
||||
return False
|
||||
if status is not None:
|
||||
row["status"] = status
|
||||
if error is not None:
|
||||
row["error"] = error
|
||||
if remote_updated_at is not None:
|
||||
row["remote_updated_at"] = remote_updated_at
|
||||
if remote_ok and row["remote_at"] is None:
|
||||
row["remote_at"] = now_kst()
|
||||
if resolved_by is not None:
|
||||
row["resolved_by"] = resolved_by
|
||||
return True
|
||||
|
||||
def record_attempt_revision(self, attempt_id, *, revision_type, memo, created_by, source="",
|
||||
source_revision_id=None):
|
||||
self._maybe_fail("record_attempt_revision")
|
||||
row = self.attempts[int(attempt_id)]
|
||||
if row.get("applied_revision_id"):
|
||||
return row["applied_revision_id"]
|
||||
body = row.get("target_html") or self.revisions.get(row.get("target_revision_id") or 0, {}).get("html_content", "")
|
||||
rid = self.add_revision(product_no=row["product_no"], html_content=body, revision_type=revision_type,
|
||||
memo=memo, created_by=created_by, mall_id=row.get("mall_id", ""),
|
||||
source=source, source_revision_id=source_revision_id)
|
||||
row.update(status=store.ATTEMPT_RECORDED, applied_revision_id=rid, target_html="")
|
||||
if row["remote_at"] is None:
|
||||
row["remote_at"] = now_kst()
|
||||
return rid
|
||||
|
||||
def get_attempt(self, attempt_id):
|
||||
return dict(self.attempts.get(int(attempt_id), {}))
|
||||
|
||||
def latest_attempt_for_schedule(self, schedule_id):
|
||||
rows = [a for a in self.attempts.values() if a.get("schedule_id") == int(schedule_id)]
|
||||
return dict(max(rows, key=lambda a: a["id"])) if rows else {}
|
||||
|
||||
def open_attempts(self, product_no, *, since):
|
||||
return [dict(a) for a in sorted(self.attempts.values(), key=lambda a: a["id"])
|
||||
if a["product_no"] == int(product_no) and a["status"] in store.ATTEMPT_OPEN
|
||||
and a["created_at"] >= since]
|
||||
|
||||
def attempts_needing_record(self, *, since, limit=20):
|
||||
return [dict(a) for a in self.attempts.values()
|
||||
if a["status"] == store.ATTEMPT_REMOTE_OK and a["created_at"] >= since][:limit]
|
||||
|
||||
def write_lineage(self, product_no, *, since, limit=30):
|
||||
rows = [a for a in self.attempts.values()
|
||||
if a["product_no"] == int(product_no) and a["status"] in store.ATTEMPT_CONFIRMED
|
||||
and a["target_digest"] and a["remote_at"] and a["remote_at"] >= since]
|
||||
rows.sort(key=lambda a: (a["remote_at"], a["id"]), reverse=True)
|
||||
out = []
|
||||
for i, a in enumerate(rows[:limit]):
|
||||
body = ""
|
||||
if i == 0:
|
||||
body = (a.get("target_html")
|
||||
or self.revisions.get(a.get("applied_revision_id") or 0, {}).get("html_content")
|
||||
or self.revisions.get(a.get("target_revision_id") or 0, {}).get("html_content") or "")
|
||||
out.append({**a, "created_at": a["remote_at"], "created_by": a.get("actor", ""), "html_content": body})
|
||||
return out
|
||||
|
||||
# ── 상품 캐시 · 스냅샷 ──
|
||||
def upsert_products(self, rows):
|
||||
self._maybe_fail("upsert_products")
|
||||
for r in rows:
|
||||
self.products[int(r["product_no"])] = dict(r)
|
||||
return len(rows)
|
||||
|
||||
def save_write_snapshot(self, product_no, section, data, *, replace=False):
|
||||
self._maybe_fail("save_write_snapshot")
|
||||
at = now_kst().isoformat(timespec="seconds")
|
||||
current = self.snapshots.setdefault(int(product_no), {})
|
||||
if section == "variants":
|
||||
previous = (current.get("variants") or {}).get("data") or {}
|
||||
data = store.merge_variant_snapshot(previous, data, at=at, replace=replace)
|
||||
current[section] = {"data": data, "written_at": at}
|
||||
|
||||
def get_write_snapshot(self, product_no):
|
||||
return dict(self.snapshots.get(int(product_no), {}))
|
||||
|
||||
# ── 예약 ──
|
||||
def add_schedule(self, **fields):
|
||||
sid = next(self._ids)
|
||||
row = {"id": sid, "product_no": 131, "revision_id": None, "set_display": None, "set_selling": None,
|
||||
"status": store.STATUS_PENDING, "retry_count": 0, "next_retry_at": None, "last_error": "",
|
||||
"scheduled_at": now_kst() - timedelta(minutes=1), "lease_token": "", "lease_owner": "",
|
||||
"lease_expires_at": None, "started_at": None}
|
||||
row.update(fields)
|
||||
self.schedules[sid] = row
|
||||
return sid
|
||||
|
||||
def claim_due_schedule(self, *, now, owner, ttl_seconds):
|
||||
due = [s for s in sorted(self.schedules.values(), key=lambda s: (s["scheduled_at"], s["id"]))
|
||||
if s["status"] == store.STATUS_PENDING and s["scheduled_at"] <= now
|
||||
and (s["next_retry_at"] is None or s["next_retry_at"] <= now)]
|
||||
if not due:
|
||||
return None
|
||||
row = due[0]
|
||||
row.update(status=store.STATUS_PROCESSING, lease_owner=owner, lease_token=uuid.uuid4().hex,
|
||||
lease_expires_at=now_kst() + timedelta(seconds=ttl_seconds), started_at=now_kst(),
|
||||
last_error="")
|
||||
return dict(row)
|
||||
|
||||
def claim_expired_schedules(self, *, owner, ttl_seconds, legacy_minutes, limit=20):
|
||||
out = []
|
||||
for row in self.schedules.values():
|
||||
if row["status"] != store.STATUS_PROCESSING:
|
||||
continue
|
||||
expired = row["lease_expires_at"] is not None and row["lease_expires_at"] < now_kst()
|
||||
legacy = row["lease_expires_at"] is None and (row["started_at"] or now_kst()) < now_kst() - timedelta(minutes=legacy_minutes)
|
||||
if expired or legacy:
|
||||
row.update(lease_owner=owner, lease_token=uuid.uuid4().hex,
|
||||
lease_expires_at=now_kst() + timedelta(seconds=ttl_seconds))
|
||||
out.append(dict(row))
|
||||
return out[:limit]
|
||||
|
||||
def renew_schedule_lease(self, schedule_id, token, *, ttl_seconds):
|
||||
row = self.schedules.get(int(schedule_id))
|
||||
if (not row or row["status"] != store.STATUS_PROCESSING or row["lease_token"] != token
|
||||
or row["lease_expires_at"] <= now_kst()):
|
||||
return False
|
||||
row["lease_expires_at"] = now_kst() + timedelta(seconds=ttl_seconds)
|
||||
return True
|
||||
|
||||
def finish_schedule(self, schedule_id, *, token, status, error="", next_retry_at=None, retry_count=None):
|
||||
self._maybe_fail("finish_schedule")
|
||||
row = self.schedules.get(int(schedule_id))
|
||||
if not row or row["status"] != store.STATUS_PROCESSING or row["lease_token"] != token:
|
||||
return False
|
||||
row.update(status=store.normalize_schedule_status(status), last_error=error, next_retry_at=next_retry_at,
|
||||
lease_token="", lease_owner="", lease_expires_at=None)
|
||||
if retry_count is not None:
|
||||
row["retry_count"] = retry_count
|
||||
return True
|
||||
|
||||
def expire_schedule_lease(self, schedule_id):
|
||||
self.schedules[int(schedule_id)]["lease_expires_at"] = now_kst() - timedelta(seconds=1)
|
||||
|
||||
def get_schedule(self, schedule_id):
|
||||
return dict(self.schedules.get(int(schedule_id), {}))
|
||||
|
||||
def review_schedule(self, schedule_id, *, status, note, actor, action):
|
||||
row = self.schedules.get(int(schedule_id))
|
||||
if not row or row["status"] != store.STATUS_NEEDS_REVIEW:
|
||||
return {}
|
||||
row.update(status=status, last_error=note,
|
||||
next_retry_at=now_kst() if status == store.STATUS_PENDING else None)
|
||||
if status != store.STATUS_SUCCESS:
|
||||
for a in self.attempts.values():
|
||||
if a.get("schedule_id") == int(schedule_id) and a["status"] in (store.ATTEMPT_STARTED, store.ATTEMPT_UNKNOWN):
|
||||
a.update(status=store.ATTEMPT_ABANDONED, resolved_by=actor)
|
||||
return dict(row)
|
||||
|
||||
# ── 감사 ──
|
||||
def log_audit(self, **fields):
|
||||
self._maybe_fail("log_audit")
|
||||
self.audits.append(fields)
|
||||
|
||||
def log_api_call(self, **_fields):
|
||||
pass
|
||||
|
||||
|
||||
class FakeConfig:
|
||||
mall_id = "testmall"
|
||||
shop_base = "https://testmall.cafe24.com"
|
||||
|
||||
def product_url(self, no):
|
||||
return f"https://testmall.cafe24.com/product/detail.html?product_no={no}"
|
||||
|
||||
|
||||
class FakeCafe24:
|
||||
"""카페24 상품 API 대역 — 상세설명·진열/판매·updated_date 를 들고 있고,
|
||||
읽기 지연(lag)·PUT 실패·응답 유실을 흉내낸다."""
|
||||
|
||||
def __init__(self, description: str = "<p>A</p>", *, product_no: int = 131):
|
||||
self.product_no = product_no
|
||||
self.state = {"product_no": product_no, "product_name": "상품", "product_code": "P000000B",
|
||||
"description": description, "mobile_description": description,
|
||||
"separated_mobile_description": "F", "display": "T", "selling": "T",
|
||||
"updated_date": "2026-09-30T10:00:00+09:00"}
|
||||
self.stale: dict | None = None # 설정하면 GET 이 이 값을 돌려준다(읽기 지연)
|
||||
self.put_error: Exception | None = None
|
||||
self.put_error_after_apply = False # True 면 반영한 뒤 오류(응답 유실)
|
||||
self.calls: list[tuple] = []
|
||||
self._clock = 0
|
||||
self.option: dict = {"has_option": "F", "options": []}
|
||||
self.variants: list = []
|
||||
self.stale_option: dict | None = None # 설정하면 GET options 가 이 값을 돌려준다
|
||||
self.stale_variants: list | None = None # 설정하면 GET variants 가 이 값을 돌려준다
|
||||
self.hidden_variants = 0 # 새로 생긴 품목이 GET 에 늦게 나타나는 횟수
|
||||
self.fail_variant_chunk = 0 # n번째 PUT variants 묶음을 실패시킨다
|
||||
self.variant_error: Exception | None = None
|
||||
self._variant_puts = 0
|
||||
self._code_seq = 0
|
||||
|
||||
def external_edit(self, description: str) -> None:
|
||||
"""카페24 관리자에서 사람이 직접 고친 것."""
|
||||
self._tick()
|
||||
self.state.update(description=description, mobile_description=description)
|
||||
|
||||
def _tick(self) -> None:
|
||||
self._clock += 1
|
||||
self.state["updated_date"] = (datetime(2026, 9, 30, 10, 0, tzinfo=KST)
|
||||
+ timedelta(minutes=self._clock)).isoformat()
|
||||
|
||||
# Cafe24Client 흉내 — products.* 래퍼가 부르는 get/put
|
||||
def get(self, path, **kw):
|
||||
self.calls.append(("GET", path))
|
||||
if path == f"/admin/products/{self.product_no}":
|
||||
return {"product": dict(self.stale if self.stale is not None else self.state)}
|
||||
out = self._options_call("GET", path, None)
|
||||
return copy.deepcopy(out) if out is not None else {}
|
||||
|
||||
# ── 옵션 / 품목 ── (상태는 __init__ 에서 만든다)
|
||||
|
||||
def _new_code(self) -> str:
|
||||
self._code_seq += 1
|
||||
return f"P000000B{self._code_seq:04X}"
|
||||
|
||||
def _options_call(self, method, path, json):
|
||||
no = self.product_no
|
||||
req = (json or {}).get("request") or {}
|
||||
if path == f"/admin/products/{no}/options":
|
||||
if method == "GET":
|
||||
return {"option": self.stale_option if self.stale_option is not None else self.option}
|
||||
if method == "POST":
|
||||
opt = req["options"][0]
|
||||
values = [{"option_text": v["option_text"], "value_no": i + 1} for i, v in enumerate(opt["option_value"])]
|
||||
self.option = {"has_option": "T", "option_type": "T", "option_list_type": "S",
|
||||
"options": [{"option_name": opt["option_name"], "option_code": "O1",
|
||||
"option_display_type": opt.get("option_display_type", "S"),
|
||||
"option_value": values}]}
|
||||
self.variants = [{"variant_code": self._new_code(), "options": [{"name": opt["option_name"], "value": v["option_text"]}],
|
||||
"custom_variant_code": "", "additional_amount": "0.00", "display": "T", "selling": "T"}
|
||||
for v in values]
|
||||
return {"option": self.option}
|
||||
if method == "PUT":
|
||||
new = req["options"]
|
||||
for gi, group in enumerate(new):
|
||||
cur = self.option["options"][gi]
|
||||
old_name = cur["option_name"]
|
||||
old_values = [v["option_text"] for v in cur["option_value"]]
|
||||
cur["option_name"] = group["option_name"]
|
||||
vals = []
|
||||
for vi, v in enumerate(group["option_value"]):
|
||||
vals.append({"option_text": v["option_text"], "value_no": vi + 1,
|
||||
"option_image_file": v.get("option_image_file", "")})
|
||||
if vi < len(old_values):
|
||||
for var in self.variants:
|
||||
for o in var["options"]:
|
||||
if o["name"] == old_name and o["value"] == old_values[vi]:
|
||||
o["value"] = v["option_text"]
|
||||
else:
|
||||
self.variants.append({"variant_code": self._new_code(),
|
||||
"options": [{"name": group["option_name"], "value": v["option_text"]}],
|
||||
"custom_variant_code": "", "additional_amount": "0.00",
|
||||
"display": "T", "selling": "T", "_new": True})
|
||||
for var in self.variants:
|
||||
for o in var["options"]:
|
||||
if o["name"] == old_name:
|
||||
o["name"] = group["option_name"]
|
||||
cur["option_value"] = vals
|
||||
return {"option": self.option}
|
||||
if method == "DELETE":
|
||||
self.option = {"has_option": "F", "options": []}
|
||||
self.variants = []
|
||||
return {"option": {"product_no": no}}
|
||||
if path == f"/admin/products/{no}/variants":
|
||||
if method == "GET":
|
||||
if self.stale_variants is not None:
|
||||
return {"variants": [dict(v) for v in self.stale_variants]}
|
||||
shown = [dict(v) for v in self.variants]
|
||||
if self.hidden_variants > 0:
|
||||
self.hidden_variants -= 1
|
||||
shown = [v for v in shown if not v.get("_new")]
|
||||
return {"variants": shown}
|
||||
if method == "PUT":
|
||||
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)
|
||||
out = []
|
||||
for r in (json or {}).get("requests") or []:
|
||||
for var in self.variants:
|
||||
if var["variant_code"] == r["variant_code"]:
|
||||
var.update({k: v for k, v in r.items() if k != "variant_code"})
|
||||
out.append(dict(var))
|
||||
return {"variants": out}
|
||||
if path.startswith(f"/admin/products/{no}/variants/") and method == "DELETE":
|
||||
code = path.rsplit("/", 1)[1]
|
||||
self.variants = [v for v in self.variants if v["variant_code"] != code]
|
||||
return {"variant": {"variant_code": code}}
|
||||
return None
|
||||
|
||||
def post(self, path, *, json=None, **kw):
|
||||
self.calls.append(("POST", path, json))
|
||||
out = self._options_call("POST", path, json)
|
||||
return copy.deepcopy(out) if out is not None else {}
|
||||
|
||||
def delete(self, path, **kw):
|
||||
self.calls.append(("DELETE", path))
|
||||
out = self._options_call("DELETE", path, None)
|
||||
return out if out is not None else {}
|
||||
|
||||
def put(self, path, *, json=None, **kw):
|
||||
self.calls.append(("PUT", path, json))
|
||||
if path != f"/admin/products/{self.product_no}":
|
||||
out = self._options_call("PUT", path, json)
|
||||
return copy.deepcopy(out) if out is not None else {}
|
||||
if self.put_error is not None and not self.put_error_after_apply:
|
||||
raise self.put_error
|
||||
req = (json or {}).get("request", {})
|
||||
self._tick()
|
||||
for key in ("description", "display", "selling", "product_name", "separated_mobile_description"):
|
||||
if key in req:
|
||||
self.state[key] = req[key]
|
||||
if "description" in req:
|
||||
self.state["mobile_description"] = req["description"]
|
||||
if self.put_error is not None:
|
||||
raise self.put_error
|
||||
return {"product": dict(self.state)}
|
||||
|
||||
def puts(self):
|
||||
return [c for c in self.calls if c[0] == "PUT"]
|
||||
|
||||
|
||||
class FakeApi:
|
||||
def __init__(self, client):
|
||||
self.client = client
|
||||
self.config = FakeConfig()
|
||||
|
||||
|
||||
def network_error(maybe_applied: bool = True) -> Cafe24ApiError:
|
||||
return Cafe24ApiError("네트워크 오류 (ReadTimeout)", status=0, maybe_applied=maybe_applied)
|
||||
|
||||
|
||||
class FakeFTP:
|
||||
"""ftplib.FTP 대역 — RETR/STOR/RNFR·RNTO/DELE 를 메모리 파일로. 실패를 주입할 수 있다."""
|
||||
|
||||
files: dict[str, bytes] = {}
|
||||
rename_mode = "overwrite" # overwrite | no_overwrite | unsupported
|
||||
truncate_store = False # STOR 가 앞부분만 쓰고 끝난 것처럼
|
||||
on_before_rename = None # 교체 직전 끼어들기(남이 원본을 바꿈 등)
|
||||
log: list[tuple] = []
|
||||
|
||||
def __init__(self):
|
||||
pass
|
||||
|
||||
def connect(self, host, port, timeout=None):
|
||||
FakeFTP.log.append(("connect",))
|
||||
|
||||
def login(self, user, password):
|
||||
pass
|
||||
|
||||
def set_pasv(self, value):
|
||||
pass
|
||||
|
||||
def retrbinary(self, cmd, callback):
|
||||
path = cmd.split(" ", 1)[1]
|
||||
if path not in self.files:
|
||||
raise ftplib.error_perm("550 No such file")
|
||||
callback(self.files[path])
|
||||
|
||||
def storbinary(self, cmd, fp):
|
||||
path = cmd.split(" ", 1)[1]
|
||||
data = fp.read()
|
||||
FakeFTP.log.append(("STOR", path))
|
||||
self.files[path] = data[: len(data) // 2] if FakeFTP.truncate_store else data
|
||||
|
||||
def rename(self, src, dst):
|
||||
FakeFTP.log.append(("RENAME", src, dst))
|
||||
if FakeFTP.on_before_rename is not None:
|
||||
hook, FakeFTP.on_before_rename = FakeFTP.on_before_rename, None
|
||||
hook(self.files)
|
||||
if FakeFTP.rename_mode == "unsupported":
|
||||
raise ftplib.error_perm("502 RNFR not implemented")
|
||||
if src not in self.files:
|
||||
raise ftplib.error_perm("550 No such file")
|
||||
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)
|
||||
|
||||
def delete(self, path):
|
||||
FakeFTP.log.append(("DELE", path))
|
||||
self.files.pop(path, None)
|
||||
|
||||
def quit(self):
|
||||
pass
|
||||
|
||||
def close(self):
|
||||
pass
|
||||
|
||||
@classmethod
|
||||
def reset(cls, files):
|
||||
cls.files = dict(files)
|
||||
cls.rename_mode = "overwrite"
|
||||
cls.truncate_store = False
|
||||
cls.on_before_rename = None
|
||||
cls.log = []
|
||||
|
||||
|
||||
@contextmanager
|
||||
def patched_ftp():
|
||||
saved = ftplib.FTP
|
||||
ftplib.FTP = FakeFTP
|
||||
try:
|
||||
yield FakeFTP
|
||||
finally:
|
||||
ftplib.FTP = saved
|
||||
@@ -8,6 +8,7 @@ DB/네트워크 없이 검증한다(가짜 저장소 + refresh 함수 주입).
|
||||
from __future__ import annotations
|
||||
|
||||
import ftplib
|
||||
import logging
|
||||
import os
|
||||
from contextlib import contextmanager
|
||||
from datetime import timedelta
|
||||
@@ -15,7 +16,8 @@ from datetime import timedelta
|
||||
from app.integrations.cafe24 import config as cfgmod
|
||||
from app.integrations.cafe24 import crypto, oauth, products, tokens
|
||||
from app.integrations.cafe24.errors import Cafe24ApiError, Cafe24AuthError, Cafe24ConfigError
|
||||
from app.modules.cafe24 import store, worker
|
||||
from app.modules.cafe24 import store, worker, writes
|
||||
from app.modules.cafe24.tests import fakes
|
||||
from app.timezone import now_kst
|
||||
|
||||
SECRET = "unit-test-secret"
|
||||
@@ -23,8 +25,27 @@ SECRET = "unit-test-secret"
|
||||
# wait_for_description 은 실물 카페24 API 의 쓰기 직후 읽기 지연을 흡수하려고
|
||||
# 실제로 sleep 한다. 가짜 클라이언트는 그 지연을 재현하지 않으므로(항상 같은
|
||||
# 값을 돌려줌) 재시도 예산을 다 채우게 되는데, 테스트에서까지 그 시간을 그대로
|
||||
# 기다릴 필요는 없다.
|
||||
products.time.sleep = lambda *_a, **_k: None
|
||||
# 기다릴 필요는 없다. products.time 은 공유 time 모듈이라 import 때 바꾸면 다른 테스트의
|
||||
# time.sleep 까지 바뀐다 — 이 파일 테스트 동안만 바꾼다(pytest fixture / 직접 실행은 _run_all, 검토 F10).
|
||||
_NO_SLEEP = lambda *_a, **_k: None # noqa: E731
|
||||
|
||||
try:
|
||||
import pytest
|
||||
except ImportError: # 직접 실행은 pytest 없이도 돈다
|
||||
pytest = None
|
||||
|
||||
if pytest is not None:
|
||||
@pytest.fixture(autouse=True, scope="module")
|
||||
def _no_sleep_in_this_file():
|
||||
prev = products.time.sleep
|
||||
products.time.sleep = _NO_SLEEP
|
||||
try:
|
||||
yield
|
||||
finally:
|
||||
products.time.sleep = prev
|
||||
|
||||
# 장애 주입 테스트가 남기는 logger.exception 출력은 결과와 무관하다 — 조용히.
|
||||
logging.getLogger("cafe24").setLevel(logging.CRITICAL)
|
||||
|
||||
_TEST_ENV = {
|
||||
"CAFE24_MALL_ID": "testmall",
|
||||
@@ -711,203 +732,303 @@ def test_design_file_path_env_override():
|
||||
os.environ["CAFE24_PC_DETAIL_FTP_PATH"] = saved
|
||||
|
||||
|
||||
class _FakeFTP:
|
||||
"""ftplib.FTP 대역 — 실제 소켓 없이 RETR/STOR 명령만 흉내낸다."""
|
||||
|
||||
files: dict[str, bytes] = {}
|
||||
|
||||
def __init__(self):
|
||||
self.calls = []
|
||||
|
||||
def connect(self, host, port, timeout=None):
|
||||
self.calls.append(("connect", host, port))
|
||||
|
||||
def login(self, user, password):
|
||||
self.calls.append(("login", user, password))
|
||||
|
||||
def set_pasv(self, value):
|
||||
pass
|
||||
|
||||
def retrbinary(self, cmd, callback):
|
||||
path = cmd.split(" ", 1)[1]
|
||||
if path not in self.files:
|
||||
raise ftplib.error_perm("550 No such file")
|
||||
callback(self.files[path])
|
||||
|
||||
def storbinary(self, cmd, fp):
|
||||
path = cmd.split(" ", 1)[1]
|
||||
self.files[path] = fp.read()
|
||||
|
||||
def quit(self):
|
||||
self.calls.append(("quit",))
|
||||
_FTP_CFG = cfgmod.Cafe24FtpConfig(host="h", port=21, user="u", password="p")
|
||||
_SWIPER = "/sde_design/mobile11/product-swiper/product-swiper.js"
|
||||
|
||||
|
||||
def test_design_ftp_read_and_write_roundtrip():
|
||||
from app.integrations.cafe24 import design_ftp
|
||||
|
||||
path = "/sde_design/mobile11/product-swiper/product-swiper.js"
|
||||
_FakeFTP.files = {path: "old".encode("utf-8")}
|
||||
saved = ftplib.FTP
|
||||
ftplib.FTP = _FakeFTP
|
||||
try:
|
||||
cfg = cfgmod.Cafe24FtpConfig(host="h", port=21, user="u", password="p")
|
||||
content = design_ftp.read_text_file(cfg, path)
|
||||
assert content == "old"
|
||||
|
||||
design_ftp.write_text_file(cfg, path, "new content")
|
||||
assert design_ftp.read_text_file(cfg, path) == "new content"
|
||||
finally:
|
||||
ftplib.FTP = saved
|
||||
with fakes.patched_ftp() as ftp:
|
||||
ftp.reset({_SWIPER: "old".encode("utf-8")})
|
||||
assert design_ftp.read_text_file(_FTP_CFG, _SWIPER) == "old"
|
||||
design_ftp.write_text_file(_FTP_CFG, _SWIPER, "new content", expected_current="old")
|
||||
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 any(e[0] == "RENAME" and e[2] == _SWIPER for e in ftp.log)
|
||||
# 임시 파일이 남지 않는다
|
||||
assert set(ftp.files) == {_SWIPER}
|
||||
|
||||
|
||||
def test_design_ftp_missing_file_raises_cafe24_error():
|
||||
from app.integrations.cafe24 import design_ftp
|
||||
from app.integrations.cafe24.errors import Cafe24FtpError
|
||||
|
||||
_FakeFTP.files = {}
|
||||
saved = ftplib.FTP
|
||||
ftplib.FTP = _FakeFTP
|
||||
try:
|
||||
cfg = cfgmod.Cafe24FtpConfig(host="h", port=21, user="u", password="p")
|
||||
with fakes.patched_ftp() as ftp:
|
||||
ftp.reset({})
|
||||
try:
|
||||
design_ftp.read_text_file(cfg, "/missing.js")
|
||||
design_ftp.read_text_file(_FTP_CFG, "/missing.js")
|
||||
raise AssertionError("Cafe24FtpError 가 났어야 한다")
|
||||
except Cafe24FtpError:
|
||||
pass
|
||||
finally:
|
||||
ftplib.FTP = saved
|
||||
|
||||
|
||||
def test_design_ftp_truncated_upload_keeps_original():
|
||||
"""[04] 전송이 잘려도 원본은 그대로 — 임시 파일 검증에서 멈춘다."""
|
||||
from app.integrations.cafe24 import design_ftp
|
||||
from app.integrations.cafe24.errors import Cafe24FtpError
|
||||
|
||||
with fakes.patched_ftp() as ftp:
|
||||
ftp.reset({_SWIPER: b"ORIGINAL"})
|
||||
ftp.truncate_store = True
|
||||
try:
|
||||
design_ftp.write_text_file(_FTP_CFG, _SWIPER, "NEW CONTENT 1234", expected_current="ORIGINAL")
|
||||
raise AssertionError("잘린 업로드를 성공으로 처리했다")
|
||||
except Cafe24FtpError as exc:
|
||||
assert exc.maybe_applied is False
|
||||
assert ftp.files == {_SWIPER: b"ORIGINAL"} # 원본 그대로 + 임시 파일 정리
|
||||
|
||||
|
||||
def test_design_ftp_rename_unsupported_aborts_without_direct_stor():
|
||||
"""[04] 이름 바꾸기를 지원하지 않으면 중단 — 원본에 직접 쓰지 않는다."""
|
||||
from app.integrations.cafe24 import design_ftp
|
||||
from app.integrations.cafe24.errors import Cafe24FtpError
|
||||
|
||||
with fakes.patched_ftp() as ftp:
|
||||
ftp.reset({_SWIPER: b"ORIGINAL"})
|
||||
ftp.rename_mode = "unsupported"
|
||||
try:
|
||||
design_ftp.write_text_file(_FTP_CFG, _SWIPER, "NEW", expected_current="ORIGINAL")
|
||||
raise AssertionError("rename 미지원인데 진행했다")
|
||||
except Cafe24FtpError as exc:
|
||||
assert "rename" in str(exc)
|
||||
assert ftp.files == {_SWIPER: b"ORIGINAL"}
|
||||
assert not any(e == ("STOR", _SWIPER) for e in ftp.log)
|
||||
|
||||
|
||||
def test_design_ftp_no_overwrite_rename_swaps_safely():
|
||||
"""덮어쓰기 rename 을 거부하는 서버 — 원본을 비킨 뒤 교체하고 비킨 파일은 지운다."""
|
||||
from app.integrations.cafe24 import design_ftp
|
||||
|
||||
with fakes.patched_ftp() as ftp:
|
||||
ftp.reset({_SWIPER: b"ORIGINAL"})
|
||||
ftp.rename_mode = "no_overwrite"
|
||||
design_ftp.write_text_file(_FTP_CFG, _SWIPER, "NEW", expected_current="ORIGINAL")
|
||||
assert ftp.files == {_SWIPER: b"NEW"}
|
||||
|
||||
|
||||
def test_design_ftp_conflict_right_before_replace():
|
||||
"""[04] 교체 직전 원본이 바뀌어 있으면(남이 수정) 덮지 않고 멈춘다."""
|
||||
from app.integrations.cafe24 import design_ftp
|
||||
from app.integrations.cafe24.errors import Cafe24FtpConflict
|
||||
|
||||
with fakes.patched_ftp() as ftp:
|
||||
ftp.reset({_SWIPER: b"SOMEONE ELSE"})
|
||||
try:
|
||||
design_ftp.write_text_file(_FTP_CFG, _SWIPER, "MINE", expected_current="ORIGINAL")
|
||||
raise AssertionError("충돌을 못 잡았다")
|
||||
except Cafe24FtpConflict:
|
||||
pass
|
||||
assert ftp.files == {_SWIPER: b"SOMEONE ELSE"}
|
||||
|
||||
|
||||
# ════════════════════════════════════════════════════════════
|
||||
# 예약 worker — 성공/재시도/최종실패
|
||||
# 예약 worker — 성공/재시도/최종실패/확인 필요/중단 복구 (메모리 저장소 대역)
|
||||
# 실제 DB 의 lease·SKIP LOCKED 는 test_cafe24_db.py 에서 검증한다.
|
||||
# ════════════════════════════════════════════════════════════
|
||||
class _FakeStore:
|
||||
"""worker 가 쓰는 저장소 메서드만 흉내낸다."""
|
||||
|
||||
def __init__(self, rows):
|
||||
self.rows = list(rows)
|
||||
self.revisions = {}
|
||||
self.added = []
|
||||
self.finished = []
|
||||
self.audits = []
|
||||
|
||||
@contextmanager
|
||||
def claim_due_schedule(self, *, now):
|
||||
yield self.rows.pop(0) if self.rows else None
|
||||
|
||||
def get_revision(self, revision_id):
|
||||
return self.revisions.get(int(revision_id), {})
|
||||
|
||||
def add_revision(self, **fields):
|
||||
self.added.append(fields)
|
||||
return 900 + len(self.added)
|
||||
|
||||
def save_write_snapshot(self, product_no, section, data):
|
||||
self.snapshots = getattr(self, "snapshots", [])
|
||||
self.snapshots.append((product_no, section, data))
|
||||
|
||||
def finish_schedule(self, schedule_id, *, status, error="", next_retry_at=None, retry_count=None):
|
||||
self.finished.append(
|
||||
{"id": schedule_id, "status": status, "error": error,
|
||||
"next_retry_at": next_retry_at, "retry_count": retry_count}
|
||||
)
|
||||
|
||||
def log_audit(self, **fields):
|
||||
self.audits.append(fields)
|
||||
|
||||
|
||||
class _FakeApi:
|
||||
def __init__(self, client):
|
||||
self.client = client
|
||||
|
||||
|
||||
class _WorkerClient(_FakeClient):
|
||||
"""PUT 을 실패시킬 수 있는 클라이언트."""
|
||||
|
||||
def __init__(self, payload=None, fail_put=None):
|
||||
super().__init__(payload)
|
||||
self.fail_put = fail_put
|
||||
|
||||
def put(self, path, *, params=None, json=None, product_no=None):
|
||||
if self.fail_put:
|
||||
raise self.fail_put
|
||||
return super().put(path, params=params, json=json, product_no=product_no)
|
||||
|
||||
|
||||
def _schedule_row(**overrides):
|
||||
row = {
|
||||
"id": 7, "product_no": 131, "revision_id": 55,
|
||||
"set_display": True, "set_selling": None, "retry_count": 0,
|
||||
}
|
||||
row.update(overrides)
|
||||
return row
|
||||
def _worker_env(description="<p>A</p>", **schedule):
|
||||
st = fakes.MemoryStore()
|
||||
cafe = fakes.FakeCafe24(description)
|
||||
api = fakes.FakeApi(cafe)
|
||||
rid = st.add_revision(product_no=131, html_content="<p>예약 내용</p>", revision_type="DRAFT")
|
||||
fields = {"revision_id": rid, "set_display": True}
|
||||
fields.update(schedule)
|
||||
sid = st.add_schedule(**fields)
|
||||
return st, cafe, api, sid, rid
|
||||
|
||||
|
||||
def test_worker_applies_html_and_flags():
|
||||
st = _FakeStore([_schedule_row()])
|
||||
st.revisions[55] = {"html_content": "<p>예약 내용</p>"}
|
||||
client = _WorkerClient({"product": _PRODUCT})
|
||||
assert worker.process_once(st, _FakeApi(client)) == 1
|
||||
st, cafe, api, sid, _rid = _worker_env()
|
||||
assert worker.process_once(st, api) == 1
|
||||
|
||||
# 쓰기 직전 현재값을 읽어 BACKUP 을 남겼는가
|
||||
assert any(r["revision_type"] == store.REVISION_BACKUP for r in st.added)
|
||||
backups = st.of_type(store.REVISION_BACKUP)
|
||||
assert backups and backups[0]["html_content"] == "<p>A</p>"
|
||||
assert backups[0]["source"] == store.SOURCE_OBSERVED
|
||||
# HTML 과 진열 상태를 한 번의 PUT 으로 보냈는가
|
||||
put = [c for c in client.calls if c["method"] == "PUT"][0]
|
||||
assert put["json"]["request"]["description"] == "<p>예약 내용</p>"
|
||||
put = cafe.puts()[0]
|
||||
assert put[2]["request"]["description"] == "<p>예약 내용</p>"
|
||||
# mobile_description 은 보내지 않는다 — separated_mobile_description="F" 로
|
||||
# "PC 상세설명과 동일"을 강제한다(직접 보내면 "직접 등록"으로 바뀌어버린다).
|
||||
assert "mobile_description" not in put["json"]["request"]
|
||||
assert put["json"]["request"]["separated_mobile_description"] == "F"
|
||||
assert put["json"]["request"]["display"] == "T"
|
||||
assert "selling" not in put["json"]["request"] # 변경 없음이면 보내지 않는다
|
||||
assert st.finished == [
|
||||
{"id": 7, "status": store.STATUS_SUCCESS, "error": "",
|
||||
"next_retry_at": None, "retry_count": None}
|
||||
]
|
||||
assert "mobile_description" not in put[2]["request"]
|
||||
assert put[2]["request"]["separated_mobile_description"] == "F"
|
||||
assert put[2]["request"]["display"] == "T"
|
||||
assert "selling" not in put[2]["request"] # 변경 없음이면 보내지 않는다
|
||||
row = st.schedules[sid]
|
||||
assert row["status"] == store.STATUS_SUCCESS and row["last_error"] == ""
|
||||
assert row["lease_token"] == "" # 끝나면 lease 를 비운다
|
||||
assert len(st.of_type(store.REVISION_SCHEDULED)) == 1
|
||||
assert list(st.attempts.values())[0]["status"] == store.ATTEMPT_RECORDED
|
||||
assert st.locks == {} # 상품 잠금 해제
|
||||
|
||||
|
||||
def test_worker_flags_only_skips_backup():
|
||||
"""HTML 없이 진열/판매만 바꾸는 예약은 상세설명을 읽거나 백업하지 않는다."""
|
||||
st = _FakeStore([_schedule_row(revision_id=None, set_selling=False)])
|
||||
client = _WorkerClient({"product": _PRODUCT})
|
||||
assert worker.process_once(st, _FakeApi(client)) == 1
|
||||
assert st.added == [] # 백업 없음
|
||||
put = [c for c in client.calls if c["method"] == "PUT"][0]
|
||||
assert "description" not in put["json"]["request"]
|
||||
assert put["json"]["request"] == {"display": "T", "selling": "F"}
|
||||
st, cafe, api, sid, _ = _worker_env(revision_id=None, set_selling=False)
|
||||
before = len(st.revisions)
|
||||
assert worker.process_once(st, api) == 1
|
||||
assert len(st.revisions) == before # 백업·SCHEDULED 버전 없음
|
||||
put = cafe.puts()[0]
|
||||
assert put[2]["request"] == {"display": "T", "selling": "F"}
|
||||
assert st.schedules[sid]["status"] == store.STATUS_SUCCESS
|
||||
|
||||
|
||||
def test_worker_retries_then_fails():
|
||||
"""실패는 재시도 예산 안에서 다시 시도하고, 소진되면 FAILED 로 확정한다."""
|
||||
boom = Cafe24ApiError("서버 오류", status=500)
|
||||
|
||||
st = _FakeStore([_schedule_row(retry_count=0)])
|
||||
st.revisions[55] = {"html_content": "<p>x</p>"}
|
||||
worker.process_once(st, _FakeApi(_WorkerClient({"product": _PRODUCT}, fail_put=boom)))
|
||||
first = st.finished[0]
|
||||
"""거절(반영 안 됨이 확실)은 재시도 예산 안에서 다시 시도하고, 소진되면 FAILED."""
|
||||
st, cafe, api, sid, _ = _worker_env()
|
||||
cafe.put_error = Cafe24ApiError("잘못된 요청", status=422)
|
||||
worker.process_once(st, api)
|
||||
first = st.schedules[sid]
|
||||
assert first["status"] == store.STATUS_PENDING # 다시 대기로
|
||||
assert first["retry_count"] == 1
|
||||
assert first["next_retry_at"] is not None
|
||||
assert list(st.attempts.values())[-1]["status"] == store.ATTEMPT_REMOTE_FAILED
|
||||
|
||||
st2 = _FakeStore([_schedule_row(retry_count=store.MAX_RETRY)])
|
||||
st2.revisions[55] = {"html_content": "<p>x</p>"}
|
||||
worker.process_once(st2, _FakeApi(_WorkerClient({"product": _PRODUCT}, fail_put=boom)))
|
||||
assert st2.finished[0]["status"] == store.STATUS_FAILED
|
||||
st2, cafe2, api2, sid2, _ = _worker_env(retry_count=store.MAX_RETRY)
|
||||
cafe2.put_error = Cafe24ApiError("서버 오류", status=400)
|
||||
worker.process_once(st2, api2)
|
||||
assert st2.schedules[sid2]["status"] == store.STATUS_FAILED
|
||||
assert any(a["result"] == "FAIL" for a in st2.audits)
|
||||
|
||||
|
||||
def test_worker_missing_revision_is_failure_not_crash():
|
||||
st = _FakeStore([_schedule_row(revision_id=999, retry_count=store.MAX_RETRY)])
|
||||
worker.process_once(st, _FakeApi(_WorkerClient({"product": _PRODUCT})))
|
||||
assert st.finished[0]["status"] == store.STATUS_FAILED
|
||||
assert "999" in st.finished[0]["error"]
|
||||
st, _cafe, api, sid, _ = _worker_env(revision_id=999, retry_count=store.MAX_RETRY)
|
||||
worker.process_once(st, api)
|
||||
assert st.schedules[sid]["status"] == store.STATUS_FAILED
|
||||
assert "999" in st.schedules[sid]["last_error"]
|
||||
|
||||
|
||||
def test_worker_stops_when_nothing_due():
|
||||
st = _FakeStore([])
|
||||
assert worker.process_once(st, _FakeApi(_WorkerClient())) == 0
|
||||
st = fakes.MemoryStore()
|
||||
assert worker.process_once(st, fakes.FakeApi(fakes.FakeCafe24())) == 0
|
||||
|
||||
|
||||
def test_worker_unknown_result_needs_review_not_retry():
|
||||
"""[05][07] 응답 유실(반영 여부 모름) — 재시도로 한 번 더 쓰지 않고 확인 필요로 둔다."""
|
||||
st, cafe, api, sid, _ = _worker_env()
|
||||
cafe.put_error = fakes.network_error(maybe_applied=True)
|
||||
cafe.put_error_after_apply = True
|
||||
worker.process_once(st, api)
|
||||
assert st.schedules[sid]["status"] == store.STATUS_NEEDS_REVIEW
|
||||
assert list(st.attempts.values())[-1]["status"] == store.ATTEMPT_UNKNOWN
|
||||
worker.process_once(st, api)
|
||||
assert len(cafe.puts()) == 1 # 다시 쓰지 않았다
|
||||
|
||||
|
||||
def test_worker_remote_ok_but_record_failure_is_success_not_failed():
|
||||
"""[07] PUT 성공 뒤 로컬 버전 기록 실패 → FAILED 가 아니라 SUCCESS + 기록 복구 메모, 재적용 없음."""
|
||||
st, cafe, api, sid, _ = _worker_env()
|
||||
st.fail_on.add("record_attempt_revision")
|
||||
worker.process_once(st, api)
|
||||
row = st.schedules[sid]
|
||||
assert row["status"] == store.STATUS_SUCCESS, row
|
||||
assert "기록" in row["last_error"]
|
||||
attempt = list(st.attempts.values())[-1]
|
||||
assert attempt["status"] == store.ATTEMPT_REMOTE_OK # 반영됨, 기록 복구 대기
|
||||
# 다음 주기: 기록 복구만 하고 다시 PUT 하지 않는다
|
||||
st.fail_on.clear()
|
||||
worker.process_once(st, api)
|
||||
assert len(cafe.puts()) == 1
|
||||
assert attempt["status"] == store.ATTEMPT_RECORDED
|
||||
assert len(st.of_type(store.REVISION_SCHEDULED)) == 1
|
||||
|
||||
|
||||
def test_worker_busy_product_defers_without_burning_retry():
|
||||
"""[02] 같은 상품을 다른 작업이 쓰는 중이면 쓰지 않고 잠시 뒤로 미룬다(재시도 횟수 그대로)."""
|
||||
st, cafe, api, sid, _ = _worker_env()
|
||||
st.acquire_lock("product:131", owner="king|web:1", purpose="상세설명 적용", ttl_seconds=60)
|
||||
worker.process_once(st, api)
|
||||
row = st.schedules[sid]
|
||||
assert row["status"] == store.STATUS_PENDING and row["retry_count"] == 0
|
||||
assert row["next_retry_at"] is not None
|
||||
assert cafe.puts() == []
|
||||
|
||||
|
||||
def test_worker_backup_uses_confirmed_last_write_during_lag():
|
||||
"""[06] 예약 직전 카페24가 읽기 지연으로 옛 HTML 을 돌려줘도, 백업은 마지막 확인된 적용값."""
|
||||
st, cafe, api, sid, _ = _worker_env(description="<p>OLD</p>")
|
||||
# 방금 웹에서 NEW 를 적용(확인된 쓰기) — 카페24 GET 은 아직 OLD
|
||||
with writes.write_lock(st, "product:131", actor="king", purpose="t") as lock:
|
||||
writes.write_product(st, api, 131, lock=lock, origin=store.ORIGIN_MANUAL, actor="king",
|
||||
html="<p>NEW</p>", wait_confirm=False)
|
||||
cafe.stale = {**cafe.state, "description": "<p>OLD</p>", "mobile_description": "<p>OLD</p>",
|
||||
"updated_date": "2026-09-30T09:00:00+09:00"}
|
||||
worker.process_once(st, api)
|
||||
backups = [r for r in st.of_type(store.REVISION_BACKUP) if "예약" in r["memo"]]
|
||||
assert backups and backups[-1]["html_content"] == "<p>NEW</p>", backups
|
||||
assert backups[-1]["source"] == store.SOURCE_LAST_WRITE
|
||||
|
||||
|
||||
def test_worker_recovers_expired_processing_by_attempt_state():
|
||||
"""[05] lease 만료 PROCESSING — 시도 기록으로 판정(무조건 PENDING 금지)."""
|
||||
st = fakes.MemoryStore()
|
||||
cafe = fakes.FakeCafe24("<p>A</p>")
|
||||
api = fakes.FakeApi(cafe)
|
||||
rid = st.add_revision(product_no=131, html_content="<p>예약</p>", revision_type="DRAFT")
|
||||
|
||||
def processing(**fields):
|
||||
sid = st.add_schedule(revision_id=rid, status=store.STATUS_PROCESSING,
|
||||
lease_token="dead", started_at=now_kst(), **fields)
|
||||
st.expire_schedule_lease(sid)
|
||||
return sid
|
||||
|
||||
# (1) 원격 쓰기 전에 죽음 → 재시도 대기
|
||||
s1 = processing()
|
||||
# (2) 반영·기록까지 끝난 뒤 죽음 → 완료
|
||||
s2 = processing()
|
||||
st.start_attempt(product_no=131, schedule_id=s2, origin="SCHEDULED", target_digest="x",
|
||||
target_revision_id=rid)
|
||||
st.attempts[max(st.attempts)]["status"] = store.ATTEMPT_RECORDED
|
||||
# (3) 반영됐고 기록 전에 죽음 → 기록 채우고 완료(재적용 없음)
|
||||
s3 = processing()
|
||||
a3 = st.start_attempt(product_no=131, schedule_id=s3, origin="SCHEDULED",
|
||||
target_digest=store.content_digest("<p>예약</p>"), target_revision_id=rid)
|
||||
st.attempts[a3]["status"] = store.ATTEMPT_REMOTE_OK
|
||||
# (4) PUT 도중 죽음, 카페24 값은 예약 결과와 다름 → 확인 필요
|
||||
s4 = processing()
|
||||
st.start_attempt(product_no=131, schedule_id=s4, origin="SCHEDULED",
|
||||
target_digest=store.content_digest("<p>예약</p>"), target_revision_id=rid)
|
||||
# (5) 레거시(lease 없음) PROCESSING, 40분 전 → 만료로 보고 재시도 대기
|
||||
s5 = st.add_schedule(revision_id=rid, status=store.STATUS_PROCESSING, lease_token="",
|
||||
started_at=now_kst() - timedelta(minutes=40))
|
||||
|
||||
worker.recover(st, api)
|
||||
assert st.schedules[s1]["status"] == store.STATUS_PENDING and st.schedules[s1]["retry_count"] == 1
|
||||
assert st.schedules[s2]["status"] == store.STATUS_SUCCESS
|
||||
assert st.schedules[s3]["status"] == store.STATUS_SUCCESS
|
||||
assert st.attempts[a3]["status"] == store.ATTEMPT_RECORDED
|
||||
assert st.schedules[s4]["status"] == store.STATUS_NEEDS_REVIEW
|
||||
assert st.schedules[s5]["status"] == store.STATUS_PENDING
|
||||
assert cafe.puts() == [] # 복구는 쓰지 않는다
|
||||
|
||||
|
||||
def test_worker_recover_verifies_remote_value():
|
||||
"""[05] 결과 모름 시도라도 카페24 현재값이 예약 결과와 같으면 반영됨으로 확정."""
|
||||
st = fakes.MemoryStore()
|
||||
cafe = fakes.FakeCafe24("<p>예약</p>") # 이미 반영돼 있다
|
||||
api = fakes.FakeApi(cafe)
|
||||
rid = st.add_revision(product_no=131, html_content="<p>예약</p>", revision_type="DRAFT")
|
||||
sid = st.add_schedule(revision_id=rid, status=store.STATUS_PROCESSING, lease_token="dead",
|
||||
started_at=now_kst())
|
||||
st.expire_schedule_lease(sid)
|
||||
aid = st.start_attempt(product_no=131, schedule_id=sid, origin="SCHEDULED",
|
||||
target_digest=store.content_digest("<p>예약</p>"), target_revision_id=rid)
|
||||
worker.recover(st, api)
|
||||
assert st.schedules[sid]["status"] == store.STATUS_SUCCESS
|
||||
assert st.attempts[aid]["status"] == store.ATTEMPT_RECORDED
|
||||
|
||||
|
||||
def test_worker_late_finish_after_lease_loss_does_not_overwrite():
|
||||
"""[05] lease 를 잃은 worker 의 늦은 결과는 반영되지 않는다(token 불일치)."""
|
||||
st, _cafe, _api, sid, _ = _worker_env()
|
||||
row = st.claim_due_schedule(now=now_kst(), owner="w1", ttl_seconds=60)
|
||||
st.expire_schedule_lease(sid)
|
||||
st.claim_expired_schedules(owner="w2", ttl_seconds=60, legacy_minutes=30)
|
||||
assert st.finish_schedule(sid, token=row["lease_token"], status=store.STATUS_FAILED) is False
|
||||
assert st.schedules[sid]["status"] == store.STATUS_PROCESSING
|
||||
|
||||
# ════════════════════════════════════════════════════════════
|
||||
# 카페24 읽기 지연 보정 — 마지막 쓰기가 권위
|
||||
# ════════════════════════════════════════════════════════════
|
||||
@@ -1185,7 +1306,8 @@ def test_upload_images_and_variants_wrappers():
|
||||
assert products.list_variants(client, 7) == [{"variant_code": "P000000R000A"}]
|
||||
assert products.get_options(client, 7)["has_option"] == "T"
|
||||
assert products.update_variants(client, 7, [{"variant_code": "P000000R000A", "display": "F"}]) == [
|
||||
{"variant_code": "P000000R000A", "display": "F"}
|
||||
{"variant_code": "P000000R000A", "status": "ok", "error": "",
|
||||
"variant": {"variant_code": "P000000R000A", "display": "F"}}
|
||||
]
|
||||
sent = [c for c in client.calls if c[0] == "PUT"][-1]
|
||||
assert sent[2]["requests"][0]["variant_code"] == "P000000R000A"
|
||||
@@ -1221,7 +1343,406 @@ def test_set_main_image_uses_product_images_endpoint():
|
||||
assert products.set_main_image(client, 13, b"") == {}
|
||||
|
||||
|
||||
# ════════════════════════════════════════════════════════════
|
||||
# 쓰기 공통 처리(writes.write_product) — [01][02][06][07] 회귀
|
||||
# ════════════════════════════════════════════════════════════
|
||||
def _apply(st, api, html, *, fp=None, origin=store.ORIGIN_MANUAL, actor="king", **kw):
|
||||
with writes.write_lock(st, "product:131", actor=actor, purpose="t", wait_seconds=0) as lock:
|
||||
return writes.write_product(st, api, 131, lock=lock, origin=origin, actor=actor, html=html,
|
||||
base_fingerprint=fp, wait_confirm=False, **kw)
|
||||
|
||||
|
||||
def _editor_view(st, cafe):
|
||||
"""편집기가 보여줄 유효 현재값과 지문(routes_products._editor_ctx 와 같은 판정)."""
|
||||
product = cafe.get(f"/admin/products/{cafe.product_no}")["product"]
|
||||
effective, state, _ = writes.resolve_effective(st, 131, product["description"],
|
||||
fetched_updated=product.get("updated_date"))
|
||||
return effective, state, store.fingerprint(effective)
|
||||
|
||||
|
||||
def test_01_rejected_conflict_backup_does_not_mask_external_edit():
|
||||
"""[01] 충돌로 거절된 적용의 BACKUP(=외부 값 X)이 읽기 지연 근거가 되면 X 를 덮어쓴다."""
|
||||
st = fakes.MemoryStore()
|
||||
cafe = fakes.FakeCafe24("<p>A</p>")
|
||||
api = fakes.FakeApi(cafe)
|
||||
_apply(st, api, "<p>W1</p>") # 우리 쓰기(확인됨)
|
||||
_eff, _state, stale_fp = _editor_view(st, cafe) # 사용자 1: W1 을 보고 편집 시작
|
||||
cafe.external_edit("<p>X</p>") # 관리자에서 직접 X 로 고침
|
||||
|
||||
try:
|
||||
_apply(st, api, "<p>Y</p>", fp=stale_fp) # 사용자 1 적용 → 충돌로 거절(BACKUP X 가 남는다)
|
||||
raise AssertionError("충돌을 못 잡았다")
|
||||
except writes.WriteConflict:
|
||||
pass
|
||||
assert any(r["html_content"] == "<p>X</p>" for r in st.of_type(store.REVISION_BACKUP))
|
||||
|
||||
effective, state, fp = _editor_view(st, cafe)
|
||||
assert (effective, state) == ("<p>X</p>", store.SYNC_EXTERNAL), (effective, state)
|
||||
try:
|
||||
_apply(st, api, "<p>Y</p>", fp=stale_fp) # 같은 옛 지문으로 다시 → 여전히 충돌
|
||||
raise AssertionError("외부 수정 X 를 덮어썼다")
|
||||
except writes.WriteConflict:
|
||||
pass
|
||||
assert cafe.state["description"] == "<p>X</p>"
|
||||
_apply(st, api, "<p>Y</p>", fp=fp) # 새로 본 X 기준이면 적용된다
|
||||
assert cafe.state["description"] == "<p>Y</p>"
|
||||
|
||||
|
||||
def test_01_draft_value_is_not_treated_as_known():
|
||||
"""[01] 예약 초안(DRAFT)은 카페24에 올라간 적이 없다 — 관리자가 그 값으로 고쳐도 외부 변경."""
|
||||
st = fakes.MemoryStore()
|
||||
cafe = fakes.FakeCafe24("<p>A</p>")
|
||||
api = fakes.FakeApi(cafe)
|
||||
_apply(st, api, "<p>W1</p>")
|
||||
st.add_revision(product_no=131, html_content="<p>D</p>", revision_type="DRAFT")
|
||||
cafe.external_edit("<p>D</p>")
|
||||
assert _editor_view(st, cafe)[:2] == ("<p>D</p>", store.SYNC_EXTERNAL)
|
||||
|
||||
|
||||
def test_01_read_lag_still_shows_last_confirmed_write():
|
||||
"""읽기 지연 보정은 유지 — GET 이 쓰기 직전 값(A)을 돌려주면 마지막 확인된 쓰기를 보여준다."""
|
||||
st = fakes.MemoryStore()
|
||||
cafe = fakes.FakeCafe24("<p>A</p>")
|
||||
api = fakes.FakeApi(cafe)
|
||||
_apply(st, api, "<p>B</p>")
|
||||
cafe.stale = {**cafe.state, "description": "<p>A</p>", "updated_date": "2026-09-30T09:00:00+09:00"}
|
||||
assert _editor_view(st, cafe)[:2] == ("<p>B</p>", store.SYNC_PENDING)
|
||||
_apply(st, api, "<p>C</p>") # A→B→C 직후 GET 이 A 여도 지연
|
||||
assert _editor_view(st, cafe)[:2] == ("<p>C</p>", store.SYNC_PENDING)
|
||||
|
||||
|
||||
def test_01_revert_after_our_write_detected_by_updated_date():
|
||||
"""[01] 관리자가 우리 적용 뒤 예전 값(A)으로 되돌림 — updated_date 가 더 뒤라 외부 변경."""
|
||||
st = fakes.MemoryStore()
|
||||
cafe = fakes.FakeCafe24("<p>A</p>")
|
||||
api = fakes.FakeApi(cafe)
|
||||
_apply(st, api, "<p>B</p>")
|
||||
cafe.external_edit("<p>A</p>")
|
||||
assert _editor_view(st, cafe)[:2] == ("<p>A</p>", store.SYNC_EXTERNAL)
|
||||
|
||||
|
||||
def test_01_failed_write_is_not_lineage():
|
||||
"""[01] 카페24가 거절한 쓰기는 "마지막 쓰기"가 아니다."""
|
||||
st = fakes.MemoryStore()
|
||||
cafe = fakes.FakeCafe24("<p>A</p>")
|
||||
api = fakes.FakeApi(cafe)
|
||||
cafe.put_error = Cafe24ApiError("거절", status=422)
|
||||
try:
|
||||
_apply(st, api, "<p>B</p>")
|
||||
raise AssertionError("실패를 삼켰다")
|
||||
except writes.RemoteWriteFailed:
|
||||
pass
|
||||
assert list(st.attempts.values())[-1]["status"] == store.ATTEMPT_REMOTE_FAILED
|
||||
assert _editor_view(st, cafe)[:2] == ("<p>A</p>", store.SYNC_NONE)
|
||||
assert st.of_type(store.REVISION_MANUAL) == []
|
||||
|
||||
|
||||
def test_02_second_writer_is_serialized_and_detects_conflict():
|
||||
"""[02] 같은 편집 기준(A)으로 두 사람이 동시에 적용 — 잠금으로 순서가 생기고 뒤 사람은 충돌."""
|
||||
st = fakes.MemoryStore()
|
||||
cafe = fakes.FakeCafe24("<p>A</p>")
|
||||
api = fakes.FakeApi(cafe)
|
||||
fp_a = store.fingerprint("<p>A</p>")
|
||||
with writes.write_lock(st, "product:131", actor="alice", purpose="t", wait_seconds=0):
|
||||
try: # 앞 사람이 쓰는 동안 뒤 사람은 잠금을 못 잡는다
|
||||
with writes.write_lock(st, "product:131", actor="bob", purpose="t", wait_seconds=0):
|
||||
raise AssertionError("잠금이 겹쳤다")
|
||||
except writes.WriteBusy as exc:
|
||||
assert "alice" in str(exc)
|
||||
_apply(st, api, "<p>ALICE</p>", fp=fp_a, actor="alice")
|
||||
cafe.stale = {**cafe.state, "description": "<p>A</p>", "updated_date": "2026-09-30T09:00:00+09:00"}
|
||||
try: # GET 이 지연으로 A 를 돌려줘도, 마지막 확인된 쓰기(ALICE)가 기준이라 충돌
|
||||
_apply(st, api, "<p>BOB</p>", fp=fp_a, actor="bob")
|
||||
raise AssertionError("둘 다 성공했다")
|
||||
except writes.WriteConflict:
|
||||
pass
|
||||
assert cafe.state["description"] == "<p>ALICE</p>"
|
||||
|
||||
|
||||
def test_02_expired_lock_cannot_write_fencing():
|
||||
"""[02] 잠금이 만료돼 남에게 넘어간 뒤에는 PUT 하지 않는다(펜싱)."""
|
||||
st = fakes.MemoryStore()
|
||||
cafe = fakes.FakeCafe24("<p>A</p>")
|
||||
api = fakes.FakeApi(cafe)
|
||||
with writes.write_lock(st, "product:131", actor="slow", purpose="t", wait_seconds=0) as lock:
|
||||
st.expire_lock("product:131")
|
||||
with writes.write_lock(st, "product:131", actor="other", purpose="t", wait_seconds=0):
|
||||
pass # 만료 뒤 다른 요청이 가져갔다가 풀었다
|
||||
try:
|
||||
writes.write_product(st, api, 131, lock=lock, origin="MANUAL", actor="slow",
|
||||
html="<p>S</p>", wait_confirm=False)
|
||||
raise AssertionError("만료된 잠금으로 썼다")
|
||||
except writes.WriteBusy:
|
||||
pass
|
||||
assert cafe.puts() == []
|
||||
|
||||
|
||||
def test_02_schema_missing_refuses_to_write():
|
||||
st = fakes.MemoryStore()
|
||||
st.schema_ok = False
|
||||
try:
|
||||
with writes.write_lock(st, "product:131", actor="k", purpose="t"):
|
||||
raise AssertionError("스키마 없이 잠금을 줬다")
|
||||
except writes.WriteSetupError as exc:
|
||||
assert "005" in str(exc)
|
||||
|
||||
|
||||
def test_06_manual_backup_marks_source():
|
||||
"""[06] BACKUP 메타데이터 — 관측값(OBSERVED) / 지연 중 마지막 확인된 쓰기(LAST_WRITE)."""
|
||||
st = fakes.MemoryStore()
|
||||
cafe = fakes.FakeCafe24("<p>A</p>")
|
||||
api = fakes.FakeApi(cafe)
|
||||
first = _apply(st, api, "<p>B</p>")
|
||||
b1 = st.revisions[first.backup_id]
|
||||
assert (b1["html_content"], b1["source"]) == ("<p>A</p>", store.SOURCE_OBSERVED)
|
||||
cafe.stale = {**cafe.state, "description": "<p>A</p>", "updated_date": "2026-09-30T09:00:00+09:00"}
|
||||
second = _apply(st, api, "<p>C</p>")
|
||||
b2 = st.revisions[second.backup_id]
|
||||
assert (b2["html_content"], b2["source"]) == ("<p>B</p>", store.SOURCE_LAST_WRITE)
|
||||
assert b2["source_revision_id"] == first.revision_id
|
||||
|
||||
|
||||
def test_07_manual_record_failure_is_not_apply_failure():
|
||||
"""[07] PUT 성공 뒤 버전 기록 실패 — 예외 없이 record_error, 시도는 REMOTE_OK(기록 복구 대기)."""
|
||||
st = fakes.MemoryStore()
|
||||
cafe = fakes.FakeCafe24("<p>A</p>")
|
||||
api = fakes.FakeApi(cafe)
|
||||
st.fail_on.add("record_attempt_revision")
|
||||
out = _apply(st, api, "<p>B</p>")
|
||||
assert out.record_error and not out.revision_id
|
||||
attempt = st.attempts[out.attempt_id]
|
||||
assert attempt["status"] == store.ATTEMPT_REMOTE_OK and attempt["target_html"] == "<p>B</p>"
|
||||
# 기록이 없어도 확인된 쓰기로 본다 — 지연 중에도 B 를 보여준다
|
||||
cafe.stale = {**cafe.state, "description": "<p>A</p>", "updated_date": "2026-09-30T09:00:00+09:00"}
|
||||
assert _editor_view(st, cafe)[:2] == ("<p>B</p>", store.SYNC_PENDING)
|
||||
# 다음 쓰기 때 기록을 채운다(다시 PUT 하지 않음)
|
||||
st.fail_on.clear()
|
||||
puts = len(cafe.puts())
|
||||
cafe.stale = None
|
||||
_apply(st, api, "<p>C</p>")
|
||||
assert attempt["status"] == store.ATTEMPT_RECORDED and attempt["target_html"] == ""
|
||||
assert len(cafe.puts()) == puts + 1 # C 쓰기 한 번뿐
|
||||
|
||||
|
||||
def test_07_unknown_result_blocks_rewrite_until_verified():
|
||||
"""[07] 응답 유실 — UNKNOWN. 확정 전에는 같은 상품 상세설명을 다시 쓰지 않는다.
|
||||
카페24 값이 그 시도의 결과와 같아지면(=반영됨) 자동으로 확정한다."""
|
||||
st = fakes.MemoryStore()
|
||||
cafe = fakes.FakeCafe24("<p>A</p>")
|
||||
api = fakes.FakeApi(cafe)
|
||||
cafe.put_error = fakes.network_error(maybe_applied=True)
|
||||
try:
|
||||
_apply(st, api, "<p>B</p>")
|
||||
raise AssertionError("결과 모름을 성공/실패로 판정했다")
|
||||
except writes.RemoteWriteUnknown as exc:
|
||||
aid = exc.attempt_id
|
||||
assert st.attempts[aid]["status"] == store.ATTEMPT_UNKNOWN
|
||||
cafe.put_error = None
|
||||
try:
|
||||
_apply(st, api, "<p>C</p>")
|
||||
raise AssertionError("결과 모름 시도가 있는데 또 썼다")
|
||||
except writes.WriteBlocked:
|
||||
pass
|
||||
cafe.state.update(description="<p>B</p>") # 확인해 보니 반영돼 있었다
|
||||
_apply(st, api, "<p>C</p>")
|
||||
assert st.attempts[aid]["status"] == store.ATTEMPT_RECORDED
|
||||
assert [r["html_content"] for r in st.of_type(store.REVISION_MANUAL)] == ["<p>B</p>", "<p>C</p>"]
|
||||
|
||||
|
||||
def test_07_connect_error_is_definite_failure():
|
||||
"""연결조차 안 된 오류는 반영 안 됨이 확실 — UNKNOWN 이 아니라 REMOTE_FAILED."""
|
||||
st = fakes.MemoryStore()
|
||||
cafe = fakes.FakeCafe24("<p>A</p>")
|
||||
cafe.put_error = fakes.network_error(maybe_applied=False)
|
||||
try:
|
||||
_apply(st, fakes.FakeApi(cafe), "<p>B</p>")
|
||||
except writes.RemoteWriteFailed:
|
||||
pass
|
||||
assert list(st.attempts.values())[-1]["status"] == store.ATTEMPT_REMOTE_FAILED
|
||||
|
||||
|
||||
def test_rollback_records_rollback_revision():
|
||||
"""[13] 선택 복원은 정상 경로로 한 번 적용하고 ROLLBACK(원본 버전 표시)을 남긴다."""
|
||||
st = fakes.MemoryStore()
|
||||
cafe = fakes.FakeCafe24("<p>A</p>")
|
||||
api = fakes.FakeApi(cafe)
|
||||
first = _apply(st, api, "<p>B</p>")
|
||||
backup = first.backup_id # A
|
||||
out = _apply(st, api, st.revisions[backup]["html_content"], fp=store.fingerprint("<p>B</p>"),
|
||||
origin=store.ORIGIN_ROLLBACK, target_revision_id=backup, memo=f"버전 {backup} 복원")
|
||||
assert cafe.state["description"] == "<p>A</p>"
|
||||
rb = st.revisions[out.revision_id]
|
||||
assert rb["revision_type"] == "ROLLBACK" and rb["source_revision_id"] == backup
|
||||
assert rb["html_content"] == "<p>A</p>"
|
||||
|
||||
|
||||
# ════════════════════════════════════════════════════════════
|
||||
# 스냅샷 병합 · 품목 표기 · 옵션 모양 — [10][11]
|
||||
# ════════════════════════════════════════════════════════════
|
||||
def test_11_variant_snapshot_field_merge():
|
||||
at = now_kst().isoformat()
|
||||
a = store.merge_variant_snapshot({}, {"V1": {"custom_variant_code": "C1"}}, at=at)
|
||||
b = store.merge_variant_snapshot(a, {"V1": {"display": "F"}}, at=at)
|
||||
assert b["V1"]["custom_variant_code"] == "C1" and b["V1"]["display"] == "F"
|
||||
|
||||
|
||||
def test_11_empty_patch_is_not_reset_but_replace_is():
|
||||
at = now_kst().isoformat()
|
||||
a = store.merge_variant_snapshot({}, {"V1": {"display": "F"}}, at=at)
|
||||
assert store.merge_variant_snapshot(a, {}, at=at) == a
|
||||
assert store.merge_variant_snapshot(a, {}, at=at, replace=True) == {}
|
||||
|
||||
|
||||
def test_11_deleted_variant_is_not_resurrected():
|
||||
at = now_kst().isoformat()
|
||||
a = store.merge_variant_snapshot({}, {"V1": {"_deleted": True}}, at=at)
|
||||
b = store.merge_variant_snapshot(a, {"V1": {"display": "T", "custom_variant_code": "X"}}, at=at)
|
||||
assert b["V1"].get("_deleted") is True and "custom_variant_code" not in b["V1"]
|
||||
v = store.apply_variant_patch({"variant_code": "V1"}, b["V1"], section_written_at=at, grace_minutes=60)
|
||||
assert v is None
|
||||
|
||||
|
||||
def test_11_per_code_grace():
|
||||
old = (now_kst() - timedelta(hours=10)).isoformat()
|
||||
patch = {"display": "F", "_at": old}
|
||||
v = store.apply_variant_patch({"variant_code": "V1", "display": "T"}, patch,
|
||||
section_written_at=now_kst().isoformat(), grace_minutes=60)
|
||||
assert v["display"] == "T" # 그 품목 기록은 유예시간이 지났다
|
||||
|
||||
|
||||
def test_10_lagging_variant_labels_matched_by_code():
|
||||
"""[10] 옵션값 이름 변경 직후 GET 품목이 옛 이름 — 품목코드 기록으로 새 이름을 보여준다."""
|
||||
at = now_kst().isoformat()
|
||||
patch = {"options": [{"name": "색상", "value": "Jet"}], "_options_before": [[{"name": "색상", "value": "Black"}]],
|
||||
"_at": at}
|
||||
lag = store.apply_variant_patch({"variant_code": "V1", "options": [{"name": "색상", "value": "Black"}]},
|
||||
patch, section_written_at=at, grace_minutes=60)
|
||||
assert lag["options"] == [{"name": "색상", "value": "Jet"}]
|
||||
ext = store.apply_variant_patch({"variant_code": "V1", "options": [{"name": "색상", "value": "Onyx"}]},
|
||||
patch, section_written_at=at, grace_minutes=60)
|
||||
assert ext["options"] == [{"name": "색상", "value": "Onyx"}] # 관리자에서 다시 고친 이름은 믿는다
|
||||
|
||||
|
||||
def test_10_options_overlay_respects_external_change():
|
||||
at = now_kst().isoformat()
|
||||
before = {"has_option": "T", "options": [{"option_name": "색상", "option_value": [{"option_text": "Black"}]}]}
|
||||
ours = {"has_option": "T", "options": [{"option_name": "색상", "option_value": [{"option_text": "Jet"}]}]}
|
||||
other = {"has_option": "T", "options": [{"option_name": "색상", "option_value": [{"option_text": "Onyx"}]}]}
|
||||
snap = {**ours, "_before_signatures": [store.options_signature(before)]}
|
||||
assert store.overlay_options(before, snapshot=snap, written_at=at, grace_minutes=60) == (snap, True)
|
||||
assert store.overlay_options(other, snapshot=snap, written_at=at, grace_minutes=60) == (other, False)
|
||||
assert store.overlay_options(ours, snapshot=snap, written_at=at, grace_minutes=60) == (ours, False)
|
||||
|
||||
|
||||
def test_05_recovery_decision_table():
|
||||
rd = store.recovery_decision
|
||||
assert rd(None, 0)[0] == store.RECOVER_RETRY
|
||||
assert rd(None, store.MAX_RETRY)[0] == store.RECOVER_FAIL
|
||||
assert rd({"status": "RECORDED"}, 0)[0] == store.RECOVER_SUCCESS
|
||||
assert rd({"status": "REMOTE_OK"}, 0)[0] == store.RECOVER_RECORD
|
||||
assert rd({"status": "REMOTE_FAILED"}, 0)[0] == store.RECOVER_RETRY
|
||||
assert rd({"status": "STARTED"}, 0)[0] == store.RECOVER_REVIEW
|
||||
assert rd({"status": "UNKNOWN"}, 99)[0] == store.RECOVER_REVIEW # 예산과 무관하게 사람 확인
|
||||
|
||||
|
||||
def test_resolve_description_updated_date_rule():
|
||||
lw = {"html_content": "B", "created_at": now_kst(), "remote_updated_at": "2026-09-30T10:05:00+09:00"}
|
||||
digests = {store.content_digest("A")}
|
||||
newer = store.resolve_description("A", last_write=lw, known_digests=digests, grace_minutes=60,
|
||||
fetched_updated="2026-09-30T10:06:00+09:00")
|
||||
same = store.resolve_description("A", last_write=lw, known_digests=digests, grace_minutes=60,
|
||||
fetched_updated="2026-09-30T10:05:00+09:00")
|
||||
older = store.resolve_description("A", last_write=lw, known_digests=digests, grace_minutes=60,
|
||||
fetched_updated="2026-09-30T10:00:00+09:00")
|
||||
assert newer == ("A", store.SYNC_EXTERNAL)
|
||||
assert same == ("B", store.SYNC_PENDING) and older == ("B", store.SYNC_PENDING)
|
||||
|
||||
|
||||
# ════════════════════════════════════════════════════════════
|
||||
# 품목 일괄 수정 행별 결과 — [09]
|
||||
# ════════════════════════════════════════════════════════════
|
||||
class _ChunkClient:
|
||||
def __init__(self, fail_chunk: int, error):
|
||||
self.fail_chunk = fail_chunk
|
||||
self.error = error
|
||||
self.n = 0
|
||||
|
||||
def put(self, path, *, json=None, **kw):
|
||||
self.n += 1
|
||||
if self.n == self.fail_chunk:
|
||||
raise self.error
|
||||
return {"variants": [{"variant_code": r["variant_code"], "display": r.get("display")} for r in json["requests"]]}
|
||||
|
||||
|
||||
def _codes(n):
|
||||
return [{"variant_code": f"P0000000{i:04d}", "display": "F"} for i in range(n)]
|
||||
|
||||
|
||||
def test_09_partial_chunk_failure_reports_per_row():
|
||||
rows = products.update_variants(_ChunkClient(2, Cafe24ApiError("거절", status=422)), 7, _codes(150))
|
||||
assert [r["status"] for r in rows[:100]] == ["ok"] * 100
|
||||
assert [r["status"] for r in rows[100:]] == ["failed"] * 50
|
||||
assert rows[0]["variant"]["display"] == "F" and rows[120]["error"] == "거절"
|
||||
|
||||
|
||||
def test_09_first_chunk_failure_still_sends_second():
|
||||
client = _ChunkClient(1, fakes.network_error(maybe_applied=True))
|
||||
rows = products.update_variants(client, 7, _codes(150))
|
||||
assert client.n == 2
|
||||
assert {r["status"] for r in rows[:100]} == {"unknown"}
|
||||
assert {r["status"] for r in rows[100:]} == {"ok"}
|
||||
|
||||
|
||||
# ════════════════════════════════════════════════════════════
|
||||
# 전송 계층 — 쓰기 요청이 카페24에 닿았을 수 있는가(maybe_applied)
|
||||
# ════════════════════════════════════════════════════════════
|
||||
def _client_with(handler):
|
||||
import httpx
|
||||
|
||||
from app.integrations.cafe24 import client as client_mod
|
||||
|
||||
class _Tokens:
|
||||
def get_access_token(self):
|
||||
return "AT"
|
||||
|
||||
def force_expire(self):
|
||||
pass
|
||||
|
||||
real = httpx.Client
|
||||
transport = httpx.MockTransport(handler)
|
||||
client_mod.httpx.Client = lambda **kw: real(transport=transport, **kw)
|
||||
client_mod.time.sleep = lambda *_a, **_k: None
|
||||
return client_mod.Cafe24Client(_config(), _Tokens(), min_interval=0), (client_mod, real)
|
||||
|
||||
|
||||
def _restore(saved):
|
||||
client_mod, real = saved
|
||||
client_mod.httpx.Client = real
|
||||
|
||||
|
||||
def test_client_maybe_applied_classification():
|
||||
import httpx
|
||||
|
||||
cases = [
|
||||
("PUT", lambda req: (_ for _ in ()).throw(httpx.ReadTimeout("t", request=req)), True),
|
||||
("PUT", lambda req: (_ for _ in ()).throw(httpx.ConnectError("c", request=req)), False),
|
||||
("PUT", lambda req: httpx.Response(500, json={"error": {"message": "서버"}}), True),
|
||||
("PUT", lambda req: httpx.Response(422, json={"error": {"message": "검증"}}), False),
|
||||
("GET", lambda req: (_ for _ in ()).throw(httpx.ReadTimeout("t", request=req)), False),
|
||||
]
|
||||
for method, handler, expected in cases:
|
||||
client, saved = _client_with(handler)
|
||||
try:
|
||||
client.request(method, "/admin/products/1", json={"request": {}} if method == "PUT" else None)
|
||||
raise AssertionError("오류가 나야 한다")
|
||||
except Cafe24ApiError as exc:
|
||||
assert exc.maybe_applied is expected, (method, expected, str(exc))
|
||||
finally:
|
||||
_restore(saved)
|
||||
|
||||
|
||||
def _run_all():
|
||||
products.time.sleep = _NO_SLEEP # 직접 실행 = 이 프로세스는 이 파일 테스트만
|
||||
fns = [v for k, v in sorted(globals().items()) if k.startswith("test_") and callable(v)]
|
||||
for fn in fns:
|
||||
fn()
|
||||
|
||||
+223
-119
@@ -8,14 +8,28 @@
|
||||
웹 요청 안에서 기다리는 방식은 프록시 타임아웃·재기동에 그대로 무너진다.
|
||||
compose 서비스 `dbx-cafe24-worker` 가 web 과 같은 이미지로 이 모듈을 돌린다.
|
||||
|
||||
한 번에 한 건씩 처리한다
|
||||
`claim_due_schedule` 이 `FOR UPDATE SKIP LOCKED` 로 한 건을 잠그고 PROCESSING 으로
|
||||
바꾼다. worker 가 실수로 두 개 떠도 같은 예약이 두 번 적용되지 않는다.
|
||||
한 번에 한 건씩, lease 로 잡는다 (마이그레이션 005)
|
||||
`claim_due_schedule` 이 `FOR UPDATE SKIP LOCKED` 로 한 건을 잡아 PROCESSING + lease
|
||||
(만료 시각·token)로 바꾼다. worker 가 여럿이어도 같은 예약을 두 번 잡지 않는다.
|
||||
카페24에 쓰기 직전 lease 를 연장해 "아직 내 것인가"를 확인하고(펜싱), 결과는
|
||||
token 이 맞을 때만 남긴다 — 만료 뒤 늦게 끝난 worker 가 남의 결과를 덮지 않는다.
|
||||
|
||||
적용 순서는 화면 편집과 같다
|
||||
카페24 현재값 재조회 → BACKUP revision → PUT → SUCCESS + 감사로그
|
||||
실패하면 재시도 예산(store.MAX_RETRY) 안에서 간격을 두고 다시 시도하고,
|
||||
소진되면 FAILED 로 확정한다. 되돌리기는 쓰지 않는다.
|
||||
적용 순서는 화면 편집과 같다 (writes.write_product 공용)
|
||||
상품 잠금 → 카페24 현재값 재조회 → 유효 현재값(읽기 지연 보정) → BACKUP
|
||||
→ 시도 기록 → PUT → 버전(SCHEDULED)·스냅샷 기록
|
||||
예약 직전 백업도 읽기 지연을 보정한 값이다(카페24가 아직 옛 HTML 을 돌려줘도
|
||||
그것을 "직전 내용"으로 남기지 않는다). 백업의 source 로 관측값/확인된 적용값을 구분한다.
|
||||
|
||||
결과 분류
|
||||
카페24가 거절 → 재시도 예산(store.MAX_RETRY) 안에서 간격을 두고 다시, 소진되면 FAILED
|
||||
반영 여부 모름 → NEEDS_REVIEW (자동 재적용 금지 — 사람이 쇼핑몰을 보고 확정)
|
||||
반영 성공·기록 실패 → SUCCESS + "기록 복구 필요" 메모. 기록은 다음 주기에 채운다(재적용 없음)
|
||||
같은 상품을 다른 작업이 쓰는 중 → 재시도 횟수를 쓰지 않고 잠시 뒤 다시
|
||||
|
||||
중단 복구 (recover)
|
||||
lease 가 만료된 PROCESSING 은 그 예약의 마지막 쓰기 시도를 보고 판정한다
|
||||
(store.recovery_decision). 무조건 PENDING 으로 돌리지 않는다 — 카페24에 이미 반영됐을
|
||||
수 있기 때문이다. 카페24 현재값이 예약 결과와 같으면 반영된 것으로 확정한다.
|
||||
|
||||
토큰 갱신은 TokenService 가 행 잠금 안에서 하므로 web 과 동시에 떠 있어도 안전하다.
|
||||
"""
|
||||
@@ -25,6 +39,7 @@ from __future__ import annotations
|
||||
import argparse
|
||||
import logging
|
||||
import os
|
||||
import socket
|
||||
import sys
|
||||
import time
|
||||
from datetime import timedelta
|
||||
@@ -33,141 +48,230 @@ from typing import Any
|
||||
from app.integrations.cafe24 import Cafe24Error, build_cafe24_api, products
|
||||
from app.timezone import now_kst
|
||||
|
||||
from . import store
|
||||
from . import store, writes
|
||||
from .common import read_lag_grace_minutes
|
||||
|
||||
logger = logging.getLogger("cafe24.worker")
|
||||
|
||||
ACTOR = "SCHEDULER"
|
||||
DEFAULT_LEASE_SEC = 600 # 한 건 처리(현재값 조회 + PUT + 확인)에 넉넉한 시간
|
||||
LEGACY_PROCESSING_MIN = 30 # lease 컬럼이 없는 옛 PROCESSING 을 만료로 볼 시간
|
||||
BUSY_RETRY_SECONDS = 30 # 같은 상품을 다른 작업이 쓰는 중일 때 다시 볼 간격
|
||||
SETUP_RETRY_SECONDS = 300 # 마이그레이션 미적용 등 설정 문제일 때 다시 볼 간격
|
||||
|
||||
|
||||
def _apply(store_db: Any, api: Any, row: dict[str, Any]) -> str:
|
||||
"""예약 1건 적용. 성공 시 사람이 읽을 요약 문자열."""
|
||||
def lease_seconds() -> int:
|
||||
try:
|
||||
value = int(str(os.getenv("CAFE24_SCHEDULE_LEASE_SEC") or "").strip())
|
||||
except ValueError:
|
||||
return DEFAULT_LEASE_SEC
|
||||
return max(60, value)
|
||||
|
||||
|
||||
def worker_owner() -> str:
|
||||
return f"{ACTOR}|{socket.gethostname()}:{os.getpid()}"
|
||||
|
||||
|
||||
def _summary(row: dict[str, Any]) -> str:
|
||||
return store.describe_schedule_action(
|
||||
has_html=bool(row.get("revision_id")),
|
||||
set_display=row.get("set_display"),
|
||||
set_selling=row.get("set_selling"),
|
||||
)
|
||||
|
||||
|
||||
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)
|
||||
schedule_id = int(row["id"])
|
||||
if store.can_retry(retry_count):
|
||||
wait = store.retry_backoff_seconds(retry_count)
|
||||
st.finish_schedule(
|
||||
schedule_id, token=token, status=store.STATUS_PENDING, error=error,
|
||||
next_retry_at=now_kst() + timedelta(seconds=wait), retry_count=retry_count + 1,
|
||||
)
|
||||
logger.warning("예약 #%s 상품 %s 실패 — %s초 후 재시도 (%s/%s): %s",
|
||||
schedule_id, row.get("product_no"), wait, retry_count + 1, store.MAX_RETRY, error)
|
||||
return store.STATUS_PENDING
|
||||
st.finish_schedule(schedule_id, token=token, status=store.STATUS_FAILED, error=error)
|
||||
writes.audit_safe(st, actor=ACTOR, action="schedule_apply", product_no=row.get("product_no"),
|
||||
schedule_id=schedule_id, result="FAIL", detail=error)
|
||||
logger.error("예약 #%s 상품 %s 최종 실패: %s", schedule_id, row.get("product_no"), error)
|
||||
return store.STATUS_FAILED
|
||||
|
||||
|
||||
def run_one(st: Any, api: Any, row: dict[str, Any]) -> str:
|
||||
"""lease 로 잡은 예약 1건 실행. 반환: 남긴 상태(또는 'LEASE_LOST')."""
|
||||
schedule_id = int(row["id"])
|
||||
product_no = int(row["product_no"])
|
||||
token = str(row.get("lease_token") or "")
|
||||
lease = lease_seconds()
|
||||
revision_id = row.get("revision_id")
|
||||
set_display = row.get("set_display")
|
||||
set_selling = row.get("set_selling")
|
||||
|
||||
html: str | None = None
|
||||
if revision_id:
|
||||
revision = store_db.get_revision(int(revision_id))
|
||||
if not revision:
|
||||
raise Cafe24Error(f"예약이 가리키는 버전 {revision_id} 을 찾을 수 없습니다.")
|
||||
html = revision.get("html_content") or ""
|
||||
if not html.strip():
|
||||
raise Cafe24Error(f"버전 {revision_id} 의 내용이 비어 있습니다.")
|
||||
def fence() -> bool:
|
||||
return bool(st.renew_schedule_lease(schedule_id, token, ttl_seconds=lease))
|
||||
|
||||
# 상세설명을 바꿀 때는 쓰기 직전 현재값을 읽어 백업한다(로컬 값을 믿지 않는다).
|
||||
backup_id = 0
|
||||
if html is not None:
|
||||
current = products.fetch_descriptions(api.client, product_no)
|
||||
backup_id = store_db.add_revision(
|
||||
product_no=product_no,
|
||||
html_content=current.description,
|
||||
revision_type=store.REVISION_BACKUP,
|
||||
memo=f"예약 #{schedule_id} 적용 직전 자동 백업",
|
||||
created_by=ACTOR,
|
||||
)
|
||||
if current.mobile_description and current.mobile_description != current.description:
|
||||
store_db.add_revision(
|
||||
product_no=product_no,
|
||||
html_content=current.mobile_description,
|
||||
revision_type=store.REVISION_BACKUP,
|
||||
memo=f"예약 #{schedule_id} 적용 직전 자동 백업 (모바일)",
|
||||
created_by=ACTOR,
|
||||
try:
|
||||
html: str | None = None
|
||||
if revision_id:
|
||||
revision = st.get_revision(int(revision_id))
|
||||
if not revision:
|
||||
raise Cafe24Error(f"예약이 가리키는 버전 {revision_id} 을 찾을 수 없습니다.")
|
||||
html = str(revision.get("html_content") or "")
|
||||
if not html.strip():
|
||||
raise Cafe24Error(f"버전 {revision_id} 의 내용이 비어 있습니다.")
|
||||
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,
|
||||
)
|
||||
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))
|
||||
logger.error("예약 #%s 실행 보류 — %s", schedule_id, exc)
|
||||
return store.STATUS_PENDING
|
||||
except writes.WriteBusy as exc:
|
||||
# 다른 작업이 같은 상품을 쓰는 중이거나 lease 를 잃었다. 재시도 횟수를 쓰지 않는다.
|
||||
# (lease 를 잃었으면 finish 는 token 이 안 맞아 아무것도 바꾸지 않는다.)
|
||||
done = st.finish_schedule(schedule_id, token=token, status=store.STATUS_PENDING, error=str(exc),
|
||||
next_retry_at=now_kst() + timedelta(seconds=BUSY_RETRY_SECONDS))
|
||||
logger.info("예약 #%s 상품 %s 보류(%s): %s", schedule_id, product_no, "재대기" if done else "lease 잃음", exc)
|
||||
return store.STATUS_PENDING if done else "LEASE_LOST"
|
||||
except (writes.WriteBlocked, writes.RemoteWriteUnknown) as exc:
|
||||
st.finish_schedule(schedule_id, token=token, status=store.STATUS_NEEDS_REVIEW, error=str(exc))
|
||||
writes.audit_safe(st, actor=ACTOR, action="schedule_apply", product_no=product_no,
|
||||
schedule_id=schedule_id, result="UNKNOWN", detail=str(exc))
|
||||
logger.error("예약 #%s 상품 %s 확인 필요: %s", schedule_id, product_no, exc)
|
||||
return store.STATUS_NEEDS_REVIEW
|
||||
except (writes.RemoteWriteFailed, Cafe24Error) as exc:
|
||||
return _retry_or_fail(st, row, token, str(exc))
|
||||
except Exception as exc: # noqa: BLE001 — 카페24에 쓰기 전의 사고(원격 이후는 write_product 가 삼킨다)
|
||||
logger.exception("예약 #%s 처리 중 예상치 못한 오류(카페24 쓰기 전)", schedule_id)
|
||||
return _retry_or_fail(st, row, token, f"{type(exc).__name__}: {exc}")
|
||||
|
||||
# PC/모바일은 구분하지 않는다 — mobile_description 은 보내지 않고
|
||||
# separated_mobile_description="F" 로 "PC 상세설명과 동일"을 강제한다.
|
||||
# (mobile_description 을 직접 보내면 카페24가 그 설정을 "직접 등록"으로 바꿔버린다.)
|
||||
updated = products.update_product(
|
||||
api.client,
|
||||
product_no,
|
||||
description=html,
|
||||
separated_mobile_description="F" if html is not None else None,
|
||||
display=set_display,
|
||||
selling=set_selling,
|
||||
note = ""
|
||||
if outcome.record_error:
|
||||
note = f"카페24 반영 성공 · 로컬 기록 실패(자동 복구 예정, 재적용 안 함): {outcome.record_error}"
|
||||
done = st.finish_schedule(schedule_id, token=token, status=store.STATUS_SUCCESS, error=note)
|
||||
if not done:
|
||||
# 반영은 됐다. 결과를 못 남겼어도 lease 만료 후 recover 가 시도 기록(REMOTE_OK/RECORDED)을
|
||||
# 보고 SUCCESS 로 확정한다 — 다시 적용하지 않는다.
|
||||
logger.warning("예약 #%s 적용됨 — 결과 기록 실패(lease 잃음). 복구 단계가 확정합니다.", schedule_id)
|
||||
summary = _summary(row)
|
||||
writes.audit_safe(
|
||||
st, actor=ACTOR, action="schedule_apply", product_no=product_no,
|
||||
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" / {note}" if note else ""),
|
||||
)
|
||||
# PUT 응답은 쓰기 직후의 실제 값이다 — 스냅샷으로 남겨 화면이 GET 의 읽기 지연에
|
||||
# 흔들리지 않게 한다(routes_products._load_product 가 덮어씌운다).
|
||||
if isinstance(updated, dict) and updated.get("product_no"):
|
||||
logger.info("예약 #%s 상품 %s 적용 완료 — %s", schedule_id, product_no, summary)
|
||||
return store.STATUS_SUCCESS
|
||||
|
||||
|
||||
def _verify_attempt(st: Any, api: Any, attempt: dict[str, Any]) -> bool:
|
||||
"""카페24 현재값이 그 시도의 결과와 같은가(같으면 반영된 것으로 확정해도 된다)."""
|
||||
try:
|
||||
product = products.get_product(api.client, int(attempt["product_no"]))
|
||||
except Cafe24Error as exc:
|
||||
logger.warning("시도 #%s 확인용 조회 실패: %s", attempt.get("id"), exc)
|
||||
return False
|
||||
return writes.attempt_matches_remote(attempt, product)
|
||||
|
||||
|
||||
def recover_one(st: Any, api: Any, row: dict[str, Any]) -> str:
|
||||
"""lease 만료 PROCESSING 1건 복구 판정 — 반환: 남긴 상태."""
|
||||
schedule_id = int(row["id"])
|
||||
token = str(row.get("lease_token") or "")
|
||||
attempt = st.latest_attempt_for_schedule(schedule_id) or None
|
||||
decision, note = store.recovery_decision(attempt, row.get("retry_count"))
|
||||
note = f"중단 복구: {note}"
|
||||
|
||||
if decision == store.RECOVER_REVIEW and attempt:
|
||||
try:
|
||||
store_db.save_write_snapshot(product_no, "product", store.product_snapshot(updated))
|
||||
except Exception: # noqa: BLE001 — 스냅샷 실패가 예약 결과를 바꾸면 안 된다.
|
||||
logger.exception("예약 #%s 상품 %s 스냅샷 저장 실패", schedule_id, product_no)
|
||||
if html is not None:
|
||||
# 화면 편집(apply)과 동일 — 카페24 관리자 API 의 쓰기 직후 읽기 지연을
|
||||
# 여기서 짧게 흡수한다(쇼핑몰에는 바로 반영되지만 관리자 조회만 뒤쳐질 때가 있다).
|
||||
# 확인이 안 돼도 실패가 아니다 — 화면은 마지막 쓰기(SCHEDULED revision)를 기준으로
|
||||
# 그린다. 여기서 SCHEDULED revision 을 남겨야 그 기준이 생긴다.
|
||||
products.wait_for_description(api.client, product_no, html)
|
||||
store_db.add_revision(
|
||||
product_no=product_no,
|
||||
html_content=html,
|
||||
revision_type=store.REVISION_SCHEDULED,
|
||||
memo=f"예약 #{schedule_id} 적용",
|
||||
created_by=ACTOR,
|
||||
)
|
||||
with writes.write_lock(st, writes.product_lock_key(int(row["product_no"])), actor=ACTOR,
|
||||
purpose=f"예약 #{schedule_id} 복구 확인", wait_seconds=0):
|
||||
if _verify_attempt(st, api, attempt):
|
||||
st.update_attempt(int(attempt["id"]), status=store.ATTEMPT_REMOTE_OK, remote_ok=True,
|
||||
resolved_by="auto:카페24 값이 예약 결과와 같음",
|
||||
only_from=(store.ATTEMPT_STARTED, store.ATTEMPT_UNKNOWN))
|
||||
decision, note = store.RECOVER_RECORD, "중단 복구: 카페24 현재값이 예약 결과와 같아 반영됨으로 확정"
|
||||
except writes.WriteBusy:
|
||||
pass # 다음 주기에 다시 — 판정은 REVIEW 로 남긴다
|
||||
if decision == store.RECOVER_RECORD and attempt:
|
||||
try:
|
||||
writes.record_attempt(st, attempt)
|
||||
except Exception as exc: # noqa: BLE001 — 반영은 됐다. 기록은 다음 주기에.
|
||||
logger.exception("예약 #%s 복구 중 버전 기록 실패", schedule_id)
|
||||
note += f" (버전 기록 실패 — 자동 재시도: {type(exc).__name__})"
|
||||
decision = store.RECOVER_SUCCESS
|
||||
|
||||
summary = store.describe_schedule_action(
|
||||
has_html=html is not None, set_display=set_display, set_selling=set_selling
|
||||
if decision == store.RECOVER_SUCCESS:
|
||||
st.finish_schedule(schedule_id, token=token, status=store.STATUS_SUCCESS, error=note)
|
||||
status = store.STATUS_SUCCESS
|
||||
elif decision == store.RECOVER_REVIEW:
|
||||
st.finish_schedule(schedule_id, token=token, status=store.STATUS_NEEDS_REVIEW, error=note)
|
||||
status = store.STATUS_NEEDS_REVIEW
|
||||
else:
|
||||
status = _retry_or_fail(st, row, token, note)
|
||||
writes.audit_safe(st, actor=ACTOR, action="schedule_recover", product_no=row.get("product_no"),
|
||||
schedule_id=schedule_id, result=status, detail=note)
|
||||
logger.warning("예약 #%s 중단 복구 → %s (%s)", schedule_id, status, note)
|
||||
return status
|
||||
|
||||
|
||||
def record_pending_attempts(st: Any) -> int:
|
||||
"""카페24에 반영됐는데 버전 기록이 빠진 시도(REMOTE_OK)의 기록을 채운다."""
|
||||
since = now_kst() - timedelta(minutes=read_lag_grace_minutes())
|
||||
done = 0
|
||||
for attempt in st.attempts_needing_record(since=since):
|
||||
try:
|
||||
with writes.write_lock(st, writes.product_lock_key(int(attempt["product_no"])), actor=ACTOR,
|
||||
purpose="기록 복구", wait_seconds=0):
|
||||
writes.record_attempt(st, attempt)
|
||||
done += 1
|
||||
except writes.WriteBusy:
|
||||
continue
|
||||
except Exception: # noqa: BLE001
|
||||
logger.exception("시도 #%s 기록 복구 실패", attempt.get("id"))
|
||||
return done
|
||||
|
||||
|
||||
def recover(st: Any, api: Any) -> int:
|
||||
"""중단 복구 — 기록 복구 + lease 만료 PROCESSING 판정. 처리 건수."""
|
||||
count = record_pending_attempts(st)
|
||||
rows = st.claim_expired_schedules(
|
||||
owner=worker_owner(), ttl_seconds=lease_seconds(), legacy_minutes=LEGACY_PROCESSING_MIN
|
||||
)
|
||||
store_db.log_audit(
|
||||
actor=ACTOR,
|
||||
action="schedule_apply",
|
||||
product_no=product_no,
|
||||
revision_id=int(revision_id) if revision_id else None,
|
||||
schedule_id=schedule_id,
|
||||
result="SUCCESS",
|
||||
detail=summary + (f" (백업 {backup_id})" if backup_id else ""),
|
||||
)
|
||||
return summary
|
||||
for row in rows:
|
||||
try:
|
||||
recover_one(st, api, row)
|
||||
except Exception: # noqa: BLE001 — 한 건 때문에 나머지를 멈추지 않는다(lease 만료 후 다시)
|
||||
logger.exception("예약 #%s 복구 중 오류", row.get("id"))
|
||||
count += 1
|
||||
return count
|
||||
|
||||
|
||||
def process_once(store_db: Any, api: Any) -> int:
|
||||
"""실행할 예약을 모두 처리한다. 처리한 건수를 돌려준다."""
|
||||
def process_once(st: Any, api: Any) -> int:
|
||||
"""중단 복구 후, 실행할 예약을 모두 처리한다. 처리한(잡은) 예약 건수를 돌려준다."""
|
||||
try:
|
||||
recover(st, api)
|
||||
except Exception: # noqa: BLE001 — 복구 실패가 새 예약 실행을 막지 않게
|
||||
logger.exception("중단 복구 단계 오류 — 다음 주기에 다시 시도")
|
||||
handled = 0
|
||||
while True:
|
||||
with store_db.claim_due_schedule(now=now_kst()) as row:
|
||||
if row is None:
|
||||
return handled
|
||||
# 잠금은 여기서 이미 풀렸다. 상태가 PROCESSING 이라 다른 worker 가 집지 않는다.
|
||||
schedule_id = int(row["id"])
|
||||
product_no = int(row["product_no"])
|
||||
try:
|
||||
summary = _apply(store_db, api, row)
|
||||
except Cafe24Error as exc:
|
||||
retry_count = int(row.get("retry_count") or 0)
|
||||
if store.can_retry(retry_count):
|
||||
wait = store.retry_backoff_seconds(retry_count)
|
||||
store_db.finish_schedule(
|
||||
schedule_id,
|
||||
status=store.STATUS_PENDING,
|
||||
error=str(exc),
|
||||
next_retry_at=now_kst() + timedelta(seconds=wait),
|
||||
retry_count=retry_count + 1,
|
||||
)
|
||||
logger.warning(
|
||||
"예약 #%s 상품 %s 실패 — %s초 후 재시도 (%s/%s): %s",
|
||||
schedule_id, product_no, wait, retry_count + 1, store.MAX_RETRY, exc,
|
||||
)
|
||||
else:
|
||||
store_db.finish_schedule(
|
||||
schedule_id, status=store.STATUS_FAILED, error=str(exc)
|
||||
)
|
||||
store_db.log_audit(
|
||||
actor=ACTOR, action="schedule_apply", product_no=product_no,
|
||||
schedule_id=schedule_id, result="FAIL", detail=str(exc),
|
||||
)
|
||||
logger.error("예약 #%s 상품 %s 최종 실패: %s", schedule_id, product_no, exc)
|
||||
except Exception as exc: # noqa: BLE001 — 한 건의 사고가 worker 를 죽이면 안 된다.
|
||||
store_db.finish_schedule(
|
||||
schedule_id, status=store.STATUS_FAILED, error=f"{type(exc).__name__}: {exc}"
|
||||
)
|
||||
logger.exception("예약 #%s 처리 중 예상치 못한 오류", schedule_id)
|
||||
else:
|
||||
store_db.finish_schedule(schedule_id, status=store.STATUS_SUCCESS)
|
||||
logger.info("예약 #%s 상품 %s 적용 완료 — %s", schedule_id, product_no, summary)
|
||||
row = st.claim_due_schedule(now=now_kst(), owner=worker_owner(), ttl_seconds=lease_seconds())
|
||||
if row is None:
|
||||
return handled
|
||||
run_one(st, api, row)
|
||||
handled += 1
|
||||
|
||||
|
||||
|
||||
@@ -0,0 +1,531 @@
|
||||
"""카페24 쓰기 공통 처리 — 잠금 · 유효 현재값 판정 · 백업 · 시도 기록 · 결과 분류.
|
||||
|
||||
상세설명(과 예약의 진열/판매)을 카페24에 쓰는 모든 경로 — 즉시 적용, 버전 복원,
|
||||
예약 worker — 가 `write_product` 한 곳을 지난다. 경로마다 판정이 달라 생기던 문제
|
||||
(예약 직전 백업이 지연된 옛 HTML 을 담는 등)를 막기 위해서다.
|
||||
|
||||
순서 (docs/CAFE24_MODULE.md 3-2, 3-5)
|
||||
상품 잠금(DB lease) → 카페24 현재값 GET → 결과 모르는 이전 시도 확인
|
||||
→ 유효 현재값(읽기 지연 보정) → BACKUP → 지문 대조(충돌 거부)
|
||||
→ 잠금 펜싱 → 시도 기록(STARTED) → PUT
|
||||
→ 원격 결과 분류(REMOTE_OK / REMOTE_FAILED / UNKNOWN)
|
||||
→ 스냅샷 · 버전(MANUAL/SCHEDULED/ROLLBACK) 기록(RECORDED)
|
||||
|
||||
원칙
|
||||
- 읽기 지연 판정의 근거는 **원격 반영이 확인된 쓰기**(cafe24_write_attempts 의
|
||||
REMOTE_OK/RECORDED)뿐이다. 충돌로 거절된 적용의 백업·예약 초안은 넣지 않는다.
|
||||
- PUT 이 성공한 뒤의 실패(스냅샷·버전 기록)는 "적용 실패"가 아니다. 결과에
|
||||
record_error 로 알리고, 시도 기록(REMOTE_OK)에 남은 내용으로 나중에 복구한다.
|
||||
재적용하지 않는다.
|
||||
- 반영 여부를 모르는 시도(STARTED/UNKNOWN)가 남아 있으면 같은 상품 상세설명을
|
||||
다시 쓰지 않는다(WriteBlocked). 카페24 값이 그 시도의 내용과 같으면 자동 확정.
|
||||
- 잠금은 웹 여러 프로세스 + worker 가 공유하는 DB 표(cafe24_write_locks)다.
|
||||
카페24 관리자 화면에서 사람이 동시에 고치는 것은 막을 수 없다 — 그것은 지문
|
||||
대조(편집 시작 시점 값과 비교)로만 잡는다.
|
||||
|
||||
카페24 호출은 `app.integrations.cafe24` 만 쓴다(httpx 직접 호출 금지).
|
||||
"""
|
||||
|
||||
from __future__ import annotations
|
||||
|
||||
import logging
|
||||
import os
|
||||
import socket
|
||||
import time
|
||||
from contextlib import contextmanager
|
||||
from dataclasses import dataclass, field
|
||||
from datetime import timedelta
|
||||
from typing import Any, Callable, Iterator
|
||||
|
||||
from app.integrations.cafe24 import Cafe24Error, products
|
||||
from app.timezone import now_kst
|
||||
|
||||
from . import store
|
||||
from .common import read_lag_grace_minutes
|
||||
|
||||
logger = logging.getLogger("cafe24.writes")
|
||||
|
||||
DEFAULT_LOCK_TTL_SEC = 300 # 이미지 업로드(최대 120초 × 재시도)도 담을 만큼
|
||||
DEFAULT_LOCK_WAIT_SEC = 3.0 # 웹 요청은 짧게만 기다린다 — 오래 걸리면 "수정 중" 안내
|
||||
|
||||
|
||||
def _env_number(name: str, default: float) -> float:
|
||||
try:
|
||||
value = float(str(os.getenv(name) or "").strip())
|
||||
except ValueError:
|
||||
return default
|
||||
return value if value >= 0 else default
|
||||
|
||||
|
||||
def lock_ttl_seconds() -> int:
|
||||
return max(30, int(_env_number("CAFE24_WRITE_LOCK_TTL_SEC", DEFAULT_LOCK_TTL_SEC)))
|
||||
|
||||
|
||||
def lock_wait_seconds() -> float:
|
||||
return min(30.0, _env_number("CAFE24_WRITE_LOCK_WAIT_SEC", DEFAULT_LOCK_WAIT_SEC))
|
||||
|
||||
|
||||
# ════════════════════════════════════════════════════════════
|
||||
# 예외 — http_status 는 JSON API 가 그대로 쓴다
|
||||
# ════════════════════════════════════════════════════════════
|
||||
class WriteError(Exception):
|
||||
http_status = 500
|
||||
|
||||
def __init__(self, message: str, *, backup_id: int = 0, attempt_id: int = 0):
|
||||
super().__init__(message)
|
||||
self.backup_id = backup_id
|
||||
self.attempt_id = attempt_id
|
||||
|
||||
|
||||
class WriteSetupError(WriteError):
|
||||
"""마이그레이션 005 미적용 등 — 안전장치 없이 쓰지 않는다."""
|
||||
|
||||
http_status = 503
|
||||
|
||||
|
||||
class WriteBusy(WriteError):
|
||||
"""다른 요청(또는 예약 실행)이 같은 대상을 쓰는 중이거나, 잠금을 잃었다."""
|
||||
|
||||
http_status = 409
|
||||
|
||||
|
||||
class WriteConflict(WriteError):
|
||||
"""편집 시작 뒤 카페24 값이 바뀌었다(지문 불일치)."""
|
||||
|
||||
http_status = 409
|
||||
|
||||
|
||||
class WriteBlocked(WriteError):
|
||||
"""반영 여부를 모르는 이전 시도가 남아 있다 — 사람이 확정하기 전에는 쓰지 않는다."""
|
||||
|
||||
http_status = 409
|
||||
|
||||
def __init__(self, message: str, *, attempts: list[dict[str, Any]] | None = None, **kw: Any):
|
||||
super().__init__(message, **kw)
|
||||
self.attempts = attempts or []
|
||||
|
||||
|
||||
class RemoteWriteFailed(WriteError):
|
||||
"""카페24가 거절 — 반영되지 않은 것이 확실하다."""
|
||||
|
||||
http_status = 502
|
||||
|
||||
|
||||
class RemoteWriteUnknown(WriteError):
|
||||
"""요청이 도달했을 수 있으나 응답을 못 받았다 — 반영 여부를 모른다. 재적용 금지."""
|
||||
|
||||
http_status = 502
|
||||
|
||||
|
||||
# ════════════════════════════════════════════════════════════
|
||||
# 잠금
|
||||
# ════════════════════════════════════════════════════════════
|
||||
def product_lock_key(product_no: int) -> str:
|
||||
return f"product:{int(product_no)}"
|
||||
|
||||
|
||||
def design_lock_key(file_key: str) -> str:
|
||||
return f"design:{file_key}"
|
||||
|
||||
|
||||
def lock_owner(actor: str) -> str:
|
||||
"""잠금 소유자 표기 — '사람|호스트:pid'. 안내 문구에는 '|' 앞(사람)만 쓴다."""
|
||||
return f"{actor or '-'}|{socket.gethostname()}:{os.getpid()}"
|
||||
|
||||
|
||||
def require_schema(st: Any) -> None:
|
||||
try:
|
||||
ok = st.write_schema_ready()
|
||||
except Exception as exc: # noqa: BLE001 — DB 접속 실패도 "쓰지 않음"으로
|
||||
raise WriteSetupError(f"cafe24_db 상태를 확인하지 못해 카페24에 쓰지 않았습니다: {type(exc).__name__}") from exc
|
||||
if not ok:
|
||||
raise WriteSetupError(
|
||||
"cafe24_db 마이그레이션 005(쓰기 안전장치)가 적용되지 않아 카페24에 쓰지 않았습니다. "
|
||||
"관리자에게 scripts/sql/cafe24_db_005_write_safety.sql 적용을 요청하세요."
|
||||
)
|
||||
|
||||
|
||||
@dataclass
|
||||
class WriteLock:
|
||||
st: Any
|
||||
key: str
|
||||
token: str
|
||||
ttl: int
|
||||
|
||||
def still_mine(self) -> bool:
|
||||
"""아직 내 잠금이면 연장하고 True(펜싱). 만료돼 넘어갔으면 False."""
|
||||
try:
|
||||
return bool(self.st.renew_lock(self.key, self.token, ttl_seconds=self.ttl))
|
||||
except Exception: # noqa: BLE001 — 확인할 수 없으면 쓰지 않는다
|
||||
logger.exception("잠금 연장 실패 %s", self.key)
|
||||
return False
|
||||
|
||||
|
||||
@contextmanager
|
||||
def write_lock(
|
||||
st: Any,
|
||||
key: str,
|
||||
*,
|
||||
actor: str,
|
||||
purpose: str,
|
||||
wait_seconds: float | None = None,
|
||||
ttl_seconds: int | None = None,
|
||||
) -> Iterator[WriteLock]:
|
||||
"""DB 잠금을 잡은 채 작업한다. 못 잡으면 WriteBusy, 스키마가 없으면 WriteSetupError."""
|
||||
require_schema(st)
|
||||
ttl = int(ttl_seconds or lock_ttl_seconds())
|
||||
wait = lock_wait_seconds() if wait_seconds is None else max(0.0, float(wait_seconds))
|
||||
deadline = time.monotonic() + wait
|
||||
while True:
|
||||
token = st.acquire_lock(key, owner=lock_owner(actor), purpose=purpose, ttl_seconds=ttl)
|
||||
if token:
|
||||
break
|
||||
if time.monotonic() >= deadline:
|
||||
raise WriteBusy(_busy_message(st, key))
|
||||
time.sleep(0.25)
|
||||
lock = WriteLock(st=st, key=key, token=token, ttl=ttl)
|
||||
try:
|
||||
yield lock
|
||||
finally:
|
||||
try:
|
||||
st.release_lock(key, token)
|
||||
except Exception: # noqa: BLE001 — 못 풀어도 만료되면 풀린다
|
||||
logger.exception("잠금 해제 실패 %s (만료 후 자동 해제)", key)
|
||||
|
||||
|
||||
def _busy_message(st: Any, key: str) -> str:
|
||||
try:
|
||||
holder = st.lock_holder(key) or {}
|
||||
except Exception: # noqa: BLE001
|
||||
holder = {}
|
||||
who = str(holder.get("owner") or "").split("|", 1)[0]
|
||||
what = str(holder.get("purpose") or "")
|
||||
detail = " · ".join(p for p in (what, who) if p and p != "-")
|
||||
return "다른 작업이 같은 대상을 수정하고 있습니다" + (f"({detail})" if detail else "") + ". 잠시 후 다시 시도하세요."
|
||||
|
||||
|
||||
# ════════════════════════════════════════════════════════════
|
||||
# 유효 현재값 — 읽기 지연 보정 (확인된 쓰기만 근거)
|
||||
# ════════════════════════════════════════════════════════════
|
||||
def resolve_effective(
|
||||
st: Any, product_no: int, cafe24_html: str, *, fetched_updated: object = None
|
||||
) -> tuple[str, str, dict[str, Any] | None]:
|
||||
"""(유효 HTML, 상태 store.SYNC_*, 마지막 확인된 쓰기)."""
|
||||
grace = read_lag_grace_minutes()
|
||||
since = now_kst() - timedelta(minutes=grace)
|
||||
lineage = st.write_lineage(product_no, since=since)
|
||||
if not lineage:
|
||||
return cafe24_html, store.SYNC_NONE, None
|
||||
last = lineage[0]
|
||||
effective, state = store.resolve_description(
|
||||
cafe24_html,
|
||||
last_write=last,
|
||||
known_digests=store.lineage_digests(lineage),
|
||||
grace_minutes=grace,
|
||||
fetched_updated=fetched_updated,
|
||||
)
|
||||
return effective, state, last
|
||||
|
||||
|
||||
# ════════════════════════════════════════════════════════════
|
||||
# 기록 — PUT 성공 뒤의 로컬 저장(실패해도 "적용 실패"가 아니다)
|
||||
# ════════════════════════════════════════════════════════════
|
||||
def remember_product_write(st: Any, product_no: int, updated: dict[str, Any]) -> tuple[dict[str, Any], str]:
|
||||
"""PUT 응답(상품 dict)을 캐시·스냅샷에 남긴다. (정규화된 상품 행, 기록 오류 문자열)."""
|
||||
info = products.normalize_product(updated) if updated else {}
|
||||
if not info.get("product_no"):
|
||||
return info, ""
|
||||
try:
|
||||
st.upsert_products([info])
|
||||
st.save_write_snapshot(product_no, "product", store.product_snapshot(updated))
|
||||
except Exception as exc: # noqa: BLE001 — 카페24에는 이미 반영됐다
|
||||
logger.exception("상품 %s 쓰기 스냅샷 저장 실패", product_no)
|
||||
return info, f"{type(exc).__name__}: {exc}"
|
||||
return info, ""
|
||||
|
||||
|
||||
def audit_safe(st: Any, **fields: Any) -> None:
|
||||
"""감사로그 — 실패해도 호출부 결과를 바꾸지 않는다(이미 카페24에 반영된 뒤일 수 있다)."""
|
||||
try:
|
||||
st.log_audit(**fields)
|
||||
except Exception: # noqa: BLE001
|
||||
logger.exception("감사로그 기록 실패: %s", fields.get("action"))
|
||||
|
||||
|
||||
def record_attempt(st: Any, attempt: dict[str, Any]) -> int:
|
||||
"""원격 반영된 시도의 버전을 남기고 RECORDED 로 바꾼다(이미 있으면 그 id). 멱등.
|
||||
|
||||
진열/판매만 바꾼 시도(상세설명 없음)는 버전을 만들지 않고 상태만 RECORDED 로 둔다.
|
||||
"""
|
||||
if not attempt.get("target_digest") and not attempt.get("target_revision_id"):
|
||||
st.update_attempt(int(attempt["id"]), status=store.ATTEMPT_RECORDED, remote_ok=True)
|
||||
return 0
|
||||
origin = str(attempt.get("origin") or store.ORIGIN_MANUAL)
|
||||
revision_type = store.ORIGIN_REVISION_TYPE.get(origin, "MANUAL")
|
||||
source = store.SOURCE_REVISION if origin == store.ORIGIN_ROLLBACK else ""
|
||||
source_revision = attempt.get("target_revision_id") if origin != store.ORIGIN_MANUAL else None
|
||||
return int(st.record_attempt_revision(
|
||||
int(attempt["id"]),
|
||||
revision_type=revision_type,
|
||||
memo=str(attempt.get("memo") or ""),
|
||||
created_by=str(attempt.get("actor") or ""),
|
||||
source=source,
|
||||
source_revision_id=int(source_revision) if source_revision else None,
|
||||
))
|
||||
|
||||
|
||||
def _flags_match(product: dict[str, Any], attempt: dict[str, Any]) -> bool:
|
||||
for key in ("set_display", "set_selling"):
|
||||
want = attempt.get(key)
|
||||
if want is None:
|
||||
continue
|
||||
field_name = key.replace("set_", "")
|
||||
if products._flag(product.get(field_name)) != bool(want): # noqa: SLF001 — 같은 규칙
|
||||
return False
|
||||
return True
|
||||
|
||||
|
||||
def attempt_matches_remote(attempt: dict[str, Any], product: dict[str, Any]) -> bool:
|
||||
"""카페24 현재값이 그 시도가 쓰려던 결과와 같은가(같으면 결과를 "반영됨"으로 확정해도 된다)."""
|
||||
if not product:
|
||||
return False
|
||||
digest = str(attempt.get("target_digest") or "")
|
||||
if digest and store.content_digest(str(product.get("description") or "")) != digest:
|
||||
return False
|
||||
if not digest and attempt.get("set_display") is None and attempt.get("set_selling") is None:
|
||||
return False
|
||||
return _flags_match(product, attempt)
|
||||
|
||||
|
||||
def settle_open_attempts(
|
||||
st: Any, product_no: int, *, product: dict[str, Any], actor: str = "SYSTEM"
|
||||
) -> list[dict[str, Any]]:
|
||||
"""열린 시도를 정리하고 **아직 결과를 모르는 것**만 돌려준다. 잠금 안에서 부른다.
|
||||
|
||||
REMOTE_OK → 버전 기록을 채운다(기록 복구)
|
||||
STARTED / UNKNOWN → 카페24 현재값이 그 시도의 결과와 같으면 반영됨으로 확정
|
||||
(예약이 "확인 필요"였다면 완료로 바꾼다). 다르면 남긴다.
|
||||
"""
|
||||
since = now_kst() - timedelta(minutes=read_lag_grace_minutes())
|
||||
unresolved: list[dict[str, Any]] = []
|
||||
for attempt in st.open_attempts(product_no, since=since):
|
||||
status = attempt.get("status")
|
||||
if status == store.ATTEMPT_REMOTE_OK:
|
||||
try:
|
||||
record_attempt(st, attempt)
|
||||
except Exception: # noqa: BLE001 — 원격은 반영됨. 다음 기회에 다시.
|
||||
logger.exception("시도 #%s 기록 복구 실패", attempt.get("id"))
|
||||
continue
|
||||
if attempt_matches_remote(attempt, product):
|
||||
st.update_attempt(
|
||||
int(attempt["id"]), status=store.ATTEMPT_REMOTE_OK, remote_ok=True,
|
||||
resolved_by="auto:카페24 값이 요청 결과와 같음",
|
||||
only_from=(store.ATTEMPT_STARTED, store.ATTEMPT_UNKNOWN),
|
||||
)
|
||||
try:
|
||||
record_attempt(st, attempt)
|
||||
except Exception: # noqa: BLE001
|
||||
logger.exception("시도 #%s 기록 실패(자동 확정 후)", attempt.get("id"))
|
||||
if attempt.get("schedule_id"):
|
||||
st.review_schedule(
|
||||
int(attempt["schedule_id"]), status=store.STATUS_SUCCESS,
|
||||
note="자동 확인: 카페24 현재값이 예약 내용과 같습니다", actor=actor, action="auto_verify",
|
||||
)
|
||||
continue
|
||||
unresolved.append(attempt)
|
||||
return unresolved
|
||||
|
||||
|
||||
def describe_attempt(attempt: dict[str, Any]) -> str:
|
||||
origin = {store.ORIGIN_MANUAL: "즉시 적용", store.ORIGIN_SCHEDULED: "예약", store.ORIGIN_ROLLBACK: "복원"}.get(
|
||||
str(attempt.get("origin") or ""), "적용")
|
||||
when = str(attempt.get("created_at") or "").replace("T", " ")[:16]
|
||||
who = str(attempt.get("actor") or "")
|
||||
sched = f" · 예약 #{attempt['schedule_id']}" if attempt.get("schedule_id") else ""
|
||||
return f"시도 #{attempt.get('id')} ({origin}{sched}, {when}{', ' + who if who else ''})"
|
||||
|
||||
|
||||
# ════════════════════════════════════════════════════════════
|
||||
# 본 처리
|
||||
# ════════════════════════════════════════════════════════════
|
||||
@dataclass
|
||||
class WriteOutcome:
|
||||
attempt_id: int = 0
|
||||
backup_id: int = 0
|
||||
revision_id: int = 0
|
||||
changed: bool = True # False = 바뀐 것이 없어 PUT 하지 않음
|
||||
pending: bool = False # 백업이 "마지막 확인된 쓰기" 기준이었나(카페24 읽기 지연)
|
||||
recorded: bool = False # 버전 기록까지 끝났나
|
||||
record_error: str = "" # PUT 성공 뒤 로컬 기록 실패 사유(재적용 금지 — 자동 복구)
|
||||
confirmed: bool = False # PUT 뒤 GET 이 새 값을 돌려줬나
|
||||
updated: dict[str, Any] = field(default_factory=dict)
|
||||
|
||||
|
||||
def write_product(
|
||||
st: Any,
|
||||
api: Any,
|
||||
product_no: int,
|
||||
*,
|
||||
lock: WriteLock,
|
||||
origin: str,
|
||||
actor: str,
|
||||
html: str | None,
|
||||
base_fingerprint: str | None = None,
|
||||
set_display: bool | None = None,
|
||||
set_selling: bool | None = None,
|
||||
schedule_id: int | None = None,
|
||||
target_revision_id: int | None = None,
|
||||
memo: str = "",
|
||||
skip_if_same: bool = False,
|
||||
extra_fence: Callable[[], bool] | None = None,
|
||||
wait_confirm: bool = True,
|
||||
) -> WriteOutcome:
|
||||
"""상세설명(html)·진열/판매를 카페24에 쓴다. 잠금(lock)을 잡은 채 부른다.
|
||||
|
||||
예외(아무것도 쓰지 않음): Cafe24Error(현재값 조회 실패), WriteBlocked, WriteConflict,
|
||||
WriteBusy(펜싱 실패) / RemoteWriteFailed(거절) / RemoteWriteUnknown(반영 여부 모름).
|
||||
PUT 성공 뒤의 로컬 기록 실패는 예외가 아니라 WriteOutcome.record_error 로 알린다.
|
||||
"""
|
||||
mall_id = str(getattr(api.config, "mall_id", "") or "")
|
||||
shop_no = 1
|
||||
out = WriteOutcome()
|
||||
current_html: str | None = None
|
||||
effective: str | None = None
|
||||
|
||||
if html is not None:
|
||||
product = products.get_product(api.client, product_no)
|
||||
if not product:
|
||||
raise Cafe24Error("카페24에서 상품을 찾지 못했습니다.")
|
||||
desc = products.descriptions_from_product(product)
|
||||
current_html = desc.description
|
||||
|
||||
unresolved = [a for a in settle_open_attempts(st, product_no, product=product, actor=actor)
|
||||
if a.get("target_digest")]
|
||||
if unresolved:
|
||||
names = ", ".join(describe_attempt(a) for a in unresolved[:3])
|
||||
raise WriteBlocked(
|
||||
f"이전 적용의 반영 여부를 아직 확인하지 못했습니다: {names}. "
|
||||
"쇼핑몰에서 확인한 뒤 편집기 위 안내에서 결과를 확정하고 다시 시도하세요.",
|
||||
attempts=unresolved,
|
||||
)
|
||||
|
||||
effective, state, last = resolve_effective(
|
||||
st, product_no, current_html, fetched_updated=product.get("updated_date")
|
||||
)
|
||||
out.pending = state == store.SYNC_PENDING
|
||||
label = {store.ORIGIN_SCHEDULED: f"예약 #{schedule_id} 적용 직전 자동 백업",
|
||||
store.ORIGIN_ROLLBACK: "복원 직전 자동 백업"}.get(origin, "적용 직전 자동 백업")
|
||||
out.backup_id = st.add_revision(
|
||||
product_no=product_no,
|
||||
html_content=effective,
|
||||
revision_type=store.REVISION_BACKUP,
|
||||
memo=label + (" (카페24 읽기 지연 — 마지막으로 확인된 적용값 기준)" if out.pending else ""),
|
||||
created_by=actor,
|
||||
mall_id=mall_id,
|
||||
shop_no=shop_no,
|
||||
source=store.SOURCE_LAST_WRITE if out.pending else store.SOURCE_OBSERVED,
|
||||
source_revision_id=(last or {}).get("applied_revision_id") if out.pending else None,
|
||||
)
|
||||
# 모바일이 PC 와 달랐다면 그것도 남긴다 — 아래 쓰기로 모바일이 PC 와 같아진다.
|
||||
if desc.mobile_description and desc.mobile_description != desc.description:
|
||||
st.add_revision(
|
||||
product_no=product_no,
|
||||
html_content=desc.mobile_description,
|
||||
revision_type=store.REVISION_BACKUP,
|
||||
memo=label + " (모바일 — PC와 달랐던 내용)",
|
||||
created_by=actor,
|
||||
mall_id=mall_id,
|
||||
shop_no=shop_no,
|
||||
source=store.SOURCE_OBSERVED,
|
||||
)
|
||||
if base_fingerprint and base_fingerprint != store.fingerprint(effective):
|
||||
raise WriteConflict(
|
||||
"편집하는 동안 카페24 값이 변경되었습니다. 새로고침해 현재 내용을 확인한 뒤 다시 적용하세요.",
|
||||
backup_id=out.backup_id,
|
||||
)
|
||||
if skip_if_same and html == effective and set_display is None and set_selling is None:
|
||||
out.changed = False
|
||||
return out
|
||||
|
||||
# 펜싱 — 잠금이 만료돼 남에게 넘어갔으면 쓰지 않는다.
|
||||
if not lock.still_mine() or (extra_fence is not None and not extra_fence()):
|
||||
raise WriteBusy("작업 시간이 길어져 잠금이 만료되었습니다. 카페24에 쓰지 않았습니다 — 다시 시도하세요.",
|
||||
backup_id=out.backup_id)
|
||||
|
||||
out.attempt_id = st.start_attempt(
|
||||
product_no=int(product_no),
|
||||
mall_id=mall_id,
|
||||
shop_no=shop_no,
|
||||
origin=origin,
|
||||
schedule_id=schedule_id,
|
||||
actor=actor,
|
||||
backup_revision_id=out.backup_id or None,
|
||||
observed_digest=store.content_digest(current_html) if current_html is not None else "",
|
||||
base_digest=store.content_digest(effective) if effective is not None else "",
|
||||
target_digest=store.content_digest(html) if html is not None else "",
|
||||
# 예약·복원은 내용이 버전(target_revision_id)에 있다 — 즉시 적용만 시도에 보관한다.
|
||||
target_html=html if (html is not None and not target_revision_id) else "",
|
||||
target_revision_id=target_revision_id,
|
||||
set_display=set_display,
|
||||
set_selling=set_selling,
|
||||
memo=(memo or "")[:500],
|
||||
)
|
||||
|
||||
try:
|
||||
updated = products.update_product(
|
||||
api.client,
|
||||
product_no,
|
||||
description=html,
|
||||
# PC/모바일 구분 안 함 — mobile_description 은 보내지 않고 "PC 와 동일"을 강제.
|
||||
separated_mobile_description="F" if html is not None else None,
|
||||
display=set_display,
|
||||
selling=set_selling,
|
||||
)
|
||||
except Exception as exc: # noqa: BLE001 — 분류해서 다시 던진다
|
||||
known = isinstance(exc, Cafe24Error)
|
||||
unknown = (not known) or bool(getattr(exc, "maybe_applied", False))
|
||||
message = str(exc) if known else f"{type(exc).__name__}: {exc}"
|
||||
try:
|
||||
st.update_attempt(
|
||||
out.attempt_id,
|
||||
status=store.ATTEMPT_UNKNOWN if unknown else store.ATTEMPT_REMOTE_FAILED,
|
||||
error=message,
|
||||
only_from=(store.ATTEMPT_STARTED,),
|
||||
)
|
||||
except Exception: # noqa: BLE001 — 기록 실패 시 STARTED 로 남는다(= 결과 모름, 안전 쪽)
|
||||
logger.exception("시도 #%s 결과 기록 실패", out.attempt_id)
|
||||
kind = RemoteWriteUnknown if unknown else RemoteWriteFailed
|
||||
raise kind(message, backup_id=out.backup_id, attempt_id=out.attempt_id) from exc
|
||||
|
||||
# ── 여기부터는 카페24에 반영된 뒤다. 무엇이 실패해도 "적용 실패"가 아니다. ──
|
||||
out.updated = updated if isinstance(updated, dict) else {}
|
||||
errors: list[str] = []
|
||||
try:
|
||||
st.update_attempt(
|
||||
out.attempt_id, status=store.ATTEMPT_REMOTE_OK, remote_ok=True,
|
||||
remote_updated_at=str(out.updated.get("updated_date") or ""),
|
||||
only_from=(store.ATTEMPT_STARTED,),
|
||||
)
|
||||
except Exception as exc: # noqa: BLE001
|
||||
logger.exception("시도 #%s REMOTE_OK 기록 실패", out.attempt_id)
|
||||
errors.append(f"시도 상태: {type(exc).__name__}")
|
||||
if out.updated.get("product_no"):
|
||||
_, snap_error = remember_product_write(st, product_no, out.updated)
|
||||
if snap_error:
|
||||
errors.append(f"스냅샷: {snap_error}")
|
||||
try:
|
||||
out.revision_id = record_attempt(st, {
|
||||
"id": out.attempt_id, "origin": origin, "actor": actor, "memo": memo,
|
||||
"target_revision_id": target_revision_id,
|
||||
"target_digest": store.content_digest(html) if html is not None else "",
|
||||
})
|
||||
out.recorded = True
|
||||
except Exception as exc: # noqa: BLE001
|
||||
logger.exception("시도 #%s 버전 기록 실패", out.attempt_id)
|
||||
errors.append(f"버전 기록: {type(exc).__name__}: {exc}")
|
||||
out.record_error = "; ".join(errors)
|
||||
|
||||
if html is not None and wait_confirm:
|
||||
# 카페24 관리자 API 의 쓰기 직후 읽기 지연을 짧게 흡수(확인 실패는 실패가 아니다).
|
||||
out.confirmed = products.wait_for_description(api.client, product_no, html)
|
||||
return out
|
||||
@@ -36,10 +36,23 @@ class CupangDBStore:
|
||||
open=False,
|
||||
)
|
||||
self._pool.open(wait=False)
|
||||
self._weight_col: bool | None = None # 마이그레이션 007(weight_g) 적용 여부 — 한 번 확인되면 기억
|
||||
|
||||
def close(self) -> None:
|
||||
self._pool.close()
|
||||
|
||||
def weight_enabled(self) -> bool:
|
||||
"""cupang_products.weight_g(포장무게, 마이그레이션 007) 가 있는가. 있으면 기억(없으면 다음에 다시 확인)."""
|
||||
if self._weight_col:
|
||||
return True
|
||||
with self._pool.connection() as conn:
|
||||
row = conn.execute(
|
||||
"SELECT 1 FROM information_schema.columns "
|
||||
"WHERE table_name = 'cupang_products' AND column_name = 'weight_g'"
|
||||
).fetchone()
|
||||
self._weight_col = row is not None
|
||||
return self._weight_col
|
||||
|
||||
# ════════════════════════════════════════════════════════════
|
||||
# 입고센터 (cupang_centers)
|
||||
# ════════════════════════════════════════════════════════════
|
||||
@@ -300,32 +313,39 @@ class CupangDBStore:
|
||||
product_name: str,
|
||||
coupang_item_code: str | None = None,
|
||||
sort_order: int = 0,
|
||||
weight_g: int | None = None,
|
||||
) -> dict[str, Any]:
|
||||
"""제품 등록/수정.
|
||||
|
||||
coupang_item_code 가 None 이면 기존 값을 유지한다(빈 문자열은 지우기).
|
||||
weight_g(포장무게 g) 가 None 이면 기존 값을 유지한다(수기 추가에서 비워 두면 그대로). 007 미적용이면 무시.
|
||||
"""
|
||||
code = (product_code or "").strip()
|
||||
name = (product_name or "").strip()
|
||||
cic = None if coupang_item_code is None else coupang_item_code.strip()
|
||||
if not code or not name:
|
||||
raise ValueError("제품코드와 제품명 모두 필요합니다.")
|
||||
weight = self.weight_enabled()
|
||||
with self._pool.connection() as conn:
|
||||
row = conn.execute(
|
||||
"""
|
||||
INSERT INTO cupang_products
|
||||
(product_code, product_name, coupang_item_code, sort_order)
|
||||
VALUES (%(code)s, %(name)s, COALESCE(%(cic)s, ''), %(sort)s)
|
||||
(product_code, product_name, coupang_item_code, sort_order"""
|
||||
+ (", weight_g" if weight else "") + """)
|
||||
VALUES (%(code)s, %(name)s, COALESCE(%(cic)s, ''), %(sort)s"""
|
||||
+ (", %(w)s" if weight else "") + """)
|
||||
ON CONFLICT (product_code) DO UPDATE
|
||||
SET product_name = EXCLUDED.product_name,
|
||||
coupang_item_code = COALESCE(
|
||||
%(cic)s, cupang_products.coupang_item_code
|
||||
),
|
||||
),"""
|
||||
+ ("\n weight_g = COALESCE(%(w)s, cupang_products.weight_g)," if weight else "")
|
||||
+ """
|
||||
sort_order = EXCLUDED.sort_order,
|
||||
active = TRUE
|
||||
RETURNING *
|
||||
""",
|
||||
{"code": code, "name": name, "cic": cic, "sort": sort_order},
|
||||
{"code": code, "name": name, "cic": cic, "sort": sort_order, "w": weight_g},
|
||||
).fetchone()
|
||||
return self._product_serialize(row)
|
||||
|
||||
@@ -345,8 +365,11 @@ class CupangDBStore:
|
||||
product_name: str,
|
||||
product_code: str,
|
||||
coupang_item_code: str = "",
|
||||
weight_g: Any = ...,
|
||||
) -> dict[str, Any]:
|
||||
"""등록된 제품 수정(제품명/제품코드/쿠팡상품코드).
|
||||
"""등록된 제품 수정(제품명/제품코드/쿠팡상품코드/포장무게).
|
||||
|
||||
weight_g: 정수 g 또는 None(지움). 넘기지 않으면(...) 그대로 — 007 미적용이면 무시.
|
||||
|
||||
제품코드가 바뀌면 같은 코드로 연결돼 있던 상자 규칙(cupang_box_rules)의
|
||||
product_code 도 함께 옮긴다(출고 라인은 과거 기록이라 스냅샷 유지).
|
||||
@@ -356,6 +379,7 @@ class CupangDBStore:
|
||||
cic = (coupang_item_code or "").strip()
|
||||
if not name or not code:
|
||||
raise ValueError("제품코드와 제품명 모두 필요합니다.")
|
||||
set_weight = weight_g is not ... and self.weight_enabled() # 트랜잭션 밖에서 확인(연결을 겹쳐 잡지 않게)
|
||||
with self._pool.connection() as conn:
|
||||
with conn.transaction():
|
||||
old = conn.execute(
|
||||
@@ -378,11 +402,12 @@ class CupangDBStore:
|
||||
UPDATE cupang_products
|
||||
SET product_name = %s,
|
||||
product_code = %s,
|
||||
coupang_item_code = %s
|
||||
coupang_item_code = %s"""
|
||||
+ (", weight_g = %s" if set_weight else "") + """
|
||||
WHERE id = %s
|
||||
RETURNING *
|
||||
""",
|
||||
(name, code, cic, product_id),
|
||||
(name, code, cic) + ((weight_g,) if set_weight else ()) + (product_id,),
|
||||
).fetchone()
|
||||
if code != old_code:
|
||||
# 새 코드로 된 규칙이 이미 있으면 옮기지 않는다(중복 방지).
|
||||
@@ -1081,6 +1106,8 @@ class CupangDBStore:
|
||||
out["active"] = bool(out.get("active", True))
|
||||
out["sort_order"] = int(out.get("sort_order", 0))
|
||||
out["coupang_item_code"] = (out.get("coupang_item_code") or "").strip()
|
||||
w = out.get("weight_g") # 007 미적용이면 키 없음 → None
|
||||
out["weight_g"] = int(w) if w is not None else None
|
||||
for k in ("created_at", "updated_at"):
|
||||
v = out.get(k)
|
||||
if isinstance(v, datetime):
|
||||
|
||||
@@ -193,10 +193,17 @@ def build_workbook(ship_date: str, shipments: list[dict[str, Any]]) -> Any:
|
||||
# ── 상자 목록(상자 번호별 내용물) ──────────────────────────────
|
||||
BOX_HEADERS = ["상자번호", "제품명", "제품코드", "수량"]
|
||||
BOX_WIDTHS_PX = {1: 70, 2: 240, 3: 110, 4: 70}
|
||||
BOX_WEIGHT_HEADER = "무게(g)" # with_weight 일 때 5열 — 상자 무게 합계(상자번호처럼 상자 단위로 세로 병합)
|
||||
BOX_WEIGHT_WIDTH_PX = 80
|
||||
|
||||
|
||||
def build_box_list_workbook(shipment: dict[str, Any], box_list: list[dict[str, Any]]) -> Any:
|
||||
"""상자 번호 · 제품명 · 제품코드 · 수량 한 줄씩. 시트명 = YYYYMMDD(요일)."""
|
||||
def build_box_list_workbook(
|
||||
shipment: dict[str, Any], box_list: list[dict[str, Any]], *, with_weight: bool = False
|
||||
) -> Any:
|
||||
"""상자 번호 · 제품명 · 제품코드 · 수량 한 줄씩. 시트명 = YYYYMMDD(요일).
|
||||
|
||||
with_weight 면 5열 "무게(g)" — 상자마다 box["weight_g"](라우터 _attach_box_weights), 모르면 빈칸."""
|
||||
headers = BOX_HEADERS + ([BOX_WEIGHT_HEADER] if with_weight else [])
|
||||
from openpyxl import Workbook
|
||||
from openpyxl.styles import Alignment, Border, Font, PatternFill, Side
|
||||
from openpyxl.utils import get_column_letter
|
||||
@@ -215,10 +222,10 @@ def build_box_list_workbook(shipment: dict[str, Any], box_list: list[dict[str, A
|
||||
|
||||
ws.cell(row=1, column=1, value=f"{with_dow(ship_date)} {center} 상자 목록")
|
||||
ws.cell(row=1, column=1).font = Font(size=14, bold=True)
|
||||
ws.merge_cells(start_row=1, start_column=1, end_row=1, end_column=len(BOX_HEADERS))
|
||||
ws.merge_cells(start_row=1, start_column=1, end_row=1, end_column=len(headers))
|
||||
|
||||
header_fill = PatternFill("solid", fgColor=HEADER_BG)
|
||||
for idx, name in enumerate(BOX_HEADERS, start=1):
|
||||
for idx, name in enumerate(headers, start=1):
|
||||
cell = ws.cell(row=2, column=idx, value=name)
|
||||
cell.font = Font(bold=True)
|
||||
cell.alignment = center_align
|
||||
@@ -235,18 +242,27 @@ def build_box_list_workbook(shipment: dict[str, Any], box_list: list[dict[str, A
|
||||
ws.cell(row=row, column=3, value=it.get("product_code") or "")
|
||||
ws.cell(row=row, column=4, value=int(it.get("quantity") or 0))
|
||||
row += 1
|
||||
# 한 상자에 여러 제품이면 상자번호 칸을 세로로 합친다.
|
||||
if with_weight and contents:
|
||||
w = entry.get("weight_g")
|
||||
ws.cell(row=first, column=5, value=(int(w) if w is not None else None))
|
||||
ws.cell(row=first, column=5).number_format = "#,##0"
|
||||
# 한 상자에 여러 제품이면 상자번호(·무게) 칸을 세로로 합친다.
|
||||
if row - first > 1:
|
||||
ws.merge_cells(start_row=first, start_column=1, end_row=row - 1, end_column=1)
|
||||
if with_weight:
|
||||
ws.merge_cells(start_row=first, start_column=5, end_row=row - 1, end_column=5)
|
||||
|
||||
last = row - 1
|
||||
for r in range(3, last + 1):
|
||||
for col in range(1, len(BOX_HEADERS) + 1):
|
||||
for col in range(1, len(headers) + 1):
|
||||
cell = ws.cell(row=r, column=col)
|
||||
cell.border = box
|
||||
cell.alignment = left_align if col == 2 else center_align
|
||||
|
||||
for col, px in BOX_WIDTHS_PX.items():
|
||||
widths = dict(BOX_WIDTHS_PX)
|
||||
if with_weight:
|
||||
widths[5] = BOX_WEIGHT_WIDTH_PX
|
||||
for col, px in widths.items():
|
||||
ws.column_dimensions[get_column_letter(col)].width = round(px / PX_PER_CHAR, 2)
|
||||
ws.row_dimensions[1].height = 24
|
||||
|
||||
|
||||
@@ -11,6 +11,7 @@ from __future__ import annotations
|
||||
|
||||
import calendar as _calendar
|
||||
import json
|
||||
from decimal import ROUND_HALF_UP, Decimal
|
||||
from fractions import Fraction
|
||||
from typing import Any
|
||||
|
||||
@@ -22,7 +23,7 @@ from fastapi import APIRouter, Body, Depends, File, Form, HTTPException, Request
|
||||
from fastapi.responses import HTMLResponse, JSONResponse, RedirectResponse
|
||||
|
||||
from .holidays import holiday_name, is_holiday
|
||||
from .store import SHIP_METHODS
|
||||
from .store import SHIP_METHODS, parse_weight_g
|
||||
|
||||
router = APIRouter(prefix="/cupang", tags=["cupang"])
|
||||
|
||||
@@ -411,6 +412,19 @@ def detail(request: Request, shipment_id: int) -> HTMLResponse:
|
||||
]
|
||||
calc = _compute_boxes(store, items)
|
||||
total_qty = sum(it["quantity"] for it in items)
|
||||
box_list = _expand_box_list(ship, calc, items)
|
||||
box_weight = _attach_box_weights(store, box_list)
|
||||
# 상자 목록 합계 행 — 수량 합계와 무게 합계(kg, 소수 첫째 자리)
|
||||
box_qty_total = sum(int(it.get("quantity") or 0) for b in box_list for it in (b.get("items") or []))
|
||||
box_weight_total = None
|
||||
box_weight_partial = False
|
||||
if box_weight:
|
||||
for b in box_list:
|
||||
b["weight_kg"] = _g_to_kg(b.get("weight_g"))
|
||||
if b.get("weight_g") is not None:
|
||||
box_weight_total = (box_weight_total or 0) + int(b["weight_g"])
|
||||
if b.get("weight_missing"):
|
||||
box_weight_partial = True
|
||||
|
||||
return render_template(
|
||||
request,
|
||||
@@ -424,7 +438,12 @@ def detail(request: Request, shipment_id: int) -> HTMLResponse:
|
||||
"shipment": ship,
|
||||
"items": items,
|
||||
"calc": calc,
|
||||
"box_list": _expand_box_list(ship, calc, items),
|
||||
"box_list": box_list,
|
||||
# 상자별 무게 합계(g) 칸 — 포장무게(마이그레이션 007) 가 있을 때만
|
||||
"box_weight": box_weight,
|
||||
"box_qty_total": box_qty_total,
|
||||
"box_weight_total_kg": _g_to_kg(box_weight_total),
|
||||
"box_weight_partial": box_weight_partial,
|
||||
"total_qty": total_qty,
|
||||
},
|
||||
)
|
||||
@@ -432,7 +451,7 @@ def detail(request: Request, shipment_id: int) -> HTMLResponse:
|
||||
|
||||
@router.get("/{shipment_id:int}/boxes.xlsx")
|
||||
def export_box_list_xlsx(request: Request, shipment_id: int) -> Any:
|
||||
"""상자 목록(상자번호·제품명·제품코드·수량) 엑셀 다운로드."""
|
||||
"""상자 목록(상자번호·제품명·제품코드·수량·무게) 엑셀 다운로드."""
|
||||
from io import BytesIO # noqa: WPS433
|
||||
|
||||
from fastapi.responses import StreamingResponse # noqa: WPS433
|
||||
@@ -457,8 +476,9 @@ def export_box_list_xlsx(request: Request, shipment_id: int) -> Any:
|
||||
for ln in (ship.get("lines") or [])
|
||||
]
|
||||
box_list = _expand_box_list(ship, _compute_boxes(store, items), items)
|
||||
with_weight = _attach_box_weights(store, box_list)
|
||||
|
||||
wb = build_box_list_workbook(ship, box_list)
|
||||
wb = build_box_list_workbook(ship, box_list, with_weight=with_weight)
|
||||
buf = BytesIO()
|
||||
wb.save(buf)
|
||||
buf.seek(0)
|
||||
@@ -1185,6 +1205,44 @@ def _compute_boxes(store: Any, raw_items: list[Any]) -> dict[str, Any]:
|
||||
}
|
||||
|
||||
|
||||
def _g_to_kg(grams: Any) -> str | None:
|
||||
"""g → kg 표시 글자 — 소수 둘째 자리에서 반올림(사사오입)해 첫째 자리까지. 예: 1,250g → "1.3"."""
|
||||
if grams is None:
|
||||
return None
|
||||
kg = (Decimal(int(grams)) / 1000).quantize(Decimal("0.1"), rounding=ROUND_HALF_UP)
|
||||
return f"{kg:,.1f}"
|
||||
|
||||
|
||||
def _attach_box_weights(store: Any, box_list: list[dict[str, Any]]) -> bool:
|
||||
"""상자마다 무게 합계(g) — 상자에 든 제품마다 수량 × 포장무게(설정(제품명)의 지금 값, cupang_products.weight_g).
|
||||
|
||||
상자에 넣는 값: weight_g = 아는 무게의 합(상자 안 제품 무게가 하나도 없으면 None),
|
||||
weight_missing = 무게가 없는 제품코드 목록(일부만 없으면 합계는 그 제품을 뺀 값).
|
||||
포장무게 칸(마이그레이션 007)이 없으면 아무것도 넣지 않고 False.
|
||||
"""
|
||||
if not store.weight_enabled():
|
||||
return False
|
||||
weights = {
|
||||
str(p.get("product_code") or "").strip(): p.get("weight_g")
|
||||
for p in store.list_products(include_inactive=True)
|
||||
}
|
||||
for box in box_list:
|
||||
contents = box.get("items") or []
|
||||
total, missing = 0, []
|
||||
for it in contents:
|
||||
code = str(it.get("product_code") or "").strip()
|
||||
w = weights.get(code)
|
||||
if w is None:
|
||||
if code not in missing:
|
||||
missing.append(code)
|
||||
continue
|
||||
total += int(w) * int(it.get("quantity") or 0)
|
||||
known = any(weights.get(str(it.get("product_code") or "").strip()) is not None for it in contents)
|
||||
box["weight_g"] = total if known else None
|
||||
box["weight_missing"] = missing
|
||||
return True
|
||||
|
||||
|
||||
def _expand_box_list(
|
||||
shipment: dict[str, Any], calc: dict[str, Any], items: list[dict[str, Any]]
|
||||
) -> list[dict[str, Any]]:
|
||||
@@ -1349,6 +1407,8 @@ def products_page(request: Request) -> HTMLResponse:
|
||||
"page_subtitle": "왼쪽 itemcode_db 목록에서 선택해 등록하면 폼 드롭다운에 노출됩니다.",
|
||||
"products": store.list_products(include_inactive=True),
|
||||
"registered_codes": [p["product_code"] for p in store.list_products(include_inactive=True)],
|
||||
# 포장무게(g) — 마이그레이션 007 적용 전이면 무게 칸을 숨긴다
|
||||
"weight_enabled": store.weight_enabled(),
|
||||
"search_enabled": bool(reader and reader.enabled),
|
||||
"search_reason": (reader.reason if reader else ""),
|
||||
},
|
||||
@@ -1412,6 +1472,7 @@ def product_upsert(
|
||||
product_code: str = Form(...),
|
||||
product_name: str = Form(...),
|
||||
coupang_item_code: str = Form(""),
|
||||
weight_g: str = Form(""),
|
||||
sort_order: int = Form(0),
|
||||
user: dict[str, Any] = Depends(_require_user),
|
||||
) -> RedirectResponse:
|
||||
@@ -1422,9 +1483,10 @@ def product_upsert(
|
||||
store.upsert_product(
|
||||
product_code=product_code,
|
||||
product_name=product_name,
|
||||
# 빈 값은 "미입력" 으로 보고 기존 쿠팡상품코드를 유지한다.
|
||||
# 빈 값은 "미입력" 으로 보고 기존 쿠팡상품코드·포장무게를 유지한다.
|
||||
coupang_item_code=(coupang_item_code.strip() or None),
|
||||
sort_order=sort_order,
|
||||
weight_g=parse_weight_g(weight_g),
|
||||
)
|
||||
except ValueError as exc:
|
||||
raise HTTPException(status_code=400, detail=str(exc))
|
||||
@@ -1457,7 +1519,8 @@ def product_edit(
|
||||
payload: dict[str, Any] = Body(...),
|
||||
user: dict[str, Any] = Depends(_require_user),
|
||||
) -> JSONResponse:
|
||||
"""등록된 제품 수정. body: {product_name, product_code, coupang_item_code}."""
|
||||
"""등록된 제품 수정. body: {product_name, product_code, coupang_item_code, weight_g?}.
|
||||
weight_g 키가 있으면 저장(빈 값 = 지움), 없으면 무게는 그대로."""
|
||||
store = _store(request)
|
||||
if store is None:
|
||||
raise HTTPException(status_code=503, detail="cupang_db 미설정")
|
||||
@@ -1467,6 +1530,7 @@ def product_edit(
|
||||
product_name=str(payload.get("product_name") or ""),
|
||||
product_code=str(payload.get("product_code") or ""),
|
||||
coupang_item_code=str(payload.get("coupang_item_code") or ""),
|
||||
weight_g=(parse_weight_g(payload.get("weight_g")) if "weight_g" in payload else ...),
|
||||
)
|
||||
except KeyError:
|
||||
raise HTTPException(status_code=404, detail="제품을 찾을 수 없습니다.")
|
||||
|
||||
@@ -94,3 +94,32 @@ def compute_boxes(quantity: int, units_per_box: int | None) -> dict[str, Any]:
|
||||
"remainder_units": qty % upb,
|
||||
"required_boxes": math.ceil(qty / upb),
|
||||
}
|
||||
|
||||
|
||||
# 제품 포장무게(g) — cupang_products.weight_g (마이그레이션 007). 0 ~ 1,000,000g, 정수.
|
||||
WEIGHT_MAX_G = 1_000_000
|
||||
|
||||
|
||||
def parse_weight_g(value: Any) -> int | None:
|
||||
"""포장무게 입력 → 그램 정수. 빈 값은 None(미입력).
|
||||
|
||||
"1,070" · " 1,070 " · "1070g" · "1070.0" 처럼 쉼표·공백·g 단위가 붙어도 읽는다.
|
||||
숫자가 아니거나 음수·소수(0.5g 등)·범위 밖이면 ValueError.
|
||||
"""
|
||||
if value is None:
|
||||
return None
|
||||
s = str(value).strip().replace(",", "").replace(" ", "")
|
||||
if s.lower().endswith("g"):
|
||||
s = s[:-1]
|
||||
if not s:
|
||||
return None
|
||||
try:
|
||||
f = float(s)
|
||||
except ValueError:
|
||||
raise ValueError(f"포장무게는 숫자(g)로 입력하세요: {value}")
|
||||
if f != f or f < 0 or f != int(f):
|
||||
raise ValueError(f"포장무게는 0 이상의 정수(g)로 입력하세요: {value}")
|
||||
v = int(f)
|
||||
if v > WEIGHT_MAX_G:
|
||||
raise ValueError(f"포장무게가 너무 큽니다(최대 {WEIGHT_MAX_G:,}g): {value}")
|
||||
return v
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
{% extends "erp_base.html" %}
|
||||
|
||||
{% block head_extra %}<link rel="stylesheet" href="/static/cupang.css?v=20260904f" />{% endblock %}
|
||||
{% block head_extra %}<link rel="stylesheet" href="/static/cupang.css?v=20261013b" />{% endblock %}
|
||||
|
||||
{% block content %}
|
||||
<section class="cpg">
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
{% extends "erp_base.html" %}
|
||||
|
||||
{% block head_extra %}<link rel="stylesheet" href="/static/cupang.css?v=20260904f" />{% endblock %}
|
||||
{% block head_extra %}<link rel="stylesheet" href="/static/cupang.css?v=20261013b" />{% endblock %}
|
||||
|
||||
{% block content %}
|
||||
<section class="cpg">
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
{% extends "erp_base.html" %}
|
||||
|
||||
{% block head_extra %}<link rel="stylesheet" href="/static/cupang.css?v=20260904f" />{% endblock %}
|
||||
{% block head_extra %}<link rel="stylesheet" href="/static/cupang.css?v=20261013b" />{% endblock %}
|
||||
|
||||
{% block content %}
|
||||
<section class="cpg">
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
{% extends "erp_base.html" %}
|
||||
|
||||
{% block head_extra %}<link rel="stylesheet" href="/static/cupang.css?v=20260904f" />{% endblock %}
|
||||
{% block head_extra %}<link rel="stylesheet" href="/static/cupang.css?v=20261013b" />{% endblock %}
|
||||
|
||||
{% block content %}
|
||||
<section class="cpg">
|
||||
@@ -34,6 +34,12 @@
|
||||
<input class="erp-input" type="text" name="product_code" required placeholder="예: MS-1012" /></label>
|
||||
<label class="erp-field"><span>쿠팡상품코드</span>
|
||||
<input class="erp-input" type="text" name="coupang_item_code" placeholder="예: 1234567890" /></label>
|
||||
{% if weight_enabled %}
|
||||
{# 포장무게(g) — 쉼표·g 붙여도 됨(1,070). 비워 두면 같은 제품코드의 기존 무게 유지 #}
|
||||
<label class="erp-field cpg-weight-field"><span>포장무게(g)</span>
|
||||
<input class="erp-input" type="text" name="weight_g" inputmode="numeric" autocomplete="off"
|
||||
pattern="\s*[0-9][0-9,]*\s*(g|G)?\s*" title="숫자(g)로 입력하세요. 예: 1,070" placeholder="예: 1,070" /></label>
|
||||
{% endif %}
|
||||
<button type="submit" class="erp-btn erp-btn-primary">추가</button>
|
||||
</div>
|
||||
</form>
|
||||
@@ -60,6 +66,7 @@
|
||||
<th><button type="button" class="cpg-sort" data-sort-key="name">제품명<span class="cpg-sort-ind" aria-hidden="true"></span></button></th>
|
||||
<th><button type="button" class="cpg-sort" data-sort-key="code">제품코드<span class="cpg-sort-ind" aria-hidden="true"></span></button></th>
|
||||
<th><button type="button" class="cpg-sort" data-sort-key="cpcode">쿠팡상품코드<span class="cpg-sort-ind" aria-hidden="true"></span></button></th>
|
||||
{% if weight_enabled %}<th class="cpg-weight-col"><button type="button" class="cpg-sort" data-sort-key="weight">포장무게<span class="cpg-sort-ind" aria-hidden="true"></span></button></th>{% endif %}
|
||||
<th>상태</th>
|
||||
<th>동작</th>
|
||||
</tr>
|
||||
@@ -68,10 +75,12 @@
|
||||
{% for p in products %}
|
||||
<tr data-name="{{ p.product_name }}" data-code="{{ p.product_code }}"
|
||||
data-cpcode="{{ p.coupang_item_code }}"
|
||||
data-weight="{{ p.weight_g if p.weight_g is not none else '' }}"
|
||||
class="cpg-prod-row{% if not p.active %} is-inactive{% endif %}">
|
||||
<td title="{{ p.product_name }}">{{ p.product_name }}</td>
|
||||
<td title="{{ p.product_code }}">{{ p.product_code }}</td>
|
||||
<td class="cpg-cpcode" title="{{ p.coupang_item_code }}">{% if p.coupang_item_code %}{{ p.coupang_item_code }}{% else %}<span class="erp-muted">—</span>{% endif %}</td>
|
||||
{% if weight_enabled %}<td class="cpg-weight-col">{% if p.weight_g is not none %}{{ "{:,}".format(p.weight_g) }}<span class="cpg-weight-unit">g</span>{% else %}<span class="erp-muted">—</span>{% endif %}</td>{% endif %}
|
||||
<td>
|
||||
<!-- 배지 자체가 토글 버튼: 클릭 → 활성/비활성 전환 -->
|
||||
<button type="button" class="erp-badge cpg-active-toggle
|
||||
@@ -92,7 +101,7 @@
|
||||
</tr>
|
||||
{% endfor %}
|
||||
{% if not products %}
|
||||
<tr class="cpg-no-sort"><td colspan="5" class="erp-muted">등록된 제품명이 없습니다. 왼쪽에서 선택해 등록하세요.</td></tr>
|
||||
<tr class="cpg-no-sort"><td colspan="{{ 6 if weight_enabled else 5 }}" class="erp-muted">등록된 제품명이 없습니다. 왼쪽에서 선택해 등록하세요.</td></tr>
|
||||
{% endif %}
|
||||
</tbody>
|
||||
</table>
|
||||
@@ -117,6 +126,10 @@
|
||||
rows.sort(function (a, b) {
|
||||
var av = a.getAttribute("data-" + state.key) || "";
|
||||
var bv = b.getAttribute("data-" + state.key) || "";
|
||||
if (state.key === "weight") { // 포장무게 — 숫자 크기순, 무게 없는 줄은 늘 맨 뒤
|
||||
if (!av || !bv) return (av ? 0 : 1) - (bv ? 0 : 1);
|
||||
return (Number(av) - Number(bv)) * state.dir;
|
||||
}
|
||||
return collator.compare(av, bv) * state.dir;
|
||||
});
|
||||
rows.forEach(function (r) { tbody.appendChild(r); });
|
||||
@@ -150,6 +163,10 @@
|
||||
<input class="erp-input" type="text" id="cpg-edit-code" /></label>
|
||||
<label class="erp-field"><span>쿠팡상품코드</span>
|
||||
<input class="erp-input" type="text" id="cpg-edit-cpcode" placeholder="비우면 지워집니다" /></label>
|
||||
{% if weight_enabled %}
|
||||
<label class="erp-field"><span>포장무게(g)</span>
|
||||
<input class="erp-input" type="text" id="cpg-edit-weight" inputmode="numeric" autocomplete="off" placeholder="예: 1,070 (비우면 지워집니다)" /></label>
|
||||
{% endif %}
|
||||
<p class="erp-muted" id="cpg-edit-msg" style="margin:0;font-size:12px;"></p>
|
||||
<div class="cpg-dlg-actions erp-page-actions">
|
||||
<button type="button" class="erp-btn erp-btn-outline" data-edit-close>취소</button>
|
||||
@@ -167,6 +184,7 @@
|
||||
var elName = document.getElementById("cpg-edit-name");
|
||||
var elCode = document.getElementById("cpg-edit-code");
|
||||
var elCp = document.getElementById("cpg-edit-cpcode");
|
||||
var elW = document.getElementById("cpg-edit-weight"); // 마이그레이션 007 전이면 없음
|
||||
var elMsg = document.getElementById("cpg-edit-msg");
|
||||
var saveBtn = document.getElementById("cpg-edit-save");
|
||||
var editingId = null;
|
||||
@@ -181,6 +199,10 @@
|
||||
elName.value = row.getAttribute("data-name") || "";
|
||||
elCode.value = row.getAttribute("data-code") || "";
|
||||
elCp.value = row.getAttribute("data-cpcode") || "";
|
||||
if (elW) {
|
||||
var w = row.getAttribute("data-weight") || "";
|
||||
elW.value = w ? Number(w).toLocaleString("ko-KR") : "";
|
||||
}
|
||||
elMsg.textContent = "";
|
||||
dlg.hidden = false;
|
||||
elName.focus();
|
||||
@@ -200,6 +222,12 @@
|
||||
product_code: (elCode.value || "").trim(),
|
||||
coupang_item_code: (elCp.value || "").trim()
|
||||
};
|
||||
if (elW) {
|
||||
// 포장무게 — 쉼표·g 는 서버가 읽는다. 숫자가 아니면 여기서 먼저 막는다(빈 값 = 지움)
|
||||
var wv = (elW.value || "").trim();
|
||||
if (wv && !/^[0-9][0-9,]*\s*g?$/i.test(wv)) { elMsg.textContent = "포장무게는 숫자(g)로 입력하세요. 예: 1,070"; return; }
|
||||
body.weight_g = wv;
|
||||
}
|
||||
if (!body.product_name || !body.product_code) {
|
||||
elMsg.textContent = "제품명과 제품코드는 필수입니다."; return;
|
||||
}
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
{% extends "erp_base.html" %}
|
||||
|
||||
{% block head_extra %}<link rel="stylesheet" href="/static/cupang.css?v=20260904f" />{% endblock %}
|
||||
{% block head_extra %}<link rel="stylesheet" href="/static/cupang.css?v=20261013b" />{% endblock %}
|
||||
|
||||
{% block content %}
|
||||
{# 쿠팡 로켓 매출 — 발주 라인별 공급가·원가·물류비·마진 #}
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
{% extends "erp_base.html" %}
|
||||
|
||||
{% block head_extra %}<link rel="stylesheet" href="/static/cupang.css?v=20260904f" />{% endblock %}
|
||||
{% block head_extra %}<link rel="stylesheet" href="/static/cupang.css?v=20261013b" />{% endblock %}
|
||||
|
||||
{% block content %}
|
||||
{# 출고 묶음 보기 — 상자 계산 화면과 같은 3열 구성. 읽기 전용(수정 없음). #}
|
||||
@@ -73,16 +73,17 @@
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<div class="cpg-sum-scroll">
|
||||
<div class="cpg-sum-scroll cpg-boxno-scroll">
|
||||
<table class="erp-table cpg-boxno-table">
|
||||
<colgroup>
|
||||
<col class="cpg-boxno-c-no" />
|
||||
<col class="cpg-boxno-c-name" />
|
||||
<col class="cpg-boxno-c-code" />
|
||||
<col class="cpg-boxno-c-qty" />
|
||||
{% if box_weight %}<col class="cpg-boxno-c-weight" />{% endif %}
|
||||
</colgroup>
|
||||
<thead>
|
||||
<tr><th>상자번호</th><th>제품명</th><th>제품코드</th><th>수량</th></tr>
|
||||
<tr><th>상자번호</th><th>제품명</th><th>제품코드</th><th>수량</th>{% if box_weight %}<th title="상자에 든 제품의 수량 × 포장무게(설정(제품명)) 합계">무게</th>{% endif %}</tr>
|
||||
</thead>
|
||||
<tbody>
|
||||
{% for b in box_list %}
|
||||
@@ -94,13 +95,40 @@
|
||||
<td title="{{ it.product_name }}">{{ it.product_name }}</td>
|
||||
<td class="cpg-boxno-code">{{ it.product_code }}</td>
|
||||
<td class="cpg-calc-num">{{ it.quantity }}</td>
|
||||
{% if box_weight and loop.first %}
|
||||
{# 상자 무게 합계 — 상자번호처럼 상자 단위로 한 칸. 무게 없는 제품이 있으면 표시 #}
|
||||
{% set miss = b.weight_missing or [] %}
|
||||
<td class="cpg-boxno-weight" rowspan="{{ b['items']|length }}"
|
||||
{% if miss %}title="포장무게 미입력: {{ miss|join(', ') }}{% if b.weight_g is not none %} — 이 제품을 뺀 합계{% endif %} (설정(제품명)에서 입력)"{% endif %}>
|
||||
{%- if b.weight_g is not none -%}
|
||||
{{ b.weight_kg }}<span class="cpg-weight-unit">kg</span>{% if miss %}<span class="cpg-boxno-wmiss">일부 미입력</span>{% endif %}
|
||||
{%- else -%}<span class="erp-muted">—</span>{%- endif -%}
|
||||
</td>
|
||||
{% endif %}
|
||||
</tr>
|
||||
{% endfor %}
|
||||
{% endfor %}
|
||||
{% if not box_list %}
|
||||
<tr><td colspan="4" class="erp-muted">상자 정보가 없습니다.</td></tr>
|
||||
<tr><td colspan="{{ 5 if box_weight else 4 }}" class="erp-muted">상자 정보가 없습니다.</td></tr>
|
||||
{% endif %}
|
||||
</tbody>
|
||||
{% if box_list %}
|
||||
{# 합계 행 — 수량 합계, 무게 합계(kg). 무게 없는 제품이 있으면 아는 무게만 더한 값 #}
|
||||
<tfoot>
|
||||
<tr class="cpg-boxno-total">
|
||||
<td class="cpg-boxno-cell" colspan="3">합계</td>
|
||||
<td class="cpg-calc-num">{{ "{:,}".format(box_qty_total) }}</td>
|
||||
{% if box_weight %}
|
||||
<td class="cpg-boxno-weight"
|
||||
{% if box_weight_partial %}title="포장무게 미입력 제품이 있어 아는 무게만 더한 합계 (설정(제품명)에서 입력)"{% endif %}>
|
||||
{%- if box_weight_total_kg is not none -%}
|
||||
{{ box_weight_total_kg }}<span class="cpg-weight-unit">kg</span>{% if box_weight_partial %}<span class="cpg-boxno-wmiss">일부 미입력</span>{% endif %}
|
||||
{%- else -%}<span class="erp-muted">—</span>{%- endif -%}
|
||||
</td>
|
||||
{% endif %}
|
||||
</tr>
|
||||
</tfoot>
|
||||
{% endif %}
|
||||
</table>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
@@ -0,0 +1,23 @@
|
||||
"""긴급 공지 — ERP 전체 화면 가운데에 띄우는 공지(2026-10-12).
|
||||
|
||||
- 라우터: `router.py` (prefix=/notice) — 만들기·고치기는 수퍼관리자만, 받기·[확인]은 로그인 사용자 누구나
|
||||
- 저장소: `db.py` (project_db 마이그레이션 024 의 urgent_notice* 표 — 프로젝트 저장소의 연결 풀을 같이 쓴다)
|
||||
- 검증: `store.py`
|
||||
- 화면: 관리 `templates/notice/admin.html` + `static/erp-notice-admin.js`, 표시 `static/erp-notice.js`(erp_base.html 공용)
|
||||
상세는 docs/NOTICE_MODULE.md.
|
||||
"""
|
||||
|
||||
from typing import Any
|
||||
|
||||
from .router import router
|
||||
|
||||
__all__ = ["router", "build_notice_store"]
|
||||
|
||||
|
||||
def build_notice_store(project_store: Any) -> Any:
|
||||
"""프로젝트 저장소(PROJECT_DB_URL)가 있으면 그 연결 풀로 NoticeStore, 없으면 None(공지 API 는 503)."""
|
||||
if project_store is None:
|
||||
return None
|
||||
from .db import NoticeStore # noqa: WPS433
|
||||
|
||||
return NoticeStore(project_store.pool)
|
||||
@@ -0,0 +1,238 @@
|
||||
"""긴급 공지 저장소 — project_db(마이그레이션 024)의 urgent_notice* 표. 연결 풀은 프로젝트 저장소와 같이 쓴다."""
|
||||
|
||||
from __future__ import annotations
|
||||
|
||||
from datetime import datetime, timezone
|
||||
from typing import Any
|
||||
|
||||
from psycopg import errors as psycopg_errors
|
||||
|
||||
from app.modules.project import store as pj_store
|
||||
from app.timezone import KST
|
||||
|
||||
from . import store
|
||||
|
||||
|
||||
def _iso(v: Any) -> str:
|
||||
return v.astimezone(KST).isoformat(timespec="minutes") if isinstance(v, datetime) else ""
|
||||
|
||||
|
||||
def _version(v: Any) -> str:
|
||||
"""공지 내용 버전 = updated_at(마이크로초까지, UTC) — 고치기·취소 때마다 바뀐다. 받는 사람 화면이 바뀐 내용을 다시 그리고,
|
||||
[확인]이 어느 내용을 읽고 누른 것인지 서버가 가린다(2026-10-15 검토 F07)."""
|
||||
return v.astimezone(timezone.utc).strftime("%Y%m%d%H%M%S%f") if isinstance(v, datetime) else ""
|
||||
|
||||
|
||||
class NoticeStore:
|
||||
def __init__(self, pool: Any) -> None:
|
||||
self._pool = pool
|
||||
|
||||
def _conn(self) -> Any:
|
||||
return self._pool.connection()
|
||||
|
||||
@staticmethod
|
||||
def _run(fn: Any) -> Any:
|
||||
try:
|
||||
return fn()
|
||||
except psycopg_errors.UndefinedTable:
|
||||
raise store.NoticeMigrationNeeded()
|
||||
|
||||
# ── 읽기 ────────────────────────────────────────────────
|
||||
@staticmethod
|
||||
def _row(r: dict[str, Any]) -> dict[str, Any]:
|
||||
return {
|
||||
"id": int(r["id"]), "title": r["title"], "body_html": r["body_html"],
|
||||
"show_at": _iso(r["show_at"]), "to_all": bool(r["to_all"]),
|
||||
"created_by": r["created_by"], "created_at": _iso(r["created_at"]),
|
||||
"updated_by": r.get("updated_by") or "", "updated_at": _iso(r.get("updated_at")),
|
||||
"version": _version(r.get("updated_at")),
|
||||
"cancelled_at": _iso(r.get("cancelled_at")), "cancelled_by": r.get("cancelled_by") or "",
|
||||
}
|
||||
|
||||
def list_notices(self, *, limit: int = 200) -> list[dict[str, Any]]:
|
||||
"""관리 화면 — 최근 것부터. 받는 사람·확인한 사람 목록을 함께."""
|
||||
def run() -> list[dict[str, Any]]:
|
||||
with self._conn() as conn:
|
||||
rows = conn.execute("SELECT * FROM urgent_notices ORDER BY show_at DESC, id DESC LIMIT %s",
|
||||
(int(limit),)).fetchall()
|
||||
ids = [int(r["id"]) for r in rows]
|
||||
targets: dict[int, list[str]] = {i: [] for i in ids}
|
||||
acks: dict[int, dict[str, str]] = {i: {} for i in ids}
|
||||
if ids:
|
||||
for t in conn.execute("SELECT notice_id, user_email FROM urgent_notice_targets "
|
||||
"WHERE notice_id = ANY(%s) ORDER BY user_email", (ids,)).fetchall():
|
||||
targets[int(t["notice_id"])].append(t["user_email"])
|
||||
for a in conn.execute("SELECT notice_id, user_email, acked_at FROM urgent_notice_acks "
|
||||
"WHERE notice_id = ANY(%s) ORDER BY acked_at", (ids,)).fetchall():
|
||||
acks[int(a["notice_id"])][a["user_email"]] = _iso(a["acked_at"])
|
||||
return [{**self._row(r), "targets": targets[int(r["id"])], "acks": acks[int(r["id"])]} for r in rows]
|
||||
return self._run(run)
|
||||
|
||||
def pending_for(self, *, email: str, now: datetime | None = None) -> list[dict[str, Any]]:
|
||||
"""이 사람이 지금 봐야 할 공지 — 취소 안 됨·띄울 시각이 지남·받는 사람(전체 또는 지정)·아직 [확인] 안 함. 오래된 것부터."""
|
||||
em = pj_store.norm_str(email, lower=True)
|
||||
|
||||
def run() -> list[dict[str, Any]]:
|
||||
with self._conn() as conn:
|
||||
rows = conn.execute(
|
||||
"SELECT n.* FROM urgent_notices n "
|
||||
"WHERE n.cancelled_at IS NULL AND n.show_at <= %s "
|
||||
" AND (n.to_all OR EXISTS (SELECT 1 FROM urgent_notice_targets t "
|
||||
" WHERE t.notice_id = n.id AND t.user_email = %s)) "
|
||||
" AND NOT EXISTS (SELECT 1 FROM urgent_notice_acks a WHERE a.notice_id = n.id AND a.user_email = %s) "
|
||||
"ORDER BY n.show_at ASC, n.id ASC LIMIT 20",
|
||||
(now or datetime.now(KST), em, em),
|
||||
).fetchall()
|
||||
return [self._row(r) for r in rows]
|
||||
return self._run(run)
|
||||
|
||||
def get_notice(self, *, notice_id: int) -> dict[str, Any] | None:
|
||||
def run() -> dict[str, Any] | None:
|
||||
with self._conn() as conn:
|
||||
r = conn.execute("SELECT * FROM urgent_notices WHERE id = %s", (notice_id,)).fetchone()
|
||||
if r is None:
|
||||
return None
|
||||
t = [x["user_email"] for x in conn.execute(
|
||||
"SELECT user_email FROM urgent_notice_targets WHERE notice_id = %s ORDER BY user_email",
|
||||
(notice_id,)).fetchall()]
|
||||
return {**self._row(r), "targets": t}
|
||||
return self._run(run)
|
||||
|
||||
def is_recipient(self, *, notice: dict[str, Any], email: str) -> bool:
|
||||
em = pj_store.norm_str(email, lower=True)
|
||||
return bool(notice["to_all"]) or em in notice.get("targets", [])
|
||||
|
||||
# ── 쓰기 ────────────────────────────────────────────────
|
||||
def _link_images(self, conn: Any, notice_id: int, body: str, by: str) -> None:
|
||||
"""본문에 든 이미지를 이 공지에 묶는다 — 내가 올린, 아직 어느 공지에도 안 묶인 이미지만(남의 공지 이미지 가로채기 방지)."""
|
||||
ids = store.image_ids_in(body)
|
||||
if ids:
|
||||
conn.execute("UPDATE urgent_notice_images SET notice_id = %s "
|
||||
"WHERE id = ANY(%s) AND notice_id IS NULL AND uploaded_by = %s", (notice_id, ids, by))
|
||||
# 하루 넘게 어느 공지에도 안 묶인 이미지(올렸다가 저장 안 함)는 정리
|
||||
conn.execute("DELETE FROM urgent_notice_images WHERE notice_id IS NULL AND created_at < now() - interval '1 day'")
|
||||
|
||||
def create_notice(self, *, title: Any, body: Any, show_at: Any, to_all: Any, targets: Any, by: str) -> dict[str, Any]:
|
||||
ttl = store.validate_title(title)
|
||||
html = store.sanitize_body(body)
|
||||
when = store.parse_show_at(show_at)
|
||||
all_, emails = store.validate_targets(to_all, targets)
|
||||
who = pj_store.norm_str(by, lower=True)
|
||||
|
||||
def run() -> int:
|
||||
with self._conn() as conn:
|
||||
with conn.transaction():
|
||||
nid = int(conn.execute(
|
||||
"INSERT INTO urgent_notices (title, body_html, show_at, to_all, created_by, updated_by) "
|
||||
"VALUES (%s,%s,%s,%s,%s,%s) RETURNING id", (ttl, html, when, all_, who, who),
|
||||
).fetchone()["id"])
|
||||
for em in emails:
|
||||
conn.execute("INSERT INTO urgent_notice_targets (notice_id, user_email) VALUES (%s,%s) "
|
||||
"ON CONFLICT DO NOTHING", (nid, em))
|
||||
self._link_images(conn, nid, html, who)
|
||||
return nid
|
||||
return self.get_notice(notice_id=self._run(run)) # type: ignore[return-value]
|
||||
|
||||
def update_notice(self, *, notice_id: int, title: Any, body: Any, show_at: Any, to_all: Any, targets: Any,
|
||||
by: str, reshow: bool = False) -> dict[str, Any]:
|
||||
"""고치기 — 받는 사람·시각·내용 전부. reshow=True 면 이미 [확인]한 사람에게도 다시 띄운다(확인 기록 지움)."""
|
||||
ttl = store.validate_title(title)
|
||||
html = store.sanitize_body(body)
|
||||
when = store.parse_show_at(show_at)
|
||||
all_, emails = store.validate_targets(to_all, targets)
|
||||
who = pj_store.norm_str(by, lower=True)
|
||||
|
||||
def run() -> None:
|
||||
with self._conn() as conn:
|
||||
with conn.transaction():
|
||||
row = conn.execute("UPDATE urgent_notices SET title=%s, body_html=%s, show_at=%s, to_all=%s, "
|
||||
"updated_by=%s, updated_at=now() WHERE id=%s RETURNING id",
|
||||
(ttl, html, when, all_, who, notice_id)).fetchone()
|
||||
if row is None:
|
||||
raise KeyError(notice_id)
|
||||
conn.execute("DELETE FROM urgent_notice_targets WHERE notice_id = %s", (notice_id,))
|
||||
for em in emails:
|
||||
conn.execute("INSERT INTO urgent_notice_targets (notice_id, user_email) VALUES (%s,%s) "
|
||||
"ON CONFLICT DO NOTHING", (notice_id, em))
|
||||
if reshow:
|
||||
conn.execute("DELETE FROM urgent_notice_acks WHERE notice_id = %s", (notice_id,))
|
||||
self._link_images(conn, notice_id, html, who)
|
||||
self._run(run)
|
||||
return self.get_notice(notice_id=notice_id) # type: ignore[return-value]
|
||||
|
||||
def cancel_notice(self, *, notice_id: int, by: str, cancel: bool = True) -> dict[str, Any]:
|
||||
"""취소(더 띄우지 않음) · 취소 되돌리기. 기록은 남는다."""
|
||||
def run() -> None:
|
||||
with self._conn() as conn:
|
||||
row = conn.execute(
|
||||
"UPDATE urgent_notices SET cancelled_at = CASE WHEN %s THEN now() ELSE NULL END, "
|
||||
"cancelled_by = CASE WHEN %s THEN %s ELSE '' END, updated_at = now() WHERE id = %s RETURNING id",
|
||||
(cancel, cancel, pj_store.norm_str(by, lower=True), notice_id),
|
||||
).fetchone()
|
||||
if row is None:
|
||||
raise KeyError(notice_id)
|
||||
self._run(run)
|
||||
return self.get_notice(notice_id=notice_id) # type: ignore[return-value]
|
||||
|
||||
def ack(self, *, notice_id: int, email: str, version: str | None = None, now: datetime | None = None) -> str:
|
||||
"""[확인] — 결과: "acked"(처음) · "already"(이미 확인 — 여러 번 눌러도 한 번) · "stale"(그 사이 내용이 바뀜 — 읽은
|
||||
version 이 지금과 다름) · "denied"(받는 사람이 아님·띄울 시각 전·취소·없음).
|
||||
|
||||
받는 사람·표시 시각·취소 확인과 기록이 **한 트랜잭션**(2026-10-15 검토 F08): 공지 행을 FOR SHARE 로 잠그고 조건을 본 뒤
|
||||
기록한다 — 동시에 취소·고치기가 들어오면 그 쪽이 먼저 끝나거나(그러면 바뀐 행으로 다시 판정) 이 기록 뒤로 기다린다.
|
||||
version 이 없으면(예전 화면) 내용 확인은 건너뛴다."""
|
||||
em = pj_store.norm_str(email, lower=True)
|
||||
|
||||
def run() -> str:
|
||||
with self._conn() as conn:
|
||||
with conn.transaction():
|
||||
n = conn.execute(
|
||||
"SELECT n.id, n.updated_at FROM urgent_notices n "
|
||||
"WHERE n.id = %s AND n.cancelled_at IS NULL AND n.show_at <= %s "
|
||||
" AND (n.to_all OR EXISTS (SELECT 1 FROM urgent_notice_targets t "
|
||||
" WHERE t.notice_id = n.id AND t.user_email = %s)) "
|
||||
"FOR SHARE OF n",
|
||||
(notice_id, now or datetime.now(KST), em),
|
||||
).fetchone()
|
||||
if n is None:
|
||||
return "denied"
|
||||
done = conn.execute("SELECT 1 FROM urgent_notice_acks WHERE notice_id = %s AND user_email = %s",
|
||||
(notice_id, em)).fetchone()
|
||||
if done is not None:
|
||||
return "already"
|
||||
if version and version != _version(n["updated_at"]):
|
||||
return "stale"
|
||||
r = conn.execute("INSERT INTO urgent_notice_acks (notice_id, user_email) VALUES (%s,%s) "
|
||||
"ON CONFLICT DO NOTHING RETURNING notice_id", (notice_id, em)).fetchone()
|
||||
return "acked" if r is not None else "already"
|
||||
return self._run(run)
|
||||
|
||||
# ── 이미지 ──────────────────────────────────────────────
|
||||
def add_image(self, *, data: bytes, filename: str, by: str) -> dict[str, Any]:
|
||||
ctype = store.sniff_image(data)
|
||||
|
||||
def run() -> int:
|
||||
with self._conn() as conn:
|
||||
return int(conn.execute(
|
||||
"INSERT INTO urgent_notice_images (filename, content_type, size_bytes, data, uploaded_by) "
|
||||
"VALUES (%s,%s,%s,%s,%s) RETURNING id",
|
||||
(pj_store.norm_str(filename)[:200], ctype, len(data), data, pj_store.norm_str(by, lower=True)),
|
||||
).fetchone()["id"])
|
||||
iid = self._run(run)
|
||||
return {"id": iid, "url": f"/notice/images/{iid}", "content_type": ctype}
|
||||
|
||||
def get_image(self, *, image_id: int) -> dict[str, Any] | None:
|
||||
def run() -> dict[str, Any] | None:
|
||||
with self._conn() as conn:
|
||||
r = conn.execute("SELECT id, notice_id, content_type, data, uploaded_by FROM urgent_notice_images "
|
||||
"WHERE id = %s", (image_id,)).fetchone()
|
||||
return dict(r) if r else None
|
||||
return self._run(run)
|
||||
|
||||
def enabled(self) -> bool:
|
||||
try:
|
||||
with self._conn() as conn:
|
||||
return bool(conn.execute("SELECT to_regclass('public.urgent_notices') AS r").fetchone()["r"])
|
||||
except Exception: # noqa: BLE001
|
||||
return False
|
||||
|
||||
@@ -0,0 +1,188 @@
|
||||
"""긴급 공지 라우터(/notice) — ERP 전체 화면 가운데 공지.
|
||||
|
||||
- 만들기·고치기·취소·이미지 올리기·확인 현황: 수퍼관리자(app.store.SUPER_ADMIN_EMAIL)만.
|
||||
- 받기(GET /notice/api/pending)·[확인]: 로그인한 등록 사용자 누구나 — 모듈 권한과 무관(ERP 전체 공지).
|
||||
- 저장: project_db 024(urgent_notice*). PROJECT_DB_URL 이 없거나 024 미적용이면 503(화면 스크립트는 조용히 멈춘다).
|
||||
- 핸들러는 동기 DB 라 def(프로젝트 라우터와 같은 이유).
|
||||
"""
|
||||
|
||||
from __future__ import annotations
|
||||
|
||||
from typing import Any
|
||||
|
||||
from fastapi import APIRouter, Body, File, HTTPException, Request, UploadFile
|
||||
from fastapi.responses import HTMLResponse, JSONResponse, Response
|
||||
|
||||
from . import store
|
||||
|
||||
router = APIRouter(prefix="/notice", tags=["notice"])
|
||||
|
||||
_MIGRATION_MSG = "긴급 공지 기능이 아직 준비되지 않았습니다(project_db 마이그레이션 024 필요)."
|
||||
|
||||
|
||||
def _user(request: Request) -> dict[str, Any]:
|
||||
from app.main import get_current_user_record # noqa: WPS433
|
||||
|
||||
user = get_current_user_record(request)
|
||||
if user is None:
|
||||
raise HTTPException(status_code=401, detail="로그인이 필요합니다.")
|
||||
return user
|
||||
|
||||
|
||||
def _is_super(user: dict[str, Any]) -> bool:
|
||||
from app.store import SUPER_ADMIN_EMAIL # noqa: WPS433
|
||||
|
||||
return str(user.get("email") or "").strip().lower() == SUPER_ADMIN_EMAIL
|
||||
|
||||
|
||||
def _super(request: Request) -> dict[str, Any]:
|
||||
user = _user(request)
|
||||
if not _is_super(user):
|
||||
raise HTTPException(status_code=403, detail="긴급 공지는 수퍼관리자만 만들 수 있습니다.")
|
||||
return user
|
||||
|
||||
|
||||
def _store(request: Request) -> Any:
|
||||
st = getattr(request.app.state, "notice_store", None)
|
||||
if st is None:
|
||||
raise HTTPException(status_code=503, detail=_MIGRATION_MSG)
|
||||
return st
|
||||
|
||||
|
||||
def _call(fn: Any, **kw: Any) -> Any:
|
||||
try:
|
||||
return fn(**kw)
|
||||
except store.NoticeMigrationNeeded:
|
||||
raise HTTPException(status_code=503, detail=_MIGRATION_MSG)
|
||||
except ValueError as exc:
|
||||
raise HTTPException(status_code=400, detail=str(exc))
|
||||
except KeyError:
|
||||
raise HTTPException(status_code=404, detail="공지를 찾을 수 없습니다.")
|
||||
|
||||
|
||||
def _public(n: dict[str, Any]) -> dict[str, Any]:
|
||||
"""받는 사람 화면에 보내는 값 — 받는 사람 목록·확인 현황은 빼고."""
|
||||
return {k: n.get(k, "") for k in ("id", "title", "body_html", "show_at", "created_by", "version")}
|
||||
|
||||
|
||||
# ── 화면 ─────────────────────────────────────────────────────
|
||||
@router.get("/", response_class=HTMLResponse)
|
||||
def notice_admin_page(request: Request) -> HTMLResponse:
|
||||
"""긴급 공지 관리 — 수퍼관리자만. 목록(예약·표시 중·취소)·확인 현황·새 공지."""
|
||||
from app.main import build_erp_nav, render_template, user_store # noqa: WPS433
|
||||
from app.store import is_admin # noqa: WPS433
|
||||
|
||||
user = _super(request)
|
||||
st = getattr(request.app.state, "notice_store", None)
|
||||
enabled = bool(st) and st.enabled()
|
||||
# 받는 사람 후보 = 등록 사용자 전원 — 프로젝트 멤버 고르기와 같은 모양(아이콘 + 이름)으로 그린다(project.js memberPickHtml)
|
||||
people = sorted(
|
||||
({"email": u["email"], "id": u["email"].split("@")[0], "name": u.get("name") or u["email"].split("@")[0],
|
||||
"avatar": u.get("picture") or ""} for u in user_store.list_all()),
|
||||
key=lambda p: p["id"],
|
||||
)
|
||||
return render_template(request, "notice/admin.html", {
|
||||
"user": user, "is_admin": is_admin(user),
|
||||
"nav_items": build_erp_nav(user, active=""),
|
||||
"page_title": "긴급 공지", "page_subtitle": "정한 시각에 받는 사람 화면 가운데에 띄웁니다([확인] 전까지)",
|
||||
"enabled": enabled, "people": people,
|
||||
})
|
||||
|
||||
|
||||
# ── 받는 사람 ────────────────────────────────────────────────
|
||||
@router.get("/api/pending")
|
||||
def api_pending(request: Request) -> JSONResponse:
|
||||
"""지금 내가 봐야 할 공지(띄울 시각이 지났고 아직 [확인] 안 한 것, 오래된 것부터)."""
|
||||
user = _user(request)
|
||||
st = _store(request)
|
||||
rows = _call(st.pending_for, email=user["email"])
|
||||
return JSONResponse({"notices": [_public(n) for n in rows]})
|
||||
|
||||
|
||||
@router.post("/api/{notice_id}/ack")
|
||||
def api_ack(request: Request, notice_id: int, payload: dict[str, Any] = Body(default={})) -> JSONResponse:
|
||||
"""[확인] — 받는 사람이고 띄울 시각이 지난, 취소 안 된 공지만(검증과 기록을 저장소가 한 트랜잭션에서, 검토 F08).
|
||||
여러 번 눌러도 한 번 기록. payload.version = 화면에 띄운 내용의 버전 — 그 사이 고쳐졌으면 409(바뀐 내용을 다시 읽게, F07)."""
|
||||
user = _user(request)
|
||||
st = _store(request)
|
||||
version = str((payload or {}).get("version") or "").strip() or None
|
||||
result = _call(st.ack, notice_id=notice_id, email=user["email"], version=version)
|
||||
if result == "denied":
|
||||
raise HTTPException(status_code=404, detail="공지를 찾을 수 없습니다.")
|
||||
if result == "stale":
|
||||
raise HTTPException(status_code=409, detail="공지 내용이 수정되었습니다. 바뀐 내용을 확인한 뒤 다시 [확인]을 눌러 주세요.")
|
||||
return JSONResponse({"ok": True, "result": result})
|
||||
|
||||
|
||||
@router.get("/images/{image_id}")
|
||||
def notice_image(request: Request, image_id: int) -> Response:
|
||||
"""공지 본문 이미지 — 수퍼관리자, 또는 그 공지를 받는 사람(띄울 시각이 지난 공지)만."""
|
||||
from datetime import datetime # noqa: WPS433
|
||||
|
||||
from app.timezone import KST # noqa: WPS433
|
||||
|
||||
user = _user(request)
|
||||
st = _store(request)
|
||||
img = _call(st.get_image, image_id=image_id)
|
||||
if img is None:
|
||||
raise HTTPException(status_code=404, detail="이미지를 찾을 수 없습니다.")
|
||||
if not _is_super(user):
|
||||
n = _call(st.get_notice, notice_id=int(img["notice_id"])) if img["notice_id"] else None
|
||||
if (n is None or n["cancelled_at"] or not st.is_recipient(notice=n, email=user["email"])
|
||||
or datetime.fromisoformat(n["show_at"]) > datetime.now(KST)):
|
||||
raise HTTPException(status_code=404, detail="이미지를 찾을 수 없습니다.")
|
||||
return Response(content=bytes(img["data"]), media_type=img["content_type"], headers={
|
||||
"X-Content-Type-Options": "nosniff", "Cache-Control": "private, max-age=3600",
|
||||
"Content-Security-Policy": "default-src 'none'; img-src 'self'; sandbox",
|
||||
})
|
||||
|
||||
|
||||
# ── 수퍼관리자 ───────────────────────────────────────────────
|
||||
@router.get("/api/notices")
|
||||
def api_list(request: Request) -> JSONResponse:
|
||||
_super(request)
|
||||
st = _store(request)
|
||||
return JSONResponse({"notices": _call(st.list_notices)})
|
||||
|
||||
|
||||
def _fields(payload: dict[str, Any]) -> dict[str, Any]:
|
||||
return {"title": payload.get("title"), "body": payload.get("body_html") or "",
|
||||
"show_at": payload.get("show_at"), "to_all": payload.get("to_all", True),
|
||||
"targets": payload.get("targets") or []}
|
||||
|
||||
|
||||
@router.post("/api/notices")
|
||||
def api_create(request: Request, payload: dict[str, Any] = Body(...)) -> JSONResponse:
|
||||
user = _super(request)
|
||||
st = _store(request)
|
||||
n = _call(st.create_notice, **_fields(payload), by=user["email"])
|
||||
return JSONResponse({"notice": n}, status_code=201)
|
||||
|
||||
|
||||
@router.put("/api/notices/{notice_id}")
|
||||
def api_update(request: Request, notice_id: int, payload: dict[str, Any] = Body(...)) -> JSONResponse:
|
||||
"""고치기 — reshow=true 면 이미 [확인]한 사람에게도 다시 띄운다."""
|
||||
user = _super(request)
|
||||
st = _store(request)
|
||||
n = _call(st.update_notice, notice_id=notice_id, **_fields(payload), by=user["email"],
|
||||
reshow=payload.get("reshow") is True)
|
||||
return JSONResponse({"notice": n})
|
||||
|
||||
|
||||
@router.post("/api/notices/{notice_id}/cancel")
|
||||
def api_cancel(request: Request, notice_id: int, payload: dict[str, Any] = Body(default={})) -> JSONResponse:
|
||||
"""취소(더 띄우지 않음) {cancel: true} · 되돌리기 {cancel: false}."""
|
||||
user = _super(request)
|
||||
st = _store(request)
|
||||
n = _call(st.cancel_notice, notice_id=notice_id, by=user["email"], cancel=payload.get("cancel", True) is not False)
|
||||
return JSONResponse({"notice": n})
|
||||
|
||||
|
||||
@router.post("/api/images")
|
||||
def api_upload_image(request: Request, file: UploadFile = File(...)) -> JSONResponse:
|
||||
"""본문 이미지 올리기 — 저장(공지 만들기·고치기) 때 본문에 든 것만 그 공지에 묶인다."""
|
||||
user = _super(request)
|
||||
st = _store(request)
|
||||
data = file.file.read(store.IMAGE_MAX_BYTES + 1)
|
||||
img = _call(st.add_image, data=data, filename=file.filename or "image", by=user["email"])
|
||||
return JSONResponse({"image": img}, status_code=201)
|
||||
@@ -0,0 +1,106 @@
|
||||
"""긴급 공지 — 순수 검증(DB 없음). 저장은 db.py, 화면·권한은 router.py."""
|
||||
|
||||
from __future__ import annotations
|
||||
|
||||
import re
|
||||
from datetime import datetime
|
||||
from typing import Any
|
||||
|
||||
from app.modules.project import store as pj_store
|
||||
from app.timezone import KST
|
||||
|
||||
TITLE_MAX = 200
|
||||
BODY_MAX = 100_000 # 정리한 HTML 기준(이미지는 주소만 들어간다)
|
||||
IMAGE_MAX_BYTES = 10 * 1024 * 1024
|
||||
TARGETS_MAX = 500
|
||||
|
||||
# 이미지 형식은 올린 쪽이 정한 Content-Type 이 아니라 파일 앞 바이트로 정한다(svg·html 은 받지 않는다).
|
||||
_MAGIC: tuple[tuple[bytes, str], ...] = (
|
||||
(b"\x89PNG\r\n\x1a\n", "image/png"),
|
||||
(b"\xff\xd8\xff", "image/jpeg"),
|
||||
(b"GIF87a", "image/gif"),
|
||||
(b"GIF89a", "image/gif"),
|
||||
)
|
||||
_IMG_SRC_OK = re.compile(r"^/notice/images/(\d+)$")
|
||||
_IMG_TAG = re.compile(r"<img\b[^>]*>", re.IGNORECASE)
|
||||
_SRC_ATTR = re.compile(r"""\bsrc\s*=\s*"([^"]*)\"""", re.IGNORECASE)
|
||||
|
||||
|
||||
class NoticeMigrationNeeded(Exception):
|
||||
"""project_db 024 미적용."""
|
||||
|
||||
|
||||
def validate_title(v: Any) -> str:
|
||||
t = pj_store.norm_str(v)
|
||||
if not t:
|
||||
raise ValueError("공지 제목을 입력하세요.")
|
||||
if len(t) > TITLE_MAX:
|
||||
raise ValueError(f"제목은 {TITLE_MAX}자 이하로 입력하세요.")
|
||||
return t
|
||||
|
||||
|
||||
def sanitize_body(html: Any) -> str:
|
||||
"""작업 설명란과 같은 허용 목록으로 정리한 뒤, 이미지는 공지 이미지 주소(/notice/images/{id})만 남긴다
|
||||
(외부 주소·data: 이미지는 뺀다 — 받는 사람 화면에서 다른 곳으로 요청이 나가지 않게)."""
|
||||
out = pj_store.sanitize_description_html(str(html or ""))
|
||||
|
||||
def keep(m: re.Match[str]) -> str:
|
||||
src = _SRC_ATTR.search(m.group(0))
|
||||
return m.group(0) if src and _IMG_SRC_OK.match(src.group(1)) else ""
|
||||
out = _IMG_TAG.sub(keep, out)
|
||||
if len(out) > BODY_MAX:
|
||||
raise ValueError("내용이 너무 깁니다.")
|
||||
return out
|
||||
|
||||
|
||||
def image_ids_in(html: str) -> list[int]:
|
||||
"""본문에 들어 있는 공지 이미지 id(순서대로, 중복 없이)."""
|
||||
ids: list[int] = []
|
||||
for tag in _IMG_TAG.findall(html or ""):
|
||||
src = _SRC_ATTR.search(tag)
|
||||
m = _IMG_SRC_OK.match(src.group(1)) if src else None
|
||||
if m and int(m.group(1)) not in ids:
|
||||
ids.append(int(m.group(1)))
|
||||
return ids
|
||||
|
||||
|
||||
def parse_show_at(v: Any, *, now: datetime | None = None) -> datetime:
|
||||
"""띄울 시각 — 'YYYY-MM-DDTHH:MM'(화면 입력, 한국시간) 또는 시간대가 붙은 ISO. 비우면 지금."""
|
||||
s = pj_store.norm_str(v)
|
||||
if not s:
|
||||
return now or datetime.now(KST)
|
||||
try:
|
||||
d = datetime.fromisoformat(s.replace("Z", "+00:00"))
|
||||
except ValueError:
|
||||
raise ValueError("띄울 시각이 올바르지 않습니다.")
|
||||
if d.tzinfo is None:
|
||||
d = d.replace(tzinfo=KST)
|
||||
if not 2000 <= d.year <= 2100:
|
||||
raise ValueError("띄울 시각이 올바르지 않습니다.")
|
||||
return d
|
||||
|
||||
|
||||
def validate_targets(to_all: Any, targets: Any) -> tuple[bool, list[str]]:
|
||||
"""(전체 여부, 받는 사람 이메일). 전체가 아니면 한 명 이상."""
|
||||
if to_all is True or to_all in ("1", "true", "on"):
|
||||
return True, []
|
||||
emails = pj_store.normalize_emails(targets if isinstance(targets, (list, tuple)) else [])
|
||||
if not emails:
|
||||
raise ValueError("받는 사람을 한 명 이상 고르거나 '전체'를 고르세요.")
|
||||
if len(emails) > TARGETS_MAX:
|
||||
raise ValueError(f"받는 사람은 {TARGETS_MAX}명까지 고를 수 있습니다.")
|
||||
return False, emails
|
||||
|
||||
|
||||
def sniff_image(data: bytes) -> str:
|
||||
"""파일 앞 바이트로 이미지 형식 — png·jpeg·gif·webp 만. 아니면 ValueError."""
|
||||
if not data:
|
||||
raise ValueError("빈 파일입니다.")
|
||||
if len(data) > IMAGE_MAX_BYTES:
|
||||
raise ValueError("이미지는 10MB 이하만 올릴 수 있습니다.")
|
||||
for magic, ctype in _MAGIC:
|
||||
if data.startswith(magic):
|
||||
return ctype
|
||||
if len(data) >= 12 and data[:4] == b"RIFF" and data[8:12] == b"WEBP":
|
||||
return "image/webp"
|
||||
raise ValueError("이미지(png·jpg·gif·webp)만 올릴 수 있습니다.")
|
||||
@@ -0,0 +1,70 @@
|
||||
{% extends "erp_base.html" %}
|
||||
|
||||
{% block head_extra %}
|
||||
{# 프로젝트 화면 부품(설명 편집기·날짜 팝업·멤버 고르기)을 그대로 쓴다 — project.js 는 PJ_LIB_ONLY 로 부품만 #}
|
||||
<link rel="stylesheet" href="/static/project.css?v=20261013i" />
|
||||
<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 %}
|
||||
|
||||
{% block content %}
|
||||
{% if not enabled %}
|
||||
<div class="ntc-card">
|
||||
<h2>긴급 공지 준비 필요</h2>
|
||||
<p>project_db 마이그레이션 024(<code>scripts/sql/project_db_024_urgent_notices.sql</code>)를 적용하면 사용할 수 있습니다.</p>
|
||||
</div>
|
||||
{% else %}
|
||||
<div class="ntc-wrap" id="ntc-root">
|
||||
<section class="ntc-card" aria-labelledby="ntc-form-title">
|
||||
<h2 id="ntc-form-title">새 긴급 공지</h2>
|
||||
<input type="hidden" id="ntc-id" value="" />
|
||||
<label class="ntc-field">제목
|
||||
<input type="text" id="ntc-title" maxlength="200" placeholder="예: 오늘 18시 서버 점검" autocomplete="off" />
|
||||
</label>
|
||||
{# 내용 — 작업 설명란과 같은 편집기(서식 도구 전체·이미지 붙여넣기/버튼·크기 조절·링크·체크리스트) #}
|
||||
<div class="ntc-field pj-desc-block ntc-desc">
|
||||
<div class="pj-desc-toolbar"><span>내용</span><span class="pj-muted-sm" id="ntc-hint"></span></div>
|
||||
{% with fmtbar_id = "ntc-fmtbar", img_input_id = "ntc-img-input" %}{% include "project/_desc_fmtbar.html" %}{% endwith %}
|
||||
<div class="pj-desc-wrap">
|
||||
<div class="pj-desc-editor" id="ntc-body" contenteditable="true" role="textbox" aria-multiline="true" aria-label="공지 내용"
|
||||
data-placeholder="공지 내용을 쓰세요… (이미지는 붙여넣기 또는 위 버튼으로 추가)"></div>
|
||||
</div>
|
||||
</div>
|
||||
{# 띄울 날짜 — 프로젝트와 같은 날짜 팝업(공휴일·오늘·지우기), 시각은 옆 칸. 둘 다 비우면 바로 #}
|
||||
<div class="ntc-field">띄울 시각 <small class="ntc-sub">한국시간 · 날짜를 비우면 바로</small>
|
||||
<div class="ntc-when">
|
||||
<input type="date" id="ntc-date" />
|
||||
<input type="time" id="ntc-time" class="ntc-time" step="300" aria-label="띄울 시각" />
|
||||
</div>
|
||||
</div>
|
||||
<div class="ntc-field">받는 사람
|
||||
<div class="ntc-targets">
|
||||
<div class="ntc-to">
|
||||
<label><input type="radio" name="ntc-to" value="all" checked /> 전체(로그인하는 모든 사람)</label>
|
||||
<label><input type="radio" name="ntc-to" value="some" /> 고른 사람만</label>
|
||||
</div>
|
||||
{# 프로젝트 멤버 고르기와 같은 모양 — 아이콘 + 이름 + 체크 #}
|
||||
<div class="pj-member-picker ntc-people" id="ntc-people" hidden></div>
|
||||
</div>
|
||||
</div>
|
||||
<label class="ntc-field ntc-inline" id="ntc-reshow-row" hidden>
|
||||
<input type="checkbox" id="ntc-reshow" /> 이미 [확인]한 사람에게도 다시 띄우기
|
||||
</label>
|
||||
<div class="ntc-actions">
|
||||
<button type="button" class="pj-btn" id="ntc-reset">새로 쓰기</button>
|
||||
<button type="button" class="pj-btn" id="ntc-preview">미리 보기</button>
|
||||
<button type="button" class="pj-btn pj-btn-primary" id="ntc-save">공지 만들기</button>
|
||||
</div>
|
||||
<p class="ntc-msg" id="ntc-msg" role="alert" hidden></p>
|
||||
</section>
|
||||
|
||||
<section class="ntc-card" aria-labelledby="ntc-list-title">
|
||||
<h2 id="ntc-list-title">공지 목록</h2>
|
||||
<div class="ntc-list" id="ntc-list">불러오는 중…</div>
|
||||
</section>
|
||||
</div>
|
||||
<script>window.NTC_PEOPLE = {{ people | tojson }};</script>
|
||||
<script src="/static/project.js?v=20261015c" defer></script>
|
||||
<script src="/static/erp-notice-admin.js?v=20261012b" defer></script>
|
||||
{% endif %}
|
||||
{% endblock %}
|
||||
@@ -0,0 +1,25 @@
|
||||
"""실적(쇼핑몰 통합 매출) 모듈.
|
||||
|
||||
네 영역을 분리해 둔다(쇼핑몰 하나를 추가할 때 어댑터 파일 하나만 늘어나게).
|
||||
① 쇼핑몰 API 수집 adapters/ (쇼핑몰별 어댑터) + sync.py (공통 동기화 서비스)
|
||||
② 인증정보·보안 security/ (AES-256-GCM, 비밀값 가리기) + credentials.py
|
||||
③ 매출 계산/저장 calc.py (기간·수수료·집계) + db.py (performance_db)
|
||||
④ 대시보드/UI dashboard.py (화면 데이터 조립) + router.py + templates/performance/
|
||||
|
||||
데이터 저장은 performance_db 전용이다. PERFORMANCE_DB_URL 미설정 시
|
||||
build_performance_store 는 None 을 반환하고 라우터가 "설정 필요" 안내를 보여 준다(앱은 죽지 않음).
|
||||
"""
|
||||
|
||||
from typing import Any
|
||||
|
||||
from .router import router
|
||||
|
||||
__all__ = ["router", "build_performance_store"]
|
||||
|
||||
|
||||
def build_performance_store(*, dsn: str | None) -> Any:
|
||||
if not dsn:
|
||||
return None
|
||||
from .db import PerformanceDBStore # 지연 import (개발 환경 deps 없을 수 있음)
|
||||
|
||||
return PerformanceDBStore(dsn)
|
||||
@@ -0,0 +1,5 @@
|
||||
"""광고 API 연동(구글 광고 등) — 광고 채널 하나 = 파일 하나 + registry.py 한 줄.
|
||||
|
||||
쇼핑몰 어댑터(adapters/)와 같은 모양(입력칸·연결 테스트·인증정보 접근자)을 따르되, 돌려주는 것은 매출 사건이 아니라
|
||||
"날짜별 광고비·ROAS·보고서 항목"(AdDay)이다. 저장은 ad_sync.py 가 perf_ad_spend(source='api')에.
|
||||
"""
|
||||
@@ -0,0 +1,70 @@
|
||||
"""광고 API 연동 — 공통 인터페이스.
|
||||
|
||||
광고 채널 코드(code)는 광고비 표 채널 코드(ad_spend.CHANNELS)와 같다 — 가져온 값은 그 채널 열로 들어간다.
|
||||
인증정보는 쇼핑몰 인증정보와 같은 방식(설정 화면 입력 → 마스터 키로 암호화 → perf_ad_credentials)이고,
|
||||
꺼낼 때는 ctx.credentials.get(key) 로만(서버 안에서만 복호화). 오류는 adapters.base 의 AdapterError 계열 —
|
||||
status 가 곧 연결 상태 코드(설정 화면 표시)다. 오류 문구에 비밀값을 넣지 않는다.
|
||||
"""
|
||||
|
||||
from __future__ import annotations
|
||||
|
||||
from dataclasses import dataclass, field
|
||||
from datetime import date
|
||||
from decimal import Decimal
|
||||
from typing import Any
|
||||
|
||||
from ..adapters.base import AdapterContext, CredentialField, NotConfigured
|
||||
|
||||
|
||||
@dataclass
|
||||
class AdDay:
|
||||
"""광고 API 가 돌려준 하루치 — 금액은 원 단위 정수, ROAS 는 %(없으면 None), 나머지 항목은 화면 이름 그대로."""
|
||||
|
||||
day: date
|
||||
amount: int
|
||||
roas: Decimal | None = None
|
||||
metrics: dict[str, Any] = field(default_factory=dict)
|
||||
|
||||
|
||||
class AdSource:
|
||||
code: str = "" # 광고비 채널 코드(google 등)
|
||||
name: str = "" # 설정 화면 이름
|
||||
docs_url: str = ""
|
||||
note: str = "" # 설정 창 맨 위 안내
|
||||
|
||||
# 인증정보 서비스(credentials.CredentialService)가 쇼핑몰 어댑터와 같은 방식으로 다루게 맞춘 속성
|
||||
@property
|
||||
def uses_shared_integration(self) -> bool:
|
||||
return False
|
||||
|
||||
def credential_fields(self) -> list[CredentialField]:
|
||||
return []
|
||||
|
||||
def visible_fields(self) -> list[CredentialField]:
|
||||
return [f for f in self.credential_fields() if not f.internal]
|
||||
|
||||
def validate_credentials(self, values: dict[str, str]) -> list[str]:
|
||||
"""저장 전 검사. values 의 "__stored__" = 저장된 값이 있음(원문은 꺼내지 않음). 값 자체를 오류 문구에 넣지 않는다."""
|
||||
errors: list[str] = []
|
||||
for f in self.visible_fields():
|
||||
v = (values.get(f.key) or "").strip()
|
||||
if f.required and not v:
|
||||
errors.append(f"{f.label} 을(를) 입력하세요.")
|
||||
elif v and len(v) > 20000:
|
||||
errors.append(f"{f.label} 값이 너무 깁니다.")
|
||||
return errors
|
||||
|
||||
def is_configured(self, ctx: AdapterContext) -> bool:
|
||||
return all(ctx.credentials.has(f.key) for f in self.visible_fields() if f.required)
|
||||
|
||||
def require_configured(self, ctx: AdapterContext) -> None:
|
||||
if not self.is_configured(ctx):
|
||||
raise NotConfigured("필수 인증정보가 입력되지 않았습니다. 실적 설정 → 광고 API 연동에서 입력하세요.")
|
||||
|
||||
def test_connection(self, ctx: AdapterContext) -> str:
|
||||
"""성공하면 사람이 읽을 짧은 문구. 실패는 AdapterError."""
|
||||
raise NotImplementedError
|
||||
|
||||
def fetch_days(self, ctx: AdapterContext, start: date, end: date) -> list[AdDay]:
|
||||
"""기간(양 끝 포함)의 날짜별 광고비. 광고가 없던 날은 빠질 수 있다(저장 쪽이 그날의 예전 API 값을 지운다)."""
|
||||
raise NotImplementedError
|
||||
@@ -0,0 +1,302 @@
|
||||
"""구글 광고(Google Ads API) — 날짜별 광고비·ROAS·보고서 항목.
|
||||
|
||||
인증(2026-10-15 사용자: 서비스 계정 Explorer 승인)
|
||||
- 서비스 계정 JSON 키로 OAuth 액세스 토큰(scope adwords)을 받는다 — JWT 를 google-auth 로 서명하고 토큰 교환은 httpx.
|
||||
서비스 계정 이메일을 구글 광고 계정(또는 관리자 MCC 계정) → 관리 → 액세스 및 보안 → 사용자에 추가해 두어야 한다
|
||||
(2024-11 부터 도메인 전체 위임 없이 직접 추가 가능).
|
||||
- **개발자 토큰은 2026-09-09 폐지** — API 접근 등급(Explorer 등)은 서비스 계정을 가진 Google Cloud 프로젝트에 붙는다
|
||||
(Cloud Console → Google Ads API Overview 에서 신청). developer-token 머리글은 지금은 무시되고 다음 큰 버전부터 거부되므로
|
||||
보내지 않는다(입력칸도 없음, 예전에 저장한 값은 쓰지 않음).
|
||||
- 요청 머리글: Authorization(Bearer) · login-customer-id(MCC 를 거쳐 들어갈 때만).
|
||||
- Explorer 등급은 운영 계정 조회(보고서)가 되고 하루 작업 수 한도가 있다 — 우리는 가져오기 한 번에 요청 1~2개.
|
||||
|
||||
조회(REST googleAds:searchStream, GAQL)
|
||||
SELECT customer.currency_code, segments.date, metrics.cost_micros, metrics.impressions, metrics.clicks,
|
||||
metrics.conversions, metrics.conversions_value FROM customer WHERE segments.date BETWEEN 'from' AND 'to'
|
||||
- 날짜는 광고 계정 시간대 기준(한국 계정이면 KST). 광고가 없던 날은 행이 없을 수 있다.
|
||||
- 금액(광고비) = **부가세 포함**(2026-10-15 사용자 요청) = cost_micros ÷ 1,000,000 × 1.1 을 원 단위로 반올림
|
||||
(구글 광고 비용은 부가세 별도 — 쿠팡 광고비처럼 부가세 포함으로 맞춘다). 계정 통화가 KRW 가 아니면 저장하지 않는다.
|
||||
- ROAS(%) = 전환 가치 ÷ 비용(부가세 별도) × 100 — 구글 광고 화면 "전환 가치/비용"과 같은 값 그대로, 비용이 0 이면 없음.
|
||||
- 나머지 항목(노출수·클릭수·클릭률·전환수·전환 가치)은 광고비 탭 구글 머리글 → 일자별 표.
|
||||
API 버전은 설정 칸(기본 DEFAULT_VERSION) — 구글은 버전을 약 1년 뒤 종료하므로 종료 안내가 오면 설정에서 올린다.
|
||||
"""
|
||||
|
||||
from __future__ import annotations
|
||||
|
||||
import json
|
||||
import re
|
||||
import threading
|
||||
import time
|
||||
from datetime import date
|
||||
from decimal import ROUND_HALF_UP, Decimal
|
||||
from typing import Any
|
||||
|
||||
import httpx
|
||||
|
||||
from ..adapters.base import AdapterContext, ApiError, AuthFailed, CredentialField, NotConfigured
|
||||
from .base import AdDay, AdSource
|
||||
|
||||
SCOPE = "https://www.googleapis.com/auth/adwords"
|
||||
API_BASE = "https://googleads.googleapis.com"
|
||||
DEFAULT_VERSION = "v26" # 2026-10 기준 최신(구글 광고 API 는 매월 부 버전·분기마다 새 버전)
|
||||
TOKEN_URI = "https://oauth2.googleapis.com/token"
|
||||
MAX_DAYS = 366
|
||||
VAT = Decimal("1.1") # 광고비 = 구글 비용 + 부가세 10%
|
||||
|
||||
# 일자별 표(광고비 탭 구글 머리글) 항목 — 순서 = 열 순서. 클릭률·ROAS 합계는 ad_spend.detail_table 이 이름으로 다시 계산.
|
||||
M_SPEND, M_COST = "광고비(부가세 포함)", "비용(부가세 별도)"
|
||||
M_IMPR, M_CLICKS, M_CTR, M_CONV, M_VALUE, M_ROAS = "노출수", "클릭수", "클릭률(%)", "전환수", "전환 가치", "ROAS(%)"
|
||||
|
||||
# 구글 오류 코드 → 고칠 곳 안내(오류 문구 뒤에 붙임)
|
||||
_HINTS = {
|
||||
"CLOUD_PROJECT_NOT_APPROVED_FOR_PRODUCTION": "서비스 계정이 속한 Google Cloud 프로젝트에 운영 계정 접근 승인이 없습니다. "
|
||||
"Cloud Console → Google Ads API Overview 에서 그 프로젝트의 Explorer 이상 승인을 확인하세요.",
|
||||
"AUTHORIZATION_ERROR": "API 접근 승인 문제입니다. 서비스 계정이 속한 Cloud 프로젝트의 Google Ads API 승인 상태를 확인하세요.",
|
||||
"INVALID_LOGIN_CUSTOMER_ID": "[로그인 고객 ID(MCC)] 칸 문제입니다. 서비스 계정을 광고 계정에 직접 추가했다면 이 칸을 비우세요"
|
||||
"(칸을 지우고 [연결 테스트] → [저장]). MCC 에 추가했다면 서비스 계정을 추가한 그 MCC 번호여야 하고, "
|
||||
"고객 ID 의 광고 계정이 그 MCC 아래에 있어야 합니다.",
|
||||
"USER_PERMISSION_DENIED": "서비스 계정이 이 광고 계정에 권한이 없습니다. 구글 광고 → 관리 → 액세스 및 보안에 서비스 계정 이메일을 "
|
||||
"사용자로 추가했는지, 관리자(MCC) 계정에 추가했다면 [로그인 고객 ID]에 MCC 번호를 넣었는지 확인하세요.",
|
||||
"CUSTOMER_NOT_ENABLED": "광고 계정이 사용 중지(취소·미완료) 상태입니다.",
|
||||
"NOT_ADS_USER": "서비스 계정이 구글 광고 사용자로 등록돼 있지 않습니다(액세스 및 보안에서 추가).",
|
||||
"INVALID_CUSTOMER_ID": "고객 ID 가 올바르지 않습니다(광고 계정 오른쪽 위 123-456-7890 형태 번호).",
|
||||
"CUSTOMER_NOT_FOUND": "고객 ID 의 광고 계정을 찾을 수 없습니다.",
|
||||
"SERVICE_ACCOUNT_NOT_ALLOWED": "이 계정은 서비스 계정 접근을 허용하지 않습니다.",
|
||||
}
|
||||
|
||||
_token_lock = threading.Lock()
|
||||
_token_cache: dict[str, tuple[str, float]] = {} # (서비스 계정 이메일, 키 ID) → (액세스 토큰, 만료 시각)
|
||||
|
||||
|
||||
def _digits(value: str) -> str:
|
||||
return re.sub(r"[\s\-]", "", value or "")
|
||||
|
||||
|
||||
def _http(ctx: AdapterContext) -> httpx.Client:
|
||||
"""HTTP 클라이언트 — 테스트가 바꿔 끼운다."""
|
||||
return httpx.Client(timeout=ctx.timeout_sec)
|
||||
|
||||
|
||||
def parse_service_account(raw: str) -> dict[str, Any]:
|
||||
"""서비스 계정 JSON 키 → dict. 형식이 틀리면 ValueError(문구에 키 내용을 넣지 않는다)."""
|
||||
try:
|
||||
info = json.loads(raw)
|
||||
except (TypeError, ValueError):
|
||||
raise ValueError("서비스 계정 키가 JSON 형식이 아닙니다(구글 클라우드에서 내려받은 .json 파일 내용을 통째로 붙여 넣으세요).") from None
|
||||
if not isinstance(info, dict) or info.get("type") != "service_account":
|
||||
raise ValueError("서비스 계정 키가 아닙니다(\"type\": \"service_account\" 인 JSON 이어야 합니다).")
|
||||
for k in ("client_email", "private_key"):
|
||||
if not str(info.get(k) or "").strip():
|
||||
raise ValueError(f"서비스 계정 키에 {k} 가 없습니다.")
|
||||
return info
|
||||
|
||||
|
||||
def _won(micros: int, rate: Decimal = Decimal(1)) -> int:
|
||||
"""마이크로 단위 금액 × rate → 원(반올림). rate=VAT 면 부가세 포함."""
|
||||
return int((Decimal(int(micros)) * rate / Decimal(1_000_000)).quantize(Decimal(1), rounding=ROUND_HALF_UP))
|
||||
|
||||
|
||||
def _num(v: Any) -> Decimal:
|
||||
"""REST 응답 숫자(int64 는 문자열, double 은 숫자, 0 은 아예 빠짐) → Decimal."""
|
||||
if v is None or v == "":
|
||||
return Decimal(0)
|
||||
return Decimal(str(v))
|
||||
|
||||
|
||||
def _google_error(resp: httpx.Response) -> tuple[str, str]:
|
||||
"""구글 오류 응답 → (오류 코드 이름, 사람이 읽을 문구). searchStream 오류는 배열에 싸여 올 수 있다."""
|
||||
try:
|
||||
body = resp.json()
|
||||
except ValueError:
|
||||
return "", f"HTTP {resp.status_code}"
|
||||
if isinstance(body, list):
|
||||
body = next((b for b in body if isinstance(b, dict) and b.get("error")), body[0] if body else {})
|
||||
err = (body or {}).get("error") or {}
|
||||
if isinstance(err, str): # 토큰 교환 오류 {"error": "invalid_grant", "error_description": "..."}
|
||||
return err, str((body or {}).get("error_description") or err)
|
||||
code_name, message = "", str(err.get("message") or f"HTTP {resp.status_code}")
|
||||
for d in err.get("details") or []:
|
||||
for e in (d or {}).get("errors") or []:
|
||||
ec = e.get("errorCode") or {}
|
||||
if ec:
|
||||
code_name = str(next(iter(ec.values())))
|
||||
if e.get("message"):
|
||||
message = str(e["message"])
|
||||
break
|
||||
if code_name:
|
||||
break
|
||||
return code_name, message
|
||||
|
||||
|
||||
class GoogleAdsSource(AdSource):
|
||||
code = "google"
|
||||
name = "구글 광고"
|
||||
docs_url = "https://developers.google.com/google-ads/api/docs/oauth/service-accounts"
|
||||
note = ("구글 광고 API 로 날짜별 광고비(비용)·ROAS(전환 가치 ÷ 비용)·노출수·클릭수·전환을 가져옵니다. "
|
||||
"준비: ① Google Cloud 서비스 계정 JSON 키(그 Cloud 프로젝트가 Google Ads API Explorer 이상 승인) "
|
||||
"② 구글 광고 → 관리 → 액세스 및 보안 → 사용자에 서비스 계정 이메일 추가(읽기 권한이면 충분). "
|
||||
"개발자 토큰은 2026-09-09 폐지돼 필요 없습니다.")
|
||||
|
||||
def credential_fields(self) -> list[CredentialField]:
|
||||
return [
|
||||
CredentialField("customer_id", "고객 ID(광고 계정)", placeholder="123-456-7890",
|
||||
help="광고비를 가져올 광고 계정 번호(구글 광고 화면 오른쪽 위). 하이픈은 있어도 됩니다."),
|
||||
CredentialField("login_customer_id", "로그인 고객 ID(MCC)", required=False, placeholder="비워 두면 광고 계정에 직접 접근",
|
||||
help="서비스 계정을 관리자(MCC) 계정에 추가해 그 아래 광고 계정을 볼 때만 MCC 번호를 넣습니다."),
|
||||
CredentialField("service_account_json", "서비스 계정 키(JSON)", secret=True, multiline=True,
|
||||
help="Google Cloud → IAM → 서비스 계정 → 키 → JSON 으로 받은 파일 내용을 통째로 붙여 넣습니다. "
|
||||
"저장 후에는 화면에 다시 보이지 않습니다."),
|
||||
CredentialField("api_version", "API 버전", required=False, placeholder=DEFAULT_VERSION,
|
||||
help=f"비워 두면 {DEFAULT_VERSION}. 구글이 버전 종료를 알리면 새 버전(예: v27)으로 바꿉니다."),
|
||||
]
|
||||
|
||||
def validate_credentials(self, values: dict[str, str]) -> list[str]:
|
||||
errors = super().validate_credentials(values)
|
||||
for key, label in (("customer_id", "고객 ID"), ("login_customer_id", "로그인 고객 ID")):
|
||||
v = (values.get(key) or "").strip()
|
||||
if v and v != "__stored__" and not re.fullmatch(r"\d{10}", _digits(v)):
|
||||
errors.append(f"{label}는 숫자 10자리여야 합니다(예: 123-456-7890).")
|
||||
sa = (values.get("service_account_json") or "").strip()
|
||||
if sa and sa != "__stored__":
|
||||
try:
|
||||
parse_service_account(sa)
|
||||
except ValueError as exc:
|
||||
errors.append(str(exc))
|
||||
ver = (values.get("api_version") or "").strip()
|
||||
if ver and ver != "__stored__" and not re.fullmatch(r"v\d{2,3}", ver):
|
||||
errors.append("API 버전은 v26 처럼 v 뒤에 숫자로 입력하세요.")
|
||||
return errors
|
||||
|
||||
# ── 인증 ──────────────────────────────────────────────
|
||||
def _access_token(self, ctx: AdapterContext, client: httpx.Client) -> str:
|
||||
try:
|
||||
info = parse_service_account(ctx.credentials.get("service_account_json"))
|
||||
except ValueError as exc:
|
||||
raise NotConfigured(str(exc)) from None
|
||||
cache_key = f"{info['client_email']}|{info.get('private_key_id', '')}"
|
||||
with _token_lock:
|
||||
hit = _token_cache.get(cache_key)
|
||||
if hit and hit[1] > time.time() + 120:
|
||||
return hit[0]
|
||||
from google.auth import crypt, jwt # noqa: WPS433 — google-auth(requirements)
|
||||
|
||||
try:
|
||||
signer = crypt.RSASigner.from_service_account_info(info)
|
||||
except Exception: # noqa: BLE001 — 키 내용은 문구에 넣지 않는다
|
||||
raise AuthFailed("서비스 계정 키의 private_key 를 읽을 수 없습니다(JSON 파일 내용을 그대로 붙여 넣었는지 확인).") from None
|
||||
now = int(time.time())
|
||||
token_uri = str(info.get("token_uri") or TOKEN_URI)
|
||||
assertion = jwt.encode(signer, {"iss": info["client_email"], "scope": SCOPE, "aud": token_uri,
|
||||
"iat": now, "exp": now + 3600})
|
||||
try:
|
||||
resp = client.post(token_uri, data={"grant_type": "urn:ietf:params:oauth:grant-type:jwt-bearer",
|
||||
"assertion": assertion.decode() if isinstance(assertion, bytes) else assertion})
|
||||
except httpx.HTTPError as exc:
|
||||
raise ApiError(f"구글 인증 서버에 연결하지 못했습니다({type(exc).__name__}).") from None
|
||||
if resp.status_code != 200:
|
||||
name, msg = _google_error(resp)
|
||||
raise AuthFailed(f"서비스 계정 인증 실패({name or resp.status_code}): {msg[:200]} — 키가 삭제·사용 중지되지 않았는지 확인하세요.")
|
||||
body = resp.json()
|
||||
token = str(body.get("access_token") or "")
|
||||
if not token:
|
||||
raise AuthFailed("구글 인증 서버가 액세스 토큰을 주지 않았습니다.")
|
||||
with _token_lock:
|
||||
_token_cache[cache_key] = (token, time.time() + int(body.get("expires_in") or 3600))
|
||||
return token
|
||||
|
||||
def _search(self, ctx: AdapterContext, query: str) -> list[dict[str, Any]]:
|
||||
"""GAQL 한 번 — searchStream 응답(묶음 배열)의 results 를 이어 붙여 돌려준다."""
|
||||
self.require_configured(ctx)
|
||||
cid = _digits(ctx.credentials.get("customer_id"))
|
||||
if not re.fullmatch(r"\d{10}", cid):
|
||||
raise NotConfigured("고객 ID 는 숫자 10자리여야 합니다.")
|
||||
version = (ctx.credentials.get("api_version") or "").strip() or DEFAULT_VERSION
|
||||
with _http(ctx) as client:
|
||||
token = self._access_token(ctx, client)
|
||||
headers = {"Authorization": f"Bearer {token}", "Content-Type": "application/json"} # 개발자 토큰 없음(2026-09-09 폐지)
|
||||
login = _digits(ctx.credentials.get("login_customer_id"))
|
||||
if login:
|
||||
headers["login-customer-id"] = login
|
||||
ctx.progress.check()
|
||||
try:
|
||||
resp = client.post(f"{API_BASE}/{version}/customers/{cid}/googleAds:searchStream",
|
||||
headers=headers, json={"query": query})
|
||||
except httpx.HTTPError as exc:
|
||||
raise ApiError(f"구글 광고 API 에 연결하지 못했습니다({type(exc).__name__}).") from None
|
||||
if resp.status_code == 404:
|
||||
raise ApiError(f"구글 광고 API 버전 {version} 을(를) 쓸 수 없습니다(종료됐을 수 있음) — 실적 설정에서 API 버전을 최신으로 바꾸세요.")
|
||||
if resp.status_code != 200:
|
||||
name, msg = _google_error(resp)
|
||||
hint = _HINTS.get(name, "")
|
||||
text = f"구글 광고 API 오류({name or resp.status_code}): {msg[:200]}" + (f" — {hint}" if hint else "")
|
||||
raise (AuthFailed if resp.status_code in (401, 403) else ApiError)(text)
|
||||
try:
|
||||
batches = resp.json()
|
||||
except ValueError:
|
||||
raise ApiError("구글 광고 API 응답을 읽을 수 없습니다.") from None
|
||||
if isinstance(batches, dict):
|
||||
batches = [batches]
|
||||
out: list[dict[str, Any]] = []
|
||||
for b in batches or []:
|
||||
out.extend((b or {}).get("results") or [])
|
||||
return out
|
||||
|
||||
# ── 연결 테스트 · 가져오기 ─────────────────────────────
|
||||
def test_connection(self, ctx: AdapterContext) -> str:
|
||||
rows = self._search(ctx, "SELECT customer.id, customer.descriptive_name, customer.currency_code, "
|
||||
"customer.time_zone FROM customer LIMIT 1")
|
||||
c = (rows[0].get("customer") if rows else None) or {}
|
||||
currency = c.get("currencyCode") or "?"
|
||||
msg = f"연결됨 — {c.get('descriptiveName') or '광고 계정'} · 통화 {currency} · 시간대 {c.get('timeZone') or '?'}"
|
||||
if currency != "KRW":
|
||||
msg += " (원화 계정이 아니라 광고비를 가져올 수 없습니다)"
|
||||
return msg
|
||||
|
||||
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}일까지 가져올 수 있습니다.")
|
||||
rows = self._search(
|
||||
ctx,
|
||||
"SELECT customer.currency_code, segments.date, metrics.cost_micros, metrics.impressions, metrics.clicks, "
|
||||
"metrics.conversions, metrics.conversions_value FROM customer "
|
||||
f"WHERE segments.date BETWEEN '{start.isoformat()}' AND '{end.isoformat()}'",
|
||||
)
|
||||
sums: dict[date, dict[str, Decimal]] = {}
|
||||
for r in rows:
|
||||
cur = ((r.get("customer") or {}).get("currencyCode") or "").upper()
|
||||
if cur and cur != "KRW":
|
||||
raise ApiError(f"광고 계정 통화가 {cur} 입니다 — 원화(KRW) 계정만 광고비로 가져옵니다.")
|
||||
raw_day = (r.get("segments") or {}).get("date")
|
||||
try:
|
||||
day = date.fromisoformat(str(raw_day))
|
||||
except ValueError:
|
||||
continue
|
||||
m = r.get("metrics") or {}
|
||||
acc = sums.setdefault(day, {"cost": Decimal(0), "impr": Decimal(0), "clicks": Decimal(0),
|
||||
"conv": Decimal(0), "value": Decimal(0)})
|
||||
acc["cost"] += _num(m.get("costMicros"))
|
||||
acc["impr"] += _num(m.get("impressions"))
|
||||
acc["clicks"] += _num(m.get("clicks"))
|
||||
acc["conv"] += _num(m.get("conversions"))
|
||||
acc["value"] += _num(m.get("conversionsValue"))
|
||||
out: list[AdDay] = []
|
||||
for day in sorted(sums):
|
||||
a = sums[day]
|
||||
amount = _won(int(a["cost"]), VAT) # 광고비 = 부가세 포함
|
||||
cost = a["cost"] / Decimal(1_000_000)
|
||||
roas = (a["value"] / cost * 100).quantize(Decimal("0.01"), rounding=ROUND_HALF_UP) if cost > 0 else None
|
||||
ctr = (a["clicks"] / a["impr"] * 100).quantize(Decimal("0.01"), rounding=ROUND_HALF_UP) if a["impr"] > 0 else None
|
||||
metrics = {
|
||||
M_SPEND: amount,
|
||||
M_COST: _won(int(a["cost"])),
|
||||
M_IMPR: int(a["impr"]),
|
||||
M_CLICKS: int(a["clicks"]),
|
||||
M_CTR: float(ctr) if ctr is not None else None,
|
||||
M_CONV: float(a["conv"].quantize(Decimal("0.01"), rounding=ROUND_HALF_UP)),
|
||||
M_VALUE: int(a["value"].quantize(Decimal(1), rounding=ROUND_HALF_UP)),
|
||||
M_ROAS: float(roas) if roas is not None else None,
|
||||
}
|
||||
out.append(AdDay(day=day, amount=amount, roas=roas, metrics=metrics))
|
||||
return out
|
||||
@@ -0,0 +1,17 @@
|
||||
"""광고 API 연동 목록 — 새 광고 채널은 파일 하나 + 여기 한 줄(채널 코드는 ad_spend.CHANNELS 와 같아야 한다)."""
|
||||
|
||||
from __future__ import annotations
|
||||
|
||||
from .base import AdSource
|
||||
from .google_ads import GoogleAdsSource
|
||||
|
||||
_SOURCES: tuple[AdSource, ...] = (GoogleAdsSource(),)
|
||||
_BY_CODE = {s.code: s for s in _SOURCES}
|
||||
|
||||
|
||||
def all_sources() -> tuple[AdSource, ...]:
|
||||
return _SOURCES
|
||||
|
||||
|
||||
def get_source(code: str) -> AdSource | None:
|
||||
return _BY_CODE.get(code)
|
||||
@@ -0,0 +1,506 @@
|
||||
"""광고비 — 채널(구글·메타·쿠팡(윙)·쿠팡(로켓))별 일 광고비 + 업로드 파일 읽기 + 화면 데이터 조립.
|
||||
|
||||
저장: performance_db `perf_ad_spend`(마이그레이션 005) — 채널 × 날짜 하나에 금액 하나(원 단위 정수).
|
||||
- 화면 날짜 칸을 눌러 직접 입력(source=manual), 업로드 파일로 한 번에 입력(source=upload, 같은 날 덮어씀).
|
||||
- 구글은 광고 API 로 가져온다(source=api, ad_sync.py — 2026-10-15). 메타는 지금은 직접 입력만.
|
||||
|
||||
쿠팡(윙)·쿠팡(로켓) 업로드 양식(2026-10-13·14 사용자 제공 — 둘 다 같은 쿠팡 광고 보고서 CSV/엑셀):
|
||||
1행 머리글, 1열 = 날짜("2026년 10월 01일"), 19열 = 청구금액(+부가가치세) → 그날 광고비.
|
||||
규칙(2026-10-14 사용자 확인): **1열에 날짜가 있는 줄의 19열 값**을 가져온다 — 19열이 빈 줄은 건너뛰고(윙 보고서는
|
||||
캠페인 줄에도 날짜가 있고 19열이 비어 있다), 같은 날짜에 값이 있는 줄이 여럿이면 더한다.
|
||||
1열이 빈 캠페인 줄·맨 위 "전체" 합계 줄은 건너뛴다. 날짜는 있는데 19열 값이 한 줄도 없는 날은 empty_days 로 알려 준다.
|
||||
네이버 업로드 양식(2026-10-14 사용자 제공 — 네이버 광고 보고서 CSV/엑셀, 하루 한 줄):
|
||||
1행 머리글, 3열 = 기간(날짜 "2026.09.30."), 4열 = 총비용 → 그날 광고비, 12열 = 구매완료 광고수익률(%) → 그날 ROAS.
|
||||
나머지 열(노출수·클릭수·클릭률·전환수·구매완료 수·장바구니·총 전환매출액 …)은 머리글 이름 그대로 metrics 에 보관 —
|
||||
화면에서 네이버 머리글을 누르면 일자별 표(마이그레이션 006: perf_ad_spend.roas·metrics).
|
||||
|
||||
HTTP·DB 와 무관한 순수 함수(읽기·조립) — 라우터가 파일 바이트와 저장소를 넘긴다.
|
||||
"""
|
||||
|
||||
from __future__ import annotations
|
||||
|
||||
import csv
|
||||
import io
|
||||
from dataclasses import dataclass, field
|
||||
from datetime import date
|
||||
from decimal import ROUND_HALF_UP, Decimal, InvalidOperation
|
||||
from typing import Any, Callable, Mapping, Sequence
|
||||
|
||||
from . import calc
|
||||
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).
|
||||
CHANNELS: tuple[tuple[str, str], ...] = (
|
||||
("google", "구글"),
|
||||
("meta", "메타"),
|
||||
("naver", "네이버"),
|
||||
("coupang_wing", "쿠팡(윙)"),
|
||||
("coupang_rocket", "쿠팡(로켓)"),
|
||||
("ohouse", "오늘의집"),
|
||||
("gmarket", "G마켓"),
|
||||
("kakao", "카카오"),
|
||||
("gsshop", "GS샵"),
|
||||
("elevenst", "11번가"),
|
||||
("lotteon", "롯데ON"),
|
||||
("toss", "토스"),
|
||||
("atomy", "애터미아자몰"),
|
||||
)
|
||||
CHANNEL_NAMES = dict(CHANNELS)
|
||||
CHANNEL_CODES = tuple(c for c, _ in CHANNELS)
|
||||
# ROAS(매출 ÷ 광고비 × 100) 의 매출 = 이 쇼핑몰 매출 실적 총매출. 쿠팡(윙)은 매출 쪽 코드가 coupang.
|
||||
# 구글·메타·네이버는 ROAS 를 계산하지 않는다 — 광고 보고서의 ROAS 값을 따로 넣는다(perf_ad_spend.roas, 2026-10-14).
|
||||
# 여러 날(주·월·합계)의 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}
|
||||
ROAS_SALES_CODE["coupang_wing"] = "coupang"
|
||||
|
||||
|
||||
def roas(sales: int, spend: int) -> int | None:
|
||||
"""ROAS(%) = 매출 ÷ 광고비 × 100, 정수로 반올림. 광고비가 없으면 None."""
|
||||
if not spend or spend <= 0:
|
||||
return None
|
||||
return int((Decimal(int(sales)) * 100 / Decimal(int(spend))).quantize(Decimal(1), rounding=ROUND_HALF_UP))
|
||||
|
||||
|
||||
def roas_basis(code: str) -> str:
|
||||
"""머리글 말풍선 — ROAS 에 쓰는 매출(구글·메타·네이버는 빈 값 = 계산 안 함, 보고서 값)."""
|
||||
return "" if code not in ROAS_SALES_CODE else CHANNEL_NAMES.get(code, code)
|
||||
|
||||
|
||||
def file_roas(code: str, file_roas_map: Mapping[tuple[date, str], Any], spends: Mapping[tuple[date, str], int],
|
||||
s: date, e: date) -> int | None:
|
||||
"""보고서 ROAS 채널의 기간 ROAS — Σ(ROAS × 광고비) ÷ Σ광고비(ROAS 가 있고 광고비가 있는 날만)."""
|
||||
rev = Decimal(0)
|
||||
spend = 0
|
||||
for (d, c), r in file_roas_map.items():
|
||||
if c != code or not s <= d <= e or r is None:
|
||||
continue
|
||||
amt = int(spends.get((d, c)) or 0)
|
||||
if amt > 0:
|
||||
rev += Decimal(str(r)) * amt
|
||||
spend += amt
|
||||
if spend <= 0:
|
||||
return None
|
||||
return int((rev / spend).quantize(Decimal(1), rounding=ROUND_HALF_UP))
|
||||
|
||||
|
||||
def channel_roas(code: str, sales_of: Callable[[str], int], spend: int,
|
||||
file_of: Callable[[str], int | None] | None = None) -> int | None:
|
||||
"""채널 칸의 ROAS — 쇼핑몰 매출 ÷ 광고비. 구글·메타·네이버는 보고서 ROAS(file_of), 없으면 None."""
|
||||
if code in FILE_ROAS:
|
||||
return file_of(code) if file_of else None
|
||||
mcode = ROAS_SALES_CODE.get(code)
|
||||
return None if mcode is None else roas(sales_of(mcode), spend)
|
||||
|
||||
ROCKET_DATE_COL = 0 # 1열 날짜
|
||||
ROCKET_AMOUNT_COL = 18 # 19열 청구금액(+부가가치세)
|
||||
SKIP_LABELS = frozenset({"전체", "합계", "총계", "날짜"})
|
||||
|
||||
|
||||
NAVER_DATE_COL = 2 # 3열 기간(날짜)
|
||||
NAVER_AMOUNT_COL = 3 # 4열 총비용
|
||||
NAVER_ROAS_COL = 11 # 12열 구매완료 광고수익률(%)
|
||||
NAVER_SKIP_COLS = (0, 1, 2) # 광고 계정 이름·ID·기간은 metrics 에 넣지 않음
|
||||
|
||||
|
||||
class AdMigrationNeeded(Exception):
|
||||
"""광고비 표(마이그레이션 005: perf_ad_spend) 또는 ROAS·상세 칸(006)이 아직 없음."""
|
||||
|
||||
|
||||
@dataclass
|
||||
class ParseResult:
|
||||
entries: list[tuple[date, int]] = field(default_factory=list) # (날짜, 금액)
|
||||
errors: list[str] = field(default_factory=list)
|
||||
skipped: int = 0 # 건너뛴 줄(캠페인 줄·합계 줄)
|
||||
# 보고서 ROAS·상세 항목(네이버) — 날짜 → ROAS(%) · {머리글: 값}. 비어 있으면 금액만 저장.
|
||||
roas: dict[date, Decimal] = field(default_factory=dict)
|
||||
metrics: dict[date, dict[str, Any]] = field(default_factory=dict)
|
||||
columns: list[str] = field(default_factory=list) # 상세 항목 머리글(파일 순서)
|
||||
empty_days: list[date] = field(default_factory=list) # 날짜 줄은 있는데 금액이 한 줄도 없던 날(저장 안 함)
|
||||
|
||||
|
||||
# ════════════════════════════════════════════════════════════
|
||||
# 파일 읽기
|
||||
# ════════════════════════════════════════════════════════════
|
||||
def _decode_csv(content: bytes) -> str:
|
||||
for enc in ("utf-8-sig", "cp949"):
|
||||
try:
|
||||
return content.decode(enc)
|
||||
except UnicodeDecodeError:
|
||||
continue
|
||||
raise UploadError("CSV 글자 인코딩을 읽을 수 없습니다(UTF-8 또는 CP949 로 저장해 주세요).")
|
||||
|
||||
|
||||
def read_rows(content: bytes, filename: str = "") -> list[tuple[Any, ...]]:
|
||||
"""CSV 또는 엑셀(.xlsx) 첫 시트 → 줄 목록(값 그대로)."""
|
||||
if not content:
|
||||
raise UploadError("빈 파일입니다.")
|
||||
if len(content) > MAX_FILE_BYTES:
|
||||
raise UploadError("파일이 너무 큽니다(5MB 이하).")
|
||||
is_xlsx = content[:2] == b"PK" or filename.lower().endswith(".xlsx")
|
||||
if not is_xlsx:
|
||||
return [tuple(r) for r in csv.reader(io.StringIO(_decode_csv(content)))]
|
||||
try:
|
||||
import openpyxl # noqa: WPS433
|
||||
|
||||
wb = openpyxl.load_workbook(io.BytesIO(content), read_only=True, data_only=True)
|
||||
except Exception: # noqa: BLE001 — 형식이 다르면 어떤 오류든 같은 안내
|
||||
raise UploadError("파일을 읽을 수 없습니다. 쿠팡 광고 보고서 CSV 또는 엑셀(.xlsx) 파일을 올려 주세요.") from None
|
||||
try:
|
||||
return [tuple(r or ()) for r in wb.worksheets[0].iter_rows(values_only=True)]
|
||||
finally:
|
||||
wb.close()
|
||||
|
||||
|
||||
def parse_coupang_rocket(content: bytes, *, today: date, filename: str = "") -> ParseResult:
|
||||
"""쿠팡(윙·로켓) 광고 보고서 → (날짜, 그날 19열 청구금액(+부가가치세) 합). 1열에 날짜가 있고 19열에 값이 있는 줄만,
|
||||
같은 날짜는 더한다. 잘못된 줄이 있으면 errors 에 담는다(저장은 라우터가 막음)."""
|
||||
rows = read_rows(content, filename)
|
||||
res = ParseResult()
|
||||
sums: dict[date, int] = {}
|
||||
dated: set[date] = set()
|
||||
for r, row in enumerate(rows, start=1):
|
||||
raw_day = row[ROCKET_DATE_COL] if len(row) > ROCKET_DATE_COL else None
|
||||
text = str(raw_day or "").strip()
|
||||
if not text or text.replace(" ", "") in SKIP_LABELS:
|
||||
res.skipped += 1
|
||||
continue
|
||||
try:
|
||||
day = parse_date(raw_day)
|
||||
except ValueError:
|
||||
if r == 1: # 머리글
|
||||
res.skipped += 1
|
||||
continue
|
||||
res.errors.append(f"{r}행 1열: 날짜를 읽을 수 없습니다({text[:30]}).")
|
||||
continue
|
||||
if day is None:
|
||||
res.skipped += 1
|
||||
continue
|
||||
raw_amt = row[ROCKET_AMOUNT_COL] if len(row) > ROCKET_AMOUNT_COL else None
|
||||
try:
|
||||
amt = parse_amount(raw_amt)
|
||||
except ValueError:
|
||||
res.errors.append(f"{r}행 19열: 금액이 숫자가 아닙니다({str(raw_amt)[:30]}).")
|
||||
continue
|
||||
dated.add(day)
|
||||
if amt is None:
|
||||
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:
|
||||
raise UploadError(f"한 번에 {MAX_DATA_ROWS:,}일까지 올릴 수 있습니다.")
|
||||
if len(res.errors) > MAX_ERRORS:
|
||||
break
|
||||
res.entries = sorted(sums.items())
|
||||
res.empty_days = sorted(d for d in dated if d not in sums and d <= today)
|
||||
# 날짜 줄은 있는데 청구금액이 한 줄도 없는 파일(그 달 광고비 0 등)은 오류가 아니라 넘어간다(2026-10-14 사용자 요청).
|
||||
# 날짜 줄 자체가 없을 때만 양식 오류.
|
||||
if not dated and not res.errors:
|
||||
raise UploadError("광고비 날짜 줄이 없습니다. 1열 날짜(예: 2026년 10월 01일), 19열 청구금액(+부가가치세) 양식인지 확인하세요.")
|
||||
return res
|
||||
|
||||
|
||||
def _number(value: Any) -> Decimal | None:
|
||||
"""숫자 칸 → Decimal(쉼표·%·원 허용). 빈 칸이면 None, 숫자가 아니면 ValueError."""
|
||||
if value is None or (isinstance(value, str) and not value.strip()):
|
||||
return None
|
||||
if isinstance(value, bool):
|
||||
raise ValueError
|
||||
text = str(value).replace(",", "").replace("%", "").replace("원", "").strip()
|
||||
try:
|
||||
num = Decimal(text)
|
||||
except InvalidOperation:
|
||||
raise ValueError from None
|
||||
if not num.is_finite():
|
||||
raise ValueError
|
||||
return num
|
||||
|
||||
|
||||
def _json_num(num: Decimal | None) -> Any:
|
||||
if num is None:
|
||||
return None
|
||||
return int(num) if num == num.to_integral_value() else float(round(num, 2))
|
||||
|
||||
|
||||
def parse_naver(content: bytes, *, today: date, filename: str = "") -> ParseResult:
|
||||
"""네이버 광고 보고서 → (날짜, 총비용) + 그날 ROAS(12열) + 나머지 항목. 잘못된 줄이 있으면 errors."""
|
||||
rows = read_rows(content, filename)
|
||||
res = ParseResult()
|
||||
header: tuple[Any, ...] = ()
|
||||
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
|
||||
text = str(raw_day or "").strip()
|
||||
if not text or text.replace(" ", "") in SKIP_LABELS:
|
||||
res.skipped += 1
|
||||
continue
|
||||
try:
|
||||
day = parse_date(raw_day)
|
||||
except ValueError:
|
||||
if not header: # 머리글(1행 "기간")
|
||||
header = tuple(str(h or "").strip() for h in row)
|
||||
res.columns = [h for i, h in enumerate(header) if i not in NAVER_SKIP_COLS and h]
|
||||
res.skipped += 1
|
||||
continue
|
||||
res.errors.append(f"{r}행 3열: 날짜를 읽을 수 없습니다({text[:30]}).")
|
||||
continue
|
||||
if day is None:
|
||||
res.skipped += 1
|
||||
continue
|
||||
try:
|
||||
amt = parse_amount(row[NAVER_AMOUNT_COL] if len(row) > NAVER_AMOUNT_COL else None)
|
||||
except ValueError:
|
||||
res.errors.append(f"{r}행 4열: 총비용이 숫자가 아닙니다.")
|
||||
continue
|
||||
try:
|
||||
ro = _number(row[NAVER_ROAS_COL] if len(row) > NAVER_ROAS_COL else None)
|
||||
except ValueError:
|
||||
res.errors.append(f"{r}행 12열: 광고수익률(ROAS)이 숫자가 아닙니다.")
|
||||
continue
|
||||
if amt is None:
|
||||
res.errors.append(f"{r}행 4열: {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}열"
|
||||
if i in NAVER_SKIP_COLS or not name:
|
||||
continue
|
||||
try:
|
||||
m[name] = _json_num(_number(v))
|
||||
except ValueError:
|
||||
m[name] = str(v)[:100]
|
||||
res.metrics[day] = m
|
||||
if len(res.entries) > MAX_DATA_ROWS:
|
||||
raise UploadError(f"한 번에 {MAX_DATA_ROWS:,}일까지 올릴 수 있습니다.")
|
||||
if len(res.errors) > MAX_ERRORS:
|
||||
break
|
||||
if not res.entries and not res.errors:
|
||||
raise UploadError("광고비 날짜 줄이 없습니다. 3열 기간(예: 2026.09.30.), 4열 총비용, 12열 광고수익률 양식인지 확인하세요.")
|
||||
return res
|
||||
|
||||
|
||||
# 업로드 양식이 정해진 채널 → 파일 읽기 함수(채널 순서 = 업로드 창 선택 순서). 쿠팡(윙)도 로켓과 같은 양식(2026-10-14).
|
||||
PARSERS: dict[str, Callable[..., ParseResult]] = {
|
||||
"naver": parse_naver, "coupang_wing": parse_coupang_rocket, "coupang_rocket": parse_coupang_rocket}
|
||||
_COUPANG_HELP = "쿠팡 광고 보고서(CSV 또는 엑셀) — 1열 날짜, 19열 청구금액(+부가가치세)을 그날 광고비로 넣습니다."
|
||||
UPLOAD_HELP = {
|
||||
"naver": "네이버 광고 보고서(CSV 또는 엑셀) — 3열 기간(날짜), 4열 총비용 = 그날 광고비, 12열 구매완료 광고수익률 = ROAS. "
|
||||
"나머지 항목은 네이버 머리글을 누르면 일자별로 볼 수 있습니다.",
|
||||
"coupang_wing": _COUPANG_HELP, "coupang_rocket": _COUPANG_HELP}
|
||||
MAX_UPLOAD_FILES = 30
|
||||
|
||||
|
||||
def merge_results(parsed: list[tuple[str, float, ParseResult]]) -> tuple[ParseResult, list[date]]:
|
||||
"""여러 파일(이름, 파일 수정 시각, 읽은 결과)을 하나로 — 같은 날짜가 여러 파일에 있으면 **파일 날짜(수정 시각)가 최신인
|
||||
파일** 값(같으면 나중에 올린 파일). 돌려주는 값: (합친 결과, 여러 파일에 겹친 날짜). 오류는 파일 이름을 앞에 붙여 모은다."""
|
||||
merged = ParseResult()
|
||||
owner: dict[date, tuple[float, int]] = {}
|
||||
overlap: set[date] = set()
|
||||
empty: set[date] = set()
|
||||
for idx, (name, modified, res) in enumerate(parsed):
|
||||
merged.errors.extend(f"[{name}] {e}" for e in res.errors)
|
||||
empty.update(res.empty_days)
|
||||
merged.skipped += res.skipped
|
||||
for c in res.columns:
|
||||
if c not in merged.columns:
|
||||
merged.columns.append(c)
|
||||
picked: dict[date, tuple[int, int]] = {}
|
||||
for idx, (name, modified, res) in enumerate(parsed):
|
||||
for day, amt in res.entries:
|
||||
key = (float(modified or 0), idx)
|
||||
if day in owner:
|
||||
overlap.add(day)
|
||||
if key < owner[day]:
|
||||
continue
|
||||
owner[day] = key
|
||||
picked[day] = (idx, amt)
|
||||
for day in sorted(picked):
|
||||
idx, amt = picked[day]
|
||||
res = parsed[idx][2]
|
||||
merged.entries.append((day, amt))
|
||||
if day in res.roas:
|
||||
merged.roas[day] = res.roas[day]
|
||||
if day in res.metrics:
|
||||
merged.metrics[day] = res.metrics[day]
|
||||
merged.empty_days = sorted(d for d in empty if d not in picked) # 어느 파일에도 값이 없던 날
|
||||
return merged, sorted(overlap)
|
||||
|
||||
|
||||
# 머리글을 누르면 일자별 상세 표가 열리는 채널(보고서 항목을 보관하는 채널) — 구글은 광고 API 로 가져온 항목(2026-10-15)
|
||||
DETAIL_CHANNELS = frozenset({"naver", "google"})
|
||||
|
||||
|
||||
def detail_table(rows: list[dict[str, Any]]) -> dict[str, Any]:
|
||||
"""일자별 상세(GET /api/ad-spend/{channel}/details) — rows: date·amount·roas·metrics(저장소).
|
||||
열 = 파일 머리글 순서(처음 나온 순), 합계 = 숫자 열 합 + 클릭률·ROAS 는 가중 평균."""
|
||||
cols: list[str] = []
|
||||
for r in rows:
|
||||
for k in (r.get("metrics") or {}):
|
||||
if k not in cols:
|
||||
cols.append(k)
|
||||
sums: dict[str, Decimal] = {}
|
||||
for r in rows:
|
||||
for k, v in (r.get("metrics") or {}).items():
|
||||
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()}
|
||||
for k in cols:
|
||||
if "클릭률" in k and sums.get("노출수"):
|
||||
total[k] = float(round(sums.get("클릭수", Decimal(0)) * 100 / sums["노출수"], 2))
|
||||
elif ("수익률" in k or "ROAS" in k.upper()):
|
||||
spend = sum(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)
|
||||
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
|
||||
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}
|
||||
|
||||
|
||||
# ════════════════════════════════════════════════════════════
|
||||
# 화면 데이터
|
||||
# ════════════════════════════════════════════════════════════
|
||||
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,
|
||||
sales_codes: Sequence[str] = ()) -> dict[str, Any]:
|
||||
"""광고비 화면 — 매출 실적과 같은 기간 이동·표(일자 × 채널, 연간은 월)·그래프·월/연 누적.
|
||||
sales_codes 가 있으면 같은 기간 매출(총매출) 대비 광고비 비율도 보여 준다."""
|
||||
codes = list(CHANNEL_CODES)
|
||||
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
|
||||
month_period = calc.resolve_period("month", ref)
|
||||
year_period = calc.resolve_period("year", ref)
|
||||
m_cmp_start, m_cmp_end, m_cmp_label = month_period.compare_range(today)
|
||||
y_cmp_start, y_cmp_end, y_cmp_label = year_period.compare_range(today)
|
||||
q_start = min(period.start, cmp_start, m_cmp_start, y_cmp_start)
|
||||
q_end = max(period.end, year_period.end)
|
||||
|
||||
migration_needed = False
|
||||
try:
|
||||
amounts, sources = store.ad_amounts(q_start, q_end)
|
||||
except AdMigrationNeeded:
|
||||
amounts, sources, migration_needed = {}, {}, True
|
||||
cells = {k: calc.Money(gross=int(v)) for k, v in amounts.items()}
|
||||
roas_reader = getattr(store, "ad_roas", None)
|
||||
try:
|
||||
roas_map = roas_reader(q_start, q_end) if roas_reader and not migration_needed else {}
|
||||
except AdMigrationNeeded:
|
||||
roas_map = {}
|
||||
|
||||
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)
|
||||
|
||||
# 매출(ROAS 용) — 채널별 매출 쇼핑몰 + 매출 실적에 들어가는 쇼핑몰 전부(합계 열 ROAS·매출 대비 광고비)
|
||||
total_codes = list(sales_codes)
|
||||
need = sorted(set(ROAS_SALES_CODE.values()) | set(total_codes))
|
||||
sales = {(d, c): int(v) for (d, c), v in store.daily_amounts(q_start, q_end, need).items()}
|
||||
|
||||
def sales_sum(mcodes: Sequence[str], s: date, e: date) -> int:
|
||||
want = set(mcodes)
|
||||
return sum(v for (d, c), v in sales.items() if c in want and s <= d <= e)
|
||||
|
||||
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]
|
||||
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},
|
||||
]}
|
||||
|
||||
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)
|
||||
# 칸마다 ROAS — "광고비(ROAS%)" 로 보인다. 행 기간 = 그 날·주·월(합계 행은 선택 기간)
|
||||
for row in table:
|
||||
s = date.fromisoformat(row["from"]) if row.get("from") else period.start
|
||||
e = date.fromisoformat(row["to"]) if row.get("to") else period.end
|
||||
row["roas"] = {c: channel_roas(c, lambda m: sales_sum([m], s, e), row["cells"][c]["gross"],
|
||||
lambda f: file_roas(f, roas_map, amounts, s, e)) for c in codes}
|
||||
row["roas_total"] = roas(sales_sum(total_codes, s, e), row["total"]["gross"]) if total_codes else None
|
||||
m_s, m_e = month_period.start, month_period.end
|
||||
for r in month["rows"]:
|
||||
r["roas"] = channel_roas(r["code"], lambda m: sales_sum([m], m_s, m_e), r["gross"],
|
||||
lambda f: file_roas(f, roas_map, amounts, m_s, m_e))
|
||||
month["total"]["roas"] = roas(sales_sum(total_codes, m_s, m_e), month["total"]["gross"]) if total_codes else None
|
||||
year = calc.year_months(year_period.start.year, codes, cells, today=today)
|
||||
for i, r in enumerate(year["rows"], start=1):
|
||||
s = date(year_period.start.year, i, 1)
|
||||
r["roas"] = None if r.get("future") or not total_codes else roas(sales_sum(total_codes, s, calc.month_end(s)), r["gross"] or 0)
|
||||
year["total"]["roas"] = roas(sales_sum(total_codes, year_period.start, year_period.end), year["total"]["gross"]) if total_codes else None
|
||||
return {
|
||||
"nav": nav,
|
||||
"period": period,
|
||||
"period_kind": period.kind,
|
||||
"today": today.isoformat(),
|
||||
"codes": codes,
|
||||
"names": dict(CHANNEL_NAMES),
|
||||
"kpis": kpis,
|
||||
"table": table,
|
||||
"month": month,
|
||||
"year": year,
|
||||
"roas_basis": {c: roas_basis(c) for c in codes},
|
||||
"detail_channels": sorted(DETAIL_CHANNELS),
|
||||
"chart_daily": calc.daily_series(period, codes, cells),
|
||||
"chart_share": [{"code": c, "name": CHANNEL_NAMES[c], **share[c].as_dict()} for c in codes],
|
||||
# 업로드로 들어온 칸(표시용) — "날짜|채널"
|
||||
"upload_cells": sorted(f"{d.isoformat()}|{c}" for (d, c), s in sources.items()
|
||||
if s == "upload" and period.start <= d <= period.end),
|
||||
# 광고 API(구글 광고 등)로 가져온 칸 — 표시용(초록 숫자)
|
||||
"api_cells": sorted(f"{d.isoformat()}|{c}" for (d, c), s in sources.items()
|
||||
if s == "api" and period.start <= d <= period.end),
|
||||
"upload_channels": [{"code": c, "name": CHANNEL_NAMES[c], "help": UPLOAD_HELP.get(c, "")} for c in PARSERS],
|
||||
"migration_needed": migration_needed,
|
||||
}
|
||||
@@ -0,0 +1,124 @@
|
||||
"""광고 API 가져오기 — 인증정보(perf_ad_credentials) → 광고 연동(ad_sources) → perf_ad_spend(source='api').
|
||||
|
||||
- 광고비 탭 [구글 광고 불러오기](보고 있는 기간) · 매출 자동 업데이트 회차(최근 N일, auto_sync) · 실적 설정 연결 테스트가 쓴다.
|
||||
- 같은 광고 채널은 동시에 한 번만(프로세스 안 잠금) — 두 번째 요청은 바로 "진행 중" 오류.
|
||||
- 저장은 기간 단위 한 트랜잭션(db.replace_ad_api_range): API 가 준 날은 덮어쓰고, 안 준 날은 예전 API 값만 지운다.
|
||||
- 오류 문구는 저장된 비밀값을 가린 뒤 기록·반환한다(security.redact).
|
||||
"""
|
||||
|
||||
from __future__ import annotations
|
||||
|
||||
import logging
|
||||
import threading
|
||||
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 .credentials import CredentialService
|
||||
from .db import AdCredentialTable
|
||||
from .security.redact import redact_text
|
||||
|
||||
logger = logging.getLogger("performance.ad_sync")
|
||||
|
||||
AD_NS = "ad:" # 광고 인증정보 암호문 이름 공간(credentials.aad_for)
|
||||
_locks: dict[str, threading.Lock] = {}
|
||||
_locks_guard = threading.Lock()
|
||||
|
||||
|
||||
def _lock(code: str) -> threading.Lock:
|
||||
with _locks_guard:
|
||||
return _locks.setdefault(code, threading.Lock())
|
||||
|
||||
|
||||
class AdSyncBusy(Exception):
|
||||
"""같은 광고 채널 가져오기가 이미 진행 중."""
|
||||
|
||||
|
||||
def ad_credentials(store: Any, ring_loader: Callable[[], Any]) -> CredentialService:
|
||||
"""광고 API 인증정보 서비스 — 쇼핑몰과 같은 서비스, 저장소만 광고 표."""
|
||||
return CredentialService(AdCredentialTable(store), ring_loader, aad_ns=AD_NS)
|
||||
|
||||
|
||||
class AdSyncService:
|
||||
def __init__(self, store: Any, creds: CredentialService) -> None:
|
||||
self._store = store
|
||||
self._creds = creds
|
||||
|
||||
def configured(self) -> dict[str, bool]:
|
||||
return self._creds.configured_codes(list(all_sources()))
|
||||
|
||||
def _ctx(self, code: str, *, values: dict[str, str] | None = None, user: str = "",
|
||||
cleared: set[str] | None = None) -> AdapterContext:
|
||||
trial = values is not None or bool(cleared)
|
||||
acc = self._creds.accessor(code, overrides=values, persist=not trial, user=user, cleared=cleared)
|
||||
return AdapterContext(code=code, credentials=acc, timeout_sec=30.0)
|
||||
|
||||
@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)
|
||||
|
||||
def test_connection(self, code: str, *, values: dict[str, str] | None = None, user: str = "",
|
||||
cleared: set[str] | None = None) -> dict[str, Any]:
|
||||
"""values 가 있으면 저장하지 않은 새 입력값(빈 칸은 저장값)으로 시험, cleared = 화면에서 비운 항목(빈 값으로) —
|
||||
그때는 상태를 기록하지 않는다."""
|
||||
src = get_source(code)
|
||||
if src is None:
|
||||
return {"ok": False, "status": "api_error", "label": STATUS_LABELS["api_error"], "message": "알 수 없는 광고 연동입니다."}
|
||||
ctx = self._ctx(code, values=values, user=user, cleared=cleared)
|
||||
trial = bool(values) or bool(cleared)
|
||||
try:
|
||||
src.require_configured(ctx)
|
||||
msg = src.test_connection(ctx)
|
||||
ok, status = True, "ok"
|
||||
except AdapterError as exc:
|
||||
ok, status, msg = False, exc.status, self._message(exc, ctx)
|
||||
except Exception as exc: # noqa: BLE001 — 예상 못 한 오류도 화면에는 짧게
|
||||
logger.exception("ad test failed: %s", code)
|
||||
ok, status, msg = False, "api_error", f"연결 테스트 중 오류: {type(exc).__name__}"
|
||||
if not trial:
|
||||
self._store.record_ad_status(code, status=status, ok=ok, error="" if ok else msg, kind="test")
|
||||
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."""
|
||||
src = get_source(code)
|
||||
if src is None:
|
||||
raise KeyError(code)
|
||||
lock = _lock(code)
|
||||
if not lock.acquire(blocking=False):
|
||||
raise AdSyncBusy(f"{src.name} 가져오기가 이미 진행 중입니다. 잠시 뒤 다시 누르세요.")
|
||||
try:
|
||||
ctx = self._ctx(code, user=user)
|
||||
try:
|
||||
src.require_configured(ctx)
|
||||
days = src.fetch_days(ctx, start, end)
|
||||
except AdapterError as exc:
|
||||
msg = self._message(exc, ctx)
|
||||
self._store.record_ad_status(code, status=exc.status, ok=False, error=msg, kind="sync")
|
||||
return {"ok": False, "code": code, "name": src.name, "status": exc.status,
|
||||
"label": STATUS_LABELS.get(exc.status, exc.status), "message": msg}
|
||||
saved = self._store.replace_ad_api_range(
|
||||
code, start, end, [(d.day, d.amount, d.roas, d.metrics) for d in days], user=user or "광고 API")
|
||||
self._store.record_ad_status(code, status="ok", ok=True, kind="sync")
|
||||
return {"ok": True, "code": code, "name": src.name, "days": saved, "total": sum(d.amount for d in days),
|
||||
"from": start.isoformat(), "to": end.isoformat()}
|
||||
finally:
|
||||
lock.release()
|
||||
|
||||
def sync_all(self, start: date, end: date, *, user: str = "") -> list[dict[str, Any]]:
|
||||
"""설정이 끝난 광고 연동 전부(자동 업데이트 회차). 채널별로 실패를 격리한다."""
|
||||
out = []
|
||||
for code, ok in self.configured().items():
|
||||
if not ok:
|
||||
continue
|
||||
try:
|
||||
out.append(self.sync(code, start, end, user=user))
|
||||
except AdSyncBusy as exc:
|
||||
out.append({"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__}"})
|
||||
return out
|
||||
@@ -0,0 +1,5 @@
|
||||
"""① 쇼핑몰 API 수집 — 쇼핑몰별 어댑터(공통 인터페이스는 base.py, 목록은 registry.py)."""
|
||||
|
||||
from .registry import all_adapters, get_adapter
|
||||
|
||||
__all__ = ["all_adapters", "get_adapter"]
|
||||
@@ -0,0 +1,268 @@
|
||||
"""① 쇼핑몰 API 수집 — 공통 인터페이스.
|
||||
|
||||
쇼핑몰 하나 = 어댑터 파일 하나. 새 쇼핑몰은 `MarketplaceAdapter` 를 상속한 파일을
|
||||
만들고 `registry.py` 에 한 줄 추가하면 설정 화면·동기화·대시보드에 자동으로 붙는다.
|
||||
|
||||
흐름: 쇼핑몰 원본 → 어댑터(fetch_* → normalize_*) → 공통 SaleEvent → sync 서비스가 DB 저장
|
||||
|
||||
어댑터가 지켜야 할 것:
|
||||
- 인증정보는 `ctx.credentials.get(key)` 로만 꺼낸다(복호화는 서버 안에서만).
|
||||
- 새 토큰은 `ctx.credentials.set(key, value)` 로 저장한다(자동 암호화).
|
||||
- 오류는 아래 AdapterError 계열로 던진다. 메시지에 비밀값을 넣지 않는다
|
||||
(sync 서비스가 한 번 더 가리지만, 애초에 넣지 않는 것이 원칙).
|
||||
- 금액은 원 단위 정수(int). 결제는 +, 취소/반품은 − 로 만든다.
|
||||
- 날짜 기준을 섞지 않는다: order_date / payment_date / event_date 를 각각 채운다.
|
||||
집계 기준일(sales_date)은 sync 서비스가 정한다(결제=결제일, 취소·반품=발생일).
|
||||
"""
|
||||
|
||||
from __future__ import annotations
|
||||
|
||||
from abc import ABC
|
||||
from dataclasses import dataclass, field
|
||||
from datetime import date
|
||||
from typing import Any, Iterable, Protocol
|
||||
|
||||
# 연결 상태 코드 → 화면 표시. DB CHECK 제약과 같은 목록.
|
||||
STATUS_LABELS: dict[str, str] = {
|
||||
"ok": "정상 연결",
|
||||
"not_configured": "인증정보 미설정",
|
||||
"auth_failed": "인증 실패",
|
||||
"token_expired": "Token 만료",
|
||||
"api_error": "API 오류",
|
||||
"not_implemented": "연동 준비 중",
|
||||
"unknown": "확인 전",
|
||||
"disabled": "사용 중지", # DB 에는 저장하지 않는 화면 전용 상태(쇼핑몰 사용 OFF)
|
||||
"cancelled": "취소됨", # 화면 전용 — 매출 업데이트 창에서 [업데이트 취소](연결 상태는 바꾸지 않음)
|
||||
"manual": "수동 입력", # 화면 전용 — API 없이 수동 입력만 쓰는 쇼핑몰(manual_only)
|
||||
}
|
||||
|
||||
EVENT_TYPES = ("SALE", "CANCEL", "RETURN", "ADJUST")
|
||||
|
||||
|
||||
# ════════════════════════════════════════════════════════════
|
||||
# 오류 — status 가 곧 연결 상태 코드
|
||||
# ════════════════════════════════════════════════════════════
|
||||
class AdapterError(Exception):
|
||||
status = "api_error"
|
||||
|
||||
def __init__(self, message: str = "") -> None:
|
||||
super().__init__(message or STATUS_LABELS.get(self.status, "오류"))
|
||||
self.message = message or STATUS_LABELS.get(self.status, "오류")
|
||||
|
||||
|
||||
class NotConfigured(AdapterError):
|
||||
status = "not_configured"
|
||||
|
||||
|
||||
class AuthFailed(AdapterError):
|
||||
status = "auth_failed"
|
||||
|
||||
|
||||
class TokenExpired(AdapterError):
|
||||
status = "token_expired"
|
||||
|
||||
|
||||
class ApiError(AdapterError):
|
||||
status = "api_error"
|
||||
|
||||
|
||||
class NotImplementedYet(AdapterError):
|
||||
status = "not_implemented"
|
||||
|
||||
|
||||
class Cancelled(AdapterError):
|
||||
"""사용자가 매출 업데이트를 취소함 — 어댑터가 ctx.progress.check() 에서 받는다. 연결 오류가 아니다."""
|
||||
status = "cancelled"
|
||||
|
||||
|
||||
# ════════════════════════════════════════════════════════════
|
||||
# 설정 입력칸 · 공통 매출 사건
|
||||
# ════════════════════════════════════════════════════════════
|
||||
@dataclass(frozen=True)
|
||||
class CredentialField:
|
||||
"""설정 화면 입력칸 하나. secret=True 면 저장 후 값을 화면으로 다시 보내지 않는다.
|
||||
|
||||
internal=True 는 화면에 안 보이는 내부 값(access/refresh token 등) — 어댑터가 직접 저장.
|
||||
multiline=True 면 여러 줄 입력칸(서비스 계정 JSON 키 등).
|
||||
"""
|
||||
|
||||
key: str
|
||||
label: str
|
||||
secret: bool = False
|
||||
required: bool = True
|
||||
help: str = ""
|
||||
placeholder: str = ""
|
||||
internal: bool = False
|
||||
multiline: bool = False
|
||||
|
||||
|
||||
@dataclass
|
||||
class SaleEvent:
|
||||
"""쇼핑몰 원본을 공통 형식으로 바꾼 매출 사건 하나(주문 라인 단위 권장)."""
|
||||
|
||||
event_type: str # SALE / CANCEL / RETURN / ADJUST
|
||||
external_event_id: str # 쇼핑몰 안에서 이 사건을 유일하게 가리키는 값(중복 방지 키)
|
||||
external_order_id: str
|
||||
event_date: date # 사건 발생일(결제=결제일, 취소=취소일, 반품=반품완료일)
|
||||
amount: int # 원 단위 정수. 결제 +, 취소/반품 −
|
||||
external_line_id: str = ""
|
||||
order_date: date | None = None
|
||||
payment_date: date | None = None
|
||||
product_name: str = ""
|
||||
option_name: str = ""
|
||||
quantity: int = 0
|
||||
discount_amount: int = 0
|
||||
order_status: str = ""
|
||||
raw: dict[str, Any] = field(default_factory=dict)
|
||||
# 어느 쇼핑몰 열로 집계할지 — None 이면 이 어댑터의 쇼핑몰. 다른 쇼핑몰 주문을 대신 받아 오는
|
||||
# 연동(예: 카페24 마켓 통합관리가 가져온 스마트스토어 주문)은 해당 쇼핑몰 코드를 넣는다.
|
||||
marketplace_code: str | None = None
|
||||
|
||||
def validate(self) -> None:
|
||||
if self.event_type not in EVENT_TYPES:
|
||||
raise ValueError(f"알 수 없는 사건 종류: {self.event_type}")
|
||||
if not self.external_event_id or not self.external_order_id:
|
||||
raise ValueError("external_event_id / external_order_id 가 필요합니다.")
|
||||
if not isinstance(self.amount, int) or isinstance(self.amount, bool):
|
||||
raise ValueError("amount 는 원 단위 정수여야 합니다.")
|
||||
if self.event_type == "SALE" and self.amount < 0:
|
||||
raise ValueError("결제(SALE) 금액은 음수일 수 없습니다.")
|
||||
if self.event_type in ("CANCEL", "RETURN") and self.amount > 0:
|
||||
raise ValueError("취소/반품 금액은 음수(또는 0)여야 합니다.")
|
||||
|
||||
|
||||
def credential_fingerprint(credentials: Any, keys: Iterable[str]) -> str:
|
||||
"""토큰을 발급한 인증정보 묶음의 지문(SHA-256 16진수) — 원문은 남기지 않는다(2026-10-15 검토 F04).
|
||||
저장된 토큰은 이 지문이 지금 인증정보(연결 테스트의 새 입력값 포함)와 같을 때만 다시 쓴다 —
|
||||
계정·키를 바꾸면 이전 계정 토큰을 쓰지 않고, 같은 값을 다시 저장하면 토큰을 새로 받지 않는다."""
|
||||
import hashlib # noqa: WPS433
|
||||
|
||||
raw = "\x1f".join(f"{k}={(credentials.get(k) or '').strip()}" for k in keys)
|
||||
return hashlib.sha256(raw.encode("utf-8")).hexdigest()
|
||||
|
||||
|
||||
class CredentialAccessor(Protocol):
|
||||
def get(self, key: str) -> str: ...
|
||||
|
||||
def set(self, key: str, value: str) -> None: ...
|
||||
|
||||
def has(self, key: str) -> bool: ...
|
||||
|
||||
|
||||
class Progress:
|
||||
"""수집 진행 알림(매출 업데이트 창의 진행 막대용). 기본은 아무것도 하지 않는다 — sync 가 진행 상황을 모으는
|
||||
객체(jobs.ShopProgress)로 바꿔 넣는다.
|
||||
|
||||
어댑터: 조회를 시작하기 전에 plan(전체 단계 수, 단위) → 단계 하나(하루·조회 구간)를 끝낼 때마다
|
||||
step(items=그 단계에서 받은 건수). 하다가 할 일이 늘면 add(늘어난 단계 수).
|
||||
API 를 부르기 직전마다 check() — 사용자가 [업데이트 취소]를 눌렀으면 Cancelled 를 던져 거기서 멈춘다."""
|
||||
|
||||
def plan(self, total: int, unit: str = "단계") -> None:
|
||||
return None
|
||||
|
||||
def add(self, n: int) -> None:
|
||||
return None
|
||||
|
||||
def step(self, n: int = 1, *, items: int = 0) -> None:
|
||||
return None
|
||||
|
||||
def check(self) -> None:
|
||||
return None
|
||||
|
||||
|
||||
@dataclass
|
||||
class AdapterContext:
|
||||
code: str
|
||||
credentials: CredentialAccessor
|
||||
app_state: Any = None # 공통 연동 계층 재사용(예: 카페24 토큰 저장소)
|
||||
timeout_sec: float = 20.0
|
||||
progress: Progress = field(default_factory=Progress)
|
||||
|
||||
|
||||
# ════════════════════════════════════════════════════════════
|
||||
# 어댑터
|
||||
# ════════════════════════════════════════════════════════════
|
||||
class MarketplaceAdapter(ABC):
|
||||
code: str = ""
|
||||
name: str = ""
|
||||
auth_type: str = "api_key" # api_key / oauth / shared(공통 연동 계층 재사용)
|
||||
docs_url: str = ""
|
||||
implemented: bool = False # 실제 수집(fetch)이 구현됐는가
|
||||
# True 면 API 연동이 없는 수동 입력 전용 쇼핑몰 — 매출 업데이트에서 빠지고, 인증 설정·연결 테스트가 없다.
|
||||
manual_only: bool = False
|
||||
# True 면 동기화 때 그 기간(sales_date)의 이 쇼핑몰 실데이터를 지우고 새로 넣는다(한 트랜잭션).
|
||||
# 쇼핑몰 API 가 "기간 안 결제·환불"을 빠짐없이 돌려줄 때만 켠다 — 규칙이 바뀌거나
|
||||
# 주문이 사라져도 예전 행이 남지 않는다. False 면 같은 사건 ID 만 덮어쓴다(upsert).
|
||||
replace_range: bool = False
|
||||
# replace_range 일 때 이 어댑터가 만든 사건을 가려내는 외부 사건 ID 접두어. 다른 쇼핑몰 열로 보낸
|
||||
# 사건(marketplace_code 지정)도 이 접두어로 찾아 함께 교체한다 — 그 쇼핑몰의 직접 연동분은 건드리지 않음.
|
||||
event_prefix: str = ""
|
||||
note: str = "" # 설정 화면 안내 문구
|
||||
|
||||
# ── 설정 ──────────────────────────────────────────────
|
||||
def credential_fields(self) -> list[CredentialField]:
|
||||
return []
|
||||
|
||||
def visible_fields(self) -> list[CredentialField]:
|
||||
return [f for f in self.credential_fields() if not f.internal]
|
||||
|
||||
@property
|
||||
def uses_shared_integration(self) -> bool:
|
||||
return self.auth_type == "shared"
|
||||
|
||||
def validate_credentials(self, values: dict[str, str]) -> list[str]:
|
||||
"""저장 전 검사. 값 자체를 오류 문구에 넣지 않는다."""
|
||||
errors: list[str] = []
|
||||
for f in self.visible_fields():
|
||||
v = (values.get(f.key) or "").strip()
|
||||
if f.required and not v:
|
||||
errors.append(f"{f.label} 을(를) 입력하세요.")
|
||||
elif v and len(v) > 2000:
|
||||
errors.append(f"{f.label} 값이 너무 깁니다.")
|
||||
return errors
|
||||
|
||||
def is_configured(self, ctx: AdapterContext) -> bool:
|
||||
return all(ctx.credentials.has(f.key) for f in self.visible_fields() if f.required)
|
||||
|
||||
# ── 인증 ──────────────────────────────────────────────
|
||||
def authenticate(self, ctx: AdapterContext) -> None:
|
||||
"""API 호출 전 준비(토큰 발급 등). 기본은 할 일 없음."""
|
||||
if not self.is_configured(ctx):
|
||||
raise NotConfigured("필수 인증정보가 입력되지 않았습니다.")
|
||||
|
||||
def refresh_token(self, ctx: AdapterContext) -> None:
|
||||
"""OAuth 쇼핑몰: refresh token 으로 access token 재발급 후 ctx.credentials.set(...)."""
|
||||
return None
|
||||
|
||||
def test_connection(self, ctx: AdapterContext) -> str:
|
||||
"""성공 시 사람이 읽을 짧은 문구 반환. 실패는 AdapterError."""
|
||||
self.authenticate(ctx)
|
||||
raise NotImplementedYet(f"{self.name} API 연동은 다음 단계에서 구현됩니다.")
|
||||
|
||||
# ── 수집 ──────────────────────────────────────────────
|
||||
def fetch_orders(self, ctx: AdapterContext, start: date, end: date) -> Iterable[dict[str, Any]]:
|
||||
raise NotImplementedYet(f"{self.name} 주문 수집은 다음 단계에서 구현됩니다.")
|
||||
|
||||
def fetch_refunds(self, ctx: AdapterContext, start: date, end: date) -> Iterable[dict[str, Any]]:
|
||||
return []
|
||||
|
||||
def normalize_order(self, raw: dict[str, Any]) -> list[SaleEvent]:
|
||||
raise NotImplementedYet(f"{self.name} 주문 변환은 다음 단계에서 구현됩니다.")
|
||||
|
||||
def normalize_refund(self, raw: dict[str, Any]) -> list[SaleEvent]:
|
||||
return []
|
||||
|
||||
def collect(self, ctx: AdapterContext, start: date, end: date) -> tuple[int, list[SaleEvent]]:
|
||||
"""기간의 주문·취소/반품을 받아 공통 사건으로 변환. (원본 건수, 사건 목록)."""
|
||||
self.authenticate(ctx)
|
||||
fetched = 0
|
||||
events: list[SaleEvent] = []
|
||||
for raw in self.fetch_orders(ctx, start, end):
|
||||
fetched += 1
|
||||
events.extend(self.normalize_order(raw))
|
||||
for raw in self.fetch_refunds(ctx, start, end):
|
||||
fetched += 1
|
||||
events.extend(self.normalize_refund(raw))
|
||||
for ev in events:
|
||||
ev.validate()
|
||||
return fetched, events
|
||||
@@ -0,0 +1,770 @@
|
||||
"""카페24 — 공통 연동 계층(app/integrations/cafe24) 재사용.
|
||||
|
||||
카페24는 이미 OAuth 로 연결해 쓰고 있다(상품관리). 실적 설정에서 인증정보를 따로
|
||||
받지 않고, 같은 토큰 저장소(cafe24_db)와 클라이언트(재시도·429·토큰 자동 갱신)를 쓴다.
|
||||
주문 읽기 권한(mall.read_order)이 필요하다 — config.DEFAULT_SCOPES 에 포함, 권한 추가 후
|
||||
카페24 상품관리 → 시스템에서 한 번 다시 연결해야 한다.
|
||||
|
||||
카페24 관리자 "일별 매출내역"과 같은 기준으로 센다(Admin API 문서 2026-09-01 확인).
|
||||
- 결제합계(SALE, +): GET /admin/orders date_type=pay_date(결제일), 결제된(paid=T) 주문마다
|
||||
실결제금액 + 적립금 + 예치금 + 네이버포인트 = 고객이 실제로 낸 금액
|
||||
(initial_order_amount 의 payment_amount·points_spent_amount·credits_spent_amount + 주문의 naver_point)
|
||||
"상품구매금액 + 배송비 − 할인 − 쿠폰"은 할인 필드에 안 잡히는 차이(수십~수만 원)가 생겨 쓰지 않는다
|
||||
(2026-09-23 실데이터: 카페24 1,874,738 = 1,713,128 + 10,110 + 151,500, 상품식은 1,874,800).
|
||||
네 값이 모두 0인 주문도 0원(카페24와 같음).
|
||||
환불은 따로 빼므로 취소 후 금액(actual_order_amount)이 아니라 결제 당시 금액을 쓴다.
|
||||
- 환불합계(CANCEL/RETURN, −): GET /admin/refunds date_type=refund_date(환불완료일),
|
||||
실제 환불액(actual_refund_amount). 환불코드가 R 로 시작하면 반품, 그 밖은 취소.
|
||||
- 수집 기간을 통째로 다시 받는다(replace_range) — 결제·환불 모두 기간 안 날짜로 조회되므로
|
||||
그 기간의 카페24 실데이터를 지우고 새로 넣는다. 규칙이 바뀌거나 주문이 사라져도 이중 집계 없음.
|
||||
- 자체몰 주문(market_id 가 self/빈값)은 카페24 열. 카페24 마켓 통합관리로 들어온 다른 마켓 주문
|
||||
(스마트스토어·쿠팡 등)은 MARKET_MAP 으로 해당 쇼핑몰 열에 넣는다(환불도 원 주문으로 판단).
|
||||
현재 이 쇼핑몰은 마켓 통합관리를 쓰지 않아 MARKET_MAP 이 비어 있다 — 모두 카페24 열.
|
||||
MARKET_MAP 에 없는 마켓은 카페24 열 — 전체 합계는 항상 카페24 일별 매출내역과 같다.
|
||||
네이버페이 결제(order_place_id=NCHECKOUT)는 자체몰 주문이라 카페24 열.
|
||||
카페24 가 만든 사건은 모두 외부 사건 ID 앞에 "c24:" — 다시 받을 때 이것만 골라 교체하므로
|
||||
해당 쇼핑몰을 나중에 직접 연동해도 그 데이터는 건드리지 않는다(단, 같은 주문을 양쪽에서 받지 않게
|
||||
직접 연동을 켜는 쇼핑몰은 MARKET_MAP 에서 빼야 한다).
|
||||
- 한 호출 검색기간 3개월 미만 → 60일씩 나눠 요청. orders limit ≤ 1000, refunds limit ≤ 500, offset ≤ 15000.
|
||||
- 개인정보(구매자 이름·주소·연락처·계좌)는 저장하지 않는다 — raw 에는 금액·상태 필드만.
|
||||
- 할인 항목 구성·마켓 주문 포함 여부는 `reconcile()`(설정 화면 "카페24 매출 대조")로 카페24 화면과
|
||||
대조해 확정한다.
|
||||
"""
|
||||
|
||||
from __future__ import annotations
|
||||
|
||||
from datetime import date, timedelta
|
||||
from decimal import ROUND_HALF_UP, Decimal, InvalidOperation
|
||||
from typing import Any, Iterable
|
||||
|
||||
from .base import (
|
||||
AdapterContext,
|
||||
ApiError,
|
||||
AuthFailed,
|
||||
MarketplaceAdapter,
|
||||
NotConfigured,
|
||||
SaleEvent,
|
||||
TokenExpired,
|
||||
)
|
||||
|
||||
ORDER_SCOPE = "mall.read_order"
|
||||
ORDER_LIMIT = 1000
|
||||
REFUND_LIMIT = 500
|
||||
LOOKUP_BATCH = 100
|
||||
MAX_OFFSET = 15000
|
||||
CHUNK_DAYS = 60
|
||||
EVENT_PREFIX = "c24:"
|
||||
|
||||
# 매출 대조 전용 — 클레임 완료 주문 조회 날짜 유형과 "완료" 상태(입금전취소 C47~49 는 결제 전이라 제외)
|
||||
CLAIM_DATE_TYPES = (("cancel_complete_date", "취소완료"), ("cancel_date", "주문취소일"),
|
||||
("return_complete_date", "반품완료"), ("exchange_complete_date", "교환완료"))
|
||||
CLAIM_DONE = frozenset({"C40", "C41", "C42", "C43", "R40", "R41", "R42", "R43", "E40"})
|
||||
UNPAID_CANCEL = frozenset({"C47", "C48", "C49"})
|
||||
# 환불 목록(/admin/refunds)에 없는 취소·반품(네이버페이 등) — 카페24 일별 매출 환불합계에는 들어간다(실데이터 확인)
|
||||
NO_RECORD_DATE_TYPES = ("cancel_date", "return_complete_date")
|
||||
NO_RECORD_DONE = frozenset({"C40", "C41", "C42", "C43", "R40", "R41", "R42", "R43"})
|
||||
NO_RECORD_CHANNEL = "ncheckout" # 네이버페이만 — 톡체크아웃·자체몰의 환불 기록 없는 취소는 카페24 환불합계에 없다
|
||||
REFUND_LOOKAROUND_DAYS = 60
|
||||
|
||||
# 카페24 자체몰 주문 채널 — market_id 는 외부 마켓만이 아니라 주문 채널·간편결제도 담는다
|
||||
# (실데이터 확인 2026-09-30: mobile=모바일웹, NCHECKOUT=네이버페이, KAKAOPAY=톡체크아웃).
|
||||
# 이 주문들은 카페24 자체몰 매출이다. 비교는 소문자로.
|
||||
SELF_CHANNELS: dict[str, str] = {
|
||||
# self 는 PC 전용이 아니다 — 주문경로(order_place_name)가 "PC쇼핑몰"·"모바일웹"으로 나뉘어 섞여 있다(실데이터 확인).
|
||||
"": "자체몰", "self": "자체몰", "cafe24": "자체몰", "mobile": "모바일웹", "mobile_d": "모바일앱",
|
||||
"ncheckout": "네이버페이", "kakaopay": "톡체크아웃",
|
||||
}
|
||||
|
||||
# 카페24 마켓 통합관리가 가져온 외부 마켓 주문의 market_id(또는 order_place_id) → 우리 쇼핑몰 열.
|
||||
# 이 쇼핑몰은 카페24 마켓 통합관리를 쓰지 않는다(2026-09 사용자 확인) — 비워 두어 카페24로 들어온 주문은 모두
|
||||
# 카페24 열. 나중에 쓰게 되면 대조 화면 "주문 채널별" 표의 market_id 로 확인해 예: {"shopn": "naver"} 처럼 넣는다
|
||||
# (그 쇼핑몰을 직접 연동한다면 넣지 않는다 — 같은 주문을 두 번 받게 됨). 결제수단과 헷갈리는 이름(naver, kakao) 금지.
|
||||
MARKET_MAP: dict[str, str] = {}
|
||||
|
||||
|
||||
def _key(value: Any) -> str:
|
||||
return str(value or "").strip().lower()
|
||||
|
||||
|
||||
def channel_kind(market_id: Any, order_place_id: Any = None) -> str:
|
||||
"""self(자체몰 채널) / market(외부 마켓, 해당 쇼핑몰 열) / unknown(모르는 채널 → 카페24 열)."""
|
||||
if market_id is None or _key(market_id) in SELF_CHANNELS:
|
||||
return "self"
|
||||
if _key(market_id) in MARKET_MAP or _key(order_place_id) in MARKET_MAP:
|
||||
return "market"
|
||||
return "unknown"
|
||||
|
||||
|
||||
def target_code(market_id: Any, order_place_id: Any = None) -> str:
|
||||
"""이 주문을 집계할 쇼핑몰 열. 자체몰 채널·모르는 채널은 카페24."""
|
||||
if channel_kind(market_id, order_place_id) != "market":
|
||||
return "cafe24"
|
||||
return MARKET_MAP.get(_key(market_id)) or MARKET_MAP[_key(order_place_id)]
|
||||
|
||||
# 참고식(상품구매금액 + 배송비 − 할인 − 쿠폰)의 필드 — 결제합계는 PAID_FIELDS + naver_point 로 센다
|
||||
DISCOUNT_FIELDS = ("membership_discount_amount", "set_product_discount_amount", "app_discount_amount",
|
||||
"market_other_discount_amount", "shipping_fee_discount_amount")
|
||||
COUPON_FIELDS = ("coupon_discount_price", "coupon_shipping_fee_amount")
|
||||
AMOUNT_FIELDS = ("order_price_amount", "shipping_fee", *DISCOUNT_FIELDS, *COUPON_FIELDS,
|
||||
"points_spent_amount", "credits_spent_amount", "payment_amount")
|
||||
PAID_FIELDS = ("payment_amount", "points_spent_amount", "credits_spent_amount")
|
||||
|
||||
|
||||
def _won(value: Any) -> int:
|
||||
"""카페24 금액 문자열("29000.00") → 원 단위 정수."""
|
||||
try:
|
||||
return int(Decimal(str(value or "0")).quantize(Decimal(1), rounding=ROUND_HALF_UP))
|
||||
except (InvalidOperation, ValueError):
|
||||
return 0
|
||||
|
||||
|
||||
def _day(value: Any) -> date | None:
|
||||
""""2018-07-04T11:21:35+09:00" / "2017-07-10 15:55:51" → date (카페24 는 KST 로 준다)."""
|
||||
s = str(value or "").strip()
|
||||
if len(s) < 10:
|
||||
return None
|
||||
try:
|
||||
return date.fromisoformat(s[:10])
|
||||
except ValueError:
|
||||
return None
|
||||
|
||||
|
||||
def order_amounts(order: dict[str, Any]) -> dict[str, int]:
|
||||
"""결제 당시 금액(initial_order_amount, 없으면 actual_order_amount) 항목별 원 단위 + 네이버포인트(주문 필드)."""
|
||||
a = order.get("initial_order_amount") or order.get("actual_order_amount") or {}
|
||||
return {**{k: _won(a.get(k)) for k in AMOUNT_FIELDS}, "naver_point": _won(order.get("naver_point"))}
|
||||
|
||||
|
||||
def goods_total(w: dict[str, int]) -> int:
|
||||
"""참고식: 상품구매금액 + 배송비 − 할인 − 쿠폰."""
|
||||
return (w["order_price_amount"] + w["shipping_fee"]
|
||||
- sum(w[k] for k in DISCOUNT_FIELDS) - sum(w[k] for k in COUPON_FIELDS))
|
||||
|
||||
|
||||
def _paid_total(w: dict[str, int]) -> int:
|
||||
"""결제합계 = 실결제금액 + 적립금 + 예치금 + 네이버포인트. 넷 다 0인 주문은 카페24도 0원으로 센다
|
||||
(9/25 가상계좌·휴대폰 9,900 주문 — 상품식으로 넣으면 그만큼 많아짐)."""
|
||||
return sum(w[k] for k in PAID_FIELDS) + w["naver_point"]
|
||||
|
||||
|
||||
def order_total(order: dict[str, Any]) -> int:
|
||||
"""결제합계(결제 당시) — 카페24 일별 매출내역 결제합계와 같은 기준."""
|
||||
return _paid_total(order_amounts(order))
|
||||
|
||||
|
||||
def refund_total(refund: dict[str, Any]) -> int:
|
||||
"""환불합계 = 실제 환불액 + 적립금·예치금 환불."""
|
||||
return _won(refund.get("actual_refund_amount")) + _won(refund.get("used_points")) + _won(refund.get("used_credits"))
|
||||
|
||||
|
||||
def order_total_now(order: dict[str, Any]) -> int:
|
||||
"""취소·반품 반영 후 현재 결제합계(actual_order_amount). 없으면 결제 당시 금액."""
|
||||
a = order.get("actual_order_amount") or order.get("initial_order_amount") or {}
|
||||
return _paid_total({**{k: _won(a.get(k)) for k in AMOUNT_FIELDS}, "naver_point": _won(order.get("naver_point"))})
|
||||
|
||||
|
||||
def is_self_market(market_id: Any) -> bool:
|
||||
"""카페24 자체몰 채널(PC·모바일·네이버페이·톡체크아웃 등)인가."""
|
||||
return channel_kind(market_id) == "self"
|
||||
|
||||
|
||||
# 대조 진단 — 이름에 이 말이 들어간 숫자 필드만 합산(계좌·연락처 같은 개인정보 숫자는 이름이 달라 제외)
|
||||
DIAG_WORDS = ("price", "amount", "discount", "point", "fee", "credit", "mileage", "sale", "benefit", "incentive", "coupon")
|
||||
|
||||
|
||||
def _num(value: Any) -> Decimal | None:
|
||||
if isinstance(value, bool) or value is None:
|
||||
return None
|
||||
try:
|
||||
d = Decimal(str(value).strip())
|
||||
except (InvalidOperation, ValueError):
|
||||
return None
|
||||
return d if d.is_finite() else None
|
||||
|
||||
|
||||
def money_fields(obj: Any) -> dict[str, int]:
|
||||
"""dict 의 금액성 숫자 필드(이름에 DIAG_WORDS) → 원 단위. 중첩은 한 단계까지 "부모.자식"."""
|
||||
out: dict[str, int] = {}
|
||||
if not isinstance(obj, dict):
|
||||
return out
|
||||
for k, v in obj.items():
|
||||
if isinstance(v, dict):
|
||||
for k2, v2 in money_fields(v).items():
|
||||
out[f"{k}.{k2}"] = v2
|
||||
continue
|
||||
if not any(w in str(k).lower() for w in DIAG_WORDS):
|
||||
continue
|
||||
n = _num(v)
|
||||
if n is not None:
|
||||
out[str(k)] = int(n.quantize(Decimal(1), rounding=ROUND_HALF_UP))
|
||||
return out
|
||||
|
||||
|
||||
def _chunks(start: date, end: date) -> Iterable[tuple[date, date]]:
|
||||
s = start
|
||||
while s <= end:
|
||||
e = min(end, s + timedelta(days=CHUNK_DAYS - 1))
|
||||
yield s, e
|
||||
s = e + timedelta(days=1)
|
||||
|
||||
|
||||
class Cafe24Adapter(MarketplaceAdapter):
|
||||
code = "cafe24"
|
||||
name = "카페24"
|
||||
auth_type = "shared"
|
||||
implemented = True
|
||||
replace_range = True
|
||||
event_prefix = EVENT_PREFIX
|
||||
docs_url = "https://apidocs.cafe24.com/docs/admin/get-orders"
|
||||
note = ("카페24 상품관리에서 연결한 OAuth 토큰을 함께 씁니다(여기서 따로 입력하지 않음). "
|
||||
"주문 읽기 권한이 필요해 권한 추가 후 한 번 다시 연결해야 합니다.")
|
||||
|
||||
# ── 연결 ──────────────────────────────────────────────
|
||||
def is_configured(self, ctx: AdapterContext) -> bool:
|
||||
return True
|
||||
|
||||
def _repo(self, ctx: AdapterContext):
|
||||
return getattr(ctx.app_state, "cafe24_store", None) if ctx.app_state is not None else None
|
||||
|
||||
def shared_status(self, ctx: AdapterContext) -> dict:
|
||||
from app.integrations.cafe24.config import load_config # 지연 import
|
||||
from app.integrations.cafe24.tokens import TokenService # 지연 import
|
||||
|
||||
repo = self._repo(ctx)
|
||||
config = load_config()
|
||||
if repo is None:
|
||||
return {"connected": False, "missing": config.missing or ["CAFE24_DB_URL"], "needs_reauth": False}
|
||||
return TokenService(repo, config).status()
|
||||
|
||||
def authenticate(self, ctx: AdapterContext) -> None:
|
||||
st = self.shared_status(ctx)
|
||||
if not st.get("connected"):
|
||||
if st.get("missing"):
|
||||
raise NotConfigured("카페24 연동 환경변수가 설정되지 않았습니다.")
|
||||
if st.get("needs_reauth") and str(st.get("reason", "")).startswith("refresh"):
|
||||
raise TokenExpired("카페24 연결이 만료되었습니다. 카페24 상품관리 → 시스템에서 재연결하세요.")
|
||||
raise AuthFailed("카페24에 연결되어 있지 않습니다. 카페24 상품관리 → 시스템에서 연결하세요.")
|
||||
if ORDER_SCOPE not in str(st.get("scopes") or ""):
|
||||
raise AuthFailed("카페24 토큰에 주문 읽기 권한(mall.read_order)이 없습니다. "
|
||||
"카페24 상품관리 → 시스템에서 다시 연결하세요.")
|
||||
|
||||
def _client(self, ctx: AdapterContext):
|
||||
from app.integrations.cafe24 import build_cafe24_api # 지연 import
|
||||
|
||||
return build_cafe24_api(self._repo(ctx)).client
|
||||
|
||||
def _get(self, ctx: AdapterContext, path: str, params: dict[str, Any]) -> dict[str, Any]:
|
||||
from app.integrations.cafe24.errors import ( # 지연 import
|
||||
Cafe24ApiError,
|
||||
Cafe24AuthError,
|
||||
Cafe24ConfigError,
|
||||
Cafe24RateLimitError,
|
||||
)
|
||||
|
||||
try:
|
||||
return self._client(ctx).get(path, params=params)
|
||||
except Cafe24ConfigError as exc:
|
||||
raise NotConfigured(str(exc)) from None
|
||||
except Cafe24AuthError as exc:
|
||||
raise AuthFailed(str(exc)) from None
|
||||
except Cafe24RateLimitError as exc:
|
||||
raise ApiError(f"카페24 호출 제한(429): {exc}") from None
|
||||
except Cafe24ApiError as exc:
|
||||
status = getattr(exc, "status", None)
|
||||
if status == 403:
|
||||
raise AuthFailed(f"카페24 권한 오류(403): {exc}. 주문 권한 추가 후 재연결하세요.") from None
|
||||
raise ApiError(f"카페24 API 오류({status}): {exc}") from None
|
||||
|
||||
def test_connection(self, ctx: AdapterContext) -> str:
|
||||
from app.timezone import today_kst # noqa: WPS433
|
||||
|
||||
self.authenticate(ctx)
|
||||
today = today_kst().isoformat()
|
||||
self._get(ctx, "/admin/orders", {"start_date": today, "end_date": today, "date_type": "pay_date", "limit": 1})
|
||||
return "카페24 연결 정상(주문 조회 권한 확인)."
|
||||
|
||||
# ── 조회 ──────────────────────────────────────────────
|
||||
def _paged(self, ctx: AdapterContext, path: str, key: str, params: dict[str, Any],
|
||||
limit: int) -> Iterable[dict[str, Any]]:
|
||||
offset = 0
|
||||
while True:
|
||||
if offset > MAX_OFFSET:
|
||||
raise ApiError(f"카페24 조회 건수가 너무 많습니다({params.get('start_date')}~{params.get('end_date')}). "
|
||||
"기간을 줄여 다시 시도하세요.")
|
||||
ctx.progress.check() # [업데이트 취소]면 여기서 멈춤
|
||||
rows = self._get(ctx, path, {**params, "limit": limit, "offset": offset}).get(key) or []
|
||||
yield from rows
|
||||
if len(rows) < limit:
|
||||
return
|
||||
offset += limit
|
||||
|
||||
def paid_orders(self, ctx: AdapterContext, start: date, end: date) -> Iterable[dict[str, Any]]:
|
||||
for s, e in _chunks(start, end):
|
||||
n = 0
|
||||
for o in self._paged(ctx, "/admin/orders", "orders",
|
||||
{"start_date": s.isoformat(), "end_date": e.isoformat(),
|
||||
"date_type": "pay_date", "embed": "items"}, ORDER_LIMIT):
|
||||
n += 1
|
||||
yield o
|
||||
ctx.progress.step(items=n)
|
||||
|
||||
def refunds(self, ctx: AdapterContext, start: date, end: date,
|
||||
date_type: str = "refund_date") -> Iterable[dict[str, Any]]:
|
||||
"""환불 목록. date_type: refund_date(환불완료일, 기본) / accepted_refund_date(환불접수일)."""
|
||||
for s, e in _chunks(start, end):
|
||||
n = 0
|
||||
for r in self._paged(ctx, "/admin/refunds", "refunds",
|
||||
{"start_date": s.isoformat(), "end_date": e.isoformat(),
|
||||
"date_type": date_type}, REFUND_LIMIT):
|
||||
n += 1
|
||||
yield r
|
||||
ctx.progress.step(items=n)
|
||||
|
||||
def claim_items(self, ctx: AdapterContext, day: date) -> dict[str, Any]:
|
||||
"""그날 취소완료·반품완료·교환완료된 주문의 클레임 품목(대조 전용). 환불 API 에 안 잡히는 건
|
||||
(네이버페이 취소 등)을 찾기 위한 것. 조회 실패는 errors 에 담고 계속한다. 개인정보 제외."""
|
||||
items: list[dict[str, Any]] = []
|
||||
errors: list[str] = []
|
||||
seen: set[str] = set()
|
||||
full_cancel_shipping = 0
|
||||
for date_type, label in CLAIM_DATE_TYPES:
|
||||
try:
|
||||
orders = list(self._paged(ctx, "/admin/orders", "orders",
|
||||
{"start_date": day.isoformat(), "end_date": day.isoformat(),
|
||||
"date_type": date_type, "embed": "items"}, ORDER_LIMIT))
|
||||
except ApiError as exc:
|
||||
errors.append(f"{label}: {exc}")
|
||||
continue
|
||||
for o in orders:
|
||||
oid = str(o.get("order_id") or "")
|
||||
its = o.get("items") or []
|
||||
claimed = [i for i in its if str(i.get("order_status") or "")[:1] in ("C", "R", "E")
|
||||
and str(i.get("order_status") or "") not in UNPAID_CANCEL]
|
||||
if claimed and len(claimed) == len(its) and oid not in seen and \
|
||||
all(str(i.get("order_status") or "") in CLAIM_DONE and str(i.get("order_status"))[:1] == "C" for i in its):
|
||||
full_cancel_shipping += order_amounts(o)["shipping_fee"]
|
||||
for i in claimed:
|
||||
key = str(i.get("order_item_code") or f"{oid}-{i.get('item_no')}")
|
||||
if key in seen:
|
||||
continue
|
||||
seen.add(key)
|
||||
status = str(i.get("order_status") or "")
|
||||
qty = int(i.get("quantity") or 0)
|
||||
items.append({
|
||||
"via": label, "order_id": oid, "item_code": key,
|
||||
"channel": str(o.get("order_place_name") or o.get("market_id") or ""),
|
||||
"paid": o.get("paid") == "T", "pay_date": str(o.get("payment_date") or "")[:10],
|
||||
"status": status, "status_text": str(i.get("status_text") or ""),
|
||||
"done": status in CLAIM_DONE,
|
||||
"claim_code": str(i.get("claim_code") or ""),
|
||||
"product_name": str(i.get("product_name") or "")[:40], "quantity": qty,
|
||||
"product_amount": (_won(i.get("product_price")) + _won(i.get("option_price"))) * qty,
|
||||
"payment_amount": _won(i.get("payment_amount")),
|
||||
"coupon": _won(i.get("coupon_discount_price")),
|
||||
"naver_pay_claim_status": str(i.get("naver_pay_claim_status") or ""),
|
||||
"cancel_date": str(i.get("cancel_date") or "")[:16],
|
||||
"refund_date": str(i.get("refund_date") or "")[:16],
|
||||
"return_confirmed_date": str(i.get("return_confirmed_date") or "")[:16],
|
||||
})
|
||||
seen.add(oid)
|
||||
return {"items": items, "errors": errors, "full_cancel_shipping": full_cancel_shipping}
|
||||
|
||||
def unrefunded_claims(self, ctx: AdapterContext, start: date, end: date) -> list[dict[str, Any]]:
|
||||
"""환불 목록에 기록이 없는 네이버페이 취소·반품 완료 품목. 날짜 = 품목 취소일(반품은 반품완료일).
|
||||
금액 = 판매가(+옵션)×수량 − 품목 할인·쿠폰. 주문 전체가 취소·반품되면 배송비(− 배송비 할인·쿠폰)도 환불로
|
||||
보고 그 주문의 마지막 클레임 품목에 한 번 더한다. 앞뒤 60일 환불 목록(완료일·접수일)에 그 주문이 있으면
|
||||
제외해 환불 목록 쪽과 두 번 빼지 않는다.
|
||||
카페24 일별 매출 환불합계와 대조한 결과(2026-09): 네이버페이만 센다 — 톡체크아웃(KAKAOPAY)·자체몰의
|
||||
환불 기록 없는 취소는 넣지 않는다(9/16 톡체크아웃 취소 9,900 제외, 9/4 네이버페이 전체취소 배송비 3,500 포함)."""
|
||||
from app.timezone import today_kst # noqa: WPS433
|
||||
|
||||
found: dict[str, dict[str, Any]] = {}
|
||||
for date_type in NO_RECORD_DATE_TYPES:
|
||||
for s, e in _chunks(start, end):
|
||||
scanned = 0
|
||||
for o in self._paged(ctx, "/admin/orders", "orders",
|
||||
{"start_date": s.isoformat(), "end_date": e.isoformat(),
|
||||
"date_type": date_type, "embed": "items"}, ORDER_LIMIT):
|
||||
scanned += 1
|
||||
if NO_RECORD_CHANNEL not in (_key(o.get("market_id")), _key(o.get("order_place_id"))):
|
||||
continue
|
||||
oid = str(o.get("order_id") or "")
|
||||
its = o.get("items") or []
|
||||
claimed: list[tuple[date, str, dict[str, Any]]] = []
|
||||
for i in its:
|
||||
status = str(i.get("order_status") or "")
|
||||
if status not in NO_RECORD_DONE:
|
||||
continue
|
||||
keys = (("cancel_date", "refund_date", "return_confirmed_date") if status[:1] == "C"
|
||||
else ("return_confirmed_date", "refund_date", "cancel_date"))
|
||||
day = next((d for d in (_day(i.get(k)) for k in keys) if d), None)
|
||||
if day is not None:
|
||||
claimed.append((day, str(i.get("order_item_code") or f"{oid}-{i.get('item_no')}"), i))
|
||||
if not claimed:
|
||||
continue
|
||||
all_claimed = len(claimed) == len(its)
|
||||
w = order_amounts(o)
|
||||
ship = max(0, w["shipping_fee"] - w["coupon_shipping_fee_amount"] - w["shipping_fee_discount_amount"])
|
||||
last = max((d, k) for d, k, _ in claimed)
|
||||
for day, key, i in claimed:
|
||||
if not (start <= day <= end):
|
||||
continue
|
||||
status = str(i.get("order_status") or "")
|
||||
qty = int(i.get("quantity") or 0)
|
||||
amount = max(0, (_won(i.get("product_price")) + _won(i.get("option_price"))) * qty
|
||||
- _won(i.get("additional_discount_price")) - _won(i.get("coupon_discount_price"))
|
||||
- _won(i.get("app_item_discount_amount")))
|
||||
ship_refund = ship if all_claimed and (day, key) == last else 0
|
||||
found[key] = {
|
||||
"order_id": oid, "item_code": key, "status": status, "day": day,
|
||||
"market_id": o.get("market_id"), "place_id": o.get("order_place_id"),
|
||||
"place_name": o.get("order_place_name"), "order_date": _day(o.get("order_date")),
|
||||
"quantity": qty, "amount": amount + ship_refund, "shipping_refund": ship_refund,
|
||||
"product_name": str(i.get("product_name") or "")[:40],
|
||||
"naver_pay_claim_status": str(i.get("naver_pay_claim_status") or ""),
|
||||
# 대조용 — 주문 전체가 취소·반품됐는지, 그 주문 배송비
|
||||
"order_all_claimed": all_claimed, "order_shipping_fee": w["shipping_fee"],
|
||||
"item_payment_amount": _won(i.get("payment_amount")),
|
||||
"coupon": _won(i.get("coupon_discount_price")),
|
||||
}
|
||||
ctx.progress.step(items=scanned)
|
||||
if not found:
|
||||
return []
|
||||
lo = start - timedelta(days=REFUND_LOOKAROUND_DAYS)
|
||||
hi = max(end, min(end + timedelta(days=REFUND_LOOKAROUND_DAYS), today_kst()))
|
||||
ctx.progress.add(2 * len(list(_chunks(lo, hi)))) # 환불 목록 대조(완료일·접수일) — 찾은 게 있을 때만
|
||||
refunded = {str(r.get("order_id") or "") for dt in ("refund_date", "accepted_refund_date")
|
||||
for r in self.refunds(ctx, lo, hi, dt)}
|
||||
return [c for c in found.values() if c["order_id"] not in refunded]
|
||||
|
||||
def market_ids(self, ctx: AdapterContext, refunds: list[dict[str, Any]]) -> dict[str, tuple[Any, Any, Any]]:
|
||||
"""환불의 원 주문 (market_id, order_place_id, order_place_name) — 주문일 60일 구간·100건씩 묶어 조회.
|
||||
못 찾으면 자체몰."""
|
||||
pairs = sorted({(_day(r.get("order_date")) or date.min, str(r.get("order_id") or ""))
|
||||
for r in refunds if r.get("order_id")})
|
||||
out: dict[str, Any] = {}
|
||||
i = 0
|
||||
while i < len(pairs):
|
||||
first = pairs[i][0]
|
||||
group = [p for p in pairs[i:i + LOOKUP_BATCH] if (p[0] - first).days < CHUNK_DAYS]
|
||||
ids = [oid for _, oid in group]
|
||||
if first != date.min:
|
||||
params = {"order_id": ",".join(ids), "start_date": first.isoformat(),
|
||||
"end_date": group[-1][0].isoformat(), "date_type": "order_date", "limit": LOOKUP_BATCH}
|
||||
for o in self._get(ctx, "/admin/orders", params).get("orders") or []:
|
||||
out[str(o.get("order_id"))] = (o.get("market_id"), o.get("order_place_id"), o.get("order_place_name"))
|
||||
i += len(group)
|
||||
return out
|
||||
|
||||
# ── 수집(어댑터 공통 흐름) ──────────────────────────────
|
||||
def fetch_orders(self, ctx: AdapterContext, start: date, end: date) -> Iterable[dict[str, Any]]:
|
||||
# 진행 막대: 60일 구간마다 결제 주문 1 + 환불 1 + 환불 없는 취소·반품(취소일·반품완료일) 2
|
||||
c = len(list(_chunks(start, end)))
|
||||
ctx.progress.plan(c * (2 + len(NO_RECORD_DATE_TYPES)), "구간")
|
||||
yield from self.paid_orders(ctx, start, end)
|
||||
|
||||
def fetch_refunds(self, ctx: AdapterContext, start: date, end: date) -> Iterable[dict[str, Any]]:
|
||||
rows = [r for r in self.refunds(ctx, start, end) if str(r.get("status") or "T") == "T"]
|
||||
markets = self.market_ids(ctx, rows)
|
||||
for r in rows:
|
||||
mid, place, _name = markets.get(str(r.get("order_id")), ("self", None, None))
|
||||
yield {**r, "_market_id": mid, "_order_place_id": place}
|
||||
for c in self.unrefunded_claims(ctx, start, end):
|
||||
yield {**c, "_kind": "claim"}
|
||||
|
||||
def normalize_order(self, order: dict[str, Any]) -> list[SaleEvent]:
|
||||
"""결제 주문 → SALE. 자체몰은 카페24 열, 마켓 연동 주문은 해당 쇼핑몰 열(MARKET_MAP)."""
|
||||
if order.get("paid") != "T":
|
||||
return []
|
||||
pay_day = _day(order.get("payment_date"))
|
||||
if pay_day is None:
|
||||
return []
|
||||
items = order.get("items") or []
|
||||
names = [str(i.get("product_name") or "") for i in items if i.get("product_name")]
|
||||
name = names[0] + (f" 외 {len(names) - 1}건" if len(names) > 1 else "") if names else ""
|
||||
oid = str(order.get("order_id") or "")
|
||||
target = target_code(order.get("market_id"), order.get("order_place_id"))
|
||||
return [SaleEvent(
|
||||
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,
|
||||
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()}},
|
||||
)]
|
||||
|
||||
def normalize_refund(self, refund: dict[str, Any]) -> list[SaleEvent]:
|
||||
"""환불 → CANCEL/RETURN(−). 원 주문의 market_id 로 결제와 같은 쇼핑몰 열에 넣는다.
|
||||
금액 = 실제 환불액 + 적립금·예치금 환불(카페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)
|
||||
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",
|
||||
external_event_id=f"{EVENT_PREFIX}{code}", external_order_id=str(refund.get("order_id") or ""),
|
||||
external_line_id=",".join(refund.get("order_item_code") or []),
|
||||
order_date=_day(refund.get("order_date")), event_date=day, amount=-amount,
|
||||
quantity=-int(refund.get("quantity") or 0), order_status="환불완료",
|
||||
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")},
|
||||
)]
|
||||
|
||||
def normalize_claim(self, c: dict[str, Any]) -> list[SaleEvent]:
|
||||
"""환불 목록에 없는 취소·반품 품목(네이버페이 등) → CANCEL/RETURN(−), 취소일(반품완료일)."""
|
||||
if not c.get("amount") or c.get("day") is None:
|
||||
return []
|
||||
is_return = str(c.get("status"))[:1] == "R"
|
||||
return [SaleEvent(
|
||||
marketplace_code=target_code(c.get("market_id"), c.get("place_id")),
|
||||
event_type="RETURN" if is_return else "CANCEL",
|
||||
external_event_id=f"{EVENT_PREFIX}{c['item_code']}-CL", external_order_id=str(c.get("order_id") or ""),
|
||||
external_line_id=str(c["item_code"]), order_date=c.get("order_date"), event_date=c["day"],
|
||||
amount=-int(c["amount"]), quantity=-int(c.get("quantity") or 0), product_name=c.get("product_name") or "",
|
||||
order_status="반품완료" if is_return else "취소완료",
|
||||
raw={"order_id": c.get("order_id"), "item_code": c["item_code"], "status": c.get("status"),
|
||||
"market_id": c.get("market_id"), "naver_pay_claim_status": c.get("naver_pay_claim_status"),
|
||||
"no_refund_record": True},
|
||||
)]
|
||||
|
||||
# ── 대조(설정 화면 "카페24 매출 대조") ─────────────────
|
||||
def reconcile(self, ctx: AdapterContext, day: date) -> dict[str, Any]:
|
||||
"""그날 결제 주문·환불을 항목별로 합산 — 카페24 일별 매출내역과 비교해 규칙을 확정하는 용도.
|
||||
|
||||
groups["self"] = 카페24 열(자체몰 채널 + 알 수 없는 채널), groups["market"] = 다른 쇼핑몰 열로 가는
|
||||
외부 마켓 주문. by_channel = 주문 채널(market_id)별 내역. 개인정보는 담지 않는다.
|
||||
"""
|
||||
self.authenticate(ctx)
|
||||
|
||||
def empty() -> dict[str, int]:
|
||||
return {"orders": 0, "items": 0, "lines": 0, **{k: 0 for k in AMOUNT_FIELDS},
|
||||
"naver_point": 0, "goods_total": 0, "total": 0}
|
||||
|
||||
def channel(mid: Any, place: Any, place_name: Any = None) -> dict[str, Any]:
|
||||
"""(market_id, 주문경로) 한 쌍 = 한 줄. self 안에도 PC쇼핑몰·모바일웹 경로가 섞여 있어 나눠 본다."""
|
||||
mkey = "" if mid is None else str(mid)
|
||||
pname = str(place_name or place or "")
|
||||
kind = channel_kind(mid, place)
|
||||
return by_channel.setdefault((mkey, pname), {
|
||||
"market_id": mkey or "(없음)", "place": pname, "place_id": str(place or ""),
|
||||
"label": SELF_CHANNELS.get(_key(mid), ""), "names": set(),
|
||||
"kind": kind, "target": target_code(mid, place),
|
||||
"orders": 0, "total": 0, "refund_count": 0, "refund_amount": 0,
|
||||
# 기기 — 주문의 order_from_mobile(T=모바일에서 주문). PC 채널(self)에도 모바일 주문이 섞여 있다.
|
||||
"pc_orders": 0, "pc_total": 0, "mobile_orders": 0, "mobile_total": 0,
|
||||
})
|
||||
|
||||
groups = {"self": empty(), "market": empty()}
|
||||
by_channel: dict[str, dict[str, Any]] = {}
|
||||
by_payment: dict[str, dict[str, Any]] = {} # 결제수단 조합별(카페24 열 주문만)
|
||||
unpaid = 0
|
||||
paid_self: dict[str, int] = {} # 그날 결제된 카페24 열 주문 → (결제 당시 − 현재) 금액
|
||||
reduced: dict[str, dict[str, Any]] = {} # 그중 금액이 줄어든 주문(취소·반품) — 환불 기록과 대조
|
||||
# 진단 — 어떤 원본 필드가 카페24 화면 열과 맞는지 찾는 용도(결제 주문 전체, 개인정보 제외)
|
||||
diag = {"order": {}, "initial": {}, "actual": {}, "item": {}}
|
||||
odd: list[dict[str, Any]] = [] # 판매가×수량 합이 주문 상품금액과 다르거나 100원 단위가 아닌 주문
|
||||
for o in self.paid_orders(ctx, day, day):
|
||||
if o.get("paid") != "T":
|
||||
unpaid += 1
|
||||
continue
|
||||
for part, src in (("order", {k: v for k, v in o.items() if not isinstance(v, (dict, list))}),
|
||||
("initial", o.get("initial_order_amount")), ("actual", o.get("actual_order_amount"))):
|
||||
for k, v in money_fields(src).items():
|
||||
diag[part][k] = diag[part].get(k, 0) + v
|
||||
its = o.get("items") or []
|
||||
for i in its:
|
||||
for k, v in money_fields(i).items():
|
||||
diag["item"][k] = diag["item"].get(k, 0) + v
|
||||
gross = sum((_won(i.get("product_price")) + _won(i.get("option_price"))) * int(i.get("quantity") or 0) for i in its)
|
||||
opa = order_amounts(o)["order_price_amount"]
|
||||
if (gross != opa or opa % 100) and len(odd) < 60:
|
||||
odd.append({"order_id": str(o.get("order_id") or ""),
|
||||
"channel": str(o.get("order_place_name") or o.get("market_id") or ""),
|
||||
"order_price_amount": opa, "items_gross": gross, "total": order_total(o),
|
||||
"items": [{"code": str(i.get("order_item_code") or ""), "status": str(i.get("order_status") or ""),
|
||||
"quantity": int(i.get("quantity") or 0),
|
||||
"fields": {k: v for k, v in money_fields(i).items() if v}} for i in its]})
|
||||
ch = channel(o.get("market_id"), o.get("order_place_id"), o.get("order_place_name"))
|
||||
total = order_total(o)
|
||||
ch["orders"] += 1
|
||||
ch["total"] += total
|
||||
dev = "mobile" if str(o.get("order_from_mobile") or "").upper() == "T" else "pc"
|
||||
ch[f"{dev}_orders"] += 1
|
||||
ch[f"{dev}_total"] += total
|
||||
if ch["target"] == "cafe24":
|
||||
names = [str(n) for n in (o.get("payment_method_name") or o.get("payment_method") or []) if n]
|
||||
pkey = " + ".join(names) or "(없음)"
|
||||
pm = by_payment.setdefault(pkey, {"method": pkey, "orders": 0, "total": 0})
|
||||
pm["orders"] += 1
|
||||
pm["total"] += total
|
||||
for n in (o.get("order_place_name"), o.get("order_place_id")):
|
||||
if n:
|
||||
ch["names"].add(str(n))
|
||||
g = groups["self" if ch["target"] == "cafe24" else "market"]
|
||||
g["orders"] += 1
|
||||
g["items"] += sum(int(i.get("quantity") or 0) for i in o.get("items") or [])
|
||||
g["lines"] += len(o.get("items") or [])
|
||||
for k, v in order_amounts(o).items():
|
||||
g[k] += v
|
||||
g["goods_total"] += goods_total(order_amounts(o))
|
||||
g["total"] += order_total(o)
|
||||
if ch["target"] == "cafe24":
|
||||
oid_ = str(o.get("order_id") or "")
|
||||
paid_self[oid_] = order_total(o) - order_total_now(o)
|
||||
if paid_self[oid_] > 0:
|
||||
reduced[oid_] = {
|
||||
"order_id": oid_, "channel": str(o.get("order_place_name") or o.get("market_id") or ""),
|
||||
"payment": " + ".join(str(n) for n in (o.get("payment_method_name") or []) if n),
|
||||
"initial": order_total(o), "now": order_total_now(o), "diff": paid_self[oid_],
|
||||
"statuses": sorted({f"{i.get('order_status') or ''} {i.get('status_text') or ''}".strip()
|
||||
for i in o.get("items") or []}),
|
||||
"naver_pay": sorted({str(i.get("naver_pay_claim_status")) for i in o.get("items") or []
|
||||
if i.get("naver_pay_claim_status")}),
|
||||
"claim_dates": sorted({str(i.get(k))[:10] for i in o.get("items") or []
|
||||
for k in ("cancel_date", "refund_date", "return_confirmed_date")
|
||||
if i.get(k)}),
|
||||
"refunded": 0, "refund_dates": [],
|
||||
}
|
||||
rows = [r for r in self.refunds(ctx, day, day) if str(r.get("status") or "T") == "T"]
|
||||
markets = self.market_ids(ctx, rows)
|
||||
refunds = {k: {"count": 0, "actual_refund_amount": 0, "used_points": 0, "used_credits": 0,
|
||||
"no_record_count": 0, "no_record": 0, "total": 0} for k in ("self", "market")}
|
||||
for r in rows:
|
||||
mid, place, place_name = markets.get(str(r.get("order_id")), ("self", None, None))
|
||||
ch = channel(mid, place, place_name)
|
||||
g = refunds["self" if ch["target"] == "cafe24" else "market"]
|
||||
g["count"] += 1
|
||||
for k in ("actual_refund_amount", "used_points", "used_credits"):
|
||||
g[k] += _won(r.get(k))
|
||||
g["total"] += refund_total(r)
|
||||
ch["refund_count"] += 1
|
||||
ch["refund_amount"] += refund_total(r)
|
||||
no_record = self.unrefunded_claims(ctx, day, day)
|
||||
for c in no_record:
|
||||
ch = channel(c["market_id"], c["place_id"], c["place_name"])
|
||||
g = refunds["self" if ch["target"] == "cafe24" else "market"]
|
||||
g["no_record_count"] += 1
|
||||
g["no_record"] += c["amount"]
|
||||
g["total"] += c["amount"]
|
||||
ch["refund_count"] += 1
|
||||
ch["refund_amount"] += c["amount"]
|
||||
channels_out = sorted(({**v, "names": sorted(v["names"])} for v in by_channel.values()),
|
||||
key=lambda v: v["total"], reverse=True)
|
||||
|
||||
# 환불 기준 비교 — 카페24 "환불합계"가 어느 기준인지 확정하는 용도.
|
||||
# 완료일(refund_date, 완료 T) vs 접수일(accepted_refund_date, 상태 T/F/M 전부)
|
||||
# 각각 실제 환불액만 / 적립금·예치금 환불 포함
|
||||
def rsum(items: Iterable[dict[str, Any]]) -> dict[str, int]:
|
||||
out = {"count": 0, "actual_refund_amount": 0, "used_points": 0, "used_credits": 0}
|
||||
for x in items:
|
||||
out["count"] += 1
|
||||
for k in ("actual_refund_amount", "used_points", "used_credits"):
|
||||
out[k] += _won(x.get(k))
|
||||
out["with_points"] = out["actual_refund_amount"] + out["used_points"] + out["used_credits"]
|
||||
return out
|
||||
|
||||
accepted = list(self.refunds(ctx, day, day, "accepted_refund_date"))
|
||||
status_names = {"T": "환불완료", "F": "환불전", "M": "환불보류"}
|
||||
refund_basis = {
|
||||
"completed": rsum(rows),
|
||||
"accepted_all": rsum(accepted),
|
||||
"accepted_by_status": [
|
||||
{"status": s, "label": status_names.get(s, s or "(없음)"),
|
||||
**rsum(x for x in accepted if str(x.get("status") or "") == s)}
|
||||
for s in sorted({str(x.get("status") or "") for x in accepted})
|
||||
],
|
||||
}
|
||||
|
||||
# 환불 건별 목록(완료일 기준 + 접수일 기준, 환불코드로 합침) — 개인정보(이메일·계좌) 제외
|
||||
extra = markets | self.market_ids(ctx, [a for a in accepted if str(a.get("order_id")) not in markets])
|
||||
refund_list: dict[str, dict[str, Any]] = {}
|
||||
for basis, items in (("completed", rows), ("accepted", accepted)):
|
||||
for x in items:
|
||||
code = str(x.get("refund_code") or "")
|
||||
mid, place, place_name = extra.get(str(x.get("order_id")), ("self", None, None))
|
||||
e = refund_list.setdefault(code, {
|
||||
"refund_code": code, "order_id": str(x.get("order_id") or ""),
|
||||
"channel": str(place_name or mid or ""), "status": str(x.get("status") or ""),
|
||||
"accepted_date": str(x.get("accepted_refund_date") or "")[:16].replace("T", " "),
|
||||
"refund_date": str(x.get("refund_date") or "")[:16].replace("T", " "),
|
||||
"quantity": int(x.get("quantity") or 0),
|
||||
"actual_refund_amount": _won(x.get("actual_refund_amount")),
|
||||
"used_points": _won(x.get("used_points")), "used_credits": _won(x.get("used_credits")),
|
||||
"cancel_fee_amount": _won(x.get("cancel_fee_amount")),
|
||||
"methods": [str(m) for m in (x.get("refund_methods") or []) if m],
|
||||
"in_completed": False, "in_accepted": False,
|
||||
})
|
||||
e["in_" + basis] = True
|
||||
|
||||
claims = self.claim_items(ctx, day)
|
||||
refunded_orders = {r["order_id"] for r in refund_list.values()}
|
||||
for c in claims["items"]:
|
||||
c["has_refund"] = c["order_id"] in refunded_orders
|
||||
|
||||
def csum(pred) -> dict[str, int]:
|
||||
sel = [c for c in claims["items"] if c["done"] and pred(c)]
|
||||
return {"count": len(sel), "payment_amount": sum(c["payment_amount"] for c in sel),
|
||||
"product_amount": sum(c["product_amount"] for c in sel)}
|
||||
|
||||
# 결제일 기준 — 그날 결제된 주문이 그 뒤(오늘까지) 환불된 금액. 카페24 일별 매출이 환불을 원 주문 결제일에
|
||||
# 빼는지 확인하는 용도(최근일만 맞고 지난 날일수록 차이가 커지는 현상).
|
||||
from app.timezone import today_kst # noqa: WPS433
|
||||
|
||||
later = [x for x in self.refunds(ctx, day, max(day, today_kst()))
|
||||
if str(x.get("order_id") or "") in paid_self and str(x.get("status") or "T") == "T"]
|
||||
by_pay = rsum(later)
|
||||
by_pay["amount_diff"] = sum(v for v in paid_self.values() if v > 0)
|
||||
by_pay["refund_dates"] = sorted({str(x.get("refund_date") or "")[:10] for x in later})
|
||||
refund_basis["by_pay_date"] = by_pay
|
||||
for x in later:
|
||||
r_ = reduced.get(str(x.get("order_id") or ""))
|
||||
if r_ is not None:
|
||||
r_["refunded"] += _won(x.get("actual_refund_amount")) + _won(x.get("used_points")) + _won(x.get("used_credits"))
|
||||
r_["refund_dates"] = sorted({*r_["refund_dates"], str(x.get("refund_date") or "")[:10]})
|
||||
|
||||
comp = refund_basis["completed"]
|
||||
no_refund = csum(lambda c: not c["has_refund"])
|
||||
claimed = csum(lambda c: True)
|
||||
# 카페24 "환불합계" 후보 — 화면 값과 같은 줄을 찾는다(화면에서 값을 입력하면 강조)
|
||||
candidates = [
|
||||
{"key": "applied", "label": "적용 규칙 · 환불 목록(실제 + 적립금·예치금) + 환불 목록 없는 취소·반품(네이버페이 등)",
|
||||
"amount": refunds["self"]["total"] + refunds["market"]["total"]},
|
||||
{"key": "completed", "label": "환불완료일 · 실제 환불액 (이전 규칙)", "amount": comp["actual_refund_amount"]},
|
||||
{"key": "completed_pts", "label": "환불완료일 · 실제 환불액 + 적립금·예치금", "amount": comp["with_points"]},
|
||||
{"key": "pay_date", "label": "결제일 기준 · 그날 결제 주문의 환불(오늘까지) · 실제 환불액",
|
||||
"amount": by_pay["actual_refund_amount"]},
|
||||
{"key": "pay_date_pts", "label": "결제일 기준 · 그날 결제 주문의 환불(오늘까지) · 실제 + 적립금·예치금",
|
||||
"amount": by_pay["with_points"]},
|
||||
{"key": "pay_date_diff", "label": "결제일 기준 · 그날 결제 주문의 (결제 당시 금액 − 현재 금액)",
|
||||
"amount": by_pay["amount_diff"]},
|
||||
{"key": "accepted", "label": "환불접수일(전체 상태) · 실제 환불액", "amount": refund_basis["accepted_all"]["actual_refund_amount"]},
|
||||
{"key": "accepted_pts", "label": "환불접수일(전체 상태) · 실제 + 적립금·예치금", "amount": refund_basis["accepted_all"]["with_points"]},
|
||||
{"key": "claim_pay", "label": "취소·반품·교환 완료 품목 · 품목 결제금액", "amount": claimed["payment_amount"]},
|
||||
{"key": "claim_prod", "label": "취소·반품·교환 완료 품목 · 판매가(+옵션)×수량", "amount": claimed["product_amount"]},
|
||||
{"key": "claim_pay_ship", "label": "완료 품목 결제금액 + 전체취소 주문 배송비",
|
||||
"amount": claimed["payment_amount"] + claims["full_cancel_shipping"]},
|
||||
{"key": "completed_plus_noref", "label": "환불완료 실제 환불액 + 환불 기록 없는 완료 품목 결제금액",
|
||||
"amount": comp["actual_refund_amount"] + no_refund["payment_amount"]},
|
||||
{"key": "completed_pts_plus_noref", "label": "환불완료 (실제+적립금) + 환불 기록 없는 완료 품목 결제금액",
|
||||
"amount": comp["with_points"] + no_refund["payment_amount"]},
|
||||
]
|
||||
return {"date": day.isoformat(), "orders": groups, "refunds": refunds, "unpaid_orders": unpaid,
|
||||
"by_channel": channels_out, "refund_basis": refund_basis,
|
||||
"refund_list": sorted(refund_list.values(), key=lambda r: r["refund_code"]),
|
||||
"claims": claims, "refund_candidates": candidates,
|
||||
"no_record_claims": [{**c, "day": c["day"].isoformat(),
|
||||
"order_date": c["order_date"].isoformat() if c["order_date"] else None}
|
||||
for c in no_record],
|
||||
"reduced_orders": sorted(reduced.values(), key=lambda r: r["diff"] - r["refunded"], reverse=True),
|
||||
"by_payment": sorted(by_payment.values(), key=lambda v: v["total"], reverse=True),
|
||||
"diag": {part: dict(sorted(v.items())) for part, v in diag.items()}, "odd_orders": odd,
|
||||
"formula": "결제합계 = 실결제금액 + 적립금 + 예치금 + 네이버포인트(결제 당시). 참고식 = 상품구매금액 + 배송비 − 할인("
|
||||
+ ", ".join(DISCOUNT_FIELDS) + ") − 쿠폰(" + ", ".join(COUPON_FIELDS) + ")"}
|
||||
@@ -0,0 +1,552 @@
|
||||
"""쿠팡 — 쿠팡 윙(마켓플레이스) Open API.
|
||||
|
||||
인증: Vendor ID + Access Key + Secret Key 로 요청마다 HMAC 서명(CEA 헤더).
|
||||
signed-date = UTC "yyMMddTHHmmssZ", message = signed-date + METHOD + path + query(물음표 없이, 보내는 그대로)
|
||||
Authorization: CEA algorithm=HmacSHA256, access-key=…, signed-date=…, signature=hex(HMAC-SHA256(secret, message))
|
||||
(공식 문서 developers.coupangcorp.com → 시작하기 → HMAC Signature 생성 / Python Example, 2026-09-30 확인)
|
||||
|
||||
OPEN API 키는 판매자당 1개(유효기간 180일). 발급 방식이 둘 —
|
||||
· 연동업체 선택(사방넷 등 1곳만): 그 업체 서버에서 쓰는 키. 우리 서버에서 부르면 막힐 수 있다.
|
||||
· 자체개발: 업체명·URL·허용 IP(최대 10개). 우리 서버 IP 를 넣어야 한다.
|
||||
|
||||
매출 수집 — 맞출 화면: WING → 비즈니스 인사이트 → **판매분석**(판매자배송 + 로켓그로스, 날짜 선택) 의 "매출(원)"
|
||||
(2026-10-12 사용자 지정). 판매분석 자체를 주는 Open API 는 없다(2026-10-12 developers.coupang.com API 목록 확인) —
|
||||
그래서 주문 API 두 개를 결제일(한국 시간)로 합친다:
|
||||
- 판매자배송: 발주서 목록(일단위 페이징) GET /v2/providers/openapi/apis/api/v5/vendors/{vendorId}/ordersheets
|
||||
?createdAtFrom=yyyy-mm-dd+09:00&createdAtTo=…&status=…&maxPerPage=50&nextToken=
|
||||
— 주문일 기준·한 번에 31일까지·상태(ACCEPT·INSTRUCT·DEPARTURE·DELIVERING·FINAL_DELIVERY·NONE_TRACKING)마다 따로.
|
||||
결제일(paidAt)로 다시 거른다(주문일 하루 앞부터 조회). 줄 금액 = orderPrice(판매가 × 수량, 쿠폰 할인 전).
|
||||
완료된 반품·결제 전 취소된 발주서는 이 목록에 없다(쿠팡 안내).
|
||||
- 로켓그로스: 주문 목록 GET /v2/providers/rg_open_api/apis/api/v1/vendors/{vendorId}/rg/orders
|
||||
?paidDateFrom=yyyymmdd&paidDateTo=yyyymmdd&nextToken= — 결제일 기준·30일까지·분당 50회.
|
||||
줄 금액 = unitSalesPrice × salesQuantity. 쿠팡 안내상 **출고된 주문만** 나온다(오늘 주문은 출고 뒤에 잡힐 수 있음).
|
||||
- SALE = 주문 하나(판매자배송 `coupang:{orderId}`, 로켓그로스 `coupang:rg:{orderId}`), 날짜 = 결제일.
|
||||
결제 뒤 취소된 줄(canceled·cancelCount)도 결제일 매출에 둔다(지난 날짜가 나중에 줄지 않게) — 금액은 참고로 따로.
|
||||
판매분석 "매출" 의 정확한 정의(할인 전·후, 취소 포함 여부)는 공개 문서가 없어 **설정 → 쇼핑몰 원본 데이터 확인**
|
||||
(reconcile)의 날짜별 후보 금액을 WING 숫자와 비교해 확정한다. 구매자 이름·연락처·주소는 저장·표시하지 않는다.
|
||||
로켓(공급) 매출은 기존 쿠팡 밀크런 모듈의 cupang_sales 에 있다 — 여기에 넣지 않는다.
|
||||
"""
|
||||
|
||||
from __future__ import annotations
|
||||
|
||||
import hashlib
|
||||
import hmac
|
||||
import time
|
||||
from datetime import date, datetime, timedelta, timezone
|
||||
from typing import Any, Iterable
|
||||
from urllib.parse import quote, urlencode
|
||||
|
||||
from .base import (
|
||||
AdapterContext,
|
||||
AdapterError,
|
||||
ApiError,
|
||||
AuthFailed,
|
||||
CredentialField,
|
||||
MarketplaceAdapter,
|
||||
NotConfigured,
|
||||
SaleEvent,
|
||||
)
|
||||
from .naver import field_summary, flatten
|
||||
|
||||
HOST = "https://api-gateway.coupang.com"
|
||||
ORDERS_PATH = "/v2/providers/openapi/apis/api/v5/vendors/{vendor}/ordersheets"
|
||||
RG_ORDERS_PATH = "/v2/providers/rg_open_api/apis/api/v1/vendors/{vendor}/rg/orders"
|
||||
EVENT_PREFIX = "coupang:"
|
||||
RG_PREFIX = "coupang:rg:"
|
||||
STATUSES = ("ACCEPT", "INSTRUCT", "DEPARTURE", "DELIVERING", "FINAL_DELIVERY", "NONE_TRACKING")
|
||||
STATUS_KO = {"ACCEPT": "결제완료", "INSTRUCT": "상품준비중", "DEPARTURE": "배송지시", "DELIVERING": "배송중",
|
||||
"FINAL_DELIVERY": "배송완료", "NONE_TRACKING": "업체직송", "RG": "로켓그로스"}
|
||||
ORDER_SPAN_DAYS = 31 # 발주서 목록 한 번에 조회할 수 있는 기간(시작·끝 포함)
|
||||
RG_SPAN_DAYS = 30 # 로켓그로스 주문 목록 한 번에 조회할 수 있는 기간
|
||||
PAGE_SIZE = 50
|
||||
MAX_PAGES = 400 # 한 조회 2만 건 — 무한 반복 방지
|
||||
CALL_INTERVAL_SEC = 0.25 # 발주서 목록 호출 간격
|
||||
RG_CALL_INTERVAL_SEC = 1.25 # 로켓그로스 분당 50회 제한
|
||||
RETRY_429 = 3
|
||||
RETRY_TIMEOUT_1DAY = 2 # 하루 구간도 시간 초과면 잠깐 쉬고 다시 부르는 횟수
|
||||
PROBE_MAX_DAYS = 31
|
||||
KST_OFFSET = timedelta(hours=9)
|
||||
|
||||
|
||||
class GatewayTimeout(ApiError):
|
||||
"""쿠팡 서버가 시간 안에 답하지 못함(502·503·504·응답 시간 초과) — 조회 기간을 줄이면 대개 풀린다."""
|
||||
|
||||
|
||||
class TooManyPages(ApiError):
|
||||
"""한 번 조회가 끝까지 받았는지 확인되지 않음(쪽 수 상한·커서 반복) — 조회 기간을 줄여 다시 부른다(F05)."""
|
||||
|
||||
|
||||
# 원본 확인·저장에서 통째로 빼는 항목(구매자·수령자·통관 정보·배송 메모·직접 입력 항목)
|
||||
PERSONAL_KEYS = frozenset({"orderer", "receiver", "overseaShippingInfoDto", "parcelPrintMessage"})
|
||||
PERSONAL_ITEM_KEYS = frozenset({"etcInfoHeader", "etcInfoValue", "etcInfoValues"})
|
||||
|
||||
|
||||
def signed_date(now: float | None = None) -> str:
|
||||
return time.strftime("%y%m%dT%H%M%SZ", time.gmtime(now))
|
||||
|
||||
|
||||
def authorization(method: str, path: str, query: str, access_key: str, secret_key: str,
|
||||
*, now: float | None = None) -> str:
|
||||
"""쿠팡 CEA HMAC 헤더. query 는 실제로 보내는 문자열 그대로(물음표 제외)."""
|
||||
dt = signed_date(now)
|
||||
sig = hmac.new(secret_key.encode("utf-8"), f"{dt}{method}{path}{query}".encode("utf-8"),
|
||||
hashlib.sha256).hexdigest()
|
||||
return f"CEA algorithm=HmacSHA256, access-key={access_key}, signed-date={dt}, signature={sig}"
|
||||
|
||||
|
||||
def build_query(params: dict[str, Any]) -> str:
|
||||
"""쿠팡 예시와 같은 인코딩 — '+' 는 %2B, ':' 는 그대로(2026-09-30%2B09:00)."""
|
||||
return urlencode({k: v for k, v in params.items() if v is not None}, quote_via=quote, safe=":")
|
||||
|
||||
|
||||
def _won(value: Any) -> int:
|
||||
"""금액 → 원 정수. 쿠팡 Money({"units": 15000, "nanos": 0})·숫자·문자열("27800") 모두."""
|
||||
if isinstance(value, dict):
|
||||
return _won(value.get("units")) + int(round((_num(value.get("nanos")) or 0) / 1e9))
|
||||
n = _num(value)
|
||||
return int(round(n)) if n is not None else 0
|
||||
|
||||
|
||||
def _num(value: Any) -> float | None:
|
||||
if value is None or isinstance(value, bool):
|
||||
return None
|
||||
try:
|
||||
return float(str(value).replace(",", "").strip() or 0)
|
||||
except ValueError:
|
||||
return None
|
||||
|
||||
|
||||
def _kst_day(value: Any) -> date | None:
|
||||
"""결제 시각 → 한국 날짜. ISO 문자열("2025-08-01T10:06:12+09:00", 시간대 없으면 한국 시간) 또는
|
||||
밀리초 타임스탬프(1746093162000, 로켓그로스)."""
|
||||
if value is None or value == "":
|
||||
return None
|
||||
n = _num(value) if not isinstance(value, str) or value.strip().isdigit() else None
|
||||
if n is not None:
|
||||
secs = n / 1000 if n > 1e11 else n
|
||||
return (datetime.fromtimestamp(secs, tz=timezone.utc) + KST_OFFSET).date()
|
||||
s = str(value).strip().replace("Z", "+00:00")
|
||||
try:
|
||||
dt = datetime.fromisoformat(s if "T" in s or " " in s else s[:10])
|
||||
except ValueError:
|
||||
try:
|
||||
return date.fromisoformat(s[:10])
|
||||
except ValueError:
|
||||
return None
|
||||
if dt.tzinfo is not None:
|
||||
dt = (dt - dt.utcoffset()).replace(tzinfo=None) + KST_OFFSET # type: ignore[operator]
|
||||
return dt.date()
|
||||
|
||||
|
||||
def spans(start: date, end: date, days: int) -> list[tuple[date, date]]:
|
||||
"""[start, end] 를 days 일(시작·끝 포함) 이하 구간으로 자른다."""
|
||||
out, d = [], start
|
||||
while d <= end:
|
||||
e = min(end, d + timedelta(days=days - 1))
|
||||
out.append((d, e))
|
||||
d = e + timedelta(days=1)
|
||||
return out
|
||||
|
||||
|
||||
def safe_order(o: dict[str, Any]) -> dict[str, Any]:
|
||||
"""개인정보 항목을 뺀 발주서(원본 확인·저장용)."""
|
||||
out = {k: v for k, v in o.items() if k not in PERSONAL_KEYS}
|
||||
if isinstance(out.get("orderItems"), list):
|
||||
out["orderItems"] = [{k: v for k, v in it.items() if k not in PERSONAL_ITEM_KEYS}
|
||||
for it in out["orderItems"] if isinstance(it, dict)]
|
||||
return out
|
||||
|
||||
|
||||
def line_records(o: dict[str, Any]) -> list[dict[str, str]]:
|
||||
"""발주서 하나 → 줄(orderItems)마다 평평한 기록 하나 — 원본 확인 표의 항목별 합계용."""
|
||||
base = flatten({k: v for k, v in safe_order(o).items() if k != "orderItems"})
|
||||
items = safe_order(o).get("orderItems") or [{}]
|
||||
return [{**base, **flatten(it, "orderItems")} for it in items]
|
||||
|
||||
|
||||
def seller_lines(orders: Iterable[dict[str, Any]], start: date, end: date) -> list[dict[str, Any]]:
|
||||
"""판매자배송 발주서 → 결제일이 [start, end] 인 줄. 같은 발주서가 두 번 와도(상태 사이 이동) 한 번만."""
|
||||
seen: set[tuple[str, str, str, str]] = set()
|
||||
out: list[dict[str, Any]] = []
|
||||
for o in orders:
|
||||
oid = str(o.get("orderId") or "")
|
||||
day = _kst_day(o.get("paidAt") or o.get("orderedAt"))
|
||||
if not oid or day is None or not (start <= day <= end):
|
||||
continue
|
||||
box = str(o.get("shipmentBoxId") or "")
|
||||
first = len(out)
|
||||
for it in o.get("orderItems") or []:
|
||||
if not isinstance(it, dict):
|
||||
continue
|
||||
key = (oid, box, str(it.get("vendorItemId") or ""), str(it.get("sequenceNo") or ""))
|
||||
if key in seen:
|
||||
continue
|
||||
seen.add(key)
|
||||
qty = _won(it.get("shippingCount"))
|
||||
price = _won(it.get("orderPrice")) or _won(it.get("salesPrice")) * qty
|
||||
cancel_qty = _won(it.get("cancelCount")) + _won(it.get("holdCountForCancel"))
|
||||
canceled = bool(it.get("canceled")) or (qty > 0 and cancel_qty >= qty)
|
||||
cancel_amt = price if canceled else (_won(it.get("salesPrice")) * min(cancel_qty, qty) if cancel_qty else 0)
|
||||
out.append({
|
||||
"orderId": oid, "_day": day, "order_day": _kst_day(o.get("orderedAt")), "status": str(o.get("status") or ""),
|
||||
"amount": price, "discount": _won(it.get("discountPrice")), "canceled": cancel_amt, "qty": qty,
|
||||
"name": str(it.get("sellerProductName") or it.get("vendorItemName") or ""),
|
||||
"opt": str(it.get("sellerProductItemName") or ""), "ship": 0,
|
||||
})
|
||||
# 배송비는 발주서(묶음 배송)마다 한 번 — 그 발주서의 첫 새 줄에(참고용, 매출 제외). 같은 발주서가 또 오면 새 줄이 없어 안 더함
|
||||
if len(out) > first:
|
||||
out[first]["ship"] += _won(o.get("shippingPrice")) + _won(o.get("remotePrice"))
|
||||
return out
|
||||
|
||||
|
||||
def rg_lines(orders: Iterable[dict[str, Any]], start: date, end: date) -> list[dict[str, Any]]:
|
||||
"""로켓그로스 주문 → 결제일이 [start, end] 인 줄. 금액 = 단가 × 수량."""
|
||||
seen: set[tuple[str, str, int]] = set()
|
||||
out: list[dict[str, Any]] = []
|
||||
for o in orders:
|
||||
oid = str(o.get("orderId") or "")
|
||||
day = _kst_day(o.get("paidAt"))
|
||||
if not oid or day is None or not (start <= day <= end):
|
||||
continue
|
||||
for i, it in enumerate(o.get("orderItems") or []):
|
||||
if not isinstance(it, dict):
|
||||
continue
|
||||
key = (oid, str(it.get("vendorItemId") or ""), i)
|
||||
if key in seen:
|
||||
continue
|
||||
seen.add(key)
|
||||
qty = _won(it.get("salesQuantity"))
|
||||
out.append({"orderId": oid, "_day": day, "order_day": day, "status": "RG",
|
||||
"amount": _won(it.get("unitSalesPrice")) * qty, "discount": 0, "canceled": 0, "qty": qty,
|
||||
"name": str(it.get("productName") or ""), "opt": "", "ship": 0})
|
||||
return out
|
||||
|
||||
|
||||
def group_lines(lines: Iterable[dict[str, Any]], prefix: str) -> dict[str, dict[str, Any]]:
|
||||
"""줄 → 주문 하나(외부 사건 ID 기준)."""
|
||||
orders: dict[str, dict[str, Any]] = {}
|
||||
for ln in lines:
|
||||
eid = f"{prefix}{ln['orderId']}"
|
||||
o = orders.setdefault(eid, {"event_id": eid, "orderId": ln["orderId"], "_day": ln["_day"],
|
||||
"order_day": ln.get("order_day"), "amount": 0, "discount": 0, "canceled": 0,
|
||||
"ship": 0, "qty": 0, "names": [], "opt": "", "statuses": []})
|
||||
for k in ("amount", "discount", "canceled", "ship", "qty"):
|
||||
o[k] += int(ln.get(k) or 0)
|
||||
if ln["name"] and ln["name"] not in o["names"]:
|
||||
o["names"].append(ln["name"])
|
||||
o["opt"] = o["opt"] or ln.get("opt") or ""
|
||||
if ln["status"] and ln["status"] not in o["statuses"]:
|
||||
o["statuses"].append(ln["status"])
|
||||
return orders
|
||||
|
||||
|
||||
class CoupangAdapter(MarketplaceAdapter):
|
||||
code = "coupang"
|
||||
name = "쿠팡(윙)"
|
||||
auth_type = "api_key"
|
||||
implemented = True
|
||||
replace_range = True
|
||||
event_prefix = EVENT_PREFIX
|
||||
docs_url = "https://developers.coupang.com/"
|
||||
note = ("쿠팡 윙 → 판매자정보 → 추가판매정보 → OPEN API 키 발급에서 확인합니다. 키는 판매자당 1개이며, "
|
||||
"'연동업체(사방넷 등)'로 발급한 키는 이 서버에서 막힐 수 있습니다 — 그때는 '자체개발'로 바꾸고 "
|
||||
"이 서버 IP 를 허용 IP 에 넣어야 합니다(연결 테스트로 확인). 매출은 판매자배송 + 로켓그로스 주문을 "
|
||||
"결제일로 합칩니다(WING 비즈니스 인사이트 → 판매분석 '매출'과 비교).")
|
||||
|
||||
def __init__(self) -> None:
|
||||
self._last_call = 0.0
|
||||
self._last_rg_call = 0.0
|
||||
|
||||
def credential_fields(self) -> list[CredentialField]:
|
||||
return [
|
||||
CredentialField("vendor_id", "Vendor ID(업체코드)", placeholder="A00012345"),
|
||||
CredentialField("access_key", "Access Key", secret=True),
|
||||
CredentialField("secret_key", "Secret Key", secret=True),
|
||||
]
|
||||
|
||||
# ── 호출 ──────────────────────────────────────────────
|
||||
def _vendor(self, ctx: AdapterContext) -> str:
|
||||
v = ctx.credentials.get("vendor_id").strip()
|
||||
if not v:
|
||||
raise NotConfigured("쿠팡 Vendor ID·Access Key·Secret Key 를 모두 입력하세요.")
|
||||
return v
|
||||
|
||||
def _get(self, ctx: AdapterContext, path: str, params: dict[str, Any], *, rg: bool = False) -> dict[str, Any]:
|
||||
"""GET — 호출 간격 유지(로켓그로스는 분당 50회), 429 는 잠깐 쉬고 다시."""
|
||||
import httpx # 지연 import
|
||||
|
||||
access, secret = ctx.credentials.get("access_key").strip(), ctx.credentials.get("secret_key").strip()
|
||||
if not (access and secret):
|
||||
raise NotConfigured("쿠팡 Vendor ID·Access Key·Secret Key 를 모두 입력하세요.")
|
||||
query = build_query(params)
|
||||
what = "로켓그로스 주문" if rg else "발주서"
|
||||
for attempt in range(RETRY_429 + 1):
|
||||
ctx.progress.check() # [업데이트 취소]면 여기서 멈춤
|
||||
gap = RG_CALL_INTERVAL_SEC if rg else CALL_INTERVAL_SEC
|
||||
last = self._last_rg_call if rg else self._last_call
|
||||
wait = gap - (time.monotonic() - last)
|
||||
if wait > 0:
|
||||
time.sleep(wait)
|
||||
headers = {"Authorization": authorization("GET", path, query, access, secret),
|
||||
"Content-Type": "application/json;charset=UTF-8"}
|
||||
try:
|
||||
res = httpx.get(f"{HOST}{path}?{query}", headers=headers, timeout=ctx.timeout_sec)
|
||||
except httpx.TimeoutException as exc:
|
||||
raise GatewayTimeout(f"쿠팡 {what} 응답 시간 초과: {type(exc).__name__}") from None
|
||||
except httpx.HTTPError as exc:
|
||||
raise ApiError(f"쿠팡 API 연결 실패: {type(exc).__name__}") from None
|
||||
finally:
|
||||
if rg:
|
||||
self._last_rg_call = time.monotonic()
|
||||
else:
|
||||
self._last_call = time.monotonic()
|
||||
if res.status_code == 429 and attempt < RETRY_429:
|
||||
time.sleep(2.0 * (2 ** attempt))
|
||||
continue
|
||||
try:
|
||||
body = res.json()
|
||||
except ValueError:
|
||||
if res.status_code < 400:
|
||||
# HTTP 200 이어도 JSON 이 아니면(점검·프록시 안내 페이지 등) 수집 실패 — 빈 목록으로 보면 기간 교체 때
|
||||
# 그 기간 매출이 지워진다(2026-10-15 검토 F01). 오류 응답(4xx·5xx)은 아래에서 글자로 안내한다.
|
||||
raise ApiError(f"쿠팡 {what} 응답이 JSON 이 아닙니다(HTTP {res.status_code}) — 점검 중일 수 있어 "
|
||||
"저장하지 않았습니다. 잠시 뒤 다시 시도하세요.") from None
|
||||
body = {}
|
||||
if not isinstance(body, dict):
|
||||
body = {"data": body}
|
||||
msg = str(body.get("message") or body.get("error") or res.text[:200] or "").strip()[:300]
|
||||
if res.status_code in (401, 403):
|
||||
raise AuthFailed(
|
||||
f"쿠팡 {what} 조회 거부({res.status_code}): {msg}. Vendor ID·키가 맞는지 확인하세요. 키를 '연동업체(사방넷 등)'로 "
|
||||
"발급했다면 이 서버에서 쓸 수 없을 수 있습니다 — WING 에서 '자체개발'로 바꾸고 이 서버 IP 를 허용 IP 에 "
|
||||
"넣어야 합니다(사방넷 IP 도 함께 넣어야 사방넷이 계속 동작).")
|
||||
if res.status_code == 429:
|
||||
raise ApiError(f"쿠팡 {what} 호출 제한(429)이 계속됩니다. 잠시 뒤 다시 시도하세요.")
|
||||
if res.status_code in (502, 503, 504):
|
||||
raise GatewayTimeout(f"쿠팡 {what} API 오류({res.status_code}): {msg}")
|
||||
if res.status_code >= 400:
|
||||
raise ApiError(f"쿠팡 {what} API 오류({res.status_code}): {msg}")
|
||||
code = body.get("code")
|
||||
if isinstance(code, int) and code >= 400:
|
||||
raise ApiError(f"쿠팡 {what} API 오류({code}): {msg}")
|
||||
return body
|
||||
raise ApiError(f"쿠팡 {what} 호출 제한(429)이 계속됩니다. 잠시 뒤 다시 시도하세요.")
|
||||
|
||||
@staticmethod
|
||||
def _page_rows(body: dict[str, Any], what: str) -> list[dict[str, Any]]:
|
||||
"""한 쪽의 주문 목록 — `data` 가 목록이어야 한다. 목록이 아니면 빈 목록(주문 0건)과 구분해 실패로(F01):
|
||||
`data` 가 없거나 다른 형식이면 오류, `data: null` 은 성공 표시(code 200·OK/SUCCESS)가 함께 있을 때만 빈 목록."""
|
||||
data = body.get("data")
|
||||
if isinstance(data, list):
|
||||
return [r for r in data if isinstance(r, dict)]
|
||||
code, msg = body.get("code"), str(body.get("message") or "").strip().upper()
|
||||
if "data" in body and data is None and (code in (200, "200") or msg in ("OK", "SUCCESS")):
|
||||
return []
|
||||
raise ApiError(f"쿠팡 {what} 응답 형식이 예상과 다릅니다(주문 목록 data 없음) — 저장하지 않았습니다. 잠시 뒤 다시 시도하세요.")
|
||||
|
||||
def _pages(self, ctx: AdapterContext, path: str, params: dict[str, Any], *, rg: bool = False) -> list[dict[str, Any]]:
|
||||
"""nextToken 으로 끝까지 받는다. 끝(다음 쪽 없음)을 확인하지 못하면 TooManyPages — 일부만 받은 목록으로
|
||||
기간을 교체하지 않게(2026-10-15 검토 F05). 부르는 쪽이 기간을 나눠 다시 부른다.
|
||||
- MAX_PAGES 를 다 써도 다음 쪽이 남음 · 같은 nextToken 이 다시 옴(커서 반복) → TooManyPages
|
||||
- 빈 쪽인데 다음 쪽이 있으면 따라간다(예전엔 거기서 끝난 것으로 봤다)"""
|
||||
what = "로켓그로스 주문" if rg else "발주서"
|
||||
out: list[dict[str, Any]] = []
|
||||
token: str | None = None
|
||||
seen: set[str] = set()
|
||||
for _ in range(MAX_PAGES):
|
||||
body = self._get(ctx, path, {**params, "nextToken": token} if token else params, rg=rg)
|
||||
out.extend(self._page_rows(body, what))
|
||||
nxt = str(body.get("nextToken") or "").strip()
|
||||
if not nxt:
|
||||
return out # 마지막 쪽 확인
|
||||
if nxt in seen:
|
||||
raise TooManyPages(f"쿠팡 {what} 다음 쪽 표시가 반복돼 끝까지 받았는지 확인할 수 없습니다 — 저장하지 않았습니다.")
|
||||
seen.add(nxt)
|
||||
token = nxt
|
||||
raise TooManyPages(f"쿠팡 {what} 한 번 조회가 {MAX_PAGES}쪽을 넘었습니다 — 일부만 받은 채 저장하지 않았습니다.")
|
||||
|
||||
def _seller_orders(self, ctx: AdapterContext, start: date, end: date) -> list[dict[str, Any]]:
|
||||
"""판매자배송 발주서 — 주문일 [start-1, end] 를 31일씩 × 상태 6개. 결제일 필터는 seller_lines 가.
|
||||
|
||||
건수가 많은 상태(배송완료 등)는 31일을 한 번에 부르면 쿠팡 서버가 504(시간 초과)를 낸다 — 그러면 그 구간을
|
||||
반으로 줄여 다시 부르고(하루까지), 줄인 크기는 같은 상태의 다음 구간에도 그대로 쓴다(매번 31일로 실패하지 않게)."""
|
||||
path = ORDERS_PATH.format(vendor=self._vendor(ctx))
|
||||
out: list[dict[str, Any]] = []
|
||||
size_by_status = {st: ORDER_SPAN_DAYS for st in STATUSES}
|
||||
for a, b in spans(start - timedelta(days=1), end, ORDER_SPAN_DAYS):
|
||||
for st in STATUSES:
|
||||
rows: list[dict[str, Any]] = []
|
||||
d, tries = a, 0
|
||||
while d <= b:
|
||||
e = min(b, d + timedelta(days=size_by_status[st] - 1))
|
||||
try:
|
||||
part = self._pages(ctx, path, {"createdAtFrom": f"{d.isoformat()}+09:00",
|
||||
"createdAtTo": f"{e.isoformat()}+09:00",
|
||||
"status": st, "maxPerPage": PAGE_SIZE})
|
||||
except GatewayTimeout as exc:
|
||||
if size_by_status[st] > 1:
|
||||
size_by_status[st] = max(1, size_by_status[st] // 2)
|
||||
continue
|
||||
tries += 1
|
||||
if tries <= RETRY_TIMEOUT_1DAY:
|
||||
time.sleep(3.0 * tries)
|
||||
continue
|
||||
raise ApiError(f"{exc.message} [주문일 {d.isoformat()} 하루도 시간 초과, 상태 {st}] "
|
||||
"— 잠시 뒤 다시 시도하세요.") from None
|
||||
except TooManyPages as exc: # 끝까지 못 받음 — 구간을 반으로(하루까지), 하루도 넘치면 실패
|
||||
if size_by_status[st] > 1:
|
||||
size_by_status[st] = max(1, size_by_status[st] // 2)
|
||||
continue
|
||||
raise ApiError(f"{exc.message} [주문일 {d.isoformat()} 하루, 상태 {st}]") from None
|
||||
except ApiError as exc: # 긴 기간을 나눠 부를 때 어느 구간에서 막혔는지 알 수 있게
|
||||
raise ApiError(f"{exc.message} [주문일 {d.isoformat()}~{e.isoformat()}, 상태 {st}]") from None
|
||||
rows.extend(part)
|
||||
d, tries = e + timedelta(days=1), 0
|
||||
out.extend(rows)
|
||||
ctx.progress.step(items=len(rows))
|
||||
return out
|
||||
|
||||
def _rg_orders(self, ctx: AdapterContext, start: date, end: date) -> list[dict[str, Any]]:
|
||||
path = RG_ORDERS_PATH.format(vendor=self._vendor(ctx))
|
||||
out: list[dict[str, Any]] = []
|
||||
for a, b in spans(start, end, RG_SPAN_DAYS):
|
||||
rows: list[dict[str, Any]] = []
|
||||
d, size, tries = a, RG_SPAN_DAYS, 0
|
||||
while d <= b: # 시간 초과면 판매자배송과 같이 구간을 반으로(하루까지)
|
||||
e = min(b, d + timedelta(days=size - 1))
|
||||
try:
|
||||
part = self._pages(ctx, path, {"paidDateFrom": d.strftime("%Y%m%d"),
|
||||
"paidDateTo": e.strftime("%Y%m%d")}, rg=True)
|
||||
except GatewayTimeout as exc:
|
||||
if size > 1:
|
||||
size = max(1, size // 2)
|
||||
continue
|
||||
tries += 1
|
||||
if tries <= RETRY_TIMEOUT_1DAY:
|
||||
time.sleep(3.0 * tries)
|
||||
continue
|
||||
raise ApiError(f"{exc.message} [로켓그로스 결제일 {d.isoformat()} 하루도 시간 초과] "
|
||||
"— 잠시 뒤 다시 시도하세요.") from None
|
||||
except TooManyPages as exc: # 끝까지 못 받음 — 구간을 반으로(하루까지), 하루도 넘치면 실패
|
||||
if size > 1:
|
||||
size = max(1, size // 2)
|
||||
continue
|
||||
raise ApiError(f"{exc.message} [로켓그로스 결제일 {d.isoformat()} 하루]") from None
|
||||
except ApiError as exc:
|
||||
raise ApiError(f"{exc.message} [로켓그로스 결제일 {d.isoformat()}~{e.isoformat()}]") from None
|
||||
rows.extend(part)
|
||||
d, tries = e + timedelta(days=1), 0
|
||||
out.extend(rows)
|
||||
ctx.progress.step(items=len(rows))
|
||||
return out
|
||||
|
||||
def _plan(self, ctx: AdapterContext, start: date, end: date) -> None:
|
||||
ctx.progress.plan(len(spans(start - timedelta(days=1), end, ORDER_SPAN_DAYS)) * len(STATUSES)
|
||||
+ len(spans(start, end, RG_SPAN_DAYS)), "조회")
|
||||
|
||||
# ── 수집 ──────────────────────────────────────────────
|
||||
def fetch_orders(self, ctx: AdapterContext, start: date, end: date) -> Iterable[dict[str, Any]]:
|
||||
self._plan(ctx, start, end)
|
||||
seller = seller_lines(self._seller_orders(ctx, start, end), start, end)
|
||||
rg = rg_lines(self._rg_orders(ctx, start, end), start, end)
|
||||
yield from group_lines(seller, EVENT_PREFIX).values()
|
||||
yield from group_lines(rg, RG_PREFIX).values()
|
||||
|
||||
def normalize_order(self, o: dict[str, Any]) -> list[SaleEvent]:
|
||||
oid, day = str(o.get("orderId") or ""), o.get("_day")
|
||||
if not oid or day is None:
|
||||
return []
|
||||
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 []]
|
||||
if o.get("canceled"):
|
||||
statuses.append("취소 포함")
|
||||
return [SaleEvent(
|
||||
event_type="SALE", external_event_id=str(o["event_id"]), 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)),
|
||||
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],
|
||||
)]
|
||||
|
||||
def test_connection(self, ctx: AdapterContext) -> str:
|
||||
from app.timezone import today_kst # noqa: WPS433
|
||||
|
||||
self.authenticate(ctx)
|
||||
vendor = self._vendor(ctx)
|
||||
today = today_kst()
|
||||
body = self._get(ctx, ORDERS_PATH.format(vendor=vendor),
|
||||
{"createdAtFrom": f"{today.isoformat()}+09:00", "createdAtTo": f"{today.isoformat()}+09:00",
|
||||
"status": "ACCEPT", "maxPerPage": 1})
|
||||
n = len(body.get("data") or [])
|
||||
rg = self._get(ctx, RG_ORDERS_PATH.format(vendor=vendor),
|
||||
{"paidDateFrom": today.strftime("%Y%m%d"), "paidDateTo": today.strftime("%Y%m%d")}, rg=True)
|
||||
m = len(rg.get("data") or [])
|
||||
return (f"쿠팡 연결 정상(판매자배송 발주서·로켓그로스 주문 조회 권한 확인 — 오늘 결제완료 발주서 {'있음' if n else '없음'}, "
|
||||
f"로켓그로스 오늘 주문 {m}건{'+' if rg.get('nextToken') else ''}).")
|
||||
|
||||
# ── 원본 데이터 확인(설정 화면 "쇼핑몰 원본 데이터 확인") ─────────
|
||||
def reconcile(self, ctx: AdapterContext, day: date, to: date | None = None) -> dict[str, Any]:
|
||||
"""결제일 기준 기간(최대 31일)의 판매자배송 발주서·로켓그로스 주문을 실제로 불러, 날짜별 후보 금액을 나란히 —
|
||||
WING 판매분석 '매출(원)'과 같은 열을 찾아 규칙을 확정하는 용도. 저장하지 않고, 개인정보 항목은 빼고 보여 준다."""
|
||||
self.authenticate(ctx)
|
||||
to = min(max(to or day, day), day + timedelta(days=PROBE_MAX_DAYS - 1))
|
||||
self._plan(ctx, day, to)
|
||||
probes: list[dict[str, Any]] = []
|
||||
seller_raw: list[dict[str, Any]] = []
|
||||
rg_raw: list[dict[str, Any]] = []
|
||||
try:
|
||||
seller_raw = self._seller_orders(ctx, day, to)
|
||||
probes.append({"key": "seller", "label": "판매자배송 발주서(주문일 하루 앞부터, 상태 6개)",
|
||||
"path": ORDERS_PATH.format(vendor="{vendorId}"), "ok": True, "count": len(seller_raw),
|
||||
"fields": field_summary([r for o in seller_raw for r in line_records(o)])})
|
||||
except AdapterError as exc:
|
||||
probes.append({"key": "seller", "label": "판매자배송 발주서", "path": ORDERS_PATH.format(vendor="{vendorId}"),
|
||||
"ok": False, "error": exc.message[:300]})
|
||||
try:
|
||||
rg_raw = self._rg_orders(ctx, day, to)
|
||||
probes.append({"key": "rg", "label": "로켓그로스 주문(결제일, 출고된 주문만)",
|
||||
"path": RG_ORDERS_PATH.format(vendor="{vendorId}"), "ok": True, "count": len(rg_raw),
|
||||
"fields": field_summary([{**flatten({k: v for k, v in o.items() if k != "orderItems"}),
|
||||
**flatten(it, "orderItems")}
|
||||
for o in rg_raw for it in (o.get("orderItems") or [{}])])})
|
||||
except AdapterError as exc:
|
||||
probes.append({"key": "rg", "label": "로켓그로스 주문", "path": RG_ORDERS_PATH.format(vendor="{vendorId}"),
|
||||
"ok": False, "error": exc.message[:300]})
|
||||
seller = seller_lines(seller_raw, day, to)
|
||||
rg = rg_lines(rg_raw, day, to)
|
||||
dates = [(day + timedelta(days=i)).isoformat() for i in range((to - day).days + 1)]
|
||||
|
||||
def per_day(lines: list[dict[str, Any]], fn: Any) -> dict[str, int]:
|
||||
out = {d: 0 for d in dates}
|
||||
for ln in lines:
|
||||
out[ln["_day"].isoformat()] += int(fn(ln))
|
||||
return out
|
||||
|
||||
def count(lines: list[dict[str, Any]], d: str) -> int:
|
||||
return len({ln["orderId"] for ln in lines if ln["_day"].isoformat() == d})
|
||||
|
||||
s_amt, s_net = per_day(seller, lambda x: x["amount"]), per_day(seller, lambda x: x["amount"] - x["discount"])
|
||||
s_live = per_day(seller, lambda x: x["amount"] - x["canceled"])
|
||||
s_qty, r_qty = per_day(seller, lambda x: x["qty"]), per_day(rg, lambda x: x["qty"])
|
||||
s_cancel, s_ship = per_day(seller, lambda x: x["canceled"]), per_day(seller, lambda x: x["ship"])
|
||||
r_amt = per_day(rg, lambda x: x["amount"])
|
||||
ok = {p["key"]: p["ok"] for p in probes}
|
||||
failed = {p["key"]: p.get("error", "") for p in probes if not p["ok"]}
|
||||
cands = [
|
||||
{"label": "① 현재 규칙: 판매자배송 판매가 + 로켓그로스", "days": {d: s_amt[d] + r_amt[d] for d in dates}},
|
||||
{"label": "② 판매자배송 판매가(쿠폰 할인 전)", "days": s_amt, "error": failed.get("seller")},
|
||||
{"label": "③ 판매자배송 할인 뒤(판매가 − 쿠폰·쿠팡 할인)", "days": s_net, "error": failed.get("seller")},
|
||||
{"label": "④ 판매자배송 취소분 뺀 판매가", "days": s_live, "error": failed.get("seller")},
|
||||
{"label": "⑤ 로켓그로스 단가 × 수량", "days": r_amt, "error": failed.get("rg")},
|
||||
{"label": "판매량: 판매자배송 + 로켓그로스(개)", "days": {d: s_qty[d] + r_qty[d] for d in dates}},
|
||||
]
|
||||
if not all(ok.values()):
|
||||
cands[0]["error"] = "일부 조회 실패 — 위 표 참고"
|
||||
days = [{"date": d, "orders": count(seller, d) + count(rg, d), "amount": s_amt[d] + r_amt[d],
|
||||
"claimed": s_cancel[d], "ship": s_ship[d]}
|
||||
for d in dates]
|
||||
return {"date": day.isoformat(), "to": to.isoformat(), "probes": probes, "days": days,
|
||||
"day_cols": {"amount": "매출(현재 규칙)", "claimed": "그중 판매자배송 취소분(참고)", "ship": "판매자배송 배송비(참고, 매출 제외)"},
|
||||
"refund_candidates": cands, "candidates_title": "매출 후보 비교 — WING 판매분석 '매출(원)'·'판매량'과 같은 열을 알려 주세요",
|
||||
"rule": "결제일(한국 시간) 기준 — 판매자배송 발주서 orderPrice(판매가 × 수량, 쿠폰 할인 전, 결제 뒤 취소분 포함) + "
|
||||
"로켓그로스 unitSalesPrice × salesQuantity(출고된 주문만). 배송비 제외"}
|
||||
@@ -0,0 +1,329 @@
|
||||
"""11번가 — 11번가 셀러 오픈API.
|
||||
|
||||
인증: 셀러오피스(openapi.11st.co.kr → 서비스등록·확인)에서 발급한 Open API Key 를 요청 헤더 `openapikey` 에 넣는다.
|
||||
셀러 API 는 등록한 IP 에서만 호출된다("Seller API 정보 수정"에서 서버 IP 등록, 셀링툴(사방넷 등)과 함께 쓸 수 있음).
|
||||
(공식 이용방법 openapi.11st.co.kr → OpenApiOperationGuide SERVICE_METHOD, 2026-09-30 확인)
|
||||
응답은 XML(euc-kr). 없는 주소는 500 + resultCode -997 "등록된 API 정보가 존재하지 않습니다", 건이 없으면 -1 "해당 건이 없습니다".
|
||||
|
||||
매출(2026-09-30 실데이터·셀러오피스 "판매 상세내역"으로 확정):
|
||||
- SALE = 주문 하나(`11st:{ordNo}`), 날짜 = 결제일.
|
||||
- 정산된 주문: 정산 내역(/rest/settlement/settlementList/{yyyyMMdd}/{yyyyMMdd}, 정산확정일 stlDy 기준)의
|
||||
판매금액합계(selPrcAmt) 합 — 판매 상세내역과 같고 배송비(도서산간 등)가 별도 줄로 들어 있다.
|
||||
예: 9/10 주문 = 83,800 + 배송비 줄 3,000 = 86,800 (주문 목록의 dlvCst 는 0 이라 주문 목록만으로는 모자람).
|
||||
- 정산 전 주문: 주문 상태 목록 4개(결제완료·발송대기·배송중·배송완료 — 지금 그 상태인 주문만, 배송완료에 구매확정 주문도
|
||||
남음)의 ordAmt(판매금액, 11번가 부담 쿠폰 전) + 배송비(dlvCst 최댓값 한 번). 정산되면 다음 업데이트 때 정산 값으로 바뀐다.
|
||||
- ordAmt − ordPayAmt = 11번가 부담 할인(= 정산 cupnAmt/tmallApplyDscAmt). 수수료는 판매금액 기준(34,900 × 13% = 4,537).
|
||||
- 취소·반품된 주문은 목록에서 빠진다 → 기간을 통째로 다시 받아(replace_range) 매출에서 빠진다(취소 사건을 따로 만들지 않음).
|
||||
"""
|
||||
|
||||
from __future__ import annotations
|
||||
|
||||
import re
|
||||
import xml.etree.ElementTree as ET
|
||||
from datetime import date, timedelta
|
||||
from typing import Any, Iterable
|
||||
|
||||
from .base import (
|
||||
AdapterContext,
|
||||
AdapterError,
|
||||
ApiError,
|
||||
AuthFailed,
|
||||
CredentialField,
|
||||
MarketplaceAdapter,
|
||||
SaleEvent,
|
||||
)
|
||||
|
||||
HOST = "https://api.11st.co.kr"
|
||||
|
||||
|
||||
def _xml_text(content: bytes) -> str:
|
||||
"""11번가 XML 은 euc-kr 선언이 많다 — 파이썬 XML 파서가 다바이트 인코딩 선언을 못 읽어 직접 풀고 선언을 뗀다."""
|
||||
head = content[:200].decode("ascii", "ignore")
|
||||
m = re.search(r"encoding=[\"']([\w-]+)", head)
|
||||
enc = (m.group(1) if m else "utf-8").lower()
|
||||
try:
|
||||
text = content.decode("cp949" if enc in ("euc-kr", "euckr", "ks_c_5601-1987") else enc)
|
||||
except (LookupError, UnicodeDecodeError):
|
||||
text = content.decode("utf-8", "replace")
|
||||
return re.sub(r"^\s*<\?xml[^>]*\?>", "", text)
|
||||
|
||||
|
||||
def xml_result(content: bytes) -> tuple[str, str, int]:
|
||||
"""(결과코드, 결과문구, 주문 수). 네임스페이스와 무관하게 태그 끝 이름으로 찾는다. XML 이 아니면 코드 "not-xml"."""
|
||||
try:
|
||||
root = ET.fromstring(_xml_text(content))
|
||||
except ET.ParseError:
|
||||
return "not-xml", "", 0
|
||||
if root.tag.rsplit("}", 1)[-1].lower() == "html": # 오류 안내 웹페이지(IP 차단 등)
|
||||
return "not-xml", "", 0
|
||||
code = text = ""
|
||||
orders = 0
|
||||
for el in root.iter():
|
||||
tag = el.tag.rsplit("}", 1)[-1].lower()
|
||||
if tag in ("result_code", "resultcode") and not code:
|
||||
code = (el.text or "").strip()
|
||||
elif tag in ("result_text", "resulttext", "result_message", "message") and not text:
|
||||
text = (el.text or "").strip()
|
||||
elif tag == "order":
|
||||
orders += 1
|
||||
return code, text, orders
|
||||
|
||||
|
||||
# 원본 데이터 확인용 후보 주소 — {s}/{e} = yyyyMMddHHmm, {d} = yyyyMMdd. 문서 미확인 경로가 섞여 있어
|
||||
# 404 등 실패도 그대로 보여 준다(어느 주소가 살아 있는지 확인하는 것이 목적).
|
||||
PROBE_PATHS: tuple[tuple[str, str, str], ...] = (
|
||||
("complete", "결제완료(발주확인 전)", "/rest/ordservices/complete/{s}/{e}"),
|
||||
("packaging", "발송처리 대상(발주확인 후)", "/rest/ordservices/packaging/{s}/{e}"),
|
||||
("shipping", "배송중", "/rest/ordservices/shipping/{s}/{e}"),
|
||||
("completed", "배송완료", "/rest/ordservices/completed/{s}/{e}"),
|
||||
("cancelorders", "취소신청", "/rest/claimservice/cancelorders/{s}/{e}"),
|
||||
("canceledorders", "취소완료", "/rest/claimservice/canceledorders/{s}/{e}"),
|
||||
("returnorders", "반품신청", "/rest/claimservice/returnorders/{s}/{e}"),
|
||||
("returnedorders", "반품완료", "/rest/claimservice/returnedorders/{s}/{e}"),
|
||||
("purchaseconfirm", "구매확정(후보)", "/rest/ordservices/purchaseconfirm/{s}/{e}"),
|
||||
("settlement", "정산 내역", "/rest/settlement/settlementList/{ds}/{de}"),
|
||||
)
|
||||
NO_DATA = re.compile(r"해당\s*건이\s*없|조회된?\s*(내역|건|데이터)이?\s*없") # 코드 -1 이어도 "0건"
|
||||
PROBE_CHUNK_DAYS = 7
|
||||
PROBE_MAX_DAYS = 31
|
||||
|
||||
# 개인정보로 보이는 항목 — 값은 보이지 않고 이름만(이름·연락처·주소·우편번호·아이디·메일·메모)
|
||||
PERSONAL = re.compile(r"(nm|name|tel|tlphn|phone|hp|addr|zip|mail|id|memo|msg|pcc|clearance|birth)$|rcvr|ordnm|buyer",
|
||||
re.IGNORECASE)
|
||||
NUMBER = re.compile(r"^-?\d+(\.\d+)?$")
|
||||
SAFE = re.compile(r"^(prd|opt|slct|dlvEtprs|dlvMthd|clm|reason|stl|sel)", re.IGNORECASE) # 상품·옵션·클레임 사유 등은 보임
|
||||
|
||||
|
||||
def xml_records(content: bytes) -> list[dict[str, str]]:
|
||||
"""응답에서 주문(또는 클레임·정산) 한 줄씩 — 자식이 모두 글자 항목인 요소를 한 줄로 본다(태그 끝 이름 → 값)."""
|
||||
try:
|
||||
root = ET.fromstring(_xml_text(content))
|
||||
except ET.ParseError:
|
||||
return []
|
||||
out: list[dict[str, str]] = []
|
||||
for el in root.iter():
|
||||
kids = list(el)
|
||||
if len(kids) >= 3 and all(len(k) == 0 for k in kids):
|
||||
out.append({k.tag.rsplit("}", 1)[-1]: (k.text or "").strip() for k in kids})
|
||||
return out
|
||||
|
||||
|
||||
def field_summary(records: list[dict[str, str]]) -> list[dict[str, Any]]:
|
||||
"""항목별: 채워진 줄 수, 숫자면 합계, 개인정보 아니면 예시 값 하나."""
|
||||
names: dict[str, dict[str, Any]] = {}
|
||||
for r in records:
|
||||
for k, v in r.items():
|
||||
f = names.setdefault(k, {"name": k, "filled": 0, "numeric": True, "sum": 0.0, "sample": "",
|
||||
"personal": bool(PERSONAL.search(k)) and not SAFE.match(k)})
|
||||
if not v:
|
||||
continue
|
||||
f["filled"] += 1
|
||||
if NUMBER.match(v) and f["numeric"]:
|
||||
f["sum"] += float(v)
|
||||
else:
|
||||
f["numeric"] = False
|
||||
if not f["sample"] and not f["personal"]:
|
||||
f["sample"] = v[:40]
|
||||
for f in names.values():
|
||||
f["sum"] = int(round(f["sum"])) if f["numeric"] and f["filled"] else None
|
||||
return list(names.values())
|
||||
|
||||
|
||||
# 매출 수집 — 주문 상태 목록 4개(지금 그 상태인 주문만 준다). 배송완료 목록에는 구매확정된 주문도 남는다(실데이터 확인).
|
||||
# 취소·반품된 주문은 이 목록들에서 빠진다 → 기간을 통째로 다시 받아(replace_range) 매출에서 자연히 빠지게 한다.
|
||||
ORDER_PATHS = ("/rest/ordservices/complete/{s}/{e}", "/rest/ordservices/packaging/{s}/{e}",
|
||||
"/rest/ordservices/shipping/{s}/{e}", "/rest/ordservices/completed/{s}/{e}")
|
||||
ORDER_STATUS = {"complete": "결제완료", "packaging": "발송대기", "shipping": "배송중", "completed": "배송완료"}
|
||||
# 목록의 날짜 조건이 주문일인지 상태 변경일(배송완료일 등)인지 문서로 확인 못 해, 기간 뒤로 넉넉히 더 불러
|
||||
# 주문일로 거른다(나중에 배송완료된 주문도 빠지지 않게).
|
||||
LOOKAHEAD_DAYS = 30
|
||||
SETTLE_LOOKAHEAD_DAYS = 45 # 결제 → 정산확정(구매확정)까지 보통 1~3주
|
||||
SETTLEMENT_PATH = "/rest/settlement/settlementList/{ds}/{de}"
|
||||
EVENT_PREFIX = "11st:"
|
||||
|
||||
|
||||
def _won(value: Any) -> int:
|
||||
try:
|
||||
return int(round(float(str(value or "0").replace(",", ""))))
|
||||
except ValueError:
|
||||
return 0
|
||||
|
||||
|
||||
def _day(value: Any) -> date | None:
|
||||
""""2026-09-09 15:13:16" / "2026/09/09" / "20260909" → date."""
|
||||
s = re.sub(r"[^0-9]", "", str(value or ""))[:8]
|
||||
if len(s) < 8:
|
||||
return None
|
||||
try:
|
||||
return date(int(s[:4]), int(s[4:6]), int(s[6:8]))
|
||||
except ValueError:
|
||||
return None
|
||||
|
||||
|
||||
def _n_chunks(lo: date, hi: date) -> int:
|
||||
return max(0, ((hi - lo).days + PROBE_CHUNK_DAYS) // PROBE_CHUNK_DAYS)
|
||||
|
||||
|
||||
class ElevenstAdapter(MarketplaceAdapter):
|
||||
code = "elevenst"
|
||||
name = "11번가"
|
||||
auth_type = "api_key"
|
||||
implemented = True
|
||||
replace_range = True
|
||||
event_prefix = EVENT_PREFIX
|
||||
docs_url = "https://openapi.11st.co.kr/"
|
||||
note = ("11번가 셀러오피스 → 오픈API 에서 발급한 키를 입력합니다. 셀러 API 는 등록한 IP 에서만 호출되므로 "
|
||||
"'Seller API 정보 수정 → IP 직접 입력'에 이 서버의 외부 IP 를 넣어야 합니다.")
|
||||
|
||||
def credential_fields(self) -> list[CredentialField]:
|
||||
return [
|
||||
CredentialField("api_key", "Open API Key", secret=True),
|
||||
]
|
||||
|
||||
# ── 수집 ──────────────────────────────────────────────
|
||||
def _pages(self, ctx: AdapterContext, tmpl: str, lo: date, hi: date) -> Iterable[dict[str, str]]:
|
||||
"""[lo, hi] 를 7일씩 나눠 한 주소를 부른다."""
|
||||
s = lo
|
||||
while s <= hi:
|
||||
e = min(hi, s + timedelta(days=PROBE_CHUNK_DAYS - 1))
|
||||
ds, de = s.strftime("%Y%m%d"), e.strftime("%Y%m%d")
|
||||
rows = xml_records(self._get(ctx, tmpl.format(s=f"{ds}0000", e=f"{de}2359", ds=ds, de=de)))
|
||||
ctx.progress.step(items=len(rows))
|
||||
yield from rows
|
||||
s = e + timedelta(days=1)
|
||||
|
||||
def fetch_orders(self, ctx: AdapterContext, start: date, end: date) -> Iterable[dict[str, Any]]:
|
||||
"""결제일이 [start, end] 인 주문을 주문 단위로 합쳐 돌려준다.
|
||||
1) 정산 내역 — 정산확정일 기준이라 [start, end+45일(오늘까지)] 를 불러 결제일(ordStlEndDt)로 거른다.
|
||||
판매금액합계(selPrcAmt)는 셀러오피스 "판매 상세내역"과 같고 배송비 줄(도서산간 등)도 따로 들어 있다.
|
||||
2) 아직 정산 전인 주문 — 주문 상태 목록 4개([start, end+30일]) 의 ordAmt + 배송비(dlvCst 최댓값 한 번).
|
||||
같은 주문이 정산에 있으면 정산 값을 쓴다(정산되면 다음 업데이트 때 정산 값으로 바뀜)."""
|
||||
from app.timezone import today_kst # noqa: WPS433
|
||||
|
||||
today = today_kst()
|
||||
orders: dict[str, dict[str, Any]] = {}
|
||||
|
||||
def acc(oid: str, src: str, day: date) -> dict[str, Any]:
|
||||
return orders.setdefault(oid, {"ordNo": oid, "_src": src, "_day": day, "amount": 0, "qty": 0,
|
||||
"discount": 0, "ship": 0, "names": [], "opt": "", "raw": {}})
|
||||
|
||||
settle_hi = max(end, min(end + timedelta(days=SETTLE_LOOKAHEAD_DAYS), today))
|
||||
hi = max(end, min(end + timedelta(days=LOOKAHEAD_DAYS), today))
|
||||
# 진행 막대: 7일 구간마다 한 번 — 정산 내역 + 주문 상태 목록 4개
|
||||
ctx.progress.plan(_n_chunks(start, settle_hi) + len(ORDER_PATHS) * _n_chunks(start, hi), "구간")
|
||||
for r in self._pages(ctx, SETTLEMENT_PATH, start, settle_hi):
|
||||
oid, day = str(r.get("ordNo") or ""), _day(r.get("ordStlEndDt"))
|
||||
if not oid or day is None or not (start <= day <= end):
|
||||
continue
|
||||
o = acc(oid, "settlement", day)
|
||||
o["amount"] += _won(r.get("selPrcAmt"))
|
||||
o["qty"] += _won(r.get("ordQty"))
|
||||
o["discount"] += _won(r.get("cupnAmt"))
|
||||
if r.get("prdNm") and r["prdNm"] not in o["names"]:
|
||||
o["names"].append(r["prdNm"])
|
||||
o["opt"] = o["opt"] or str(r.get("slctPrdOptNm") or "")
|
||||
for k in ("stlAmt", "selFee", "deductAmt", "bmStlDlvCst"):
|
||||
o["raw"][k] = o["raw"].get(k, 0) + _won(r.get(k))
|
||||
o["raw"]["stlDy"] = r.get("stlDy")
|
||||
settled = set(orders)
|
||||
|
||||
seen: set[str] = set()
|
||||
for tmpl in ORDER_PATHS:
|
||||
status = ORDER_STATUS[tmpl.split("/")[3]]
|
||||
for r in self._pages(ctx, tmpl, start, hi):
|
||||
oid = str(r.get("ordNo") or "")
|
||||
key = f"{oid}-{r.get('ordPrdSeq')}"
|
||||
day = _day(r.get("ordStlEndDt") or r.get("ordDt"))
|
||||
if not oid or oid in settled or key in seen or day is None or not (start <= day <= end):
|
||||
continue
|
||||
seen.add(key)
|
||||
o = acc(oid, status, day)
|
||||
o["amount"] += _won(r.get("ordAmt"))
|
||||
o["ship"] = max(o["ship"], _won(r.get("dlvCst")))
|
||||
o["qty"] += _won(r.get("ordQty"))
|
||||
o["discount"] += max(0, _won(r.get("ordAmt")) - _won(r.get("ordPayAmt")))
|
||||
if r.get("prdNm") and r["prdNm"] not in o["names"]:
|
||||
o["names"].append(r["prdNm"])
|
||||
o["opt"] = o["opt"] or str(r.get("slctPrdOptNm") or "")
|
||||
o["raw"]["ordDt"] = r.get("ordDt")
|
||||
for o in orders.values():
|
||||
o["amount"] += o.pop("ship")
|
||||
yield o
|
||||
|
||||
def normalize_order(self, o: dict[str, Any]) -> list[SaleEvent]:
|
||||
"""주문 하나 → SALE(결제일). 금액 = 정산 판매금액합계(정산 전이면 ordAmt + 배송비) — 11번가 부담 쿠폰 전 금액.
|
||||
수수료가 판매금액 기준이라(34,900 × 13% = 4,537, 정산 실데이터) 판매자 매출은 할인 전 금액으로 본다."""
|
||||
oid, day = str(o.get("ordNo") or ""), o.get("_day")
|
||||
if not oid or day is None:
|
||||
return []
|
||||
names = o.get("names") or []
|
||||
name = names[0] + (f" 외 {len(names) - 1}건" if len(names) > 1 else "") if names else ""
|
||||
return [SaleEvent(
|
||||
event_type="SALE", external_event_id=f"{EVENT_PREFIX}{oid}", external_order_id=oid,
|
||||
payment_date=day, event_date=day, amount=max(0, int(o.get("amount") or 0)),
|
||||
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="정산확정" if o.get("_src") == "settlement" else str(o.get("_src") or ""),
|
||||
raw={"source": o.get("_src"), **(o.get("raw") or {})},
|
||||
)]
|
||||
|
||||
def _get(self, ctx: AdapterContext, path: str) -> bytes:
|
||||
import httpx # 지연 import
|
||||
|
||||
ctx.progress.check() # [업데이트 취소]면 여기서 멈춤
|
||||
headers = {"openapikey": ctx.credentials.get("api_key").strip(), "Accept": "application/xml"}
|
||||
try:
|
||||
res = httpx.get(f"{HOST}{path}", headers=headers, timeout=ctx.timeout_sec)
|
||||
except httpx.HTTPError as exc:
|
||||
raise ApiError(f"11번가 API 연결 실패: {type(exc).__name__} — 등록한 IP 가 이 서버 IP 인지 확인하세요.") from None
|
||||
code, text, _ = xml_result(res.content)
|
||||
detail = text or res.text[:200].strip()
|
||||
if res.status_code in (401, 403):
|
||||
raise AuthFailed(f"11번가 인증 거부({res.status_code}): {detail}. 키와 등록 IP(이 서버 외부 IP)를 확인하세요.")
|
||||
if res.status_code >= 400:
|
||||
raise ApiError(f"11번가 API 오류({res.status_code}): {detail}")
|
||||
if code == "not-xml":
|
||||
raise ApiError(f"11번가가 예상하지 못한 응답을 돌려줬습니다(XML 아님): {res.text[:120].strip()}")
|
||||
if code and code not in ("0", "200", "00") and not NO_DATA.search(text):
|
||||
raise ApiError(f"11번가 API 오류(코드 {code}): {detail}")
|
||||
return res.content
|
||||
|
||||
# ── 원본 데이터 확인(설정 화면 "11번가 원본 데이터 확인") ─────────
|
||||
def reconcile(self, ctx: AdapterContext, day: date, to: date | None = None) -> dict[str, Any]:
|
||||
"""후보 조회 주소마다 기간(day~to, 최대 31일, 7일씩 나눠)을 실제로 불러 동작 여부·줄 수·항목별 합계를 돌려준다.
|
||||
셀러 API 상세 문서가 로그인 뒤에만 있어, 어느 주소·항목이 셀러오피스 화면 매출과 맞는지 실데이터로 확정하는 용도.
|
||||
개인정보 항목(이름·연락처·주소·아이디 등)은 값 없이 이름만."""
|
||||
self.authenticate(ctx)
|
||||
to = min(max(to or day, day), day + timedelta(days=PROBE_MAX_DAYS - 1))
|
||||
chunks = []
|
||||
s = day
|
||||
while s <= to:
|
||||
e = min(to, s + timedelta(days=PROBE_CHUNK_DAYS - 1))
|
||||
chunks.append((s, e))
|
||||
s = e + timedelta(days=1)
|
||||
out = []
|
||||
for key, label, tmpl in PROBE_PATHS:
|
||||
row: dict[str, Any] = {"key": key, "label": label, "path": tmpl.split("/{")[0] + "/…"}
|
||||
records: list[dict[str, str]] = []
|
||||
error = ""
|
||||
for s, e in chunks:
|
||||
ds, de = s.strftime("%Y%m%d"), e.strftime("%Y%m%d")
|
||||
try:
|
||||
records += xml_records(self._get(ctx, tmpl.format(s=f"{ds}0000", e=f"{de}2359", ds=ds, de=de)))
|
||||
except AdapterError as exc:
|
||||
error = exc.message[:200]
|
||||
break
|
||||
if error:
|
||||
out.append({**row, "ok": False, "error": error})
|
||||
else:
|
||||
out.append({**row, "ok": True, "count": len(records), "fields": field_summary(records)})
|
||||
return {"date": day.isoformat(), "to": to.isoformat(), "probes": out}
|
||||
|
||||
def test_connection(self, ctx: AdapterContext) -> str:
|
||||
from app.timezone import today_kst # noqa: WPS433
|
||||
|
||||
self.authenticate(ctx)
|
||||
d = today_kst().strftime("%Y%m%d")
|
||||
body = self._get(ctx, f"/rest/ordservices/complete/{d}0000/{d}2359")
|
||||
_, _, orders = xml_result(body)
|
||||
return f"11번가 연결 정상(주문 조회 권한 확인, 오늘 결제완료 {orders}건)."
|
||||
@@ -0,0 +1,23 @@
|
||||
"""G마켓 — ESM(ESM Plus / ESM Trading API).
|
||||
|
||||
인증: ESM 마스터 ID + 판매자 ID + 발급 Secret Key 로 JWT 서명(연동 단계에서 확정).
|
||||
"""
|
||||
|
||||
from __future__ import annotations
|
||||
|
||||
from .base import CredentialField, MarketplaceAdapter
|
||||
|
||||
|
||||
class GmarketAdapter(MarketplaceAdapter):
|
||||
code = "gmarket"
|
||||
name = "G마켓"
|
||||
auth_type = "api_key"
|
||||
docs_url = "https://etapi.gmarket.com/"
|
||||
note = "ESM Plus 에서 발급한 API 인증정보를 입력합니다."
|
||||
|
||||
def credential_fields(self) -> list[CredentialField]:
|
||||
return [
|
||||
CredentialField("master_id", "ESM 마스터 ID"),
|
||||
CredentialField("seller_id", "G마켓 판매자 ID"),
|
||||
CredentialField("secret_key", "Secret Key", secret=True),
|
||||
]
|
||||
@@ -0,0 +1,318 @@
|
||||
"""GS샵 — GSSHOP 제휴 API(협력사 API V3, partners.gsshop.com → 제휴 API → 개발가이드).
|
||||
|
||||
인증(개발가이드 2026-09-30 확인): 요청 헤더
|
||||
supCd = 협력사코드
|
||||
token = AES256( Sysdate("yyyyMMddHHmmss") + 협력사코드 ) 예: "20181017174913" + "1036018"
|
||||
AES256 암복호화 키는 partners.gsshop.com/api/apiMain 에 로그인하면 보인다.
|
||||
암호화 모드(CBC/ECB, IV)와 키를 바이트로 쓰는 법은 문서에 없다 → 키 변형(글자 그대로 / 16진수 풀기 / 앞 32자,
|
||||
key_variants) × 모드(CBC·IV=키 앞 16바이트 → ECB → CBC·IV=0) 순서로 시도하고 통과한 조합을 기억한다. 출력은 base64.
|
||||
(포털 "운영 KEY" 는 16진수처럼 보이는 글자 — 32자면 글자 그대로 AES256, 64자면 16진수로 풀어 32바이트일 수 있다.)
|
||||
token 이 틀리면 HTTP 200 + {"result":"fail","message":"키 인증 중 오류…","code":"401 UNAUTHORIZED"}.
|
||||
주소: 운영 https://withgs-api.gsshop.com (개발가이드의 예시 주소 atwithgs-api 는 테스트용 — 두 곳 모두 응답 확인).
|
||||
|
||||
매출(Settlement API 1.0): GET /api/v2/settlement/out/sales/period?supCode=&fromDate=&toDate=&pageIdx=&rowsPerPage=
|
||||
— 매출인식일(YYYYMMDD) 기준, 한 번에 10일까지, 쪽당 최대 1만 건. 응답 {data:[…], hasMorePage, totalCount, …}.
|
||||
배송비는 /api/v2/settlement/out/sales/shippingFee/period(같은 조건).
|
||||
응답 줄 항목(2026-09-30 실데이터 9/3 — 개발가이드 예시에는 없음): saleAwareDt(매출인식일), ordNo·ordItemNo·orgOrdNo,
|
||||
ordType(SALE …), prdCd·prdNm, chrQty(수량), salePrice(할인 전 판매가 — 줄 합계), dcTotAmt(할인 합계),
|
||||
custChrAmt(고객 결제금액 = salePrice − dcTotAmt), supGiveAmt(협력사 지급액, 수수료 차감), sup*DcAmt(협력사 부담 할인).
|
||||
9/3: salePrice 211,100 − dcTotAmt 19,528 = custChrAmt 191,572, supGiveAmt 179,435, 배송비 내역 7,000.
|
||||
**주문일 기준 조회 API 는 없다**(V3 문서에 주문 조회 없음) — 협력사 포털 주문 통계(총주문금액, 주문일)와는 기준이 달라
|
||||
날짜별로 똑같이 맞출 수 없다.
|
||||
|
||||
매출 규칙 — 협력사 포털 주문 통계의 금액 = **supGiveAmt(협력사 지급액)**(2026-09-30, 9월 실데이터로 확인):
|
||||
미라미라클 6호세트 포털 176,715 ÷ 9 = 19,635 = API 줄 supGiveAmt 19,635(판매가 23,100·고객 결제 20,330),
|
||||
7호세트 39,015 = 45,900 × 85%, 주부체험 세트 8,910 = 9,900 × 90% — 상품마다 GS 수수료율이 달라 판매가 × 요율로는 못 맞춘다.
|
||||
9/1~9/29: 지급액 4,972,689 / 포털 순주문 4,823,074(차이는 주문일 ↔ 매출인식일 기준 차이·취소분).
|
||||
- 매출 내역 한 줄 = 사건 하나(`gs:{ordNo}-{ordItemNo}-{ordType}-{saleAwareDt}`), 날짜 = 매출인식일.
|
||||
- 금액 = supGiveAmt, 배송비 제외. 이미 GS 수수료를 뺀 금액이라 **실적 설정의 GS샵 수수료율은 0%** 로 둔다.
|
||||
ordType 이 SALE 이 아니면(취소·반품 등) 음수로(RETURN). 할인 = dcTotAmt. 기간을 통째로 다시 받는다(replace_range).
|
||||
"""
|
||||
|
||||
from __future__ import annotations
|
||||
|
||||
import base64
|
||||
from datetime import date, datetime, timedelta
|
||||
from typing import Any, Iterable
|
||||
|
||||
from .base import (
|
||||
credential_fingerprint,
|
||||
AdapterContext,
|
||||
AdapterError,
|
||||
ApiError,
|
||||
AuthFailed,
|
||||
CredentialField,
|
||||
MarketplaceAdapter,
|
||||
NotConfigured,
|
||||
SaleEvent,
|
||||
)
|
||||
from .elevenst import field_summary
|
||||
|
||||
HOST = "https://withgs-api.gsshop.com"
|
||||
SALES_PATH = "/api/v2/settlement/out/sales/period"
|
||||
SHIPPING_PATH = "/api/v2/settlement/out/sales/shippingFee/period"
|
||||
DAILY_SALES_PATH = "/api/v2/settlement/out/sales"
|
||||
CHUNK_DAYS = 10 # 기간 조회는 시작일부터 10일 이내
|
||||
ROWS_PER_PAGE = 10000
|
||||
MAX_PAGES = 50
|
||||
PROBE_MAX_DAYS = 31
|
||||
TOKEN_MODES = ("cbc-keyiv", "ecb", "cbc-zeroiv")
|
||||
MODE_LABEL = {"cbc-keyiv": "AES/CBC(IV=키 앞 16바이트)", "ecb": "AES/ECB", "cbc-zeroiv": "AES/CBC(IV=0)"}
|
||||
|
||||
|
||||
KEY_LABEL = {"text": "키 글자 그대로", "hex": "키 16진수 풀기", "first32": "키 앞 32자"}
|
||||
|
||||
|
||||
def key_variants(aes_key: str) -> list[tuple[str, bytes]]:
|
||||
"""AES 키로 쓸 수 있는 바이트 후보(시도 순서). 하나도 없으면 길이 오류."""
|
||||
raw = aes_key.strip().encode("utf-8")
|
||||
out: list[tuple[str, bytes]] = []
|
||||
if len(raw) in (16, 24, 32):
|
||||
out.append(("text", raw))
|
||||
txt = aes_key.strip()
|
||||
if len(txt) in (32, 48, 64) and all(c in "0123456789abcdefABCDEF" for c in txt):
|
||||
out.append(("hex", bytes.fromhex(txt)))
|
||||
if len(raw) > 32:
|
||||
out.append(("first32", raw[:32]))
|
||||
if not out:
|
||||
raise AuthFailed(f"AES 키 길이가 올바르지 않습니다({len(raw)}자). 제휴 API 메인 화면의 운영 KEY 를 "
|
||||
"[복사] 버튼으로 복사해 그대로 붙여 넣으세요.")
|
||||
return out
|
||||
|
||||
|
||||
def make_token(aes_key: str | bytes, sup_cd: str, now: datetime, mode: str) -> str:
|
||||
"""token = base64(AES(yyyyMMddHHmmss + 협력사코드)), PKCS7(=PKCS5) 패딩. aes_key 가 글자면 그대로 바이트로."""
|
||||
from cryptography.hazmat.primitives import padding # 지연 import
|
||||
from cryptography.hazmat.primitives.ciphers import Cipher, algorithms, modes
|
||||
|
||||
key = aes_key if isinstance(aes_key, bytes) else aes_key.encode("utf-8")
|
||||
if len(key) not in (16, 24, 32):
|
||||
raise AuthFailed(f"AES 키 길이가 올바르지 않습니다({len(key)}바이트 — 16·24·32 중 하나여야 함). "
|
||||
"제휴 API 메인 화면의 키를 그대로 붙여 넣으세요.")
|
||||
plain = (now.strftime("%Y%m%d%H%M%S") + sup_cd).encode("utf-8")
|
||||
padder = padding.PKCS7(128).padder()
|
||||
data = padder.update(plain) + padder.finalize()
|
||||
if mode == "ecb":
|
||||
cipher = Cipher(algorithms.AES(key), modes.ECB())
|
||||
elif mode == "cbc-zeroiv":
|
||||
cipher = Cipher(algorithms.AES(key), modes.CBC(b"\0" * 16))
|
||||
else:
|
||||
cipher = Cipher(algorithms.AES(key), modes.CBC(key[:16]))
|
||||
enc = cipher.encryptor()
|
||||
return base64.b64encode(enc.update(data) + enc.finalize()).decode("ascii")
|
||||
|
||||
|
||||
def _rows(body: dict[str, Any]) -> list[dict[str, Any]]:
|
||||
data = body.get("data")
|
||||
return [r for r in data if isinstance(r, dict)] if isinstance(data, list) else []
|
||||
|
||||
|
||||
def _strs(row: dict[str, Any]) -> dict[str, str]:
|
||||
"""원본 확인용 — 값은 모두 글자로(중첩은 JSON 글자 그대로 짧게)."""
|
||||
return {str(k): ("" if v is None else str(v)) for k, v in row.items()}
|
||||
|
||||
|
||||
EVENT_PREFIX = "gs:"
|
||||
|
||||
|
||||
def _won(value: Any) -> int:
|
||||
try:
|
||||
return int(round(float(str(value if value is not None else 0).replace(",", ""))))
|
||||
except ValueError:
|
||||
return 0
|
||||
|
||||
|
||||
def _yyyymmdd(value: Any) -> date | None:
|
||||
s = "".join(ch for ch in str(value or "") if ch.isdigit())[:8]
|
||||
if len(s) < 8:
|
||||
return None
|
||||
try:
|
||||
return date(int(s[:4]), int(s[4:6]), int(s[6:8]))
|
||||
except ValueError:
|
||||
return None
|
||||
|
||||
|
||||
class GsshopAdapter(MarketplaceAdapter):
|
||||
code = "gsshop"
|
||||
name = "GS샵"
|
||||
auth_type = "api_key"
|
||||
implemented = True
|
||||
replace_range = True
|
||||
event_prefix = EVENT_PREFIX
|
||||
docs_url = "https://partners.gsshop.com/api/apiDevGuide"
|
||||
note = ("GS SHOP 협력사 포털(partners.gsshop.com) → 제휴 API 메인 화면의 협력사코드와 "
|
||||
"운영 KEY(오른쪽 [복사] 버튼)를 입력합니다. 개발 KEY 가 아니라 운영 KEY 입니다.")
|
||||
|
||||
def __init__(self) -> None:
|
||||
# (협력사코드·운영 KEY 지문) → 통과한 (키 변형, 암호화 모드). 키를 바꾸면 예전 방식을 쓰지 않는다(검토 F04)
|
||||
self._mode: dict[str, tuple[str, str]] = {}
|
||||
|
||||
def credential_fields(self) -> list[CredentialField]:
|
||||
# 키 이름(vendor_code·api_key)은 처음 만든 입력칸 그대로 — 이미 저장한 값을 다시 넣지 않아도 되게.
|
||||
return [
|
||||
CredentialField("vendor_code", "협력사코드(supCd)", help="예: 1036018"),
|
||||
CredentialField("api_key", "운영 KEY(AES256 암복호화 키)", secret=True,
|
||||
help="제휴 API 메인 화면의 운영 KEY — [복사] 버튼으로 복사해 붙여 넣기"),
|
||||
]
|
||||
|
||||
# ── 호출 ──────────────────────────────────────────────
|
||||
def _creds(self, ctx: AdapterContext) -> tuple[str, str]:
|
||||
sup = ctx.credentials.get("vendor_code").strip()
|
||||
key = ctx.credentials.get("api_key").strip()
|
||||
if not sup or not key:
|
||||
raise NotConfigured("협력사코드와 AES256 키를 입력하세요.")
|
||||
return sup, key
|
||||
|
||||
def _call(self, ctx: AdapterContext, path: str, params: dict[str, Any], how: tuple[str, str]) -> dict[str, Any]:
|
||||
import httpx # 지연 import
|
||||
|
||||
from app.timezone import now_kst # noqa: WPS433
|
||||
|
||||
ctx.progress.check() # [업데이트 취소]면 여기서 멈춤
|
||||
sup, key = self._creds(ctx)
|
||||
key_bytes = dict(key_variants(key))[how[0]]
|
||||
headers = {"supCd": sup, "token": make_token(key_bytes, sup, now_kst(), how[1]), "Accept": "application/json"}
|
||||
try:
|
||||
res = httpx.get(f"{HOST}{path}", params={"supCode": sup, **params}, headers=headers, timeout=ctx.timeout_sec)
|
||||
except httpx.HTTPError as exc:
|
||||
raise ApiError(f"GS샵 API 연결 실패: {type(exc).__name__}") from None
|
||||
try:
|
||||
body = res.json()
|
||||
except ValueError:
|
||||
raise ApiError(f"GS샵이 예상하지 못한 응답을 돌려줬습니다({res.status_code}): {res.text[:150].strip()}") from None
|
||||
if not isinstance(body, dict):
|
||||
body = {"data": body}
|
||||
code = str(body.get("code") or "")
|
||||
msg = str(body.get("message") or "")[:200]
|
||||
if res.status_code in (401, 403) or (str(body.get("result")) == "fail" and ("401" in code or "403" in code)):
|
||||
raise AuthFailed(f"GS샵 인증 거부({code or res.status_code}): {msg}")
|
||||
if res.status_code >= 400 or str(body.get("result")) == "fail":
|
||||
raise ApiError(f"GS샵 API 오류({code or res.status_code}): {msg or res.text[:150].strip()}")
|
||||
return body
|
||||
|
||||
def _get(self, ctx: AdapterContext, path: str, params: dict[str, Any]) -> dict[str, Any]:
|
||||
"""토큰 만드는 법(키 변형 × 암호화 모드)을 모르면 순서대로 시도 — 통과한 조합을 기억한다."""
|
||||
sup, key = self._creds(ctx)
|
||||
mode_key = self._mode_key(ctx)
|
||||
known = self._mode.get(mode_key)
|
||||
if known:
|
||||
return self._call(ctx, path, params, known)
|
||||
tries = [(v, m) for v, _ in key_variants(key) for m in TOKEN_MODES]
|
||||
last: AuthFailed | None = None
|
||||
for how in tries:
|
||||
try:
|
||||
body = self._call(ctx, path, params, how)
|
||||
except AuthFailed as exc:
|
||||
last = exc
|
||||
continue
|
||||
self._mode[mode_key] = how
|
||||
return body
|
||||
raise AuthFailed(f"{last.message if last else 'GS샵 인증 실패'} — 토큰 만드는 방식 {len(tries)}가지 모두 거부. "
|
||||
"협력사코드·운영 KEY 가 맞는지, 서버 시각이 정확한지 확인하세요.")
|
||||
|
||||
def _pages(self, ctx: AdapterContext, path: str, lo: date, hi: date) -> list[dict[str, Any]]:
|
||||
"""[lo, hi] 를 10일씩 나눠 쪽을 넘겨 모두 받는다."""
|
||||
out: list[dict[str, Any]] = []
|
||||
s = lo
|
||||
while s <= hi:
|
||||
e = min(hi, s + timedelta(days=CHUNK_DAYS - 1))
|
||||
for page in range(1, MAX_PAGES + 1):
|
||||
body = self._get(ctx, path, {"fromDate": s.strftime("%Y%m%d"), "toDate": e.strftime("%Y%m%d"),
|
||||
"pageIdx": page, "rowsPerPage": ROWS_PER_PAGE})
|
||||
rows = _rows(body)
|
||||
out.extend(rows)
|
||||
if not body.get("hasMorePage") or not rows:
|
||||
break
|
||||
else: # 쪽 수 상한을 다 썼는데 아직 다음 쪽이 있음 — 일부만 받은 채 기간을 교체하지 않게(검토 F05)
|
||||
raise ApiError(f"GS샵 {s.isoformat()}~{e.isoformat()} 조회가 {MAX_PAGES}쪽을 넘어 끝까지 받지 못했습니다 — "
|
||||
"저장하지 않았습니다.")
|
||||
ctx.progress.step(items=len(out))
|
||||
s = e + timedelta(days=1)
|
||||
return out
|
||||
|
||||
# ── 수집 ──────────────────────────────────────────────
|
||||
def fetch_orders(self, ctx: AdapterContext, start: date, end: date) -> Iterable[dict[str, Any]]:
|
||||
"""매출인식일이 [start, end] 인 매출 내역 줄. 같은 사건 ID 가 두 번 나오면 뒤에 번호를 붙여 둘 다 남긴다."""
|
||||
ctx.progress.plan(max(1, ((end - start).days + CHUNK_DAYS) // CHUNK_DAYS), "구간")
|
||||
seen: dict[str, int] = {}
|
||||
for r in self._pages(ctx, SALES_PATH, start, end):
|
||||
day = _yyyymmdd(r.get("saleAwareDt"))
|
||||
if day is None or not (start <= day <= end):
|
||||
continue
|
||||
base = f"{r.get('ordNo')}-{r.get('ordItemNo')}-{r.get('ordType') or 'SALE'}-{day.strftime('%Y%m%d')}"
|
||||
n = seen.get(base, 0)
|
||||
seen[base] = n + 1
|
||||
yield {**r, "_day": day, "_id": base if n == 0 else f"{base}-{n + 1}"}
|
||||
|
||||
def normalize_order(self, r: dict[str, Any]) -> list[SaleEvent]:
|
||||
"""매출 내역 한 줄 → SALE(ordType=SALE) 또는 RETURN(그 밖, 음수). 금액 = supGiveAmt(협력사 지급액 — 포털 주문 통계 금액)."""
|
||||
oid, day = str(r.get("ordNo") or ""), r.get("_day")
|
||||
if not oid or day is None:
|
||||
return []
|
||||
kind = str(r.get("ordType") or "SALE").upper()
|
||||
amount = abs(_won(r.get("supGiveAmt")))
|
||||
is_sale = kind == "SALE"
|
||||
return [SaleEvent(
|
||||
event_type="SALE" if is_sale else "RETURN", external_event_id=f"{EVENT_PREFIX}{r['_id']}",
|
||||
external_order_id=oid, external_line_id=str(r.get("ordItemNo") or ""), event_date=day,
|
||||
payment_date=day if is_sale else None, amount=amount if is_sale else -amount,
|
||||
product_name=str(r.get("prdNm") or "")[:200], quantity=abs(_won(r.get("chrQty"))),
|
||||
discount_amount=abs(_won(r.get("dcTotAmt"))), order_status=kind[:50],
|
||||
raw={"salePrice": _won(r.get("salePrice")), "custChrAmt": _won(r.get("custChrAmt")),
|
||||
"orgOrdNo": str(r.get("orgOrdNo") or ""), "prdCd": str(r.get("prdCd") or "")},
|
||||
)]
|
||||
|
||||
def test_connection(self, ctx: AdapterContext) -> str:
|
||||
from app.timezone import today_kst # noqa: WPS433
|
||||
|
||||
self.authenticate(ctx)
|
||||
sup, _ = self._creds(ctx)
|
||||
self._mode.pop(self._mode_key(ctx), None) # 입력값을 바꿨을 수 있으니 모드를 다시 찾는다
|
||||
day = today_kst() - timedelta(days=1)
|
||||
body = self._get(ctx, DAILY_SALES_PATH, {"stdDate": day.strftime("%Y%m%d"), "pageIdx": 1, "rowsPerPage": 10})
|
||||
total = body.get("totalCount")
|
||||
return (f"GS샵 연결 정상(매출 내역 조회 확인, 어제 매출 {total if total is not None else len(_rows(body))}건, "
|
||||
f"토큰 {self._how_label(ctx)}).")
|
||||
|
||||
@staticmethod
|
||||
def _mode_key(ctx: AdapterContext) -> str:
|
||||
return credential_fingerprint(ctx.credentials, ("vendor_code", "api_key"))
|
||||
|
||||
def _how_label(self, ctx: AdapterContext) -> str:
|
||||
v, m = self._mode.get(self._mode_key(ctx), ("", ""))
|
||||
return f"{MODE_LABEL.get(m, m)}, {KEY_LABEL.get(v, v)}"
|
||||
|
||||
# ── 원본 데이터 확인(설정 화면 "쇼핑몰 원본 데이터 확인") ─────────
|
||||
def reconcile(self, ctx: AdapterContext, day: date, to: date | None = None) -> dict[str, Any]:
|
||||
"""매출 내역·배송비 내역을 기간(최대 31일, 10일씩)으로 실제 불러 항목별 합계를 돌려준다(저장 안 함).
|
||||
응답 항목 이름이 개발가이드에 없어 협력사 포털 매출 화면과 맞는 항목을 실데이터로 확정하는 용도."""
|
||||
self.authenticate(ctx)
|
||||
to = min(max(to or day, day), day + timedelta(days=PROBE_MAX_DAYS - 1))
|
||||
probes = []
|
||||
got: dict[str, list[dict[str, Any]]] = {}
|
||||
for key, label, path in (("sales", "매출 내역(매출인식일 기준)", SALES_PATH),
|
||||
("shipping", "배송비 내역(매출인식일 기준)", SHIPPING_PATH)):
|
||||
row: dict[str, Any] = {"key": key, "label": label, "path": path}
|
||||
try:
|
||||
rows = self._pages(ctx, path, day, to)
|
||||
except AdapterError as exc:
|
||||
probes.append({**row, "ok": False, "error": exc.message[:300]})
|
||||
continue
|
||||
got[key] = rows
|
||||
probes.append({**row, "ok": True, "count": len(rows), "fields": field_summary([_strs(r) for r in rows])})
|
||||
# 날짜별 현재 규칙 매출(supGiveAmt, SALE 아닌 줄은 음수) — 협력사 포털 매출 화면과 나란히 비교
|
||||
days = []
|
||||
d = day
|
||||
while d <= to:
|
||||
sales = [r for r in got.get("sales", []) if _yyyymmdd(r.get("saleAwareDt")) == d]
|
||||
ret = [r for r in sales if str(r.get("ordType") or "SALE").upper() != "SALE"]
|
||||
amt = sum(abs(_won(r.get("supGiveAmt"))) for r in sales if r not in ret) - sum(abs(_won(r.get("supGiveAmt"))) for r in ret)
|
||||
days.append({"date": d.isoformat(), "orders": len({str(r.get("ordNo")) for r in sales if r not in ret}),
|
||||
"amount": amt, "claimed": sum(abs(_won(r.get("supGiveAmt"))) for r in ret),
|
||||
"ship": sum(_won(r.get("salePrice")) for r in got.get("shipping", [])
|
||||
if _yyyymmdd(r.get("saleAwareDt")) == d)})
|
||||
d += timedelta(days=1)
|
||||
return {"date": day.isoformat(), "to": to.isoformat(), "probes": probes, "days": days,
|
||||
"day_cols": {"claimed": "그중 취소·반품(음수로 반영)", "ship": "배송비(참고, 매출 제외)"},
|
||||
"rule": "매출인식일 기준 매출 내역 supGiveAmt(협력사 지급액 = 포털 주문 통계 금액) 합, SALE 이 아닌 줄은 빼기, "
|
||||
"배송비 제외. 주문 통계는 주문일 기준이라 날마다 같지는 않고 기간이 길수록 가까워진다"}
|
||||
@@ -0,0 +1,372 @@
|
||||
"""카카오 — 카카오쇼핑(톡스토어) Open API(shopping-developers.kakao.com, 2026-10-13 문서 확인).
|
||||
|
||||
인증(“API 공통 인증 헤더 구성”) — 모든 호출에 같은 헤더 3개, 주소 https://kapi.kakao.com
|
||||
Authorization: KakaoAK {앱 어드민 키} 카카오디벨로퍼스 앱(연동 앱) → 앱 설정 → 앱 → 어드민 키
|
||||
Target-Authorization: KakaoAK {판매자 API 인증키} 카카오쇼핑 판매자센터 → 정보관리 → 판매채널 정보 → API 인증키
|
||||
channel-ids: 101(톡스토어) / 1(선물하기) / "1,101"(둘 다)
|
||||
두 헤더에 같은 앱의 키를 넣으면 {"code": -2, "msg": "invalid authorization or target-authorization header."},
|
||||
판매자 인증키가 바뀌었거나 무효면 {"code": -401, "msg": "appKey(판매자인증키) is already deactivated"},
|
||||
연동 앱과 판매자가 연결되지 않았으면 "대행사 매핑/권한 확인이 필요합니다."
|
||||
Open API 는 카카오쇼핑 검토를 거쳐 허락된 앱만 쓸 수 있다(“카카오쇼핑 API 연동 검토 요청하기”).
|
||||
|
||||
매출 수집 — 네이버와 같은 기준(결제일, 할인 뒤 상품 금액, 배송비 제외, 결제 뒤 취소·반품분도 결제일 매출에 포함):
|
||||
- 결제일시 기준 주문내역 조회 GET /v2/shopping/orders/paidAt?from=YYYY-MM-DD HH:mm:ss&to=…&size=100(&token=)
|
||||
— 한 번에 24시간까지(하루씩 부른다), 쪽당 100건, 다음 쪽은 응답의 token(더 없으면 token 없음).
|
||||
목록에는 금액이 없다(orderId·paymentId·orderStatus·paidAt …).
|
||||
- 주문 하나씩 주문정보 조회 GET /v1/shopping/order?order_id= 로 orderProduct 금액을 받는다.
|
||||
한 번 받은 주문은 목록의 modifiedAt 이 같으면 다시 부르지 않는다(프로세스 안 메모리 캐시).
|
||||
- 카카오 주문(orderId)은 상품 한 줄이고 결제(paymentId)가 장바구니 하나 → SALE = 결제 하나(`kakao:{paymentId}`),
|
||||
날짜 = 결제일(paidAt, 한국 시간), 금액 = 그 결제에 든 상품 줄 금액 합.
|
||||
- 상품 줄 금액(line_amount) = (productPrice + optionPrice) × quantity − sellerDiscountPrice − sellerCouponDiscountPrice
|
||||
− adminDiscountPrice. 문서에 결제금액 항목이 따로 없어 이 식으로 만든다 — **판매자센터 매출 화면과 아직 대조 전**.
|
||||
설정 화면 "쇼핑몰 원본 데이터 확인"에서 항목별 합계를 보고 맞는 식으로 확정한다.
|
||||
- 미결제(주문 생성·결제 요청·입금 대기/확인·결제 실패·미입금 취소)만 뺀다.
|
||||
- 구매자 이름·연락처·주소는 저장하지 않는다(원본 확인에서도 값 없이 이름만).
|
||||
"""
|
||||
|
||||
from __future__ import annotations
|
||||
|
||||
import re
|
||||
import time
|
||||
from datetime import date, timedelta
|
||||
from typing import Any, Iterable
|
||||
|
||||
from .base import (
|
||||
AdapterContext,
|
||||
AdapterError,
|
||||
ApiError,
|
||||
AuthFailed,
|
||||
CredentialField,
|
||||
MarketplaceAdapter,
|
||||
NotConfigured,
|
||||
SaleEvent,
|
||||
)
|
||||
from .naver import field_summary, flatten
|
||||
|
||||
HOST = "https://kapi.kakao.com"
|
||||
PAID_PATH = "/v2/shopping/orders/paidAt"
|
||||
ORDER_PATH = "/v1/shopping/order"
|
||||
EVENT_PREFIX = "kakao:"
|
||||
DEFAULT_CHANNELS = "101" # 톡스토어
|
||||
PAGE_SIZE = 100
|
||||
MAX_PAGES = 200 # 하루 2만 건 — 무한 반복 방지
|
||||
CALL_INTERVAL_SEC = 0.1 # 호출 사이 간격(문서에 제한 없음 — 넉넉히)
|
||||
RETRY_429 = 3
|
||||
PROBE_MAX_DAYS = 31
|
||||
CACHE_MAX = 20000
|
||||
|
||||
# 매출에서 빼는 상태 — 결제되지 않은 것만. 결제 뒤 취소·반품은 결제일 매출에 그대로(네이버 "판매금액(총)"과 같은 기준).
|
||||
UNPAID_STATUS = frozenset({"Created", "PayRequest", "PayWaiting", "PayChecking", "PayFailed", "UnpaidCancelComplete"})
|
||||
# 결제 뒤 취소·환불·반품 완료 — 원본 확인 표에 참고로 따로 보여 줌
|
||||
CLAIMED_STATUS = frozenset({
|
||||
"PayCancelComplete", "RefundComplete", "ShippingCancelComplete", "ShippingRefundComplete",
|
||||
"ReturnCancelComplete", "ReturnRefundComplete", "TicketCancelComplete", "TicketRefundComplete",
|
||||
})
|
||||
STATUS_KO = {
|
||||
"Created": "주문 생성", "PayRequest": "결제 요청", "PayWaiting": "결제 대기", "PayChecking": "입금 확인 중",
|
||||
"PayFailed": "결제 실패", "PayComplete": "결제 완료", "ShippingRequest": "배송 요청",
|
||||
"PayCancelRequest": "결제 취소 예정", "PayCancelComplete": "결제 취소 완료", "RefundComplete": "환불 완료",
|
||||
"UnpaidCancelComplete": "미입금 취소 완료", "ShippingWaiting": "배송 준비 중",
|
||||
"ShippingCancelComplete": "결제 취소 완료", "ShippingProgress": "배송 중", "ShippingComplete": "배송 완료",
|
||||
"ShippingRefundComplete": "환불 완료", "ExchangeShippingComplete": "교환 완료", "ReturnRequest": "반품 요청",
|
||||
"ReturnCancelComplete": "반품 결제 취소 완료", "ReturnRefundComplete": "반품 환불 완료",
|
||||
"TicketSendComplete": "발송 완료", "TicketCancelComplete": "결제 취소 완료", "TicketRefundComplete": "환불 완료",
|
||||
"BuyDecision": "구매 결정",
|
||||
}
|
||||
|
||||
|
||||
def _won(value: Any) -> int:
|
||||
try:
|
||||
return int(round(float(str(value if value is not None else 0).replace(",", ""))))
|
||||
except ValueError:
|
||||
return 0
|
||||
|
||||
|
||||
def _day(value: Any) -> date | None:
|
||||
""""20251201201735" 또는 "2025-12-01 20:17:35" → date(2025, 12, 1). 카카오 날짜는 한국 시간."""
|
||||
s = "".join(ch for ch in str(value or "") if ch.isdigit())[:8]
|
||||
if len(s) < 8:
|
||||
return None
|
||||
try:
|
||||
return date(int(s[:4]), int(s[4:6]), int(s[6:8]))
|
||||
except ValueError:
|
||||
return None
|
||||
|
||||
|
||||
def line_amount(op: dict[str, Any]) -> int:
|
||||
"""상품 줄 금액 = (상품가 + 옵션가) × 수량 − 판매자 할인 − 판매자 쿠폰 − 카카오(관리자) 할인. 배송비 제외."""
|
||||
qty = max(1, _won(op.get("quantity")))
|
||||
gross = (_won(op.get("productPrice")) + _won(op.get("optionPrice"))) * qty
|
||||
return max(0, gross - line_discount(op))
|
||||
|
||||
|
||||
def line_discount(op: dict[str, Any]) -> int:
|
||||
return sum(abs(_won(op.get(k))) for k in ("sellerDiscountPrice", "sellerCouponDiscountPrice", "adminDiscountPrice"))
|
||||
|
||||
|
||||
# 구매자 개인정보 — 받자마자 값을 지운다(메모리 캐시·원본 확인 표 어디에도 남기지 않음, 항목 이름만 남김).
|
||||
PERSONAL_OBJECTS = ("orderer", "orderDeliveryRequest", "orderTicketReceiver")
|
||||
PERSONAL_KEY = re.compile(r"^(pickup|exchange)(Name|ZipCode|RoadZipCode|Address\d*|MobileNumber|PhoneNumber)$|reasonComment")
|
||||
|
||||
|
||||
def strip_personal(det: dict[str, Any]) -> dict[str, Any]:
|
||||
out: dict[str, Any] = {}
|
||||
for k, v in det.items():
|
||||
if k in PERSONAL_OBJECTS and isinstance(v, dict):
|
||||
out[k] = {kk: "" for kk in v}
|
||||
elif isinstance(v, dict):
|
||||
out[k] = {kk: ("" if PERSONAL_KEY.search(str(kk)) else vv) for kk, vv in v.items()}
|
||||
else:
|
||||
out[k] = v
|
||||
return out
|
||||
|
||||
|
||||
def order_detail(body: Any) -> dict[str, Any]:
|
||||
"""주문정보 조회 응답에서 주문 하나(orderBase·orderProduct …)를 꺼낸다(개인정보 값은 지움).
|
||||
감싼 모양(data/content)도 받아들인다."""
|
||||
if not isinstance(body, dict):
|
||||
return {}
|
||||
if isinstance(body.get("orderProduct"), dict) or isinstance(body.get("orderBase"), dict):
|
||||
return strip_personal(body)
|
||||
for k in ("data", "content", "contents"):
|
||||
v = body.get(k)
|
||||
if isinstance(v, list) and v and isinstance(v[0], dict):
|
||||
v = v[0]
|
||||
if isinstance(v, dict) and (isinstance(v.get("orderProduct"), dict) or isinstance(v.get("orderBase"), dict)):
|
||||
return strip_personal(v)
|
||||
return {}
|
||||
|
||||
|
||||
def group_payments(items: Iterable[dict[str, Any]], start: date, end: date) -> dict[str, dict[str, Any]]:
|
||||
"""주문(상품 줄) → 결제 하나로 합침(결제일이 [start, end] 이고 결제된 것 — 나중에 취소·반품된 것도 포함).
|
||||
items = {"row": 목록 줄, "detail": 주문정보}. 배송비·취소/반품분은 참고용(ship·claimed)으로만 모은다."""
|
||||
pays: dict[str, dict[str, Any]] = {}
|
||||
for it in items:
|
||||
row, det = it.get("row") or {}, it.get("detail") or {}
|
||||
base, op = det.get("orderBase") or {}, det.get("orderProduct") or {}
|
||||
status = str(row.get("orderStatus") or base.get("status") or "")
|
||||
day = _day(row.get("paidAt") or base.get("paidAt"))
|
||||
oid = str(row.get("orderId") or base.get("id") or det.get("id") or "")
|
||||
pid = str(row.get("paymentId") or base.get("paymentId") or oid)
|
||||
if not oid or day is None or not (start <= day <= end) or status in UNPAID_STATUS or not op:
|
||||
continue
|
||||
p = pays.setdefault(pid, {"paymentId": pid, "_day": day, "amount": 0, "ship": 0, "claimed": 0, "qty": 0,
|
||||
"discount": 0, "names": [], "opt": "", "statuses": [], "orders": [],
|
||||
"order_day": _day(row.get("createdAt") or base.get("createdAt"))})
|
||||
amt = line_amount(op)
|
||||
p["amount"] += amt
|
||||
if status in CLAIMED_STATUS:
|
||||
p["claimed"] += amt
|
||||
p["ship"] += _won(op.get("deliveryAmount")) + _won(op.get("areaAdditionalDeliveryAmount"))
|
||||
p["qty"] += max(1, _won(op.get("quantity")))
|
||||
p["discount"] += line_discount(op)
|
||||
p["orders"].append(oid)
|
||||
name = str(op.get("name") or "")
|
||||
if name and name not in p["names"]:
|
||||
p["names"].append(name)
|
||||
p["opt"] = p["opt"] or str(op.get("optionContent") or "")
|
||||
if status and status not in p["statuses"]:
|
||||
p["statuses"].append(status)
|
||||
return pays
|
||||
|
||||
|
||||
def _err_text(body: dict[str, Any], res: Any) -> str:
|
||||
parts = [str(body.get(k)) for k in ("code", "msg", "message") if body.get(k) not in (None, "")]
|
||||
ex = body.get("extras")
|
||||
if isinstance(ex, dict):
|
||||
parts += [str(ex.get(k)) for k in ("error_code", "error_message") if ex.get(k) not in (None, "")]
|
||||
return " ".join(parts)[:300] or res.text[:200].strip() or "응답 없음"
|
||||
|
||||
|
||||
class KakaoAdapter(MarketplaceAdapter):
|
||||
code = "kakao"
|
||||
name = "카카오"
|
||||
auth_type = "api_key"
|
||||
implemented = True
|
||||
replace_range = True
|
||||
event_prefix = EVENT_PREFIX
|
||||
docs_url = "https://shopping-developers.kakao.com/hc/ko/articles/4578909656975"
|
||||
note = ("카카오쇼핑 Open API 는 카카오쇼핑 검토로 허락된 카카오디벨로퍼스 앱만 쓸 수 있습니다. "
|
||||
"그 앱의 어드민 키와, 판매자센터(정보관리 → 판매채널 정보 → API 인증키)의 판매자 API 인증키를 입력합니다. "
|
||||
"두 키는 서로 다른 앱의 키여야 합니다.")
|
||||
|
||||
def __init__(self) -> None:
|
||||
self._last_call = 0.0
|
||||
self._details: dict[str, tuple[str, dict[str, Any]]] = {} # orderId → (modifiedAt, 주문정보)
|
||||
|
||||
def credential_fields(self) -> list[CredentialField]:
|
||||
# api_key 는 처음 만든 입력칸 이름 그대로 — 이미 저장한 판매자 인증키를 다시 넣지 않아도 되게.
|
||||
return [
|
||||
CredentialField("admin_key", "앱 어드민 키(Authorization)", secret=True,
|
||||
help="카카오디벨로퍼스 → 내 애플리케이션(카카오쇼핑 API 허락된 앱) → 앱 설정 → 앱 → 어드민 키"),
|
||||
CredentialField("api_key", "판매자 API 인증키(Target-Authorization)", secret=True,
|
||||
help="카카오쇼핑 판매자센터 → 정보관리 → 판매채널 정보 → API 인증키"),
|
||||
CredentialField("channel_ids", "판매채널(channel-ids)", required=False, placeholder=DEFAULT_CHANNELS,
|
||||
help="톡스토어 101(기본), 선물하기 1, 둘 다 1,101"),
|
||||
]
|
||||
|
||||
# ── 호출 ──────────────────────────────────────────────
|
||||
def _headers(self, ctx: AdapterContext) -> dict[str, str]:
|
||||
admin = ctx.credentials.get("admin_key").strip()
|
||||
seller = ctx.credentials.get("api_key").strip()
|
||||
if not admin or not seller:
|
||||
raise NotConfigured("앱 어드민 키와 판매자 API 인증키를 입력하세요.")
|
||||
channels = re.sub(r"\s+", "", ctx.credentials.get("channel_ids") or "") or DEFAULT_CHANNELS
|
||||
return {"Authorization": f"KakaoAK {admin}", "Target-Authorization": f"KakaoAK {seller}",
|
||||
"channel-ids": channels, "Accept": "application/json"}
|
||||
|
||||
def _get(self, ctx: AdapterContext, path: str, params: dict[str, Any]) -> dict[str, Any]:
|
||||
"""GET — 호출 간격 유지, 429 는 잠깐 쉬고 다시. 키 오류는 AuthFailed(무엇을 확인할지 안내)."""
|
||||
import httpx # 지연 import
|
||||
|
||||
headers = self._headers(ctx)
|
||||
for attempt in range(RETRY_429 + 1):
|
||||
ctx.progress.check() # [업데이트 취소]면 여기서 멈춤
|
||||
wait = CALL_INTERVAL_SEC - (time.monotonic() - self._last_call)
|
||||
if wait > 0:
|
||||
time.sleep(wait)
|
||||
try:
|
||||
res = httpx.get(f"{HOST}{path}", params=params, headers=headers, timeout=ctx.timeout_sec)
|
||||
except httpx.HTTPError as exc:
|
||||
raise ApiError(f"카카오쇼핑 API 연결 실패: {type(exc).__name__}") from None
|
||||
finally:
|
||||
self._last_call = time.monotonic()
|
||||
if res.status_code == 429 and attempt < RETRY_429:
|
||||
time.sleep(1.0 * (2 ** attempt))
|
||||
continue
|
||||
try:
|
||||
body = res.json()
|
||||
except ValueError:
|
||||
body = {}
|
||||
if not isinstance(body, dict):
|
||||
body = {"contents": body}
|
||||
code = _won(body.get("code")) if body.get("code") not in (None, "") else 0
|
||||
text = _err_text(body, res)
|
||||
if code == -2 or "target-authorization" in text.lower():
|
||||
raise AuthFailed(f"카카오 인증 헤더 거부({text}). 앱 어드민 키와 판매자 API 인증키가 서로 다른 앱의 키인지, "
|
||||
"어드민 키가 REST API 키가 아닌지 확인하세요.")
|
||||
if code == -401 or "deactivated" in text:
|
||||
raise AuthFailed(f"카카오 판매자 API 인증키 무효({text}). 판매자센터의 API 인증키를 다시 복사해 넣으세요.")
|
||||
if "매핑" in text or "대행사" in text:
|
||||
raise AuthFailed(f"카카오쇼핑 연동 앱과 판매자가 연결되지 않았습니다({text}). 판매자 연결(POST /v1/store/register)이 "
|
||||
"끝났는지, 앱이 카카오쇼핑 API 허락을 받았는지 확인하세요.")
|
||||
if res.status_code in (401, 403):
|
||||
raise AuthFailed(f"카카오 권한 거부({res.status_code}): {text}. 앱이 카카오쇼핑 API 허락을 받았는지, "
|
||||
"두 키가 맞는지 확인하세요.")
|
||||
if res.status_code >= 400 or code < 0:
|
||||
raise ApiError(f"카카오쇼핑 API 오류({res.status_code}): {text}")
|
||||
return body
|
||||
raise ApiError("카카오쇼핑 API 호출 제한(429)이 계속됩니다. 잠시 뒤 다시 시도하세요.")
|
||||
|
||||
def _day_rows(self, ctx: AdapterContext, d: date) -> list[dict[str, Any]]:
|
||||
"""결제일이 d(한국 시간 0시~23:59:59)인 주문 목록 — 모든 상태, 금액 없음."""
|
||||
params: dict[str, Any] = {"from": f"{d.isoformat()} 00:00:00", "to": f"{d.isoformat()} 23:59:59",
|
||||
"size": PAGE_SIZE}
|
||||
out: list[dict[str, Any]] = []
|
||||
token = ""
|
||||
seen: set[str] = set()
|
||||
for _ in range(MAX_PAGES):
|
||||
body = self._get(ctx, PAID_PATH, {**params, **({"token": token} if token else {})})
|
||||
rows = [r for r in body.get("contents") or [] if isinstance(r, dict)]
|
||||
out.extend(rows)
|
||||
token = str(body.get("token") or "")
|
||||
if not token or not rows:
|
||||
break
|
||||
if token in seen: # 커서 반복 — 끝까지 받았는지 알 수 없다(검토 F05)
|
||||
raise ApiError(f"카카오 {d.isoformat()} 주문 목록의 다음 쪽 표시가 반복됩니다 — 저장하지 않았습니다.")
|
||||
seen.add(token)
|
||||
else: # 쪽 수 상한을 다 썼는데 아직 다음 쪽이 있음
|
||||
raise ApiError(f"카카오 {d.isoformat()} 주문이 {MAX_PAGES}쪽을 넘어 끝까지 받지 못했습니다 — 저장하지 않았습니다.")
|
||||
return out
|
||||
|
||||
def _detail(self, ctx: AdapterContext, row: dict[str, Any]) -> dict[str, Any]:
|
||||
oid = str(row.get("orderId") or "")
|
||||
mod = str(row.get("modifiedAt") or "")
|
||||
hit = self._details.get(oid)
|
||||
if hit and hit[0] == mod and mod:
|
||||
return hit[1]
|
||||
det = order_detail(self._get(ctx, ORDER_PATH, {"order_id": oid}))
|
||||
if det:
|
||||
if len(self._details) >= CACHE_MAX:
|
||||
self._details.clear()
|
||||
self._details[oid] = (mod, det)
|
||||
return det
|
||||
|
||||
def _items(self, ctx: AdapterContext, start: date, end: date) -> Iterable[dict[str, Any]]:
|
||||
"""하루씩 목록 → 결제된 주문만 주문정보까지 받아 {"row", "detail"}."""
|
||||
ctx.progress.plan((end - start).days + 1, "일") # 진행 막대: 하루 = 한 단계
|
||||
d = start
|
||||
while d <= end:
|
||||
rows = self._day_rows(ctx, d)
|
||||
got = []
|
||||
for r in rows:
|
||||
if not r.get("orderId") or str(r.get("orderStatus") or "") in UNPAID_STATUS:
|
||||
got.append({"row": r, "detail": {}})
|
||||
continue
|
||||
got.append({"row": r, "detail": self._detail(ctx, r)})
|
||||
ctx.progress.step(items=len(rows))
|
||||
yield from got
|
||||
d += timedelta(days=1)
|
||||
|
||||
# ── 수집 ──────────────────────────────────────────────
|
||||
def fetch_orders(self, ctx: AdapterContext, start: date, end: date) -> Iterable[dict[str, Any]]:
|
||||
yield from group_payments(self._items(ctx, start, end), start, end).values()
|
||||
|
||||
def normalize_order(self, p: dict[str, Any]) -> list[SaleEvent]:
|
||||
pid, day = str(p.get("paymentId") or ""), p.get("_day")
|
||||
if not pid or day is None:
|
||||
return []
|
||||
names = p.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 p.get("statuses") or []]
|
||||
orders = p.get("orders") or []
|
||||
return [SaleEvent(
|
||||
event_type="SALE", external_event_id=f"{EVENT_PREFIX}{pid}", external_order_id=pid,
|
||||
external_line_id=",".join(orders)[:100], order_date=p.get("order_day"), payment_date=day, event_date=day,
|
||||
amount=max(0, int(p.get("amount") or 0)), product_name=name[:200], option_name=str(p.get("opt") or "")[:200],
|
||||
quantity=int(p.get("qty") or 0), discount_amount=max(0, int(p.get("discount") or 0)),
|
||||
order_status="/".join(statuses)[:50],
|
||||
)]
|
||||
|
||||
def test_connection(self, ctx: AdapterContext) -> str:
|
||||
from app.timezone import today_kst # noqa: WPS433
|
||||
|
||||
self.authenticate(ctx)
|
||||
rows = self._day_rows(ctx, today_kst())
|
||||
return f"카카오쇼핑 API 연결 정상(결제일 기준 주문 조회 확인, 오늘 결제 주문 {len(rows)}건)."
|
||||
|
||||
# ── 원본 데이터 확인(설정 화면 "쇼핑몰 원본 데이터 확인") ─────────
|
||||
def reconcile(self, ctx: AdapterContext, day: date, to: date | None = None) -> dict[str, Any]:
|
||||
"""결제일 기준 기간(최대 31일)의 주문과 주문정보를 실제로 불러 항목별 합계·상태별 합계·날짜별 현재 규칙 매출을
|
||||
돌려준다(저장 안 함). 판매자센터 매출 화면과 어느 항목이 맞는지 실데이터로 확정하는 용도. 개인정보는 이름만."""
|
||||
self.authenticate(ctx)
|
||||
to = min(max(to or day, day), day + timedelta(days=PROBE_MAX_DAYS - 1))
|
||||
try:
|
||||
items = list(self._items(ctx, day, to))
|
||||
except AdapterError as exc:
|
||||
return {"date": day.isoformat(), "to": to.isoformat(), "probes": [
|
||||
{"key": "paid", "label": "결제일 기준 주문", "path": PAID_PATH, "ok": False, "error": exc.message[:300]}]}
|
||||
flat = [{**flatten(it["row"], "list"), **flatten(it["detail"])} for it in items]
|
||||
probes = [{"key": "paid", "label": "결제일 기준 주문 + 주문정보(전체 상태)", "path": f"{PAID_PATH} → {ORDER_PATH}",
|
||||
"ok": True, "count": len(items), "fields": field_summary(flat)}]
|
||||
by_status: dict[str, list[dict[str, str]]] = {}
|
||||
for it, f in zip(items, flat):
|
||||
by_status.setdefault(str(it["row"].get("orderStatus") or "?"), []).append(f)
|
||||
for st, rows in sorted(by_status.items()):
|
||||
probes.append({"key": f"status-{st}", "label": f"상태 {STATUS_KO.get(st, st)}({st})"
|
||||
+ (" — 매출 제외(미결제)" if st in UNPAID_STATUS else
|
||||
" — 결제 뒤 취소·반품(매출 포함)" if st in CLAIMED_STATUS else ""), "path": "orderStatus",
|
||||
"ok": True, "count": len(rows),
|
||||
"fields": [f for f in field_summary(rows)
|
||||
if f["sum"] is not None and f["name"].startswith("orderProduct.")]})
|
||||
pays = group_payments(items, day, to)
|
||||
days = []
|
||||
d = day
|
||||
while d <= to:
|
||||
day_pays = [p for p in pays.values() if p["_day"] == d]
|
||||
days.append({"date": d.isoformat(), "orders": len(day_pays), "amount": sum(p["amount"] for p in day_pays),
|
||||
"claimed": sum(p["claimed"] for p in day_pays), "ship": sum(p["ship"] for p in day_pays)})
|
||||
d += timedelta(days=1)
|
||||
return {"date": day.isoformat(), "to": to.isoformat(), "probes": probes, "days": days,
|
||||
"rule": "결제일 기준 주문의 (상품가 + 옵션가) × 수량 − 판매자 할인 − 판매자 쿠폰 − 카카오 할인 합(배송비 제외, "
|
||||
"결제 뒤 취소·반품분 포함, 미결제 제외). 판매자센터 매출과 대조 전 — 표의 항목 합계로 확인"}
|
||||
@@ -0,0 +1,21 @@
|
||||
"""롯데ON — 롯데ON 판매자 API.
|
||||
|
||||
인증: 거래처번호 + 발급 API Key(연동 단계에서 확정).
|
||||
"""
|
||||
|
||||
from __future__ import annotations
|
||||
|
||||
from .base import CredentialField, MarketplaceAdapter
|
||||
|
||||
|
||||
class LotteonAdapter(MarketplaceAdapter):
|
||||
code = "lotteon"
|
||||
name = "롯데ON"
|
||||
auth_type = "api_key"
|
||||
note = "롯데ON 스토어센터에서 발급한 API 인증정보를 입력합니다."
|
||||
|
||||
def credential_fields(self) -> list[CredentialField]:
|
||||
return [
|
||||
CredentialField("trade_no", "거래처번호"),
|
||||
CredentialField("api_key", "API Key", secret=True),
|
||||
]
|
||||
@@ -0,0 +1,25 @@
|
||||
"""수동 입력 전용 쇼핑몰 — API 연동 없이 실적 일자별 표의 날짜 칸에 총매출을 직접 넣는다.
|
||||
|
||||
어댑터는 쇼핑몰의 "종류"만 알린다: 인증 항목이 없고(manual_only), 매출 업데이트(sync_all)에서 빠진다.
|
||||
DB(perf_marketplaces)에는 manual_input = TRUE 로 넣는다(마이그레이션 003).
|
||||
"""
|
||||
|
||||
from __future__ import annotations
|
||||
|
||||
from .base import MarketplaceAdapter
|
||||
|
||||
|
||||
class ManualOnlyAdapter(MarketplaceAdapter):
|
||||
auth_type = "manual"
|
||||
manual_only = True
|
||||
note = "API 연동 없이 실적 일자별 표의 날짜 칸에 총매출을 직접 입력합니다."
|
||||
|
||||
|
||||
class CoupangRocketAdapter(ManualOnlyAdapter):
|
||||
code = "coupang_rocket"
|
||||
name = "쿠팡(로켓)"
|
||||
|
||||
|
||||
class AtomyAzmallAdapter(ManualOnlyAdapter):
|
||||
code = "atomy"
|
||||
name = "애터미아자몰"
|
||||
@@ -0,0 +1,63 @@
|
||||
"""테스트(모의) 매출 데이터 — 실제 API 연동 전 화면 확인용.
|
||||
|
||||
같은 (쇼핑몰, 날짜)면 항상 같은 값이 나온다(재현 가능). 결제뿐 아니라 전체 취소·
|
||||
부분 반품도 섞어 넣어 음수 반영과 합계를 확인할 수 있게 한다.
|
||||
DB 에는 is_sample=TRUE 로 들어가며 설정 화면에서 한 번에 지울 수 있다.
|
||||
"""
|
||||
|
||||
from __future__ import annotations
|
||||
|
||||
import random
|
||||
from datetime import date, timedelta
|
||||
|
||||
from .base import SaleEvent
|
||||
|
||||
# 쇼핑몰별 하루 평균 주문 건수(모의값) — 화면에 차이가 보이도록만 다르게 둔다.
|
||||
_DAILY_ORDERS = {
|
||||
"cafe24": 9, "naver": 14, "coupang": 18, "ohouse": 4, "gmarket": 6,
|
||||
"kakao": 3, "gsshop": 2, "elevenst": 4, "lotteon": 2, "toss": 1,
|
||||
}
|
||||
_PRODUCTS = (
|
||||
("스테인리스 냄비 20cm", 39_000), ("프라이팬 28cm", 45_900), ("밀폐용기 5종 세트", 29_800),
|
||||
("도마 대형", 19_900), ("칼 블록 세트", 89_000), ("주방 가위", 12_900),
|
||||
("냄비 받침", 8_900), ("전골 냄비", 59_000),
|
||||
)
|
||||
|
||||
|
||||
def generate(code: str, start: date, end: date) -> list[SaleEvent]:
|
||||
events: list[SaleEvent] = []
|
||||
base = _DAILY_ORDERS.get(code, 3)
|
||||
d = start
|
||||
while d <= end:
|
||||
rng = random.Random(f"perf-sample:{code}:{d.isoformat()}")
|
||||
weekend = d.weekday() >= 5
|
||||
n = max(0, int(rng.gauss(base * (0.7 if weekend else 1.0), base * 0.35)))
|
||||
for i in range(n):
|
||||
name, price = rng.choice(_PRODUCTS)
|
||||
qty = 1 if rng.random() < 0.8 else rng.randint(2, 3)
|
||||
discount = rng.choice((0, 0, 0, 1000, 2000, 3000))
|
||||
amount = max(0, price * qty - discount)
|
||||
order_id = f"SAMPLE-{code}-{d:%Y%m%d}-{i:03d}"
|
||||
events.append(SaleEvent(
|
||||
event_type="SALE", external_event_id=f"{order_id}-S", external_order_id=order_id,
|
||||
external_line_id="1", order_date=d, payment_date=d, event_date=d, amount=amount,
|
||||
product_name=name, quantity=qty, discount_amount=discount, order_status="결제완료",
|
||||
raw={"sample": True},
|
||||
))
|
||||
roll = rng.random()
|
||||
if roll < 0.05: # 전체 취소(당일~2일 뒤)
|
||||
cd = min(end, d + timedelta(days=rng.randint(0, 2)))
|
||||
events.append(SaleEvent(
|
||||
event_type="CANCEL", external_event_id=f"{order_id}-C", external_order_id=order_id,
|
||||
external_line_id="1", order_date=d, payment_date=d, event_date=cd, amount=-amount,
|
||||
product_name=name, quantity=-qty, order_status="취소완료", raw={"sample": True},
|
||||
))
|
||||
elif roll < 0.08 and qty > 1: # 부분 반품(1개, 3~7일 뒤)
|
||||
rd = min(end, d + timedelta(days=rng.randint(3, 7)))
|
||||
events.append(SaleEvent(
|
||||
event_type="RETURN", external_event_id=f"{order_id}-R", external_order_id=order_id,
|
||||
external_line_id="1", order_date=d, payment_date=d, event_date=rd, amount=-price,
|
||||
product_name=name, quantity=-1, order_status="반품완료", raw={"sample": True},
|
||||
))
|
||||
d += timedelta(days=1)
|
||||
return events
|
||||
@@ -0,0 +1,424 @@
|
||||
"""네이버 스마트스토어 — 네이버 커머스API.
|
||||
|
||||
인증(공식 방식): 애플리케이션 ID + 시크릿으로 전자서명 → OAuth2 client_credentials 토큰.
|
||||
client_secret_sign = base64( bcrypt.hashpw("{client_id}_{timestamp(ms)}", client_secret) )
|
||||
POST https://api.commerce.naver.com/external/v1/oauth2/token
|
||||
(client_id, timestamp, client_secret_sign, grant_type=client_credentials, type=SELF | SELLER+account_id)
|
||||
토큰은 약 3시간 — 암호화 저장(access_token·access_token_expires_at)해 두고 만료 5분 전에 새로 받는다.
|
||||
커머스API센터 애플리케이션에 **API 호출 IP(이 서버 외부 IP)** 를 등록해야 호출된다.
|
||||
|
||||
매출 수집 — 스마트스토어센터 **판매분석 "판매금액(총)"** 과 같은 기준(2026-09-30 사용자 확인: 9/1 매출 4,455,600원.
|
||||
판매금액은 할인(판매자·네이버 부담) 뒤 금액, 배송비 332,486원은 별도, 환불 346,340원은 환불일에 따로 빠져 판매금액(순)):
|
||||
- 조건형 상품 주문 상세 조회 GET /v1/pay-order/seller/product-orders
|
||||
?from=…&to=…&rangeType=PAYED_DATETIME&pageSize=&page= — 결제일 기준, 한 번에 24시간까지(하루씩 부른다),
|
||||
from 부터 180일 안의 주문만. 응답에 주문·상품주문 상세가 바로 들어 있다(네이버 안내: 소량·조회용 권장 API).
|
||||
- SALE = 주문 하나(`naver:{orderId}`), 날짜 = 결제일(order.paymentDate).
|
||||
금액 = 상품주문들의 결제금액(productOrder.totalPaymentAmount) 합 — 배송비 제외.
|
||||
- 결제 뒤 취소·반품된 상품주문도 결제일 매출에 그대로 둔다(판매금액(총)). 입금대기·미입금 취소만 뺀다.
|
||||
그래서 지난 날짜 매출이 나중에 줄지 않는다. 환불(판매금액(순))은 아직 따로 만들지 않는다.
|
||||
- 구매자 이름·연락처·주소는 저장하지 않는다.
|
||||
"""
|
||||
|
||||
from __future__ import annotations
|
||||
|
||||
import base64
|
||||
import re
|
||||
import time
|
||||
from datetime import date, datetime, timedelta
|
||||
from typing import Any, Iterable
|
||||
|
||||
from .base import (
|
||||
credential_fingerprint,
|
||||
AdapterContext,
|
||||
AdapterError,
|
||||
ApiError,
|
||||
AuthFailed,
|
||||
CredentialField,
|
||||
MarketplaceAdapter,
|
||||
NotConfigured,
|
||||
SaleEvent,
|
||||
TokenExpired,
|
||||
)
|
||||
|
||||
HOST = "https://api.commerce.naver.com/external"
|
||||
TOKEN_PATH = "/v1/oauth2/token"
|
||||
ORDERS_PATH = "/v1/pay-order/seller/product-orders"
|
||||
EVENT_PREFIX = "naver:"
|
||||
PAGE_SIZE = 100
|
||||
MAX_PAGES = 200 # 하루 2만 건 — 무한 반복 방지
|
||||
TOKEN_MARGIN_SEC = 300 # 만료 5분 전이면 새로 받는다
|
||||
CALL_INTERVAL_SEC = 0.35 # 초당 호출 제한(넘으면 429) — 호출 사이 간격
|
||||
RETRY_429 = 3
|
||||
PROBE_MAX_DAYS = 31
|
||||
|
||||
# 매출에서 빼는 상품주문 상태 — 결제되지 않은 것만(입금대기·미입금 취소). 결제 뒤 취소·반품된 것은 판매분석
|
||||
# "판매금액(총)"처럼 결제일 매출에 그대로 둔다(환불은 판매분석에서도 환불일에 따로 빠진다).
|
||||
EXCLUDED_STATUS = frozenset({"PAYMENT_WAITING", "CANCELED_BY_NOPAYMENT"})
|
||||
CLAIMED_STATUS = frozenset({"CANCELED", "RETURNED"}) # 결제 뒤 취소·반품 완료 — 원본 확인 표에 참고로 따로 보여 줌
|
||||
STATUS_KO = {
|
||||
"PAYMENT_WAITING": "입금대기", "PAYED": "결제완료", "DELIVERING": "배송중", "DELIVERED": "배송완료",
|
||||
"PURCHASE_DECIDED": "구매확정", "EXCHANGED": "교환", "CANCELED": "취소", "RETURNED": "반품",
|
||||
"CANCELED_BY_NOPAYMENT": "미입금취소",
|
||||
}
|
||||
|
||||
# 원본 데이터 확인 — 개인정보로 보이는 항목은 값 없이 이름만. 금액·상태·날짜·상품명 등은 보인다.
|
||||
PERSONAL = re.compile(r"orderer|receiver|shippingAddress|takingAddress|returnAddress|pickupAddress|collectAddress|"
|
||||
r"name$|tel|phone|address|zip|mail|memo|customsClearance|buyer|recipient", re.IGNORECASE)
|
||||
SAFE = re.compile(r"(productName|productOption|optionCode|productClass|productId|deliveryCompany|reason|Status|Type|"
|
||||
r"Date|Amount|Price|Fee|Quantity|Count|Id)$")
|
||||
NUMBER = re.compile(r"^-?\d+(\.\d+)?$")
|
||||
|
||||
|
||||
def _won(value: Any) -> int:
|
||||
try:
|
||||
return int(round(float(str(value if value is not None else 0).replace(",", ""))))
|
||||
except ValueError:
|
||||
return 0
|
||||
|
||||
|
||||
def _day(value: Any) -> date | None:
|
||||
""""2026-09-29T10:11:12.0+09:00" → date(2026, 9, 29). 네이버 날짜는 한국 시간(+09:00)으로 온다."""
|
||||
s = str(value or "")
|
||||
m = re.match(r"(\d{4})-(\d{2})-(\d{2})", s)
|
||||
if not m:
|
||||
return None
|
||||
try:
|
||||
return date(int(m.group(1)), int(m.group(2)), int(m.group(3)))
|
||||
except ValueError:
|
||||
return None
|
||||
|
||||
|
||||
def sign(client_id: str, client_secret: str, timestamp_ms: int) -> str:
|
||||
"""커머스API 전자서명 — bcrypt(비밀번호 = "{client_id}_{timestamp}", 솔트 = 애플리케이션 시크릿) 을 base64."""
|
||||
import bcrypt # 지연 import
|
||||
|
||||
try:
|
||||
hashed = bcrypt.hashpw(f"{client_id}_{timestamp_ms}".encode("utf-8"), client_secret.encode("utf-8"))
|
||||
except ValueError:
|
||||
raise AuthFailed("애플리케이션 시크릿 형식이 올바르지 않습니다. 커머스API센터의 시크릿을 그대로 붙여 넣으세요.") from None
|
||||
return base64.standard_b64encode(hashed).decode("ascii")
|
||||
|
||||
|
||||
def product_order_items(body: Any) -> list[dict[str, Any]]:
|
||||
"""조건형 조회 응답에서 상품주문 하나씩 {"order": {...}, "productOrder": {...}, ...} 로 꺼낸다.
|
||||
응답 모양(data.contents[].content / data 목록 / 바로 목록)이 달라도 받아들인다."""
|
||||
data = body.get("data", body) if isinstance(body, dict) else body
|
||||
if isinstance(data, dict):
|
||||
data = data.get("contents") or data.get("productOrders") or data.get("items") or []
|
||||
out = []
|
||||
for it in data if isinstance(data, list) else []:
|
||||
if not isinstance(it, dict):
|
||||
continue
|
||||
c = it.get("content") if isinstance(it.get("content"), dict) else it
|
||||
if isinstance(c.get("productOrder"), dict):
|
||||
out.append(c)
|
||||
return out
|
||||
|
||||
|
||||
def has_next(body: Any, page: int, got: int) -> bool:
|
||||
data = body.get("data") if isinstance(body, dict) else None
|
||||
pg = data.get("pagination") if isinstance(data, dict) else None
|
||||
if isinstance(pg, dict):
|
||||
if "hasNext" in pg:
|
||||
return bool(pg["hasNext"])
|
||||
total = pg.get("totalPages") or pg.get("totalPage")
|
||||
if total:
|
||||
return page < int(total)
|
||||
return got >= PAGE_SIZE
|
||||
|
||||
|
||||
def flatten(obj: Any, prefix: str = "") -> dict[str, str]:
|
||||
"""중첩 사전 → {"productOrder.totalPaymentAmount": "12000", …}. 목록은 건너뛴다(개수만)."""
|
||||
out: dict[str, str] = {}
|
||||
if isinstance(obj, dict):
|
||||
for k, v in obj.items():
|
||||
key = f"{prefix}.{k}" if prefix else str(k)
|
||||
if isinstance(v, dict):
|
||||
out.update(flatten(v, key))
|
||||
elif isinstance(v, list):
|
||||
out[key + "[]"] = str(len(v))
|
||||
elif v is not None:
|
||||
out[key] = str(v)
|
||||
return out
|
||||
|
||||
|
||||
def is_personal(key: str) -> bool:
|
||||
last = key.rsplit(".", 1)[-1]
|
||||
if "Address." in key or key.split(".")[0] in ("orderer",):
|
||||
return True
|
||||
return bool(PERSONAL.search(key)) and not SAFE.search(last)
|
||||
|
||||
|
||||
def field_summary(records: list[dict[str, str]]) -> list[dict[str, Any]]:
|
||||
"""항목별: 채워진 줄 수, 숫자면 합계, 개인정보 아니면 예시 값 하나."""
|
||||
names: dict[str, dict[str, Any]] = {}
|
||||
for r in records:
|
||||
for k, v in r.items():
|
||||
f = names.setdefault(k, {"name": k, "filled": 0, "numeric": True, "sum": 0.0, "sample": "",
|
||||
"personal": is_personal(k)})
|
||||
if v == "":
|
||||
continue
|
||||
f["filled"] += 1
|
||||
if NUMBER.match(v) and f["numeric"]:
|
||||
f["sum"] += float(v)
|
||||
else:
|
||||
f["numeric"] = False
|
||||
if not f["sample"] and not f["personal"]:
|
||||
f["sample"] = v[:40]
|
||||
for f in names.values():
|
||||
f["sum"] = int(round(f["sum"])) if f["numeric"] and f["filled"] else None
|
||||
return sorted(names.values(), key=lambda f: f["name"])
|
||||
|
||||
|
||||
def group_orders(items: Iterable[dict[str, Any]], start: date, end: date) -> dict[str, dict[str, Any]]:
|
||||
"""상품주문 → 주문 하나로 합침(결제일이 [start, end] 이고 결제된 것 — 나중에 취소·반품된 것도 포함).
|
||||
금액 = totalPaymentAmount 합(할인 뒤 상품 결제금액, 배송비 제외) = 판매분석 "판매금액(총)".
|
||||
배송비·취소/반품분은 참고용(ship·claimed)으로만 모은다."""
|
||||
orders: dict[str, dict[str, Any]] = {}
|
||||
for c in items:
|
||||
po, od = c.get("productOrder") or {}, c.get("order") or {}
|
||||
oid = str(od.get("orderId") or po.get("orderId") or "")
|
||||
day = _day(od.get("paymentDate") or po.get("paymentDate"))
|
||||
status = str(po.get("productOrderStatus") or "")
|
||||
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": [],
|
||||
"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"))
|
||||
o["qty"] += _won(po.get("quantity"))
|
||||
o["discount"] += _won(po.get("productDiscountAmount"))
|
||||
name = str(po.get("productName") or "")
|
||||
if name and name not in o["names"]:
|
||||
o["names"].append(name)
|
||||
o["opt"] = o["opt"] or str(po.get("productOption") or "")
|
||||
if status and status not in o["statuses"]:
|
||||
o["statuses"].append(status)
|
||||
return orders
|
||||
|
||||
|
||||
# 토큰을 발급한 인증정보 — 이 값들이 바뀌면 저장된 토큰을 쓰지 않고 새로 받는다(credential_fingerprint)
|
||||
TOKEN_KEYS = ("client_id", "client_secret", "account_id")
|
||||
|
||||
class NaverAdapter(MarketplaceAdapter):
|
||||
code = "naver"
|
||||
name = "네이버"
|
||||
auth_type = "oauth"
|
||||
implemented = True
|
||||
replace_range = True
|
||||
event_prefix = EVENT_PREFIX
|
||||
docs_url = "https://apicenter.commerce.naver.com/"
|
||||
note = ("커머스API센터에서 발급한 애플리케이션 ID/시크릿을 입력합니다. 애플리케이션의 API 호출 IP 에 "
|
||||
"이 서버의 외부 IP 를 등록해야 호출됩니다.")
|
||||
|
||||
def __init__(self) -> None:
|
||||
self._last_call = 0.0
|
||||
|
||||
def credential_fields(self) -> list[CredentialField]:
|
||||
return [
|
||||
CredentialField("client_id", "애플리케이션 ID(Client ID)"),
|
||||
CredentialField("client_secret", "애플리케이션 시크릿(Client Secret)", secret=True),
|
||||
CredentialField("account_id", "판매자 ID", required=False,
|
||||
help="솔루션(SELLER) 방식으로 발급한 경우에만 입력 — 내 스토어 전용 애플리케이션은 비워 둡니다"),
|
||||
CredentialField("access_token", "Access Token", secret=True, required=False, internal=True),
|
||||
CredentialField("access_token_expires_at", "Access Token 만료", required=False, internal=True),
|
||||
# 토큰을 발급한 인증정보 지문(원문 아님) — 계정·키를 바꾸면 이전 토큰을 쓰지 않는다(2026-10-15 검토 F04)
|
||||
CredentialField("access_token_for", "Access Token 발급 기준", required=False, internal=True),
|
||||
]
|
||||
|
||||
# ── 인증 ──────────────────────────────────────────────
|
||||
def _token(self, ctx: AdapterContext, *, force: bool = False) -> str:
|
||||
"""저장된 토큰이 5분 넘게 남았으면 그대로, 아니면 새로 받아 암호화 저장."""
|
||||
if not force:
|
||||
tok = ctx.credentials.get("access_token")
|
||||
try:
|
||||
exp = float(ctx.credentials.get("access_token_expires_at") or 0)
|
||||
except ValueError:
|
||||
exp = 0.0
|
||||
same_account = ctx.credentials.get("access_token_for") == credential_fingerprint(ctx.credentials, TOKEN_KEYS)
|
||||
if tok and same_account and exp - time.time() > TOKEN_MARGIN_SEC:
|
||||
return tok
|
||||
return self._issue_token(ctx)
|
||||
|
||||
def _issue_token(self, ctx: AdapterContext) -> str:
|
||||
import httpx # 지연 import
|
||||
|
||||
client_id = ctx.credentials.get("client_id").strip()
|
||||
client_secret = ctx.credentials.get("client_secret").strip()
|
||||
if not client_id or not client_secret:
|
||||
raise NotConfigured("애플리케이션 ID와 시크릿을 입력하세요.")
|
||||
ts = int(time.time() * 1000)
|
||||
form = {"client_id": client_id, "timestamp": str(ts), "grant_type": "client_credentials",
|
||||
"client_secret_sign": sign(client_id, client_secret, ts), "type": "SELF"}
|
||||
account_id = ctx.credentials.get("account_id").strip()
|
||||
if account_id:
|
||||
form.update(type="SELLER", account_id=account_id)
|
||||
try:
|
||||
res = httpx.post(f"{HOST}{TOKEN_PATH}", data=form, timeout=ctx.timeout_sec,
|
||||
headers={"Accept": "application/json"})
|
||||
except httpx.HTTPError as exc:
|
||||
raise ApiError(f"네이버 커머스API 연결 실패: {type(exc).__name__}") from None
|
||||
body = self._json(res)
|
||||
if res.status_code >= 400 or not body.get("access_token"):
|
||||
msg = self._err_text(body, res)
|
||||
if res.status_code in (400, 401, 403):
|
||||
raise AuthFailed(f"네이버 토큰 발급 실패({res.status_code}): {msg}. 애플리케이션 ID·시크릿과 "
|
||||
"API 호출 IP(이 서버 외부 IP) 등록을 확인하세요.")
|
||||
raise ApiError(f"네이버 토큰 발급 오류({res.status_code}): {msg}")
|
||||
tok = str(body["access_token"])
|
||||
expires_in = _won(body.get("expires_in")) or 3 * 3600
|
||||
ctx.credentials.set("access_token", tok)
|
||||
ctx.credentials.set("access_token_expires_at", str(int(time.time()) + expires_in))
|
||||
ctx.credentials.set("access_token_for", credential_fingerprint(ctx.credentials, TOKEN_KEYS))
|
||||
return tok
|
||||
|
||||
def authenticate(self, ctx: AdapterContext) -> None:
|
||||
super().authenticate(ctx)
|
||||
self._token(ctx)
|
||||
|
||||
def refresh_token(self, ctx: AdapterContext) -> None:
|
||||
self._token(ctx, force=True)
|
||||
|
||||
# ── 호출 ──────────────────────────────────────────────
|
||||
@staticmethod
|
||||
def _json(res: Any) -> dict[str, Any]:
|
||||
try:
|
||||
body = res.json()
|
||||
except ValueError:
|
||||
return {}
|
||||
return body if isinstance(body, dict) else {"data": body}
|
||||
|
||||
@staticmethod
|
||||
def _err_text(body: dict[str, Any], res: Any) -> str:
|
||||
parts = [str(body.get(k)) for k in ("code", "message", "error", "error_description") if body.get(k)]
|
||||
inv = body.get("invalidInputs")
|
||||
if isinstance(inv, list) and inv:
|
||||
parts.append("; ".join(str(i.get("message") or i) if isinstance(i, dict) else str(i) for i in inv[:3]))
|
||||
return " ".join(parts)[:300] or res.text[:200].strip() or "응답 없음"
|
||||
|
||||
def _get(self, ctx: AdapterContext, path: str, params: dict[str, Any]) -> dict[str, Any]:
|
||||
"""GET — 호출 간격 유지, 429 는 잠깐 쉬고 다시, 401 이면 토큰을 새로 받아 한 번 더."""
|
||||
import httpx # 지연 import
|
||||
|
||||
retried_auth = False
|
||||
for attempt in range(RETRY_429 + 1):
|
||||
ctx.progress.check() # [업데이트 취소]면 여기서 멈춤
|
||||
wait = CALL_INTERVAL_SEC - (time.monotonic() - self._last_call)
|
||||
if wait > 0:
|
||||
time.sleep(wait)
|
||||
headers = {"Authorization": f"Bearer {self._token(ctx)}", "Accept": "application/json"}
|
||||
try:
|
||||
res = httpx.get(f"{HOST}{path}", params=params, headers=headers, timeout=ctx.timeout_sec)
|
||||
except httpx.HTTPError as exc:
|
||||
raise ApiError(f"네이버 커머스API 연결 실패: {type(exc).__name__}") from None
|
||||
finally:
|
||||
self._last_call = time.monotonic()
|
||||
if res.status_code == 429 and attempt < RETRY_429:
|
||||
time.sleep(1.0 * (2 ** attempt))
|
||||
continue
|
||||
if res.status_code == 401 and not retried_auth:
|
||||
retried_auth = True
|
||||
self._token(ctx, force=True)
|
||||
continue
|
||||
body = self._json(res)
|
||||
if res.status_code == 401:
|
||||
raise TokenExpired(f"네이버 인증 만료·거부(401): {self._err_text(body, res)}")
|
||||
if res.status_code == 403:
|
||||
raise AuthFailed(f"네이버 권한 거부(403): {self._err_text(body, res)}. 애플리케이션의 API 권한(주문)과 "
|
||||
"API 호출 IP 등록을 확인하세요.")
|
||||
if res.status_code >= 400:
|
||||
raise ApiError(f"네이버 API 오류({res.status_code}): {self._err_text(body, res)}")
|
||||
return body
|
||||
raise ApiError("네이버 API 호출 제한(429)이 계속됩니다. 잠시 뒤 다시 시도하세요.")
|
||||
|
||||
def _day_items(self, ctx: AdapterContext, d: date) -> list[dict[str, Any]]:
|
||||
"""결제일이 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,
|
||||
}
|
||||
out: list[dict[str, Any]] = []
|
||||
for page in range(1, MAX_PAGES + 1):
|
||||
body = self._get(ctx, ORDERS_PATH, {**params, "page": page})
|
||||
items = product_order_items(body)
|
||||
out.extend(items)
|
||||
if not items or not has_next(body, page, len(items)):
|
||||
break
|
||||
else: # 쪽 수 상한을 다 썼는데 아직 다음 쪽이 있음 — 일부만 받은 채 저장하지 않게(검토 F05)
|
||||
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, "일") # 진행 막대: 하루 = 한 단계
|
||||
d = start
|
||||
while d <= end:
|
||||
rows = self._day_items(ctx, d)
|
||||
ctx.progress.step(items=len(rows))
|
||||
yield from rows
|
||||
d += timedelta(days=1)
|
||||
|
||||
# ── 수집 ──────────────────────────────────────────────
|
||||
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()
|
||||
|
||||
def normalize_order(self, o: dict[str, Any]) -> list[SaleEvent]:
|
||||
oid, day = str(o.get("orderId") or ""), o.get("_day")
|
||||
if not oid or day is None:
|
||||
return []
|
||||
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 []]
|
||||
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)),
|
||||
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],
|
||||
)]
|
||||
|
||||
def test_connection(self, ctx: AdapterContext) -> str:
|
||||
from app.timezone import today_kst # noqa: WPS433
|
||||
|
||||
# 입력한 새 값으로 시험할 수 있으니 저장된 토큰을 쓰지 않고 항상 새로 받는다.
|
||||
super().authenticate(ctx)
|
||||
self._token(ctx, force=True)
|
||||
items = self._day_items(ctx, today_kst())
|
||||
return f"네이버 커머스API 연결 정상(토큰 발급·주문 조회 확인, 오늘 결제 상품주문 {len(items)}건)."
|
||||
|
||||
# ── 원본 데이터 확인(설정 화면 "쇼핑몰 원본 데이터 확인") ─────────
|
||||
def reconcile(self, ctx: AdapterContext, day: date, to: date | None = None) -> dict[str, Any]:
|
||||
"""결제일 기준 기간(최대 31일)의 상품주문을 실제로 불러 항목별 합계·상태별 합계·날짜별 현재 규칙 매출을 돌려준다.
|
||||
스마트스토어센터 화면 매출과 어느 항목이 맞는지 실데이터로 확정하는 용도. 개인정보 항목은 값 없이 이름만."""
|
||||
self.authenticate(ctx)
|
||||
to = min(max(to or day, day), day + timedelta(days=PROBE_MAX_DAYS - 1))
|
||||
try:
|
||||
items = list(self._items(ctx, day, to))
|
||||
except AdapterError as exc:
|
||||
return {"date": day.isoformat(), "to": to.isoformat(), "probes": [
|
||||
{"key": "payed", "label": "결제일 기준 상품주문", "path": ORDERS_PATH, "ok": False, "error": exc.message[:300]}]}
|
||||
by_status: dict[str, list[dict[str, Any]]] = {}
|
||||
for c in items:
|
||||
by_status.setdefault(str((c.get("productOrder") or {}).get("productOrderStatus") or "?"), []).append(c)
|
||||
probes = [{"key": "payed", "label": "결제일 기준 상품주문(전체 상태)", "path": ORDERS_PATH + " (PAYED_DATETIME)",
|
||||
"ok": True, "count": len(items), "fields": field_summary([flatten(c) for c in items])}]
|
||||
for st, rows in sorted(by_status.items()):
|
||||
probes.append({"key": f"status-{st}", "label": f"상태 {STATUS_KO.get(st, st)}({st})"
|
||||
+ (" — 매출 제외(미결제)" if st in EXCLUDED_STATUS else
|
||||
" — 결제 뒤 취소·반품(매출 포함)" if st in CLAIMED_STATUS else ""), "path": "productOrderStatus",
|
||||
"ok": True, "count": len(rows),
|
||||
"fields": [f for f in field_summary([flatten(c) for c in rows])
|
||||
if f["sum"] is not None and f["name"].startswith("productOrder.")]})
|
||||
days = []
|
||||
orders = group_orders(items, day, to)
|
||||
d = day
|
||||
while d <= to:
|
||||
day_orders = [o for o in orders.values() if o["_day"] == d]
|
||||
days.append({"date": d.isoformat(), "orders": len(day_orders), "amount": sum(o["amount"] for o in day_orders),
|
||||
"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,
|
||||
"rule": "결제일 기준 상품주문 totalPaymentAmount 합(할인 뒤, 배송비 제외, 결제 뒤 취소·반품분 포함, "
|
||||
"미입금 제외) = 판매분석 '판매금액(총)'. 취소·반품분·배송비는 참고"}
|
||||
@@ -0,0 +1,22 @@
|
||||
"""오늘의집 — 파트너(판매자) API.
|
||||
|
||||
인증 방식·필드는 연동 단계에서 오늘의집 파트너 API 문서로 확정한다.
|
||||
"""
|
||||
|
||||
from __future__ import annotations
|
||||
|
||||
from .base import CredentialField, MarketplaceAdapter
|
||||
|
||||
|
||||
class OhouseAdapter(MarketplaceAdapter):
|
||||
code = "ohouse"
|
||||
name = "오늘의집"
|
||||
auth_type = "api_key"
|
||||
note = "입력 항목은 연동 단계에서 오늘의집 파트너 API 문서로 확정합니다."
|
||||
|
||||
def credential_fields(self) -> list[CredentialField]:
|
||||
return [
|
||||
CredentialField("seller_id", "판매자 ID"),
|
||||
CredentialField("api_key", "API Key", secret=True),
|
||||
CredentialField("api_secret", "API Secret", secret=True, required=False),
|
||||
]
|
||||
@@ -0,0 +1,45 @@
|
||||
"""쇼핑몰 어댑터 목록 — 새 쇼핑몰은 여기 한 줄 + 어댑터 파일 하나.
|
||||
|
||||
DB(perf_marketplaces)에 행이 없으면 설정 화면에서 쓸 수 없으므로, 새 쇼핑몰을
|
||||
추가할 때는 scripts/sql 의 seed(INSERT … ON CONFLICT DO NOTHING)에도 한 줄 넣는다.
|
||||
"""
|
||||
|
||||
from __future__ import annotations
|
||||
|
||||
from .base import MarketplaceAdapter
|
||||
from .cafe24 import Cafe24Adapter
|
||||
from .coupang import CoupangAdapter
|
||||
from .elevenst import ElevenstAdapter
|
||||
from .gmarket import GmarketAdapter
|
||||
from .gsshop import GsshopAdapter
|
||||
from .kakao import KakaoAdapter
|
||||
from .lotteon import LotteonAdapter
|
||||
from .manual import AtomyAzmallAdapter, CoupangRocketAdapter
|
||||
from .naver import NaverAdapter
|
||||
from .ohouse import OhouseAdapter
|
||||
from .toss import TossAdapter
|
||||
|
||||
_ADAPTERS: tuple[MarketplaceAdapter, ...] = (
|
||||
# 화면 순서와 같게(DB sort_order 도 같은 순서 — 마이그레이션 003)
|
||||
Cafe24Adapter(),
|
||||
NaverAdapter(),
|
||||
CoupangAdapter(), # 쿠팡(윙)
|
||||
CoupangRocketAdapter(), # 쿠팡(로켓) — 수동 입력 전용
|
||||
OhouseAdapter(),
|
||||
GmarketAdapter(),
|
||||
KakaoAdapter(),
|
||||
GsshopAdapter(),
|
||||
ElevenstAdapter(),
|
||||
LotteonAdapter(),
|
||||
TossAdapter(),
|
||||
AtomyAzmallAdapter(), # 애터미아자몰 — 수동 입력 전용
|
||||
)
|
||||
_BY_CODE = {a.code: a for a in _ADAPTERS}
|
||||
|
||||
|
||||
def all_adapters() -> tuple[MarketplaceAdapter, ...]:
|
||||
return _ADAPTERS
|
||||
|
||||
|
||||
def get_adapter(code: str) -> MarketplaceAdapter | None:
|
||||
return _BY_CODE.get(code)
|
||||
@@ -0,0 +1,630 @@
|
||||
"""토스쇼핑 — 토스쇼핑 API(shopping-fep).
|
||||
|
||||
문서: https://shopping-docs.toss.im/dev (전체 목록 llms.txt, 각 쪽 주소 뒤에 .md 를 붙이면 원문)
|
||||
|
||||
인증(공식 방식): 토스쇼핑 파트너스 → 상점 이름 > 가맹점·계정 관리 > 자체 개발 → [키 발급](호출 IP 입력) →
|
||||
Access Key·Secret Key. OAuth2 client_credentials 로 토큰을 받는다.
|
||||
POST https://oauth2.cert.toss.im/token (form: grant_type=client_credentials, client_id=Access Key,
|
||||
client_secret=Secret Key, scope=toss-shopping-fep:write)
|
||||
응답 expires_in 은 약 1년 — 매번 새로 받으면 이용이 제한될 수 있어(문서 안내) 암호화 저장해 두고 재사용,
|
||||
401 이면 한 번만 새로 받는다. **키 발급 때 넣은 IP(이 서버 외부 IP)에서만 호출된다.**
|
||||
API 는 https://shopping-fep.toss.im, 헤더 Authorization: Bearer {token}. HTTP 200 + resultType FAIL 로 오류를 준다.
|
||||
호출 제한: 셀러·API 별 읽기 초당 50회(넘으면 TOO_MANY_REQUEST).
|
||||
|
||||
매출 = 토스쇼핑 파트너스 "순 거래액" = 매출 − 환불(2026-10-01 사용자 지정, 9/6 화면: 매출 29,600 − 환불 11,900 = 17,700).
|
||||
- 매출 SALE — 주문 내역 조회 GET /api/v3/shopping-fep/orders/v2?startDate=&endDate=&limit=50&nextCursor=
|
||||
(한 번에 31일까지, 상태 생략 = 전체 상태, 커서 페이지). 줄 = 주문상품(orderProductId), 묶음 = 주문(orderId).
|
||||
주문 하나 = 사건 하나(`toss:{orderId}`), 날짜 = 주문 시각(orderedAt, 한국 날짜 — 토스쇼핑은 주문 = 결제),
|
||||
금액 = 주문상품 price(판매가 × 수량) 합 — 할인 전, 배송비 제외. 할인(totalDiscountPrice = 토스쇼핑 할인 + 토스페이 할인)은
|
||||
discount_amount 로만 보관. 결제 전(BEFORE_PAYMENT)만 빼고 결제 뒤 취소·반품도 주문일 매출에 둔다(화면 "매출"도 환불 전 금액).
|
||||
- 환불 CANCEL/RETURN — 환불일에 뺀다. 주문상품 하나에 한 번(사건 ID `toss:R{orderProductId}`). `merge_refunds`:
|
||||
① 클레임 목록 GET /api/v3/shopping-fep/claims(날짜 조건이 없어 전체를 넘긴다)의 환불 완료(isRefunded) CANCEL·RETURN —
|
||||
날짜 = refundedDt(한국 날짜). 반품은 이것뿐(주문 내역엔 반품 완료 날짜가 없다).
|
||||
② 클레임이 없는 결제취소 — 주문 내역의 canceledAt(한국 날짜). 결제완료 단계의 고객 취소는 클레임이 생기지 않는다(문서).
|
||||
기간보다 CANCEL_LOOKBACK_DAYS(90)일 앞 주문까지 불러 다른 날 주문을 기간 안에 취소한 것도 잡는다.
|
||||
금액 = 그 주문상품의 price(판매가 × 수량, 매출과 같은 기준), 주문 내역에 없으면(90일보다 오래된 주문) 클레임 order.price.
|
||||
9/6 실데이터: 9/5 주문(276435356)을 9/6 취소 11,900 — 클레임(CANCEL/COMPLETED)·canceledAt 둘 다 9/6 = 화면 환불 11,900.
|
||||
정산 건별(settlement-steps)의 REFUND 는 이 취소를 담지 않아(구매확정 전 취소는 정산에 안 올라옴) 쓰지 않는다.
|
||||
- 설정 화면 "쇼핑몰 원본 데이터 확인"에 날짜별 매출·환불·순 거래액과 환불 출처별(정산·취소 시각·클레임) 비교.
|
||||
- 구매자·수령인 이름·연락처·주소·요청사항은 저장하지 않는다.
|
||||
"""
|
||||
|
||||
from __future__ import annotations
|
||||
|
||||
import re
|
||||
import time
|
||||
from datetime import date, datetime, timedelta, timezone
|
||||
from typing import Any, Iterable
|
||||
|
||||
from .base import (
|
||||
credential_fingerprint,
|
||||
AdapterContext,
|
||||
AdapterError,
|
||||
ApiError,
|
||||
AuthFailed,
|
||||
CredentialField,
|
||||
MarketplaceAdapter,
|
||||
NotConfigured,
|
||||
SaleEvent,
|
||||
TokenExpired,
|
||||
)
|
||||
from .naver import field_summary, flatten
|
||||
|
||||
TOKEN_URL = "https://oauth2.cert.toss.im/token"
|
||||
HOST = "https://shopping-fep.toss.im"
|
||||
ORDERS_PATH = "/api/v3/shopping-fep/orders/v2"
|
||||
SETTLEMENT_PATH = "/api/v3/shopping-fep/settlement-steps"
|
||||
SETTLEMENT_SIZE = 100 # 문서 1~100
|
||||
SCOPE = "toss-shopping-fep:write"
|
||||
EVENT_PREFIX = "toss:"
|
||||
PAGE_SIZE = 50 # 문서 최대 50
|
||||
WINDOW_DAYS = 31 # 한 번에 31일까지
|
||||
MAX_PAGES = 2000 # 한 구간 10만 건 — 무한 반복 방지
|
||||
TOKEN_MARGIN_SEC = 3600 # 만료 1시간 전이면 새로 받는다(토큰은 약 1년)
|
||||
CALL_INTERVAL_SEC = 0.1 # 읽기 초당 50회 제한 — 넉넉히
|
||||
RETRY_429 = 3
|
||||
PROBE_MAX_DAYS = 31
|
||||
KST = timezone(timedelta(hours=9))
|
||||
|
||||
# 결제 전 주문만 매출에서 뺀다. 결제 뒤 취소·반품은 주문일 매출에 두고 원본 확인 표에 참고로 따로 보인다.
|
||||
EXCLUDED_STATUS = frozenset({"BEFORE_PAYMENT"})
|
||||
CLAIMED_STATUS = frozenset({"CANCELED_PAYMENT", "COMPLETED_RETURN"})
|
||||
STATUS_KO = {
|
||||
"BEFORE_PAYMENT": "결제전", "PAID": "결제완료", "PREPARING_PRODUCT": "상품준비중", "DELIVERING": "배송중",
|
||||
"DELIVERED": "배송완료", "CONFIRMED_ORDER": "구매확정", "CLAIM_REQUESTED_CANCEL": "취소요청",
|
||||
"CANCELED_PAYMENT": "결제취소", "CLAIM_REJECTED_CANCEL": "취소거절", "REQUESTED_EXCHANGE": "교환요청",
|
||||
"ONGOING_EXCHANGE": "교환중", "COMPLETED_EXCHANGE": "교환완료", "CLAIM_REJECTED_EXCHANGE": "교환거절",
|
||||
"REQUESTED_RETURN": "반품요청", "ONGOING_RETURN": "반품중", "COMPLETED_RETURN": "반품완료",
|
||||
"CLAIM_REJECTED_RETURN": "반품거절", "CLAIM_COLLECTING": "수거중", "CLAIM_COLLECTED": "수거완료",
|
||||
"CLAIM_DELIVERING": "재배송중",
|
||||
}
|
||||
# 원본 데이터 확인에서 값을 숨기는 항목(개인정보·자유 입력)
|
||||
PERSONAL_KEYS = frozenset({
|
||||
"ordererName", "ordererPhone", "ordererRealPhone", "receiverName", "receiverPhone", "receiverRealPhone",
|
||||
"address", "detailAddress", "zipCode", "shippingNote", "shippingTrackingNumber",
|
||||
# 클레임 목록(order.* · 수거 주소 · 요청 사유 자유 입력 · 첨부 사진)
|
||||
"ordererPhoneNumber", "receiverPhoneNumber", "returnAddress", "requestReason", "requestDetailReason",
|
||||
"requestImages[]",
|
||||
})
|
||||
CLAIMS_PATH = "/api/v3/shopping-fep/claims"
|
||||
CLAIM_PAGE_SIZE = 100
|
||||
CLAIM_MAX_PAGES = 100 # 클레임 목록은 날짜로 못 거른다(전체를 넘긴다) — 1만 건까지
|
||||
CANCEL_LOOKBACK_DAYS = 90 # 환불 후보(주문 취소 시각): 이만큼 전 주문까지 본다
|
||||
|
||||
|
||||
def _won(value: Any) -> int:
|
||||
try:
|
||||
return int(round(float(str(value if value is not None else 0).replace(",", ""))))
|
||||
except ValueError:
|
||||
return 0
|
||||
|
||||
|
||||
def kst_day(value: Any) -> date | None:
|
||||
"""주문 시각 → 한국 날짜. 시간대가 붙어 있으면(Z, +00:00 …) 한국 시간으로 바꾸고, 없으면 한국 시간으로 본다."""
|
||||
s = str(value or "").strip()
|
||||
if not s:
|
||||
return None
|
||||
try:
|
||||
dt = datetime.fromisoformat(s.replace("Z", "+00:00"))
|
||||
except ValueError:
|
||||
m = re.match(r"(\d{4})-(\d{2})-(\d{2})", s)
|
||||
if not m:
|
||||
return None
|
||||
try:
|
||||
return date(int(m.group(1)), int(m.group(2)), int(m.group(3)))
|
||||
except ValueError:
|
||||
return None
|
||||
if dt.tzinfo is not None:
|
||||
dt = dt.astimezone(KST)
|
||||
return dt.date()
|
||||
|
||||
|
||||
def group_orders(items: Iterable[dict[str, Any]], start: date, end: date) -> dict[str, dict[str, Any]]:
|
||||
"""주문상품 → 주문 하나로 합침(주문일이 [start, end] 이고 결제된 것 — 나중에 취소·반품된 것도 포함).
|
||||
금액 = price(판매가 × 수량) 합(할인 전, 배송비 제외). 할인·배송비·취소/반품분은 참고용으로 모은다.
|
||||
배송비는 묶음(deliveryFeeGroupId)마다 한 번만 센다."""
|
||||
orders: dict[str, dict[str, Any]] = {}
|
||||
ship_groups: set[str] = set()
|
||||
for it in items:
|
||||
oid = str(it.get("orderId") or "")
|
||||
day = kst_day(it.get("orderedAt"))
|
||||
status = str(it.get("orderProductStatus") or "")
|
||||
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": []})
|
||||
price = _won(it.get("price"))
|
||||
o["amount"] += price
|
||||
if status in CLAIMED_STATUS:
|
||||
o["claimed"] += price
|
||||
group = str(it.get("deliveryFeeGroupId") or f"{oid}-{it.get('orderProductId')}")
|
||||
if group not in ship_groups:
|
||||
ship_groups.add(group)
|
||||
o["ship"] += _won(it.get("deliveryFee"))
|
||||
o["qty"] += _won(it.get("quantity"))
|
||||
o["discount"] += _won(it.get("totalDiscountPrice"))
|
||||
name = str(it.get("productName") or "")
|
||||
if name and name not in o["names"]:
|
||||
o["names"].append(name)
|
||||
o["opt"] = o["opt"] or str(it.get("optionName") or "")
|
||||
if status and status not in o["statuses"]:
|
||||
o["statuses"].append(status)
|
||||
return orders
|
||||
|
||||
|
||||
def refund_rows(items: Iterable[dict[str, Any]], start: date, end: date) -> list[dict[str, Any]]:
|
||||
"""정산 건별 목록 → 환불(stepType REFUND) 상품 줄만, 환불일(transactionTs 한국 날짜)이 [start, end] 인 것.
|
||||
금액은 양수로(사건에서 − 를 붙인다). 배송비 줄(orderProductId 없음)은 매출에 배송비를 넣지 않으므로 뺀다."""
|
||||
out = []
|
||||
for it in items:
|
||||
if str(it.get("stepType") or "") != "REFUND" or not it.get("orderProductId") or not it.get("orderId"):
|
||||
continue
|
||||
day = kst_day(it.get("transactionTs"))
|
||||
if day is None or not (start <= day <= end):
|
||||
continue
|
||||
amount = abs(_won(it.get("orderProductPrice"))) or abs(_won(it.get("stockPrice"))) * max(1, _won(it.get("quantity")))
|
||||
out.append({"orderId": str(it["orderId"]), "orderProductId": str(it["orderProductId"]),
|
||||
"_day": day, "_ts": str(it.get("transactionTs") or ""), "amount": amount,
|
||||
"qty": _won(it.get("quantity")), "name": str(it.get("displayProductName") or ""),
|
||||
"order_day": kst_day(it.get("originTransactionTs"))})
|
||||
return out
|
||||
|
||||
|
||||
def cancel_rows(items: Iterable[dict[str, Any]], start: date, end: date) -> list[dict[str, Any]]:
|
||||
"""환불 후보 — 주문 내역의 취소 시각(canceledAt 한국 날짜)이 [start, end] 인 주문상품. 금액 = price(판매가 × 수량)."""
|
||||
out = []
|
||||
for it in items:
|
||||
day = kst_day(it.get("canceledAt"))
|
||||
if not it.get("orderId") or day is None or not (start <= day <= end):
|
||||
continue
|
||||
status = str(it.get("orderProductStatus") or "")
|
||||
out.append({"orderId": str(it["orderId"]), "orderProductId": str(it.get("orderProductId") or ""), "_day": day,
|
||||
"amount": _won(it.get("price")), "status": status, "note": STATUS_KO.get(status, status),
|
||||
"order_day": kst_day(it.get("orderedAt"))})
|
||||
return out
|
||||
|
||||
|
||||
def claim_rows(items: Iterable[dict[str, Any]], start: date, end: date) -> list[dict[str, Any]]:
|
||||
"""환불 후보 — 클레임 목록의 환불 완료(isRefunded, refundedDt 한국 날짜)가 [start, end] 인 것.
|
||||
금액 = order.price(문서: "상품 가격" — 수량을 곱한 값인지 실데이터로 확인), 수량은 note 에."""
|
||||
out = []
|
||||
for it in items:
|
||||
day = kst_day(it.get("refundedDt"))
|
||||
order = it.get("order") if isinstance(it.get("order"), dict) else {}
|
||||
product = it.get("product") if isinstance(it.get("product"), dict) else {}
|
||||
if not it.get("isRefunded") or day is None or not (start <= day <= end) or not order.get("id"):
|
||||
continue
|
||||
out.append({"orderId": str(order["id"]), "orderProductId": str(order.get("orderProductId") or ""), "_day": day,
|
||||
"amount": _won(order.get("price")), "note": f"{it.get('type') or '?'}/{it.get('status') or '?'} · "
|
||||
f"수량 {_won(product.get('quantity'))}", "order_day": kst_day(order.get("createdDt"))})
|
||||
return out
|
||||
|
||||
|
||||
def merge_refunds(order_items: Iterable[dict[str, Any]], claims: Iterable[dict[str, Any]],
|
||||
start: date, end: date) -> list[dict[str, Any]]:
|
||||
"""환불 규칙 — 클레임 환불 완료(CANCEL·RETURN, refundedDt) + 클레임이 없는 결제취소(canceledAt), 주문상품마다 한 번.
|
||||
금액은 주문 내역의 price(판매가 × 수량)를 우선(없으면 클레임 order.price). 날짜가 [start, end] 인 것만.
|
||||
클레임이 있는 주문상품은 그 클레임 날짜만 쓴다(기간 밖이어도 취소 시각으로 다시 넣지 않음 — 날짜가 바뀌지 않게)."""
|
||||
order_items = list(order_items)
|
||||
by_op = {str(it.get("orderProductId")): it for it in order_items if it.get("orderProductId")}
|
||||
out: dict[str, dict[str, Any]] = {}
|
||||
claimed_ops: set[str] = set()
|
||||
for c in claims:
|
||||
order = c.get("order") if isinstance(c.get("order"), dict) else {}
|
||||
product = c.get("product") if isinstance(c.get("product"), dict) else {}
|
||||
kind = str(c.get("type") or "")
|
||||
op = str(order.get("orderProductId") or "")
|
||||
if not c.get("isRefunded") or kind not in ("CANCEL", "RETURN") or not order.get("id") or not op:
|
||||
continue
|
||||
claimed_ops.add(op)
|
||||
day = kst_day(c.get("refundedDt"))
|
||||
if day is None or not (start <= day <= end) or op in out:
|
||||
continue
|
||||
it = by_op.get(op) or {}
|
||||
out[op] = {"orderId": str(order["id"]), "orderProductId": op, "_day": day, "type": kind,
|
||||
"amount": _won(it["price"]) if "price" in it else _won(order.get("price")),
|
||||
"qty": _won(it.get("quantity")) or _won(product.get("quantity")),
|
||||
"name": str(it.get("productName") or product.get("name") or ""),
|
||||
"order_day": kst_day(it.get("orderedAt") or order.get("createdDt"))}
|
||||
for r in cancel_rows(order_items, start, end):
|
||||
op = r["orderProductId"]
|
||||
if not op or op in claimed_ops or op in out or r["status"] != "CANCELED_PAYMENT":
|
||||
continue
|
||||
it = by_op.get(op) or {}
|
||||
out[op] = {"orderId": r["orderId"], "orderProductId": op, "_day": r["_day"], "type": "CANCEL",
|
||||
"amount": r["amount"], "qty": _won(it.get("quantity")), "name": str(it.get("productName") or ""),
|
||||
"order_day": kst_day(it.get("orderedAt"))}
|
||||
return sorted(out.values(), key=lambda x: (x["_day"], x["orderId"], x["orderProductId"]))
|
||||
|
||||
|
||||
def summary(rows: list[dict[str, Any]]) -> list[dict[str, Any]]:
|
||||
"""원본 확인 표 — 항목별 채워진 줄·숫자 합계·예시 값(개인정보·자유 입력 항목은 값·합계 숨김)."""
|
||||
fields = field_summary([flatten(r) for r in rows])
|
||||
for f in fields:
|
||||
if f["name"].rsplit(".", 1)[-1] in PERSONAL_KEYS:
|
||||
f["personal"], f["sample"], f["sum"] = True, "", None
|
||||
return fields
|
||||
|
||||
|
||||
# 토큰을 발급한 인증정보 — 이 값들이 바뀌면 저장된 토큰을 쓰지 않고 새로 받는다(credential_fingerprint)
|
||||
TOKEN_KEYS = ("api_key", "api_secret")
|
||||
|
||||
class TossAdapter(MarketplaceAdapter):
|
||||
code = "toss"
|
||||
name = "토스쇼핑"
|
||||
auth_type = "oauth"
|
||||
implemented = True
|
||||
replace_range = True
|
||||
event_prefix = EVENT_PREFIX
|
||||
docs_url = "https://shopping-docs.toss.im/dev"
|
||||
note = ("토스쇼핑 파트너스 → 가맹점·계정 관리 → 자체 개발에서 발급한 Access Key·Secret Key 를 입력합니다. "
|
||||
"키 발급 때 이 서버의 외부 IP 를 등록해야 호출됩니다.")
|
||||
|
||||
def __init__(self) -> None:
|
||||
self._last_call = 0.0
|
||||
|
||||
def credential_fields(self) -> list[CredentialField]:
|
||||
# 키 이름(api_key·api_secret)은 처음 만든 입력칸 그대로 — 이미 저장한 값이 이어진다.
|
||||
return [
|
||||
CredentialField("api_key", "Access Key", secret=True,
|
||||
help="토스쇼핑 파트너스 → 가맹점·계정 관리 → 자체 개발의 Access Key"),
|
||||
CredentialField("api_secret", "Secret Key", secret=True,
|
||||
help="같은 화면의 Secret Key"),
|
||||
CredentialField("access_token", "Access Token", secret=True, required=False, internal=True),
|
||||
CredentialField("access_token_expires_at", "Access Token 만료", required=False, internal=True),
|
||||
# 토큰을 발급한 인증정보 지문(원문 아님) — 계정·키를 바꾸면 이전 토큰을 쓰지 않는다(2026-10-15 검토 F04)
|
||||
CredentialField("access_token_for", "Access Token 발급 기준", required=False, internal=True),
|
||||
]
|
||||
|
||||
# ── 인증 ──────────────────────────────────────────────
|
||||
def _token(self, ctx: AdapterContext, *, force: bool = False) -> str:
|
||||
"""저장된 토큰이 1시간 넘게 남았으면 그대로, 아니면 새로 받아 암호화 저장."""
|
||||
if not force:
|
||||
tok = ctx.credentials.get("access_token")
|
||||
try:
|
||||
exp = float(ctx.credentials.get("access_token_expires_at") or 0)
|
||||
except ValueError:
|
||||
exp = 0.0
|
||||
same_account = ctx.credentials.get("access_token_for") == credential_fingerprint(ctx.credentials, TOKEN_KEYS)
|
||||
if tok and same_account and exp - time.time() > TOKEN_MARGIN_SEC:
|
||||
return tok
|
||||
return self._issue_token(ctx)
|
||||
|
||||
def _issue_token(self, ctx: AdapterContext) -> str:
|
||||
import httpx # 지연 import
|
||||
|
||||
access_key = ctx.credentials.get("api_key").strip()
|
||||
secret_key = ctx.credentials.get("api_secret").strip()
|
||||
if not access_key or not secret_key:
|
||||
raise NotConfigured("Access Key 와 Secret Key 를 입력하세요.")
|
||||
form = {"grant_type": "client_credentials", "client_id": access_key, "client_secret": secret_key,
|
||||
"scope": SCOPE}
|
||||
try:
|
||||
res = httpx.post(TOKEN_URL, data=form, timeout=ctx.timeout_sec,
|
||||
headers={"Accept": "application/json; charset=UTF-8"})
|
||||
except httpx.HTTPError as exc:
|
||||
raise ApiError(f"토스 인증 서버 연결 실패: {type(exc).__name__}") from None
|
||||
body = self._json(res)
|
||||
if res.status_code >= 400 or not body.get("access_token"):
|
||||
msg = self._err_text(body, res)
|
||||
if res.status_code in (400, 401, 403):
|
||||
raise AuthFailed(f"토스쇼핑 토큰 발급 실패({res.status_code}): {msg}. Access Key·Secret Key 와 "
|
||||
"키 발급 때 등록한 IP(이 서버 외부 IP)를 확인하세요.")
|
||||
raise ApiError(f"토스쇼핑 토큰 발급 오류({res.status_code}): {msg}")
|
||||
tok = str(body["access_token"])
|
||||
expires_in = _won(body.get("expires_in")) or 24 * 3600
|
||||
ctx.credentials.set("access_token", tok)
|
||||
ctx.credentials.set("access_token_expires_at", str(int(time.time()) + expires_in))
|
||||
ctx.credentials.set("access_token_for", credential_fingerprint(ctx.credentials, TOKEN_KEYS))
|
||||
return tok
|
||||
|
||||
def authenticate(self, ctx: AdapterContext) -> None:
|
||||
super().authenticate(ctx)
|
||||
self._token(ctx)
|
||||
|
||||
def refresh_token(self, ctx: AdapterContext) -> None:
|
||||
self._token(ctx, force=True)
|
||||
|
||||
# ── 호출 ──────────────────────────────────────────────
|
||||
@staticmethod
|
||||
def _json(res: Any) -> dict[str, Any]:
|
||||
try:
|
||||
body = res.json()
|
||||
except ValueError:
|
||||
return {}
|
||||
return body if isinstance(body, dict) else {"data": body}
|
||||
|
||||
@staticmethod
|
||||
def _err_text(body: dict[str, Any], res: Any) -> str:
|
||||
err = body.get("error")
|
||||
if isinstance(err, dict):
|
||||
parts = [str(err.get(k)) for k in ("errorCode", "errorType", "reason", "message") if err.get(k)]
|
||||
else:
|
||||
parts = [str(body.get(k)) for k in ("error", "error_description", "code", "message") if body.get(k)]
|
||||
return " ".join(parts)[:300] or res.text[:200].strip() or "응답 없음"
|
||||
|
||||
def _get(self, ctx: AdapterContext, path: str, params: dict[str, Any]) -> dict[str, Any]:
|
||||
"""GET — 호출 간격 유지, 429·TOO_MANY_REQUEST 는 잠깐 쉬고 다시, 401 이면 토큰을 새로 받아 한 번 더.
|
||||
성공이면 success 내용을 돌려준다(토스쇼핑은 HTTP 200 + resultType FAIL 로도 오류를 준다)."""
|
||||
import httpx # 지연 import
|
||||
|
||||
retried_auth = False
|
||||
for attempt in range(RETRY_429 + 1):
|
||||
ctx.progress.check() # [업데이트 취소]면 여기서 멈춤
|
||||
wait = CALL_INTERVAL_SEC - (time.monotonic() - self._last_call)
|
||||
if wait > 0:
|
||||
time.sleep(wait)
|
||||
headers = {"Authorization": f"Bearer {self._token(ctx)}", "Accept": "application/json"}
|
||||
try:
|
||||
res = httpx.get(f"{HOST}{path}", params=params, headers=headers, timeout=ctx.timeout_sec)
|
||||
except httpx.HTTPError as exc:
|
||||
raise ApiError(f"토스쇼핑 API 연결 실패: {type(exc).__name__}") from None
|
||||
finally:
|
||||
self._last_call = time.monotonic()
|
||||
body = self._json(res)
|
||||
err = body.get("error") if isinstance(body.get("error"), dict) else {}
|
||||
limited = res.status_code == 429 or "TOO_MANY" in str(err.get("errorCode") or err.get("errorType") or "")
|
||||
if limited and attempt < RETRY_429:
|
||||
time.sleep(1.0 * (2 ** attempt))
|
||||
continue
|
||||
if res.status_code == 401 and not retried_auth:
|
||||
retried_auth = True
|
||||
self._token(ctx, force=True)
|
||||
continue
|
||||
if res.status_code == 401:
|
||||
raise TokenExpired(f"토스쇼핑 인증 만료·거부(401): {self._err_text(body, res)}")
|
||||
if res.status_code == 403:
|
||||
raise AuthFailed(f"토스쇼핑 권한 거부(403): {self._err_text(body, res)}. 키 발급 때 등록한 IP"
|
||||
"(이 서버 외부 IP)를 확인하세요.")
|
||||
if limited:
|
||||
raise ApiError("토스쇼핑 API 호출 제한이 계속됩니다. 잠시 뒤 다시 시도하세요.")
|
||||
if res.status_code >= 400:
|
||||
raise ApiError(f"토스쇼핑 API 오류({res.status_code}): {self._err_text(body, res)}")
|
||||
if body.get("resultType") == "FAIL":
|
||||
raise ApiError(f"토스쇼핑 API 오류: {self._err_text(body, res)}")
|
||||
success = body.get("success")
|
||||
return success if isinstance(success, dict) else {}
|
||||
raise ApiError("토스쇼핑 API 호출 제한이 계속됩니다. 잠시 뒤 다시 시도하세요.")
|
||||
|
||||
def _window_items(self, ctx: AdapterContext, a: date, b: date) -> list[dict[str, Any]]:
|
||||
"""조회 기간 [a, b](31일 이하)의 주문상품 전체 — 모든 상태, 커서로 끝까지."""
|
||||
params: dict[str, Any] = {"startDate": a.isoformat(), "endDate": b.isoformat(), "limit": PAGE_SIZE}
|
||||
out: list[dict[str, Any]] = []
|
||||
cursor = None
|
||||
seen: set[str] = set()
|
||||
for _ in range(MAX_PAGES):
|
||||
body = self._get(ctx, ORDERS_PATH, {**params, **({"nextCursor": cursor} if cursor else {})})
|
||||
rows = [r for r in body.get("results") or [] if isinstance(r, dict)]
|
||||
out.extend(rows)
|
||||
cursor = body.get("nextCursor")
|
||||
if not cursor or not rows:
|
||||
break
|
||||
if str(cursor) in seen: # 커서 반복 — 끝까지 받았는지 알 수 없다(검토 F05)
|
||||
raise ApiError(f"토스 주문 {a.isoformat()}~{b.isoformat()} 다음 쪽 표시가 반복됩니다 — 저장하지 않았습니다.")
|
||||
seen.add(str(cursor))
|
||||
else:
|
||||
raise ApiError(f"토스 주문 {a.isoformat()}~{b.isoformat()} 이 {MAX_PAGES}쪽을 넘어 끝까지 받지 못했습니다 — 저장하지 않았습니다.")
|
||||
return out
|
||||
|
||||
def _settlement_items(self, ctx: AdapterContext, a: date, b: date) -> list[dict[str, Any]]:
|
||||
"""거래일 기준 [a, b](31일 이하)의 정산 건별 줄 전체(결제·환불·배송비), nextToken 으로 끝까지."""
|
||||
params: dict[str, Any] = {"dateCondition": "TRANSACTION_DATE", "fromDate": a.isoformat(),
|
||||
"toDate": b.isoformat(), "size": SETTLEMENT_SIZE}
|
||||
out: list[dict[str, Any]] = []
|
||||
token = None
|
||||
seen: set[str] = set()
|
||||
for _ in range(MAX_PAGES):
|
||||
body = self._get(ctx, SETTLEMENT_PATH, {**params, **({"nextToken": token} if token else {})})
|
||||
rows = [r for r in body.get("items") or [] if isinstance(r, dict)]
|
||||
out.extend(rows)
|
||||
token = body.get("nextToken")
|
||||
if not token or not rows:
|
||||
break
|
||||
if str(token) in seen: # 커서 반복 — 끝까지 받았는지 알 수 없다(검토 F05)
|
||||
raise ApiError(f"토스 정산 {a.isoformat()}~{b.isoformat()} 다음 쪽 표시가 반복됩니다 — 저장하지 않았습니다.")
|
||||
seen.add(str(token))
|
||||
else:
|
||||
raise ApiError(f"토스 정산 {a.isoformat()}~{b.isoformat()} 이 {MAX_PAGES}쪽을 넘어 끝까지 받지 못했습니다 — 저장하지 않았습니다.")
|
||||
return out
|
||||
|
||||
def _claims(self, ctx: AdapterContext) -> list[dict[str, Any]]:
|
||||
"""클레임 목록 전체(유형·상태 조건 없음 = 전부 — 이 API 는 그 밖엔 날짜로 거를 수 없다), nextToken 으로 끝까지."""
|
||||
out: list[dict[str, Any]] = []
|
||||
token = None
|
||||
seen: set[str] = set()
|
||||
for _ in range(CLAIM_MAX_PAGES):
|
||||
body = self._get(ctx, CLAIMS_PATH, {"size": CLAIM_PAGE_SIZE, **({"nextToken": token} if token else {})})
|
||||
rows = [r for r in body.get("items") or [] if isinstance(r, dict)]
|
||||
out.extend(rows)
|
||||
token = body.get("nextToken")
|
||||
if not token or not rows or body.get("hasNext") is False:
|
||||
break
|
||||
if str(token) in seen: # 커서 반복 — 끝까지 받았는지 알 수 없다(검토 F05)
|
||||
raise ApiError("토스 클레임 목록의 다음 쪽 표시가 반복됩니다 — 저장하지 않았습니다.")
|
||||
seen.add(str(token))
|
||||
else:
|
||||
raise ApiError(f"토스 클레임 목록이 {CLAIM_MAX_PAGES}쪽을 넘어 끝까지 받지 못했습니다 — 저장하지 않았습니다.")
|
||||
return out
|
||||
|
||||
@staticmethod
|
||||
def _windows(start: date, end: date) -> list[tuple[date, date]]:
|
||||
windows = []
|
||||
a = start
|
||||
while a <= end:
|
||||
b = min(end, a + timedelta(days=WINDOW_DAYS - 1))
|
||||
windows.append((a, b))
|
||||
a = b + timedelta(days=1)
|
||||
return windows
|
||||
|
||||
def _items(self, ctx: AdapterContext, start: date, end: date) -> Iterable[dict[str, Any]]:
|
||||
"""주문 내역(매출) — 31일 구간마다 진행 막대 한 칸(plan 은 부르는 쪽이 주문 + 정산 구간 수로 정한다)."""
|
||||
for a, b in self._windows(start, end):
|
||||
rows = self._window_items(ctx, a, b)
|
||||
ctx.progress.step(items=len(rows))
|
||||
yield from rows
|
||||
|
||||
def _refund_items(self, ctx: AdapterContext, start: date, end: date) -> Iterable[dict[str, Any]]:
|
||||
"""정산 건별(환불이 들어 있음) — 31일 구간마다 진행 막대 한 칸."""
|
||||
for a, b in self._windows(start, end):
|
||||
rows = self._settlement_items(ctx, a, b)
|
||||
ctx.progress.step(items=len(rows))
|
||||
yield from rows
|
||||
|
||||
def _lookback_items(self, ctx: AdapterContext, start: date) -> list[dict[str, Any]]:
|
||||
"""기간 앞 CANCEL_LOOKBACK_DAYS 일의 주문상품 — 다른 날 주문을 기간 안에 취소한 것을 찾는 용도."""
|
||||
out: list[dict[str, Any]] = []
|
||||
for a, b in self._windows(start - timedelta(days=CANCEL_LOOKBACK_DAYS), start - timedelta(days=1)):
|
||||
rows = self._window_items(ctx, a, b)
|
||||
ctx.progress.step(items=len(rows))
|
||||
out.extend(rows)
|
||||
return out
|
||||
|
||||
def _plan(self, ctx: AdapterContext, start: date, end: date, extra: int = 0) -> None:
|
||||
"""진행 막대: 기간 주문 구간 + 앞 90일 주문 구간 + 클레임 목록 1단계 (+ 원본 확인의 정산 구간)."""
|
||||
back = len(self._windows(start - timedelta(days=CANCEL_LOOKBACK_DAYS), start - timedelta(days=1)))
|
||||
ctx.progress.plan(len(self._windows(start, end)) + back + 1 + extra, "단계")
|
||||
|
||||
def _claims_step(self, ctx: AdapterContext) -> list[dict[str, Any]]:
|
||||
claims = self._claims(ctx)
|
||||
ctx.progress.step(items=len(claims))
|
||||
return claims
|
||||
|
||||
# ── 수집 ──────────────────────────────────────────────
|
||||
def collect(self, ctx: AdapterContext, start: date, end: date) -> tuple[int, list[SaleEvent]]:
|
||||
"""매출(주문일) + 환불(환불일, merge_refunds). 주문 내역은 환불 금액·취소 시각에도 쓰여 한 번만 부른다."""
|
||||
self.authenticate(ctx)
|
||||
self._plan(ctx, start, end)
|
||||
items = list(self._items(ctx, start, end))
|
||||
back = self._lookback_items(ctx, start)
|
||||
claims = self._claims_step(ctx)
|
||||
events: list[SaleEvent] = []
|
||||
for o in group_orders(items, start, end).values():
|
||||
events.extend(self.normalize_order(o))
|
||||
for r in merge_refunds(back + items, claims, start, end):
|
||||
events.extend(self.normalize_refund(r))
|
||||
for ev in events:
|
||||
ev.validate()
|
||||
return len(items) + len(claims), events
|
||||
|
||||
def normalize_refund(self, r: dict[str, Any]) -> list[SaleEvent]:
|
||||
oid, day = str(r.get("orderId") or ""), r.get("_day")
|
||||
if not oid or day is None or not r.get("orderProductId"):
|
||||
return []
|
||||
kind = "RETURN" if r.get("type") == "RETURN" else "CANCEL"
|
||||
return [SaleEvent(
|
||||
event_type=kind, external_event_id=f"{EVENT_PREFIX}R{r['orderProductId']}", external_order_id=oid,
|
||||
external_line_id=str(r["orderProductId"]), event_date=day, order_date=r.get("order_day"),
|
||||
amount=-abs(int(r.get("amount") or 0)), product_name=str(r.get("name") or "")[:200],
|
||||
quantity=int(r.get("qty") or 0), order_status="반품 환불" if kind == "RETURN" else "취소 환불",
|
||||
)]
|
||||
|
||||
def normalize_order(self, o: dict[str, Any]) -> list[SaleEvent]:
|
||||
oid, day = str(o.get("orderId") or ""), o.get("_day")
|
||||
if not oid or day is None:
|
||||
return []
|
||||
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 []]
|
||||
return [SaleEvent(
|
||||
event_type="SALE", external_event_id=f"{EVENT_PREFIX}{oid}", external_order_id=oid,
|
||||
order_date=day, payment_date=day, event_date=day, amount=max(0, int(o.get("amount") or 0)),
|
||||
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],
|
||||
)]
|
||||
|
||||
def test_connection(self, ctx: AdapterContext) -> str:
|
||||
from app.timezone import today_kst # noqa: WPS433
|
||||
|
||||
# 입력한 새 값으로 시험할 수 있으니 저장된 토큰을 쓰지 않고 항상 새로 받는다.
|
||||
super().authenticate(ctx)
|
||||
self._token(ctx, force=True)
|
||||
today = today_kst()
|
||||
body = self._get(ctx, ORDERS_PATH, {"startDate": today.isoformat(), "endDate": today.isoformat(), "limit": 1})
|
||||
n = len(body.get("results") or [])
|
||||
more = " 이상" if body.get("nextCursor") else ""
|
||||
return f"토스쇼핑 API 연결 정상(토큰 발급·주문 조회 확인, 오늘 주문상품 {n}건{more})."
|
||||
|
||||
# ── 원본 데이터 확인(설정 화면 "쇼핑몰 원본 데이터 확인") ─────────
|
||||
def reconcile(self, ctx: AdapterContext, day: date, to: date | None = None) -> dict[str, Any]:
|
||||
"""기간(최대 31일)을 실제로 불러 항목별 합계·상태별 합계와 날짜별 매출·환불·순 거래액(= 저장되는 값)을 돌려준다.
|
||||
환불은 출처별(클레임 환불 완료·주문 취소 시각·정산 REFUND)로도 나란히 보여 파트너스 화면과 맞춰 볼 수 있게.
|
||||
개인정보 항목은 값 없이 이름만. 저장하지 않는다."""
|
||||
self.authenticate(ctx)
|
||||
to = min(max(to or day, day), day + timedelta(days=PROBE_MAX_DAYS - 1))
|
||||
self._plan(ctx, day, to, extra=len(self._windows(day, to)))
|
||||
try:
|
||||
items = list(self._items(ctx, day, to))
|
||||
back = self._lookback_items(ctx, day)
|
||||
except AdapterError as exc:
|
||||
return {"date": day.isoformat(), "to": to.isoformat(), "probes": [
|
||||
{"key": "orders", "label": "주문 내역", "path": ORDERS_PATH, "ok": False, "error": exc.message[:300]}]}
|
||||
by_status: dict[str, list[dict[str, Any]]] = {}
|
||||
for it in items:
|
||||
by_status.setdefault(str(it.get("orderProductStatus") or "?"), []).append(it)
|
||||
probes = [{"key": "orders", "label": "주문 내역(전체 상태, 주문상품 단위)", "path": ORDERS_PATH,
|
||||
"ok": True, "count": len(items), "fields": summary(items)}]
|
||||
for st, rows in sorted(by_status.items()):
|
||||
probes.append({"key": f"status-{st}", "label": f"상태 {STATUS_KO.get(st, st)}({st})"
|
||||
+ (" — 매출 제외(결제 전)" if st in EXCLUDED_STATUS else
|
||||
" — 결제 뒤 취소·반품(매출 포함)" if st in CLAIMED_STATUS else ""),
|
||||
"path": "orderProductStatus", "ok": True, "count": len(rows),
|
||||
"fields": [f for f in summary(rows) if f["sum"] is not None]})
|
||||
claims_err = ""
|
||||
try:
|
||||
claims = self._claims_step(ctx)
|
||||
probes.append({"key": "claims", "label": "클레임 목록(전체 — 날짜 조건 없음)", "path": CLAIMS_PATH, "ok": True,
|
||||
"count": len(claims), "fields": summary(claims)})
|
||||
except AdapterError as exc:
|
||||
claims, claims_err = [], exc.message[:300]
|
||||
probes.append({"key": "claims", "label": "클레임 목록", "path": CLAIMS_PATH, "ok": False, "error": claims_err})
|
||||
settle_err = ""
|
||||
try:
|
||||
settle = list(self._refund_items(ctx, day, to))
|
||||
probes.append({"key": "settlement", "label": "정산 건별(거래일 기준, 결제·환불·배송비 줄 전체 — 참고)",
|
||||
"path": SETTLEMENT_PATH + " (TRANSACTION_DATE)", "ok": True, "count": len(settle),
|
||||
"fields": summary(settle)})
|
||||
except AdapterError as exc:
|
||||
settle, settle_err = [], exc.message[:300]
|
||||
probes.append({"key": "settlement", "label": "정산 건별(참고)", "path": SETTLEMENT_PATH, "ok": False,
|
||||
"error": settle_err})
|
||||
|
||||
refunds = merge_refunds(back + items, claims, day, to) # 저장되는 환불(현재 규칙)
|
||||
# ── 환불 출처별 — 파트너스 화면 "환불"과 맞춰 보는 용도 ──
|
||||
candidates: list[dict[str, Any]] = [
|
||||
{"key": "rule", "label": "적용 규칙(클레임 환불 + 클레임 없는 결제취소)", "rows": [
|
||||
{**r, "note": "반품" if r["type"] == "RETURN" else "취소"}
|
||||
for r in refunds], "error": claims_err},
|
||||
{"key": "claims", "label": "클레임 환불 완료(refundedDt, 금액 order.price)", "rows": claim_rows(claims, day, to),
|
||||
"error": claims_err},
|
||||
{"key": "canceled", "label": f"주문 취소 시각(canceledAt, {CANCEL_LOOKBACK_DAYS}일 전 주문까지)",
|
||||
"rows": cancel_rows(back + items, day, to), "error": ""},
|
||||
{"key": "settlement", "label": "정산 REFUND 상품 줄(거래일) — 참고", "rows": [
|
||||
{**r, "note": "정산 REFUND"} for r in refund_rows(settle, day, to)],
|
||||
"error": settle_err},
|
||||
]
|
||||
for c in candidates:
|
||||
c["days"] = {}
|
||||
for r in c["rows"]:
|
||||
k = r["_day"].isoformat()
|
||||
c["days"][k] = c["days"].get(k, 0) + r["amount"]
|
||||
c["rows"] = [{"date": r["_day"].isoformat(), "orderDate": r["order_day"].isoformat() if r.get("order_day") else "",
|
||||
"orderId": r["orderId"], "orderProductId": r["orderProductId"],
|
||||
"amount": r["amount"], "note": r.get("note") or ""}
|
||||
for r in sorted(c["rows"], key=lambda x: (x["_day"], x["orderId"]))][:200]
|
||||
|
||||
days = []
|
||||
orders = group_orders(items, day, to)
|
||||
d = day
|
||||
while d <= to:
|
||||
day_orders = [o for o in orders.values() if o["_day"] == d]
|
||||
sales = sum(o["amount"] for o in day_orders)
|
||||
refund = sum(r["amount"] for r in refunds if r["_day"] == d)
|
||||
days.append({"date": d.isoformat(), "orders": len(day_orders), "amount": sales, "claimed": refund,
|
||||
"ship": sales - refund})
|
||||
d += timedelta(days=1)
|
||||
return {"date": day.isoformat(), "to": to.isoformat(), "probes": probes, "days": days,
|
||||
"refund_candidates": candidates,
|
||||
"day_cols": {"amount": "매출(주문일)", "claimed": "환불(환불일)", "ship": "순 거래액(저장되는 매출)"},
|
||||
"rule": "순 거래액 = 매출 − 환불. 매출 = 주문일(orderedAt) 기준 주문상품 price(판매가 × 수량) 합(할인 전, "
|
||||
"배송비 제외, 나중에 취소·반품된 주문 포함, 결제 전 제외). 환불 = 클레임 환불 완료(취소·반품, refundedDt) + "
|
||||
"클레임 없는 결제취소(canceledAt), 주문상품마다 한 번, 금액 = 그 주문상품 price. 환불일 기준"}
|
||||
@@ -0,0 +1,150 @@
|
||||
"""매출 자동 업데이트 — 웹 프로세스 안 데몬 스레드(프로젝트 마감 알림과 같은 방식).
|
||||
|
||||
기본: 매일 09:00 ~ 19:00(KST) 정각·30분마다, 오늘 포함 최근 10일을 [매출 업데이트] 와 같은 방식으로 다시 가져온다.
|
||||
- 매출이 끝나면 설정된 광고 API(구글 광고)도 같은 기간으로 가져온다(ad_sync, 실패해도 매출과 무관).
|
||||
- 진행 창 작업(jobs)으로 돌린다 — 그동안 누가 [매출 업데이트] 를 누르면 새로 시작하지 않고 이 진행 상황을 본다.
|
||||
- 그 시각에 이미 다른 업데이트가 돌고 있으면 그 회차는 건너뛴다(같은 쇼핑몰 동시 실행은 어차피 막혀 있음).
|
||||
- 한 회차가 30분을 넘기면 지나간 회차는 건너뛰고 다음 정각/30분을 기다린다(밀린 회차를 몰아서 돌리지 않음).
|
||||
- 서버를 켠 시각의 회차는 돌리지 않고 다음 회차부터.
|
||||
|
||||
환경변수(.env)
|
||||
PERFORMANCE_AUTO_SYNC=false 끄기(기본 켜짐)
|
||||
PERFORMANCE_AUTO_SYNC_DAYS=10 가져올 기간(오늘 포함 최근 N일, 1~90)
|
||||
PERFORMANCE_AUTO_SYNC_HOURS=9-19 돌리는 시간대(시작시-마지막시, 마지막 시는 정각 회차까지)
|
||||
"""
|
||||
|
||||
from __future__ import annotations
|
||||
|
||||
import logging
|
||||
import os
|
||||
import re
|
||||
import threading
|
||||
import time
|
||||
from datetime import datetime, timedelta
|
||||
from typing import Any
|
||||
|
||||
from app.timezone import now_kst
|
||||
|
||||
logger = logging.getLogger("performance.auto_sync")
|
||||
|
||||
AUTO_USER = "자동 업데이트"
|
||||
DEFAULT_DAYS = 10
|
||||
DEFAULT_HOURS = (9, 19)
|
||||
SLOT_MINUTES = 30
|
||||
|
||||
_started = False
|
||||
_start_lock = threading.Lock()
|
||||
|
||||
|
||||
def _env(name: str) -> str:
|
||||
return (os.getenv(name, "") or "").strip()
|
||||
|
||||
|
||||
def enabled() -> bool:
|
||||
return _env("PERFORMANCE_AUTO_SYNC").lower() not in ("0", "false", "no", "off")
|
||||
|
||||
|
||||
def sync_days() -> int:
|
||||
try:
|
||||
return max(1, min(90, int(_env("PERFORMANCE_AUTO_SYNC_DAYS") or DEFAULT_DAYS)))
|
||||
except ValueError:
|
||||
return DEFAULT_DAYS
|
||||
|
||||
|
||||
def hour_window() -> tuple[int, int]:
|
||||
m = re.fullmatch(r"(\d{1,2})\s*-\s*(\d{1,2})", _env("PERFORMANCE_AUTO_SYNC_HOURS"))
|
||||
if not m:
|
||||
return DEFAULT_HOURS
|
||||
first, last = int(m.group(1)), int(m.group(2))
|
||||
if not (0 <= first <= last <= 23):
|
||||
return DEFAULT_HOURS
|
||||
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:
|
||||
return False
|
||||
return first <= t.hour < last or (t.hour == last and t.minute == 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 run_once(store: Any, app_state: Any, *, today: Any, days: int) -> dict[str, Any]:
|
||||
"""한 회차 — 진행 창 작업으로 오늘 포함 최근 days 일 업데이트. 이미 돌고 있으면 건너뜀."""
|
||||
from . import common, jobs # 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)
|
||||
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")
|
||||
ok = sum(1 for r in results if r.get("ok"))
|
||||
return {"skipped": False, "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]}
|
||||
|
||||
|
||||
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 None or not enabled():
|
||||
return False
|
||||
with _start_lock:
|
||||
if _started:
|
||||
return False
|
||||
_started = True
|
||||
hours, days = hour_window(), sync_days()
|
||||
|
||||
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"))
|
||||
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)
|
||||
|
||||
threading.Thread(target=_loop, name="performance-auto-sync", daemon=True).start()
|
||||
return True
|
||||
@@ -0,0 +1,306 @@
|
||||
"""③ 매출 계산 — 기간/주 계산, 수수료·반올림, 표·KPI 집계. DB·HTTP 와 무관한 순수 함수.
|
||||
|
||||
금액 규칙
|
||||
- 모든 금액은 원 단위 정수(int). 부동소수점을 쓰지 않는다(수수료율만 Decimal).
|
||||
- 수수료 = round_half_up(해당 일 쇼핑몰 매출 합계 × 그날 유효한 수수료율 / 100).
|
||||
반올림은 `commission()` 한 곳에서만 한다. 취소/반품(음수)도 같은 규칙(0 에서 먼 쪽).
|
||||
- 수수료 차감 매출 = 총매출 − 수수료.
|
||||
- 수수료율은 이력(적용 시작일)으로 관리한다. 어떤 날의 요율 = 그날 이전(포함) 가장 최근
|
||||
적용 시작일의 요율. 첫 요율보다 이전 날짜는 0%.
|
||||
|
||||
주 = 월요일 ~ 일요일.
|
||||
"""
|
||||
|
||||
from __future__ import annotations
|
||||
|
||||
import calendar
|
||||
from dataclasses import dataclass
|
||||
from datetime import date, timedelta
|
||||
from decimal import ROUND_HALF_UP, Decimal
|
||||
from typing import Iterable, Mapping, Sequence
|
||||
|
||||
WEEKDAYS_KO = ("월", "화", "수", "목", "금", "토", "일")
|
||||
PERIOD_KINDS = ("day", "week", "month", "year", "custom")
|
||||
MAX_CUSTOM_DAYS = 366
|
||||
|
||||
|
||||
# ════════════════════════════════════════════════════════════
|
||||
# 금액
|
||||
# ════════════════════════════════════════════════════════════
|
||||
def commission(amount: int, rate_percent: Decimal) -> int:
|
||||
"""수수료(원). 반올림 기준은 이 함수 한 곳 — ROUND_HALF_UP(0.5 는 0 에서 먼 쪽)."""
|
||||
if not amount or not rate_percent:
|
||||
return 0
|
||||
value = Decimal(int(amount)) * Decimal(rate_percent) / Decimal(100)
|
||||
return int(value.quantize(Decimal(1), rounding=ROUND_HALF_UP))
|
||||
|
||||
|
||||
@dataclass
|
||||
class Money:
|
||||
gross: int = 0
|
||||
commission: int = 0
|
||||
|
||||
@property
|
||||
def net(self) -> int:
|
||||
return self.gross - self.commission
|
||||
|
||||
def add(self, other: "Money") -> "Money":
|
||||
self.gross += other.gross
|
||||
self.commission += other.commission
|
||||
return self
|
||||
|
||||
def as_dict(self) -> dict[str, int]:
|
||||
return {"gross": self.gross, "commission": self.commission, "net": self.net}
|
||||
|
||||
|
||||
def total(items: Iterable[Money]) -> Money:
|
||||
out = Money()
|
||||
for m in items:
|
||||
out.add(m)
|
||||
return out
|
||||
|
||||
|
||||
RateTable = Mapping[str, Sequence[tuple[date, Decimal]]] # 쇼핑몰 → [(적용 시작일, 요율%)] 오름차순
|
||||
|
||||
|
||||
def rate_on(rates: RateTable, code: str, d: date) -> Decimal:
|
||||
current = Decimal(0)
|
||||
for eff, rate in rates.get(code, ()):
|
||||
if eff <= d:
|
||||
current = Decimal(rate)
|
||||
else:
|
||||
break
|
||||
return current
|
||||
|
||||
|
||||
def build_cells(daily_amounts: Mapping[tuple[date, str], int], rates: RateTable) -> dict[tuple[date, str], Money]:
|
||||
"""(날짜, 쇼핑몰) → 그날 매출 합계로 Money 를 만든다(수수료는 그날 요율)."""
|
||||
return {
|
||||
(d, code): Money(gross=int(amt), commission=commission(int(amt), rate_on(rates, code, d)))
|
||||
for (d, code), amt in daily_amounts.items()
|
||||
}
|
||||
|
||||
|
||||
def pct_change(current: int, previous: int) -> float | None:
|
||||
"""증감률(%). 비교 대상이 0 이하이면 의미 없는 값 대신 None."""
|
||||
if previous <= 0:
|
||||
return None
|
||||
return round((current - previous) / previous * 100, 1)
|
||||
|
||||
|
||||
# ════════════════════════════════════════════════════════════
|
||||
# 기간
|
||||
# ════════════════════════════════════════════════════════════
|
||||
def week_start(d: date) -> date:
|
||||
return d - timedelta(days=d.weekday())
|
||||
|
||||
|
||||
def month_end(d: date) -> date:
|
||||
return d.replace(day=calendar.monthrange(d.year, d.month)[1])
|
||||
|
||||
|
||||
def _add_months(d: date, n: int) -> date:
|
||||
y, m = divmod(d.month - 1 + n, 12)
|
||||
year, month = d.year + y, m + 1
|
||||
return date(year, month, min(d.day, calendar.monthrange(year, month)[1]))
|
||||
|
||||
|
||||
def fmt_md(d: date) -> str:
|
||||
return f"{d.month}/{d.day}"
|
||||
|
||||
|
||||
def day_label(d: date) -> str:
|
||||
"""일자별 표 날짜 — mm/dd(요일), 예: 09/01(화)."""
|
||||
return f"{d.month:02d}/{d.day:02d}({WEEKDAYS_KO[d.weekday()]})"
|
||||
|
||||
|
||||
@dataclass
|
||||
class Period:
|
||||
kind: str
|
||||
anchor: date
|
||||
start: date
|
||||
end: date
|
||||
label: str
|
||||
prev_anchor: date
|
||||
next_anchor: date
|
||||
prev_label: str
|
||||
next_label: str
|
||||
|
||||
@property
|
||||
def days(self) -> int:
|
||||
return (self.end - self.start).days + 1
|
||||
|
||||
def compare_range(self, today: date) -> tuple[date, date, str]:
|
||||
"""직전 같은 길이 기간. 진행 중인 기간이면 같은 경과일수까지만(공정한 비교)."""
|
||||
length = self.days
|
||||
prev_start = self.start - timedelta(days=length)
|
||||
if self.kind == "month":
|
||||
prev_start = _add_months(self.start, -1)
|
||||
elif self.kind == "year":
|
||||
prev_start = self.start.replace(year=self.start.year - 1)
|
||||
in_progress = self.start <= today < self.end
|
||||
if in_progress:
|
||||
elapsed = (today - self.start).days
|
||||
prev_end = prev_start + timedelta(days=elapsed)
|
||||
if self.kind == "month":
|
||||
prev_end = min(prev_end, month_end(prev_start))
|
||||
note = "같은 기간"
|
||||
else:
|
||||
if self.kind == "month":
|
||||
prev_end = month_end(prev_start)
|
||||
elif self.kind == "year":
|
||||
prev_end = prev_start.replace(month=12, day=31)
|
||||
else:
|
||||
prev_end = self.start - timedelta(days=1)
|
||||
note = ""
|
||||
unit = {"day": "전일", "week": "전주", "month": "전월", "year": "전년"}.get(self.kind, "직전 기간")
|
||||
return prev_start, prev_end, f"{unit} {note}".strip()
|
||||
|
||||
|
||||
def resolve_period(
|
||||
kind: str,
|
||||
anchor: date,
|
||||
*,
|
||||
custom_from: date | None = None,
|
||||
custom_to: date | None = None,
|
||||
) -> Period:
|
||||
kind = kind if kind in PERIOD_KINDS else "week"
|
||||
if kind == "day":
|
||||
return Period(kind, anchor, anchor, anchor,
|
||||
f"{anchor.year}년 {anchor.month}월 {anchor.day}일 ({WEEKDAYS_KO[anchor.weekday()]})",
|
||||
anchor - timedelta(days=1), anchor + timedelta(days=1), "전일", "다음날")
|
||||
if kind == "week":
|
||||
s = week_start(anchor)
|
||||
e = s + timedelta(days=6)
|
||||
label = (f"{s.year}년 {s.month}월 {s.day}일 ~ "
|
||||
+ (f"{e.year}년 " if e.year != s.year else "") + f"{e.month}월 {e.day}일")
|
||||
return Period(kind, anchor, s, e, label, s - timedelta(days=7), s + timedelta(days=7), "이전주", "다음주")
|
||||
if kind == "month":
|
||||
s = anchor.replace(day=1)
|
||||
return Period(kind, anchor, s, month_end(s), f"{s.year}년 {s.month}월",
|
||||
_add_months(s, -1), _add_months(s, 1), "이전달", "다음달")
|
||||
if kind == "year":
|
||||
s = date(anchor.year, 1, 1)
|
||||
return Period(kind, anchor, s, date(anchor.year, 12, 31), f"{anchor.year}년",
|
||||
date(anchor.year - 1, 1, 1), date(anchor.year + 1, 1, 1), "이전해", "다음해")
|
||||
# custom
|
||||
s = custom_from or anchor
|
||||
e = custom_to or s
|
||||
if e < s:
|
||||
s, e = e, s
|
||||
if (e - s).days + 1 > MAX_CUSTOM_DAYS:
|
||||
e = s + timedelta(days=MAX_CUSTOM_DAYS - 1)
|
||||
length = (e - s).days + 1
|
||||
return Period("custom", s, s, e, f"{s.isoformat()} ~ {e.isoformat()}",
|
||||
s - timedelta(days=length), e + timedelta(days=1), "이전", "다음")
|
||||
|
||||
|
||||
def daterange(start: date, end: date) -> Iterable[date]:
|
||||
d = start
|
||||
while d <= end:
|
||||
yield d
|
||||
d += timedelta(days=1)
|
||||
|
||||
|
||||
# ════════════════════════════════════════════════════════════
|
||||
# 집계
|
||||
# ════════════════════════════════════════════════════════════
|
||||
def sum_range(cells: Mapping[tuple[date, str], Money], codes: Sequence[str], start: date, end: date) -> Money:
|
||||
wanted = set(codes)
|
||||
out = Money()
|
||||
for (d, code), m in cells.items():
|
||||
if code in wanted and start <= d <= end:
|
||||
out.add(m)
|
||||
return out
|
||||
|
||||
|
||||
def by_code(cells: Mapping[tuple[date, str], Money], codes: Sequence[str], start: date, end: date) -> dict[str, Money]:
|
||||
out = {c: Money() for c in codes}
|
||||
for (d, code), m in cells.items():
|
||||
if code in out and start <= d <= end:
|
||||
out[code].add(m)
|
||||
return out
|
||||
|
||||
|
||||
def _row(kind: str, label: str, per_code: dict[str, Money], **extra) -> dict:
|
||||
return {
|
||||
"kind": kind,
|
||||
"label": label,
|
||||
"cells": {c: m.as_dict() for c, m in per_code.items()},
|
||||
"total": total(per_code.values()).as_dict(),
|
||||
**extra,
|
||||
}
|
||||
|
||||
|
||||
def main_table(period: Period, codes: Sequence[str], cells: Mapping[tuple[date, str], Money],
|
||||
*, today: date, holidays: Mapping[str, str] | None = None) -> list[dict]:
|
||||
"""일자 × 쇼핑몰 표. 일 행 + 주간합계(일요일 뒤 / 기간 끝) + 기간 합계.
|
||||
|
||||
연간 보기는 일 대신 월 행(1~12월)으로 줄인다.
|
||||
"""
|
||||
holidays = holidays or {}
|
||||
rows: list[dict] = []
|
||||
if period.kind == "year":
|
||||
for m in range(1, 13):
|
||||
s = date(period.start.year, m, 1)
|
||||
e = month_end(s)
|
||||
rows.append(_row("month", f"{m}월", by_code(cells, codes, s, e), future=s > today,
|
||||
**{"from": s.isoformat(), "to": e.isoformat()}))
|
||||
rows.append(_row("total", "연간 합계", by_code(cells, codes, period.start, period.end)))
|
||||
return rows
|
||||
|
||||
week_codes: dict[str, Money] = {c: Money() for c in codes}
|
||||
for d in daterange(period.start, period.end):
|
||||
per_code = {c: cells.get((d, c), Money()) for c in codes}
|
||||
iso = d.isoformat()
|
||||
rows.append(_row("day", day_label(d), per_code, date=iso, weekday=d.weekday(),
|
||||
holiday=holidays.get(iso, ""), future=d > today, today=d == today,
|
||||
**{"from": iso, "to": iso}))
|
||||
for c in codes:
|
||||
week_codes[c].add(per_code[c])
|
||||
if period.days > 1 and (d.weekday() == 6 or d == period.end):
|
||||
ws = max(week_start(d), period.start)
|
||||
label = "주간합계" if period.kind == "week" else f"주간합계 ({fmt_md(ws)}~{fmt_md(d)})"
|
||||
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)))
|
||||
return rows
|
||||
|
||||
|
||||
def month_summary(year: int, month: int, codes: Sequence[str], cells: Mapping[tuple[date, str], Money]) -> dict:
|
||||
s = date(year, month, 1)
|
||||
per = by_code(cells, codes, s, month_end(s))
|
||||
tot = total(per.values())
|
||||
rows = []
|
||||
for c in codes:
|
||||
m = per[c]
|
||||
share = round(m.gross / tot.gross * 100, 1) if tot.gross > 0 else None
|
||||
rows.append({"code": c, **m.as_dict(), "share": share})
|
||||
rows.sort(key=lambda r: r["gross"], reverse=True)
|
||||
return {"label": f"{year}년 {month}월", "rows": rows,
|
||||
"total": {**tot.as_dict(), "share": 100.0 if tot.gross > 0 else None}}
|
||||
|
||||
|
||||
def year_months(year: int, codes: Sequence[str], cells: Mapping[tuple[date, str], Money], *, today: date) -> dict:
|
||||
rows = []
|
||||
for m in range(1, 13):
|
||||
s = date(year, m, 1)
|
||||
future = s > today
|
||||
money = sum_range(cells, codes, s, month_end(s))
|
||||
rows.append({"month": m, "label": f"{m}월", "future": future,
|
||||
**({"gross": None, "commission": None, "net": None} if future else money.as_dict())})
|
||||
tot = sum_range(cells, codes, date(year, 1, 1), date(year, 12, 31))
|
||||
return {"year": year, "rows": rows, "total": tot.as_dict()}
|
||||
|
||||
|
||||
def daily_series(period: Period, codes: Sequence[str], cells: Mapping[tuple[date, str], Money]) -> list[dict]:
|
||||
"""일별 추이 그래프용. 연간은 월별."""
|
||||
if period.kind == "year":
|
||||
out = []
|
||||
for m in range(1, 13):
|
||||
s = date(period.start.year, m, 1)
|
||||
out.append({"label": f"{m}월", **sum_range(cells, codes, s, month_end(s)).as_dict()})
|
||||
return out
|
||||
return [{"label": fmt_md(d), "date": d.isoformat(), **sum_range(cells, codes, d, d).as_dict()}
|
||||
for d in daterange(period.start, period.end)]
|
||||
@@ -0,0 +1,126 @@
|
||||
"""실적 모듈 공용 가드/서비스 생성 — router.py 가 쓴다(순환 import 방지로 분리).
|
||||
|
||||
권한(프론트에서 메뉴를 숨기는 것과 별개로 **서버에서** 항상 검사):
|
||||
- 실적 대시보드/매출 업데이트/상세 조회 : 모듈 권한 `performance` (admin 은 자동)
|
||||
- 실적 설정(수수료·API 인증정보·연결 테스트·테스트 데이터) : 관리자(is_admin)만
|
||||
"""
|
||||
|
||||
from __future__ import annotations
|
||||
|
||||
from typing import Any
|
||||
|
||||
from fastapi import HTTPException, Request
|
||||
from fastapi.responses import HTMLResponse, RedirectResponse
|
||||
|
||||
MODULE_KEY = "performance"
|
||||
MODULE_NAME = "실적"
|
||||
|
||||
CONFIG_HELP = (
|
||||
"실적 모듈이 아직 설정되지 않았습니다. "
|
||||
"scripts/sql/performance_db_init.sql 로 performance_db 를 만들고 "
|
||||
"PERFORMANCE_DB_URL 환경변수를 설정한 뒤 컨테이너를 재기동하세요."
|
||||
)
|
||||
|
||||
|
||||
def get_store(request: Request) -> Any:
|
||||
return getattr(request.app.state, "performance_store", None)
|
||||
|
||||
|
||||
def key_ring():
|
||||
"""마스터 키 — 호출할 때마다 환경변수에서 읽는다(DB 에는 없다)."""
|
||||
from .security.crypto import KeyRing # noqa: WPS433
|
||||
|
||||
return KeyRing.from_env()
|
||||
|
||||
|
||||
def key_status() -> dict[str, Any]:
|
||||
"""설정 화면용 — 키가 설정됐는지/버전만. 키 값은 절대 넣지 않는다."""
|
||||
from .security.crypto import CryptoConfigError # noqa: WPS433
|
||||
|
||||
try:
|
||||
ring = key_ring()
|
||||
except CryptoConfigError as exc:
|
||||
return {"ok": False, "message": str(exc), "current_version": None, "versions": []}
|
||||
return {"ok": True, "message": "", "current_version": ring.current_version, "versions": ring.versions}
|
||||
|
||||
|
||||
def services(request: Request, store: Any):
|
||||
"""(CredentialService, SyncService)."""
|
||||
from .credentials import CredentialService # noqa: WPS433
|
||||
from .sync import SyncService # noqa: WPS433
|
||||
|
||||
creds = CredentialService(store, key_ring)
|
||||
return creds, SyncService(store, creds, app_state=request.app.state)
|
||||
|
||||
|
||||
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
|
||||
|
||||
user = get_current_user_record(request)
|
||||
if user is None:
|
||||
raise HTTPException(status_code=401, detail="로그인이 필요합니다.")
|
||||
if not has_module(user, MODULE_KEY):
|
||||
raise HTTPException(status_code=403, detail=f"{MODULE_NAME} 모듈 권한이 없습니다.")
|
||||
return user
|
||||
|
||||
|
||||
def require_admin(request: Request) -> dict[str, Any]:
|
||||
from app.store import is_admin # noqa: WPS433
|
||||
|
||||
user = require_user(request)
|
||||
if not is_admin(user):
|
||||
raise HTTPException(status_code=403, detail="실적 설정은 관리자만 변경할 수 있습니다.")
|
||||
return user
|
||||
|
||||
|
||||
def require_store(request: Request, *, admin: bool = False) -> tuple[Any, dict[str, Any]]:
|
||||
user = require_admin(request) if admin else require_user(request)
|
||||
st = get_store(request)
|
||||
if st is None:
|
||||
raise HTTPException(status_code=503, detail=CONFIG_HELP)
|
||||
return st, user
|
||||
|
||||
|
||||
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
|
||||
|
||||
user = get_current_user_record(request)
|
||||
if user is None:
|
||||
return RedirectResponse(url="/login", status_code=303)
|
||||
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",
|
||||
{"reason": reason, "user": user, "is_admin": is_admin(user)}, status_code=403)
|
||||
st = get_store(request)
|
||||
if st is None:
|
||||
return render_config_needed(request, user)
|
||||
return st, user
|
||||
|
||||
|
||||
def render_config_needed(request: Request, user: 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, "denied.html",
|
||||
{"reason": CONFIG_HELP, "user": user, "is_admin": is_admin(user),
|
||||
"nav_items": build_erp_nav(user, active=MODULE_KEY)},
|
||||
status_code=503,
|
||||
)
|
||||
|
||||
|
||||
def base_ctx(user: dict[str, Any], *, active_tab: str, page_title: str = "실적") -> dict[str, Any]:
|
||||
from app.main import build_erp_nav # noqa: WPS433
|
||||
from app.store import is_admin # noqa: WPS433
|
||||
|
||||
return {
|
||||
"user": user,
|
||||
"is_admin": is_admin(user),
|
||||
"nav_items": build_erp_nav(user, active=MODULE_KEY),
|
||||
"active_tab": active_tab,
|
||||
"page_title": page_title,
|
||||
"page_subtitle": "쇼핑몰 통합 매출",
|
||||
}
|
||||
@@ -0,0 +1,209 @@
|
||||
"""② 쇼핑몰 API 인증정보 — 저장(암호화) / 화면용 요약 / 어댑터용 복호화 접근자 / 재암호화.
|
||||
|
||||
흐름: 설정 화면 입력 → 이 서비스(암호화) → perf_credentials(암호문)
|
||||
어댑터 → CredentialAccessor.get() → 서버 안에서만 복호화
|
||||
|
||||
화면으로 돌려주는 값
|
||||
- secret 항목: 값 있음/없음(has_value)만. 원문·일부·길이 모두 보내지 않는다.
|
||||
- 일반 항목(Vendor ID 등): 확인용으로 원문을 보여 준다(이것도 DB 에는 암호문).
|
||||
"""
|
||||
|
||||
from __future__ import annotations
|
||||
|
||||
from typing import Any, Callable
|
||||
|
||||
from .adapters.base import MarketplaceAdapter
|
||||
from .security.crypto import KeyRing, decrypt, encrypt, needs_reencrypt
|
||||
|
||||
|
||||
def aad_for(code: str, key: str, ns: str = "") -> str:
|
||||
"""암호문을 (쇼핑몰, 항목)에 묶는 추가 인증 데이터. ns = 이름 공간(광고 API 인증정보는 "ad:") —
|
||||
쇼핑몰 암호문과 광고 암호문을 서로 바꿔 넣어도 복호화되지 않는다."""
|
||||
return f"perf:{ns}{code}:{key}"
|
||||
|
||||
|
||||
class CredentialAccessor:
|
||||
"""어댑터 전용 — 서버 안에서만 복호화. 값은 처음 꺼낼 때 한 번 복호화해 둔다."""
|
||||
|
||||
def __init__(self, store: Any, code: str, ring_loader: Callable[[], KeyRing], *,
|
||||
overrides: dict[str, str] | None = None, persist: bool = True, user: str = "",
|
||||
aad_ns: str = "", cleared: set[str] | None = None) -> None:
|
||||
self._store = store
|
||||
self._code = code
|
||||
self._ns = aad_ns
|
||||
self._ring_loader = ring_loader
|
||||
self._rows = store.credential_rows(code) if store is not None else {}
|
||||
self._cache: dict[str, str] = {}
|
||||
self._overrides = {k: v for k, v in (overrides or {}).items() if v}
|
||||
# 연결 테스트에서 화면 칸을 비운 항목 — 저장값이 있어도 빈 값으로(저장하지 않음)
|
||||
self._cleared = {k for k in (cleared or set()) if k not in self._overrides}
|
||||
self._persist = persist
|
||||
self._user = user
|
||||
|
||||
def has(self, key: str) -> bool:
|
||||
if key in self._cleared:
|
||||
return False
|
||||
return bool(self._overrides.get(key)) or key in self._rows
|
||||
|
||||
def get(self, key: str) -> str:
|
||||
if key in self._cleared:
|
||||
return ""
|
||||
if key in self._overrides:
|
||||
return self._overrides[key]
|
||||
if key in self._cache:
|
||||
return self._cache[key]
|
||||
row = self._rows.get(key)
|
||||
if not row:
|
||||
return ""
|
||||
value = decrypt(row["encrypted_value"], aad=aad_for(self._code, key, self._ns), ring=self._ring_loader())
|
||||
self._cache[key] = value
|
||||
return value
|
||||
|
||||
def set(self, key: str, value: str) -> None:
|
||||
"""어댑터가 새로 받은 토큰 등을 저장. 테스트(persist=False)면 메모리에만."""
|
||||
self._cache[key] = value
|
||||
if not self._persist or self._store is None:
|
||||
return
|
||||
ring = self._ring_loader()
|
||||
self._store.upsert_credential(
|
||||
self._code, key, encrypted_value=encrypt(value, aad=aad_for(self._code, key, self._ns), ring=ring),
|
||||
key_version=ring.current_version, user=self._user or "system",
|
||||
)
|
||||
self._rows[key] = {"encrypted_value": "", "key_version": ring.current_version}
|
||||
|
||||
def known_secrets(self) -> list[str]:
|
||||
"""가리기(redact)용 — 지금까지 꺼낸 원문들."""
|
||||
return [v for v in list(self._cache.values()) + list(self._overrides.values()) if v]
|
||||
|
||||
|
||||
class CredentialService:
|
||||
"""store = 인증정보 저장소(쇼핑몰: PerformanceStore, 광고 API: db.AdCredentialTable). aad_ns = 암호문 이름 공간."""
|
||||
|
||||
def __init__(self, store: Any, ring_loader: Callable[[], KeyRing], *, aad_ns: str = "") -> None:
|
||||
self._store = store
|
||||
self._ring_loader = ring_loader
|
||||
self._ns = aad_ns
|
||||
|
||||
def accessor(self, code: str, *, overrides: dict[str, str] | None = None, persist: bool = True,
|
||||
user: str = "", cleared: set[str] | None = None) -> CredentialAccessor:
|
||||
return CredentialAccessor(self._store, code, self._ring_loader, overrides=overrides,
|
||||
persist=persist, user=user, aad_ns=self._ns, cleared=cleared)
|
||||
|
||||
# ── 화면용 요약(비밀 원문 없음) ─────────────────────────
|
||||
def describe(self, adapter: MarketplaceAdapter) -> dict[str, Any]:
|
||||
rows = self._store.credential_rows(adapter.code)
|
||||
fields = []
|
||||
decrypt_error = ""
|
||||
for f in adapter.visible_fields():
|
||||
row = rows.get(f.key)
|
||||
item: dict[str, Any] = {
|
||||
"key": f.key, "label": f.label, "secret": f.secret, "required": f.required,
|
||||
"help": f.help, "placeholder": f.placeholder, "has_value": row is not None,
|
||||
"multiline": bool(getattr(f, "multiline", False)),
|
||||
"updated_at": row["updated_at"].isoformat(timespec="seconds") if row and row.get("updated_at") else "",
|
||||
}
|
||||
if row is not None and not f.secret:
|
||||
try:
|
||||
item["value"] = decrypt(row["encrypted_value"], aad=aad_for(adapter.code, f.key, self._ns),
|
||||
ring=self._ring_loader())
|
||||
except Exception as exc: # noqa: BLE001 — 키 없음/손상: 값 없이 안내만
|
||||
item["value"] = ""
|
||||
decrypt_error = str(exc) if "환경변수" in str(exc) else "저장된 값을 복호화하지 못했습니다."
|
||||
fields.append(item)
|
||||
return {"fields": fields, "decrypt_error": decrypt_error,
|
||||
"configured": all(x["has_value"] for x in fields if x["required"])}
|
||||
|
||||
def configured_codes(self, adapters: list[MarketplaceAdapter]) -> dict[str, bool]:
|
||||
keys = self._store.credential_keys_by_code()
|
||||
out = {}
|
||||
for a in adapters:
|
||||
if a.uses_shared_integration:
|
||||
out[a.code] = True
|
||||
continue
|
||||
have = keys.get(a.code, set())
|
||||
required = [f.key for f in a.visible_fields() if f.required]
|
||||
out[a.code] = bool(required) and all(k in have for k in required)
|
||||
return out
|
||||
|
||||
# ── 저장 ────────────────────────────────────────────────
|
||||
def merged_values(self, adapter: MarketplaceAdapter, values: dict[str, str]) -> dict[str, str]:
|
||||
"""검사용 — 새 입력 + (빈 칸은) 기존 값 존재 여부. 비밀 원문은 꺼내지 않고 표식만."""
|
||||
rows = self._store.credential_rows(adapter.code)
|
||||
merged = {}
|
||||
for f in adapter.visible_fields():
|
||||
v = (values.get(f.key) or "").strip()
|
||||
merged[f.key] = v if v else ("__stored__" if f.key in rows else "")
|
||||
return merged
|
||||
|
||||
def save(self, adapter: MarketplaceAdapter, values: dict[str, str], *, clear: list[str] | None = None,
|
||||
user: str = "") -> list[str]:
|
||||
"""빈 칸 = 기존 값 유지. clear 에 든 항목은 삭제. 저장한 항목 키 목록 반환."""
|
||||
allowed = {f.key for f in adapter.visible_fields()}
|
||||
ring = self._ring_loader()
|
||||
rows = self._store.credential_rows(adapter.code)
|
||||
saved = []
|
||||
changed = False # 화면 항목이 실제로 바뀌었나 — 바뀌었으면 그 인증정보로 받은 토큰 등 내부 값을 지운다(F04)
|
||||
for key, raw in values.items():
|
||||
if key not in allowed:
|
||||
continue
|
||||
v = (raw or "").strip()
|
||||
if not v:
|
||||
continue
|
||||
if not changed and self._stored_value(adapter.code, key, rows) != v:
|
||||
changed = True
|
||||
self._store.upsert_credential(
|
||||
adapter.code, key, encrypted_value=encrypt(v, aad=aad_for(adapter.code, key, self._ns), ring=ring),
|
||||
key_version=ring.current_version, user=user,
|
||||
)
|
||||
saved.append(key)
|
||||
for key in clear or []:
|
||||
if key in allowed and key not in saved:
|
||||
if key in rows:
|
||||
changed = True
|
||||
self._store.delete_credential(adapter.code, key)
|
||||
if changed:
|
||||
# 계정·키가 바뀌면 예전 계정으로 받은 토큰·만료 시각을 남기지 않는다. 같은 값을 다시 저장했으면 그대로 둔다
|
||||
# (토큰을 불필요하게 다시 받지 않게). 어댑터도 토큰을 발급 인증정보 지문에 묶어 한 번 더 막는다.
|
||||
for f in adapter.credential_fields():
|
||||
if f.internal and f.key in rows:
|
||||
self._store.delete_credential(adapter.code, f.key)
|
||||
return saved
|
||||
|
||||
def _stored_value(self, code: str, key: str, rows: dict[str, Any]) -> str | None:
|
||||
"""저장된 값 원문(서버 안에서만, 비교용) — 없거나 복호화할 수 없으면 None(= 바뀐 것으로 본다)."""
|
||||
row = rows.get(key)
|
||||
if not row:
|
||||
return None
|
||||
try:
|
||||
return decrypt(row["encrypted_value"], aad=aad_for(code, key, self._ns), ring=self._ring_loader())
|
||||
except Exception: # noqa: BLE001 — 키 교체·손상 등: 비교할 수 없으니 바뀐 것으로
|
||||
return None
|
||||
|
||||
# ── 마스터 키 교체 후 재암호화 ─────────────────────────
|
||||
def reencrypt_all(self) -> dict[str, int]:
|
||||
"""예전 키 버전으로 된 암호문을 현재 키로 다시 암호화. (재암호화 수, 실패 수)."""
|
||||
ring = self._ring_loader()
|
||||
done = failed = 0
|
||||
for row in self._store.all_credential_rows():
|
||||
token = row["encrypted_value"]
|
||||
if not needs_reencrypt(token, ring):
|
||||
continue
|
||||
code, key = row["marketplace_code"], row["credential_key"]
|
||||
try:
|
||||
plain = decrypt(token, aad=aad_for(code, key, self._ns), ring=ring)
|
||||
except Exception: # noqa: BLE001
|
||||
failed += 1
|
||||
continue
|
||||
self._store.upsert_credential(
|
||||
code, key, encrypted_value=encrypt(plain, aad=aad_for(code, key, self._ns), ring=ring),
|
||||
key_version=ring.current_version, user="rekey",
|
||||
)
|
||||
done += 1
|
||||
return {"reencrypted": done, "failed": failed}
|
||||
|
||||
def key_versions_in_use(self) -> dict[int, int]:
|
||||
counts: dict[int, int] = {}
|
||||
for row in self._store.all_credential_rows():
|
||||
v = int(row["key_version"])
|
||||
counts[v] = counts.get(v, 0) + 1
|
||||
return counts
|
||||
@@ -0,0 +1,213 @@
|
||||
"""④ 대시보드/설정 화면 데이터 조립 — 저장소 조회 + calc 계산 결과를 템플릿 컨텍스트로.
|
||||
|
||||
HTTP 와 무관하다(store 만 주입). 라우터는 파라미터 파싱·권한만 하고 여기로 넘긴다.
|
||||
"""
|
||||
|
||||
from __future__ import annotations
|
||||
|
||||
from datetime import date, timedelta
|
||||
from decimal import Decimal
|
||||
from typing import Any, Mapping, Sequence
|
||||
|
||||
from . import calc
|
||||
from .adapters.base import STATUS_LABELS
|
||||
from .adapters.registry import all_adapters, get_adapter
|
||||
|
||||
|
||||
def _sales_marketplaces(store: Any) -> list[dict[str, Any]]:
|
||||
"""대시보드 열 = 사용 ON + 매출 집계 ON 인 쇼핑몰(설정 순서)."""
|
||||
known = {a.code for a in all_adapters()}
|
||||
return [m for m in store.list_marketplaces() if m["enabled"] and m["include_in_sales"] and m["code"] in known]
|
||||
|
||||
|
||||
def display_status(marketplace: Mapping[str, Any], status_row: Mapping[str, Any] | None,
|
||||
configured: bool) -> str:
|
||||
if not marketplace.get("enabled"):
|
||||
return "disabled"
|
||||
adapter = get_adapter(marketplace["code"])
|
||||
if adapter is not None and adapter.manual_only:
|
||||
return "manual"
|
||||
if adapter is not None and not adapter.uses_shared_integration and not configured:
|
||||
return "not_configured"
|
||||
return (status_row or {}).get("status") or "unknown"
|
||||
|
||||
|
||||
def build_dashboard(store: Any, *, kind: str, anchor: date, today: date,
|
||||
custom_from: date | None = None, custom_to: date | None = None,
|
||||
selected: Sequence[str] = (), holidays: Mapping[str, str] | None = None,
|
||||
configured: Mapping[str, bool] | None = None) -> dict[str, Any]:
|
||||
markets = _sales_marketplaces(store)
|
||||
all_codes = [m["code"] for m in markets]
|
||||
codes = [c for c in all_codes if c in set(selected)] or all_codes
|
||||
names = {m["code"]: m["name"] for m in markets}
|
||||
short = {c: _short_name(names[c]) for c in all_codes}
|
||||
|
||||
period = calc.resolve_period(kind, anchor, custom_from=custom_from, custom_to=custom_to)
|
||||
cmp_start, cmp_end, cmp_label = period.compare_range(today)
|
||||
# 월·연 누적의 기준일 — 선택 기간이 오늘을 포함하면 오늘(이번주가 다음 달로 걸쳐도
|
||||
# "이번달"), 지난 기간이면 기간 끝, 앞으로의 기간이면 기간 시작.
|
||||
if period.end < today:
|
||||
ref = period.end
|
||||
elif period.start <= today:
|
||||
ref = today
|
||||
else:
|
||||
ref = period.start
|
||||
month_period = calc.resolve_period("month", ref)
|
||||
year_period = calc.resolve_period("year", ref)
|
||||
m_cmp_start, m_cmp_end, m_cmp_label = month_period.compare_range(today)
|
||||
y_cmp_start, y_cmp_end, y_cmp_label = year_period.compare_range(today)
|
||||
|
||||
q_start = min(period.start, cmp_start, m_cmp_start, y_cmp_start)
|
||||
q_end = max(period.end, year_period.end)
|
||||
cells = calc.build_cells(store.daily_amounts(q_start, q_end, codes), store.rate_table())
|
||||
# 수동 입력(설정에서 켠 쇼핑몰) — 일자별 표의 날짜 칸을 눌러 입력. 값이 있는 칸은 표시(API 값 대신 쓰는 중)
|
||||
manual_codes = [m["code"] for m in markets if m.get("manual_input") and m["code"] in codes]
|
||||
manual_amounts = getattr(store, "manual_amounts", None)
|
||||
manual_cells = sorted(f"{d.isoformat()}|{c}" for d, c in
|
||||
(manual_amounts(period.start, period.end, manual_codes) if manual_amounts and manual_codes else {}))
|
||||
|
||||
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)
|
||||
has_prev = prev.gross != 0 or prev.commission != 0
|
||||
|
||||
period_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]
|
||||
kpis = [
|
||||
{"key": "gross", "label": f"{period_word} 총매출", "value": cur.gross, "primary": True,
|
||||
"delta": calc.pct_change(cur.gross, prev.gross), "cmp": cmp_label},
|
||||
{"key": "net", "label": f"{period_word} 수수료 차감 매출", "value": cur.net, "primary": True,
|
||||
"delta": calc.pct_change(cur.net, prev.net), "cmp": cmp_label},
|
||||
{"key": "commission", "label": f"{period_word} 수수료", "value": cur.commission,
|
||||
"delta": calc.pct_change(cur.commission, prev.commission) if has_prev else None, "cmp": cmp_label,
|
||||
"invert": True},
|
||||
{"key": "mtd", "label": f"{month_period.label} 누적 매출", "value": mtd.gross,
|
||||
"delta": calc.pct_change(mtd.gross, m_prev.gross), "cmp": m_cmp_label},
|
||||
{"key": "ytd", "label": f"{year_period.label} 누적 매출", "value": ytd.gross,
|
||||
"delta": calc.pct_change(ytd.gross, y_prev.gross), "cmp": y_cmp_label},
|
||||
]
|
||||
|
||||
share = calc.by_code(cells, codes, period.start, period.end)
|
||||
statuses = store.statuses()
|
||||
configured = configured or {}
|
||||
problems = []
|
||||
for m in markets:
|
||||
if m["code"] not in codes:
|
||||
continue
|
||||
st = display_status(m, statuses.get(m["code"]), configured.get(m["code"], False))
|
||||
if st in ("auth_failed", "token_expired", "api_error"):
|
||||
problems.append({"code": m["code"], "name": m["name"], "label": STATUS_LABELS[st],
|
||||
"error": (statuses.get(m["code"]) or {}).get("last_error", "")})
|
||||
|
||||
m_qs = "" if len(codes) == len(all_codes) else "".join(f"&m={c}" for c in codes)
|
||||
|
||||
def url(kind: str, anchor_d: date | None = None, start: date | None = None, end: date | None = None) -> str:
|
||||
if kind == "custom":
|
||||
return f"?period=custom&from={start.isoformat()}&to={end.isoformat()}{m_qs}"
|
||||
return f"?period={kind}&d={anchor_d.isoformat()}{m_qs}"
|
||||
|
||||
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 = url(period.kind, period.prev_anchor)
|
||||
next_url = url(period.kind, period.next_anchor)
|
||||
nav = {
|
||||
"prev": prev_url, "next": next_url,
|
||||
"quick": [
|
||||
{"key": "day", "label": "오늘", "url": url("day", today),
|
||||
"active": period.kind == "day" and period.start == today},
|
||||
{"key": "week", "label": "이번주", "url": url("week", today),
|
||||
"active": period.kind == "week" and period.start <= today <= period.end},
|
||||
{"key": "month", "label": "이번달", "url": url("month", today),
|
||||
"active": period.kind == "month" and period.start <= today <= period.end},
|
||||
{"key": "year", "label": "올해", "url": url("year", today),
|
||||
"active": period.kind == "year" and period.start <= today <= period.end},
|
||||
],
|
||||
"m_qs": m_qs,
|
||||
}
|
||||
|
||||
return {
|
||||
"nav": nav,
|
||||
"period": period,
|
||||
"period_kind": period.kind,
|
||||
"today": today.isoformat(),
|
||||
"codes": codes,
|
||||
"all_codes": all_codes,
|
||||
"names": names,
|
||||
"short_names": short,
|
||||
"selected_all": len(codes) == len(all_codes),
|
||||
"kpis": kpis,
|
||||
"table": calc.main_table(period, codes, cells, today=today, holidays=holidays),
|
||||
"month": calc.month_summary(month_period.start.year, month_period.start.month, codes, cells),
|
||||
"year": calc.year_months(year_period.start.year, codes, cells, today=today),
|
||||
"chart_daily": calc.daily_series(period, codes, cells),
|
||||
"chart_share": [{"code": c, "name": names[c], **share[c].as_dict()} for c in codes],
|
||||
"problems": problems,
|
||||
"manual_codes": manual_codes,
|
||||
"manual_cells": manual_cells,
|
||||
# 엑셀 업로드 대상 — 수동 입력이 켜진 쇼핑몰 전부(쇼핑몰 선택 필터와 무관, 설정 순서)
|
||||
"manual_upload_names": [m["name"] for m in markets if m.get("manual_input")],
|
||||
"last_update_at": store.last_update_at(),
|
||||
"running": store.running_codes(),
|
||||
"no_marketplaces": not all_codes,
|
||||
}
|
||||
|
||||
|
||||
def _short_name(name: str) -> str:
|
||||
return {"네이버 스마트스토어": "네이버", "토스쇼핑": "토스"}.get(name, name)
|
||||
|
||||
|
||||
def build_settings(store: Any, *, configured: Mapping[str, bool], key_info: Mapping[str, Any],
|
||||
key_versions_in_use: Mapping[int, int], sample_count: int) -> dict[str, Any]:
|
||||
from app.timezone import today_kst # noqa: WPS433
|
||||
|
||||
from .adapters.cafe24 import MARKET_MAP # noqa: WPS433
|
||||
|
||||
statuses = store.statuses()
|
||||
rates = store.rate_table()
|
||||
today = today_kst()
|
||||
via_cafe24 = set(MARKET_MAP.values()) # 카페24 마켓 통합관리 경유로 매출이 들어오는 쇼핑몰
|
||||
rows = []
|
||||
by_code = {m["code"]: m for m in store.list_marketplaces()}
|
||||
for adapter in all_adapters():
|
||||
m = by_code.get(adapter.code)
|
||||
if m is None:
|
||||
continue
|
||||
st_row = statuses.get(adapter.code) or {}
|
||||
st = display_status(m, st_row, configured.get(adapter.code, False))
|
||||
cur_rate = calc.rate_on(rates, adapter.code, today)
|
||||
has_rate = bool(rates.get(adapter.code))
|
||||
rows.append({
|
||||
"code": adapter.code, "name": m["name"], "enabled": m["enabled"],
|
||||
"include_in_sales": m["include_in_sales"], "manual_input": bool(m.get("manual_input")),
|
||||
"rate": _fmt_rate(cur_rate) if has_rate else "",
|
||||
"rate_history": len(rates.get(adapter.code, ())),
|
||||
"auth_type": adapter.auth_type, "shared": adapter.uses_shared_integration,
|
||||
"manual_only": adapter.manual_only,
|
||||
"implemented": adapter.implemented, "note": adapter.note, "docs_url": adapter.docs_url,
|
||||
"configured": configured.get(adapter.code, False),
|
||||
"via_cafe24": adapter.code in via_cafe24,
|
||||
"status": st, "status_label": STATUS_LABELS.get(st, st),
|
||||
"last_test_at": st_row.get("last_test_at"), "last_test_ok": st_row.get("last_test_ok"),
|
||||
"last_sync_at": st_row.get("last_sync_at"), "last_success_sync_at": st_row.get("last_success_sync_at"),
|
||||
"last_error": st_row.get("last_error") or "", "last_error_at": st_row.get("last_error_at"),
|
||||
})
|
||||
stale = {v: n for v, n in key_versions_in_use.items() if key_info.get("current_version") and v != key_info["current_version"]}
|
||||
return {"rows": rows, "key_info": key_info, "key_versions_in_use": dict(key_versions_in_use),
|
||||
"stale_key_rows": sum(stale.values()), "sample_count": sample_count,
|
||||
"default_sample_from": today.replace(month=1, day=1).isoformat(),
|
||||
"default_sample_to": today.isoformat()}
|
||||
|
||||
|
||||
def _fmt_rate(rate: Decimal) -> str:
|
||||
s = f"{Decimal(rate):f}"
|
||||
if "." in s:
|
||||
s = s.rstrip("0").rstrip(".")
|
||||
return s
|
||||
@@ -0,0 +1,726 @@
|
||||
"""performance_db PostgreSQL 저장소.
|
||||
|
||||
- 드라이버: psycopg 3 (`psycopg[binary,pool]`) — 다른 모듈과 동일 패턴.
|
||||
- 연결 정보: 환경변수 `PERFORMANCE_DB_URL`
|
||||
(예: postgresql://performance_app:<pwd>@postgres-db:5432/performance_db)
|
||||
- 스키마는 앱이 만들지 않는다. `scripts/sql/performance_db_init.sql` 을 superuser 가 사전 적용.
|
||||
- 연결 풀은 lazy open — 부팅 시 DB 가 잠시 끊겨도 컨테이너가 죽지 않게.
|
||||
|
||||
이 저장소는 인증정보를 **암호문 그대로만** 읽고 쓴다. 암·복호화는 credentials.py 의 몫.
|
||||
"""
|
||||
|
||||
from __future__ import annotations
|
||||
|
||||
from datetime import date, datetime, timedelta
|
||||
from decimal import Decimal
|
||||
from typing import Any, Iterable
|
||||
|
||||
from psycopg import errors as pg_errors
|
||||
from psycopg.rows import dict_row
|
||||
from psycopg.types.json import Jsonb
|
||||
from psycopg_pool import ConnectionPool
|
||||
|
||||
from app.timezone import to_kst_iso
|
||||
|
||||
# running 상태로 이 시간 넘게 남은 동기화는 죽은 것으로 보고 정리한다(서버 재시작 등).
|
||||
STALE_RUN_AFTER = timedelta(minutes=30)
|
||||
|
||||
|
||||
class ManualMigrationNeeded(Exception):
|
||||
"""수동 입력(마이그레이션 002: perf_marketplaces.manual_input · perf_manual_sales)이 아직 적용되지 않음."""
|
||||
|
||||
|
||||
def _iso(v: Any) -> Any:
|
||||
if isinstance(v, datetime):
|
||||
return to_kst_iso(v)
|
||||
if isinstance(v, date):
|
||||
return v.isoformat()
|
||||
return v
|
||||
|
||||
|
||||
class PerformanceDBStore:
|
||||
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},
|
||||
open=False,
|
||||
)
|
||||
self._pool.open(wait=False)
|
||||
|
||||
def close(self) -> None:
|
||||
self._pool.close()
|
||||
|
||||
# ════════════════════════════════════════════════════════════
|
||||
# 쇼핑몰 기본 설정
|
||||
# ════════════════════════════════════════════════════════════
|
||||
def list_marketplaces(self) -> list[dict[str, Any]]:
|
||||
with self._pool.connection() as conn:
|
||||
rows = conn.execute("SELECT * FROM perf_marketplaces ORDER BY sort_order, code").fetchall()
|
||||
return [{k: _iso(v) for k, v in r.items()} for r in rows]
|
||||
|
||||
def update_marketplace(self, code: str, *, enabled: bool | None = None,
|
||||
include_in_sales: bool | None = None,
|
||||
manual_input: bool | None = None) -> dict[str, Any] | None:
|
||||
sets, params = [], []
|
||||
if manual_input is not None:
|
||||
sets.append("manual_input = %s")
|
||||
params.append(bool(manual_input))
|
||||
if enabled is not None:
|
||||
sets.append("enabled = %s")
|
||||
params.append(bool(enabled))
|
||||
if include_in_sales is not None:
|
||||
sets.append("include_in_sales = %s")
|
||||
params.append(bool(include_in_sales))
|
||||
if not sets:
|
||||
return None
|
||||
params.append(code)
|
||||
try:
|
||||
with self._pool.connection() as conn:
|
||||
row = conn.execute(
|
||||
f"UPDATE perf_marketplaces SET {', '.join(sets)} WHERE code = %s RETURNING *", params
|
||||
).fetchone()
|
||||
except pg_errors.UndefinedColumn:
|
||||
raise ManualMigrationNeeded() from None
|
||||
return {k: _iso(v) for k, v in row.items()} if row else None
|
||||
|
||||
# ════════════════════════════════════════════════════════════
|
||||
# 수수료율 이력
|
||||
# ════════════════════════════════════════════════════════════
|
||||
def rate_table(self) -> dict[str, list[tuple[date, Decimal]]]:
|
||||
with self._pool.connection() as conn:
|
||||
rows = conn.execute(
|
||||
"SELECT marketplace_code, effective_from, rate_percent FROM perf_commission_rates "
|
||||
"WHERE rule_type = 'marketplace' ORDER BY marketplace_code, effective_from"
|
||||
).fetchall()
|
||||
out: dict[str, list[tuple[date, Decimal]]] = {}
|
||||
for r in rows:
|
||||
out.setdefault(r["marketplace_code"], []).append((r["effective_from"], Decimal(r["rate_percent"])))
|
||||
return out
|
||||
|
||||
def list_rates(self, code: str) -> list[dict[str, Any]]:
|
||||
with self._pool.connection() as conn:
|
||||
rows = conn.execute(
|
||||
"SELECT id, rate_percent, effective_from, memo, created_by, created_at "
|
||||
"FROM perf_commission_rates WHERE marketplace_code = %s AND rule_type = 'marketplace' "
|
||||
"ORDER BY effective_from DESC",
|
||||
(code,),
|
||||
).fetchall()
|
||||
return [{k: (str(v) if isinstance(v, Decimal) else _iso(v)) for k, v in r.items()} for r in rows]
|
||||
|
||||
def set_rate(self, code: str, *, rate_percent: Decimal, effective_from: date,
|
||||
memo: str = "", user: str = "") -> None:
|
||||
"""같은 적용 시작일이면 덮어쓴다(오타 수정), 다르면 이력으로 추가."""
|
||||
with self._pool.connection() as conn:
|
||||
conn.execute(
|
||||
"""
|
||||
INSERT INTO perf_commission_rates
|
||||
(marketplace_code, rule_type, rate_percent, effective_from, memo, created_by)
|
||||
VALUES (%s, 'marketplace', %s, %s, %s, %s)
|
||||
ON CONFLICT (marketplace_code, rule_type, effective_from) DO UPDATE
|
||||
SET rate_percent = EXCLUDED.rate_percent, memo = EXCLUDED.memo,
|
||||
created_by = EXCLUDED.created_by, created_at = now()
|
||||
""",
|
||||
(code, rate_percent, effective_from, memo, user),
|
||||
)
|
||||
|
||||
def delete_rate(self, code: str, rate_id: int) -> bool:
|
||||
with self._pool.connection() as conn:
|
||||
cur = conn.execute(
|
||||
"DELETE FROM perf_commission_rates WHERE id = %s AND marketplace_code = %s", (rate_id, code)
|
||||
)
|
||||
return cur.rowcount > 0
|
||||
|
||||
# ════════════════════════════════════════════════════════════
|
||||
# 인증정보(암호문)
|
||||
# ════════════════════════════════════════════════════════════
|
||||
def credential_rows(self, code: str) -> dict[str, dict[str, Any]]:
|
||||
with self._pool.connection() as conn:
|
||||
rows = conn.execute(
|
||||
"SELECT credential_key, encrypted_value, key_version, updated_at, updated_by "
|
||||
"FROM perf_credentials WHERE marketplace_code = %s",
|
||||
(code,),
|
||||
).fetchall()
|
||||
return {r["credential_key"]: r for r in rows}
|
||||
|
||||
def credential_keys_by_code(self) -> dict[str, set[str]]:
|
||||
with self._pool.connection() as conn:
|
||||
rows = conn.execute("SELECT marketplace_code, credential_key FROM perf_credentials").fetchall()
|
||||
out: dict[str, set[str]] = {}
|
||||
for r in rows:
|
||||
out.setdefault(r["marketplace_code"], set()).add(r["credential_key"])
|
||||
return out
|
||||
|
||||
def upsert_credential(self, code: str, key: str, *, encrypted_value: str, key_version: int,
|
||||
user: str = "") -> None:
|
||||
with self._pool.connection() as conn:
|
||||
conn.execute(
|
||||
"""
|
||||
INSERT INTO perf_credentials (marketplace_code, credential_key, encrypted_value, key_version, updated_by)
|
||||
VALUES (%s, %s, %s, %s, %s)
|
||||
ON CONFLICT (marketplace_code, credential_key) DO UPDATE
|
||||
SET encrypted_value = EXCLUDED.encrypted_value, key_version = EXCLUDED.key_version,
|
||||
updated_by = EXCLUDED.updated_by
|
||||
""",
|
||||
(code, key, encrypted_value, key_version, user),
|
||||
)
|
||||
|
||||
def delete_credential(self, code: str, key: str) -> None:
|
||||
with self._pool.connection() as conn:
|
||||
conn.execute(
|
||||
"DELETE FROM perf_credentials WHERE marketplace_code = %s AND credential_key = %s", (code, key)
|
||||
)
|
||||
|
||||
def all_credential_rows(self) -> list[dict[str, Any]]:
|
||||
with self._pool.connection() as conn:
|
||||
return conn.execute(
|
||||
"SELECT marketplace_code, credential_key, encrypted_value, key_version FROM perf_credentials"
|
||||
).fetchall()
|
||||
|
||||
# ════════════════════════════════════════════════════════════
|
||||
# 연결 상태
|
||||
# ════════════════════════════════════════════════════════════
|
||||
def statuses(self) -> dict[str, dict[str, Any]]:
|
||||
with self._pool.connection() as conn:
|
||||
rows = conn.execute("SELECT * FROM perf_connection_status").fetchall()
|
||||
return {r["marketplace_code"]: {k: _iso(v) for k, v in r.items()} for r in rows}
|
||||
|
||||
def record_test(self, code: str, *, status: str, ok: bool, error: str = "") -> None:
|
||||
with self._pool.connection() as conn:
|
||||
conn.execute(
|
||||
"""
|
||||
INSERT INTO perf_connection_status (marketplace_code, status, last_test_at, last_test_ok,
|
||||
last_error, last_error_at)
|
||||
VALUES (%s, %s, now(), %s, %s, CASE WHEN %s = '' THEN NULL ELSE now() END)
|
||||
ON CONFLICT (marketplace_code) DO UPDATE
|
||||
SET status = EXCLUDED.status, last_test_at = now(), last_test_ok = EXCLUDED.last_test_ok,
|
||||
last_error = CASE WHEN EXCLUDED.last_error = '' THEN perf_connection_status.last_error
|
||||
ELSE EXCLUDED.last_error END,
|
||||
last_error_at = CASE WHEN EXCLUDED.last_error = '' THEN perf_connection_status.last_error_at
|
||||
ELSE now() END
|
||||
""",
|
||||
(code, status, ok, error, error),
|
||||
)
|
||||
|
||||
def record_sync(self, code: str, *, status: str, ok: bool, error: str = "") -> None:
|
||||
with self._pool.connection() as conn:
|
||||
conn.execute(
|
||||
"""
|
||||
INSERT INTO perf_connection_status (marketplace_code, status, last_sync_at,
|
||||
last_success_sync_at, last_error, last_error_at)
|
||||
VALUES (%s, %s, now(), CASE WHEN %s THEN now() END, %s, CASE WHEN %s = '' THEN NULL ELSE now() END)
|
||||
ON CONFLICT (marketplace_code) DO UPDATE
|
||||
SET status = EXCLUDED.status, last_sync_at = now(),
|
||||
last_success_sync_at = CASE WHEN %s THEN now()
|
||||
ELSE perf_connection_status.last_success_sync_at END,
|
||||
last_error = CASE WHEN EXCLUDED.last_error = '' THEN perf_connection_status.last_error
|
||||
ELSE EXCLUDED.last_error END,
|
||||
last_error_at = CASE WHEN EXCLUDED.last_error = '' THEN perf_connection_status.last_error_at
|
||||
ELSE now() END
|
||||
""",
|
||||
(code, status, ok, error, error, ok),
|
||||
)
|
||||
|
||||
# ════════════════════════════════════════════════════════════
|
||||
# 매출 사건
|
||||
# ════════════════════════════════════════════════════════════
|
||||
def upsert_events(self, code: str, events: Iterable[dict[str, Any]], *, is_sample: bool = False) -> int:
|
||||
"""같은 (쇼핑몰, 사건 종류, 외부 사건 ID)는 덮어쓴다 — 여러 번 동기화해도 중복 없음."""
|
||||
rows = self._event_rows(code, events, is_sample)
|
||||
if not rows:
|
||||
return 0
|
||||
with self._pool.connection() as conn:
|
||||
with conn.transaction():
|
||||
with conn.cursor() as cur:
|
||||
cur.executemany(self._UPSERT_SQL, rows)
|
||||
return len(rows)
|
||||
|
||||
def replace_events(self, code: str, start: date, end: date, events: Iterable[dict[str, Any]],
|
||||
*, id_prefix: str = "") -> int:
|
||||
"""기간(sales_date) 안 이 어댑터가 만든 실데이터(is_sample 아님)를 지우고 새로 넣는다 — 한 트랜잭션.
|
||||
|
||||
지우는 대상: 이 쇼핑몰(code)의 행 + (id_prefix 가 있으면) 다른 쇼핑몰 열로 보냈던 이 어댑터의 행
|
||||
(external_event_id 가 id_prefix 로 시작). 다른 쇼핑몰의 직접 연동분·테스트 데이터는 건드리지 않는다.
|
||||
실패하면 롤백되어 예전 데이터가 그대로 남는다."""
|
||||
rows = self._event_rows(code, events, False)
|
||||
with self._pool.connection() as conn:
|
||||
with conn.transaction():
|
||||
if id_prefix:
|
||||
conn.execute(
|
||||
"DELETE FROM perf_sales_events WHERE is_sample = FALSE AND sales_date BETWEEN %s AND %s "
|
||||
"AND (marketplace_code = %s OR left(external_event_id, %s) = %s)",
|
||||
(start, end, code, len(id_prefix), id_prefix),
|
||||
)
|
||||
else:
|
||||
conn.execute(
|
||||
"DELETE FROM perf_sales_events WHERE marketplace_code = %s AND is_sample = FALSE "
|
||||
"AND sales_date BETWEEN %s AND %s",
|
||||
(code, start, end),
|
||||
)
|
||||
if rows:
|
||||
with conn.cursor() as cur:
|
||||
cur.executemany(self._UPSERT_SQL, rows)
|
||||
return len(rows)
|
||||
|
||||
@staticmethod
|
||||
def _event_rows(code: str, events: Iterable[dict[str, Any]], is_sample: bool) -> list[tuple]:
|
||||
"""행마다 집계할 쇼핑몰 = 사건의 marketplace_code(다른 쇼핑몰 대신 받은 주문), 없으면 code."""
|
||||
return [
|
||||
(e.get("marketplace_code") or code, e["event_type"], e["external_event_id"], e["external_order_id"],
|
||||
e.get("external_line_id", ""),
|
||||
e.get("order_date"), e.get("payment_date"), e["event_date"], e["sales_date"],
|
||||
e.get("product_name", ""), e.get("option_name", ""), int(e.get("quantity") or 0),
|
||||
int(e["amount"]), int(e.get("discount_amount") or 0), e.get("order_status", ""),
|
||||
Jsonb(e.get("raw") or {}), is_sample)
|
||||
for e in events
|
||||
]
|
||||
|
||||
_UPSERT_SQL = """
|
||||
INSERT INTO perf_sales_events
|
||||
(marketplace_code, event_type, external_event_id, external_order_id, external_line_id,
|
||||
order_date, payment_date, event_date, sales_date, product_name, option_name, quantity,
|
||||
amount, discount_amount, order_status, raw_data, is_sample, synced_at)
|
||||
VALUES (%s, %s, %s, %s, %s, %s, %s, %s, %s, %s, %s, %s, %s, %s, %s, %s, %s, now())
|
||||
ON CONFLICT (marketplace_code, event_type, external_event_id) DO UPDATE
|
||||
SET external_order_id = EXCLUDED.external_order_id, external_line_id = EXCLUDED.external_line_id,
|
||||
order_date = EXCLUDED.order_date, payment_date = EXCLUDED.payment_date,
|
||||
event_date = EXCLUDED.event_date, sales_date = EXCLUDED.sales_date,
|
||||
product_name = EXCLUDED.product_name, option_name = EXCLUDED.option_name,
|
||||
quantity = EXCLUDED.quantity, amount = EXCLUDED.amount,
|
||||
discount_amount = EXCLUDED.discount_amount, order_status = EXCLUDED.order_status,
|
||||
raw_data = EXCLUDED.raw_data, is_sample = EXCLUDED.is_sample, synced_at = now()
|
||||
"""
|
||||
|
||||
def daily_amounts(self, start: date, end: date, codes: list[str]) -> dict[tuple[date, str], int]:
|
||||
"""날짜 × 쇼핑몰 총매출. 수동 입력이 켜진 쇼핑몰은 수동 값을 넣은 날 그 값이 API 수집값을 대신한다
|
||||
(실적 화면·회의록 머리 카드가 같은 숫자를 보게 여기서 합친다)."""
|
||||
if not codes:
|
||||
return {}
|
||||
with self._pool.connection() as conn:
|
||||
rows = conn.execute(
|
||||
"SELECT sales_date, marketplace_code, SUM(amount)::BIGINT AS amount "
|
||||
"FROM perf_sales_events WHERE sales_date BETWEEN %s AND %s AND marketplace_code = ANY(%s) "
|
||||
"GROUP BY sales_date, marketplace_code",
|
||||
(start, end, codes),
|
||||
).fetchall()
|
||||
out = {(r["sales_date"], r["marketplace_code"]): int(r["amount"] or 0) for r in rows}
|
||||
out.update(self.manual_amounts(start, end, codes))
|
||||
return out
|
||||
|
||||
# ════════════════════════════════════════════════════════════
|
||||
# 수동 입력 매출(마이그레이션 002)
|
||||
# ════════════════════════════════════════════════════════════
|
||||
def manual_amounts(self, start: date, end: date, codes: list[str], *,
|
||||
active_only: bool = True) -> dict[tuple[date, str], int]:
|
||||
"""수동 입력 값. active_only = 그 쇼핑몰 수동 입력이 켜진 것만(집계에 쓰는 값). 002 미적용이면 비어 있음."""
|
||||
if not codes:
|
||||
return {}
|
||||
try:
|
||||
with self._pool.connection() as conn:
|
||||
rows = conn.execute(
|
||||
"SELECT s.sales_date, s.marketplace_code, s.amount FROM perf_manual_sales s "
|
||||
"JOIN perf_marketplaces m ON m.code = s.marketplace_code "
|
||||
"WHERE s.sales_date BETWEEN %s AND %s AND s.marketplace_code = ANY(%s)"
|
||||
+ (" AND m.manual_input" if active_only else ""),
|
||||
(start, end, codes),
|
||||
).fetchall()
|
||||
except (pg_errors.UndefinedTable, pg_errors.UndefinedColumn):
|
||||
return {}
|
||||
return {(r["sales_date"], r["marketplace_code"]): int(r["amount"]) for r in rows}
|
||||
|
||||
def api_amount(self, code: str, day: date) -> int:
|
||||
"""그날 API 수집 합계(수동 값과 무관) — 수동 입력 칸에 참고로 보여 준다."""
|
||||
with self._pool.connection() as conn:
|
||||
row = conn.execute(
|
||||
"SELECT COALESCE(SUM(amount), 0)::BIGINT AS amount FROM perf_sales_events "
|
||||
"WHERE marketplace_code = %s AND sales_date = %s", (code, day),
|
||||
).fetchone()
|
||||
return int(row["amount"] or 0)
|
||||
|
||||
def set_manual_sale(self, code: str, day: date, amount: int | None, *, user: str = "") -> None:
|
||||
"""수동 값 저장(amount None = 지움 → 그날은 다시 API 값)."""
|
||||
try:
|
||||
with self._pool.connection() as conn:
|
||||
if amount is None:
|
||||
conn.execute("DELETE FROM perf_manual_sales WHERE marketplace_code = %s AND sales_date = %s",
|
||||
(code, day))
|
||||
else:
|
||||
conn.execute(
|
||||
"INSERT INTO perf_manual_sales (marketplace_code, sales_date, amount, updated_by) "
|
||||
"VALUES (%s, %s, %s, %s) ON CONFLICT (marketplace_code, sales_date) DO UPDATE "
|
||||
"SET amount = EXCLUDED.amount, updated_by = EXCLUDED.updated_by",
|
||||
(code, day, int(amount), user),
|
||||
)
|
||||
except pg_errors.UndefinedTable:
|
||||
raise ManualMigrationNeeded() from None
|
||||
|
||||
def set_manual_sales_bulk(self, entries: list[tuple[str, date, int]], *, user: str = "") -> int:
|
||||
"""엑셀 업로드 — (쇼핑몰, 날짜, 금액) 여러 개를 한 트랜잭션으로 저장(덮어씀). 하나라도 실패하면 모두 취소."""
|
||||
if not entries:
|
||||
return 0
|
||||
try:
|
||||
with self._pool.connection() as conn:
|
||||
with conn.transaction():
|
||||
with conn.cursor() as cur:
|
||||
cur.executemany(
|
||||
"INSERT INTO perf_manual_sales (marketplace_code, sales_date, amount, updated_by) "
|
||||
"VALUES (%s, %s, %s, %s) ON CONFLICT (marketplace_code, sales_date) DO UPDATE "
|
||||
"SET amount = EXCLUDED.amount, updated_by = EXCLUDED.updated_by",
|
||||
[(code, day, int(amount), user) for code, day, amount in entries],
|
||||
)
|
||||
except pg_errors.UndefinedTable:
|
||||
raise ManualMigrationNeeded() from None
|
||||
return len(entries)
|
||||
|
||||
# ════════════════════════════════════════════════════════════
|
||||
# 광고비(마이그레이션 005)
|
||||
# ════════════════════════════════════════════════════════════
|
||||
def ad_amounts(self, start: date, end: date) -> tuple[dict[tuple[date, str], int], dict[tuple[date, str], str]]:
|
||||
"""(날짜, 채널) → 금액, (날짜, 채널) → 입력 방식(manual/upload/api). 005 미적용이면 AdMigrationNeeded."""
|
||||
from .ad_spend import AdMigrationNeeded # noqa: WPS433
|
||||
|
||||
try:
|
||||
with self._pool.connection() as conn:
|
||||
rows = conn.execute(
|
||||
"SELECT spend_date, channel_code, amount, source FROM perf_ad_spend "
|
||||
"WHERE spend_date BETWEEN %s AND %s", (start, end),
|
||||
).fetchall()
|
||||
except pg_errors.UndefinedTable:
|
||||
raise AdMigrationNeeded() from None
|
||||
return ({(r["spend_date"], r["channel_code"]): int(r["amount"]) for r in rows},
|
||||
{(r["spend_date"], r["channel_code"]): r["source"] for r in rows})
|
||||
|
||||
def set_ad_spend(self, code: str, day: date, amount: int | None, *, source: str = "manual", user: str = "") -> None:
|
||||
"""광고비 한 칸 저장(amount None = 지움)."""
|
||||
self.set_ad_spend_bulk(code, [(day, amount)], source=source, user=user)
|
||||
|
||||
def set_ad_spend_bulk(self, code: str, entries: list[tuple[date, int | None]], *, source: str = "manual",
|
||||
user: str = "", roas: dict[date, Any] | None = None,
|
||||
metrics: dict[date, dict[str, Any]] | None = None) -> int:
|
||||
"""여러 날을 한 트랜잭션으로(같은 날은 덮어씀, 금액 None 은 지움). 하나라도 실패하면 모두 취소.
|
||||
roas·metrics 를 주면(보고서 업로드, 마이그레이션 006) 그 날의 ROAS·상세 항목도 덮어쓴다 — 안 주면(직접 입력) 그대로 둔다."""
|
||||
from .ad_spend import AdMigrationNeeded # noqa: WPS433
|
||||
|
||||
if not entries:
|
||||
return 0
|
||||
report = roas is not None or metrics is not None
|
||||
try:
|
||||
with self._pool.connection() as conn:
|
||||
with conn.transaction():
|
||||
with conn.cursor() as cur:
|
||||
gone = [(code, d) for d, a in entries if a is None]
|
||||
if gone:
|
||||
cur.executemany("DELETE FROM perf_ad_spend WHERE channel_code = %s AND spend_date = %s", gone)
|
||||
if report:
|
||||
keep6 = [(code, d, int(a), source, user, (roas or {}).get(d),
|
||||
Jsonb((metrics or {}).get(d)) if (metrics or {}).get(d) is not None else None)
|
||||
for d, a in entries if a is not None]
|
||||
if keep6:
|
||||
cur.executemany(
|
||||
"INSERT INTO perf_ad_spend (channel_code, spend_date, amount, source, updated_by, roas, metrics) "
|
||||
"VALUES (%s, %s, %s, %s, %s, %s, %s) ON CONFLICT (channel_code, spend_date) DO UPDATE "
|
||||
"SET amount = EXCLUDED.amount, source = EXCLUDED.source, updated_by = EXCLUDED.updated_by, "
|
||||
"roas = EXCLUDED.roas, metrics = EXCLUDED.metrics",
|
||||
keep6,
|
||||
)
|
||||
else:
|
||||
keep = [(code, d, int(a), source, user) for d, a in entries if a is not None]
|
||||
if keep:
|
||||
cur.executemany(
|
||||
"INSERT INTO perf_ad_spend (channel_code, spend_date, amount, source, updated_by) "
|
||||
"VALUES (%s, %s, %s, %s, %s) ON CONFLICT (channel_code, spend_date) DO UPDATE "
|
||||
"SET amount = EXCLUDED.amount, source = EXCLUDED.source, updated_by = EXCLUDED.updated_by",
|
||||
keep,
|
||||
)
|
||||
except pg_errors.UndefinedTable:
|
||||
raise AdMigrationNeeded("005") from None
|
||||
except pg_errors.UndefinedColumn:
|
||||
raise AdMigrationNeeded("006") from None
|
||||
return len(entries)
|
||||
|
||||
def ad_roas(self, start: date, end: date) -> dict[tuple[date, str], Decimal]:
|
||||
"""(날짜, 채널) → 보고서 ROAS(%) — 값이 있는 칸만. 005·006 미적용이면 빈 값(화면은 ROAS 없이)."""
|
||||
try:
|
||||
with self._pool.connection() as conn:
|
||||
rows = conn.execute(
|
||||
"SELECT spend_date, channel_code, roas FROM perf_ad_spend "
|
||||
"WHERE spend_date BETWEEN %s AND %s AND roas IS NOT NULL", (start, end),
|
||||
).fetchall()
|
||||
except (pg_errors.UndefinedTable, pg_errors.UndefinedColumn):
|
||||
return {}
|
||||
return {(r["spend_date"], r["channel_code"]): r["roas"] for r in rows}
|
||||
|
||||
def ad_details(self, code: str, start: date, end: date) -> list[dict[str, Any]]:
|
||||
"""한 채널의 일자별 광고비·ROAS·보고서 항목(날짜 순). 006 미적용이면 AdMigrationNeeded."""
|
||||
from .ad_spend import AdMigrationNeeded # noqa: WPS433
|
||||
|
||||
try:
|
||||
with self._pool.connection() as conn:
|
||||
rows = conn.execute(
|
||||
"SELECT spend_date, amount, roas, metrics, source FROM perf_ad_spend "
|
||||
"WHERE channel_code = %s AND spend_date BETWEEN %s AND %s ORDER BY spend_date",
|
||||
(code, start, end),
|
||||
).fetchall()
|
||||
except pg_errors.UndefinedTable:
|
||||
raise AdMigrationNeeded("005") from None
|
||||
except pg_errors.UndefinedColumn:
|
||||
raise AdMigrationNeeded("006") from None
|
||||
return [{"date": r["spend_date"].isoformat(), "amount": int(r["amount"]), "roas": r["roas"],
|
||||
"metrics": r["metrics"] or {}, "source": r["source"]} for r in rows]
|
||||
|
||||
def daily_breakdown(self, code: str, start: date, end: date, *, id_prefix: str = "") -> list[dict[str, Any]]:
|
||||
"""쇼핑몰 화면(일별 매출내역) 대조용 — 날짜별 결제(SALE 합·건수)·환불(그 밖, 양수)·마지막 수집 시각.
|
||||
id_prefix 가 있으면 이 어댑터가 다른 쇼핑몰 열로 보낸 사건까지 합친다(카페24 화면 합계와 같은 범위)."""
|
||||
where = "(marketplace_code = %s OR left(external_event_id, %s) = %s)" if id_prefix else "marketplace_code = %s"
|
||||
params: tuple = (code, len(id_prefix), id_prefix) if id_prefix else (code,)
|
||||
with self._pool.connection() as conn:
|
||||
rows = conn.execute(
|
||||
"SELECT sales_date, "
|
||||
" COALESCE(SUM(amount) FILTER (WHERE event_type = 'SALE'), 0)::BIGINT AS paid, "
|
||||
" COUNT(*) FILTER (WHERE event_type = 'SALE')::INT AS orders, "
|
||||
" COALESCE(-SUM(amount) FILTER (WHERE event_type <> 'SALE'), 0)::BIGINT AS refund, "
|
||||
" MAX(synced_at) AS synced_at "
|
||||
f"FROM perf_sales_events WHERE is_sample = FALSE AND sales_date BETWEEN %s AND %s AND {where} "
|
||||
"GROUP BY sales_date ORDER BY sales_date",
|
||||
(start, end, *params),
|
||||
).fetchall()
|
||||
return [{"date": r["sales_date"].isoformat(), "paid": int(r["paid"]), "orders": int(r["orders"]),
|
||||
"refund": int(r["refund"]), "synced_at": _iso(r["synced_at"])} for r in rows]
|
||||
|
||||
def list_events(self, code: str, start: date, end: date, *, limit: int = 500) -> list[dict[str, Any]]:
|
||||
"""금액 클릭 상세(Drill-down). raw_data 는 보내지 않는다."""
|
||||
with self._pool.connection() as conn:
|
||||
rows = conn.execute(
|
||||
"SELECT id, event_type, external_order_id, external_line_id, order_date, payment_date, "
|
||||
" event_date, sales_date, product_name, option_name, quantity, amount, "
|
||||
" discount_amount, order_status, is_sample "
|
||||
"FROM perf_sales_events WHERE marketplace_code = %s AND sales_date BETWEEN %s AND %s "
|
||||
"ORDER BY sales_date, external_order_id, event_type LIMIT %s",
|
||||
(code, start, end, limit),
|
||||
).fetchall()
|
||||
return [{k: _iso(v) for k, v in r.items()} for r in rows]
|
||||
|
||||
def sample_count(self) -> int:
|
||||
with self._pool.connection() as conn:
|
||||
row = conn.execute("SELECT COUNT(*) AS n FROM perf_sales_events WHERE is_sample").fetchone()
|
||||
return int(row["n"] or 0)
|
||||
|
||||
def delete_sample_events(self) -> int:
|
||||
"""테스트 데이터만(is_sample) 지운다 — 조건이 있는 삭제."""
|
||||
with self._pool.connection() as conn:
|
||||
cur = conn.execute("DELETE FROM perf_sales_events WHERE is_sample = TRUE")
|
||||
return cur.rowcount
|
||||
|
||||
# ════════════════════════════════════════════════════════════
|
||||
# 동기화 실행(중복 실행 방지)
|
||||
# ════════════════════════════════════════════════════════════
|
||||
def start_run(self, code: str, *, trigger: str, range_from: date, range_to: date, user: str) -> int | None:
|
||||
"""running 행을 만든다. 이미 돌고 있으면 None(부분 유니크 인덱스로 막힘)."""
|
||||
import psycopg # noqa: WPS433
|
||||
|
||||
with self._pool.connection() as conn:
|
||||
conn.execute(
|
||||
"UPDATE perf_sync_runs SET status = 'failed', finished_at = now(), "
|
||||
"error = '중단됨(시간 초과로 정리)' "
|
||||
"WHERE marketplace_code = %s AND status = 'running' AND started_at < now() - %s",
|
||||
(code, STALE_RUN_AFTER),
|
||||
)
|
||||
try:
|
||||
row = conn.execute(
|
||||
"INSERT INTO perf_sync_runs (marketplace_code, trigger, range_from, range_to, started_by) "
|
||||
"VALUES (%s, %s, %s, %s, %s) RETURNING id",
|
||||
(code, trigger, range_from, range_to, user),
|
||||
).fetchone()
|
||||
except psycopg.errors.UniqueViolation:
|
||||
return None
|
||||
return int(row["id"])
|
||||
|
||||
def finish_run(self, run_id: int, *, ok: bool, fetched: int = 0, upserted: int = 0, error: str = "") -> None:
|
||||
with self._pool.connection() as conn:
|
||||
conn.execute(
|
||||
"UPDATE perf_sync_runs SET status = %s, fetched_count = %s, upserted_count = %s, "
|
||||
"error = %s, finished_at = now() WHERE id = %s",
|
||||
("success" if ok else "failed", fetched, upserted, error, run_id),
|
||||
)
|
||||
|
||||
def last_update_at(self) -> str | None:
|
||||
"""대시보드 "마지막 업데이트" — 성공한 동기화 중 가장 최근."""
|
||||
with self._pool.connection() as conn:
|
||||
row = conn.execute(
|
||||
"SELECT MAX(finished_at) AS t FROM perf_sync_runs WHERE status = 'success'"
|
||||
).fetchone()
|
||||
return _iso(row["t"]) if row and row["t"] else None
|
||||
|
||||
def running_codes(self) -> list[str]:
|
||||
with self._pool.connection() as conn:
|
||||
rows = conn.execute(
|
||||
"SELECT marketplace_code FROM perf_sync_runs WHERE status = 'running' "
|
||||
"AND started_at >= now() - %s",
|
||||
(STALE_RUN_AFTER,),
|
||||
).fetchall()
|
||||
return [r["marketplace_code"] for r in rows]
|
||||
|
||||
# ════════════════════════════════════════════════════════════
|
||||
# 광고 API 연동(마이그레이션 007) — 인증정보(암호문)·연결 상태·가져온 광고비
|
||||
# 읽기는 007 미적용이면 빈 값(설정 화면은 안내만), 쓰기는 AdMigrationNeeded("007").
|
||||
# ════════════════════════════════════════════════════════════
|
||||
def ad_api_ready(self) -> bool:
|
||||
try:
|
||||
with self._pool.connection() as conn:
|
||||
conn.execute("SELECT 1 FROM perf_ad_credentials LIMIT 1").fetchall()
|
||||
except pg_errors.UndefinedTable:
|
||||
return False
|
||||
return True
|
||||
|
||||
def ad_credential_rows(self, code: str) -> dict[str, dict[str, Any]]:
|
||||
try:
|
||||
with self._pool.connection() as conn:
|
||||
rows = conn.execute(
|
||||
"SELECT credential_key, encrypted_value, key_version, updated_at, updated_by "
|
||||
"FROM perf_ad_credentials WHERE channel_code = %s", (code,),
|
||||
).fetchall()
|
||||
except pg_errors.UndefinedTable:
|
||||
return {}
|
||||
return {r["credential_key"]: r for r in rows}
|
||||
|
||||
def ad_credential_keys_by_code(self) -> dict[str, set[str]]:
|
||||
try:
|
||||
with self._pool.connection() as conn:
|
||||
rows = conn.execute("SELECT channel_code, credential_key FROM perf_ad_credentials").fetchall()
|
||||
except pg_errors.UndefinedTable:
|
||||
return {}
|
||||
out: dict[str, set[str]] = {}
|
||||
for r in rows:
|
||||
out.setdefault(r["channel_code"], set()).add(r["credential_key"])
|
||||
return out
|
||||
|
||||
def upsert_ad_credential(self, code: str, key: str, *, encrypted_value: str, key_version: int, user: str = "") -> None:
|
||||
from .ad_spend import AdMigrationNeeded # noqa: WPS433
|
||||
|
||||
try:
|
||||
with self._pool.connection() as conn:
|
||||
conn.execute(
|
||||
"""
|
||||
INSERT INTO perf_ad_credentials (channel_code, credential_key, encrypted_value, key_version, updated_by)
|
||||
VALUES (%s, %s, %s, %s, %s)
|
||||
ON CONFLICT (channel_code, credential_key) DO UPDATE
|
||||
SET encrypted_value = EXCLUDED.encrypted_value, key_version = EXCLUDED.key_version,
|
||||
updated_by = EXCLUDED.updated_by
|
||||
""",
|
||||
(code, key, encrypted_value, key_version, user),
|
||||
)
|
||||
except pg_errors.UndefinedTable:
|
||||
raise AdMigrationNeeded("007") from None
|
||||
|
||||
def delete_ad_credential(self, code: str, key: str) -> None:
|
||||
from .ad_spend import AdMigrationNeeded # noqa: WPS433
|
||||
|
||||
try:
|
||||
with self._pool.connection() as conn:
|
||||
conn.execute("DELETE FROM perf_ad_credentials WHERE channel_code = %s AND credential_key = %s", (code, key))
|
||||
except pg_errors.UndefinedTable:
|
||||
raise AdMigrationNeeded("007") from None
|
||||
|
||||
def all_ad_credential_rows(self) -> list[dict[str, Any]]:
|
||||
try:
|
||||
with self._pool.connection() as conn:
|
||||
return conn.execute(
|
||||
"SELECT channel_code AS marketplace_code, credential_key, encrypted_value, key_version "
|
||||
"FROM perf_ad_credentials"
|
||||
).fetchall()
|
||||
except pg_errors.UndefinedTable:
|
||||
return []
|
||||
|
||||
def ad_source_statuses(self) -> dict[str, dict[str, Any]]:
|
||||
try:
|
||||
with self._pool.connection() as conn:
|
||||
rows = conn.execute("SELECT * FROM perf_ad_source_status").fetchall()
|
||||
except pg_errors.UndefinedTable:
|
||||
return {}
|
||||
return {r["channel_code"]: {k: _iso(v) for k, v in r.items()} for r in rows}
|
||||
|
||||
def record_ad_status(self, code: str, *, status: str, ok: bool, error: str = "", kind: str = "test") -> None:
|
||||
"""연결 테스트(kind=test) 또는 가져오기(kind=sync) 결과. 오류가 없으면 예전 오류 문구는 그대로 둔다."""
|
||||
if kind == "sync":
|
||||
sql = """
|
||||
INSERT INTO perf_ad_source_status (channel_code, status, last_sync_at, last_success_sync_at, last_error, last_error_at)
|
||||
VALUES (%(c)s, %(s)s, now(), CASE WHEN %(ok)s THEN now() END, %(e)s, CASE WHEN %(e)s = '' THEN NULL ELSE now() END)
|
||||
ON CONFLICT (channel_code) DO UPDATE
|
||||
SET status = EXCLUDED.status, last_sync_at = now(),
|
||||
last_success_sync_at = CASE WHEN %(ok)s THEN now() ELSE perf_ad_source_status.last_success_sync_at END,
|
||||
last_error = CASE WHEN %(e)s = '' THEN perf_ad_source_status.last_error ELSE %(e)s END,
|
||||
last_error_at = CASE WHEN %(e)s = '' THEN perf_ad_source_status.last_error_at ELSE now() END
|
||||
"""
|
||||
else:
|
||||
sql = """
|
||||
INSERT INTO perf_ad_source_status (channel_code, status, last_test_at, last_test_ok, last_error, last_error_at)
|
||||
VALUES (%(c)s, %(s)s, now(), %(ok)s, %(e)s, CASE WHEN %(e)s = '' THEN NULL ELSE now() END)
|
||||
ON CONFLICT (channel_code) DO UPDATE
|
||||
SET status = EXCLUDED.status, last_test_at = now(), last_test_ok = %(ok)s,
|
||||
last_error = CASE WHEN %(e)s = '' THEN perf_ad_source_status.last_error ELSE %(e)s END,
|
||||
last_error_at = CASE WHEN %(e)s = '' THEN perf_ad_source_status.last_error_at ELSE now() END
|
||||
"""
|
||||
try:
|
||||
with self._pool.connection() as conn:
|
||||
conn.execute(sql, {"c": code, "s": status, "ok": ok, "e": error})
|
||||
except pg_errors.UndefinedTable:
|
||||
return # 007 미적용 — 상태 기록만 못 함(가져오기 자체는 막지 않음)
|
||||
|
||||
def replace_ad_api_range(self, code: str, start: date, end: date,
|
||||
days: list[tuple[date, int, Any, dict[str, Any] | None]], *, user: str = "") -> int:
|
||||
"""광고 API 로 가져온 기간을 한 트랜잭션으로 반영 — days 의 날은 덮어쓰고(source='api', ROAS·보고서 항목 포함,
|
||||
직접 입력·업로드 값이 있던 날도 API 값으로), 기간 안에서 API 가 돌려주지 않은 날은 **예전 API 값만** 지운다
|
||||
(직접 입력·업로드 값은 그대로). days = [(날짜, 금액, ROAS, 항목)]. 반영한 날 수."""
|
||||
from .ad_spend import AdMigrationNeeded # noqa: WPS433
|
||||
|
||||
keep = {d for d, _, _, _ in days}
|
||||
try:
|
||||
with self._pool.connection() as conn:
|
||||
with conn.transaction():
|
||||
with conn.cursor() as cur:
|
||||
old = cur.execute(
|
||||
"SELECT spend_date FROM perf_ad_spend WHERE channel_code = %s AND source = 'api' "
|
||||
"AND spend_date BETWEEN %s AND %s", (code, start, end),
|
||||
).fetchall()
|
||||
gone = [(code, r["spend_date"]) for r in old if r["spend_date"] not in keep]
|
||||
if gone:
|
||||
cur.executemany("DELETE FROM perf_ad_spend WHERE channel_code = %s AND spend_date = %s "
|
||||
"AND source = 'api'", gone)
|
||||
rows = [(code, d, int(a), "api", user, r, Jsonb(m) if m is not None else None) for d, a, r, m in days]
|
||||
if rows:
|
||||
cur.executemany(
|
||||
"INSERT INTO perf_ad_spend (channel_code, spend_date, amount, source, updated_by, roas, metrics) "
|
||||
"VALUES (%s, %s, %s, %s, %s, %s, %s) ON CONFLICT (channel_code, spend_date) DO UPDATE "
|
||||
"SET amount = EXCLUDED.amount, source = EXCLUDED.source, updated_by = EXCLUDED.updated_by, "
|
||||
"roas = EXCLUDED.roas, metrics = EXCLUDED.metrics",
|
||||
rows,
|
||||
)
|
||||
except pg_errors.UndefinedTable:
|
||||
raise AdMigrationNeeded("005") from None
|
||||
except pg_errors.UndefinedColumn:
|
||||
raise AdMigrationNeeded("006") from None
|
||||
return len(days)
|
||||
|
||||
|
||||
class AdCredentialTable:
|
||||
"""광고 API 인증정보 표(perf_ad_credentials)를 쇼핑몰 인증정보 저장소와 같은 이름으로 — credentials.CredentialService 가
|
||||
그대로 쓴다(저장·요약·재암호화). 채널 코드가 쇼핑몰 코드 자리에 들어간다."""
|
||||
|
||||
def __init__(self, store: Any) -> None:
|
||||
self._store = store
|
||||
|
||||
def credential_rows(self, code: str) -> dict[str, dict[str, Any]]:
|
||||
return self._store.ad_credential_rows(code)
|
||||
|
||||
def credential_keys_by_code(self) -> dict[str, set[str]]:
|
||||
return self._store.ad_credential_keys_by_code()
|
||||
|
||||
def upsert_credential(self, code: str, key: str, *, encrypted_value: str, key_version: int, user: str = "") -> None:
|
||||
self._store.upsert_ad_credential(code, key, encrypted_value=encrypted_value, key_version=key_version, user=user)
|
||||
|
||||
def delete_credential(self, code: str, key: str) -> None:
|
||||
self._store.delete_ad_credential(code, key)
|
||||
|
||||
def all_credential_rows(self) -> list[dict[str, Any]]:
|
||||
return self._store.all_ad_credential_rows()
|
||||
@@ -0,0 +1,239 @@
|
||||
"""매출 업데이트 진행 상황 — 백그라운드 수집 작업(쇼핑몰별 진행 막대)을 메모리에 둔다.
|
||||
|
||||
- [매출 업데이트]·[과거 매출 가져오기]는 수집을 백그라운드 스레드로 돌리고 작업 번호를 바로 돌려준다.
|
||||
화면은 GET /performance/api/sync/jobs/{id} 를 0.8초마다 불러 쇼핑몰별·전체 진행 막대를 그린다.
|
||||
- 어댑터가 ctx.progress.plan()/step() 으로 알린 단계를 ShopProgress 가 모은다(쇼핑몰마다 단위가 다르다 —
|
||||
네이버 "일", 11번가·카페24 "구간").
|
||||
- 웹 프로세스 하나(uvicorn 단일 워커) 기준 — 워커를 여러 개로 늘리면 진행 상황을 DB 로 옮겨야 한다.
|
||||
서버를 다시 켜면 진행 중 작업 정보는 사라진다(수집 결과는 DB 에 이미 저장된 만큼 남음).
|
||||
- [업데이트 취소]: SyncJob.cancel() → 각 쇼핑몰이 다음 API 호출 직전(ShopProgress.check)에 Cancelled 로 멈춘다.
|
||||
수집 중에 멈춘 쇼핑몰은 DB 에 아무것도 쓰지 않는다(저장은 수집이 끝난 뒤 한 트랜잭션). 저장 중이면 그 저장은 끝낸다.
|
||||
아직 차례가 안 온 쇼핑몰은 "취소됨"으로 건너뛴다.
|
||||
- 쇼핑몰별 [중지]: SyncJob.stop_shop(code) → 그 쇼핑몰만 같은 방식(다음 API 호출 직전, 저장 안 함)으로 멈추고 "중지됨",
|
||||
업데이트는 다음 쇼핑몰로 넘어간다. 차례가 안 온 쇼핑몰을 미리 중지하면 차례가 왔을 때 건너뛴다. 저장 중이면 못 멈춘다.
|
||||
"""
|
||||
|
||||
from __future__ import annotations
|
||||
|
||||
import threading
|
||||
import time
|
||||
import uuid
|
||||
from datetime import date
|
||||
from typing import Any
|
||||
|
||||
from .adapters.base import Cancelled, Progress
|
||||
|
||||
MAX_JOBS = 20
|
||||
_LOCK = threading.Lock()
|
||||
_JOBS: dict[str, "SyncJob"] = {}
|
||||
|
||||
# 끝났지만 막대에서 빼는 쇼핑몰(수집할 수 없어 바로 끝난 것) — 전체 진행률 계산에서 제외
|
||||
PASSIVE_STATUS = frozenset({"not_implemented", "not_configured"})
|
||||
|
||||
|
||||
class ShopProgress(Progress):
|
||||
"""쇼핑몰 하나의 진행 상황. state: waiting → running → saving → done | error | skipped | cancelled."""
|
||||
|
||||
def __init__(self, code: str, name: str, *, active: bool = True, job: "SyncJob | None" = None) -> None:
|
||||
self.code, self.name, self.active, self.job = code, name, active, job
|
||||
self.state = "waiting"
|
||||
self.done = self.total = self.items = self.upserted = 0
|
||||
self.unit = "단계"
|
||||
self.status = self.label = self.message = ""
|
||||
self.started_at = self.finished_at = 0.0
|
||||
self.stop_requested = False # 쇼핑몰별 [중지] — 이 쇼핑몰만 멈추고 다음 쇼핑몰로
|
||||
self._lock = threading.Lock()
|
||||
|
||||
def stop(self) -> bool:
|
||||
"""[중지] — 대기·수집 중일 때만(저장 중·끝난 뒤엔 못 멈춤). 받아들였으면 True."""
|
||||
with self._lock:
|
||||
if self.state not in ("waiting", "running"):
|
||||
return False
|
||||
self.stop_requested = True
|
||||
return True
|
||||
|
||||
# ── 어댑터가 부르는 쪽(Progress) ──
|
||||
def plan(self, total: int, unit: str = "단계") -> None:
|
||||
with self._lock:
|
||||
self.total, self.unit, self.done = max(0, int(total)), unit or "단계", 0
|
||||
|
||||
def add(self, n: int) -> None:
|
||||
with self._lock:
|
||||
self.total += max(0, int(n))
|
||||
|
||||
def check(self) -> None:
|
||||
if self.cancel_requested and self.state == "running":
|
||||
raise Cancelled("사용자가 이 쇼핑몰 업데이트를 중지했습니다." if self.stopped_only else
|
||||
"사용자가 업데이트를 취소했습니다.")
|
||||
|
||||
@property
|
||||
def cancel_requested(self) -> bool:
|
||||
"""멈춰야 하나 — 업데이트 전체 취소 또는 이 쇼핑몰만 중지."""
|
||||
return self.stop_requested or bool(self.job is not None and self.job.cancel_requested)
|
||||
|
||||
@property
|
||||
def stopped_only(self) -> bool:
|
||||
"""이 쇼핑몰만 중지(전체 취소가 아님) — 업데이트는 다음 쇼핑몰로 계속된다."""
|
||||
return self.stop_requested and not (self.job is not None and self.job.cancel_requested)
|
||||
|
||||
def step(self, n: int = 1, *, items: int = 0) -> None:
|
||||
self.check()
|
||||
with self._lock:
|
||||
self.done += max(0, int(n))
|
||||
self.items += max(0, int(items))
|
||||
if self.total and self.done > self.total: # 계획보다 많이 돌면 전체를 늘려 100% 를 넘지 않게
|
||||
self.total = self.done
|
||||
|
||||
# ── sync 가 부르는 쪽 ──
|
||||
def start(self) -> None:
|
||||
with self._lock:
|
||||
self.state, self.started_at = "running", time.time()
|
||||
|
||||
def saving(self) -> None:
|
||||
with self._lock:
|
||||
self.state = "saving"
|
||||
|
||||
def begin_saving(self) -> None:
|
||||
"""수집이 끝나 저장으로 넘어간다 — 중지·취소 확인과 running → saving 전환을 **같은 잠금 안에서** 한다.
|
||||
stop() 도 같은 잠금으로 state 를 보고 받아들이므로, [중지]가 이 전환보다 먼저면 여기서 Cancelled(저장 안 함),
|
||||
나중이면 stop() 이 False(저장 중이라 중지 불가)를 돌려준다 — 둘 다 받아들여지는 틈이 없다(2026-10-15 검토 F06).
|
||||
마지막 API 호출 중이나 collect() 정리 중에 받아들인 [중지]도 여기서 반영된다."""
|
||||
with self._lock:
|
||||
if self.cancel_requested:
|
||||
raise Cancelled("사용자가 이 쇼핑몰 업데이트를 중지했습니다." if self.stopped_only else
|
||||
"사용자가 업데이트를 취소했습니다.")
|
||||
self.state = "saving"
|
||||
|
||||
def finish(self, *, upserted: int, message: str = "") -> None:
|
||||
with self._lock:
|
||||
self.state, self.upserted, self.message, self.status = "done", int(upserted), message, "ok"
|
||||
if self.total:
|
||||
self.done = self.total
|
||||
self.finished_at = time.time()
|
||||
|
||||
def fail(self, *, status: str, label: str, message: str) -> None:
|
||||
with self._lock:
|
||||
self.state, self.status, self.label, self.message = "error", status, label, message
|
||||
if status in PASSIVE_STATUS:
|
||||
self.active = False
|
||||
self.finished_at = time.time()
|
||||
|
||||
def cancelled(self) -> None:
|
||||
with self._lock:
|
||||
self.state, self.status = "cancelled", "cancelled"
|
||||
self.message = "중지됨" if self.stopped_only else "취소됨"
|
||||
self.finished_at = time.time()
|
||||
|
||||
def skip(self, message: str) -> None:
|
||||
with self._lock:
|
||||
self.state, self.status, self.message = "skipped", "running", message
|
||||
self.finished_at = time.time()
|
||||
|
||||
@property
|
||||
def finished(self) -> bool:
|
||||
return self.state in ("done", "error", "skipped", "cancelled")
|
||||
|
||||
def fraction(self) -> float:
|
||||
if self.finished:
|
||||
return 1.0
|
||||
if self.state == "saving":
|
||||
return 0.98
|
||||
if self.state == "running" and self.total:
|
||||
return min(0.97, self.done / self.total)
|
||||
return 0.0
|
||||
|
||||
def snapshot(self) -> dict[str, Any]:
|
||||
with self._lock:
|
||||
return {
|
||||
"code": self.code, "name": self.name, "active": self.active, "state": self.state,
|
||||
"done": self.done, "total": self.total, "unit": self.unit, "items": self.items,
|
||||
"upserted": self.upserted, "status": self.status, "label": self.label, "message": self.message,
|
||||
"stop_requested": self.stop_requested, "fraction": round(self.fraction(), 4),
|
||||
"elapsed": round((self.finished_at or time.time()) - self.started_at, 1) if self.started_at else 0,
|
||||
}
|
||||
|
||||
|
||||
class SyncJob:
|
||||
def __init__(self, *, user: str, start: date | None, end: date | None) -> None:
|
||||
self.id = uuid.uuid4().hex[:12]
|
||||
self.user, self.start, self.end = user, start, end
|
||||
self.created_at = time.time()
|
||||
self.finished_at = 0.0
|
||||
self.shops: list[ShopProgress] = []
|
||||
self.error = ""
|
||||
self.last_update_at: str | None = None
|
||||
self.cancel_requested = False
|
||||
self.cancelled_by = ""
|
||||
self._lock = threading.Lock()
|
||||
|
||||
def set_targets(self, targets: list[tuple[str, str, bool]], start: date, end: date) -> dict[str, ShopProgress]:
|
||||
with self._lock:
|
||||
self.start, self.end = start, end
|
||||
self.shops = [ShopProgress(code, name, active=active, job=self) for code, name, active in targets]
|
||||
return {s.code: s for s in self.shops}
|
||||
|
||||
def cancel(self, user: str = "") -> None:
|
||||
"""[업데이트 취소] — 돌고 있는 쇼핑몰은 다음 API 호출 직전에, 기다리는 쇼핑몰은 차례가 오면 멈춘다."""
|
||||
with self._lock:
|
||||
if not self.finished_at and not self.cancel_requested:
|
||||
self.cancel_requested, self.cancelled_by = True, user
|
||||
|
||||
def stop_shop(self, code: str) -> bool:
|
||||
"""쇼핑몰별 [중지] — 그 쇼핑몰만 멈추고 다음 쇼핑몰로. 끝난 작업·없는 쇼핑몰·저장 중·끝난 쇼핑몰은 False."""
|
||||
with self._lock:
|
||||
if self.finished_at:
|
||||
return False
|
||||
shop = next((s for s in self.shops if s.code == code), None)
|
||||
return bool(shop is not None and shop.stop())
|
||||
|
||||
def finish(self, *, error: str = "", last_update_at: str | None = None) -> None:
|
||||
with self._lock:
|
||||
self.error, self.last_update_at, self.finished_at = error, last_update_at, time.time()
|
||||
|
||||
@property
|
||||
def finished(self) -> bool:
|
||||
return bool(self.finished_at)
|
||||
|
||||
def snapshot(self) -> dict[str, Any]:
|
||||
with self._lock:
|
||||
shops = [s.snapshot() for s in self.shops]
|
||||
active = [s for s in shops if s["active"]]
|
||||
return {
|
||||
"id": self.id, "finished": self.finished, "error": self.error, "user": self.user,
|
||||
"cancel_requested": self.cancel_requested,
|
||||
"from": self.start.isoformat() if self.start else None, "to": self.end.isoformat() if self.end else None,
|
||||
"elapsed": round((self.finished_at or time.time()) - self.created_at, 1),
|
||||
"last_update_at": self.last_update_at, "shops": shops,
|
||||
"overall": {
|
||||
"shops": len(active),
|
||||
"finished": sum(1 for s in active if s["state"] in ("done", "error", "skipped", "cancelled")),
|
||||
"fraction": round(sum(s["fraction"] for s in active) / len(active), 4) if active else
|
||||
(1.0 if self.finished else 0.0),
|
||||
"items": sum(s["items"] for s in shops), "upserted": sum(s["upserted"] for s in shops),
|
||||
},
|
||||
}
|
||||
|
||||
|
||||
def create_job(*, user: str, start: date | None, end: date | None) -> SyncJob:
|
||||
job = SyncJob(user=user, start=start, end=end)
|
||||
with _LOCK:
|
||||
_JOBS[job.id] = job
|
||||
if len(_JOBS) > MAX_JOBS: # 오래된 끝난 작업부터 정리
|
||||
for jid, j in sorted(_JOBS.items(), key=lambda kv: kv[1].created_at):
|
||||
if len(_JOBS) <= MAX_JOBS:
|
||||
break
|
||||
if j.finished:
|
||||
del _JOBS[jid]
|
||||
return job
|
||||
|
||||
|
||||
def get_job(job_id: str) -> SyncJob | None:
|
||||
with _LOCK:
|
||||
return _JOBS.get(job_id)
|
||||
|
||||
|
||||
def running_job() -> SyncJob | None:
|
||||
"""지금 돌고 있는 작업(가장 최근). 없으면 None — 다른 사람이 누른 업데이트도 같이 보여 주려고."""
|
||||
with _LOCK:
|
||||
live = [j for j in _JOBS.values() if not j.finished]
|
||||
return max(live, key=lambda j: j.created_at) if live else None
|
||||
@@ -0,0 +1,203 @@
|
||||
"""수동 입력 매출 엑셀 업로드 — 1열 날짜, 2열부터 쇼핑몰 이름 머리글(샘플: upload_sample.xlsx).
|
||||
|
||||
규칙
|
||||
- 머리글(1행) 2열부터 = 쇼핑몰 이름. 설정의 이름·짧은 이름(네이버/토스)·코드 어느 것이든 되고 띄어쓰기·대소문자는 무시.
|
||||
- 수동 입력이 켜진 쇼핑몰 열만 반영. 꺼진 쇼핑몰·모르는 이름 열은 건너뛰고 알려 준다.
|
||||
- 값이 있는 칸만 반영(빈 칸은 그날 기존 값 그대로 — 지우지 않음). 0 은 값(0원)으로 저장.
|
||||
- 날짜: 엑셀 날짜, 2026-10-12 · 2026.10.12 · 2026/10/12 · 20261012(뒤 요일 표기 무시). 앞으로의 날짜는 안 됨.
|
||||
- 금액: 원 단위 정수(쉼표·"원" 허용, 소수는 반올림).
|
||||
- 잘못된 칸이 하나라도 있으면 아무것도 저장하지 않고 오류 목록을 돌려준다(일부만 들어가 헷갈리지 않게).
|
||||
|
||||
HTTP·DB 와 무관한 순수 함수 — 라우터가 파일 바이트와 쇼핑몰 목록을 넘긴다.
|
||||
"""
|
||||
|
||||
from __future__ import annotations
|
||||
|
||||
import io
|
||||
import re
|
||||
from dataclasses import dataclass, field
|
||||
from datetime import date, datetime, timedelta
|
||||
from decimal import ROUND_HALF_UP, Decimal, InvalidOperation
|
||||
from typing import Any, Iterable, Mapping
|
||||
|
||||
MAX_FILE_BYTES = 5 * 1024 * 1024
|
||||
MAX_DATA_ROWS = 2000
|
||||
MAX_ERRORS = 30
|
||||
MAX_AMOUNT = 10 ** 12 # 라우터 MAX_MANUAL_AMOUNT 와 같은 상한(원)
|
||||
|
||||
_EXCEL_EPOCH = date(1899, 12, 30)
|
||||
_DATE_RE = re.compile(r"^(\d{4})\s*[-./년]\s*(\d{1,2})\s*[-./월]\s*(\d{1,2})")
|
||||
_COMPACT_RE = re.compile(r"^(\d{4})(\d{2})(\d{2})(?!\d)")
|
||||
|
||||
|
||||
class UploadError(ValueError):
|
||||
"""파일 자체를 읽을 수 없음(형식·크기·머리글)."""
|
||||
|
||||
|
||||
@dataclass
|
||||
class ParseResult:
|
||||
entries: list[tuple[str, date, int]] = field(default_factory=list) # (쇼핑몰 코드, 날짜, 금액)
|
||||
errors: list[str] = field(default_factory=list)
|
||||
ignored: list[str] = field(default_factory=list) # 건너뛴 열(머리글 + 이유)
|
||||
columns: list[str] = field(default_factory=list) # 반영 대상 쇼핑몰 코드(열 순서)
|
||||
|
||||
|
||||
def _norm(text: Any) -> str:
|
||||
return re.sub(r"\s+", "", str(text or "")).lower()
|
||||
|
||||
|
||||
def _cell_ref(row: int, col: int) -> str:
|
||||
letters = ""
|
||||
n = col
|
||||
while n:
|
||||
n, r = divmod(n - 1, 26)
|
||||
letters = chr(65 + r) + letters
|
||||
return f"{letters}{row}"
|
||||
|
||||
|
||||
def parse_date(value: Any) -> date | None:
|
||||
"""날짜 칸 → date. 읽을 수 없으면 ValueError, 빈 칸이면 None."""
|
||||
if value is None or (isinstance(value, str) and not value.strip()):
|
||||
return None
|
||||
if isinstance(value, datetime):
|
||||
return value.date()
|
||||
if isinstance(value, date):
|
||||
return value
|
||||
if isinstance(value, (int, float)) and not isinstance(value, bool):
|
||||
n = int(value)
|
||||
if 19000101 <= n <= 29991231: # 20261012
|
||||
return parse_date(str(n))
|
||||
if 20000 <= n <= 80000: # 엑셀 날짜 일련번호(서식 없는 날짜)
|
||||
return _EXCEL_EPOCH + timedelta(days=n)
|
||||
raise ValueError
|
||||
text = str(value).strip()
|
||||
m = _DATE_RE.match(text) or _COMPACT_RE.match(text)
|
||||
if not m:
|
||||
raise ValueError
|
||||
return date(int(m.group(1)), int(m.group(2)), int(m.group(3)))
|
||||
|
||||
|
||||
def parse_amount(value: Any) -> int | None:
|
||||
"""금액 칸 → 원 단위 정수. 빈 칸이면 None, 숫자가 아니면 ValueError."""
|
||||
if value is None or isinstance(value, bool):
|
||||
if value is None:
|
||||
return None
|
||||
raise ValueError
|
||||
if isinstance(value, (int, float, Decimal)):
|
||||
num = Decimal(str(value))
|
||||
else:
|
||||
text = re.sub(r"[,\s원₩]", "", str(value))
|
||||
if text == "":
|
||||
return None
|
||||
try:
|
||||
num = Decimal(text)
|
||||
except InvalidOperation:
|
||||
raise ValueError from None
|
||||
if not num.is_finite():
|
||||
raise ValueError
|
||||
return int(num.quantize(Decimal("1"), rounding=ROUND_HALF_UP))
|
||||
|
||||
|
||||
def header_aliases(markets: Iterable[Mapping[str, Any]], extra_names: Mapping[str, Iterable[str]] | None = None) -> dict[str, str]:
|
||||
"""머리글로 쓸 수 있는 이름 → 쇼핑몰 코드. markets: code·name, extra_names: 코드별 다른 이름(어댑터 이름·짧은 이름)."""
|
||||
out: dict[str, str] = {}
|
||||
for m in markets:
|
||||
code = str(m["code"])
|
||||
for alias in (code, m.get("name"), *((extra_names or {}).get(code) or ())):
|
||||
key = _norm(alias)
|
||||
if key:
|
||||
out.setdefault(key, code)
|
||||
return out
|
||||
|
||||
|
||||
def parse_workbook(content: bytes, *, markets: list[Mapping[str, Any]], today: date,
|
||||
extra_names: Mapping[str, Iterable[str]] | None = None) -> ParseResult:
|
||||
"""첫 시트를 읽어 (코드, 날짜, 금액) 목록을 만든다. markets: code·name·manual_input(설정 순서)."""
|
||||
if not content:
|
||||
raise UploadError("빈 파일입니다.")
|
||||
if len(content) > MAX_FILE_BYTES:
|
||||
raise UploadError("파일이 너무 큽니다(5MB 이하).")
|
||||
try:
|
||||
import openpyxl # noqa: WPS433
|
||||
|
||||
wb = openpyxl.load_workbook(io.BytesIO(content), read_only=True, data_only=True)
|
||||
except Exception: # noqa: BLE001 — 형식이 다르면 어떤 오류든 같은 안내
|
||||
raise UploadError("엑셀(.xlsx) 파일을 읽을 수 없습니다. 샘플 파일 양식으로 저장해 올려 주세요.") from None
|
||||
try:
|
||||
ws = wb.worksheets[0]
|
||||
rows = ws.iter_rows(values_only=True)
|
||||
header = next(rows, None)
|
||||
if not header or len(header) < 2:
|
||||
raise UploadError("1행에 날짜와 쇼핑몰 이름 머리글이 없습니다.")
|
||||
|
||||
aliases = header_aliases(markets, extra_names)
|
||||
by_code = {str(m["code"]): m for m in markets}
|
||||
res = ParseResult()
|
||||
col_code: dict[int, str] = {} # 열 번호(0부터) → 반영할 쇼핑몰 코드
|
||||
for idx, title in enumerate(header[1:], start=1):
|
||||
if title is None or not str(title).strip():
|
||||
continue
|
||||
label = str(title).strip()
|
||||
code = aliases.get(_norm(label))
|
||||
if code is None:
|
||||
res.ignored.append(f"{label}(알 수 없는 쇼핑몰)")
|
||||
elif not by_code[code].get("manual_input"):
|
||||
res.ignored.append(f"{label}(수동 입력 꺼짐)")
|
||||
elif code in col_code.values():
|
||||
res.errors.append(f"{_cell_ref(1, idx + 1)} {label}: 같은 쇼핑몰 열이 두 번 있습니다.")
|
||||
else:
|
||||
col_code[idx] = code
|
||||
res.columns.append(code)
|
||||
if not col_code and not res.errors:
|
||||
raise UploadError("반영할 쇼핑몰 열이 없습니다. 머리글을 수동 입력이 켜진 쇼핑몰 이름으로 적어 주세요."
|
||||
+ (f" (건너뛴 열: {', '.join(res.ignored)})" if res.ignored else ""))
|
||||
|
||||
seen: dict[tuple[str, date], str] = {}
|
||||
data_rows = 0
|
||||
for r, row in enumerate(rows, start=2):
|
||||
row = tuple(row or ())
|
||||
cells = {i: (row[i] if i < len(row) else None) for i in col_code}
|
||||
amounts: dict[int, int] = {}
|
||||
for i, raw in cells.items():
|
||||
try:
|
||||
amt = parse_amount(raw)
|
||||
except ValueError:
|
||||
res.errors.append(f"{_cell_ref(r, i + 1)}: 금액이 숫자가 아닙니다({raw}).")
|
||||
continue
|
||||
if amt is None:
|
||||
continue
|
||||
if abs(amt) > MAX_AMOUNT:
|
||||
res.errors.append(f"{_cell_ref(r, i + 1)}: 금액이 너무 큽니다.")
|
||||
continue
|
||||
amounts[i] = amt
|
||||
raw_day = row[0] if row else None
|
||||
try:
|
||||
day = parse_date(raw_day)
|
||||
except ValueError:
|
||||
res.errors.append(f"{_cell_ref(r, 1)}: 날짜를 읽을 수 없습니다({raw_day}).")
|
||||
continue
|
||||
if day is None:
|
||||
if amounts:
|
||||
res.errors.append(f"{r}행: 날짜가 비어 있습니다.")
|
||||
continue
|
||||
if not amounts:
|
||||
continue
|
||||
data_rows += 1
|
||||
if data_rows > MAX_DATA_ROWS:
|
||||
raise UploadError(f"한 번에 {MAX_DATA_ROWS:,}일까지 올릴 수 있습니다.")
|
||||
if day > today:
|
||||
res.errors.append(f"{_cell_ref(r, 1)}: 앞으로의 날짜({day.isoformat()})는 입력할 수 없습니다.")
|
||||
continue
|
||||
for i, amt in amounts.items():
|
||||
code = col_code[i]
|
||||
where = _cell_ref(r, i + 1)
|
||||
if (code, day) in seen:
|
||||
res.errors.append(f"{where}: {by_code[code]['name']} {day.isoformat()} 이 {seen[(code, day)]} 와 겹칩니다.")
|
||||
continue
|
||||
seen[(code, day)] = where
|
||||
res.entries.append((code, day, amt))
|
||||
if len(res.errors) > MAX_ERRORS:
|
||||
break
|
||||
return res
|
||||
finally:
|
||||
wb.close()
|
||||
@@ -0,0 +1,837 @@
|
||||
"""실적 모듈 라우터 (prefix=/performance).
|
||||
|
||||
화면
|
||||
GET /performance/ 대시보드(모듈 권한)
|
||||
GET /performance/ads 광고비(모듈 권한) — 구글·메타·쿠팡(윙)·쿠팡(로켓) 연·월·일
|
||||
GET /performance/settings 실적 설정(관리자)
|
||||
JSON API — 모듈 권한
|
||||
POST /performance/api/sync 매출 업데이트(사용 중인 쇼핑몰 전부, 쇼핑몰별 실패 격리)
|
||||
background=true 면 백그라운드로 돌리고 작업 번호를 바로 돌려줌
|
||||
GET /performance/api/sync/jobs/{id} 매출 업데이트 진행 상황(쇼핑몰별·전체 진행 막대)
|
||||
GET /performance/api/sync/current 지금 돌고 있는 업데이트(없으면 null)
|
||||
POST /performance/api/sync/jobs/{id}/cancel 업데이트 취소(시작한 사람 또는 관리자)
|
||||
GET /performance/api/events 금액 클릭 상세(쇼핑몰+기간)
|
||||
PUT /performance/api/manual-sales/{code}/{day} 수동 입력 매출 저장/지움(그 쇼핑몰 수동 입력이 켜져 있을 때, 오늘까지)
|
||||
GET /performance/api/manual-sales/sample.xlsx 수동 입력 엑셀 업로드 샘플(모듈 폴더 upload_sample.xlsx)
|
||||
POST /performance/api/manual-sales/upload 수동 입력 엑셀 업로드(1열 날짜, 2열부터 쇼핑몰 이름 머리글)
|
||||
PUT /performance/api/ad-spend/{channel}/{day} 광고비 한 칸 저장/지움(오늘까지)
|
||||
POST /performance/api/ad-spend/upload?channel= 광고비 파일 업로드(쿠팡 윙·로켓 광고 보고서 1열 날짜·19열 청구금액,
|
||||
네이버 광고 보고서 3열 기간·4열 총비용·12열 ROAS + 나머지 항목)
|
||||
GET /performance/api/ad-spend/{channel}/details?from=&to= 일자별 보고서 항목(네이버·구글 머리글 클릭)
|
||||
POST /performance/api/ad-sources/{code}/sync 광고 API(구글 광고) 가져오기 — 보는 기간(오늘까지), 92일 넘으면 관리자
|
||||
JSON API — 관리자
|
||||
GET|PUT /performance/api/ad-sources/{code}/credentials 광고 API 인증정보(마이그레이션 007, 암호화 저장·비밀 원문 없음)
|
||||
POST /performance/api/ad-sources/{code}/test 광고 API 연결 테스트(저장값 또는 새 입력값)
|
||||
PUT /performance/api/marketplaces/{code} 사용/매출 집계/수동 입력 여부
|
||||
POST /performance/api/marketplaces/{code}/rates 수수료율(적용 시작일)
|
||||
DELETE /performance/api/marketplaces/{code}/rates/{id}
|
||||
GET /performance/api/marketplaces/{code}/credentials 입력칸 + 저장 여부(비밀 원문 없음)
|
||||
GET /performance/api/marketplaces/{code}/daily-check 일별 매출 비교(저장값 + 지금 API 값)
|
||||
PUT /performance/api/marketplaces/{code}/credentials 저장(암호화)
|
||||
POST /performance/api/marketplaces/{code}/test 연결 테스트(저장값 또는 새 입력값)
|
||||
POST /performance/api/sample-data 테스트 데이터 생성/삭제
|
||||
POST /performance/api/rekey 마스터 키 교체 후 재암호화
|
||||
|
||||
핸들러는 동기 DB 라 `def` 로 둔다(FastAPI 가 스레드풀에서 실행).
|
||||
"""
|
||||
|
||||
from __future__ import annotations
|
||||
|
||||
from datetime import date, timedelta
|
||||
from decimal import Decimal, InvalidOperation
|
||||
from pathlib import Path
|
||||
from typing import Any
|
||||
|
||||
from fastapi import APIRouter, Body, File, Form, HTTPException, Query, Request, UploadFile
|
||||
from fastapi.responses import FileResponse, HTMLResponse, JSONResponse
|
||||
|
||||
from app.timezone import today_kst
|
||||
|
||||
from . import common
|
||||
from .adapters.registry import all_adapters, get_adapter
|
||||
|
||||
router = APIRouter(prefix="/performance", tags=["performance"])
|
||||
|
||||
MAX_EVENT_DAYS = 31
|
||||
MAX_CHECK_DAYS = 62 # 쇼핑몰 화면 일별 비교(카페24 일별 매출내역 붙여넣기)
|
||||
MAX_BACKFILL_DAYS = 366
|
||||
MAX_USER_SYNC_DAYS = 92 # 관리자가 아니어도 가져올 수 있는 기간(이번달·직접선택 짧은 기간)
|
||||
MAX_MANUAL_AMOUNT = 10 ** 12 # 수동 입력 한 칸 상한(원)
|
||||
MANUAL_SAMPLE_PATH = Path(__file__).resolve().parent / "upload_sample.xlsx"
|
||||
AD_MIGRATION_HELP = ("광고비를 쓰려면 performance_db 마이그레이션 005(scripts/sql/performance_db_005_ad_spend.sql)를 "
|
||||
"먼저 적용해야 합니다.")
|
||||
AD_MIGRATION_HELP_006 = ("광고 보고서 ROAS·상세 항목을 쓰려면 performance_db 마이그레이션 006"
|
||||
"(scripts/sql/performance_db_006_ad_roas_metrics.sql)을 먼저 적용해야 합니다.")
|
||||
AD_MIGRATION_HELP_007 = ("광고 API 연동(구글 광고) 인증정보를 저장하려면 performance_db 마이그레이션 007"
|
||||
"(scripts/sql/performance_db_007_ad_api.sql)을 먼저 적용해야 합니다.")
|
||||
|
||||
|
||||
def _ad_migration_help(exc: Exception) -> str:
|
||||
text = str(exc)
|
||||
return AD_MIGRATION_HELP_007 if "007" in text else AD_MIGRATION_HELP_006 if "006" in text else AD_MIGRATION_HELP
|
||||
MANUAL_MIGRATION_HELP = ("수동 입력을 쓰려면 performance_db 마이그레이션 002(scripts/sql/performance_db_002_manual_sales.sql)를 "
|
||||
"먼저 적용해야 합니다.")
|
||||
|
||||
|
||||
def _parse_date(value: Any, *, field: str = "날짜") -> date | None:
|
||||
if value in (None, ""):
|
||||
return None
|
||||
try:
|
||||
return date.fromisoformat(str(value)[:10])
|
||||
except ValueError:
|
||||
raise HTTPException(status_code=400, detail=f"{field} 형식이 올바르지 않습니다(YYYY-MM-DD).") from None
|
||||
|
||||
|
||||
def _holidays() -> dict[str, str]:
|
||||
try:
|
||||
from app.modules.project.store import KR_HOLIDAYS # noqa: WPS433 — 공휴일 표 공유(읽기 전용)
|
||||
|
||||
return dict(KR_HOLIDAYS)
|
||||
except Exception: # noqa: BLE001
|
||||
return {}
|
||||
|
||||
|
||||
def _code_or_404(store: Any, code: str):
|
||||
adapter = get_adapter(code)
|
||||
if adapter is None or code not in {m["code"] for m in store.list_marketplaces()}:
|
||||
raise HTTPException(status_code=404, detail="알 수 없는 쇼핑몰입니다.")
|
||||
return adapter
|
||||
|
||||
|
||||
@router.get("/health")
|
||||
def health(request: Request) -> JSONResponse:
|
||||
st = common.get_store(request)
|
||||
return JSONResponse({"ok": st is not None, "module": "performance",
|
||||
"encryption_key": common.key_status()["ok"]})
|
||||
|
||||
|
||||
# ════════════════════════════════════════════════════════════
|
||||
# 화면
|
||||
# ════════════════════════════════════════════════════════════
|
||||
@router.get("/", response_class=HTMLResponse)
|
||||
def dashboard_page(
|
||||
request: Request,
|
||||
period: str = "week",
|
||||
d: str | None = None,
|
||||
from_: str | None = Query(None, alias="from"),
|
||||
to: str | None = None,
|
||||
m: list[str] = Query(default=[]),
|
||||
metric: str = "gross",
|
||||
):
|
||||
from app.main import render_template # noqa: WPS433
|
||||
|
||||
g = common.guard(request)
|
||||
if not isinstance(g, tuple):
|
||||
return g
|
||||
store, user = g
|
||||
from .dashboard import build_dashboard # noqa: WPS433
|
||||
|
||||
today = today_kst()
|
||||
anchor = _parse_date(d) or today
|
||||
creds, _ = common.services(request, store)
|
||||
ctx = build_dashboard(
|
||||
store, kind=period, anchor=anchor, today=today,
|
||||
custom_from=_parse_date(from_), custom_to=_parse_date(to), selected=m,
|
||||
holidays=_holidays(), configured=creds.configured_codes(list(all_adapters())),
|
||||
)
|
||||
ctx["metric"] = metric if metric in ("gross", "commission", "net") else "gross"
|
||||
return render_template(request, "performance/index.html", {**common.base_ctx(user, active_tab="dashboard"), **ctx})
|
||||
|
||||
|
||||
@router.get("/ads", response_class=HTMLResponse)
|
||||
def ads_page(
|
||||
request: Request,
|
||||
period: str = "month",
|
||||
d: str | None = None,
|
||||
from_: str | None = Query(None, alias="from"),
|
||||
to: str | None = None,
|
||||
):
|
||||
from app.main import render_template # noqa: WPS433
|
||||
|
||||
g = common.guard(request)
|
||||
if not isinstance(g, tuple):
|
||||
return g
|
||||
store, user = g
|
||||
from .ad_spend import build_ad_dashboard # noqa: WPS433
|
||||
from .dashboard import _sales_marketplaces # noqa: WPS433
|
||||
|
||||
today = today_kst()
|
||||
ctx = build_ad_dashboard(
|
||||
store, kind=period, anchor=_parse_date(d) or today, today=today,
|
||||
custom_from=_parse_date(from_), custom_to=_parse_date(to), holidays=_holidays(),
|
||||
sales_codes=[m["code"] for m in _sales_marketplaces(store)],
|
||||
)
|
||||
# [구글 광고 불러오기] — 관리자가 실적 설정에서 인증정보를 넣은 광고 연동만
|
||||
from .ad_sources.registry import get_source # noqa: WPS433
|
||||
|
||||
_, ad_sync = _ad_services(store)
|
||||
ctx["ad_sync_sources"] = [{"code": c, "name": get_source(c).name} for c, ok in ad_sync.configured().items() if ok]
|
||||
return render_template(request, "performance/ads.html",
|
||||
{**common.base_ctx(user, active_tab="ads", page_title="광고비"), **ctx})
|
||||
|
||||
|
||||
@router.get("/settings", response_class=HTMLResponse)
|
||||
def settings_page(request: Request):
|
||||
from app.main import render_template # noqa: WPS433
|
||||
|
||||
# 모듈 권한자 누구나 들어온다 — 일반 사용자는 수수료율만(쇼핑몰 표의 다른 칸·다른 카드는 템플릿이 관리자에게만 그린다).
|
||||
g = common.guard(request)
|
||||
if not isinstance(g, tuple):
|
||||
return g
|
||||
store, user = g
|
||||
from .dashboard import build_settings # noqa: WPS433
|
||||
|
||||
creds, _ = common.services(request, store)
|
||||
ad_creds, ad_sync = _ad_services(store)
|
||||
versions = creds.key_versions_in_use()
|
||||
for v, n in ad_creds.key_versions_in_use().items(): # 광고 API 인증정보도 같은 마스터 키
|
||||
versions[v] = versions.get(v, 0) + n
|
||||
ctx = build_settings(
|
||||
store, configured=creds.configured_codes(list(all_adapters())), key_info=common.key_status(),
|
||||
key_versions_in_use=versions, sample_count=store.sample_count(),
|
||||
)
|
||||
ctx["ad_sources"] = _ad_source_rows(store, ad_sync.configured())
|
||||
ctx["ad_api_ready"] = store.ad_api_ready()
|
||||
return render_template(request, "performance/settings.html",
|
||||
{**common.base_ctx(user, active_tab="settings", page_title="실적 설정"), **ctx})
|
||||
|
||||
|
||||
def _ad_source_rows(store: Any, configured: dict[str, bool]) -> list[dict[str, Any]]:
|
||||
"""실적 설정 "광고 API 연동" 표 — 연동마다 설정 여부·연결 상태·마지막 가져오기."""
|
||||
from .ad_sources.registry import all_sources # noqa: WPS433
|
||||
from .adapters.base import STATUS_LABELS # noqa: WPS433
|
||||
|
||||
statuses = store.ad_source_statuses()
|
||||
rows = []
|
||||
for s in all_sources():
|
||||
st = statuses.get(s.code, {})
|
||||
status = st.get("status") or ("unknown" if configured.get(s.code) else "not_configured")
|
||||
rows.append({"code": s.code, "name": s.name, "configured": bool(configured.get(s.code)), "status": status,
|
||||
"status_label": STATUS_LABELS.get(status, status), "last_test_at": st.get("last_test_at"),
|
||||
"last_error": st.get("last_error") or "", "last_error_at": st.get("last_error_at"),
|
||||
"last_sync_at": st.get("last_sync_at"), "last_success_sync_at": st.get("last_success_sync_at")})
|
||||
return rows
|
||||
|
||||
|
||||
# ════════════════════════════════════════════════════════════
|
||||
# JSON API — 모듈 권한
|
||||
# ════════════════════════════════════════════════════════════
|
||||
@router.post("/api/sync")
|
||||
def api_sync(request: Request, payload: dict[str, Any] = Body(default={})) -> JSONResponse:
|
||||
"""from/to 가 없으면 최근 N일(PERFORMANCE_SYNC_DAYS). 기간 지정은 대시보드 [매출 업데이트](보고 있는 기간)와
|
||||
설정 [과거 매출 가져오기]가 쓴다 — 모듈 권한자는 92일까지, 그보다 길면(최대 366일) 관리자만."""
|
||||
store, user = common.require_store(request)
|
||||
_, sync = common.services(request, store)
|
||||
codes = [str(c) for c in (payload.get("codes") or []) if get_adapter(str(c))]
|
||||
start = _parse_date(payload.get("from"), field="시작일")
|
||||
end = _parse_date(payload.get("to"), field="종료일")
|
||||
if start or end:
|
||||
from app.store import is_admin # noqa: WPS433
|
||||
|
||||
end = end or today_kst()
|
||||
start = start or end
|
||||
if end < start:
|
||||
start, end = end, start
|
||||
if end > today_kst():
|
||||
end = today_kst()
|
||||
if start > end:
|
||||
raise HTTPException(status_code=400, detail="앞으로의 기간은 가져올 수 없습니다.")
|
||||
days = (end - start).days + 1
|
||||
if days > MAX_BACKFILL_DAYS:
|
||||
raise HTTPException(status_code=400, detail=f"한 번에 {MAX_BACKFILL_DAYS}일까지 가져올 수 있습니다.")
|
||||
if days > MAX_USER_SYNC_DAYS and not is_admin(user):
|
||||
raise HTTPException(status_code=403,
|
||||
detail=f"{MAX_USER_SYNC_DAYS}일보다 긴 기간은 관리자만 가져올 수 있습니다.")
|
||||
if payload.get("background"):
|
||||
return JSONResponse(_start_background_sync(store, sync, start=start, end=end, codes=codes or None,
|
||||
user=user["email"]))
|
||||
results = sync.sync_all(start=start, end=end, codes=codes or None, user=user["email"])
|
||||
return JSONResponse({"results": results, "last_update_at": store.last_update_at()})
|
||||
|
||||
|
||||
def _start_background_sync(store: Any, sync: Any, *, start: date | None, end: date | None,
|
||||
codes: list[str] | None, user: str) -> dict[str, Any]:
|
||||
"""수집을 스레드로 돌리고 작업 번호를 바로 돌려준다. 이미 돌고 있는 업데이트가 있으면 새로 시작하지 않고
|
||||
그 작업을 보여 준다(같은 쇼핑몰 동시 실행은 어차피 막혀 있다)."""
|
||||
import logging # noqa: WPS433
|
||||
import threading # noqa: WPS433
|
||||
|
||||
from . import jobs # noqa: WPS433
|
||||
|
||||
live = jobs.running_job()
|
||||
if live is not None:
|
||||
return {"job": live.snapshot(), "joined": True}
|
||||
job = jobs.create_job(user=user, start=start, end=end)
|
||||
|
||||
def run() -> None:
|
||||
error = ""
|
||||
try:
|
||||
sync.sync_all(start=start, end=end, codes=codes, user=user, job=job)
|
||||
except Exception as exc: # noqa: BLE001 — 스레드 밖으로 새지 않게, 화면에는 "오류"로
|
||||
logging.getLogger("performance.sync").exception("background 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)
|
||||
|
||||
threading.Thread(target=run, name=f"perf-sync-{job.id}", daemon=True).start()
|
||||
return {"job": job.snapshot(), "joined": False}
|
||||
|
||||
|
||||
@router.get("/api/sync/jobs/{job_id}")
|
||||
def api_sync_job(request: Request, job_id: str) -> JSONResponse:
|
||||
common.require_store(request)
|
||||
from . import jobs # noqa: WPS433
|
||||
|
||||
job = jobs.get_job(job_id)
|
||||
if job is None:
|
||||
raise HTTPException(status_code=404, detail="진행 상황을 찾을 수 없습니다(서버가 다시 시작됐을 수 있습니다).")
|
||||
return JSONResponse({"job": job.snapshot()})
|
||||
|
||||
|
||||
@router.post("/api/sync/jobs/{job_id}/cancel")
|
||||
def api_sync_cancel(request: Request, job_id: str) -> JSONResponse:
|
||||
"""[업데이트 취소] — 시작한 사람 또는 관리자. 돌고 있는 쇼핑몰은 다음 API 호출 직전에 멈추고(저장 전이면 DB 그대로),
|
||||
기다리는 쇼핑몰은 건너뛴다. 이미 저장이 끝난 쇼핑몰 결과는 그대로 남는다."""
|
||||
from app.store import is_admin # noqa: WPS433
|
||||
|
||||
from . import jobs # noqa: WPS433
|
||||
|
||||
_, user = common.require_store(request)
|
||||
job = jobs.get_job(job_id)
|
||||
if job is None:
|
||||
raise HTTPException(status_code=404, detail="진행 상황을 찾을 수 없습니다(서버가 다시 시작됐을 수 있습니다).")
|
||||
if job.user and job.user != user["email"] and not is_admin(user):
|
||||
raise HTTPException(status_code=403, detail="업데이트를 시작한 사람이나 관리자만 취소할 수 있습니다.")
|
||||
job.cancel(user["email"])
|
||||
return JSONResponse({"job": job.snapshot()})
|
||||
|
||||
|
||||
@router.post("/api/sync/jobs/{job_id}/shops/{code}/stop")
|
||||
def api_sync_stop_shop(request: Request, job_id: str, code: str) -> JSONResponse:
|
||||
"""쇼핑몰별 [중지] — 시작한 사람 또는 관리자. 그 쇼핑몰만 다음 API 호출 직전에 멈추고(저장 안 함, 기존 매출 그대로)
|
||||
업데이트는 다음 쇼핑몰로 넘어간다. 차례가 안 온 쇼핑몰은 차례가 오면 건너뛴다. 저장 중·끝난 쇼핑몰은 409."""
|
||||
from app.store import is_admin # noqa: WPS433
|
||||
|
||||
from . import jobs # noqa: WPS433
|
||||
|
||||
_, user = common.require_store(request)
|
||||
job = jobs.get_job(job_id)
|
||||
if job is None:
|
||||
raise HTTPException(status_code=404, detail="진행 상황을 찾을 수 없습니다(서버가 다시 시작됐을 수 있습니다).")
|
||||
if job.user and job.user != user["email"] and not is_admin(user):
|
||||
raise HTTPException(status_code=403, detail="업데이트를 시작한 사람이나 관리자만 중지할 수 있습니다.")
|
||||
if not job.stop_shop(code):
|
||||
raise HTTPException(status_code=409, detail="이미 끝났거나 저장 중인 쇼핑몰은 중지할 수 없습니다.")
|
||||
return JSONResponse({"job": job.snapshot()})
|
||||
|
||||
|
||||
@router.get("/api/sync/current")
|
||||
def api_sync_current(request: Request) -> JSONResponse:
|
||||
common.require_store(request)
|
||||
from . import jobs # noqa: WPS433
|
||||
|
||||
job = jobs.running_job()
|
||||
return JSONResponse({"job": job.snapshot() if job else None})
|
||||
|
||||
|
||||
@router.get("/api/events")
|
||||
def api_events(request: Request, code: str, from_: str = Query(..., alias="from"), to: str | None = None) -> JSONResponse:
|
||||
store, _ = common.require_store(request)
|
||||
_code_or_404(store, code)
|
||||
start = _parse_date(from_)
|
||||
end = _parse_date(to) or start
|
||||
if end < start:
|
||||
start, end = end, start
|
||||
if (end - start).days + 1 > MAX_EVENT_DAYS:
|
||||
raise HTTPException(status_code=400, detail=f"상세 조회는 {MAX_EVENT_DAYS}일 이내만 가능합니다.")
|
||||
rows = store.list_events(code, start, end)
|
||||
return JSONResponse({"rows": rows, "truncated": len(rows) >= 500})
|
||||
|
||||
|
||||
@router.put("/api/manual-sales/{code}/{day}")
|
||||
def api_manual_sale(request: Request, code: str, day: str, payload: dict[str, Any] = Body(...)) -> JSONResponse:
|
||||
"""수동 입력 — 그 쇼핑몰 수동 입력이 켜져 있을 때만, 오늘까지. amount 가 비면 지움(그날은 다시 API 값)."""
|
||||
from .db import ManualMigrationNeeded # noqa: WPS433
|
||||
|
||||
store, user = common.require_store(request) # 모듈 권한자 누구나(켜고 끄기는 관리자 설정)
|
||||
_code_or_404(store, code)
|
||||
d = _parse_date(day)
|
||||
if d > today_kst():
|
||||
raise HTTPException(status_code=400, detail="앞으로의 날짜는 입력할 수 없습니다.")
|
||||
m = next((x for x in store.list_marketplaces() if x["code"] == code), {})
|
||||
if not m.get("manual_input"):
|
||||
raise HTTPException(status_code=400, detail="이 쇼핑몰은 수동 입력을 쓰지 않습니다(실적 설정에서 켜세요).")
|
||||
raw = payload.get("amount")
|
||||
amount: int | None
|
||||
if raw in (None, ""):
|
||||
amount = None
|
||||
else:
|
||||
try:
|
||||
amount = int(Decimal(str(raw).replace(",", "").strip()))
|
||||
except (InvalidOperation, ValueError):
|
||||
raise HTTPException(status_code=400, detail="금액은 숫자(원)로 입력하세요.") from None
|
||||
if abs(amount) > MAX_MANUAL_AMOUNT:
|
||||
raise HTTPException(status_code=400, detail="금액이 너무 큽니다.")
|
||||
try:
|
||||
store.set_manual_sale(code, d, amount, user=user.get("email", ""))
|
||||
except ManualMigrationNeeded:
|
||||
raise HTTPException(status_code=503, detail=MANUAL_MIGRATION_HELP) from None
|
||||
api_amount = store.api_amount(code, d)
|
||||
return JSONResponse({"ok": True, "code": code, "date": d.isoformat(), "manual": amount,
|
||||
"amount": api_amount if amount is None else amount, "api_amount": api_amount})
|
||||
|
||||
|
||||
@router.get("/api/manual-sales/sample.xlsx")
|
||||
def api_manual_sample(request: Request) -> Any:
|
||||
common.require_store(request)
|
||||
if not MANUAL_SAMPLE_PATH.is_file():
|
||||
raise HTTPException(status_code=404, detail="샘플 파일이 없습니다.")
|
||||
return FileResponse(MANUAL_SAMPLE_PATH, filename="upload_sample.xlsx",
|
||||
media_type="application/vnd.openxmlformats-officedocument.spreadsheetml.sheet")
|
||||
|
||||
|
||||
@router.post("/api/manual-sales/upload")
|
||||
def api_manual_upload(request: Request, file: UploadFile = File(...)) -> JSONResponse:
|
||||
"""수동 입력 엑셀 업로드 — 값이 있는 칸만 반영(덮어씀). 잘못된 칸이 있으면 아무것도 저장하지 않는다."""
|
||||
from . import manual_upload # noqa: WPS433
|
||||
from .dashboard import _short_name # noqa: WPS433
|
||||
from .db import ManualMigrationNeeded # noqa: WPS433
|
||||
|
||||
store, user = common.require_store(request) # 날짜 칸 수동 입력과 같은 권한(모듈 권한자 누구나)
|
||||
content = file.file.read(manual_upload.MAX_FILE_BYTES + 1)
|
||||
known = {a.code: a for a in all_adapters()}
|
||||
markets = [m for m in store.list_marketplaces() if m["code"] in known and m["enabled"]]
|
||||
extra = {m["code"]: (known[m["code"]].name, _short_name(m["name"])) for m in markets}
|
||||
try:
|
||||
res = manual_upload.parse_workbook(content, markets=markets, today=today_kst(), extra_names=extra)
|
||||
except manual_upload.UploadError as exc:
|
||||
raise HTTPException(status_code=400, detail=str(exc)) from None
|
||||
names = {m["code"]: m["name"] for m in markets}
|
||||
if res.errors:
|
||||
return JSONResponse(status_code=400, content={
|
||||
"detail": f"잘못된 칸이 {len(res.errors)}개{'+' if len(res.errors) > manual_upload.MAX_ERRORS else ''} 있어 "
|
||||
"아무것도 저장하지 않았습니다. 고친 뒤 다시 올려 주세요.",
|
||||
"errors": res.errors[:manual_upload.MAX_ERRORS], "ignored": res.ignored})
|
||||
try:
|
||||
saved = store.set_manual_sales_bulk(res.entries, user=user.get("email", ""))
|
||||
except ManualMigrationNeeded:
|
||||
raise HTTPException(status_code=503, detail=MANUAL_MIGRATION_HELP) from None
|
||||
counts: dict[str, int] = {}
|
||||
for code, _, _ in res.entries:
|
||||
counts[code] = counts.get(code, 0) + 1
|
||||
days = sorted({d for _, d, _ in res.entries})
|
||||
return JSONResponse({
|
||||
"ok": True, "saved": saved,
|
||||
"by_shop": [{"code": c, "name": names.get(c, c), "count": counts[c]} for c in res.columns if counts.get(c)],
|
||||
"from": days[0].isoformat() if days else None, "to": days[-1].isoformat() if days else None,
|
||||
"ignored": res.ignored,
|
||||
})
|
||||
|
||||
|
||||
# ════════════════════════════════════════════════════════════
|
||||
# JSON API — 광고비(모듈 권한자 누구나)
|
||||
# ════════════════════════════════════════════════════════════
|
||||
def _ad_channel(channel: str) -> str:
|
||||
from .ad_spend import CHANNEL_NAMES # noqa: WPS433
|
||||
|
||||
if channel not in CHANNEL_NAMES:
|
||||
raise HTTPException(status_code=404, detail="알 수 없는 광고 채널입니다.")
|
||||
return channel
|
||||
|
||||
|
||||
@router.put("/api/ad-spend/{channel}/{day}")
|
||||
def api_ad_spend(request: Request, channel: str, day: str, payload: dict[str, Any] = Body(...)) -> JSONResponse:
|
||||
from .ad_spend import AdMigrationNeeded # noqa: WPS433
|
||||
|
||||
store, user = common.require_store(request)
|
||||
_ad_channel(channel)
|
||||
d = _parse_date(day)
|
||||
if d is None:
|
||||
raise HTTPException(status_code=400, detail="날짜가 필요합니다.")
|
||||
if d > today_kst():
|
||||
raise HTTPException(status_code=400, detail="앞으로의 날짜는 입력할 수 없습니다.")
|
||||
raw = payload.get("amount")
|
||||
amount: int | None
|
||||
if raw in (None, ""):
|
||||
amount = None
|
||||
else:
|
||||
try:
|
||||
amount = int(Decimal(str(raw).replace(",", "").strip()))
|
||||
except (InvalidOperation, ValueError):
|
||||
raise HTTPException(status_code=400, detail="금액은 숫자(원)로 입력하세요.") from None
|
||||
if abs(amount) > MAX_MANUAL_AMOUNT:
|
||||
raise HTTPException(status_code=400, detail="금액이 너무 큽니다.")
|
||||
try:
|
||||
store.set_ad_spend(channel, d, amount, source="manual", user=user.get("email", ""))
|
||||
except AdMigrationNeeded as exc:
|
||||
raise HTTPException(status_code=503, detail=_ad_migration_help(exc)) from None
|
||||
return JSONResponse({"ok": True, "channel": channel, "date": d.isoformat(), "manual": amount,
|
||||
"amount": amount or 0})
|
||||
|
||||
|
||||
@router.get("/api/ad-spend/{channel}/details")
|
||||
def api_ad_spend_details(request: Request, channel: str, from_: str = Query(..., alias="from"), to: str = Query(...)) -> JSONResponse:
|
||||
"""일자별 보고서 항목(네이버 — 노출수·클릭수·전환수 …) + 광고비·ROAS. 최대 366일."""
|
||||
from . import ad_spend # noqa: WPS433
|
||||
|
||||
store, _ = common.require_store(request)
|
||||
_ad_channel(channel)
|
||||
if channel not in ad_spend.DETAIL_CHANNELS:
|
||||
raise HTTPException(status_code=400, detail="이 채널은 일자별 상세 자료가 없습니다.")
|
||||
start, end = _parse_date(from_, field="시작일"), _parse_date(to, field="종료일")
|
||||
if start is None or end is None or end < start or (end - start).days > 365:
|
||||
raise HTTPException(status_code=400, detail="기간을 확인하세요(최대 366일).")
|
||||
try:
|
||||
rows = store.ad_details(channel, start, end)
|
||||
except ad_spend.AdMigrationNeeded as exc:
|
||||
raise HTTPException(status_code=503, detail=_ad_migration_help(exc)) from None
|
||||
return JSONResponse({"channel": channel, "name": ad_spend.CHANNEL_NAMES[channel], "from": start.isoformat(),
|
||||
"to": end.isoformat(), **ad_spend.detail_table(rows)})
|
||||
|
||||
|
||||
@router.post("/api/ad-spend/upload")
|
||||
def api_ad_spend_upload(
|
||||
request: Request,
|
||||
channel: str = Query(...),
|
||||
files: list[UploadFile] | None = File(None),
|
||||
file: UploadFile | None = File(None),
|
||||
modified: list[str] = Form(default=[]),
|
||||
) -> JSONResponse:
|
||||
"""광고비 파일 업로드(여러 파일 가능, 2026-10-14) — 파일에 있는 날만 덮어쓴다. 같은 날짜가 여러 파일에 있으면
|
||||
파일 날짜(브라우저가 보낸 수정 시각 modified, 파일 순서대로 ms)가 최신인 파일 값. 잘못된 줄이 하나라도 있으면 아무것도 저장하지 않는다."""
|
||||
from . import ad_spend # noqa: WPS433
|
||||
from .manual_upload import MAX_FILE_BYTES, UploadError # noqa: WPS433
|
||||
|
||||
store, user = common.require_store(request)
|
||||
_ad_channel(channel)
|
||||
parser = ad_spend.PARSERS.get(channel)
|
||||
if parser is None:
|
||||
raise HTTPException(status_code=400, detail=f"{ad_spend.CHANNEL_NAMES[channel]} 업로드 양식은 아직 정해지지 않았습니다.")
|
||||
uploads = list(files or []) + ([file] if file is not None else [])
|
||||
if not uploads:
|
||||
raise HTTPException(status_code=400, detail="파일을 고르세요.")
|
||||
if len(uploads) > ad_spend.MAX_UPLOAD_FILES:
|
||||
raise HTTPException(status_code=400, detail=f"한 번에 {ad_spend.MAX_UPLOAD_FILES}개 파일까지 올릴 수 있습니다.")
|
||||
parsed = []
|
||||
for i, up in enumerate(uploads):
|
||||
name = up.filename or f"파일{i + 1}"
|
||||
try:
|
||||
mtime = float(modified[i]) if i < len(modified) and str(modified[i]).strip() else 0.0
|
||||
except ValueError:
|
||||
mtime = 0.0
|
||||
try:
|
||||
parsed.append((name, mtime, parser(up.file.read(MAX_FILE_BYTES + 1), today=today_kst(), filename=name)))
|
||||
except UploadError as exc:
|
||||
raise HTTPException(status_code=400, detail=(f"[{name}] " if len(uploads) > 1 else "") + str(exc)) from None
|
||||
res, overlap = ad_spend.merge_results(parsed)
|
||||
if res.errors:
|
||||
return JSONResponse(status_code=400, content={
|
||||
"detail": f"잘못된 줄이 {len(res.errors)}개 있어 아무것도 저장하지 않았습니다. 고친 뒤 다시 올려 주세요.",
|
||||
"errors": res.errors[:60]})
|
||||
report = {"roas": res.roas, "metrics": res.metrics} if (res.roas or res.metrics) else {}
|
||||
try:
|
||||
saved = store.set_ad_spend_bulk(channel, list(res.entries), source="upload", user=user.get("email", ""), **report)
|
||||
except ad_spend.AdMigrationNeeded as exc:
|
||||
raise HTTPException(status_code=503, detail=_ad_migration_help(exc)) from None
|
||||
days = sorted(d for d, _ in res.entries)
|
||||
return JSONResponse({"ok": True, "saved": saved, "channel": channel, "name": ad_spend.CHANNEL_NAMES[channel],
|
||||
"total": sum(a for _, a in res.entries), "skipped": res.skipped, "files": len(uploads),
|
||||
"overlap_days": len(overlap), "empty_days": [d.isoformat() for d in res.empty_days[:62]],
|
||||
"from": days[0].isoformat() if days else None, "to": days[-1].isoformat() if days else None})
|
||||
|
||||
|
||||
# ════════════════════════════════════════════════════════════
|
||||
# JSON API — 광고 API 연동(구글 광고). 인증정보·연결 테스트는 관리자, 가져오기는 모듈 권한자(92일 넘으면 관리자)
|
||||
# ════════════════════════════════════════════════════════════
|
||||
def _ad_services(store: Any):
|
||||
"""(광고 인증정보 서비스, 광고 가져오기 서비스)."""
|
||||
from .ad_sync import AdSyncService, ad_credentials # noqa: WPS433
|
||||
|
||||
creds = ad_credentials(store, common.key_ring)
|
||||
return creds, AdSyncService(store, creds)
|
||||
|
||||
|
||||
def _ad_source_or_404(code: str):
|
||||
from .ad_sources.registry import get_source # noqa: WPS433
|
||||
|
||||
src = get_source(code)
|
||||
if src is None:
|
||||
raise HTTPException(status_code=404, detail="알 수 없는 광고 연동입니다.")
|
||||
return src
|
||||
|
||||
|
||||
@router.get("/api/ad-sources/{code}/credentials")
|
||||
def api_ad_source_credentials(request: Request, code: str) -> JSONResponse:
|
||||
"""입력칸 + 저장 여부만(비밀 원문 없음) — 쇼핑몰 API 설정 창과 같은 모양."""
|
||||
store, _ = common.require_store(request, admin=True)
|
||||
src = _ad_source_or_404(code)
|
||||
creds, _ = _ad_services(store)
|
||||
info = creds.describe(src)
|
||||
if not store.ad_api_ready():
|
||||
info["decrypt_error"] = AD_MIGRATION_HELP_007
|
||||
return JSONResponse({"code": code, "name": src.name, "shared": False, "note": src.note, "docs_url": src.docs_url,
|
||||
"key": common.key_status(), **info})
|
||||
|
||||
|
||||
@router.put("/api/ad-sources/{code}/credentials")
|
||||
def api_ad_source_save(request: Request, code: str, payload: dict[str, Any] = Body(...)) -> JSONResponse:
|
||||
from .ad_spend import AdMigrationNeeded # noqa: WPS433
|
||||
|
||||
store, user = common.require_store(request, admin=True)
|
||||
src = _ad_source_or_404(code)
|
||||
if not common.key_status()["ok"]:
|
||||
raise HTTPException(status_code=503, detail=common.key_status()["message"])
|
||||
creds, _ = _ad_services(store)
|
||||
values = _clean_values(src, payload)
|
||||
clear = [str(k) for k in (payload.get("clear") or [])]
|
||||
merged = creds.merged_values(src, values)
|
||||
for k in clear:
|
||||
if k in merged and not values.get(k):
|
||||
merged[k] = ""
|
||||
errors = src.validate_credentials(merged)
|
||||
if errors:
|
||||
raise HTTPException(status_code=400, detail=" ".join(errors))
|
||||
try:
|
||||
saved = creds.save(src, values, clear=clear, user=user["email"])
|
||||
except AdMigrationNeeded as exc:
|
||||
raise HTTPException(status_code=503, detail=_ad_migration_help(exc)) from None
|
||||
return JSONResponse({"saved": saved, **creds.describe(src)})
|
||||
|
||||
|
||||
@router.post("/api/ad-sources/{code}/test")
|
||||
def api_ad_source_test(request: Request, code: str, payload: dict[str, Any] = Body(default={})) -> JSONResponse:
|
||||
"""values 가 있으면 저장하지 않은 새 입력값으로 시험(빈 칸은 저장된 값)."""
|
||||
store, user = common.require_store(request, admin=True)
|
||||
src = _ad_source_or_404(code)
|
||||
_, ad_sync = _ad_services(store)
|
||||
values = {k: v for k, v in _clean_values(src, payload).items() if v.strip()}
|
||||
cleared = _cleared_keys(src, payload, values)
|
||||
return JSONResponse(ad_sync.test_connection(code, values=values or None, user=user["email"], cleared=cleared or None))
|
||||
|
||||
|
||||
@router.post("/api/ad-sources/{code}/sync")
|
||||
def api_ad_source_sync(request: Request, code: str, payload: dict[str, Any] = Body(default={})) -> JSONResponse:
|
||||
"""광고비 탭 [구글 광고 불러오기] — 기간(from·to, 없으면 최근 N일)을 가져와 저장. 오늘 뒤는 잘라낸다.
|
||||
모듈 권한자는 92일까지, 그보다 길면(최대 366일) 관리자만."""
|
||||
from app.store import is_admin # noqa: WPS433
|
||||
|
||||
from .ad_spend import AdMigrationNeeded # noqa: WPS433
|
||||
from .ad_sync import AdSyncBusy # noqa: WPS433
|
||||
from .auto_sync import sync_days # noqa: WPS433
|
||||
|
||||
store, user = common.require_store(request)
|
||||
src = _ad_source_or_404(code)
|
||||
today = today_kst()
|
||||
end = _parse_date(payload.get("to"), field="종료일") or today
|
||||
start = _parse_date(payload.get("from"), field="시작일") or (end - timedelta(days=sync_days() - 1))
|
||||
if end < start:
|
||||
start, end = end, start
|
||||
end = min(end, today)
|
||||
if start > end:
|
||||
raise HTTPException(status_code=400, detail="앞으로의 기간은 가져올 수 없습니다.")
|
||||
days = (end - start).days + 1
|
||||
if days > MAX_BACKFILL_DAYS:
|
||||
raise HTTPException(status_code=400, detail=f"한 번에 {MAX_BACKFILL_DAYS}일까지 가져올 수 있습니다.")
|
||||
if days > MAX_USER_SYNC_DAYS and not is_admin(user):
|
||||
raise HTTPException(status_code=403, detail=f"{MAX_USER_SYNC_DAYS}일보다 긴 기간은 관리자만 가져올 수 있습니다.")
|
||||
_, ad_sync = _ad_services(store)
|
||||
if not ad_sync.configured().get(code):
|
||||
raise HTTPException(status_code=400, detail=f"{src.name} API 가 설정되지 않았습니다. 관리자가 실적 설정 → 광고 API 연동에서 입력해야 합니다.")
|
||||
try:
|
||||
res = ad_sync.sync(code, start, end, user=user["email"])
|
||||
except AdSyncBusy as exc:
|
||||
raise HTTPException(status_code=409, detail=str(exc)) from None
|
||||
except AdMigrationNeeded as exc:
|
||||
raise HTTPException(status_code=503, detail=_ad_migration_help(exc)) from None
|
||||
if not res.get("ok"):
|
||||
return JSONResponse(status_code=502, content={"detail": f"{src.name} 가져오기 실패 — {res.get('message')}", **res})
|
||||
return JSONResponse(res)
|
||||
|
||||
|
||||
# ════════════════════════════════════════════════════════════
|
||||
# JSON API — 설정(수수료율은 모듈 권한자 누구나, 나머지는 관리자)
|
||||
# ════════════════════════════════════════════════════════════
|
||||
@router.put("/api/marketplaces/{code}")
|
||||
def api_update_marketplace(request: Request, code: str, payload: dict[str, Any] = Body(...)) -> JSONResponse:
|
||||
store, _ = common.require_store(request, admin=True)
|
||||
_code_or_404(store, code)
|
||||
from .db import ManualMigrationNeeded # noqa: WPS433
|
||||
|
||||
adapter = get_adapter(code)
|
||||
if adapter is not None and adapter.manual_only and payload.get("manual_input") is False:
|
||||
raise HTTPException(status_code=400, detail="수동 입력 전용 쇼핑몰은 수동 입력을 끌 수 없습니다.")
|
||||
|
||||
try:
|
||||
row = store.update_marketplace(
|
||||
code,
|
||||
enabled=bool(payload["enabled"]) if "enabled" in payload else None,
|
||||
include_in_sales=bool(payload["include_in_sales"]) if "include_in_sales" in payload else None,
|
||||
manual_input=bool(payload["manual_input"]) if "manual_input" in payload else None,
|
||||
)
|
||||
except ManualMigrationNeeded:
|
||||
raise HTTPException(status_code=503, detail=MANUAL_MIGRATION_HELP) from None
|
||||
return JSONResponse({"marketplace": row})
|
||||
|
||||
|
||||
@router.post("/api/marketplaces/{code}/rates")
|
||||
def api_set_rate(request: Request, code: str, payload: dict[str, Any] = Body(...)) -> JSONResponse:
|
||||
store, user = common.require_store(request) # 수수료 설정은 모듈 권한자 누구나
|
||||
_code_or_404(store, code)
|
||||
raw = str(payload.get("rate_percent", "")).strip().rstrip("%").strip()
|
||||
try:
|
||||
rate = Decimal(raw)
|
||||
except InvalidOperation:
|
||||
raise HTTPException(status_code=400, detail="수수료율은 숫자로 입력하세요(예: 5, 10.8, 15.35).") from None
|
||||
if not rate.is_finite() or rate < 0 or rate > 100:
|
||||
raise HTTPException(status_code=400, detail="수수료율은 0 ~ 100 사이여야 합니다.")
|
||||
if rate != rate.quantize(Decimal("0.001")):
|
||||
raise HTTPException(status_code=400, detail="수수료율은 소수점 셋째 자리까지 입력할 수 있습니다.")
|
||||
effective_from = _parse_date(payload.get("effective_from"), field="적용 시작일")
|
||||
if effective_from is None:
|
||||
raise HTTPException(status_code=400, detail="적용 시작일을 입력하세요.")
|
||||
store.set_rate(code, rate_percent=rate, effective_from=effective_from,
|
||||
memo=str(payload.get("memo") or "")[:200], user=user["email"])
|
||||
return JSONResponse({"rates": store.list_rates(code)})
|
||||
|
||||
|
||||
@router.get("/api/marketplaces/{code}/rates")
|
||||
def api_list_rates(request: Request, code: str) -> JSONResponse:
|
||||
store, _ = common.require_store(request) # 수수료 설정은 모듈 권한자 누구나
|
||||
_code_or_404(store, code)
|
||||
return JSONResponse({"rates": store.list_rates(code)})
|
||||
|
||||
|
||||
@router.delete("/api/marketplaces/{code}/rates/{rate_id}")
|
||||
def api_delete_rate(request: Request, code: str, rate_id: int) -> JSONResponse:
|
||||
store, _ = common.require_store(request) # 수수료 설정은 모듈 권한자 누구나
|
||||
_code_or_404(store, code)
|
||||
if not store.delete_rate(code, rate_id):
|
||||
raise HTTPException(status_code=404, detail="수수료 이력을 찾지 못했습니다.")
|
||||
return JSONResponse({"rates": store.list_rates(code)})
|
||||
|
||||
|
||||
@router.get("/api/marketplaces/{code}/credentials")
|
||||
def api_get_credentials(request: Request, code: str) -> JSONResponse:
|
||||
"""입력칸 정의 + 저장 여부만. secret 항목의 원문은 보내지 않는다."""
|
||||
store, _ = common.require_store(request, admin=True)
|
||||
adapter = _code_or_404(store, code)
|
||||
creds, _ = common.services(request, store)
|
||||
info = creds.describe(adapter)
|
||||
return JSONResponse({"code": code, "name": adapter.name, "shared": adapter.uses_shared_integration,
|
||||
"note": adapter.note, "docs_url": adapter.docs_url,
|
||||
"key": common.key_status(), **info})
|
||||
|
||||
|
||||
def _clean_values(adapter, payload: dict[str, Any]) -> dict[str, str]:
|
||||
allowed = {f.key for f in adapter.visible_fields()}
|
||||
values = payload.get("values") or {}
|
||||
if not isinstance(values, dict):
|
||||
raise HTTPException(status_code=400, detail="values 형식이 올바르지 않습니다.")
|
||||
return {k: str(v) for k, v in values.items() if k in allowed and v is not None}
|
||||
|
||||
|
||||
@router.put("/api/marketplaces/{code}/credentials")
|
||||
def api_save_credentials(request: Request, code: str, payload: dict[str, Any] = Body(...)) -> JSONResponse:
|
||||
store, user = common.require_store(request, admin=True)
|
||||
adapter = _code_or_404(store, code)
|
||||
if adapter.uses_shared_integration:
|
||||
raise HTTPException(status_code=400, detail=f"{adapter.name}은(는) 공통 연동을 사용해 여기서 입력하지 않습니다.")
|
||||
if not common.key_status()["ok"]:
|
||||
raise HTTPException(status_code=503, detail=common.key_status()["message"])
|
||||
creds, _ = common.services(request, store)
|
||||
values = _clean_values(adapter, payload)
|
||||
clear = [str(k) for k in (payload.get("clear") or [])]
|
||||
merged = creds.merged_values(adapter, values)
|
||||
for k in clear:
|
||||
if k in merged and not values.get(k):
|
||||
merged[k] = ""
|
||||
errors = adapter.validate_credentials(merged)
|
||||
if errors:
|
||||
raise HTTPException(status_code=400, detail=" ".join(errors))
|
||||
saved = creds.save(adapter, values, clear=clear, user=user["email"])
|
||||
return JSONResponse({"saved": saved, **creds.describe(adapter)})
|
||||
|
||||
|
||||
@router.post("/api/marketplaces/{code}/test")
|
||||
def api_test_connection(request: Request, code: str, payload: dict[str, Any] = Body(default={})) -> JSONResponse:
|
||||
"""values 가 있으면 저장하지 않은 새 입력값으로 시험(빈 칸은 저장된 값 사용), clear = 화면에서 비운 항목은 빈 값으로.
|
||||
광고 API 시험(/api/ad-sources/{code}/test)과 같은 요청·응답 계약 — 공통 설정 창이 둘 다 쓴다(검토 F09)."""
|
||||
store, user = common.require_store(request, admin=True)
|
||||
adapter = _code_or_404(store, code)
|
||||
_, sync = common.services(request, store)
|
||||
values = {k: v for k, v in _clean_values(adapter, payload).items() if v.strip()}
|
||||
cleared = _cleared_keys(adapter, payload, values)
|
||||
result = sync.test_connection(code, values=values or None, user=user["email"], cleared=cleared or None)
|
||||
return JSONResponse(result)
|
||||
|
||||
|
||||
def _cleared_keys(source: Any, payload: dict[str, Any], values: dict[str, str]) -> set[str]:
|
||||
"""요청의 clear 중 이 연동의 화면 항목이면서 새 값이 없는 것 — 연결 시험에서 빈 값으로 본다."""
|
||||
allowed = {f.key for f in source.visible_fields()}
|
||||
return {str(k) for k in (payload.get("clear") or []) if str(k) in allowed and str(k) not in values}
|
||||
|
||||
|
||||
@router.get("/api/marketplaces/{code}/reconcile")
|
||||
def api_reconcile(request: Request, code: str, date_: str = Query(..., alias="date"), to: str | None = None) -> JSONResponse:
|
||||
"""쇼핑몰 화면(예: 카페24 일별 매출내역)과 비교용 — 그날 원천 금액 항목별 합계. DB 는 바꾸지 않는다."""
|
||||
store, user = common.require_store(request, admin=True)
|
||||
_code_or_404(store, code)
|
||||
day = _parse_date(date_)
|
||||
_, sync = common.services(request, store)
|
||||
return JSONResponse(sync.reconcile(code, day, to=_parse_date(to, field="종료일"), user=user["email"]))
|
||||
|
||||
|
||||
@router.get("/api/marketplaces/{code}/daily-check")
|
||||
def api_daily_check(request: Request, code: str, from_: str = Query(..., alias="from"), to: str | None = None,
|
||||
live: bool = False) -> JSONResponse:
|
||||
"""쇼핑몰 화면 일별 매출과 날짜별 비교 — 저장값(db) + live=1 이면 지금 API 로 다시 계산한 값(저장 안 함)."""
|
||||
store, user = common.require_store(request, admin=True)
|
||||
_code_or_404(store, code)
|
||||
start = _parse_date(from_)
|
||||
end = _parse_date(to) or start
|
||||
if end < start:
|
||||
start, end = end, start
|
||||
if (end - start).days + 1 > MAX_CHECK_DAYS:
|
||||
raise HTTPException(status_code=400, detail=f"일별 비교는 {MAX_CHECK_DAYS}일 이내만 가능합니다.")
|
||||
_, sync = common.services(request, store)
|
||||
return JSONResponse(sync.daily_check(code, start, end, live=live, user=user["email"]))
|
||||
|
||||
|
||||
@router.post("/api/sample-data")
|
||||
def api_sample_data(request: Request, payload: dict[str, Any] = Body(...)) -> JSONResponse:
|
||||
store, _ = common.require_store(request, admin=True)
|
||||
action = payload.get("action")
|
||||
if action == "delete":
|
||||
return JSONResponse({"deleted": store.delete_sample_events(), "sample_count": store.sample_count()})
|
||||
if action != "generate":
|
||||
raise HTTPException(status_code=400, detail="action 은 generate 또는 delete 입니다.")
|
||||
today = today_kst()
|
||||
start = _parse_date(payload.get("from")) or today.replace(month=1, day=1)
|
||||
end = _parse_date(payload.get("to")) or today
|
||||
if end < start:
|
||||
start, end = end, start
|
||||
if (end - start).days > 400:
|
||||
raise HTTPException(status_code=400, detail="테스트 데이터는 한 번에 400일까지 만들 수 있습니다.")
|
||||
codes = [m["code"] for m in store.list_marketplaces() if m["enabled"]]
|
||||
_, sync = common.services(request, store)
|
||||
n = sync.generate_samples(start, end, codes)
|
||||
return JSONResponse({"generated": n, "sample_count": store.sample_count()})
|
||||
|
||||
|
||||
@router.post("/api/rekey")
|
||||
def api_rekey(request: Request) -> JSONResponse:
|
||||
store, _ = common.require_store(request, admin=True)
|
||||
if not common.key_status()["ok"]:
|
||||
raise HTTPException(status_code=503, detail=common.key_status()["message"])
|
||||
creds, _ = common.services(request, store)
|
||||
ad_creds, _ = _ad_services(store)
|
||||
shop, ad = creds.reencrypt_all(), ad_creds.reencrypt_all() # 광고 API 인증정보도 같은 마스터 키
|
||||
versions = creds.key_versions_in_use()
|
||||
for v, n in ad_creds.key_versions_in_use().items():
|
||||
versions[v] = versions.get(v, 0) + n
|
||||
return JSONResponse({"reencrypted": shop["reencrypted"] + ad["reencrypted"], "failed": shop["failed"] + ad["failed"],
|
||||
"versions_in_use": versions})
|
||||
@@ -0,0 +1 @@
|
||||
"""② API 인증정보 보안 — 암호화(crypto) · 비밀값 가리기(redact)."""
|
||||
@@ -0,0 +1,161 @@
|
||||
"""쇼핑몰 인증정보 암호화 — AES-256-GCM(인증 암호화) + 키 버전.
|
||||
|
||||
- 라이브러리: `cryptography` 의 AESGCM (직접 만든 알고리즘 없음).
|
||||
- 해시가 아니라 **복호화 가능한** 암호화다 — API Secret/Token 은 나중에 원문이 필요하다.
|
||||
- 마스터 키는 DB 에 두지 않는다. 환경변수(.env)에서만 읽는다.
|
||||
|
||||
APP_ENCRYPTION_KEY 현재 키(32바이트). `openssl rand -hex 32` 의 64자 hex
|
||||
또는 32바이트 base64/base64url 둘 다 받는다.
|
||||
APP_ENCRYPTION_KEY_VERSION 현재 키의 버전 번호(기본 1).
|
||||
APP_ENCRYPTION_KEY_V{n} 키 교체 중 남겨 두는 예전 키(버전 n). 재암호화가
|
||||
끝나면 지운다.
|
||||
|
||||
암호문 형식: ``v{버전}:{base64url(nonce 12바이트 + 암호문 + tag 16바이트)}``
|
||||
|
||||
AAD(추가 인증 데이터)로 "어느 쇼핑몰의 어느 항목"인지를 묶는다
|
||||
(예: ``perf:coupang:secret_key``). DB 에서 암호문을 다른 행/칸으로 옮겨 붙이면
|
||||
복호화가 실패한다.
|
||||
"""
|
||||
|
||||
from __future__ import annotations
|
||||
|
||||
import base64
|
||||
import binascii
|
||||
import os
|
||||
import re
|
||||
from dataclasses import dataclass, field
|
||||
from typing import Mapping
|
||||
|
||||
KEY_ENV = "APP_ENCRYPTION_KEY"
|
||||
VERSION_ENV = "APP_ENCRYPTION_KEY_VERSION"
|
||||
_OLD_KEY_RE = re.compile(r"^APP_ENCRYPTION_KEY_V(\d+)$")
|
||||
_TOKEN_RE = re.compile(r"^v(\d+):([A-Za-z0-9_\-]+={0,2})$")
|
||||
_NONCE_LEN = 12
|
||||
|
||||
|
||||
class CryptoConfigError(RuntimeError):
|
||||
"""마스터 키가 없거나 형식이 틀림 — 설정 문제."""
|
||||
|
||||
|
||||
class DecryptError(RuntimeError):
|
||||
"""복호화 실패(키 버전 없음/키 바뀜/손상/다른 칸의 암호문). 원문·키는 메시지에 넣지 않는다."""
|
||||
|
||||
|
||||
def _parse_key(raw: str, *, name: str) -> bytes:
|
||||
value = (raw or "").strip()
|
||||
if not value:
|
||||
raise CryptoConfigError(f"{name} 가 비어 있습니다.")
|
||||
if re.fullmatch(r"[0-9a-fA-F]{64}", value):
|
||||
return bytes.fromhex(value)
|
||||
try:
|
||||
padded = value + "=" * (-len(value) % 4)
|
||||
decoded = base64.urlsafe_b64decode(padded.replace("+", "-").replace("/", "_"))
|
||||
except (binascii.Error, ValueError):
|
||||
decoded = b""
|
||||
if len(decoded) == 32:
|
||||
return decoded
|
||||
raise CryptoConfigError(
|
||||
f"{name} 형식이 올바르지 않습니다. 32바이트 키가 필요합니다 "
|
||||
"(`openssl rand -hex 32` 로 만든 64자 hex 권장)."
|
||||
)
|
||||
|
||||
|
||||
@dataclass(frozen=True)
|
||||
class KeyRing:
|
||||
"""현재 키 + (교체 중이면) 예전 키들. 키 값은 repr 에 나오지 않는다."""
|
||||
|
||||
current_version: int
|
||||
_keys: Mapping[int, bytes] = field(repr=False)
|
||||
|
||||
@classmethod
|
||||
def from_env(cls, environ: Mapping[str, str] | None = None) -> "KeyRing":
|
||||
env = os.environ if environ is None else environ
|
||||
raw_current = (env.get(KEY_ENV) or "").strip()
|
||||
if not raw_current:
|
||||
raise CryptoConfigError(
|
||||
f"{KEY_ENV} 환경변수가 설정되지 않았습니다. "
|
||||
"`openssl rand -hex 32` 로 값을 만들어 .env 에 넣고 컨테이너를 재기동하세요."
|
||||
)
|
||||
try:
|
||||
version = int((env.get(VERSION_ENV) or "1").strip())
|
||||
except ValueError:
|
||||
raise CryptoConfigError(f"{VERSION_ENV} 는 1 이상의 정수여야 합니다.") from None
|
||||
if version < 1:
|
||||
raise CryptoConfigError(f"{VERSION_ENV} 는 1 이상의 정수여야 합니다.")
|
||||
keys: dict[int, bytes] = {}
|
||||
for name, raw in env.items():
|
||||
m = _OLD_KEY_RE.match(name)
|
||||
if m and (raw or "").strip():
|
||||
keys[int(m.group(1))] = _parse_key(raw, name=name)
|
||||
keys[version] = _parse_key(raw_current, name=KEY_ENV)
|
||||
return cls(current_version=version, _keys=keys)
|
||||
|
||||
@property
|
||||
def versions(self) -> list[int]:
|
||||
return sorted(self._keys)
|
||||
|
||||
def key(self, version: int) -> bytes:
|
||||
try:
|
||||
return self._keys[version]
|
||||
except KeyError:
|
||||
raise DecryptError(
|
||||
f"암호화 키 버전 v{version} 이 서버에 없습니다. "
|
||||
f"{KEY_ENV}_V{version} 환경변수를 확인하세요."
|
||||
) from None
|
||||
|
||||
|
||||
def _aesgcm(key: bytes):
|
||||
from cryptography.hazmat.primitives.ciphers.aead import AESGCM # 지연 import
|
||||
|
||||
return AESGCM(key)
|
||||
|
||||
|
||||
def encrypt(plaintext: str, *, aad: str, ring: KeyRing) -> str:
|
||||
"""평문 → ``v{버전}:{...}``. 항상 현재 키로 암호화한다."""
|
||||
if plaintext is None:
|
||||
raise ValueError("암호화할 값이 없습니다.")
|
||||
nonce = os.urandom(_NONCE_LEN)
|
||||
ct = _aesgcm(ring.key(ring.current_version)).encrypt(
|
||||
nonce, plaintext.encode("utf-8"), aad.encode("utf-8")
|
||||
)
|
||||
body = base64.urlsafe_b64encode(nonce + ct).decode("ascii")
|
||||
return f"v{ring.current_version}:{body}"
|
||||
|
||||
|
||||
def key_version_of(token: str) -> int:
|
||||
m = _TOKEN_RE.match(token or "")
|
||||
if not m:
|
||||
raise DecryptError("암호문 형식이 올바르지 않습니다.")
|
||||
return int(m.group(1))
|
||||
|
||||
|
||||
def decrypt(token: str, *, aad: str, ring: KeyRing) -> str:
|
||||
"""``v{버전}:{...}`` → 평문. 실패 원인은 알려 주되 값은 절대 담지 않는다."""
|
||||
m = _TOKEN_RE.match(token or "")
|
||||
if not m:
|
||||
raise DecryptError("암호문 형식이 올바르지 않습니다.")
|
||||
version = int(m.group(1))
|
||||
try:
|
||||
raw = base64.urlsafe_b64decode(m.group(2))
|
||||
except (binascii.Error, ValueError):
|
||||
raise DecryptError("암호문이 손상되었습니다.") from None
|
||||
if len(raw) <= _NONCE_LEN:
|
||||
raise DecryptError("암호문이 손상되었습니다.")
|
||||
from cryptography.exceptions import InvalidTag # 지연 import
|
||||
|
||||
try:
|
||||
pt = _aesgcm(ring.key(version)).decrypt(raw[:_NONCE_LEN], raw[_NONCE_LEN:], aad.encode("utf-8"))
|
||||
except InvalidTag:
|
||||
raise DecryptError(
|
||||
"복호화하지 못했습니다. 마스터 키가 바뀌었거나 값이 손상되었습니다. "
|
||||
"인증정보를 다시 입력해야 할 수 있습니다."
|
||||
) from None
|
||||
return pt.decode("utf-8")
|
||||
|
||||
|
||||
def needs_reencrypt(token: str, ring: KeyRing) -> bool:
|
||||
"""현재 키 버전이 아닌 암호문인가(키 교체 후 재암호화 대상)."""
|
||||
try:
|
||||
return key_version_of(token) != ring.current_version
|
||||
except DecryptError:
|
||||
return False
|
||||
@@ -0,0 +1,95 @@
|
||||
"""비밀값 가리기 — 오류 메시지·로그·원본 데이터(raw_data)에 인증정보가 남지 않게.
|
||||
|
||||
원칙은 "애초에 남기지 않는다"이고, 이 모듈은 그래도 섞여 들어올 수 있는 값을
|
||||
걸러내는 마지막 방어선이다.
|
||||
|
||||
- `redact_text(text, known_secrets)`: 문자열 안의 비밀값을 가린다.
|
||||
· 알고 있는 실제 비밀값(저장된 인증정보 원문)은 어디에 있든 통째로 치환
|
||||
· "Authorization: ...", "Bearer ...", "Basic ...", 쿠키
|
||||
· key=value / "key": "value" 형태에서 key 가 비밀 이름(password, secret, token …)인 값
|
||||
· 길이 제한(기본 300자)
|
||||
- `redact_mapping(obj)`: dict/list 를 깊이 복사하며 비밀 이름 키의 값을 가린다.
|
||||
- `mask(value)`: 꼭 보여야 할 때 앞 4자 + **** + 뒤 4자(짧으면 전부 가림).
|
||||
"""
|
||||
|
||||
from __future__ import annotations
|
||||
|
||||
import re
|
||||
from typing import Any, Iterable
|
||||
|
||||
MASK = "****"
|
||||
|
||||
# 이름만 보고 비밀로 판단하는 키(대소문자 무시, 부분 일치).
|
||||
_SENSITIVE_NAME = re.compile(
|
||||
r"(pass(word|wd)?|pwd|secret|token|api[_\-]?key|access[_\-]?key|private[_\-]?key|"
|
||||
r"authorization|auth[_\-]?header|cookie|session|signature|credential|client[_\-]?secret|"
|
||||
r"refresh|bearer|x[_\-]?api)",
|
||||
re.IGNORECASE,
|
||||
)
|
||||
|
||||
# 헤더 이름 뒤의 "인증 방식 + 값" 한 덩어리(예: Bearer xxx, CEA algorithm=…, signature=…).
|
||||
_AUTH_HEADER = re.compile(
|
||||
r"(?i)\b(authorization|proxy-authorization)[\"']?\s*[:=]\s*[\"']?"
|
||||
r"(?:(?:bearer|basic|digest|cea|hmac\S*)\s+)?[^\s\"',;}\]]+"
|
||||
)
|
||||
_BEARER = re.compile(r"(?i)\b(bearer|basic|cea)\s+[A-Za-z0-9._~+/=\-]{6,}")
|
||||
_COOKIE = re.compile(r"(?i)\b(set-cookie|cookie)\s*[:=]\s*[^\r\n]+")
|
||||
_KV = re.compile(
|
||||
r"""(?ix)
|
||||
(["']?) # 여는 따옴표(선택)
|
||||
([A-Za-z0-9_\-\.]*? # 키 이름
|
||||
(?:pass(?:word|wd)?|pwd|secret|token|api[_\-]?key|access[_\-]?key|
|
||||
private[_\-]?key|signature|credential|client[_\-]?secret|refresh)
|
||||
[A-Za-z0-9_\-\.]*)
|
||||
\1\s*[:=]\s*
|
||||
(["']?)([^"'&\s,;}\]]+)\3
|
||||
"""
|
||||
)
|
||||
|
||||
DEFAULT_MAX_LEN = 300
|
||||
|
||||
|
||||
def is_sensitive_name(name: str) -> bool:
|
||||
return bool(_SENSITIVE_NAME.search(name or ""))
|
||||
|
||||
|
||||
def mask(value: str | None) -> str:
|
||||
v = value or ""
|
||||
if len(v) < 12:
|
||||
return MASK
|
||||
return f"{v[:4]}{MASK}{v[-4:]}"
|
||||
|
||||
|
||||
def redact_text(
|
||||
text: Any,
|
||||
known_secrets: Iterable[str] = (),
|
||||
*,
|
||||
max_len: int = DEFAULT_MAX_LEN,
|
||||
) -> str:
|
||||
s = "" if text is None else str(text)
|
||||
for secret in sorted({x for x in known_secrets if x and len(x) >= 4}, key=len, reverse=True):
|
||||
s = s.replace(secret, MASK)
|
||||
s = _AUTH_HEADER.sub(lambda m: f"{m.group(1)}: {MASK}", s)
|
||||
s = _COOKIE.sub(lambda m: f"{m.group(1)}: {MASK}", s)
|
||||
s = _BEARER.sub(lambda m: f"{m.group(1)} {MASK}", s)
|
||||
s = _KV.sub(lambda m: f"{m.group(1)}{m.group(2)}{m.group(1)}={MASK}", s)
|
||||
if max_len and len(s) > max_len:
|
||||
s = s[:max_len] + "…"
|
||||
return s
|
||||
|
||||
|
||||
def redact_mapping(obj: Any, known_secrets: Iterable[str] = ()) -> Any:
|
||||
secrets = tuple(known_secrets)
|
||||
if isinstance(obj, dict):
|
||||
out: dict[str, Any] = {}
|
||||
for k, v in obj.items():
|
||||
if is_sensitive_name(str(k)):
|
||||
out[k] = MASK
|
||||
else:
|
||||
out[k] = redact_mapping(v, secrets)
|
||||
return out
|
||||
if isinstance(obj, (list, tuple)):
|
||||
return [redact_mapping(v, secrets) for v in obj]
|
||||
if isinstance(obj, str):
|
||||
return redact_text(obj, secrets, max_len=0) if secrets else obj
|
||||
return obj
|
||||
@@ -0,0 +1,242 @@
|
||||
"""① 수집 서비스 — 쇼핑몰 API → 어댑터 → 공통 사건 → DB. 화면(버튼)과 분리된 공통 로직.
|
||||
|
||||
- 버튼(매출 업데이트)·연결 테스트·향후 cron/worker 모두 이 서비스를 부른다.
|
||||
- 같은 쇼핑몰은 동시에 한 번만(perf_sync_runs 의 running 부분 유니크 인덱스).
|
||||
- 쇼핑몰 하나가 실패해도 나머지는 계속한다. 실패한 쇼핑몰만 상태가 오류로 바뀐다.
|
||||
- 오류 문구·원본 데이터는 비밀값을 가린 뒤에만 저장/로그한다.
|
||||
|
||||
매출 기준일(sales_date) — 한 곳에서만 정한다(`sales_date_for`):
|
||||
결제(SALE) = 결제일(payment_date, 없으면 event_date)
|
||||
취소/반품 = 발생일(event_date) — 지난 실적이 나중에 바뀌지 않게
|
||||
"""
|
||||
|
||||
from __future__ import annotations
|
||||
|
||||
import logging
|
||||
import os
|
||||
from dataclasses import asdict
|
||||
from datetime import date, timedelta
|
||||
from typing import Any, Iterable
|
||||
|
||||
from app.timezone import today_kst
|
||||
|
||||
from .adapters.base import STATUS_LABELS, AdapterContext, AdapterError, Cancelled, MarketplaceAdapter, SaleEvent
|
||||
from .adapters.registry import all_adapters, get_adapter
|
||||
from .credentials import CredentialService
|
||||
from .security.crypto import CryptoConfigError, DecryptError
|
||||
from .security.redact import redact_mapping, redact_text
|
||||
|
||||
logger = logging.getLogger("performance.sync")
|
||||
|
||||
DEFAULT_SYNC_DAYS = 7
|
||||
|
||||
|
||||
def sync_days() -> int:
|
||||
try:
|
||||
return max(1, min(90, int(os.getenv("PERFORMANCE_SYNC_DAYS", str(DEFAULT_SYNC_DAYS)))))
|
||||
except ValueError:
|
||||
return DEFAULT_SYNC_DAYS
|
||||
|
||||
|
||||
def sales_date_for(ev: SaleEvent) -> date:
|
||||
if ev.event_type == "SALE":
|
||||
return ev.payment_date or ev.event_date
|
||||
return ev.event_date
|
||||
|
||||
|
||||
def event_row(ev: SaleEvent, known_secrets: Iterable[str] = ()) -> dict[str, Any]:
|
||||
row = asdict(ev)
|
||||
row["sales_date"] = sales_date_for(ev)
|
||||
row["raw"] = redact_mapping(ev.raw or {}, known_secrets)
|
||||
return row
|
||||
|
||||
|
||||
class SyncService:
|
||||
def __init__(self, store: Any, creds: CredentialService, *, app_state: Any = None) -> None:
|
||||
self._store = store
|
||||
self._creds = creds
|
||||
self._app_state = app_state
|
||||
|
||||
def _ctx(self, adapter: MarketplaceAdapter, *, overrides: dict[str, str] | None = None,
|
||||
persist: bool = True, user: str = "", cleared: set[str] | None = None) -> AdapterContext:
|
||||
acc = self._creds.accessor(adapter.code, overrides=overrides, persist=persist, user=user, cleared=cleared)
|
||||
return AdapterContext(code=adapter.code, credentials=acc, app_state=self._app_state)
|
||||
|
||||
@staticmethod
|
||||
def _failure(exc: Exception, ctx: AdapterContext | None) -> tuple[str, str]:
|
||||
known = ctx.credentials.known_secrets() if ctx is not None else []
|
||||
if isinstance(exc, AdapterError):
|
||||
return exc.status, redact_text(exc.message, known)
|
||||
if isinstance(exc, (DecryptError, CryptoConfigError)):
|
||||
return "not_configured", redact_text(str(exc), known)
|
||||
return "api_error", redact_text(f"예상하지 못한 오류: {type(exc).__name__}: {exc}", known)
|
||||
|
||||
# ── 연결 테스트 ─────────────────────────────────────────
|
||||
def test_connection(self, code: str, *, values: dict[str, str] | None = None, user: str = "",
|
||||
cleared: set[str] | None = None) -> dict[str, Any]:
|
||||
"""values 를 주면 저장하지 않은 새 입력값으로, cleared = 화면에서 비운 항목은 저장값 대신 빈 값으로 시험한다.
|
||||
둘 중 하나라도 있으면 저장하지 않은 시험이라 연결 상태·토큰을 저장하지 않는다(광고 API 시험과 같은 계약, 검토 F09)."""
|
||||
adapter = get_adapter(code)
|
||||
if adapter is None:
|
||||
return {"ok": False, "status": "api_error", "message": "알 수 없는 쇼핑몰입니다."}
|
||||
unsaved = bool(values) or bool(cleared)
|
||||
ctx = None
|
||||
try:
|
||||
ctx = self._ctx(adapter, overrides=values, persist=not unsaved, user=user, cleared=cleared)
|
||||
message = adapter.test_connection(ctx)
|
||||
status, ok = "ok", True
|
||||
except Exception as exc: # noqa: BLE001 — 어떤 오류든 상태로 바꿔 화면에 보여 준다
|
||||
status, message = self._failure(exc, ctx)
|
||||
ok = False
|
||||
logger.info("performance test %s: %s %s", code, status, message)
|
||||
if not unsaved:
|
||||
self._store.record_test(code, status=status, ok=ok, error="" if ok else message)
|
||||
return {"ok": ok, "status": status, "label": STATUS_LABELS.get(status, status),
|
||||
"message": message, "unsaved": unsaved}
|
||||
|
||||
# ── 동기화 ──────────────────────────────────────────────
|
||||
def sync_marketplace(self, code: str, start: date, end: date, *, trigger: str = "manual",
|
||||
user: str = "", progress: Any = None) -> dict[str, Any]:
|
||||
"""progress: jobs.ShopProgress(매출 업데이트 창 진행 막대) — 없으면 알리지 않는다."""
|
||||
adapter = get_adapter(code)
|
||||
result: dict[str, Any] = {"code": code, "ok": False, "skipped": False, "fetched": 0, "upserted": 0}
|
||||
if adapter is None:
|
||||
if progress is not None:
|
||||
progress.fail(status="api_error", label=STATUS_LABELS["api_error"], message="알 수 없는 쇼핑몰입니다.")
|
||||
return {**result, "status": "api_error", "message": "알 수 없는 쇼핑몰입니다."}
|
||||
if progress is not None and progress.cancel_requested: # [업데이트 취소]·쇼핑몰 [중지] 뒤 차례가 온 쇼핑몰
|
||||
progress.cancelled()
|
||||
return {**result, "cancelled": True, "status": "cancelled", "message": progress.message}
|
||||
run_id = self._store.start_run(code, trigger=trigger, range_from=start, range_to=end, user=user)
|
||||
if run_id is None:
|
||||
if progress is not None:
|
||||
progress.skip("이미 다른 업데이트가 진행 중입니다.")
|
||||
return {**result, "skipped": True, "status": "running", "message": "이미 업데이트 중입니다."}
|
||||
if progress is not None:
|
||||
progress.start()
|
||||
ctx = None
|
||||
try:
|
||||
ctx = self._ctx(adapter, user=user)
|
||||
if progress is not None:
|
||||
ctx.progress = progress
|
||||
fetched, events = adapter.collect(ctx, start, end)
|
||||
if progress is not None:
|
||||
# 중지 확인과 저장 시작을 한 잠금에서 — collect() 끝 무렵에 받아들인 [중지]면 여기서 Cancelled(저장 안 함)
|
||||
progress.begin_saving()
|
||||
known = ctx.credentials.known_secrets()
|
||||
rows = [event_row(ev, known) for ev in events]
|
||||
# 다른 쇼핑몰 열로 보낸 사건 — 등록된 쇼핑몰이 아니면 이 쇼핑몰 열에 둔다(합계가 빠지지 않게).
|
||||
registered = {m["code"] for m in self._store.list_marketplaces()}
|
||||
for r in rows:
|
||||
if r.get("marketplace_code") not in registered:
|
||||
r["marketplace_code"] = code
|
||||
if adapter.replace_range:
|
||||
# 그 기간을 통째로 다시 받은 쇼핑몰 — 기간 안 예전 행을 지우고 새로 넣는다(한 트랜잭션).
|
||||
rows = [r for r in rows if start <= r["sales_date"] <= end]
|
||||
upserted = self._store.replace_events(code, start, end, rows, id_prefix=adapter.event_prefix)
|
||||
else:
|
||||
upserted = self._store.upsert_events(code, rows)
|
||||
self._store.finish_run(run_id, ok=True, fetched=fetched, upserted=upserted)
|
||||
self._store.record_sync(code, status="ok", ok=True)
|
||||
if progress is not None:
|
||||
progress.finish(upserted=upserted, message=f"{upserted}건 반영")
|
||||
return {**result, "ok": True, "status": "ok", "fetched": fetched, "upserted": upserted,
|
||||
"message": f"{upserted}건 반영"}
|
||||
except Cancelled:
|
||||
# 수집 중 취소·중지 — 아직 아무것도 저장하지 않았다. 연결 상태(오류 표시)는 바꾸지 않는다.
|
||||
# 쇼핑몰 [중지]면 이 쇼핑몰만 멈추고 sync_all 이 다음 쇼핑몰로 넘어간다.
|
||||
stopped = progress is not None and progress.stopped_only
|
||||
self._store.finish_run(run_id, ok=False, error="쇼핑몰 중지" if stopped else "업데이트 취소")
|
||||
if progress is not None:
|
||||
progress.cancelled()
|
||||
return {**result, "cancelled": True, "status": "cancelled", "message": "중지됨" if stopped else "취소됨"}
|
||||
except Exception as exc: # noqa: BLE001 — 한 쇼핑몰 실패가 전체를 멈추지 않게
|
||||
status, message = self._failure(exc, ctx)
|
||||
logger.warning("performance sync %s failed: %s %s", code, status, message)
|
||||
self._store.finish_run(run_id, ok=False, error=message)
|
||||
self._store.record_sync(code, status=status, ok=False, error=message)
|
||||
if progress is not None:
|
||||
progress.fail(status=status, label=STATUS_LABELS.get(status, status), message=message)
|
||||
return {**result, "status": status, "label": STATUS_LABELS.get(status, status), "message": message}
|
||||
|
||||
def sync_all(self, *, start: date | None = None, end: date | None = None, codes: list[str] | None = None,
|
||||
trigger: str = "manual", user: str = "", job: Any = None) -> list[dict[str, Any]]:
|
||||
"""job: jobs.SyncJob — 주면 쇼핑몰마다 진행 상황(ShopProgress)을 채운다(매출 업데이트 창)."""
|
||||
end = end or today_kst()
|
||||
start = start or (end - timedelta(days=sync_days() - 1))
|
||||
enabled = {m["code"] for m in self._store.list_marketplaces() if m["enabled"]}
|
||||
# 수동 입력 전용 쇼핑몰(manual_only)은 가져올 API 가 없어 매출 업데이트에서 뺀다
|
||||
targets = [a for a in all_adapters()
|
||||
if a.code in enabled and not a.manual_only and (not codes or a.code in codes)]
|
||||
progress: dict[str, Any] = {}
|
||||
if job is not None:
|
||||
# 수집이 구현되고 인증정보가 있는 쇼핑몰만 막대로(active), 나머지는 "건너뜀" 한 줄로 — 바로 끝나는
|
||||
# 쇼핑몰이 전체 진행률을 부풀리거나, 아직 차례가 안 와서 진행률을 낮추지 않게.
|
||||
def ready(a: MarketplaceAdapter) -> bool:
|
||||
if not a.implemented:
|
||||
return False
|
||||
try:
|
||||
return a.is_configured(self._ctx(a, user=user))
|
||||
except Exception: # noqa: BLE001 — 확인이 안 되면 일단 막대로(실제 결과는 수집 때 나온다)
|
||||
return True
|
||||
|
||||
progress = job.set_targets([(a.code, a.name, ready(a)) for a in targets], start, end)
|
||||
return [self.sync_marketplace(a.code, start, end, trigger=trigger, user=user, progress=progress.get(a.code))
|
||||
for a in targets]
|
||||
|
||||
# ── 쇼핑몰 화면과 대조 ────────────────────────────────
|
||||
def reconcile(self, code: str, day: date, *, to: date | None = None, user: str = "") -> dict[str, Any]:
|
||||
"""어댑터가 지원하면(reconcile) 그날 원천 금액을 항목별로 합산해 돌려준다. DB 는 바꾸지 않는다."""
|
||||
adapter = get_adapter(code)
|
||||
if adapter is None or not hasattr(adapter, "reconcile"):
|
||||
return {"ok": False, "message": "이 쇼핑몰은 대조 기능을 지원하지 않습니다."}
|
||||
ctx = None
|
||||
try:
|
||||
ctx = self._ctx(adapter, user=user)
|
||||
return {"ok": True, **(adapter.reconcile(ctx, day, to=to) if to else adapter.reconcile(ctx, day))}
|
||||
except Exception as exc: # noqa: BLE001
|
||||
status, message = self._failure(exc, ctx)
|
||||
return {"ok": False, "status": status, "label": STATUS_LABELS.get(status, status), "message": message}
|
||||
|
||||
def daily_check(self, code: str, start: date, end: date, *, live: bool = False, user: str = "") -> dict[str, Any]:
|
||||
"""쇼핑몰 화면 일별 매출과 날짜별로 맞춰 보는 용도. DB 는 바꾸지 않는다.
|
||||
db = 지금 저장된 값(날짜별 결제·환불·결제 건수)
|
||||
live = live=True 일 때 지금 API·현재 규칙으로 다시 계산한 값(매출 업데이트와 같은 계산, 저장 안 함).
|
||||
db 만 틀리고 live 가 맞으면 → 예전에 받은 뒤 규칙·주문이 바뀐 것(다시 가져오면 해결)."""
|
||||
adapter = get_adapter(code)
|
||||
if adapter is None:
|
||||
return {"ok": False, "message": "알 수 없는 쇼핑몰입니다."}
|
||||
prefix = adapter.event_prefix if adapter.replace_range else ""
|
||||
out: dict[str, Any] = {"ok": True, "db": self._store.daily_breakdown(code, start, end, id_prefix=prefix)}
|
||||
if not live:
|
||||
return out
|
||||
ctx = None
|
||||
try:
|
||||
ctx = self._ctx(adapter, user=user)
|
||||
_, events = adapter.collect(ctx, start, end)
|
||||
except Exception as exc: # noqa: BLE001
|
||||
status, message = self._failure(exc, ctx)
|
||||
return {**out, "live_error": f"{STATUS_LABELS.get(status, status)} — {message}"}
|
||||
days: dict[str, dict[str, Any]] = {}
|
||||
for ev in events:
|
||||
d = sales_date_for(ev)
|
||||
if not (start <= d <= end):
|
||||
continue
|
||||
row = days.setdefault(d.isoformat(), {"date": d.isoformat(), "paid": 0, "orders": 0, "refund": 0})
|
||||
if ev.event_type == "SALE":
|
||||
row["paid"] += ev.amount
|
||||
row["orders"] += 1
|
||||
else:
|
||||
row["refund"] -= ev.amount
|
||||
out["live"] = sorted(days.values(), key=lambda r: r["date"])
|
||||
return out
|
||||
|
||||
# ── 테스트(모의) 데이터 ────────────────────────────────
|
||||
def generate_samples(self, start: date, end: date, codes: list[str]) -> int:
|
||||
from .adapters import mock # noqa: WPS433
|
||||
|
||||
n = 0
|
||||
for code in codes:
|
||||
n += self._store.upsert_events(code, (event_row(ev) for ev in mock.generate(code, start, end)),
|
||||
is_sample=True)
|
||||
return n
|
||||
@@ -0,0 +1,16 @@
|
||||
{# 실적 모듈 탭 — [매출 실적] [광고비] 큰 탭 둘(아이콘 + 색으로 구분) + 맨 오른쪽 설정 톱니(프로젝트 모듈과 같은 아이콘).
|
||||
설정은 모듈 권한자 모두(일반 사용자 화면은 수수료율만, 나머지는 관리자). #}
|
||||
<link rel="stylesheet" href="/static/vendor/material-symbols/material-symbols.css" />
|
||||
<nav class="perf-tabs" aria-label="실적 메뉴">
|
||||
<div class="perf-tabs-main" role="tablist">
|
||||
<a class="perf-tab perf-tab-sales{% if active_tab == 'dashboard' %} is-active{% endif %}" href="/performance/"
|
||||
role="tab" aria-selected="{{ 'true' if active_tab == 'dashboard' else 'false' }}">
|
||||
<span class="material-symbols-outlined" aria-hidden="true">monitoring</span>매출 실적</a>
|
||||
<a class="perf-tab perf-tab-ads{% if active_tab == 'ads' %} is-active{% endif %}" href="/performance/ads"
|
||||
role="tab" aria-selected="{{ 'true' if active_tab == 'ads' else 'false' }}">
|
||||
<span class="material-symbols-outlined" aria-hidden="true">campaign</span>광고비</a>
|
||||
</div>
|
||||
<a class="perf-tab-gear{% if active_tab == 'settings' %} is-active{% endif %}" href="/performance/settings"
|
||||
title="{{ '실적 설정' if is_admin else '수수료 설정' }}" aria-label="{{ '실적 설정' if is_admin else '수수료 설정' }}">
|
||||
<span class="material-symbols-outlined" aria-hidden="true">settings</span></a>
|
||||
</nav>
|
||||
@@ -0,0 +1,227 @@
|
||||
{% extends "erp_base.html" %}
|
||||
|
||||
{% block head_extra %}<link rel="stylesheet" href="/static/performance.css?v=20261015a" />{% endblock %}
|
||||
|
||||
{#- ROAS 덧붙임 — "광고비(ROAS%)". 광고비가 없으면 아무것도 안 붙는다. -#}
|
||||
{%- macro roas(p) -%}{%- if p is not none -%}<span class="perf-roas">({{ "{:,}".format(p) }}%)</span>{%- endif -%}{%- endmacro -%}
|
||||
|
||||
{%- macro won(v) -%}
|
||||
{%- if v is none -%}<span class="perf-na"></span>
|
||||
{%- elif v == 0 -%}<span class="perf-zero">–</span>
|
||||
{%- else -%}{{ "{:,}".format(v) }}{%- endif -%}
|
||||
{%- endmacro -%}
|
||||
|
||||
{% block content %}
|
||||
{#- 광고비 — 매출 실적과 같은 기간 이동·표·그래프. 날짜 칸을 눌러 직접 입력(파란 숫자), 업로드로 들어온 값은 주황 숫자. -#}
|
||||
<section class="perf perf-ads" id="perf-dash" data-metric="gross" data-fixed-metric="gross">
|
||||
{% include "performance/_tabs.html" %}
|
||||
|
||||
<div class="perf-toolbar">
|
||||
<div class="perf-quick" role="group" aria-label="기간 선택">
|
||||
{% for q in nav.quick %}
|
||||
<a class="perf-seg{% if q.active %} is-active{% endif %}" href="{{ q.url }}">{{ q.label }}</a>
|
||||
{% endfor %}
|
||||
<button type="button" class="perf-seg{% if period_kind == 'custom' %} is-active{% endif %}" id="perf-custom-btn">직접선택</button>
|
||||
</div>
|
||||
|
||||
<div class="perf-nav">
|
||||
<a class="perf-nav-btn" href="{{ nav.prev }}" title="{{ period.prev_label }}">‹ {{ period.prev_label }}</a>
|
||||
<span class="perf-nav-label">{{ period.label }}</span>
|
||||
<a class="perf-nav-btn" href="{{ nav.next }}" title="{{ period.next_label }}">{{ period.next_label }} ›</a>
|
||||
</div>
|
||||
|
||||
<form class="perf-custom" id="perf-custom" method="get" action="/performance/ads"{% if period_kind != 'custom' %} hidden{% endif %}>
|
||||
<input type="hidden" name="period" value="custom" />
|
||||
<input class="erp-input perf-date" type="date" name="from" value="{{ period.start.isoformat() }}" required />
|
||||
<span class="perf-muted">~</span>
|
||||
<input class="erp-input perf-date" type="date" name="to" value="{{ period.end.isoformat() }}" required />
|
||||
<button class="erp-btn erp-btn-outline" type="submit">조회</button>
|
||||
</form>
|
||||
</div>
|
||||
|
||||
{% if migration_needed %}
|
||||
<div class="perf-notice is-warn">광고비 저장 표가 아직 없습니다. 관리자가 performance_db 마이그레이션 005
|
||||
(scripts/sql/performance_db_005_ad_spend.sql)를 적용하면 입력할 수 있습니다.</div>
|
||||
{% endif %}
|
||||
|
||||
<!-- ── KPI ── -->
|
||||
<div class="perf-kpis">
|
||||
{% for k in kpis %}
|
||||
<div class="perf-kpi{% if k.primary %} is-primary{% endif %}">
|
||||
<div class="perf-kpi-label">{{ k.label }}</div>
|
||||
{% if k.key == 'ratio' %}
|
||||
<div class="perf-kpi-value">{% if k.pct is none %}–{% else %}{{ "%.1f" | format(k.pct) }}%{% endif %}</div>
|
||||
<div class="perf-kpi-delta"><span class="perf-muted">{{ k.note }}</span></div>
|
||||
{% else %}
|
||||
<div class="perf-kpi-value">₩{{ "{:,}".format(k.value) }}</div>
|
||||
<div class="perf-kpi-delta">
|
||||
{% if k.delta is none %}<span class="perf-muted">{{ k.cmp }} 비교 없음</span>
|
||||
{% else %}
|
||||
{% set up = k.delta > 0 %}
|
||||
<span class="perf-delta {% if k.delta == 0 %}is-flat{% elif up != (k.invert or false) %}is-up{% else %}is-down{% endif %}">
|
||||
{% if k.delta > 0 %}▲{% elif k.delta < 0 %}▼{% else %}–{% endif %} {{ "%.1f" | format(k.delta | abs) }}%</span>
|
||||
<span class="perf-muted">{{ k.cmp }} 대비</span>
|
||||
{% endif %}
|
||||
</div>
|
||||
{% endif %}
|
||||
</div>
|
||||
{% endfor %}
|
||||
</div>
|
||||
|
||||
<!-- ── 일자 × 채널 ── -->
|
||||
<div class="erp-card perf-card">
|
||||
<div class="perf-card-head">
|
||||
<h2 class="perf-h">{% if period_kind == 'year' %}월별 × 광고 채널{% else %}일자별 × 광고 채널{% endif %}</h2>
|
||||
<div class="perf-ad-actions">
|
||||
{% for s in ad_sync_sources %}
|
||||
<button type="button" class="erp-btn erp-btn-outline erp-btn-sm perf-ad-sync-btn" data-ad-sync="{{ s.code }}"
|
||||
title="{{ s.name }} API 로 지금 보는 기간(오늘까지)의 광고비·ROAS 를 가져옵니다 — 같은 날은 덮어씀">
|
||||
<span class="material-symbols-outlined" aria-hidden="true">sync</span>{{ s.name }} 불러오기</button>
|
||||
{% endfor %}
|
||||
{% if upload_channels %}
|
||||
<button type="button" class="erp-btn erp-btn-outline erp-btn-sm perf-manual-upload-btn perf-ad-upload-btn" id="perf-ad-upload"
|
||||
title="광고 보고서 파일로 일별 광고비를 한 번에 입력">파일 업로드</button>
|
||||
{% endif %}
|
||||
</div>
|
||||
</div>
|
||||
<div class="erp-table-wrap perf-table-wrap">
|
||||
<table class="perf-table perf-main">
|
||||
<thead>
|
||||
<tr>
|
||||
<th class="perf-th-label">{% if period_kind == 'year' %}월{% else %}날짜{% endif %}</th>
|
||||
{% for c in codes %}{% if c in detail_channels %}<th class="perf-th-detail" title="{{ names[c] }} — 눌러 일자별 광고 보고서 항목 보기. 괄호 = {% if c == 'google' %}구글 광고 ROAS(전환 가치 ÷ 비용){% else %}보고서 ROAS(구매완료 광고수익률){% endif %}"><button type="button" class="perf-detail-btn" data-detail-channel="{{ c }}">{{ names[c] }} <span class="material-symbols-outlined" aria-hidden="true">table_view</span></button></th>{% else %}<th title="{{ names[c] }} — 날짜 칸을 눌러 광고비 입력.{% if roas_basis[c] %} 괄호 = ROAS({{ roas_basis[c] }} 매출 ÷ 광고비){% else %} ROAS 는 계산하지 않음(따로 입력){% endif %}">{{ names[c] }} <span class="perf-manual-mark" aria-hidden="true">✎</span></th>{% endif %}{% endfor %}
|
||||
<th class="perf-th-total">{% if period_kind == 'year' %}월 합계{% else %}일 합계{% endif %}</th>
|
||||
</tr>
|
||||
</thead>
|
||||
<tbody>
|
||||
{% for r in table %}
|
||||
<tr class="perf-row-{{ r.kind }}{% if r.weekday == 5 %} is-sat{% endif %}{% if r.weekday == 6 or r.holiday %} is-sun{% endif %}{% if r.today %} is-today{% endif %}{% if r.future %} is-future{% endif %}">
|
||||
<th class="perf-td-label" scope="row"{% if r.holiday %} title="{{ r.holiday }}"{% endif %}>
|
||||
{{ r.label }}{% if r.holiday %}<small class="perf-hol">{{ r.holiday }}</small>{% endif %}
|
||||
</th>
|
||||
{% for c in codes %}
|
||||
{% set v = r.cells[c].gross %}
|
||||
{% if r.kind == 'day' and not r.future and not migration_needed %}
|
||||
{% set up = (r.date ~ '|' ~ c) in upload_cells %}
|
||||
{% set ap = (r.date ~ '|' ~ c) in api_cells %}
|
||||
<td class="perf-num is-manual-cell{% if v and not up and not ap %} is-manual{% endif %}{% if up %} is-upload{% endif %}{% if ap %} is-api{% endif %}"
|
||||
data-manual-code="{{ c }}" data-date="{{ r.date }}" data-manual-value="{{ v if v else '' }}" tabindex="0"
|
||||
title="{% if ap %}광고 API 값 — 눌러 고치기(다음 불러오기 때 다시 API 값으로){% elif up %}파일 업로드 값 — 눌러 고치기{% else %}눌러 광고비 입력(비우고 저장하면 지움){% endif %}"><span class="v v-gross">{{ won(v) }}</span>{{ roas(r.roas[c]) }}</td>
|
||||
{% else %}
|
||||
<td class="perf-num"><span class="v v-gross">{{ won(v) }}</span>{{ roas(r.roas[c]) }}</td>
|
||||
{% endif %}
|
||||
{% endfor %}
|
||||
<td class="perf-num perf-td-total"><span class="v v-gross">{{ won(r.total.gross) }}</span>{{ roas(r.roas_total) }}</td>
|
||||
</tr>
|
||||
{% endfor %}
|
||||
</tbody>
|
||||
</table>
|
||||
</div>
|
||||
{% if period_kind != 'year' %}
|
||||
<p class="perf-muted perf-manual-help">날짜 칸을 눌러 그날 <b>광고비</b>를 직접 입력합니다 — Enter 저장 후 아래 칸, Esc 취소, 비우고 저장하면 지움.
|
||||
칸은 <b>광고비(ROAS%)</b> — ROAS = 그 쇼핑몰 매출 실적 총매출 ÷ 광고비(합계 열은 전체 매출). 메타는 ROAS 를 계산하지 않고,
|
||||
네이버는 광고 보고서의 ROAS(구매완료 광고수익률), 구글은 구글 광고 API 의 ROAS(전환 가치 ÷ 비용)를 씁니다 — 네이버·구글 머리글을 누르면 일자별 보고서 항목.
|
||||
파란 숫자 = 직접 입력, 주황 숫자 = 파일 업로드 값, 초록 숫자 = 광고 API 값. 쿠팡(윙)·쿠팡(로켓)·네이버는 [파일 업로드]로 광고 보고서를 올리면 날짜별로 한 번에 들어갑니다.
|
||||
구글은 [구글 광고 불러오기](관리자가 실적 설정 → 광고 API 연동을 마친 뒤) 또는 매출 자동 업데이트 때 들어옵니다.</p>
|
||||
{% endif %}
|
||||
</div>
|
||||
|
||||
<!-- ── 그래프 ── -->
|
||||
<div class="perf-grid2">
|
||||
<div class="erp-card perf-card">
|
||||
<div class="perf-card-head"><h2 class="perf-h">{% if period_kind == 'year' %}월별{% else %}일별{% endif %} 광고비 추이</h2></div>
|
||||
<div class="perf-chart" id="perf-chart-daily"></div>
|
||||
</div>
|
||||
<div class="erp-card perf-card">
|
||||
<div class="perf-card-head"><h2 class="perf-h">채널별 비중</h2>
|
||||
<span class="perf-muted">{{ period.label }}</span></div>
|
||||
<div class="perf-chart" id="perf-chart-share"></div>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<!-- ── 월 누적 · 연간 누적 ── -->
|
||||
<div class="perf-grid2">
|
||||
<div class="erp-card perf-card">
|
||||
<div class="perf-card-head"><h2 class="perf-h">{{ month.label }} 채널별 광고비</h2></div>
|
||||
<div class="erp-table-wrap">
|
||||
<table class="perf-table">
|
||||
<thead><tr><th class="perf-th-label">채널</th><th>광고비</th><th>ROAS</th><th>비중</th></tr></thead>
|
||||
<tbody>
|
||||
{% for r in month.rows %}
|
||||
<tr>
|
||||
<th class="perf-td-label" scope="row">{{ names[r.code] }}</th>
|
||||
<td class="perf-num">{{ won(r.gross) }}</td>
|
||||
<td class="perf-num">{% if r.roas is not none %}{{ "{:,}".format(r.roas) }}%{% else %}<span class="perf-zero">–</span>{% endif %}</td>
|
||||
<td class="perf-num perf-share">
|
||||
{% if r.share is not none %}<span class="perf-bar" style="--w: {{ [r.share, 0] | max }}%"></span>{{ "%.1f" | format(r.share) }}%{% else %}<span class="perf-zero">–</span>{% endif %}
|
||||
</td>
|
||||
</tr>
|
||||
{% endfor %}
|
||||
</tbody>
|
||||
<tfoot>
|
||||
<tr class="perf-row-total">
|
||||
<th class="perf-td-label" scope="row">합계</th>
|
||||
<td class="perf-num">{{ won(month.total.gross) }}</td>
|
||||
<td class="perf-num">{% if month.total.roas is not none %}{{ "{:,}".format(month.total.roas) }}%{% else %}<span class="perf-zero">–</span>{% endif %}</td>
|
||||
<td class="perf-num">{% if month.total.share is not none %}100%{% else %}<span class="perf-zero">–</span>{% endif %}</td>
|
||||
</tr>
|
||||
</tfoot>
|
||||
</table>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<div class="erp-card perf-card">
|
||||
<div class="perf-card-head"><h2 class="perf-h">{{ year.year }}년 누적 광고비</h2></div>
|
||||
<div class="perf-year-sum">
|
||||
<div><span>광고비</span><b>₩{{ "{:,}".format(year.total.gross) }}</b></div>
|
||||
</div>
|
||||
<div class="erp-table-wrap">
|
||||
<table class="perf-table perf-year">
|
||||
<thead><tr><th class="perf-th-label">월</th><th>광고비</th><th>ROAS</th></tr></thead>
|
||||
<tbody>
|
||||
{% for r in year.rows %}
|
||||
<tr class="{% if r.future %}is-future{% endif %}">
|
||||
<th class="perf-td-label" scope="row">{{ r.label }}</th>
|
||||
<td class="perf-num">{{ won(r.gross) }}</td>
|
||||
<td class="perf-num">{% if r.roas is not none %}{{ "{:,}".format(r.roas) }}%{% elif not r.future %}<span class="perf-zero">–</span>{% endif %}</td>
|
||||
</tr>
|
||||
{% endfor %}
|
||||
</tbody>
|
||||
<tfoot>
|
||||
<tr class="perf-row-total">
|
||||
<th class="perf-td-label" scope="row">합계</th>
|
||||
<td class="perf-num">{{ won(year.total.gross) }}</td>
|
||||
<td class="perf-num">{% if year.total.roas is not none %}{{ "{:,}".format(year.total.roas) }}%{% else %}<span class="perf-zero">–</span>{% endif %}</td>
|
||||
</tr>
|
||||
</tfoot>
|
||||
</table>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<p class="perf-foot perf-muted">
|
||||
광고비 기준: 쿠팡(윙)·쿠팡(로켓)은 광고 보고서의 청구금액(+부가가치세), 구글은 구글 광고 비용 + 부가세 10%(부가세 포함).
|
||||
ROAS = 그 쇼핑몰 매출 ÷ 광고비 × 100(메타는 계산 안 함, 네이버·구글은 광고 쪽 값).
|
||||
매출 대비 광고비 = 같은 기간 광고비 ÷ 매출 실적 총매출.
|
||||
메타는 지금은 직접 입력합니다.
|
||||
</p>
|
||||
</section>
|
||||
|
||||
<script type="application/json" id="perf-data">{{ {
|
||||
"names": names,
|
||||
"codes": codes,
|
||||
"daily": chart_daily,
|
||||
"share": chart_share,
|
||||
"period_kind": period_kind,
|
||||
"today": today,
|
||||
"manual_api": "/performance/api/ad-spend/",
|
||||
"manual_word": "광고비",
|
||||
"period_start": period.start.isoformat(),
|
||||
"period_end": period.end.isoformat(),
|
||||
"period_label": period.label,
|
||||
"empty_text": "기간 내 광고비가 없습니다.",
|
||||
"upload_channels": upload_channels
|
||||
} | tojson }}</script>
|
||||
{% endblock %}
|
||||
|
||||
{% block scripts %}<script src="/static/performance.js?v=20261015b" defer></script>{% endblock %}
|
||||
@@ -0,0 +1,258 @@
|
||||
{% extends "erp_base.html" %}
|
||||
|
||||
{% block head_extra %}<link rel="stylesheet" href="/static/performance.css?v=20261015a" />{% endblock %}
|
||||
|
||||
{%- macro won(v) -%}
|
||||
{%- if v is none -%}<span class="perf-na"></span>
|
||||
{%- elif v == 0 -%}<span class="perf-zero">–</span>
|
||||
{%- else -%}{{ "{:,}".format(v) }}{%- endif -%}
|
||||
{%- endmacro -%}
|
||||
|
||||
{#- 한 칸에 총매출/수수료/차감매출 세 값을 넣고, 보기 전환은 CSS(data-metric)로. -#}
|
||||
{%- macro m3(m) -%}
|
||||
<span class="v v-gross">{{ won(m.gross) }}</span><span class="v v-commission">{{ won(m.commission) }}</span><span class="v v-net">{{ won(m.net) }}</span>
|
||||
{%- endmacro -%}
|
||||
|
||||
{% block content %}
|
||||
<section class="perf" id="perf-dash" data-metric="{{ metric }}">
|
||||
{% include "performance/_tabs.html" %}
|
||||
|
||||
<!-- ── 기간 · 필터 · 업데이트 ── -->
|
||||
<div class="perf-toolbar">
|
||||
<div class="perf-quick" role="group" aria-label="기간 선택">
|
||||
{% for q in nav.quick %}
|
||||
<a class="perf-seg{% if q.active %} is-active{% endif %}" href="{{ q.url }}">{{ q.label }}</a>
|
||||
{% endfor %}
|
||||
<button type="button" class="perf-seg{% if period_kind == 'custom' %} is-active{% endif %}" id="perf-custom-btn">직접선택</button>
|
||||
</div>
|
||||
|
||||
<div class="perf-nav">
|
||||
<a class="perf-nav-btn" href="{{ nav.prev }}" title="{{ period.prev_label }}">‹ {{ period.prev_label }}</a>
|
||||
<span class="perf-nav-label">{{ period.label }}</span>
|
||||
<a class="perf-nav-btn" href="{{ nav.next }}" title="{{ period.next_label }}">{{ period.next_label }} ›</a>
|
||||
</div>
|
||||
|
||||
<form class="perf-custom" id="perf-custom" method="get" action="/performance/"{% if period_kind != 'custom' %} hidden{% endif %}>
|
||||
<input type="hidden" name="period" value="custom" />
|
||||
<input class="erp-input perf-date" type="date" name="from" value="{{ period.start.isoformat() }}" required />
|
||||
<span class="perf-muted">~</span>
|
||||
<input class="erp-input perf-date" type="date" name="to" value="{{ period.end.isoformat() }}" required />
|
||||
{% for c in codes %}{% if not selected_all %}<input type="hidden" name="m" value="{{ c }}" />{% endif %}{% endfor %}
|
||||
<button class="erp-btn erp-btn-outline" type="submit">조회</button>
|
||||
</form>
|
||||
|
||||
<details class="perf-filter" id="perf-filter">
|
||||
<summary class="erp-btn erp-btn-outline">쇼핑몰: {% if selected_all %}전체{% else %}{{ codes | length }}곳{% endif %}</summary>
|
||||
<form class="perf-filter-pop" method="get" action="/performance/">
|
||||
<input type="hidden" name="period" value="{{ period_kind }}" />
|
||||
{% if period_kind == 'custom' %}
|
||||
<input type="hidden" name="from" value="{{ period.start.isoformat() }}" />
|
||||
<input type="hidden" name="to" value="{{ period.end.isoformat() }}" />
|
||||
{% else %}
|
||||
<input type="hidden" name="d" value="{{ period.anchor.isoformat() }}" />
|
||||
{% endif %}
|
||||
{% for c in all_codes %}
|
||||
<label class="perf-check"><input type="checkbox" name="m" value="{{ c }}"{% if c in codes %} checked{% endif %} /> {{ names[c] }}</label>
|
||||
{% endfor %}
|
||||
<div class="perf-filter-act">
|
||||
<button type="button" class="erp-btn erp-btn-ghost" data-perf-check-all>전체</button>
|
||||
<button type="submit" class="erp-btn erp-btn-primary">적용</button>
|
||||
</div>
|
||||
</form>
|
||||
</details>
|
||||
|
||||
<div class="perf-update">
|
||||
<span class="perf-muted" id="perf-last-update">마지막 업데이트
|
||||
<b>{{ (last_update_at or '')[:16] | replace('T', ' ') or '—' }}</b></span>
|
||||
<button type="button" class="erp-btn erp-btn-primary" id="perf-sync-btn"{% if running %} disabled{% endif %}
|
||||
title="지금 보고 있는 기간({{ period.label }}, 오늘까지)의 매출을 쇼핑몰에서 다시 가져옵니다">
|
||||
{% if running %}업데이트 중…{% else %}매출 업데이트{% endif %}
|
||||
</button>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
{% if no_marketplaces %}
|
||||
<div class="perf-notice">매출에 포함된 쇼핑몰이 없습니다. {% if is_admin %}<a href="/performance/settings">실적 설정</a>에서 쇼핑몰 사용을 켜세요.{% endif %}</div>
|
||||
{% endif %}
|
||||
|
||||
{% if problems %}
|
||||
<div class="perf-notice is-warn" id="perf-problems">
|
||||
<b>연결 오류</b>
|
||||
{% for p in problems %}<span class="perf-problem" title="{{ p.error }}">{{ p.name }} · {{ p.label }}</span>{% endfor %}
|
||||
<span class="perf-muted">— 해당 쇼핑몰은 마지막 정상 수집분까지만 반영됩니다. 나머지는 정상입니다.</span>
|
||||
</div>
|
||||
{% endif %}
|
||||
<div class="perf-notice" id="perf-sync-result" hidden></div>
|
||||
|
||||
<!-- ── KPI ── -->
|
||||
<div class="perf-kpis">
|
||||
{% for k in kpis %}
|
||||
<div class="perf-kpi{% if k.primary %} is-primary{% endif %}">
|
||||
<div class="perf-kpi-label">{{ k.label }}</div>
|
||||
<div class="perf-kpi-value">₩{{ "{:,}".format(k.value) }}</div>
|
||||
<div class="perf-kpi-delta">
|
||||
{% if k.delta is none %}<span class="perf-muted">{{ k.cmp }} 비교 없음</span>
|
||||
{% else %}
|
||||
{% set up = k.delta > 0 %}
|
||||
<span class="perf-delta {% if k.delta == 0 %}is-flat{% elif up != (k.invert or false) %}is-up{% else %}is-down{% endif %}">
|
||||
{% if k.delta > 0 %}▲{% elif k.delta < 0 %}▼{% else %}–{% endif %} {{ "%.1f" | format(k.delta | abs) }}%</span>
|
||||
<span class="perf-muted">{{ k.cmp }} 대비</span>
|
||||
{% endif %}
|
||||
</div>
|
||||
</div>
|
||||
{% endfor %}
|
||||
</div>
|
||||
|
||||
<!-- ── 일자 × 쇼핑몰 ── -->
|
||||
<div class="erp-card perf-card">
|
||||
<div class="perf-card-head">
|
||||
<h2 class="perf-h">{% if period_kind == 'year' %}월별 × 쇼핑몰{% else %}일자별 × 쇼핑몰{% endif %}</h2>
|
||||
{% if manual_upload_names %}
|
||||
<button type="button" class="erp-btn erp-btn-outline erp-btn-sm perf-manual-upload-btn" id="perf-manual-upload"
|
||||
title="수동 입력 쇼핑몰 매출을 엑셀 파일로 한 번에 입력">엑셀 업로드</button>
|
||||
{% endif %}
|
||||
<div class="perf-metric" role="group" aria-label="표시 기준">
|
||||
<button type="button" class="perf-seg" data-metric="gross">총매출</button>
|
||||
<button type="button" class="perf-seg" data-metric="commission">수수료</button>
|
||||
<button type="button" class="perf-seg" data-metric="net">수수료 차감 매출</button>
|
||||
</div>
|
||||
</div>
|
||||
<div class="erp-table-wrap perf-table-wrap">
|
||||
<table class="perf-table perf-main">
|
||||
<thead>
|
||||
<tr>
|
||||
<th class="perf-th-label">{% if period_kind == 'year' %}월{% else %}날짜{% endif %}</th>
|
||||
{% for c in codes %}<th title="{{ names[c] }}{% if c in manual_codes %} — 수동 입력(날짜 칸을 눌러 입력){% endif %}">{{ short_names[c] }}{% if c in manual_codes %} <span class="perf-manual-mark" aria-label="수동 입력">✎</span>{% endif %}</th>{% endfor %}
|
||||
<th class="perf-th-total">{% if period_kind == 'year' %}월 합계{% else %}일 합계{% endif %}</th>
|
||||
</tr>
|
||||
</thead>
|
||||
<tbody>
|
||||
{% for r in table %}
|
||||
<tr class="perf-row-{{ r.kind }}{% if r.weekday == 5 %} is-sat{% endif %}{% if r.weekday == 6 or r.holiday %} is-sun{% endif %}{% if r.today %} is-today{% endif %}{% if r.future %} is-future{% endif %}">
|
||||
<th class="perf-td-label" scope="row"{% if r.holiday %} title="{{ r.holiday }}"{% endif %}>
|
||||
{{ r.label }}{% if r.holiday %}<small class="perf-hol">{{ r.holiday }}</small>{% endif %}
|
||||
</th>
|
||||
{% for c in codes %}
|
||||
{% set m = r.cells[c] %}
|
||||
{% if r.kind == 'day' and c in manual_codes and not r.future %}
|
||||
{% set is_manual = (r.date ~ '|' ~ c) in manual_cells %}
|
||||
<td class="perf-num is-manual-cell{% if is_manual %} is-manual{% endif %}" data-manual-code="{{ c }}" data-date="{{ r.date }}"
|
||||
data-manual-value="{{ m.gross if is_manual else '' }}" tabindex="0"
|
||||
title="{% if is_manual %}수동 입력값 — 눌러 고치기(비우고 저장하면 API 값){% else %}눌러 총매출 직접 입력{% endif %}">{{ m3(m) }}</td>
|
||||
{% else %}
|
||||
<td class="perf-num{% if r['from'] and (m.gross or m.commission) %} is-link{% endif %}"
|
||||
{% if r['from'] %}data-code="{{ c }}" data-from="{{ r['from'] }}" data-to="{{ r['to'] }}"{% endif %}>{{ m3(m) }}</td>
|
||||
{% endif %}
|
||||
{% endfor %}
|
||||
<td class="perf-num perf-td-total">{{ m3(r.total) }}</td>
|
||||
</tr>
|
||||
{% endfor %}
|
||||
</tbody>
|
||||
</table>
|
||||
</div>
|
||||
{% if manual_codes and period_kind != 'year' %}
|
||||
<p class="perf-muted perf-manual-help">✎ 표시 쇼핑몰은 날짜 칸을 눌러 <b>총매출</b>을 직접 입력합니다 — Enter 저장 후 아래 칸, Esc 취소,
|
||||
비우고 저장하면 다시 API 수집값. 파란 숫자 = 수동 입력값. 수수료는 그날 수수료율로 계산되고, 입력을 마치면 합계·그래프가 다시 계산됩니다.</p>
|
||||
{% endif %}
|
||||
</div>
|
||||
|
||||
<!-- ── 그래프 ── -->
|
||||
<div class="perf-grid2">
|
||||
<div class="erp-card perf-card">
|
||||
<div class="perf-card-head"><h2 class="perf-h">{% if period_kind == 'year' %}월별{% else %}일별{% endif %} 매출 추이</h2>
|
||||
<span class="perf-muted perf-metric-name"></span></div>
|
||||
<div class="perf-chart" id="perf-chart-daily"></div>
|
||||
</div>
|
||||
<div class="erp-card perf-card">
|
||||
<div class="perf-card-head"><h2 class="perf-h">쇼핑몰별 비중</h2>
|
||||
<span class="perf-muted">{{ period.label }}</span></div>
|
||||
<div class="perf-chart" id="perf-chart-share"></div>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<!-- ── 월 누적 · 연간 누적 ── -->
|
||||
<div class="perf-grid2">
|
||||
<div class="erp-card perf-card">
|
||||
<div class="perf-card-head"><h2 class="perf-h">{{ month.label }} 쇼핑몰별 누적 실적</h2></div>
|
||||
<div class="erp-table-wrap">
|
||||
<table class="perf-table">
|
||||
<thead><tr><th class="perf-th-label">쇼핑몰</th><th>총매출</th><th>수수료</th><th>수수료 차감 매출</th><th>매출 비중</th></tr></thead>
|
||||
<tbody>
|
||||
{% for r in month.rows %}
|
||||
<tr>
|
||||
<th class="perf-td-label" scope="row">{{ names[r.code] }}</th>
|
||||
<td class="perf-num">{{ won(r.gross) }}</td>
|
||||
<td class="perf-num">{{ won(r.commission) }}</td>
|
||||
<td class="perf-num">{{ won(r.net) }}</td>
|
||||
<td class="perf-num perf-share">
|
||||
{% if r.share is not none %}<span class="perf-bar" style="--w: {{ [r.share, 0] | max }}%"></span>{{ "%.1f" | format(r.share) }}%{% else %}<span class="perf-zero">–</span>{% endif %}
|
||||
</td>
|
||||
</tr>
|
||||
{% endfor %}
|
||||
</tbody>
|
||||
<tfoot>
|
||||
<tr class="perf-row-total">
|
||||
<th class="perf-td-label" scope="row">합계</th>
|
||||
<td class="perf-num">{{ won(month.total.gross) }}</td>
|
||||
<td class="perf-num">{{ won(month.total.commission) }}</td>
|
||||
<td class="perf-num">{{ won(month.total.net) }}</td>
|
||||
<td class="perf-num">{% if month.total.share is not none %}100%{% else %}<span class="perf-zero">–</span>{% endif %}</td>
|
||||
</tr>
|
||||
</tfoot>
|
||||
</table>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<div class="erp-card perf-card">
|
||||
<div class="perf-card-head"><h2 class="perf-h">{{ year.year }}년 누적</h2></div>
|
||||
<div class="perf-year-sum">
|
||||
<div><span>총매출</span><b>₩{{ "{:,}".format(year.total.gross) }}</b></div>
|
||||
<div><span>수수료</span><b>₩{{ "{:,}".format(year.total.commission) }}</b></div>
|
||||
<div><span>수수료 차감 매출</span><b>₩{{ "{:,}".format(year.total.net) }}</b></div>
|
||||
</div>
|
||||
<div class="erp-table-wrap">
|
||||
<table class="perf-table perf-year">
|
||||
<thead><tr><th class="perf-th-label">월</th><th>총매출</th><th>수수료</th><th>수수료 차감 매출</th></tr></thead>
|
||||
<tbody>
|
||||
{% for r in year.rows %}
|
||||
<tr class="{% if r.future %}is-future{% endif %}">
|
||||
<th class="perf-td-label" scope="row">{{ r.label }}</th>
|
||||
<td class="perf-num">{{ won(r.gross) }}</td>
|
||||
<td class="perf-num">{{ won(r.commission) }}</td>
|
||||
<td class="perf-num">{{ won(r.net) }}</td>
|
||||
</tr>
|
||||
{% endfor %}
|
||||
</tbody>
|
||||
<tfoot>
|
||||
<tr class="perf-row-total">
|
||||
<th class="perf-td-label" scope="row">합계</th>
|
||||
<td class="perf-num">{{ won(year.total.gross) }}</td>
|
||||
<td class="perf-num">{{ won(year.total.commission) }}</td>
|
||||
<td class="perf-num">{{ won(year.total.net) }}</td>
|
||||
</tr>
|
||||
</tfoot>
|
||||
</table>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<p class="perf-foot perf-muted">
|
||||
매출 기준: 결제는 결제일, 취소·반품은 발생일에 반영(음수). 수수료는 그날 적용되는 쇼핑몰 수수료율로 계산하며
|
||||
일·쇼핑몰 단위로 원 미만 반올림합니다. 금액을 누르면 주문 목록을 볼 수 있습니다.
|
||||
</p>
|
||||
</section>
|
||||
|
||||
<script type="application/json" id="perf-data">{{ {
|
||||
"names": names,
|
||||
"codes": codes,
|
||||
"daily": chart_daily,
|
||||
"share": chart_share,
|
||||
"period_kind": period_kind,
|
||||
"period_start": period.start.isoformat(),
|
||||
"period_end": period.end.isoformat(),
|
||||
"today": today,
|
||||
"manual_upload_names": manual_upload_names
|
||||
} | tojson }}</script>
|
||||
{% endblock %}
|
||||
|
||||
{% block scripts %}<script src="/static/performance.js?v=20261015b" defer></script>{% endblock %}
|
||||
@@ -0,0 +1,251 @@
|
||||
{% extends "erp_base.html" %}
|
||||
|
||||
{% block head_extra %}<link rel="stylesheet" href="/static/performance.css?v=20261015a" />{% endblock %}
|
||||
|
||||
{%- macro when(v) -%}{{ (v or '')[:16] | replace('T', ' ') or '—' }}{%- endmacro -%}
|
||||
|
||||
{% block content %}
|
||||
<section class="perf perf-settings" id="perf-settings">
|
||||
{% include "performance/_tabs.html" %}
|
||||
|
||||
{# 일반 사용자(실적 권한)는 쇼핑몰별 수수료율만 — 사용·집계 토글·API 인증정보·연결 상태·아래 카드는 관리자만(서버 API 도 관리자만) #}
|
||||
{% if is_admin and not key_info.ok %}
|
||||
<div class="perf-notice is-warn">
|
||||
<b>암호화 마스터 키가 없습니다.</b> {{ key_info.message }}
|
||||
— 키가 없으면 API 인증정보를 저장할 수 없습니다(수수료 설정·대시보드는 사용 가능).
|
||||
</div>
|
||||
{% endif %}
|
||||
|
||||
<div class="erp-card perf-card">
|
||||
<div class="perf-card-head">
|
||||
<h2 class="perf-h">쇼핑몰 설정</h2>
|
||||
{% if is_admin %}
|
||||
<span class="perf-muted">사용 · 매출 집계 · 수동 입력 · 수수료율은 바로 저장됩니다. API 인증정보는 [설정]에서 입력합니다.
|
||||
수동 입력을 켜면 실적 일자별 표에서 그 쇼핑몰 날짜 칸에 매출을 직접 넣을 수 있습니다.</span>
|
||||
{% else %}
|
||||
<span class="perf-muted">쇼핑몰별 수수료율을 설정합니다. 바로 저장되며 실적 화면의 수수료·수수료 차감 매출에 반영됩니다.</span>
|
||||
{% endif %}
|
||||
</div>
|
||||
<div class="erp-table-wrap">
|
||||
<table class="perf-table perf-set-table">
|
||||
<thead>
|
||||
<tr>
|
||||
<th class="perf-th-label">쇼핑몰</th>
|
||||
{% if is_admin %}<th>사용</th>
|
||||
<th>매출 집계</th>
|
||||
<th>수동 입력</th>{% endif %}
|
||||
<th>수수료율</th>
|
||||
{% if is_admin %}<th>API 설정</th>
|
||||
<th>연결 상태</th>{% endif %}
|
||||
<th>마지막 동기화</th>
|
||||
{% if is_admin %}<th></th>{% endif %}
|
||||
</tr>
|
||||
</thead>
|
||||
<tbody>
|
||||
{% for r in rows %}
|
||||
<tr data-code="{{ r.code }}" data-name="{{ r.name }}">
|
||||
<th class="perf-td-label" scope="row">{{ r.name }}</th>
|
||||
{% if is_admin %}
|
||||
<td class="perf-center">
|
||||
<label class="perf-switch" title="사용 여부">
|
||||
<input type="checkbox" data-field="enabled"{% if r.enabled %} checked{% endif %} /><span></span>
|
||||
</label>
|
||||
</td>
|
||||
<td class="perf-center">
|
||||
<label class="perf-switch" title="매출 집계에 포함">
|
||||
<input type="checkbox" data-field="include_in_sales"{% if r.include_in_sales %} checked{% endif %} /><span></span>
|
||||
</label>
|
||||
</td>
|
||||
<td class="perf-center">
|
||||
<label class="perf-switch" title="{% if r.manual_only %}수동 입력 전용 쇼핑몰 — API 연동이 없어 늘 켜져 있습니다{% else %}수동 입력 사용 — 켜면 실적 일자별 표에서 날짜 칸에 매출을 직접 입력(입력한 날은 API 값 대신){% endif %}">
|
||||
<input type="checkbox" data-field="manual_input"{% if r.manual_input or r.manual_only %} checked{% endif %}{% if r.manual_only %} disabled{% endif %} /><span></span>
|
||||
</label>
|
||||
</td>
|
||||
{% endif %}
|
||||
<td class="perf-rate-cell">
|
||||
<span class="perf-rate">{% if r.rate %}{{ r.rate }}%{% else %}<span class="perf-muted">미설정</span>{% endif %}</span>
|
||||
<button type="button" class="erp-btn erp-btn-ghost erp-btn-sm" data-act="rate"
|
||||
data-has-history="{{ 1 if r.rate_history else 0 }}">변경{% if r.rate_history > 1 %} · 이력 {{ r.rate_history }}{% endif %}</button>
|
||||
</td>
|
||||
{% if is_admin %}
|
||||
<td>
|
||||
{% if r.manual_only %}<span class="perf-pill">수동 입력 전용</span>
|
||||
{% elif r.shared %}<span class="perf-pill">공통 연동</span>
|
||||
{% elif r.configured %}<span class="perf-pill is-ok">설정완료</span>
|
||||
{% else %}<span class="perf-pill">미설정</span>{% endif %}
|
||||
{% if r.via_cafe24 %}<span class="perf-pill is-ok" title="카페24 마켓 통합관리로 들어온 이 쇼핑몰 주문을 카페24 수집 때 함께 반영합니다">카페24 경유</span>{% endif %}
|
||||
</td>
|
||||
<td>
|
||||
<span class="perf-status st-{{ r.status }}"
|
||||
title="마지막 연결 테스트: {{ when(r.last_test_at) }}{% if r.last_error %} 최근 오류({{ when(r.last_error_at) }}): {{ r.last_error }}{% endif %}">
|
||||
<i></i>{{ r.status_label }}</span>
|
||||
{% if r.last_error and r.status not in ('ok', 'disabled') %}<div class="perf-err">{{ r.last_error }}</div>{% endif %}
|
||||
</td>
|
||||
{% endif %}
|
||||
<td class="perf-muted perf-nowrap" title="마지막 시도: {{ when(r.last_sync_at) }}">{{ when(r.last_success_sync_at) }}</td>
|
||||
{% if is_admin %}
|
||||
<td class="perf-nowrap">
|
||||
{% if not r.manual_only %}
|
||||
<button type="button" class="erp-btn erp-btn-outline erp-btn-sm" data-act="creds">설정</button>
|
||||
<button type="button" class="erp-btn erp-btn-outline erp-btn-sm" data-act="test">연결 테스트</button>
|
||||
{% endif %}
|
||||
</td>
|
||||
{% endif %}
|
||||
</tr>
|
||||
{% endfor %}
|
||||
</tbody>
|
||||
</table>
|
||||
</div>
|
||||
<p class="perf-foot perf-muted">
|
||||
수수료율은 <b>적용 시작일</b>부터 반영되고, 그 전 실적은 예전 요율로 계산됩니다(과거 실적이 바뀌지 않음).
|
||||
{% if is_admin %}상태에 마우스를 올리면 마지막 연결 테스트 시각과 최근 오류를 볼 수 있습니다.{% endif %}
|
||||
</p>
|
||||
</div>
|
||||
|
||||
{% if is_admin %}
|
||||
{# 광고 API 연동(2026-10-15, 마이그레이션 007) — 구글 광고 등. 인증정보는 쇼핑몰과 같은 마스터 키로 암호화 저장.
|
||||
가져온 광고비·ROAS 는 광고비 탭(초록 숫자). [설정]·[연결 테스트]는 쇼핑몰 표와 같은 창(/api/ad-sources/…). #}
|
||||
<div class="erp-card perf-card" id="perf-ad-sources">
|
||||
<div class="perf-card-head">
|
||||
<h2 class="perf-h">광고 API 연동</h2>
|
||||
<span class="perf-muted">광고비 탭의 광고비·ROAS 를 광고 API 로 가져옵니다. 인증정보는 [설정]에서 입력하면 암호화해 저장합니다.
|
||||
설정이 끝나면 광고비 탭 [구글 광고 불러오기]와 매출 자동 업데이트(30분마다 최근 며칠) 때 함께 가져옵니다.</span>
|
||||
</div>
|
||||
{% if not ad_api_ready %}
|
||||
<div class="perf-notice is-warn">광고 API 인증정보 저장 표가 아직 없습니다. performance_db 마이그레이션 007
|
||||
(scripts/sql/performance_db_007_ad_api.sql)을 적용해야 저장할 수 있습니다.</div>
|
||||
{% endif %}
|
||||
<div class="erp-table-wrap">
|
||||
<table class="perf-table perf-set-table">
|
||||
<thead>
|
||||
<tr><th class="perf-th-label">광고</th><th>API 설정</th><th>연결 상태</th><th>마지막 가져오기</th><th></th></tr>
|
||||
</thead>
|
||||
<tbody>
|
||||
{% for a in ad_sources %}
|
||||
<tr data-code="{{ a.code }}" data-name="{{ a.name }}" data-api="ad-sources">
|
||||
<th class="perf-td-label" scope="row">{{ a.name }}</th>
|
||||
<td>{% if a.configured %}<span class="perf-pill is-ok">설정완료</span>{% else %}<span class="perf-pill">미설정</span>{% endif %}</td>
|
||||
<td>
|
||||
<span class="perf-status st-{{ a.status }}"
|
||||
title="마지막 연결 테스트: {{ when(a.last_test_at) }}{% if a.last_error %} 최근 오류({{ when(a.last_error_at) }}): {{ a.last_error }}{% endif %}">
|
||||
<i></i>{{ a.status_label }}</span>
|
||||
{% if a.last_error and a.status not in ('ok',) %}<div class="perf-err">{{ a.last_error }}</div>{% endif %}
|
||||
</td>
|
||||
<td class="perf-muted perf-nowrap" title="마지막 시도: {{ when(a.last_sync_at) }}">{{ when(a.last_success_sync_at) }}</td>
|
||||
<td class="perf-nowrap">
|
||||
<button type="button" class="erp-btn erp-btn-outline erp-btn-sm" data-act="creds">설정</button>
|
||||
<button type="button" class="erp-btn erp-btn-outline erp-btn-sm" data-act="test">연결 테스트</button>
|
||||
</td>
|
||||
</tr>
|
||||
{% endfor %}
|
||||
</tbody>
|
||||
</table>
|
||||
</div>
|
||||
<p class="perf-foot perf-muted">
|
||||
구글 광고: 광고비 = 구글 광고 화면의 "비용" + 부가세 10%(부가세 포함), ROAS = 전환 가치 ÷ 비용(구글 화면 값 그대로). 날짜는 광고 계정 시간대 기준이며 원화(KRW) 계정만 가져옵니다.
|
||||
가져온 날은 직접 입력·업로드 값보다 우선해 덮어씁니다.
|
||||
</p>
|
||||
</div>
|
||||
|
||||
<div class="perf-grid2">
|
||||
<div class="erp-card perf-card">
|
||||
<div class="perf-card-head"><h2 class="perf-h">인증정보 암호화</h2></div>
|
||||
<dl class="perf-dl">
|
||||
<dt>마스터 키</dt>
|
||||
<dd>{% if key_info.ok %}<span class="perf-pill is-ok">설정됨 · 현재 v{{ key_info.current_version }}</span>
|
||||
{% set olds = key_info.versions | reject('equalto', key_info.current_version) | list %}
|
||||
{% if olds %}<span class="perf-muted">(예전 키 v{{ olds | join(', v') }} 보관 중)</span>{% endif %}
|
||||
{% else %}<span class="perf-pill is-bad">미설정</span>{% endif %}</dd>
|
||||
<dt>저장된 항목</dt>
|
||||
<dd>{% for v, n in key_versions_in_use.items() %}v{{ v }}: {{ n }}개{% if not loop.last %}, {% endif %}{% else %}<span class="perf-muted">없음</span>{% endfor %}</dd>
|
||||
</dl>
|
||||
{% if stale_key_rows %}
|
||||
<p class="perf-notice is-warn">예전 키로 암호화된 항목이 {{ stale_key_rows }}개 있습니다.
|
||||
<button type="button" class="erp-btn erp-btn-outline erp-btn-sm" id="perf-rekey">현재 키로 다시 암호화</button></p>
|
||||
{% endif %}
|
||||
<p class="perf-foot perf-muted">
|
||||
API 인증정보(쇼핑몰·광고)는 서버에서 AES-256-GCM 으로 암호화해 DB 에 저장합니다. 마스터 키(APP_ENCRYPTION_KEY)는 DB 가 아닌
|
||||
서버 환경변수에만 있으며, 키를 잃으면 저장된 인증정보를 복구할 수 없으니 별도로 안전하게 보관하세요.
|
||||
</p>
|
||||
</div>
|
||||
|
||||
<div class="erp-card perf-card">
|
||||
<div class="perf-card-head"><h2 class="perf-h">과거 매출 가져오기</h2></div>
|
||||
<p class="perf-muted">[매출 업데이트]는 최근 며칠만 가져옵니다. 처음 연동했거나 빠진 기간이 있으면 기간을 지정해 한 번에
|
||||
가져오세요(연동된 쇼핑몰만, 최대 366일). 같은 주문은 덮어써서 여러 번 해도 중복되지 않습니다.</p>
|
||||
<div class="perf-sample-form">
|
||||
<input class="erp-input perf-date" type="date" id="perf-backfill-from" value="{{ default_sample_from }}" />
|
||||
<span class="perf-muted">~</span>
|
||||
<input class="erp-input perf-date" type="date" id="perf-backfill-to" value="{{ default_sample_to }}" />
|
||||
<button type="button" class="erp-btn erp-btn-primary" id="perf-backfill">가져오기</button>
|
||||
</div>
|
||||
<div class="perf-notice" id="perf-backfill-result" hidden></div>
|
||||
</div>
|
||||
|
||||
<div class="erp-card perf-card perf-card-wide">
|
||||
<div class="perf-card-head"><h2 class="perf-h">쇼핑몰 원본 데이터 확인</h2></div>
|
||||
<p class="perf-muted">쇼핑몰 API 를 기간(최대 31일)으로 실제 불러, 받은 항목·금액 합계를 보여 줍니다(저장하지 않음).
|
||||
쇼핑몰 관리자 화면에서 매출이 있던 날을 넣고 결과를 알려 주시면 그 항목으로 매출 수집을 맞춥니다.
|
||||
이름·연락처·주소 같은 개인정보는 값을 보이지 않습니다.<br>
|
||||
· <b>네이버</b>: 결제일 기준 상품주문 전체(상태별 합계 포함)와 날짜별 "현재 규칙 매출" — 스마트스토어센터 매출과 비교해 주세요.<br>
|
||||
· <b>11번가</b>: 주문·클레임·정산 조회 주소별 동작 여부. 정산은 정산일 기준일 수 있어 매출이 있던 날부터 넉넉히(예: 3주).<br>
|
||||
· <b>GS샵</b>: 매출 내역·배송비 내역(매출인식일 기준)의 항목별 합계 — 협력사 포털 매출 화면의 같은 기간 숫자와 비교해 주세요.<br>
|
||||
· <b>토스쇼핑</b>: 날짜별 매출·환불·순 거래액(= 저장되는 매출)과 주문 상태별·정산 항목 합계 — 토스쇼핑 파트너스의 같은 날 숫자와 비교해 주세요.<br>
|
||||
· <b>쿠팡(윙)</b>: 판매자배송 발주서 + 로켓그로스 주문을 결제일로 모아 날짜별 매출 후보(할인 전·후, 취소분 뺀 값, 로켓그로스 따로)와 판매량 — WING 비즈니스 인사이트 → 판매분석에서 같은 날짜의 "매출(원)"·"판매량"과 비교해 주세요.</p>
|
||||
<div class="perf-sample-form">
|
||||
<select class="erp-input" id="perf-probe-code" aria-label="쇼핑몰">
|
||||
<option value="naver">네이버</option>
|
||||
<option value="elevenst">11번가</option>
|
||||
<option value="gsshop">GS샵</option>
|
||||
<option value="toss">토스쇼핑</option>
|
||||
<option value="coupang">쿠팡(윙)</option>
|
||||
</select>
|
||||
<input class="erp-input perf-date" type="date" id="perf-probe-date" value="{{ default_sample_to }}" />
|
||||
<span class="perf-muted">~</span>
|
||||
<input class="erp-input perf-date" type="date" id="perf-probe-to" value="{{ default_sample_to }}" />
|
||||
<button type="button" class="erp-btn erp-btn-outline" id="perf-probe">불러오기</button>
|
||||
</div>
|
||||
<div id="perf-probe-result"></div>
|
||||
</div>
|
||||
|
||||
<div class="erp-card perf-card perf-card-wide">
|
||||
<div class="perf-card-head"><h2 class="perf-h">카페24 매출 대조</h2></div>
|
||||
<p class="perf-muted">카페24 관리자 → 통계 → 일별 매출내역과 같은 날짜를 비교합니다. 그날 결제 주문과 환불을 카페24 API 에서
|
||||
바로 합산하며(저장하지 않음), 자체몰과 다른 마켓 연동 주문을 나눠 보여 줍니다.</p>
|
||||
<div class="perf-sample-form">
|
||||
<input class="erp-input perf-date" type="date" id="perf-recon-date" value="{{ default_sample_to }}" />
|
||||
<button type="button" class="erp-btn erp-btn-outline" id="perf-recon">대조</button>
|
||||
</div>
|
||||
<div id="perf-recon-result"></div>
|
||||
|
||||
<h3 class="perf-h" style="margin:18px 0 6px">일별 한 번에 비교</h3>
|
||||
<p class="perf-muted">카페24 일별 매출내역 표를 그대로 복사해 붙여 넣으면 날짜마다 결제합계·환불합계를 저장된 값과 비교합니다.
|
||||
[API 값도 계산]을 켜면 지금 규칙으로 카페24에서 다시 계산한 값(저장 안 함)도 함께 보여 줘, 저장값만 틀린 날(다시 가져오면 해결)과
|
||||
규칙이 틀린 날을 나눠 볼 수 있습니다. 날짜를 누르면 위 대조를 그날로 엽니다.</p>
|
||||
<textarea class="erp-input perf-paste" id="perf-daily-paste" rows="5"
|
||||
placeholder="2026-09-29(화) 47 116 2,475,300 … 2,477,800 158,000 2,319,800"></textarea>
|
||||
<div class="perf-sample-form" style="margin-top:6px">
|
||||
<label class="perf-muted"><input type="checkbox" id="perf-daily-live" /> API 값도 계산(느림)</label>
|
||||
<button type="button" class="erp-btn erp-btn-outline" id="perf-daily-check">비교</button>
|
||||
</div>
|
||||
<div id="perf-daily-result"></div>
|
||||
</div>
|
||||
|
||||
<div class="erp-card perf-card">
|
||||
<div class="perf-card-head"><h2 class="perf-h">테스트 데이터</h2>
|
||||
<span class="perf-muted">현재 {{ "{:,}".format(sample_count) }}건</span></div>
|
||||
<p class="perf-muted">실제 API 연동 전 화면 확인용 모의 매출입니다(사용 중인 쇼핑몰 대상). 실제 데이터와 구분되어 한 번에 지울 수 있습니다.</p>
|
||||
<div class="perf-sample-form">
|
||||
<input class="erp-input perf-date" type="date" id="perf-sample-from" value="{{ default_sample_from }}" />
|
||||
<span class="perf-muted">~</span>
|
||||
<input class="erp-input perf-date" type="date" id="perf-sample-to" value="{{ default_sample_to }}" />
|
||||
<button type="button" class="erp-btn erp-btn-outline" id="perf-sample-gen">생성</button>
|
||||
<button type="button" class="erp-btn erp-btn-danger" id="perf-sample-del"{% if not sample_count %} disabled{% endif %}>모두 삭제</button>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
{% endif %}
|
||||
</section>
|
||||
{% endblock %}
|
||||
|
||||
{% block scripts %}<script src="/static/performance.js?v=20261015b" defer></script>{% endblock %}
|
||||
@@ -0,0 +1,393 @@
|
||||
"""광고비 — 쿠팡(로켓) 광고 보고서 읽기(CSV·엑셀) · 화면 데이터 조립."""
|
||||
|
||||
from __future__ import annotations
|
||||
|
||||
import io
|
||||
from datetime import date
|
||||
from decimal import Decimal
|
||||
|
||||
import openpyxl
|
||||
import pytest
|
||||
|
||||
from app.modules.performance import ad_spend as ads
|
||||
from app.modules.performance.manual_upload import UploadError
|
||||
|
||||
TODAY = date(2026, 10, 13)
|
||||
|
||||
# 사용자 제공 양식(2026-10-13) 그대로 — 머리글, "전체" 합계 줄, 날짜 줄 + 그 아래 캠페인 줄
|
||||
ROCKET_CSV = """날짜,배송유형,부가세 유형,생성자,담당자,광고 유형,광고 목표,캠페인 ID,캠페인명,청구가능 금액 유형,예산 유형,광고 예산,소진 광고비,소진 광고비 중 조정 금액,조정 후 소진 광고비,초과 소진 금액,청구 가능 광고비,부가가치세,청구금액(+부가가치세)
|
||||
전체,RETAIL,,,,,,,,,,,2400506,0,2400506,2396813,2396813,239681,2636494
|
||||
2026년 10월 01일,RETAIL,Taxable,,,,,,,,,,200404,0,200404,200000,200000,20000,220000
|
||||
,,,,VENDOR,PA,매출 성장,103529103,[쿠팡로켓] 스마트AI,Adcost,DAILY_SOFT,200000,200404,0,200404,200000,200000,,
|
||||
2026년 10월 06일,RETAIL,Taxable,,,,,,,,,,196997,0,196997,196997,196997,19700,216697
|
||||
,,,,VENDOR,PA,매출 성장,103529103,[쿠팡로켓] 스마트AI,Adcost,DAILY_SOFT,200000,196997,0,196997,196997,196997,,
|
||||
2026년 10월 12일,RETAIL,Taxable,,,,,,,,,,200210,0,200210,200210,200210,20021,220231
|
||||
,,,,VENDOR,PA,매출 성장,103529103,[쿠팡로켓] 스마트AI,Adcost,DAILY_SOFT,200000,200210,0,200210,200210,200210,,
|
||||
"""
|
||||
|
||||
|
||||
def _xlsx(text: str) -> bytes:
|
||||
wb = openpyxl.Workbook()
|
||||
ws = wb.active
|
||||
for line in text.strip().splitlines():
|
||||
ws.append([int(v) if v.isdigit() else (v or None) for v in line.split(",")])
|
||||
buf = io.BytesIO()
|
||||
wb.save(buf)
|
||||
return buf.getvalue()
|
||||
|
||||
|
||||
@pytest.mark.parametrize("content,name", [
|
||||
(ROCKET_CSV.encode("utf-8-sig"), "report.csv"),
|
||||
(ROCKET_CSV.encode("cp949"), "report.csv"),
|
||||
(_xlsx(ROCKET_CSV), "report.xlsx"),
|
||||
])
|
||||
def test_rocket_report_reads_date_and_col19(content, name):
|
||||
res = ads.parse_coupang_rocket(content, today=TODAY, filename=name)
|
||||
assert not res.errors
|
||||
assert res.entries == [(date(2026, 10, 1), 220000), (date(2026, 10, 6), 216697), (date(2026, 10, 12), 220231)]
|
||||
assert res.skipped == 5 # 머리글 + 전체 + 캠페인 줄 3개
|
||||
|
||||
|
||||
def test_rocket_report_errors_block_everything():
|
||||
bad = ROCKET_CSV + "2026년 13월 40일,RETAIL,,,,,,,,,,,1,0,1,1,1,0,1\n" # 날짜 오류
|
||||
bad += "2026년 10월 08일,RETAIL,,,,,,,,,,,1,0,1,1,1,0,abc\n" # 금액이 숫자 아님
|
||||
bad += "2026년 10월 20일,RETAIL,,,,,,,,,,,1,0,1,1,1,0,5\n" # 앞으로의 날짜
|
||||
res = ads.parse_coupang_rocket(bad.encode("utf-8"), today=TODAY)
|
||||
joined = " / ".join(res.errors)
|
||||
assert len(res.errors) == 3, res.errors
|
||||
assert "날짜를 읽을 수 없습니다" in joined and "숫자가 아닙니다" in joined and "앞으로의 날짜" in joined
|
||||
|
||||
|
||||
def test_coupang_report_date_rows_col19_summed_empty_skipped():
|
||||
"""쿠팡(윙) 보고서처럼 캠페인 줄에도 1열 날짜가 있고 19열이 비어 있어도 — 날짜가 있는 줄의 19열 값만, 같은 날은 더한다
|
||||
(2026-10-14 사용자 확인: "쿠팡은 모두 1열에서 날짜가 있는 행의 19열 값"). 값이 한 줄도 없는 날은 empty_days."""
|
||||
head = ROCKET_CSV.splitlines()[0]
|
||||
wing = "\n".join([
|
||||
head,
|
||||
"2026-03-01,,,,VENDOR,PA,매출 성장,1,캠페인A,Adcost,DAILY_SOFT,1000,10,0,10,0,10,,", # 날짜 있고 19열 빈 줄
|
||||
"2026-03-01,,,,VENDOR,PA,매출 성장,2,캠페인B,Adcost,DAILY_SOFT,1000,20,0,20,0,20,,",
|
||||
"2026-03-01,RETAIL,Taxable,,,,,,,,,,30,0,30,30,30,3,33", # 값 있는 줄
|
||||
"2026-03-01,RETAIL,Tax-free,,,,,,,,,,5,0,5,5,5,0,5", # 같은 날 값 한 줄 더 → 더함
|
||||
"2026-03-02,,,,VENDOR,PA,매출 성장,1,캠페인A,Adcost,DAILY_SOFT,1000,10,0,10,0,10,,", # 값 없는 날
|
||||
"2026-03-03,RETAIL,Taxable,,,,,,,,,,1,0,1,1,1,0,1,100", # 19열 = 1 (20열은 무시)
|
||||
]) + "\n"
|
||||
for content, name in ((wing.encode("utf-8"), "w.csv"), (_xlsx(wing), "w.xlsx")):
|
||||
res = ads.parse_coupang_rocket(content, today=TODAY, filename=name)
|
||||
assert not res.errors, res.errors
|
||||
assert res.entries == [(date(2026, 3, 1), 38), (date(2026, 3, 3), 1)]
|
||||
assert res.empty_days == [date(2026, 3, 2)]
|
||||
# 청구금액이 한 줄도 없는 파일(날짜 줄만) — 오류 없이 넘어감(반영할 날 없음)
|
||||
none = "\n".join([head, "2026-03-01,,,,VENDOR,PA,매출 성장,1,캠페인A,Adcost,DAILY_SOFT,1000,0,0,0,0,0,,",
|
||||
"2026-03-02,,,,VENDOR,PA,매출 성장,1,캠페인A,Adcost,DAILY_SOFT,1000,0,0,0,0,0,,"]) + "\n"
|
||||
r0 = ads.parse_coupang_rocket(_xlsx(none), today=TODAY, filename="march.xlsx")
|
||||
assert r0.entries == [] and not r0.errors and r0.empty_days == [date(2026, 3, 1), date(2026, 3, 2)]
|
||||
m, _ = ads.merge_results([("a.xlsx", 1.0, ads.parse_coupang_rocket(wing.encode("utf-8"), today=TODAY)),
|
||||
("b.csv", 2.0, ads.ParseResult(entries=[(date(2026, 3, 2), 7)]))])
|
||||
assert m.empty_days == [] and dict(m.entries)[date(2026, 3, 2)] == 7 # 다른 파일에 값이 있으면 빈 날 아님
|
||||
|
||||
|
||||
def test_rocket_report_wrong_file():
|
||||
with pytest.raises(UploadError):
|
||||
ads.parse_coupang_rocket(b"", today=TODAY)
|
||||
with pytest.raises(UploadError): # 날짜 줄이 하나도 없음
|
||||
ads.parse_coupang_rocket("날짜,금액\n전체,3\n".encode("utf-8"), today=TODAY)
|
||||
other = ads.parse_coupang_rocket("이름,금액\n홍길동,3\n".encode("utf-8"), today=TODAY) # 다른 양식 → 줄 오류
|
||||
assert not other.entries and "날짜를 읽을 수 없습니다" in other.errors[0]
|
||||
with pytest.raises(UploadError):
|
||||
ads.parse_coupang_rocket(b"PK\x03\x04broken", today=TODAY, filename="x.xlsx")
|
||||
|
||||
|
||||
class _Store:
|
||||
def __init__(self, missing=False):
|
||||
self.missing = missing
|
||||
|
||||
def ad_amounts(self, start, end):
|
||||
if self.missing:
|
||||
raise ads.AdMigrationNeeded()
|
||||
rows = {(date(2026, 10, 1), "coupang_rocket"): (220000, "upload"),
|
||||
(date(2026, 10, 2), "google"): (50000, "manual"),
|
||||
(date(2026, 9, 1), "meta"): (100000, "manual")}
|
||||
rows = {k: v for k, v in rows.items() if start <= k[0] <= end}
|
||||
return {k: v[0] for k, v in rows.items()}, {k: v[1] for k, v in rows.items()}
|
||||
|
||||
def daily_amounts(self, start, end, codes):
|
||||
rows = {(date(2026, 10, 5), "cafe24"): 2_700_000, (date(2026, 10, 1), "coupang_rocket"): 550_000,
|
||||
(date(2026, 10, 3), "coupang_rocket"): 110_000}
|
||||
return {k: v for k, v in rows.items() if start <= k[0] <= end and k[1] in codes}
|
||||
|
||||
|
||||
def test_ad_dashboard_month():
|
||||
ctx = ads.build_ad_dashboard(_Store(), kind="month", anchor=date(2026, 10, 7), today=date(2026, 10, 7),
|
||||
sales_codes=["cafe24"])
|
||||
assert ctx["codes"] == ["google", "meta", "naver", "coupang_wing", "coupang_rocket", "ohouse", "gmarket", "kakao",
|
||||
"gsshop", "elevenst", "lotteon", "toss", "atomy"]
|
||||
k = {x["key"]: x for x in ctx["kpis"]}
|
||||
assert k["spend"]["value"] == 270000 and k["ratio"]["pct"] == 10.0 # 270,000 ÷ 2,700,000
|
||||
assert k["ytd"]["value"] == 370000 and k["mtd"]["value"] == 270000
|
||||
assert ctx["upload_cells"] == ["2026-10-01|coupang_rocket"]
|
||||
assert [c["code"] for c in ctx["upload_channels"]] == ["naver", "coupang_wing", "coupang_rocket"]
|
||||
assert ctx["detail_channels"] == ["google", "naver"] # 구글 = 광고 API 로 가져온 항목(2026-10-15)
|
||||
assert ctx["api_cells"] == []
|
||||
day1 = next(r for r in ctx["table"] if r.get("date") == "2026-10-01")
|
||||
assert day1["cells"]["coupang_rocket"]["gross"] == 220000 and day1["total"]["gross"] == 220000
|
||||
assert ctx["table"][-1]["kind"] == "total" and ctx["table"][-1]["total"]["gross"] == 270000
|
||||
# ROAS = 그 쇼핑몰 매출 ÷ 광고비 — 로켓 10/1: 550,000 ÷ 220,000 = 250%, 구글 10/2: 카페24 그날 매출 0 → 0%
|
||||
assert day1["roas"]["coupang_rocket"] == 250 and day1["roas"]["google"] is None
|
||||
day2 = next(r for r in ctx["table"] if r.get("date") == "2026-10-02")
|
||||
assert day2["roas"]["google"] is None # 구글·메타는 ROAS 계산 안 함(따로 입력)
|
||||
total = ctx["table"][-1]
|
||||
assert total["roas"]["coupang_rocket"] == 300 and total["roas"]["google"] is None # 660,000÷220,000
|
||||
assert total["roas_total"] == 1000 # 2,700,000 ÷ 270,000 (합계 = sales_codes)
|
||||
m = {r["code"]: r for r in ctx["month"]["rows"]}
|
||||
assert m["coupang_rocket"]["roas"] == 300 and m["naver"]["roas"] is None and ctx["month"]["total"]["roas"] == 1000
|
||||
assert ctx["year"]["rows"][9]["roas"] == 1000 and ctx["year"]["rows"][10]["roas"] is None # 11월 = 앞으로
|
||||
assert ctx["roas_basis"]["google"] == "" and ctx["roas_basis"]["coupang_wing"] == "쿠팡(윙)"
|
||||
assert {r["code"]: r for r in ctx["month"]["rows"]}["google"]["roas"] is None
|
||||
assert ads.roas(1, 3) == 33 and ads.roas(1, 200) == 1 and ads.roas(5, 0) is None # 0.5% 반올림 → 1
|
||||
assert ctx["nav"]["quick"][2]["active"] # 이번달
|
||||
|
||||
|
||||
def test_ad_dashboard_year_and_missing_table():
|
||||
ctx = ads.build_ad_dashboard(_Store(), kind="year", anchor=date(2026, 10, 7), today=date(2026, 10, 7))
|
||||
rows = {r["label"]: r for r in ctx["table"]}
|
||||
assert rows["9월"]["total"]["gross"] == 100000 and rows["10월"]["total"]["gross"] == 270000
|
||||
assert {x["key"]: x for x in ctx["kpis"]}["ratio"]["pct"] is None # 매출 없음
|
||||
miss = ads.build_ad_dashboard(_Store(missing=True), kind="week", anchor=date(2026, 10, 7), today=date(2026, 10, 7))
|
||||
assert miss["migration_needed"] and miss["kpis"][0]["value"] == 0
|
||||
|
||||
|
||||
def test_ad_spend_endpoints(monkeypatch):
|
||||
"""라우터: 업로드 정상 → 한 번에 저장(source=upload), 잘못된 줄 → 400 + 목록·저장 안 함, 양식 없는 채널 400,
|
||||
칸 저장(source=manual)·지우기, 모르는 채널 404, 앞으로의 날 400, 005 미적용 503."""
|
||||
import importlib
|
||||
|
||||
from fastapi import FastAPI
|
||||
from fastapi.testclient import TestClient
|
||||
|
||||
from app.modules.performance import common
|
||||
|
||||
perf_router = importlib.import_module("app.modules.performance.router")
|
||||
|
||||
class Store:
|
||||
def __init__(self):
|
||||
self.saved, self.missing = [], False
|
||||
|
||||
def set_ad_spend_bulk(self, code, entries, *, source="manual", user="", roas=None, metrics=None):
|
||||
self.report = (roas, metrics)
|
||||
if self.missing:
|
||||
raise ads.AdMigrationNeeded()
|
||||
self.saved.extend((code, d, a, source) for d, a in entries)
|
||||
return len(entries)
|
||||
|
||||
def set_ad_spend(self, code, day, amount, *, source="manual", user=""):
|
||||
self.set_ad_spend_bulk(code, [(day, amount)], source=source, user=user)
|
||||
|
||||
store = Store()
|
||||
monkeypatch.setattr(common, "require_store", lambda request, admin=False: (store, {"email": "king@x"}))
|
||||
monkeypatch.setattr(perf_router, "today_kst", lambda: TODAY)
|
||||
app = FastAPI()
|
||||
app.include_router(perf_router.router)
|
||||
client = TestClient(app)
|
||||
|
||||
r = client.post("/performance/api/ad-spend/upload?channel=coupang_rocket", files={"file": ("r.csv", ROCKET_CSV.encode("utf-8-sig"))})
|
||||
assert r.status_code == 200, r.text
|
||||
assert r.json()["saved"] == 3 and r.json()["total"] == 220000 + 216697 + 220231 and r.json()["to"] == "2026-10-12"
|
||||
assert store.saved[0] == ("coupang_rocket", date(2026, 10, 1), 220000, "upload")
|
||||
store.saved.clear()
|
||||
r = client.post("/performance/api/ad-spend/upload?channel=coupang_wing", files={"file": ("w.csv", ROCKET_CSV.encode("utf-8-sig"))})
|
||||
assert r.status_code == 200 and r.json()["name"] == "쿠팡(윙)" # 윙도 같은 양식
|
||||
assert store.saved[0] == ("coupang_wing", date(2026, 10, 1), 220000, "upload") and len(store.saved) == 3
|
||||
store.saved.clear()
|
||||
bad = ROCKET_CSV + "2026년 10월 06일,RETAIL,,,,,,,,,,,1,0,1,1,1,0,abc\n"
|
||||
r = client.post("/performance/api/ad-spend/upload?channel=coupang_rocket", files={"file": ("r.csv", bad.encode("utf-8"))})
|
||||
assert r.status_code == 400 and r.json()["errors"] and store.saved == []
|
||||
r = client.post("/performance/api/ad-spend/upload?channel=google", files={"file": ("r.csv", b"x")})
|
||||
assert r.status_code == 400 and "양식" in r.json()["detail"]
|
||||
|
||||
assert client.put("/performance/api/ad-spend/meta/2026-10-12", json={"amount": "33,000"}).json()["amount"] == 33000
|
||||
assert client.put("/performance/api/ad-spend/meta/2026-10-11", json={"amount": ""}).status_code == 200
|
||||
assert store.saved == [("meta", date(2026, 10, 12), 33000, "manual"), ("meta", date(2026, 10, 11), None, "manual")]
|
||||
assert client.put("/performance/api/ad-spend/cafe24/2026-10-12", json={"amount": 1}).status_code == 404
|
||||
assert client.put("/performance/api/ad-spend/meta/2026-10-14", json={"amount": 1}).status_code == 400
|
||||
assert client.put("/performance/api/ad-spend/meta/2026-10-12", json={"amount": "abc"}).status_code == 400
|
||||
store.missing = True
|
||||
r = client.put("/performance/api/ad-spend/meta/2026-10-12", json={"amount": 1})
|
||||
assert r.status_code == 503 and "005" in r.json()["detail"]
|
||||
|
||||
# 사용자 제공 네이버 광고 보고서(2026-10-14) — 앞 9줄 + 머리글
|
||||
NAVER_CSV = """광고 계정 이름,광고 계정 ID,기간,총비용,노출수,클릭수,클릭률(%),총 전환수,구매완료 수,장바구니 담기 수,총 전환매출액,구매완료 광고수익률(%)
|
||||
0_미라네주방,38461,2026.09.30.,0,0,0,0.00,46,6,40,8218000,0.00
|
||||
0_미라네주방,38461,2026.09.24.,0,0,0,0.00,36,6,30,6331500,0.00
|
||||
0_미라네주방,38461,2026.09.23.,300672,30043,461,1.53,71,13,58,7830100,67.58
|
||||
0_미라네주방,38461,2026.09.22.,299817,31061,441,1.42,125,20,105,15040200,198.79
|
||||
0_미라네주방,38461,2026.09.21.,299199,25641,416,1.62,159,44,115,19878020,501.11
|
||||
"""
|
||||
|
||||
|
||||
def test_naver_report_reads_date_cost_roas_and_metrics():
|
||||
for content, name in ((NAVER_CSV.encode("utf-8-sig"), "n.csv"), (NAVER_CSV.encode("cp949"), "n.csv"), (_xlsx(NAVER_CSV), "n.xlsx")):
|
||||
res = ads.parse_naver(content, today=TODAY, filename=name)
|
||||
assert not res.errors, res.errors
|
||||
assert res.entries[:3] == [(date(2026, 9, 30), 0), (date(2026, 9, 24), 0), (date(2026, 9, 23), 300672)]
|
||||
assert str(res.roas[date(2026, 9, 23)]) == "67.58" and res.roas[date(2026, 9, 30)] == 0
|
||||
m = res.metrics[date(2026, 9, 21)]
|
||||
assert m["노출수"] == 25641 and m["클릭률(%)"] == 1.62 and m["총 전환매출액"] == 19878020
|
||||
assert m["구매완료 광고수익률(%)"] == 501.11 and "광고 계정 이름" not in m and "기간" not in m
|
||||
assert res.columns[0] == "총비용" and res.columns[-1] == "구매완료 광고수익률(%)"
|
||||
bad = NAVER_CSV + "0_미라네주방,38461,2026.09.22.,1,0,0,0,0,0,0,0,1\n0_미라네주방,38461,2026.09.20.,abc,0,0,0,0,0,0,0,1\n"
|
||||
bad += "0_미라네주방,38461,2026.09.19.,5,0,0,0,0,0,0,0,x\n0_미라네주방,38461,2026.10.20.,5,0,0,0,0,0,0,0,1\n"
|
||||
errs = " / ".join(ads.parse_naver(bad.encode("utf-8"), today=TODAY).errors)
|
||||
assert "겹칩니다" in errs and "총비용이 숫자가 아닙니다" in errs and "ROAS" in errs and "앞으로의 날짜" in errs
|
||||
|
||||
|
||||
def test_naver_roas_from_report_weighted():
|
||||
"""네이버 칸 ROAS = 보고서 값(계산 안 함), 여러 날 = Σ(ROAS×광고비)÷Σ광고비, 광고비 0 인 날은 빼고."""
|
||||
class S(_Store):
|
||||
def ad_amounts(self, start, end):
|
||||
rows = {(date(2026, 9, 22), "naver"): 299817, (date(2026, 9, 23), "naver"): 300672,
|
||||
(date(2026, 9, 24), "naver"): 0}
|
||||
rows = {k: v for k, v in rows.items() if start <= k[0] <= end}
|
||||
return rows, {k: "upload" for k in rows}
|
||||
|
||||
def ad_roas(self, start, end):
|
||||
rows = {(date(2026, 9, 22), "naver"): Decimal("198.79"), (date(2026, 9, 23), "naver"): Decimal("67.58"),
|
||||
(date(2026, 9, 24), "naver"): Decimal("0")}
|
||||
return {k: v for k, v in rows.items() if start <= k[0] <= end}
|
||||
|
||||
def daily_amounts(self, start, end, codes):
|
||||
return {(date(2026, 9, 22), "naver"): 9_999_999} if "naver" in codes else {}
|
||||
|
||||
ctx = ads.build_ad_dashboard(S(), kind="week", anchor=date(2026, 9, 23), today=TODAY, sales_codes=["naver"])
|
||||
by = {r.get("date"): r for r in ctx["table"]}
|
||||
assert by["2026-09-22"]["roas"]["naver"] == 199 and by["2026-09-23"]["roas"]["naver"] == 68
|
||||
assert by["2026-09-24"]["roas"]["naver"] is None # 광고비 0
|
||||
week = next(r for r in ctx["table"] if r["kind"] == "week")
|
||||
want = round((Decimal("198.79") * 299817 + Decimal("67.58") * 300672) / (299817 + 300672))
|
||||
assert week["roas"]["naver"] == want == 133 # 매출 실적(9,999,999)으로 계산하지 않음
|
||||
assert ctx["roas_basis"]["naver"] == ""
|
||||
assert {r["code"]: r for r in ctx["month"]["rows"]}["naver"]["roas"] == 133
|
||||
|
||||
|
||||
def test_naver_detail_table_totals():
|
||||
rows = [{"date": "2026-09-22", "amount": 299817, "roas": Decimal("198.79"),
|
||||
"metrics": {"총비용": 299817, "노출수": 31061, "클릭수": 441, "클릭률(%)": 1.42, "구매완료 광고수익률(%)": 198.79}},
|
||||
{"date": "2026-09-23", "amount": 300672, "roas": Decimal("67.58"),
|
||||
"metrics": {"총비용": 300672, "노출수": 30043, "클릭수": 461, "클릭률(%)": 1.53, "구매완료 광고수익률(%)": 67.58}},
|
||||
{"date": "2026-09-24", "amount": 0, "roas": Decimal("0"), "metrics": {"총비용": 0, "노출수": 0, "클릭수": 0,
|
||||
"클릭률(%)": 0.0, "구매완료 광고수익률(%)": 0}}]
|
||||
t = ads.detail_table(rows)
|
||||
assert t["columns"] == ["총비용", "노출수", "클릭수", "클릭률(%)", "구매완료 광고수익률(%)"]
|
||||
assert t["total"]["총비용"] == 600489 and t["total"]["노출수"] == 61104 and t["total"]["클릭수"] == 902
|
||||
assert t["total"]["클릭률(%)"] == round(902 * 100 / 61104, 2) # 가중: 클릭수 ÷ 노출수
|
||||
assert t["total"]["구매완료 광고수익률(%)"] == 133.09 # 광고비 가중 평균 (198.79×299,817 + 67.58×300,672) ÷ 600,489
|
||||
assert t["rows"][0]["values"]["노출수"] == 31061 and t["rows"][1]["roas"] == 67.58
|
||||
|
||||
|
||||
def test_naver_upload_and_details_endpoints(monkeypatch):
|
||||
import importlib
|
||||
|
||||
from fastapi import FastAPI
|
||||
from fastapi.testclient import TestClient
|
||||
|
||||
from app.modules.performance import common
|
||||
|
||||
perf_router = importlib.import_module("app.modules.performance.router")
|
||||
|
||||
class Store:
|
||||
def __init__(self):
|
||||
self.saved, self.kw, self.missing = [], {}, ""
|
||||
|
||||
def set_ad_spend_bulk(self, code, entries, *, source="manual", user="", roas=None, metrics=None):
|
||||
if self.missing:
|
||||
raise ads.AdMigrationNeeded(self.missing)
|
||||
self.saved.extend((code, d, a, source) for d, a in entries)
|
||||
self.kw = {"roas": roas, "metrics": metrics}
|
||||
return len(entries)
|
||||
|
||||
def ad_details(self, code, start, end):
|
||||
if self.missing:
|
||||
raise ads.AdMigrationNeeded(self.missing)
|
||||
return [{"date": "2026-09-23", "amount": 300672, "roas": Decimal("67.58"), "metrics": {"노출수": 30043}}]
|
||||
|
||||
store = Store()
|
||||
monkeypatch.setattr(common, "require_store", lambda request, admin=False: (store, {"email": "king@x"}))
|
||||
monkeypatch.setattr(perf_router, "today_kst", lambda: TODAY)
|
||||
app = FastAPI()
|
||||
app.include_router(perf_router.router)
|
||||
client = TestClient(app)
|
||||
r = client.post("/performance/api/ad-spend/upload?channel=naver", files={"file": ("n.csv", NAVER_CSV.encode("utf-8-sig"))})
|
||||
assert r.status_code == 200, r.text
|
||||
assert r.json()["saved"] == 5 and r.json()["total"] == 300672 + 299817 + 299199
|
||||
assert store.saved[2] == ("naver", date(2026, 9, 23), 300672, "upload")
|
||||
assert str(store.kw["roas"][date(2026, 9, 23)]) == "67.58" and store.kw["metrics"][date(2026, 9, 21)]["클릭수"] == 416
|
||||
store.saved.clear()
|
||||
r = client.post("/performance/api/ad-spend/upload?channel=coupang_rocket", files={"file": ("r.csv", ROCKET_CSV.encode("utf-8-sig"))})
|
||||
assert r.status_code == 200 and store.kw == {"roas": None, "metrics": None} # 쿠팡은 금액만
|
||||
d = client.get("/performance/api/ad-spend/naver/details?from=2026-09-01&to=2026-09-30").json()
|
||||
assert d["name"] == "네이버" and d["columns"] == ["노출수"] and d["rows"][0]["roas"] == 67.58
|
||||
assert client.get("/performance/api/ad-spend/coupang_rocket/details?from=2026-09-01&to=2026-09-30").status_code == 400
|
||||
assert client.get("/performance/api/ad-spend/naver/details?from=2026-09-30&to=2026-09-01").status_code == 400
|
||||
store.missing = "006"
|
||||
r = client.post("/performance/api/ad-spend/upload?channel=naver", files={"file": ("n.csv", NAVER_CSV.encode("utf-8"))})
|
||||
assert r.status_code == 503 and "006" in r.json()["detail"]
|
||||
assert "006" in client.get("/performance/api/ad-spend/naver/details?from=2026-09-01&to=2026-09-30").json()["detail"]
|
||||
|
||||
|
||||
def test_merge_results_newest_file_wins():
|
||||
"""여러 파일 — 같은 날짜는 파일 날짜(수정 시각)가 최신인 파일 값, 같으면 나중 파일. ROAS·상세도 그 파일 것."""
|
||||
a = ads.ParseResult(entries=[(date(2026, 9, 1), 100), (date(2026, 9, 2), 200)],
|
||||
roas={date(2026, 9, 2): Decimal("10")}, metrics={date(2026, 9, 2): {"노출수": 1}}, columns=["노출수"])
|
||||
b = ads.ParseResult(entries=[(date(2026, 9, 2), 999), (date(2026, 9, 3), 300)],
|
||||
roas={date(2026, 9, 2): Decimal("99")}, metrics={date(2026, 9, 2): {"노출수": 9}}, columns=["노출수", "클릭수"])
|
||||
m, overlap = ads.merge_results([("new.csv", 2000.0, a), ("old.csv", 1000.0, b)]) # a 가 최신
|
||||
assert m.entries == [(date(2026, 9, 1), 100), (date(2026, 9, 2), 200), (date(2026, 9, 3), 300)]
|
||||
assert m.roas[date(2026, 9, 2)] == Decimal("10") and m.metrics[date(2026, 9, 2)] == {"노출수": 1}
|
||||
assert overlap == [date(2026, 9, 2)] and m.columns == ["노출수", "클릭수"]
|
||||
m2, _ = ads.merge_results([("a.csv", 1000.0, a), ("b.csv", 1000.0, b)]) # 같은 시각 → 나중 파일
|
||||
assert dict(m2.entries)[date(2026, 9, 2)] == 999
|
||||
bad = ads.ParseResult(errors=["3행: 오류"])
|
||||
m3, _ = ads.merge_results([("a.csv", 1.0, a), ("bad.csv", 2.0, bad)])
|
||||
assert m3.errors == ["[bad.csv] 3행: 오류"]
|
||||
|
||||
|
||||
def test_upload_multiple_files_endpoint(monkeypatch):
|
||||
import importlib
|
||||
|
||||
from fastapi import FastAPI
|
||||
from fastapi.testclient import TestClient
|
||||
|
||||
from app.modules.performance import common
|
||||
|
||||
perf_router = importlib.import_module("app.modules.performance.router")
|
||||
|
||||
class Store:
|
||||
saved: list = []
|
||||
|
||||
def set_ad_spend_bulk(self, code, entries, *, source="manual", user="", roas=None, metrics=None):
|
||||
self.saved = list(entries)
|
||||
self.roas = roas
|
||||
return len(entries)
|
||||
|
||||
store = Store()
|
||||
monkeypatch.setattr(common, "require_store", lambda request, admin=False: (store, {"email": "king@x"}))
|
||||
monkeypatch.setattr(perf_router, "today_kst", lambda: TODAY)
|
||||
app = FastAPI()
|
||||
app.include_router(perf_router.router)
|
||||
client = TestClient(app)
|
||||
old = NAVER_CSV
|
||||
new = NAVER_CSV.replace("2026.09.23.,300672", "2026.09.23.,111111").replace(",67.58", ",12.34")
|
||||
files = [("files", ("new.csv", new.encode("utf-8"))), ("files", ("old.csv", old.encode("utf-8")))]
|
||||
r = client.post("/performance/api/ad-spend/upload?channel=naver", files=files, data={"modified": ["2000", "1000"]})
|
||||
assert r.status_code == 200, r.text
|
||||
body = r.json()
|
||||
assert body["files"] == 2 and body["overlap_days"] == 5 and body["saved"] == 5
|
||||
assert dict(store.saved)[date(2026, 9, 23)] == 111111 and str(store.roas[date(2026, 9, 23)]) == "12.34" # 최신 파일
|
||||
r = client.post("/performance/api/ad-spend/upload?channel=naver", files=files, data={"modified": ["1000", "2000"]})
|
||||
assert dict(store.saved)[date(2026, 9, 23)] == 300672 # 이번엔 old 가 최신
|
||||
bad = NAVER_CSV + "0_미라네주방,38461,2026.09.20.,abc,0,0,0,0,0,0,0,1\n"
|
||||
r = client.post("/performance/api/ad-spend/upload?channel=naver",
|
||||
files=[("files", ("ok.csv", old.encode("utf-8"))), ("files", ("bad.csv", bad.encode("utf-8")))])
|
||||
assert r.status_code == 400 and r.json()["errors"][0].startswith("[bad.csv]")
|
||||
r = client.post("/performance/api/ad-spend/upload?channel=naver", files={"file": ("one.csv", old.encode("utf-8"))})
|
||||
assert r.status_code == 200 and r.json()["files"] == 1 # 예전 file 한 개도
|
||||
assert client.post("/performance/api/ad-spend/upload?channel=naver").status_code in (400, 422)
|
||||
@@ -0,0 +1,69 @@
|
||||
"""매출 자동 업데이트 — 회차 시각 계산·건너뛰기."""
|
||||
|
||||
from __future__ import annotations
|
||||
|
||||
from datetime import date, datetime, timedelta, timezone
|
||||
|
||||
from app.modules.performance import auto_sync as au
|
||||
|
||||
KST = timezone(timedelta(hours=9))
|
||||
H = (9, 19)
|
||||
|
||||
|
||||
def _t(h, m, d=13):
|
||||
return datetime(2026, 10, d, h, m, tzinfo=KST)
|
||||
|
||||
|
||||
def test_slots_every_half_hour_9_to_19():
|
||||
slots = [t for t in (_t(0, 0) + timedelta(minutes=30 * i) for i in range(48)) if au.is_slot(t, H)]
|
||||
assert slots[0] == _t(9, 0) and slots[-1] == _t(19, 0) and len(slots) == 21
|
||||
assert not au.is_slot(_t(19, 30), H) and not au.is_slot(_t(8, 30), H) and not au.is_slot(_t(10, 15), H)
|
||||
|
||||
|
||||
def test_next_slot():
|
||||
assert au.next_slot(_t(8, 10), H) == _t(9, 0)
|
||||
assert au.next_slot(_t(9, 0), H) == _t(9, 30) # 지금 회차는 이미 지남 → 다음
|
||||
assert au.next_slot(datetime(2026, 10, 13, 9, 29, 59, tzinfo=KST), H) == _t(9, 30)
|
||||
assert au.next_slot(_t(18, 45), H) == _t(19, 0)
|
||||
assert au.next_slot(_t(19, 0), H) == _t(9, 0, d=14) # 저녁 이후 → 다음 날 9시
|
||||
assert au.next_slot(_t(23, 59), H) == _t(9, 0, d=14)
|
||||
|
||||
|
||||
def test_env_parsing(monkeypatch):
|
||||
monkeypatch.delenv("PERFORMANCE_AUTO_SYNC", raising=False)
|
||||
monkeypatch.delenv("PERFORMANCE_AUTO_SYNC_DAYS", raising=False)
|
||||
monkeypatch.delenv("PERFORMANCE_AUTO_SYNC_HOURS", raising=False)
|
||||
assert au.enabled() and au.sync_days() == 10 and au.hour_window() == (9, 19)
|
||||
monkeypatch.setenv("PERFORMANCE_AUTO_SYNC", "false")
|
||||
monkeypatch.setenv("PERFORMANCE_AUTO_SYNC_DAYS", "200")
|
||||
monkeypatch.setenv("PERFORMANCE_AUTO_SYNC_HOURS", "20-8") # 잘못된 값 → 기본
|
||||
assert not au.enabled() and au.sync_days() == 90 and au.hour_window() == (9, 19)
|
||||
monkeypatch.setenv("PERFORMANCE_AUTO_SYNC_HOURS", "8-20")
|
||||
assert au.hour_window() == (8, 20)
|
||||
|
||||
|
||||
def test_run_once_uses_job_and_skips_when_busy(monkeypatch):
|
||||
from app.modules.performance import jobs
|
||||
from app.modules.performance.sync import SyncService
|
||||
|
||||
calls = []
|
||||
|
||||
def fake_sync_all(self, *, start, end, codes=None, trigger="manual", user="", job=None):
|
||||
calls.append((start, end, trigger, user, job is not None))
|
||||
return [{"code": "naver", "ok": True}, {"code": "toss", "ok": False, "skipped": False}]
|
||||
|
||||
class Store:
|
||||
def last_update_at(self):
|
||||
return "2026-10-13T09:00:05+09:00"
|
||||
|
||||
monkeypatch.setattr(SyncService, "sync_all", fake_sync_all)
|
||||
monkeypatch.setattr(jobs, "running_job", lambda: None)
|
||||
res = au.run_once(Store(), None, today=date(2026, 10, 13), days=10)
|
||||
assert calls == [(date(2026, 10, 4), date(2026, 10, 13), "schedule", au.AUTO_USER, True)]
|
||||
# 광고 API 저장소 메서드가 없는 가짜 저장소 — 광고 가져오기는 조용히 빠지고 매출 결과는 그대로
|
||||
assert res == {"skipped": False, "from": "2026-10-04", "to": "2026-10-13", "ok": 1, "failed": ["toss"], "error": "",
|
||||
"ads": []}
|
||||
|
||||
monkeypatch.setattr(jobs, "running_job", lambda: object())
|
||||
assert au.run_once(Store(), None, today=date(2026, 10, 13), days=10)["skipped"]
|
||||
assert len(calls) == 1
|
||||
@@ -0,0 +1,91 @@
|
||||
"""쿠팡 발주서 — 504(시간 초과)면 조회 구간을 반으로 줄여 다시 부른다."""
|
||||
|
||||
from __future__ import annotations
|
||||
|
||||
from datetime import date, timedelta
|
||||
|
||||
import pytest
|
||||
|
||||
from app.modules.performance.adapters import coupang as cp
|
||||
from app.modules.performance.adapters.base import AdapterContext, ApiError
|
||||
|
||||
|
||||
class Creds:
|
||||
def get(self, key):
|
||||
return {"vendor_id": "A001", "access_key": "ak", "secret_key": "sk"}[key]
|
||||
|
||||
def has(self, key):
|
||||
return True
|
||||
|
||||
|
||||
def _ctx():
|
||||
return AdapterContext(code="coupang", credentials=Creds())
|
||||
|
||||
|
||||
def _days(params):
|
||||
a = date.fromisoformat(params["createdAtFrom"][:10])
|
||||
b = date.fromisoformat(params["createdAtTo"][:10])
|
||||
return a, b
|
||||
|
||||
|
||||
def test_seller_window_halves_on_timeout_and_remembers(monkeypatch):
|
||||
calls = []
|
||||
|
||||
def fake_pages(self, ctx, path, params, *, rg=False):
|
||||
a, b = _days(params)
|
||||
calls.append((params["status"], a, b))
|
||||
if params["status"] == "FINAL_DELIVERY" and (b - a).days + 1 > 7:
|
||||
raise cp.GatewayTimeout("쿠팡 발주서 API 오류(504): Request timed out")
|
||||
return [{"orderId": f"{params['status']}-{a}-{b}"}]
|
||||
|
||||
monkeypatch.setattr(cp.CoupangAdapter, "_pages", fake_pages)
|
||||
ad = cp.CoupangAdapter()
|
||||
start, end = date(2026, 1, 1), date(2026, 3, 31) # 주문일 2025-12-31 ~ 3-31 = 91일 → 31일 구간 3개
|
||||
ad._seller_orders(_ctx(), start, end)
|
||||
|
||||
fd = [(a, b) for st, a, b in calls if st == "FINAL_DELIVERY"]
|
||||
ok = [(a, b) for a, b in fd if (b - a).days + 1 <= 7]
|
||||
# 성공한 구간이 빈틈·겹침 없이 전체 주문일을 덮는다
|
||||
d = start - timedelta(days=1)
|
||||
for a, b in ok:
|
||||
assert a == d
|
||||
d = b + timedelta(days=1)
|
||||
assert d == end + timedelta(days=1)
|
||||
# 31 → 15 → 7 로 줄인 뒤엔 다음 31일 구간도 처음부터 7일로(실패는 첫 구간의 두 번뿐)
|
||||
assert len(fd) - len(ok) == 2
|
||||
# 다른 상태는 31일 그대로
|
||||
assert sum(1 for st, a, b in calls if st == "ACCEPT") == 3
|
||||
|
||||
|
||||
def test_one_day_timeout_retries_then_fails(monkeypatch):
|
||||
sleeps = []
|
||||
monkeypatch.setattr(cp.time, "sleep", lambda s: sleeps.append(s))
|
||||
|
||||
def fake_pages(self, ctx, path, params, *, rg=False):
|
||||
if params["status"] == "FINAL_DELIVERY":
|
||||
raise cp.GatewayTimeout("쿠팡 발주서 API 오류(504): Request timed out")
|
||||
return []
|
||||
|
||||
monkeypatch.setattr(cp.CoupangAdapter, "_pages", fake_pages)
|
||||
with pytest.raises(ApiError) as ei:
|
||||
cp.CoupangAdapter()._seller_orders(_ctx(), date(2026, 1, 5), date(2026, 1, 5))
|
||||
assert "하루도 시간 초과" in ei.value.message and "FINAL_DELIVERY" in ei.value.message
|
||||
assert sleeps == [3.0, 6.0]
|
||||
|
||||
|
||||
def test_rg_window_halves_on_timeout(monkeypatch):
|
||||
got = []
|
||||
|
||||
def fake_pages(self, ctx, path, params, *, rg=False):
|
||||
a = date(int(params["paidDateFrom"][:4]), int(params["paidDateFrom"][4:6]), int(params["paidDateFrom"][6:]))
|
||||
b = date(int(params["paidDateTo"][:4]), int(params["paidDateTo"][4:6]), int(params["paidDateTo"][6:]))
|
||||
if (b - a).days + 1 > 10:
|
||||
raise cp.GatewayTimeout("쿠팡 로켓그로스 주문 API 오류(504)")
|
||||
got.append((a, b))
|
||||
return [{"orderId": str(a)}]
|
||||
|
||||
monkeypatch.setattr(cp.CoupangAdapter, "_pages", fake_pages)
|
||||
cp.CoupangAdapter()._rg_orders(_ctx(), date(2026, 1, 1), date(2026, 1, 30))
|
||||
assert got[0][0] == date(2026, 1, 1) and got[-1][1] == date(2026, 1, 30)
|
||||
assert all((b - a).days + 1 <= 10 for a, b in got)
|
||||
assert all(got[i + 1][0] == got[i][1] + timedelta(days=1) for i in range(len(got) - 1))
|
||||
@@ -0,0 +1,315 @@
|
||||
"""구글 광고 API 연동(2026-10-15) — 입력 검사·토큰·조회·변환·오류 안내·저장 서비스·라우터. 구글 서버는 가짜(httpx MockTransport)."""
|
||||
|
||||
from __future__ import annotations
|
||||
|
||||
import json
|
||||
from datetime import date
|
||||
from decimal import Decimal
|
||||
from urllib.parse import parse_qs
|
||||
|
||||
import httpx
|
||||
import pytest
|
||||
from cryptography.hazmat.primitives import serialization
|
||||
from cryptography.hazmat.primitives.asymmetric import rsa
|
||||
|
||||
from app.modules.performance import ad_sync
|
||||
from app.modules.performance.ad_sources import google_ads as ga
|
||||
from app.modules.performance.adapters.base import AdapterContext, ApiError, AuthFailed, NotConfigured
|
||||
from app.modules.performance.credentials import CredentialService, aad_for
|
||||
from app.modules.performance.security import crypto
|
||||
|
||||
KEY1 = "11" * 32
|
||||
|
||||
|
||||
def _sa_json() -> str:
|
||||
key = rsa.generate_private_key(public_exponent=65537, key_size=2048)
|
||||
pem = key.private_bytes(serialization.Encoding.PEM, serialization.PrivateFormat.PKCS8,
|
||||
serialization.NoEncryption()).decode()
|
||||
return json.dumps({"type": "service_account", "client_email": "erp@proj.iam.gserviceaccount.com",
|
||||
"private_key_id": "kid1", "private_key": pem, "token_uri": "https://oauth2.googleapis.com/token"})
|
||||
|
||||
|
||||
SA = _sa_json()
|
||||
|
||||
|
||||
class Creds:
|
||||
def __init__(self, values):
|
||||
self.values = values
|
||||
|
||||
def get(self, key):
|
||||
return self.values.get(key, "")
|
||||
|
||||
def has(self, key):
|
||||
return bool(self.values.get(key))
|
||||
|
||||
def set(self, key, value):
|
||||
self.values[key] = value
|
||||
|
||||
def known_secrets(self):
|
||||
return [v for v in self.values.values() if v]
|
||||
|
||||
|
||||
def _ctx(**over):
|
||||
values = {"customer_id": "123-456-7890", "service_account_json": SA}
|
||||
values.update(over)
|
||||
return AdapterContext(code="google", credentials=Creds(values))
|
||||
|
||||
|
||||
def _install(monkeypatch, handler):
|
||||
"""구글(토큰·광고 API) 가짜 서버 — handler(request) 가 searchStream 응답을 만든다. 보낸 요청을 돌려준다."""
|
||||
ga._token_cache.clear()
|
||||
seen = []
|
||||
|
||||
def route(request: httpx.Request) -> httpx.Response:
|
||||
seen.append(request)
|
||||
if request.url.host == "oauth2.googleapis.com":
|
||||
form = parse_qs(request.content.decode())
|
||||
assert form["grant_type"] == ["urn:ietf:params:oauth:grant-type:jwt-bearer"] and form["assertion"][0].count(".") == 2
|
||||
return httpx.Response(200, json={"access_token": "ya29.TOKEN", "expires_in": 3600})
|
||||
return handler(request)
|
||||
|
||||
monkeypatch.setattr(ga, "_http", lambda ctx: httpx.Client(transport=httpx.MockTransport(route)))
|
||||
return seen
|
||||
|
||||
|
||||
ROWS = [{"results": [
|
||||
{"customer": {"currencyCode": "KRW"}, "segments": {"date": "2026-10-01"},
|
||||
"metrics": {"costMicros": "123456500000", "impressions": "20000", "clicks": "400", "conversions": 12.5,
|
||||
"conversionsValue": 617282.5}},
|
||||
{"customer": {"currencyCode": "KRW"}, "segments": {"date": "2026-10-02"},
|
||||
"metrics": {"impressions": "50"}}, # 비용 0(값이 빠진 칸)
|
||||
]}, {"results": [
|
||||
{"customer": {"currencyCode": "KRW"}, "segments": {"date": "2026-10-03"},
|
||||
"metrics": {"costMicros": "1000000", "clicks": "1", "impressions": "10", "conversionsValue": 3000}},
|
||||
]}]
|
||||
|
||||
|
||||
def test_validate_credentials():
|
||||
src = ga.GoogleAdsSource()
|
||||
ok = {"customer_id": "123-456-7890", "service_account_json": SA}
|
||||
assert src.validate_credentials(ok) == []
|
||||
assert src.validate_credentials({**ok, "service_account_json": "__stored__"}) == []
|
||||
assert "developer_token" not in {f.key for f in src.visible_fields()} # 개발자 토큰 폐지(2026-09-09) — 입력칸 없음
|
||||
errs = src.validate_credentials({**ok, "customer_id": "12345", "login_customer_id": "abc", "api_version": "26",
|
||||
"service_account_json": '{"type": "authorized_user"}'})
|
||||
assert len(errs) == 4 and not any("BEGIN" in e for e in errs) # 키 내용은 문구에 없음
|
||||
assert "입력하세요" in " ".join(src.validate_credentials({}))
|
||||
assert "JSON" in " ".join(src.validate_credentials({**ok, "service_account_json": "not json"}))
|
||||
|
||||
|
||||
def test_fetch_days_converts_and_sends_headers(monkeypatch):
|
||||
seen = _install(monkeypatch, lambda req: httpx.Response(200, json=ROWS))
|
||||
days = ga.GoogleAdsSource().fetch_days(_ctx(login_customer_id="999-888-7777", api_version="v27"),
|
||||
date(2026, 10, 1), date(2026, 10, 3))
|
||||
api = seen[-1]
|
||||
assert str(api.url) == "https://googleads.googleapis.com/v27/customers/1234567890/googleAds:searchStream"
|
||||
assert api.headers["Authorization"] == "Bearer ya29.TOKEN" and "developer-token" not in api.headers # 폐지된 머리글은 보내지 않음
|
||||
assert api.headers["login-customer-id"] == "9998887777"
|
||||
q = json.loads(api.content)["query"]
|
||||
assert "segments.date BETWEEN '2026-10-01' AND '2026-10-03'" in q and "metrics.conversions_value" in q
|
||||
d1, d2, d3 = days
|
||||
# 광고비 = 부가세 포함(2026-10-15): 123,456.5원 × 1.1 = 135,802.15 → 135,802. ROAS 는 구글 값 그대로(617,282.5 ÷ 123,456.5)
|
||||
assert (d1.day, d1.amount, d1.roas) == (date(2026, 10, 1), 135802, Decimal("500.00"))
|
||||
assert d1.metrics == {"광고비(부가세 포함)": 135802, "비용(부가세 별도)": 123457, "노출수": 20000, "클릭수": 400,
|
||||
"클릭률(%)": 2.0, "전환수": 12.5, "전환 가치": 617283, "ROAS(%)": 500.0}
|
||||
assert list(d1.metrics)[:2] == ["광고비(부가세 포함)", "비용(부가세 별도)"] # 일자별 표 열 순서
|
||||
assert (d2.amount, d2.roas, d2.metrics["클릭률(%)"]) == (0, None, 0.0) # 비용 0 → ROAS 없음
|
||||
assert (d3.amount, d3.roas) == (1, Decimal("300000.00"))
|
||||
# 토큰은 한 번만 받아 두고 다시 쓴다
|
||||
ga.GoogleAdsSource().fetch_days(_ctx(), date(2026, 10, 1), date(2026, 10, 1))
|
||||
assert sum(1 for r in seen if r.url.host == "oauth2.googleapis.com") == 1
|
||||
assert "login-customer-id" not in seen[-1].headers and "/v26/" in str(seen[-1].url) # 비우면 MCC 없음·기본 버전
|
||||
|
||||
|
||||
def test_errors_are_explained(monkeypatch):
|
||||
src = ga.GoogleAdsSource()
|
||||
denied = [{"error": {"code": 403, "message": "The caller does not have permission", "status": "PERMISSION_DENIED",
|
||||
"details": [{"errors": [{"errorCode": {"authorizationError": "USER_PERMISSION_DENIED"},
|
||||
"message": "User doesn't have permission to access customer."}]}]}}]
|
||||
_install(monkeypatch, lambda req: httpx.Response(403, json=denied))
|
||||
with pytest.raises(AuthFailed) as e:
|
||||
src.fetch_days(_ctx(), date(2026, 10, 1), date(2026, 10, 1))
|
||||
assert "USER_PERMISSION_DENIED" in e.value.message and "액세스 및 보안" in e.value.message
|
||||
|
||||
# 사용자 화면 오류(2026-10-15): 로그인 고객 ID(MCC) 칸에 권한 없는 번호 → 칸을 비우라는 안내
|
||||
bad_login = [{"error": {"code": 403, "message": "PERMISSION_DENIED", "details": [{"errors": [
|
||||
{"errorCode": {"authorizationError": "INVALID_LOGIN_CUSTOMER_ID"},
|
||||
"message": "The login customer id header 'Optional[9998887777]' could not be validated."}]}]}}]
|
||||
_install(monkeypatch, lambda req: httpx.Response(403, json=bad_login))
|
||||
with pytest.raises(AuthFailed) as e:
|
||||
src.fetch_days(_ctx(login_customer_id="999-888-7777"), date(2026, 10, 1), date(2026, 10, 1))
|
||||
assert "INVALID_LOGIN_CUSTOMER_ID" in e.value.message and "칸을 지우고" in e.value.message
|
||||
|
||||
_install(monkeypatch, lambda req: httpx.Response(404, text="Not Found"))
|
||||
with pytest.raises(ApiError) as e:
|
||||
src.fetch_days(_ctx(api_version="v19"), date(2026, 10, 1), date(2026, 10, 1))
|
||||
assert "v19" in e.value.message and "API 버전" in e.value.message
|
||||
|
||||
usd = [{"results": [{"customer": {"currencyCode": "USD"}, "segments": {"date": "2026-10-01"}, "metrics": {}}]}]
|
||||
_install(monkeypatch, lambda req: httpx.Response(200, json=usd))
|
||||
with pytest.raises(ApiError, match="USD"):
|
||||
src.fetch_days(_ctx(), date(2026, 10, 1), date(2026, 10, 1))
|
||||
|
||||
with pytest.raises(NotConfigured):
|
||||
src.fetch_days(_ctx(customer_id=""), date(2026, 10, 1), date(2026, 10, 1))
|
||||
|
||||
ga._token_cache.clear()
|
||||
|
||||
def bad_token(request):
|
||||
return httpx.Response(400, json={"error": "invalid_grant", "error_description": "Invalid JWT Signature."})
|
||||
|
||||
monkeypatch.setattr(ga, "_http", lambda ctx: httpx.Client(transport=httpx.MockTransport(bad_token)))
|
||||
with pytest.raises(AuthFailed, match="invalid_grant"):
|
||||
src.fetch_days(_ctx(), date(2026, 10, 1), date(2026, 10, 1))
|
||||
|
||||
|
||||
def test_connection_message(monkeypatch):
|
||||
body = [{"results": [{"customer": {"id": "1234567890", "descriptiveName": "미라네주방", "currencyCode": "KRW",
|
||||
"timeZone": "Asia/Seoul"}}]}]
|
||||
_install(monkeypatch, lambda req: httpx.Response(200, json=body))
|
||||
assert ga.GoogleAdsSource().test_connection(_ctx()) == "연결됨 — 미라네주방 · 통화 KRW · 시간대 Asia/Seoul"
|
||||
|
||||
|
||||
def test_ad_credentials_use_own_namespace():
|
||||
"""광고 인증정보 암호문은 "perf:ad:{채널}:{항목}" 에 묶인다 — 쇼핑몰 암호문과 바꿔 넣으면 복호화되지 않는다."""
|
||||
ring = crypto.KeyRing.from_env({"APP_ENCRYPTION_KEY": KEY1})
|
||||
|
||||
class Table:
|
||||
def __init__(self):
|
||||
self.rows = {}
|
||||
|
||||
def credential_rows(self, code):
|
||||
return {k: {"encrypted_value": v, "key_version": 1} for (c, k), v in self.rows.items() if c == code}
|
||||
|
||||
def upsert_credential(self, code, key, *, encrypted_value, key_version, user=""):
|
||||
self.rows[(code, key)] = encrypted_value
|
||||
|
||||
t = Table()
|
||||
svc = CredentialService(t, lambda: ring, aad_ns=ad_sync.AD_NS)
|
||||
svc.save(ga.GoogleAdsSource(), {"service_account_json": SA, "customer_id": "1234567890"}, user="king")
|
||||
assert svc.accessor("google").get("service_account_json") == SA
|
||||
assert aad_for("google", "service_account_json", "ad:") == "perf:ad:google:service_account_json"
|
||||
with pytest.raises(Exception):
|
||||
crypto.decrypt(t.rows[("google", "service_account_json")], aad=aad_for("google", "service_account_json"), ring=ring)
|
||||
# 저장된 일반 항목을 화면에서 비우고 [연결 테스트] → 그 항목은 빈 값으로(저장값 무시), 새 입력값이 있으면 그 값
|
||||
svc.save(ga.GoogleAdsSource(), {"login_customer_id": "999-888-7777"}, user="king")
|
||||
acc = svc.accessor("google", cleared={"login_customer_id"})
|
||||
assert acc.get("login_customer_id") == "" and not acc.has("login_customer_id") and acc.get("customer_id") == "1234567890"
|
||||
assert svc.accessor("google").get("login_customer_id") == "999-888-7777"
|
||||
acc = svc.accessor("google", overrides={"login_customer_id": "111-222-3333"}, cleared={"login_customer_id"})
|
||||
assert acc.get("login_customer_id") == "111-222-3333"
|
||||
# [저장] 때 clear 로 보내면 지워진다(빈 칸 = 유지가 아니라 지움)
|
||||
t.delete_credential = lambda code, key: t.rows.pop((code, key))
|
||||
svc.save(ga.GoogleAdsSource(), {}, clear=["login_customer_id"], user="king")
|
||||
assert ("google", "login_customer_id") not in t.rows
|
||||
|
||||
|
||||
class FakeStore:
|
||||
def __init__(self):
|
||||
self.replaced, self.status = [], []
|
||||
|
||||
def ad_credential_keys_by_code(self):
|
||||
return {"google": {"customer_id", "service_account_json"}}
|
||||
|
||||
def ad_credential_rows(self, code):
|
||||
return {}
|
||||
|
||||
def replace_ad_api_range(self, code, start, end, days, *, user=""):
|
||||
self.replaced.append((code, start, end, days, user))
|
||||
return len(days)
|
||||
|
||||
def record_ad_status(self, code, *, status, ok, error="", kind="test"):
|
||||
self.status.append((code, status, ok, error, kind))
|
||||
|
||||
|
||||
def _service(store, source):
|
||||
svc = ad_sync.AdSyncService(store, CredentialService(None, lambda: None))
|
||||
svc.configured = lambda: {"google": True}
|
||||
svc._ctx = lambda code, values=None, user="": _ctx()
|
||||
return svc
|
||||
|
||||
|
||||
def test_sync_service_saves_and_records(monkeypatch):
|
||||
store = FakeStore()
|
||||
from app.modules.performance.ad_sources.base import AdDay
|
||||
|
||||
src = ga.GoogleAdsSource()
|
||||
monkeypatch.setattr(src, "fetch_days", lambda ctx, s, e: [AdDay(date(2026, 10, 1), 1000, Decimal("250.00"), {"비용": 1000})])
|
||||
monkeypatch.setattr(ad_sync, "get_source", lambda code: src)
|
||||
svc = _service(store, src)
|
||||
res = svc.sync("google", date(2026, 10, 1), date(2026, 10, 3), user="king@x")
|
||||
assert res["ok"] and res["days"] == 1 and res["total"] == 1000
|
||||
assert store.replaced == [("google", date(2026, 10, 1), date(2026, 10, 3),
|
||||
[(date(2026, 10, 1), 1000, Decimal("250.00"), {"비용": 1000})], "king@x")]
|
||||
assert store.status[-1] == ("google", "ok", True, "", "sync")
|
||||
|
||||
# 실패: 저장 안 하고 상태에 오류(저장된 비밀값은 가림)
|
||||
def boom(ctx, s, e):
|
||||
raise AuthFailed("거부된 값 123-456-7890")
|
||||
|
||||
monkeypatch.setattr(src, "fetch_days", boom)
|
||||
res = svc.sync("google", date(2026, 10, 1), date(2026, 10, 1))
|
||||
assert not res["ok"] and res["status"] == "auth_failed" and "123-456-7890" not in res["message"] # 꺼낸 인증정보 값은 가림
|
||||
assert len(store.replaced) == 1 and store.status[-1][1:3] == ("auth_failed", False)
|
||||
|
||||
# 같은 채널 동시 실행 막기
|
||||
lock = ad_sync._lock("google")
|
||||
lock.acquire()
|
||||
try:
|
||||
with pytest.raises(ad_sync.AdSyncBusy):
|
||||
svc.sync("google", date(2026, 10, 1), date(2026, 10, 1))
|
||||
assert svc.sync_all(date(2026, 10, 1), date(2026, 10, 1))[0]["skipped"]
|
||||
finally:
|
||||
lock.release()
|
||||
|
||||
|
||||
def test_sync_endpoint(monkeypatch):
|
||||
import importlib
|
||||
|
||||
from fastapi import FastAPI
|
||||
from fastapi.testclient import TestClient
|
||||
|
||||
from app.modules.performance import common
|
||||
|
||||
perf_router = importlib.import_module("app.modules.performance.router")
|
||||
calls, admin = [], {"v": False}
|
||||
|
||||
class Svc:
|
||||
def __init__(self):
|
||||
self.result = {"ok": True, "code": "google", "name": "구글 광고", "days": 3, "total": 9000}
|
||||
self.conf = {"google": True}
|
||||
|
||||
def configured(self):
|
||||
return self.conf
|
||||
|
||||
def sync(self, code, start, end, *, user=""):
|
||||
calls.append((code, start, end, user))
|
||||
return {**self.result, "from": start.isoformat(), "to": end.isoformat()}
|
||||
|
||||
svc = Svc()
|
||||
monkeypatch.setattr(common, "require_store", lambda request, admin=False: (object(), {"email": "king@x"}))
|
||||
monkeypatch.setattr(perf_router, "today_kst", lambda: date(2026, 10, 15))
|
||||
monkeypatch.setattr(perf_router, "_ad_services", lambda store: (None, svc))
|
||||
import app.store as app_store
|
||||
|
||||
monkeypatch.setattr(app_store, "is_admin", lambda user: admin["v"])
|
||||
app = FastAPI()
|
||||
app.include_router(perf_router.router)
|
||||
client = TestClient(app)
|
||||
|
||||
r = client.post("/performance/api/ad-sources/google/sync", json={"from": "2026-10-01", "to": "2026-10-31"})
|
||||
assert r.status_code == 200 and r.json()["to"] == "2026-10-15" # 오늘 뒤는 잘라냄
|
||||
assert calls[-1] == ("google", date(2026, 10, 1), date(2026, 10, 15), "king@x")
|
||||
r = client.post("/performance/api/ad-sources/google/sync", json={})
|
||||
assert r.status_code == 200 and calls[-1][1] == date(2026, 10, 6) # 기본 = 최근 10일
|
||||
r = client.post("/performance/api/ad-sources/google/sync", json={"from": "2026-01-01", "to": "2026-10-15"})
|
||||
assert r.status_code == 403 # 92일 넘으면 관리자만
|
||||
admin["v"] = True
|
||||
assert client.post("/performance/api/ad-sources/google/sync", json={"from": "2026-01-01", "to": "2026-10-15"}).status_code == 200
|
||||
assert client.post("/performance/api/ad-sources/meta/sync", json={}).status_code == 404
|
||||
svc.result = {"ok": False, "code": "google", "name": "구글 광고", "status": "auth_failed", "message": "권한 없음"}
|
||||
r = client.post("/performance/api/ad-sources/google/sync", json={})
|
||||
assert r.status_code == 502 and "권한 없음" in r.json()["detail"]
|
||||
svc.conf = {"google": False}
|
||||
r = client.post("/performance/api/ad-sources/google/sync", json={})
|
||||
assert r.status_code == 400 and "설정" in r.json()["detail"]
|
||||
@@ -0,0 +1,143 @@
|
||||
"""수동 입력 엑셀 업로드 — 머리글 매칭·값 있는 칸만·오류 시 전부 거절."""
|
||||
|
||||
from __future__ import annotations
|
||||
|
||||
import io
|
||||
from datetime import date, datetime
|
||||
from pathlib import Path
|
||||
|
||||
import openpyxl
|
||||
import pytest
|
||||
|
||||
from app.modules.performance import manual_upload as mu
|
||||
|
||||
TODAY = date(2026, 10, 13)
|
||||
MARKETS = [
|
||||
{"code": "naver", "name": "네이버", "manual_input": False},
|
||||
{"code": "coupang_rocket", "name": "쿠팡(로켓)", "manual_input": True},
|
||||
{"code": "ohouse", "name": "오늘의집", "manual_input": True},
|
||||
{"code": "toss", "name": "토스쇼핑", "manual_input": True},
|
||||
{"code": "atomy", "name": "애터미아자몰", "manual_input": True},
|
||||
]
|
||||
EXTRA = {"toss": ("토스쇼핑", "토스")}
|
||||
|
||||
|
||||
def _xlsx(rows):
|
||||
wb = openpyxl.Workbook()
|
||||
ws = wb.active
|
||||
for r in rows:
|
||||
ws.append(list(r))
|
||||
buf = io.BytesIO()
|
||||
wb.save(buf)
|
||||
return buf.getvalue()
|
||||
|
||||
|
||||
def _parse(rows):
|
||||
return mu.parse_workbook(_xlsx(rows), markets=MARKETS, today=TODAY, extra_names=EXTRA)
|
||||
|
||||
|
||||
def test_only_filled_cells_of_manual_shops():
|
||||
res = _parse([
|
||||
("날짜", "쿠팡(로켓)", " 오늘의 집 ", "네이버", "모르는몰", "토스", "애터미아자몰"),
|
||||
(datetime(2026, 10, 12), 1_000, None, 999, 5, "12,300원", ""),
|
||||
("2026.10.13(화)", None, 0, None, None, None, 4500.4),
|
||||
(None, None, None, None, None, None, None), # 빈 줄
|
||||
])
|
||||
assert not res.errors
|
||||
assert res.columns == ["coupang_rocket", "ohouse", "toss", "atomy"]
|
||||
assert sorted(res.entries) == sorted([
|
||||
("coupang_rocket", date(2026, 10, 12), 1000), ("toss", date(2026, 10, 12), 12300),
|
||||
("ohouse", date(2026, 10, 13), 0), ("atomy", date(2026, 10, 13), 4500)])
|
||||
assert res.ignored == ["네이버(수동 입력 꺼짐)", "모르는몰(알 수 없는 쇼핑몰)"]
|
||||
|
||||
|
||||
@pytest.mark.parametrize("raw, expect", [
|
||||
("2026-10-01", date(2026, 10, 1)), ("2026/10/1", date(2026, 10, 1)), ("20261001", date(2026, 10, 1)),
|
||||
(20261001, date(2026, 10, 1)), (46296, date(2026, 10, 1)), ("2026년 10월 1일", date(2026, 10, 1)), (None, None),
|
||||
])
|
||||
def test_parse_date(raw, expect):
|
||||
assert mu.parse_date(raw) == expect
|
||||
|
||||
|
||||
def test_errors_reject_everything_with_cell_refs():
|
||||
res = _parse([
|
||||
("날짜", "쿠팡(로켓)", "오늘의집"),
|
||||
("2026-10-10", "abc", 100),
|
||||
("엉터리", 1, None),
|
||||
("2026-10-14", 1, None), # 앞으로의 날짜
|
||||
(None, 5, None), # 날짜 없음
|
||||
("2026-10-11", 7, None),
|
||||
("2026-10-11", 8, None), # 같은 날 두 번
|
||||
])
|
||||
joined = "\n".join(res.errors)
|
||||
assert "B2" in joined and "A3" in joined and "A4" in joined and "5행" in joined and "B7" in joined
|
||||
assert len(res.errors) == 5
|
||||
|
||||
|
||||
def test_header_problems():
|
||||
with pytest.raises(mu.UploadError):
|
||||
_parse([("날짜", "네이버", "모르는몰"), ("2026-10-10", 1, 2)]) # 반영할 열 없음
|
||||
with pytest.raises(mu.UploadError):
|
||||
mu.parse_workbook(b"not an xlsx", markets=MARKETS, today=TODAY)
|
||||
res = _parse([("날짜", "쿠팡(로켓)", "coupang_rocket"), ("2026-10-10", 1, 2)])
|
||||
assert any("두 번" in e for e in res.errors)
|
||||
|
||||
|
||||
def test_sample_file_headers_match_marketplaces():
|
||||
"""모듈 폴더 샘플 파일 머리글 = 수동 입력 쇼핑몰 이름(시드 기준) — 업로드하면 전부 반영 대상이어야 한다."""
|
||||
sample = Path(mu.__file__).resolve().parent / "upload_sample.xlsx"
|
||||
seed = [{"code": c, "name": n, "manual_input": True} for c, n in (
|
||||
("coupang_rocket", "쿠팡(로켓)"), ("ohouse", "오늘의집"), ("gmarket", "G마켓"), ("kakao", "카카오"),
|
||||
("gsshop", "GS샵"), ("lotteon", "롯데ON"), ("atomy", "애터미아자몰"))]
|
||||
wb = openpyxl.load_workbook(sample)
|
||||
ws = wb.active
|
||||
ws.append([date(2026, 10, 1)] + [1] * 7)
|
||||
buf = io.BytesIO()
|
||||
wb.save(buf)
|
||||
res = mu.parse_workbook(buf.getvalue(), markets=seed, today=TODAY)
|
||||
assert not res.errors and not res.ignored and len(res.entries) == 7
|
||||
|
||||
|
||||
def test_upload_endpoint_saves_or_rejects(monkeypatch):
|
||||
"""라우터: 정상 파일은 한 번에 저장, 잘못된 칸이 있으면 400 + 칸 목록, 아무것도 저장 안 함. 샘플 받기."""
|
||||
from fastapi import FastAPI
|
||||
from fastapi.testclient import TestClient
|
||||
|
||||
import importlib
|
||||
|
||||
from app.modules.performance import common
|
||||
|
||||
perf_router = importlib.import_module("app.modules.performance.router") # 패키지 속성 router 는 APIRouter
|
||||
|
||||
class Store:
|
||||
saved: list = []
|
||||
|
||||
def list_marketplaces(self):
|
||||
return [{**m, "enabled": True} for m in MARKETS]
|
||||
|
||||
def set_manual_sales_bulk(self, entries, *, user=""):
|
||||
self.saved.extend(entries)
|
||||
return len(entries)
|
||||
|
||||
store = Store()
|
||||
monkeypatch.setattr(common, "require_store", lambda request, admin=False: (store, {"email": "king@x"}))
|
||||
monkeypatch.setattr(perf_router, "today_kst", lambda: TODAY)
|
||||
app = FastAPI()
|
||||
app.include_router(perf_router.router)
|
||||
client = TestClient(app)
|
||||
|
||||
ok = _xlsx([("날짜", "쿠팡(로켓)", "토스"), ("2026-10-12", 1000, None), ("2026-10-13", None, 2000)])
|
||||
r = client.post("/performance/api/manual-sales/upload", files={"file": ("a.xlsx", ok)})
|
||||
assert r.status_code == 200, r.text
|
||||
body = r.json()
|
||||
assert body["saved"] == 2 and body["from"] == "2026-10-12" and body["to"] == "2026-10-13"
|
||||
assert [s["code"] for s in body["by_shop"]] == ["coupang_rocket", "toss"]
|
||||
assert sorted(store.saved) == [("coupang_rocket", date(2026, 10, 12), 1000), ("toss", date(2026, 10, 13), 2000)]
|
||||
|
||||
store.saved.clear()
|
||||
bad = _xlsx([("날짜", "쿠팡(로켓)"), ("2026-10-12", 1000), ("2026-10-13", "x")])
|
||||
r = client.post("/performance/api/manual-sales/upload", files={"file": ("b.xlsx", bad)})
|
||||
assert r.status_code == 400 and r.json()["errors"] and store.saved == []
|
||||
|
||||
r = client.get("/performance/api/manual-sales/sample.xlsx")
|
||||
assert r.status_code == 200 and r.content[:2] == b"PK"
|
||||
File diff suppressed because it is too large
Load Diff
@@ -0,0 +1,310 @@
|
||||
"""2026-10-15 코드 검토(docs/CODE_REVIEW_2026-10-15.md) 실적 항목 회귀 테스트 — DB·네트워크 없이(가짜 저장소·가짜 HTTP).
|
||||
|
||||
F01 쿠팡 잘못된 응답(HTTP 200 + JSON 아님·data 없음)은 수집 실패 — 기존 매출 유지(replace_events 안 부름)
|
||||
F04 인증정보가 바뀌면 이전 계정 토큰을 쓰지 않음(저장 때 내부 토큰 삭제 + 토큰-인증정보 지문), 같은 값 재저장은 유지
|
||||
F05 쪽 수 상한·커서 반복이면 부분 수집을 성공으로 내지 않음(쿠팡은 기간을 나눠 다시), 다른 어댑터도 실패로
|
||||
F06 collect() 끝 무렵 받아들인 [중지]는 저장 전에 반영, 저장을 시작했으면 [중지] 불가
|
||||
F09 쇼핑몰 연결 테스트도 clear(비운 칸)를 빈 값으로 시험하고, 저장하지 않은 시험은 연결 상태를 바꾸지 않음
|
||||
"""
|
||||
|
||||
from __future__ import annotations
|
||||
|
||||
import time
|
||||
from datetime import date
|
||||
|
||||
import httpx
|
||||
import pytest
|
||||
|
||||
from app.modules.performance.adapters import coupang as cp
|
||||
from app.modules.performance.adapters import gsshop as gs
|
||||
from app.modules.performance.adapters import kakao as kk
|
||||
from app.modules.performance.adapters import naver as nv
|
||||
from app.modules.performance.adapters import toss as ts
|
||||
from app.modules.performance.adapters.base import AdapterContext, ApiError
|
||||
from app.modules.performance.adapters.registry import get_adapter
|
||||
from app.modules.performance.credentials import CredentialService
|
||||
from app.modules.performance.sync import SyncService
|
||||
from app.modules.performance.tests.test_performance import FakeStore, _naver_item, ring
|
||||
|
||||
|
||||
class Creds(dict):
|
||||
def get(self, k, default=""):
|
||||
return dict.get(self, k, default)
|
||||
|
||||
def has(self, k):
|
||||
return bool(dict.get(self, k))
|
||||
|
||||
def set(self, k, v):
|
||||
self[k] = v
|
||||
|
||||
def known_secrets(self):
|
||||
return []
|
||||
|
||||
|
||||
def _cp_ctx():
|
||||
return AdapterContext(code="coupang", credentials=Creds(vendor_id="A00012345", access_key="AK", secret_key="SK"))
|
||||
|
||||
|
||||
@pytest.fixture
|
||||
def no_wait(monkeypatch):
|
||||
monkeypatch.setattr(cp, "CALL_INTERVAL_SEC", 0)
|
||||
monkeypatch.setattr(cp, "RG_CALL_INTERVAL_SEC", 0)
|
||||
monkeypatch.setattr(cp.time, "sleep", lambda *_a, **_k: None)
|
||||
|
||||
|
||||
def _coupang_store_with_sales():
|
||||
"""기존 쿠팡 매출 한 줄(10/12)이 있는 가짜 저장소 + 쿠팡 인증정보. replace_events 호출을 기록한다."""
|
||||
st = FakeStore()
|
||||
st.events[("coupang", "SALE", "coupang:9")] = {"sales_date": date(2026, 10, 12), "amount": 15000,
|
||||
"event_type": "SALE", "is_sample": False}
|
||||
st.replaced = []
|
||||
orig = st.replace_events
|
||||
|
||||
def replace(code, start, end, events, *, id_prefix=""):
|
||||
st.replaced.append((code, start, end, list(events)))
|
||||
return orig(code, start, end, events, id_prefix=id_prefix)
|
||||
|
||||
st.replace_events = replace
|
||||
creds = CredentialService(st, lambda: ring())
|
||||
creds.save(get_adapter("coupang"), {"vendor_id": "A00012345", "access_key": "AK-1", "secret_key": "SK-1"})
|
||||
return st, creds
|
||||
|
||||
|
||||
# ── F01 ─────────────────────────────────────────────────────
|
||||
@pytest.mark.parametrize("response", [
|
||||
httpx.Response(200, text="<html>maintenance</html>"), # JSON 아님
|
||||
httpx.Response(200, json={"message": "점검 중입니다"}), # 주문 목록(data) 없음
|
||||
httpx.Response(200, json={"code": 200, "data": {"unexpected": True}}), # data 가 목록 아님
|
||||
])
|
||||
def test_f01_bad_200_response_fails_and_keeps_existing_sales(monkeypatch, no_wait, response):
|
||||
st, creds = _coupang_store_with_sales()
|
||||
monkeypatch.setattr(httpx, "get", lambda *a, **k: response)
|
||||
r = SyncService(st, creds).sync_marketplace("coupang", date(2026, 10, 12), date(2026, 10, 12))
|
||||
assert not r["ok"] and r["status"] == "api_error", r
|
||||
assert st.replaced == [] # 기간 교체(삭제)를 아예 하지 않음
|
||||
assert ("coupang", "SALE", "coupang:9") in st.events # 기존 매출 그대로
|
||||
assert st.status["coupang"]["ok"] is False and "저장하지 않았습니다" in r["message"]
|
||||
|
||||
|
||||
def test_f01_empty_list_is_still_a_normal_empty_period(monkeypatch, no_wait):
|
||||
"""정상 빈 목록(data: [])은 주문 0건 — 기간 교체가 정상적으로 일어난다(실패와 구분)."""
|
||||
st, creds = _coupang_store_with_sales()
|
||||
monkeypatch.setattr(httpx, "get", lambda *a, **k: httpx.Response(200, json={"code": 200, "data": [], "nextToken": ""}))
|
||||
r = SyncService(st, creds).sync_marketplace("coupang", date(2026, 10, 12), date(2026, 10, 12))
|
||||
assert r["ok"], r
|
||||
assert len(st.replaced) == 1 and st.replaced[0][3] == []
|
||||
|
||||
|
||||
def test_f01_page_rows_contract():
|
||||
assert cp.CoupangAdapter._page_rows({"code": 200, "data": []}, "발주서") == []
|
||||
assert cp.CoupangAdapter._page_rows({"code": 200, "message": "OK", "data": None}, "발주서") == [] # 성공 표시 + null
|
||||
assert cp.CoupangAdapter._page_rows({"data": [{"a": 1}, "x"]}, "발주서") == [{"a": 1}]
|
||||
for body in ({}, {"data": None}, {"message": "maintenance"}, {"data": "x"}):
|
||||
with pytest.raises(ApiError):
|
||||
cp.CoupangAdapter._page_rows(body, "발주서")
|
||||
|
||||
|
||||
# ── F05 ─────────────────────────────────────────────────────
|
||||
def test_f05_coupang_page_limit_and_repeated_cursor_raise(monkeypatch, no_wait):
|
||||
ad = cp.CoupangAdapter()
|
||||
monkeypatch.setattr(cp, "MAX_PAGES", 2)
|
||||
n = {"i": 0}
|
||||
|
||||
def endless(*a, **k):
|
||||
n["i"] += 1
|
||||
return httpx.Response(200, json={"code": 200, "data": [{"orderId": n["i"]}], "nextToken": f"t{n['i']}"})
|
||||
|
||||
monkeypatch.setattr(httpx, "get", endless)
|
||||
with pytest.raises(cp.TooManyPages):
|
||||
ad._pages(_cp_ctx(), "/x", {})
|
||||
monkeypatch.setattr(httpx, "get", lambda *a, **k: httpx.Response(200, json={"code": 200, "data": [{"a": 1}], "nextToken": "same"}))
|
||||
with pytest.raises(cp.TooManyPages, match="반복"):
|
||||
ad._pages(_cp_ctx(), "/x", {})
|
||||
|
||||
|
||||
def test_f05_coupang_splits_period_until_complete_or_fails(monkeypatch, no_wait):
|
||||
"""2일 조회가 쪽 수 상한을 넘으면 하루씩 나눠 끝까지 받는다. 하루도 넘치면 명확한 실패."""
|
||||
ad = cp.CoupangAdapter()
|
||||
monkeypatch.setattr(cp, "MAX_PAGES", 3)
|
||||
calls = []
|
||||
|
||||
def get(url, headers=None, timeout=None):
|
||||
q = dict(p.split("=", 1) for p in url.split("?", 1)[1].split("&"))
|
||||
calls.append((q["paidDateFrom"], q["paidDateTo"]))
|
||||
if q["paidDateFrom"] != q["paidDateTo"]: # 여러 날 — 끝이 안 보임
|
||||
i = int(q.get("nextToken", "0")) + 1
|
||||
return httpx.Response(200, json={"data": [{"orderId": i}], "nextToken": str(i)})
|
||||
return httpx.Response(200, json={"data": [{"orderId": q["paidDateFrom"]}], "nextToken": ""})
|
||||
|
||||
monkeypatch.setattr(httpx, "get", get)
|
||||
rows = ad._rg_orders(_cp_ctx(), date(2026, 10, 11), date(2026, 10, 12))
|
||||
assert sorted(r["orderId"] for r in rows) == ["20261011", "20261012"] # 부분 목록이 아니라 하루씩 전부
|
||||
assert ("20261011", "20261011") in calls and ("20261012", "20261012") in calls
|
||||
|
||||
monkeypatch.setattr(httpx, "get", lambda url, headers=None, timeout=None: httpx.Response(
|
||||
200, json={"data": [{"orderId": 1}], "nextToken": str(time.perf_counter_ns())}))
|
||||
with pytest.raises(ApiError, match="하루"):
|
||||
ad._rg_orders(_cp_ctx(), date(2026, 10, 12), date(2026, 10, 12))
|
||||
|
||||
|
||||
def test_f05_other_adapters_fail_instead_of_partial(monkeypatch):
|
||||
"""네이버·카카오·토스·GS샵 — 상한 소진·커서 반복은 실패(일부만 받은 목록을 돌려주지 않음)."""
|
||||
ctx = AdapterContext(code="x", credentials=Creds())
|
||||
d = date(2026, 10, 12)
|
||||
|
||||
monkeypatch.setattr(nv, "MAX_PAGES", 2)
|
||||
a = nv.NaverAdapter()
|
||||
a._get = lambda ctx, path, params: {"data": {"contents": [_naver_item(f"O{params['page']}", f"P{params['page']}",
|
||||
"2026-10-12", 1000)],
|
||||
"pagination": {"page": params["page"], "hasNext": True}}}
|
||||
with pytest.raises(ApiError, match="끝까지"):
|
||||
a._day_items(ctx, d)
|
||||
|
||||
k = kk.KakaoAdapter()
|
||||
k._get = lambda ctx, path, params: {"contents": [{"orderId": "1"}], "token": "same"}
|
||||
with pytest.raises(ApiError, match="반복"):
|
||||
k._day_rows(ctx, d)
|
||||
|
||||
t = ts.TossAdapter()
|
||||
t._get = lambda ctx, path, params: {"results": [{"id": 1}], "nextCursor": "c"}
|
||||
with pytest.raises(ApiError, match="반복"):
|
||||
t._window_items(ctx, d, d)
|
||||
t._get = lambda ctx, path, params: {"items": [{"id": 1}], "nextToken": "n"}
|
||||
with pytest.raises(ApiError, match="반복"):
|
||||
t._settlement_items(ctx, d, d)
|
||||
with pytest.raises(ApiError, match="반복"):
|
||||
t._claims(ctx)
|
||||
|
||||
monkeypatch.setattr(gs, "MAX_PAGES", 2)
|
||||
g = gs.GsshopAdapter()
|
||||
g._get = lambda ctx, path, params: {"data": [{"ordNo": params["pageIdx"]}], "hasMorePage": True}
|
||||
with pytest.raises(ApiError, match="끝까지"):
|
||||
g._pages(ctx, gs.SALES_PATH, d, d)
|
||||
|
||||
|
||||
# ── F06 ─────────────────────────────────────────────────────
|
||||
def test_f06_stop_accepted_at_end_of_collect_is_not_saved(monkeypatch, no_wait):
|
||||
from app.modules.performance import jobs
|
||||
|
||||
st, creds = _coupang_store_with_sales()
|
||||
job = jobs.SyncJob(user="t", start=None, end=None)
|
||||
shop = job.set_targets([("coupang", "쿠팡", True)], date(2026, 10, 12), date(2026, 10, 12))["coupang"]
|
||||
ad = get_adapter("coupang")
|
||||
|
||||
def collect(ctx, start, end): # 마지막 API 호출·정리 중에 [중지]가 들어온 상황
|
||||
assert job.stop_shop("coupang") is True
|
||||
return 1, []
|
||||
|
||||
monkeypatch.setattr(ad, "collect", collect)
|
||||
r = SyncService(st, creds).sync_marketplace("coupang", date(2026, 10, 12), date(2026, 10, 12), progress=shop)
|
||||
assert r.get("cancelled") and r["status"] == "cancelled", r
|
||||
assert st.replaced == [] and ("coupang", "SALE", "coupang:9") in st.events # 저장 안 함
|
||||
assert shop.state == "cancelled" and shop.message == "중지됨"
|
||||
|
||||
|
||||
def test_f06_stop_after_saving_started_is_refused():
|
||||
from app.modules.performance import jobs
|
||||
|
||||
job = jobs.SyncJob(user="t", start=None, end=None)
|
||||
shop = job.set_targets([("coupang", "쿠팡", True)], date(2026, 10, 12), date(2026, 10, 12))["coupang"]
|
||||
shop.start()
|
||||
shop.begin_saving()
|
||||
assert shop.state == "saving"
|
||||
assert job.stop_shop("coupang") is False and shop.stop_requested is False # 저장 중이면 중지 불가를 알림
|
||||
|
||||
|
||||
# ── F04 ─────────────────────────────────────────────────────
|
||||
def _toss_svc():
|
||||
st = FakeStore()
|
||||
svc = CredentialService(st, lambda: ring())
|
||||
ad = get_adapter("toss")
|
||||
svc.save(ad, {"api_key": "k1", "api_secret": "s1"})
|
||||
acc = svc.accessor("toss")
|
||||
acc.set("access_token", "OLD_ACCOUNT_TOKEN")
|
||||
acc.set("access_token_expires_at", str(int(time.time()) + 86400))
|
||||
acc.set("access_token_for", ts.credential_fingerprint(acc, ts.TOKEN_KEYS))
|
||||
return st, svc, ad
|
||||
|
||||
|
||||
def test_f04_same_values_keep_token_changed_values_drop_it(monkeypatch):
|
||||
st, svc, ad = _toss_svc()
|
||||
issued = []
|
||||
monkeypatch.setattr(httpx, "post", lambda *a, **k: issued.append(1) or httpx.Response(
|
||||
200, json={"access_token": "NEW_ACCOUNT_TOKEN", "expires_in": 3600}))
|
||||
|
||||
svc.save(ad, {"api_key": "k1", "api_secret": "s1"}) # 같은 값 다시 저장
|
||||
assert ("toss", "access_token") in st.creds
|
||||
ctx = AdapterContext(code="toss", credentials=svc.accessor("toss"))
|
||||
assert ad._token(ctx) == "OLD_ACCOUNT_TOKEN" and issued == [] # 불필요한 재발급 없음
|
||||
|
||||
svc.save(ad, {"api_key": "k2"}) # 계정(키) 변경
|
||||
assert ("toss", "access_token") not in st.creds and ("toss", "access_token_expires_at") not in st.creds
|
||||
ctx = AdapterContext(code="toss", credentials=svc.accessor("toss"))
|
||||
assert ad._token(ctx) == "NEW_ACCOUNT_TOKEN" and issued == [1]
|
||||
|
||||
|
||||
def test_f04_token_bound_to_credentials_even_without_save(monkeypatch):
|
||||
"""연결 테스트(저장 안 한 새 입력값)·예전 토큰(지문 없음)도 이전 계정 토큰을 쓰지 않는다 — 실제 수집과 같은 기준."""
|
||||
st, svc, ad = _toss_svc()
|
||||
monkeypatch.setattr(httpx, "post", lambda *a, **k: httpx.Response(200, json={"access_token": "NEW", "expires_in": 3600}))
|
||||
trial = AdapterContext(code="toss", credentials=svc.accessor("toss", overrides={"api_key": "k2"}, persist=False))
|
||||
assert ad._token(trial) == "NEW"
|
||||
assert svc.accessor("toss").get("access_token") == "OLD_ACCOUNT_TOKEN" # 시험은 저장된 토큰을 건드리지 않음
|
||||
# 지문이 없는 예전 토큰(배포 전에 저장된 것)은 한 번 새로 받는다
|
||||
svc.accessor("toss").set("access_token_for", "")
|
||||
real = AdapterContext(code="toss", credentials=svc.accessor("toss"))
|
||||
assert ad._token(real) == "NEW" and svc.accessor("toss").get("access_token") == "NEW"
|
||||
|
||||
|
||||
def test_f04_fingerprint_hides_values_and_gs_mode_cache_follows_key():
|
||||
fp = ts.credential_fingerprint(Creds(api_key="secret-key-1", api_secret="s"), ts.TOKEN_KEYS)
|
||||
assert len(fp) == 64 and "secret" not in fp
|
||||
a = AdapterContext(code="gsshop", credentials=Creds(vendor_code="1036018", api_key="K1" * 16))
|
||||
b = AdapterContext(code="gsshop", credentials=Creds(vendor_code="1036018", api_key="K2" * 16))
|
||||
assert gs.GsshopAdapter._mode_key(a) != gs.GsshopAdapter._mode_key(b)
|
||||
|
||||
|
||||
# ── F09 ─────────────────────────────────────────────────────
|
||||
def test_f09_shop_test_uses_empty_value_for_cleared_and_keeps_status(monkeypatch):
|
||||
st = FakeStore()
|
||||
svc = CredentialService(st, lambda: ring())
|
||||
ad = get_adapter("naver")
|
||||
svc.save(ad, {"client_id": "cid", "client_secret": "$2a$04$abcdefghijklmnopqrstuu", "account_id": "OLD-SELLER"})
|
||||
st.status["naver"] = {"status": "ok", "ok": True, "error": ""}
|
||||
seen = []
|
||||
monkeypatch.setattr(ad, "test_connection", lambda ctx: seen.append(ctx.credentials.get("account_id")) or "연결됨")
|
||||
r = SyncService(st, svc).test_connection("naver", cleared={"account_id"})
|
||||
assert seen == [""] and r["ok"] and r["unsaved"] is True # 비운 칸은 빈 값, 저장 안 한 시험
|
||||
assert st.status["naver"] == {"status": "ok", "ok": True, "error": ""} # 연결 상태 그대로
|
||||
assert svc.accessor("naver").get("account_id") == "OLD-SELLER" # 저장값도 그대로
|
||||
r = SyncService(st, svc).test_connection("naver") # 저장값 그대로 시험은 상태 기록
|
||||
assert seen[-1] == "OLD-SELLER" and r["unsaved"] is False and st.status["naver"].get("test")
|
||||
|
||||
|
||||
def test_f09_router_passes_clear_like_ad_test(monkeypatch):
|
||||
import importlib
|
||||
|
||||
from fastapi import FastAPI
|
||||
from fastapi.testclient import TestClient
|
||||
|
||||
from app.modules.performance import common
|
||||
|
||||
perf_router = importlib.import_module("app.modules.performance.router")
|
||||
calls = []
|
||||
|
||||
class Sync:
|
||||
def test_connection(self, code, *, values=None, user="", cleared=None):
|
||||
calls.append((code, values, cleared))
|
||||
return {"ok": True, "status": "ok", "label": "정상 연결", "message": "연결됨", "unsaved": bool(values or cleared)}
|
||||
|
||||
st = FakeStore()
|
||||
st.list_marketplaces = lambda: [{"code": "naver", "name": "네이버"}]
|
||||
monkeypatch.setattr(common, "require_store", lambda request, admin=False: (st, {"email": "king@x"}))
|
||||
monkeypatch.setattr(common, "services", lambda request, store: (None, Sync()))
|
||||
app = FastAPI()
|
||||
app.include_router(perf_router.router)
|
||||
c = TestClient(app)
|
||||
r = c.post("/performance/api/marketplaces/naver/test",
|
||||
json={"values": {"client_id": "new"}, "clear": ["account_id", "client_id", "nope"]})
|
||||
assert r.status_code == 200 and r.json()["unsaved"] is True
|
||||
assert calls[-1] == ("naver", {"client_id": "new"}, {"account_id"}) # 새 값이 있는 칸·모르는 칸은 빼고
|
||||
Binary file not shown.
@@ -0,0 +1,186 @@
|
||||
"""프로젝트 관리 — 현재 접근 권한의 공통 기준(서버).
|
||||
|
||||
라우터·마감 알림이 같은 규칙을 쓰도록 한 곳에 모은다. 모든 판단은 "지금" 기준이다 —
|
||||
예전에 멤버였거나 담당자·멘션·협업자로 기록돼 있어도, 지금 권한이 없으면 보이지도
|
||||
바꾸지도 알림을 받지도 않는다(기록 자체는 업무 이력으로 남긴다).
|
||||
|
||||
프로젝트
|
||||
관리(=보기·작업 CRUD) : 프로젝트 owner · 배정 멤버 · 슈퍼관리자. 모두 `project` 모듈 권한이 있어야 한다.
|
||||
(2026-10-07 — 관리자(is_admin)도 멤버가 아닌 프로젝트는 보이지 않는다. 예외는 슈퍼관리자 한 명뿐.
|
||||
멤버 배정은 Pro user 이상(2026-10-12) — 라우터의 _require_pro, 아래 등급 표.)
|
||||
|
||||
등급(2026-10-12, app.store.ROLES) — 수퍼관리자 > admin > pro > user
|
||||
is_project_admin : 수퍼관리자·admin — 남이 만든 프로젝트·섹션도 삭제.
|
||||
is_pro : 수퍼관리자·admin·pro — 새 프로젝트 만들기, 프로젝트 이름·색·아이콘·소유자 수정,
|
||||
멤버 배정·제외(자기가 멤버인 프로젝트), 사이드바 순서, 남의 댓글 수정·삭제,
|
||||
휴지통 보기·복구, 전체 보기, 대시보드 담당자별 합계, 전체 멤버 메뉴,
|
||||
목표 표 입력·구조 변경·주차별 목표·연도 추가/삭제, 회의 완료·완료 해제·회의록 삭제.
|
||||
user : 멤버인 프로젝트의 작업·섹션·서브프로젝트·작업 삭제, 회의록 작성(완료 전까지).
|
||||
프로젝트 단위 권한은 등급과 상관없이 멤버(owner)여야 한다 — 위 is_pro 권한도 멤버인 프로젝트 안에서만.
|
||||
|
||||
작업
|
||||
FULL : 원 소속 프로젝트를 관리할 수 있음 → 보기·수정·댓글·첨부·삭제(작업 삭제는 멤버 누구나, 2026-10-12)
|
||||
READ : 원 소속 권한은 없지만, 이 작업(또는 상위 작업)이 연결된(멀티호밍) 프로젝트를 관리할 수 있음
|
||||
→ 그 작업의 상세·세부 작업 목록·댓글·첨부 보기만. 원 소속의 다른 작업·멤버는 보이지 않는다.
|
||||
연결된 프로젝트 안에서의 섹션 이동(POST /links, 이미 연결된 경우)은 예전처럼 허용.
|
||||
None : 권한 없음 → 403/목록에서 제외/알림·메일 대상 제외
|
||||
"""
|
||||
|
||||
from __future__ import annotations
|
||||
|
||||
from typing import Any, Callable, Iterable
|
||||
|
||||
from . import store
|
||||
|
||||
FULL = "full"
|
||||
READ = "read"
|
||||
|
||||
UserLookup = Callable[[str], "dict[str, Any] | None"]
|
||||
|
||||
|
||||
def default_user_lookup(email: str) -> dict[str, Any] | None:
|
||||
"""등록 사용자 레코드(app.main.user_store). 지연 import — 테스트는 lookup 을 직접 넘긴다."""
|
||||
from app.main import user_store # noqa: WPS433
|
||||
|
||||
return user_store.get(store.norm_str(email, lower=True))
|
||||
|
||||
|
||||
def _is_super(user: dict[str, Any] | None) -> bool:
|
||||
"""슈퍼관리자(app.store.SUPER_ADMIN_EMAIL) — 모든 프로젝트를 보는 유일한 예외."""
|
||||
from app.store import SUPER_ADMIN_EMAIL # noqa: WPS433
|
||||
|
||||
return bool(user) and email_of(user) == SUPER_ADMIN_EMAIL
|
||||
|
||||
|
||||
def role_of(user: dict[str, Any] | None) -> str:
|
||||
"""등급 — 'super' · 'admin' · 'pro' · 'user'. 모르는 role 값은 user 로 본다."""
|
||||
if _is_super(user):
|
||||
return "super"
|
||||
role = (user or {}).get("role")
|
||||
return role if role in ("admin", "pro") else "user"
|
||||
|
||||
|
||||
def is_project_admin(user: dict[str, Any] | None) -> bool:
|
||||
"""수퍼관리자·admin — 만든 사람이 아니어도 프로젝트·섹션을 지운다."""
|
||||
return role_of(user) in ("super", "admin")
|
||||
|
||||
|
||||
def is_pro(user: dict[str, Any] | None) -> bool:
|
||||
"""수퍼관리자·admin·pro — 프로젝트 관리·목표 입력 등 운영 권한(모듈 docstring 의 등급 표)."""
|
||||
return role_of(user) in ("super", "admin", "pro")
|
||||
|
||||
|
||||
def sees_all_projects(user: dict[str, Any] | None) -> bool:
|
||||
"""멤버가 아니어도 모든 프로젝트를 보는가 — 슈퍼관리자만(모듈 권한도 있어야)."""
|
||||
return can_use_module(user) and _is_super(user)
|
||||
|
||||
|
||||
def can_use_module(user: dict[str, Any] | None) -> bool:
|
||||
from app.store import has_module # noqa: WPS433
|
||||
|
||||
return bool(user) and has_module(user, "project")
|
||||
|
||||
|
||||
def email_of(user: dict[str, Any] | None) -> str:
|
||||
return store.norm_str((user or {}).get("email", ""), lower=True)
|
||||
|
||||
|
||||
def can_manage_project(st: Any, user: dict[str, Any] | None, project_id: Any) -> bool:
|
||||
"""프로젝트 관리(=보기·작업 CRUD) — owner/멤버(관리자도 마찬가지), 슈퍼관리자는 전부. 모듈 권한이 없으면 False."""
|
||||
if not can_use_module(user):
|
||||
return False
|
||||
if _is_super(user):
|
||||
return True
|
||||
try:
|
||||
pid = int(project_id)
|
||||
except (TypeError, ValueError):
|
||||
return False
|
||||
return bool(st.is_member(project_id=pid, user_email=email_of(user)))
|
||||
|
||||
|
||||
def visible_project_ids(st: Any, user: dict[str, Any]) -> set[int] | None:
|
||||
"""관리할 수 있는 프로젝트 id 집합. 슈퍼관리자는 None(=전체), 그 밖(관리자 포함)은 owner·멤버인 프로젝트만."""
|
||||
if not can_use_module(user):
|
||||
return set()
|
||||
if _is_super(user):
|
||||
return None
|
||||
return {
|
||||
int(p["id"]) for p in st.list_projects(include_archived=True, member_email=email_of(user))
|
||||
}
|
||||
|
||||
|
||||
def task_access(st: Any, user: dict[str, Any] | None, task: dict[str, Any] | None) -> str | None:
|
||||
"""작업 하나에 대한 지금 권한: FULL / READ / None."""
|
||||
if not task or not can_use_module(user):
|
||||
return None
|
||||
if can_manage_project(st, user, task.get("project_id")):
|
||||
return FULL
|
||||
for pid in link_scope(st, [int(task["id"])]).get(int(task["id"]), set()):
|
||||
if can_manage_project(st, user, pid):
|
||||
return READ
|
||||
return None
|
||||
|
||||
|
||||
def link_scope(st: Any, task_ids: Iterable[int]) -> dict[int, set[int]]:
|
||||
"""작업 id → 이 작업 또는 상위 작업이 연결된 프로젝트 id 들. 연결 표가 없으면 빈 값."""
|
||||
ids = [int(i) for i in task_ids]
|
||||
if not ids:
|
||||
return {}
|
||||
try:
|
||||
return st.task_link_scope(task_ids=ids)
|
||||
except Exception: # noqa: BLE001 - 003 미적용(연결 기능 없음) → 연결로 보이는 작업 없음
|
||||
return {}
|
||||
|
||||
|
||||
def filter_visible_tasks(st: Any, user: dict[str, Any], tasks: list[dict[str, Any]],
|
||||
*, key: str = "id") -> list[dict[str, Any]]:
|
||||
"""목록에서 지금 볼 수 있는(FULL 또는 READ) 작업만 남긴다 — 내 작업·수신함·알림 공용."""
|
||||
allowed = visible_project_ids(st, user)
|
||||
if allowed is None:
|
||||
return list(tasks)
|
||||
ids = [int(t[key]) for t in tasks if t.get(key) is not None]
|
||||
scope = link_scope(st, ids)
|
||||
out = []
|
||||
for t in tasks:
|
||||
tid = t.get(key)
|
||||
pid = t.get("project_id")
|
||||
if pid is not None and int(pid) in allowed:
|
||||
out.append(t)
|
||||
elif tid is not None and scope.get(int(tid), set()) & allowed:
|
||||
out.append(t)
|
||||
return out
|
||||
|
||||
|
||||
def email_task_access(st: Any, email: str, task: dict[str, Any],
|
||||
lookup: UserLookup | None = None) -> str | None:
|
||||
"""이메일(알림·멘션 대상)이 지금 이 작업을 볼 수 있는지. 등록 안 된 사람·모듈 권한 없는 사람은 None."""
|
||||
rec = (lookup or default_user_lookup)(email)
|
||||
if not rec:
|
||||
return None
|
||||
rec = {**rec, "email": rec.get("email") or email}
|
||||
return task_access(st, rec, task)
|
||||
|
||||
|
||||
def filter_recipients(st: Any, task: dict[str, Any], emails: Iterable[str],
|
||||
lookup: UserLookup | None = None) -> list[str]:
|
||||
"""알림·메일·멘션 대상 중 지금 이 작업을 볼 수 있는 사람만(순서 유지, 중복 제거)."""
|
||||
out: list[str] = []
|
||||
seen: set[str] = set()
|
||||
for e in emails:
|
||||
em = store.norm_str(e, lower=True)
|
||||
if not em or em in seen:
|
||||
continue
|
||||
seen.add(em)
|
||||
if email_task_access(st, em, task, lookup) is not None:
|
||||
out.append(em)
|
||||
return out
|
||||
|
||||
|
||||
def can_assign(st: Any, email: str, project_id: Any, lookup: UserLookup | None = None) -> bool:
|
||||
"""담당자·소유자 후보 — 등록된 사용자이고 project 모듈 권한이 있으며, 그 프로젝트를
|
||||
관리할 수 있어야 한다(관리자 포함). 권한 없는 사람에게 작업 정보가 담긴 알림이 가지 않게."""
|
||||
rec = (lookup or default_user_lookup)(email)
|
||||
if not rec:
|
||||
return False
|
||||
rec = {**rec, "email": rec.get("email") or email}
|
||||
return can_manage_project(st, rec, project_id)
|
||||
Some files were not shown because too many files have changed in this diff Show More
Reference in New Issue
Block a user