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>

.env.example

@@ -20,3 +20,20 @@ CUSTOMER_ORDER_LIST_URL=/orderlist/
 # 설정하면 PostgreSQL 사용, 미설정 시 DATA_DIR/expense.json 사용.
 # DB/역할 생성: scripts/sql/expense_db_init.sql 참고.
 # EXPENSE_DB_URL=postgresql://expense_app:replace-me@postgres-db:5432/expense_db
+
+# ─── 쿠팡 밀크런 모듈 (cupang_db) ───
+# 설정해야 모듈이 동작한다(미설정 시 "설정 필요" 안내, JSON 폴백 없음).
+# DB/역할/스키마/센터 seed 생성: scripts/sql/cupang_db_init.sql 참고.
+# CUPANG_DB_URL=postgresql://cupang_app:replace-me@postgres-db:5432/cupang_db
+
+# ─── 상품 검색 (itemcode_db 읽기 전용) ───
+# cupang 출고 라인의 제품코드/제품명을 itemcode_db 에서 검색한다(읽기만).
+# 미설정 시 검색 비활성 → 폼에서 수동 입력. itemcode_db 의 실제 테이블/컬럼은
+# 운영 서버에서 `\dt` / `\d <table>` 로 확인 후 아래 값을 채운다.
+# ITEMCODE_DB_URL=postgresql://itemcode_ro:replace-me@postgres-db:5432/itemcode_db
+# ITEMCODE_TABLE=products
+# ITEMCODE_CODE_COL=product_code
+# ITEMCODE_NAME_COL=product_name
+# ITEMCODE_TYPE_COL=
+# 낱개/세트가 별도 테이블이면 아래 UNION SQL 직접 지정(code/name/type 별칭, %(q)s, %(limit)s 사용):
+# ITEMCODE_SEARCH_SQL=