feat(performance): 네이버 스마트스토어 매출 수집 — 커머스API 토큰·결제일 기준 주문 조회

- 인증: bcrypt 전자서명(client_secret_sign) → OAuth2 client_credentials 토큰, 암호화 저장·만료 5분 전 재발급,
  401 이면 한 번 새로 받아 재호출, 연결 테스트는 항상 새 토큰
- 수집: 조건형 상품 주문 상세 조회(rangeType=PAYED_DATETIME) 하루씩·페이지, 호출 간격·429 재시도
- 1차 매출 규칙: 주문 단위, 결제일, totalPaymentAmount 합 + 배송비(한 번, 배송비 할인 뺌),
  취소·반품 완료·미입금 취소 제외, replace_range
- 설정 화면 "쇼핑몰 원본 데이터 확인"을 네이버·11번가 공용으로 — 네이버는 항목·상태별 합계와
  날짜별 현재 규칙 매출(개인정보는 값 숨김)
- requirements: bcrypt, 테스트 3개 추가(26개 통과), 문서 갱신

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
2026-09-30 13:33:53 +09:00
parent f037ea7de0
commit a5f90a0343
7 changed files with 611 additions and 18 deletions
@@ -966,6 +966,185 @@ def test_registry_and_event_validation():
raise AssertionError(f"검증 실패해야 함: {bad.event_type} {bad.amount}")
def _naver_item(order_id, po_id, pay_day, amount, *, status="PAYED", ship=0, ship_dc=0, qty=1, dc=0, name="밀폐용기"):
"""조건형 상품 주문 조회 응답의 contents[] 한 줄(개인정보 항목 포함 — 저장 안 되는지 확인용)."""
return {"productOrderId": po_id, "content": {
"order": {"orderId": order_id, "paymentDate": f"{pay_day}T10:11:12.0+09:00", "orderDate": f"{pay_day}T10:10:00.0+09:00",
"ordererName": "홍길동", "ordererTel": "010-1234-5678", "ordererId": "hong***"},
"productOrder": {"productOrderId": po_id, "productOrderStatus": status, "productName": name, "productOption": "3개입",
"quantity": qty, "totalPaymentAmount": amount, "productDiscountAmount": dc,
"deliveryFeeAmount": ship, "deliveryDiscountAmount": ship_dc,
"shippingAddress": {"name": "홍길동", "tel1": "010-1234-5678", "baseAddress": "서울시 어딘가"}},
}}
def test_naver_sign_token_and_connection():
"""네이버: bcrypt 전자서명 → 토큰(form) → Bearer 로 조건형 주문 조회. 시크릿·토큰은 오류 문구에 없음."""
import base64
import bcrypt
import httpx
from app.modules.performance.adapters import naver as nv
from app.modules.performance.adapters.base import AdapterContext
secret = bcrypt.gensalt(rounds=4).decode()
sig = nv.sign("my-app-id", secret, 1727600000000)
assert bcrypt.checkpw(b"my-app-id_1727600000000", base64.b64decode(sig))
try:
nv.sign("my-app-id", "not-a-bcrypt-salt", 1)
except AuthFailed as exc:
assert "not-a-bcrypt-salt" not in exc.message
else:
raise AssertionError("시크릿 형식 오류여야 합니다")
class Creds(dict):
def get(self, k, default=""):
return dict.get(self, k, default)
def has(self, k):
return bool(dict.get(self, k))
def set(self, k, v):
self[k] = v
ctx = AdapterContext(code="naver", credentials=Creds(client_id="my-app-id", client_secret=secret))
seen = {"gets": []}
def post(url, data=None, timeout=None, headers=None):
seen["post"] = (url, dict(data))
return httpx.Response(200, json={"access_token": "TOKEN-XYZ", "expires_in": 10799, "token_type": "Bearer"})
def get(url, params=None, headers=None, timeout=None):
seen["gets"].append((url, dict(params), headers["Authorization"]))
return httpx.Response(200, json={"data": {"contents": [_naver_item("O1", "P1", "2026-09-30", 12000)],
"pagination": {"page": 1, "size": 100, "hasNext": False}}})
orig = (httpx.post, httpx.get, nv.CALL_INTERVAL_SEC)
httpx.post, httpx.get, nv.CALL_INTERVAL_SEC = post, get, 0
try:
msg = nv.NaverAdapter().test_connection(ctx)
assert "연결 정상" in msg and "1건" in msg
url, form = seen["post"]
assert url.endswith("/external/v1/oauth2/token") and form["type"] == "SELF" and form["grant_type"] == "client_credentials"
assert bcrypt.checkpw(f"my-app-id_{form['timestamp']}".encode(), base64.b64decode(form["client_secret_sign"]))
gurl, params, auth = seen["gets"][0]
assert gurl.endswith("/v1/pay-order/seller/product-orders") and auth == "Bearer TOKEN-XYZ"
assert params["rangeType"] == "PAYED_DATETIME" and params["from"].endswith("T00:00:00.000+09:00")
assert params["to"].endswith("T23:59:59.999+09:00") and params["from"][:10] == params["to"][:10]
assert ctx.credentials["access_token"] == "TOKEN-XYZ" and int(ctx.credentials["access_token_expires_at"]) > 0
# 토큰 발급 거부 → 인증 실패(시크릿·서명은 문구에 없음)
httpx.post = lambda url, data=None, timeout=None, headers=None: httpx.Response(
400, json={"code": "BadRequest", "message": "client_secret_sign 이 올바르지 않습니다"})
try:
nv.NaverAdapter().test_connection(ctx)
except AuthFailed as exc:
assert secret not in exc.message and "올바르지 않습니다" in exc.message
else:
raise AssertionError("인증 실패여야 합니다")
# 주문 조회 403(IP 미등록 등) → 인증 실패 안내
httpx.post = post
httpx.get = lambda url, params=None, headers=None, timeout=None: httpx.Response(
403, json={"code": "GW.IP_NOT_ALLOWED", "message": "허용되지 않은 IP"})
try:
nv.NaverAdapter().test_connection(ctx)
except AuthFailed as exc:
assert "허용되지 않은 IP" in exc.message and "TOKEN-XYZ" not in exc.message
else:
raise AssertionError("권한 거부여야 합니다")
finally:
httpx.post, httpx.get, nv.CALL_INTERVAL_SEC = orig
def test_naver_collect_sales():
"""네이버 매출 = 주문 단위, 결제일 기준. 상품주문 결제금액 합 + 배송비(주문에서 한 번, 배송비 할인 뺌).
취소·반품 완료·미입금 취소 상품주문은 뺀다. 페이지를 넘겨 받고, 구매자 정보는 저장하지 않는다."""
import bcrypt
import httpx
from app.modules.performance.adapters import naver as nv
pages = {
("2026-09-09", 1): ([_naver_item("A", "A1", "2026-09-09", 20000, ship=3000, qty=2, dc=1000),
_naver_item("A", "A2", "2026-09-09", 5000, ship=3000, name="뚜껑")], True),
("2026-09-09", 2): ([_naver_item("B", "B1", "2026-09-09", 9900, status="CANCELED")], False),
("2026-09-10", 1): ([_naver_item("C", "C1", "2026-09-10", 15000, ship=3000, ship_dc=3000, status="PURCHASE_DECIDED"),
_naver_item("C", "C2", "2026-09-10", 7000, status="RETURNED"),
_naver_item("D", "D1", "2026-09-10", 4000, status="CANCELED_BY_NOPAYMENT")], False),
}
calls = []
def get(url, params=None, headers=None, timeout=None):
key = (params["from"][:10], params["page"])
calls.append(key)
rows, more = pages.get(key, ([], False))
return httpx.Response(200, json={"data": {"contents": rows, "pagination": {"page": params["page"], "hasNext": more}}})
def post(url, data=None, timeout=None, headers=None):
return httpx.Response(200, json={"access_token": "TOKEN-N", "expires_in": 10799})
st = FakeStore()
creds = CredentialService(st, lambda: ring())
creds.save(next(a for a in all_adapters() if a.code == "naver"),
{"client_id": "app-id", "client_secret": bcrypt.gensalt(rounds=4).decode()})
orig = (httpx.post, httpx.get, nv.CALL_INTERVAL_SEC)
httpx.post, httpx.get, nv.CALL_INTERVAL_SEC = post, get, 0
try:
r = SyncService(st, creds).sync_marketplace("naver", date(2026, 9, 9), date(2026, 9, 10))
finally:
httpx.post, httpx.get, nv.CALL_INTERVAL_SEC = orig
assert r["ok"], r
ev_ = {k[2]: v for k, v in st.events.items() if k[0] == "naver"}
assert set(ev_) == {"naver:A", "naver:C"} # B 취소·D 미입금취소 제외
assert ev_["naver:A"]["amount"] == 20000 + 5000 + 3000 # 배송비는 주문에서 한 번
assert ev_["naver:A"]["quantity"] == 3 and ev_["naver:A"]["discount_amount"] == 1000
assert ev_["naver:A"]["sales_date"] == date(2026, 9, 9) and ev_["naver:A"]["product_name"] == "밀폐용기 외 1건"
assert ev_["naver:C"]["amount"] == 15000 # 반품 줄 제외, 무료배송(할인) 0
assert ev_["naver:C"]["order_status"] == "구매확정"
assert ("2026-09-09", 2) in calls and ("2026-09-10", 2) not in calls # hasNext 일 때만 다음 쪽
assert "홍길동" not in repr(st.events) and "010-1234-5678" not in repr(st.events)
def test_naver_reconcile_hides_personal():
import httpx
from app.modules.performance.adapters import naver as nv
from app.modules.performance.adapters.base import AdapterContext
class Creds(dict):
def get(self, k, default=""):
return dict.get(self, k, default)
def has(self, k):
return bool(dict.get(self, k))
def set(self, k, v):
self[k] = v
import time as _t
ctx = AdapterContext(code="naver", credentials=Creds(client_id="x", client_secret="y", access_token="T",
access_token_expires_at=str(int(_t.time()) + 9999)))
rows = [_naver_item("A", "A1", "2026-09-09", 20000, ship=3000), _naver_item("B", "B1", "2026-09-09", 9900, status="CANCELED")]
orig = (httpx.get, nv.CALL_INTERVAL_SEC)
httpx.get = lambda url, params=None, headers=None, timeout=None: httpx.Response(
200, json={"data": {"contents": rows if params["from"].startswith("2026-09-09") else []}})
nv.CALL_INTERVAL_SEC = 0
try:
rec = nv.NaverAdapter().reconcile(ctx, date(2026, 9, 9), to=date(2026, 9, 10))
finally:
httpx.get, nv.CALL_INTERVAL_SEC = orig
allp = rec["probes"][0]
assert allp["ok"] and allp["count"] == 2
f = {x["name"]: x for x in allp["fields"]}
assert f["productOrder.totalPaymentAmount"]["sum"] == 29900
assert f["order.ordererName"]["personal"] and f["order.ordererName"]["sample"] == ""
assert f["productOrder.shippingAddress.baseAddress"]["personal"]
assert not f["productOrder.productName"]["personal"] and f["productOrder.productName"]["sample"] == "밀폐용기"
assert "홍길동" not in repr(rec) and "010-1234-5678" not in repr(rec)
assert rec["days"] == [{"date": "2026-09-09", "orders": 1, "amount": 23000}, {"date": "2026-09-10", "orders": 0, "amount": 0}]
assert any("매출 제외" in p["label"] for p in rec["probes"])
if __name__ == "__main__":
os.environ.pop("APP_ENCRYPTION_KEY", None)
n = 0