docs(cupang): itemcode_db 실제 스키마 반영 (single_items/set_items UNION 검색 SQL)

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

.env.example

@@ -27,13 +27,10 @@ CUSTOMER_ORDER_LIST_URL=/orderlist/
 # CUPANG_DB_URL=postgresql://cupang_app:replace-me@postgres-db:5432/cupang_db
 
 # ─── 상품 검색 (itemcode_db 읽기 전용) ───
-# cupang 출고 라인의 제품코드/제품명을 itemcode_db 에서 검색한다(읽기만).
-# 미설정 시 검색 비활성 → 폼에서 수동 입력. itemcode_db 의 실제 테이블/컬럼은
-# 운영 서버에서 `\dt` / `\d <table>` 로 확인 후 아래 값을 채운다.
+# cupang 설정 화면에서 제품명을 itemcode_db 에서 검색해 등록한다(읽기만).
+# 미설정 시 검색 비활성 → 수동 등록만 가능.
+# itemcode_db 실제 테이블: single_items(낱개) / set_items(세트)
+#   컬럼: item_code, sabangnet_code, name
+# 읽기 전용 역할 itemcode_ro 를 먼저 생성하고(아래 DSN), 낱개+세트 UNION 검색 SQL 사용:
 # 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=
+# ITEMCODE_SEARCH_SQL=SELECT item_code AS code, name AS name, '낱개' AS type FROM single_items WHERE item_code ILIKE %(q)s OR name ILIKE %(q)s UNION ALL SELECT item_code AS code, name AS name, '세트' AS type FROM set_items WHERE item_code ILIKE %(q)s OR name ILIKE %(q)s ORDER BY code ASC LIMIT %(limit)s