# [쿠팡] 쿠팡 밀크런 모듈 — `app/modules/cupang/`, `cupang_db` > 이 모듈만 고칠 때 읽는 요약. 별도 상세 문서 없음 — 이 파일이 기준. > 정적 파일: `app/static/cupang.css`, `app/static/cupang.js`. 템플릿: `templates/`. > 상품은 `itemcode_db` 읽기 전용(`itemcode.py`). ## 출고 달력 / 상자 계산 - 출고 달력·상자 계산이 중심. - 출고 묶음은 **상자 계산 화면의 [분배 확정] 으로만** 만든다. 신규 등록 폼 없음, `/cupang/new` 는 상자 계산으로 리다이렉트. - 확정 조건: 미배분 상자 0 + 담긴 센터마다 출고방식(택배/파렛트) 선택. - 확정 시 센터마다 출고 묶음 1건(`status=출고준비`, 센터입고일 = 출고일 + 1일). - 상자 구성은 `cupang_shipments.box_plan` JSONB 에 스냅샷(혼합 상자 내용물·상자 종류 표시용). - 출고리스트 엑셀 자동 다운로드(`GET /cupang/export.xlsx?date=`, 시트명 YYYYMMDD). - 양식 생성은 `export.py` 한 곳에서 만들어 xlsx·구글시트가 공유. - 작업 중 상태는 `cupang_box_calc_drafts` 에 이름 붙여 임시 저장/불러오기. ## 구글 시트 동기화 - `CUPANG_SHEET_ID` + 인증(사용자 OAuth `GOOGLE_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`.