Files
dbx-main/app/modules/cupang/CLAUDE.md
T
king 7e459c1926 feat(cupang): 출고리스트 작성 — 입고센터별 입력·기본 택배·완료 진행 막대(%)
- 팝업에 입고센터 카드: [+ 입고센터 추가]·[센터 삭제], 센터마다 입고센터·출고방식·제품·출고를 따로 입력
  (작성일·출고일·센터입고일·작업자는 공통), 출고방식 기본값 택배
- POST /cupang/api/outbound-sheet: centers 목록을 받아 센터 순서대로 출고일 시트 아래에 덧붙임
  (엑셀 내려받기·올리기 1번씩, 순번 이어짐, 파렛트 센터만 배경색). centers 없으면 예전처럼 센터 1곳
- ?stream=1 이면 단계별 진행률을 NDJSON 으로 흘려보냄(내려받기 → 센터별 추가 → 올리기 → 완료/오류),
  팝업은 막대 그래프와 %로 표시하고 단계 사이에도 조금씩 채움, 실패하면 빨간 막대 + 사유
- 테스트: pytest(센터별 입력 검사·여러 센터 한 번에 쓰기·진행 단계·스트림·충돌), Playwright(카드·진행 막대·완료·실패·모바일)

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-23 16:20:21 +09:00

6.6 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_plan JSONB 에 스냅샷(혼합 상자 내용물·상자 종류 표시용).
    • 출고리스트 엑셀 자동 다운로드(GET /cupang/export.xlsx?date=, 시트명 YYYYMMDD).
  • 양식 생성은 export.py 한 곳에서 만들어 xlsx·구글시트가 공유.
  • 작업 중 상태는 cupang_box_calc_drafts 에 이름 붙여 임시 저장/불러오기.

출고리스트 문서 동기화 (드라이브 엑셀 파일)

  • 출고리스트 문서는 구글 드라이브에 올린 .xlsx 파일(CUPANG_SHEET_ID, 기본 router.DEFAULT_SHEET_ID = 1J74op7lBZOgE27p4R28I3RWsv0EtXdii). router._sheet_target 이 드라이브에서 형식을 보고 writer 를 고른다:
    • .xlsx → app/integrations/drive_xlsx.py — 내려받아 openpyxl 로 고친 뒤 같은 파일 id 에 다시 올림 (인증은 google_drive 와 같음: 서비스 계정 또는 GOOGLE_SLIDES_OAUTH_REFRESH_TOKEN/GOOGLE_SHEETS_OAUTH_REFRESH_TOKEN, Drive 권한). with writer.lock: 블록 = 내려받기 1번·올리기 1번. 올리기 직전 version 이 바뀌었으면(누가 고침) _in_sheet 가 처음부터 다시(3번).
    • 구글 시트 문서 → 예전처럼 google_sheets.py(Sheets API). 드라이브 인증이 없을 때도 이쪽.
    • 엑셀은 openpyxl 로 다시 저장하므로 파일 안 그림·차트는 사라진다(출고리스트에는 없음).
  • 인증이 없으면 조용히 skip. 확정과 동시에 출고일 시트를 생성/덮어쓰기.
  • 출고 삭제(건별/날짜 전체) 시에도 같은 날짜 시트 동기화 — 남은 출고가 있으면 다시 쓰고, 없으면 시트 삭제 (문서에 시트가 하나뿐이면 내용만 비움).

제품 포장무게

  • 설정(제품명)에서 제품별 포장무게(g, cupang_products.weight_g, 마이그레이션 007 + 시드) 입력·표시·정렬.
  • 출고 상세 상자 목록에 상자별 무게 합계(수량 × 지금 포장무게, router._attach_box_weights).
    • 무게 없는 제품은 "일부 미입력".
    • 화면은 kg 소수 첫째 자리 사사오입(router._g_to_kg) + 맨 아래 수량·무게 합계 행(앞 3열 병합).
    • 표 칸 모두 가운데 정렬, 요약 카드와 20px 간격.
  • 상자 목록 엑셀에도 무게(g) 열.

쿠팡 발주 엑셀 업로드

  • 다중 업로드(POST /cupang/api/box-calc/upload, openpyxl).
  • F13 입고예정일의 하루 전 = 출고일.
  • 22행부터 B=쿠팡상품코드·F=센터명·G=수량을 읽어 cupang_products.coupang_item_code 로 제품 매칭 → 센터별 합산 → 센터 단위로 상자 계산·자동 배분.

쿠팡 로켓 매출 (/cupang/sales)

  • 테이블 cupang_sales·cupang_sales_weekly. 발주 라인별 공급가·원가·물류비·마진 표.
  • 기간/센터/유형/검색 조회, 행 CRUD, 엑셀 다운로드.
  • 구글 시트 양식 xlsx·csv 업로드(sales_import.py) — 같은 발주번호+SKU+출고일+센터+수량은 덮어씀.
  • 광고비·할인 프로모션·장려금은 주차 단위(cupang_sales_weekly)로 보관, 순마진은 화면에서 계산.
  • 초기 데이터는 scripts/sql/cupang_sales_seed.sql.

밀크런 출고리스트 작성 (팝업 → 드라이브 엑셀 파일, 2026-10-23)

  • 첫 화면 "+ 신규 등록" 옆 엑셀색(#217346) 버튼 → 팝업(index.html + static/cupang-outbound.js). 상자 계산 없이 입고센터 여러 곳을 한 번에 출고리스트 엑셀 파일에만 적는다 — cupang_db 출고 묶음은 만들지 않는다(달력에 안 보임).
  • 대상 파일은 router._outbound_target — CUPANG_OUTBOUND_XLSX_ID(기본 DEFAULT_OUTBOUND_XLSX_ID = 1J74op7lBZOgE27p4R28I3RWsv0EtXdii), 항상 drive_xlsx. CUPANG_SHEET_ID(분배 확정 동기화)와 따로라 그게 구글 시트 문서여도 팝업은 엑셀에만 쓴다. 드라이브 인증이 없거나 파일이 .xlsx 가 아니면 구글 시트로 대신 쓰지 않고 503(사유 표시).
  • 공통 입력: 작성일(기본 오늘)·출고일·센터입고일(출고일 고르면 +1일 자동)·작업자(기본 export.WORKER) — 날짜 칸은 프로젝트 날짜 팝업 (PJLib.enhanceDateInput, project.js 를 PJ_LIB_ONLY 로 로드).
  • 입고센터 카드(#cpg-ol-center-tpl, [+ 입고센터 추가]·[센터 삭제], 최대 20곳): 센터마다 입고센터(시트 F열 + 등록 센터, 직접 입력 가능), 출고방식(기본 택배/파렛트), 제품(코드표 GET /cupang/api/products/all 검색 → 코드·이름 자동, 수량 수기), 출고(수기).
  • POST /cupang/api/outbound-sheet 본문 {document_date, ship_date, center_arrival_date, worker, centers: [{center, ship_method, outbound, lines}]} (centers 없으면 본문 자체가 센터 1곳 — _clean_outbound_entries). 센터 순서대로 시트 YYYYMMDD(요일)(출고일) 맨 아래에 export.build_block 으로 덧붙임(순번 B열 이어짐, 파렛트 센터만 배경색). 시트가 없거나 5행 머리글이 없으면 첫 센터는 양식째 새로 쓴다(write_table). 전체가 writer.lock 한 덩어리 = 엑셀 내려받기 1번·올리기 1번(_run_outbound_write). 입고센터 후보는 GET /cupang/api/outbound-sheet/centers(10분 캐시).
  • 진행 막대: 팝업은 ?stream=1 로 보내고 서버가 NDJSON 한 줄씩 {progress, until, step}(5 내려받기 → 40~80 센터별 추가 → 80 올리기) … 마지막 {done: true, ...결과} 또는 {error}. 쓰기는 별도 스레드(잠금은 잡은 스레드에서 풀어야 함)가 하고 큐로 넘긴다. 화면은 단계 사이에도 다음 단계(until) 바로 앞까지 조금씩 채우고 %를 같이 표시, 실패면 빨강. 입력 오류(400)·설정 없음(503)은 스트림 전 보통 JSON.
  • 주의: 같은 출고일에 [분배 확정]·출고 삭제가 일어나면 기존 동기화가 그 날짜 시트를 DB 기준으로 통째로 다시 써서 팝업으로 적은 줄이 사라진다.