e63734c984
- 첫 화면 "+ 신규 등록" 옆 엑셀색 버튼 → 작성일·출고일·센터입고일(프로젝트 날짜 팝업), 입고센터(시트 F열 + 등록 센터, 직접 입력), 출고방식(파렛트/택배), 코드표 검색 제품·수량, 출고, 작업자(기본 핫프렌즈) - POST /cupang/api/outbound-sheet: 출고일 시트 YYYYMMDD(요일) 맨 아래에 기존 양식으로 추가 (순번 이어짐·파렛트 배경색), 시트가 없으면 5행 양식째 생성. cupang_db 에는 저장하지 않음 - GET /cupang/api/outbound-sheet/centers: 입고센터 후보(10분 캐시) - export.build_block 분리(기존 build_table 결과 동일), google_sheets 에 sheet_titles·read_ranges·append_block 추가 - 테스트: pytest(양식·입력 검사·덧붙일 위치·Sheets 요청·실제 앱), Playwright 화면 테스트 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
4.5 KiB
4.5 KiB
[쿠팡] 쿠팡 밀크런 모듈 — app/modules/cupang/, cupang_db
이 모듈만 고칠 때 읽는 요약. 별도 상세 문서 없음 — 이 파일이 기준. 정적 파일:
app/static/cupang.css,app/static/cupang.js. 템플릿:templates/. 상품은itemcode_db읽기 전용(itemcode.py).
출고 달력 / 상자 계산
- 출고 달력·상자 계산이 중심.
- 출고 묶음은 상자 계산 화면의 [분배 확정] 으로만 만든다. 신규 등록 폼 없음,
/cupang/new는 상자 계산으로 리다이렉트. - 확정 조건: 미배분 상자 0 + 담긴 센터마다 출고방식(택배/파렛트) 선택.
- 확정 시 센터마다 출고 묶음 1건(
status=출고준비, 센터입고일 = 출고일 + 1일).- 상자 구성은
cupang_shipments.box_planJSONB 에 스냅샷(혼합 상자 내용물·상자 종류 표시용). - 출고리스트 엑셀 자동 다운로드(
GET /cupang/export.xlsx?date=, 시트명 YYYYMMDD).
- 상자 구성은
- 양식 생성은
export.py한 곳에서 만들어 xlsx·구글시트가 공유. - 작업 중 상태는
cupang_box_calc_drafts에 이름 붙여 임시 저장/불러오기.
구글 시트 동기화
CUPANG_SHEET_ID+ 인증(사용자 OAuthGOOGLE_SHEETS_OAUTH_REFRESH_TOKEN또는 서비스 계정GOOGLE_SHEETS_CREDENTIALS[_JSON]) 설정 시 확정과 동시에 Google 스프레드시트에 출고일 시트를 생성/덮어쓰기(app/integrations/google_sheets.py, 미설정이면 조용히 skip).- 출고 삭제(건별/날짜 전체) 시에도 같은 날짜 시트 동기화 — 남은 출고가 있으면 다시 쓰고, 없으면 시트 삭제 (문서에 시트가 하나뿐이면 내용만 비움).
제품 포장무게
- 설정(제품명)에서 제품별 포장무게(g,
cupang_products.weight_g, 마이그레이션 007 + 시드) 입력·표시·정렬. - 출고 상세 상자 목록에 상자별 무게 합계(수량 × 지금 포장무게,
router._attach_box_weights).- 무게 없는 제품은 "일부 미입력".
- 화면은 kg 소수 첫째 자리 사사오입(
router._g_to_kg) + 맨 아래 수량·무게 합계 행(앞 3열 병합). - 표 칸 모두 가운데 정렬, 요약 카드와 20px 간격.
- 상자 목록 엑셀에도 무게(g) 열.
쿠팡 발주 엑셀 업로드
- 다중 업로드(
POST /cupang/api/box-calc/upload, openpyxl). - F13 입고예정일의 하루 전 = 출고일.
- 22행부터 B=쿠팡상품코드·F=센터명·G=수량을 읽어
cupang_products.coupang_item_code로 제품 매칭 → 센터별 합산 → 센터 단위로 상자 계산·자동 배분.
쿠팡 로켓 매출 (/cupang/sales)
- 테이블
cupang_sales·cupang_sales_weekly. 발주 라인별 공급가·원가·물류비·마진 표. - 기간/센터/유형/검색 조회, 행 CRUD, 엑셀 다운로드.
- 구글 시트 양식 xlsx·csv 업로드(
sales_import.py) — 같은 발주번호+SKU+출고일+센터+수량은 덮어씀. - 광고비·할인 프로모션·장려금은 주차 단위(
cupang_sales_weekly)로 보관, 순마진은 화면에서 계산. - 초기 데이터는
scripts/sql/cupang_sales_seed.sql.
밀크런 출고리스트 작성 (팝업 → 구글 시트, 2026-10-23)
- 첫 화면 "+ 신규 등록" 옆 엑셀색(#217346) 버튼 → 팝업(
index.html+static/cupang-outbound.js). 상자 계산 없이 센터 1곳을 구글 시트에만 적는다 — cupang_db 출고 묶음은 만들지 않는다(달력에 안 보임). - 입력: 작성일(기본 오늘)·출고일·센터입고일(출고일 고르면 +1일 자동) — 날짜 칸은 프로젝트 날짜 팝업
(
PJLib.enhanceDateInput, project.js 를PJ_LIB_ONLY로 로드). 입고센터(시트 F열 + 등록 센터, 직접 입력 가능), 출고방식(파렛트/택배), 제품(코드표GET /cupang/api/products/all검색 → 코드·이름 자동, 수량 수기), 출고(수기), 작업자(기본export.WORKER). POST /cupang/api/outbound-sheet→ 시트YYYYMMDD(요일)(출고일) 맨 아래에export.build_block으로 덧붙임 (순번 B열 이어짐, 파렛트면 배경색). 시트가 없거나 5행 머리글이 없으면 양식째 새로 쓴다(write_table). 위치 읽기~쓰기는writer.lock으로 한 덩어리. 입고센터 후보는GET /cupang/api/outbound-sheet/centers(10분 캐시).- 주의: 같은 출고일에 [분배 확정]·출고 삭제가 일어나면 기존 동기화가 그 날짜 시트를 DB 기준으로 통째로 다시 써서 팝업으로 적은 줄이 사라진다.