Files

T

king 9e707be5ac feat(cupang): 쿠팡 밀크런 모듈 추가 (출고 달력/박스계산/입고센터)

- app/modules/cupang: router/db/store/itemcode + 템플릿 5종
- cupang_db 전용(JSON 폴백 없음). CUPANG_DB_URL 미설정 시 안내 페이지
- 월간 달력 + 출고 묶음(헤더+라인), 박스 입수량 자동계산(서버 재계산)
- 입고센터 관리(사용중 soft delete), 박스규칙 upsert, 엑셀 내보내기
- 상품 검색은 itemcode_db 읽기 전용(미설정 시 수동 입력)
- MODULE_KEYS/메뉴/아이콘/라벨 동기화, scripts/sql/cupang_db_init.sql(멱등)
- app/data/ gitignore 추가(PII)

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

2026-05-29 20:47:32 +09:00

4.3 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 읽기 전용

상세는 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             ← 이 문서

4.3 KiB Raw Blame History