Files

T

king f1097b85dc feat(dispatch): Shopee 플랫폼 추가 + 받는 사람 정보 저장/출고 엑셀

- 플랫폼 TikTok/Shopee 분리: 업로드 화면이 선택에 따라 파일 안내 변경
  (TikTok=Order Export xlsx, Shopee=Packing List xlsx / 라벨 PDF 선택)
- TikTok Picking List.pdf 업로드 제거(피킹 요약은 데이터 엑셀로 생성)
- 파서 공용화 + 헤더 행 자동탐지(Shopee 제목행 대응), 두 포맷 헤더 별칭 통합
- 받는 사람 이름/전화/주소를 박스 단위로 dispatch_db 에 저장(개인정보)
  · init SQL 갱신 + 기존 DB용 멱등 마이그레이션 dispatch_add_recipient_columns.sql
- 출고 작업 카드: Package 제거, 받는 사람 이름(크게)+주소(여러 줄)+전화 표시
- 배치 다운로드 zip 에 취합 출고 엑셀 포함
  파일명 YYYY.MM.DD(Ddd)_tictoc.xlsx / _shopee.xlsx (export.py)
- 문서(CLAUDE.md, DISPATCH_MODULE.md) PII 보관·Shopee 반영

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

2026-06-22 14:16:11 +09:00

5.6 KiB

Raw Blame History

main-app ERP 프로젝트 작업 기준

이 문서는 Claude Code가 이 저장소에서 작업할 때 가장 먼저 확인하는 기준 문서입니다. 작업 시작 전, 아래 "반드시 먼저 읽을 문서"를 모두 확인한 뒤 작업을 시작합니다.

반드시 먼저 읽을 문서

Claude Code는 이 저장소에서 작업을 시작하기 전에 반드시 아래 문서를 순서대로 읽고 맥락을 확보한 뒤 작업한다.

docs/PROJECT_OVERVIEW.md — 프로젝트 정의, 기능 범위, 연동 대상
docs/SERVER_ARCHITECTURE.md — 서버 구성도와 네트워크 흐름
docs/DATABASES.md — PostgreSQL DB 구성과 명명 규칙
docs/DEPLOYMENT.md — 배포 경로, 서비스 실행 방식, 복구 절차

문서 간 내용이 충돌하면 위의 우선순위(1 → 4)를 따른다.

프로젝트 한 줄 정의

main-app은 DBX ERP 시스템의 메인 프로젝트(허브) 이다.

담당 영역:

주문관리
상품코드 매칭
재고관리
CS관리
반품관리
외부 쇼핑몰 API 연동 (카페24, 네이버 스마트스토어, 사방넷 등)
개인경비 (app/modules/expense/, expense_db)
쿠팡 밀크런 (app/modules/cupang/, cupang_db) — 출고 달력/박스 입수량 계산/입고센터 관리, 상품은 itemcode_db 읽기 전용
휴가 관리 (app/modules/vacation/, vacation_db) — 월간 달력(구글식 bar)/연차·반차 신청/승인 워크플로/공휴일·연차 설정. 권한키 vacation·vacation_approver
말레이시아 창고 재고관리 (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

상세는 docs/PROJECT_OVERVIEW.md.

개발 원칙

기존 코드를 수정하기 전 관련 파일을 먼저 읽고 구조를 파악한다.
위험 명령은 반드시 사용자 확인 후 실행한다 (아래 "위험 명령" 절 참고).
.env, API 키, DB 비밀번호, OAuth Secret, 토큰은 절대 Git에 올리지 않는다.
신규 DB가 필요하면 승인 요청 후 생성하며, DB명은 반드시 _db로 끝낸다 (예: inventory_db).
예전 문서/코드의 orderlist_app은 현재 기준 orderlist_db이다. 발견 시 수정 대상.

위험 명령 (사용자 확인 없이 실행 금지)

아래 명령은 반드시 사용자에게 의도를 설명하고 명시적 승인을 받은 뒤 실행한다.

분류	명령 예시
파일 삭제	`rm -rf`, `Remove-Item -Recurse -Force`
DB 파괴	`DROP DATABASE`, `DROP TABLE`, `DROP SCHEMA`
데이터 삭제	`TRUNCATE`, 조건 없는 대량 `DELETE`, `UPDATE`
Docker 파괴	`docker volume rm`, `docker volume prune`, `docker system prune -a --volumes`
Git 파괴	`git reset --hard`, `git push --force`, `git clean -fd`, `git branch -D`
운영 초기화	운영 DB 덤프 덮어쓰기, 마이그레이션 롤백

원칙:

실행 전 현재 상태 확인 명령을 먼저 보여준다 (예: docker ps, \l, git status).
백업 존재 여부와 위치를 명시한다.
실행 후 결과 확인 절차를 같이 제시한다.

서버 작업 원칙

배포, DB 복구, Docker 작업 전에는 현재 상태 확인 명령을 먼저 제안한다.
PostgreSQL 작업 전에는 DB명, 컨테이너명, 포트, 백업 위치를 확인한다.
운영 서버 경로와 개발 PC 경로를 혼동하지 않는다.
- 개발 PC: G:\내 드라이브\프로젝트\Main-app
- 운영 서버 (main-app): /opt/www/main ← 본 프로젝트 경로
- 참고용 (같은 호스트 내 다른 서비스 경로): /opt/dbx-corm, /opt/dbx-orderlist
- 명령 예시·문서 작성 시 main-app 경로는 반드시 /opt/www/main 사용. 상세는 docs/DEPLOYMENT.md.

환경 변수 / 비밀값

.env, .env.local, .env.production 은 Git에 절대 커밋하지 않는다.
예시 파일(*.example)만 커밋한다.
비밀값 유출이 의심되면 즉시 회전(rotate)을 권고한다.
신규 환경변수 추가 시 *.example 파일과 본 문서(또는 docs/DEPLOYMENT.md)에 변수 설명을 함께 갱신한다.

디렉터리 구조 (요약)

Main-app/
├─ app/                  FastAPI 앱 소스
├─ docs/                 운영/설계 문서 (작업 전 필독)
├─ scripts/              배포·유지보수 스크립트
├─ skills/               Claude Code 규칙/스킬
├─ docker-compose.yml    운영 컴포즈
├─ docker-compose.local.yml  로컬 컴포즈
├─ Dockerfile
├─ requirements.txt
└─ CLAUDE.md             ← 이 문서

5.6 KiB Raw Blame History