feat(performance): 실적(쇼핑몰 통합 매출) 모듈 1단계 — 대시보드·설정·보안·어댑터 구조
- 네 영역 분리: ① 수집(adapters/ 쇼핑몰 10곳 + sync.py) ② 보안(security/ + credentials.py) ③ 계산·저장(calc.py + db.py) ④ 화면(dashboard.py, router.py, templates, performance.css/js) - 대시보드: 기간(오늘/이번주/이번달/올해/직접선택, 이전·다음), 쇼핑몰 필터, KPI 5개(진행 중 기간은 직전 기간 같은 경과일 대비), 일자×쇼핑몰 표(주간합계, 총매출/수수료/차감매출 전환), 일별 추이· 쇼핑몰 비중(SVG), 월 누적(비중)·연간 누적, 금액 클릭 → 주문 상세 - 설정(관리자): 사용/매출 집계, 수수료율 이력(적용 시작일), 쇼핑몰별 API 인증정보 입력·연결 테스트· 연결 상태, 마스터 키 상태·재암호화, 테스트(모의) 데이터 생성/삭제 - 인증정보: 설정 화면 입력 → AES-256-GCM(키 버전, AAD=쇼핑몰+항목) 암호화 저장, secret 원문은 화면으로 다시 보내지 않음, 오류·로그·raw 는 비밀값 가린 뒤 저장. 마스터 키는 APP_ENCRYPTION_KEY(.env) - 매출 기준일: 결제=결제일, 취소·반품=발생일. 금액 원 단위 정수, 수수료 반올림은 calc.commission 한 곳 - 동기화: 같은 쇼핑몰 동시 실행 차단(running 부분 유니크), 쇼핑몰별 실패 격리, 중복 방지 UNIQUE+UPSERT - 카페24 어댑터는 기존 app/integrations/cafe24 OAuth 토큰 재사용, 나머지는 입력칸만(수집은 다음 단계) - performance_db 초기화 스크립트, 권한키 performance(설정은 is_admin), 문서·.env.example Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
@@ -0,0 +1,5 @@
|
||||
"""① 쇼핑몰 API 수집 — 쇼핑몰별 어댑터(공통 인터페이스는 base.py, 목록은 registry.py)."""
|
||||
|
||||
from .registry import all_adapters, get_adapter
|
||||
|
||||
__all__ = ["all_adapters", "get_adapter"]
|
||||
@@ -0,0 +1,215 @@
|
||||
"""① 쇼핑몰 API 수집 — 공통 인터페이스.
|
||||
|
||||
쇼핑몰 하나 = 어댑터 파일 하나. 새 쇼핑몰은 `MarketplaceAdapter` 를 상속한 파일을
|
||||
만들고 `registry.py` 에 한 줄 추가하면 설정 화면·동기화·대시보드에 자동으로 붙는다.
|
||||
|
||||
흐름: 쇼핑몰 원본 → 어댑터(fetch_* → normalize_*) → 공통 SaleEvent → sync 서비스가 DB 저장
|
||||
|
||||
어댑터가 지켜야 할 것:
|
||||
- 인증정보는 `ctx.credentials.get(key)` 로만 꺼낸다(복호화는 서버 안에서만).
|
||||
- 새 토큰은 `ctx.credentials.set(key, value)` 로 저장한다(자동 암호화).
|
||||
- 오류는 아래 AdapterError 계열로 던진다. 메시지에 비밀값을 넣지 않는다
|
||||
(sync 서비스가 한 번 더 가리지만, 애초에 넣지 않는 것이 원칙).
|
||||
- 금액은 원 단위 정수(int). 결제는 +, 취소/반품은 − 로 만든다.
|
||||
- 날짜 기준을 섞지 않는다: order_date / payment_date / event_date 를 각각 채운다.
|
||||
집계 기준일(sales_date)은 sync 서비스가 정한다(결제=결제일, 취소·반품=발생일).
|
||||
"""
|
||||
|
||||
from __future__ import annotations
|
||||
|
||||
from abc import ABC
|
||||
from dataclasses import dataclass, field
|
||||
from datetime import date
|
||||
from typing import Any, Iterable, Protocol
|
||||
|
||||
# 연결 상태 코드 → 화면 표시. DB CHECK 제약과 같은 목록.
|
||||
STATUS_LABELS: dict[str, str] = {
|
||||
"ok": "정상 연결",
|
||||
"not_configured": "인증정보 미설정",
|
||||
"auth_failed": "인증 실패",
|
||||
"token_expired": "Token 만료",
|
||||
"api_error": "API 오류",
|
||||
"not_implemented": "연동 준비 중",
|
||||
"unknown": "확인 전",
|
||||
"disabled": "사용 중지", # DB 에는 저장하지 않는 화면 전용 상태(쇼핑몰 사용 OFF)
|
||||
}
|
||||
|
||||
EVENT_TYPES = ("SALE", "CANCEL", "RETURN", "ADJUST")
|
||||
|
||||
|
||||
# ════════════════════════════════════════════════════════════
|
||||
# 오류 — status 가 곧 연결 상태 코드
|
||||
# ════════════════════════════════════════════════════════════
|
||||
class AdapterError(Exception):
|
||||
status = "api_error"
|
||||
|
||||
def __init__(self, message: str = "") -> None:
|
||||
super().__init__(message or STATUS_LABELS.get(self.status, "오류"))
|
||||
self.message = message or STATUS_LABELS.get(self.status, "오류")
|
||||
|
||||
|
||||
class NotConfigured(AdapterError):
|
||||
status = "not_configured"
|
||||
|
||||
|
||||
class AuthFailed(AdapterError):
|
||||
status = "auth_failed"
|
||||
|
||||
|
||||
class TokenExpired(AdapterError):
|
||||
status = "token_expired"
|
||||
|
||||
|
||||
class ApiError(AdapterError):
|
||||
status = "api_error"
|
||||
|
||||
|
||||
class NotImplementedYet(AdapterError):
|
||||
status = "not_implemented"
|
||||
|
||||
|
||||
# ════════════════════════════════════════════════════════════
|
||||
# 설정 입력칸 · 공통 매출 사건
|
||||
# ════════════════════════════════════════════════════════════
|
||||
@dataclass(frozen=True)
|
||||
class CredentialField:
|
||||
"""설정 화면 입력칸 하나. secret=True 면 저장 후 값을 화면으로 다시 보내지 않는다.
|
||||
|
||||
internal=True 는 화면에 안 보이는 내부 값(access/refresh token 등) — 어댑터가 직접 저장.
|
||||
"""
|
||||
|
||||
key: str
|
||||
label: str
|
||||
secret: bool = False
|
||||
required: bool = True
|
||||
help: str = ""
|
||||
placeholder: str = ""
|
||||
internal: bool = False
|
||||
|
||||
|
||||
@dataclass
|
||||
class SaleEvent:
|
||||
"""쇼핑몰 원본을 공통 형식으로 바꾼 매출 사건 하나(주문 라인 단위 권장)."""
|
||||
|
||||
event_type: str # SALE / CANCEL / RETURN / ADJUST
|
||||
external_event_id: str # 쇼핑몰 안에서 이 사건을 유일하게 가리키는 값(중복 방지 키)
|
||||
external_order_id: str
|
||||
event_date: date # 사건 발생일(결제=결제일, 취소=취소일, 반품=반품완료일)
|
||||
amount: int # 원 단위 정수. 결제 +, 취소/반품 −
|
||||
external_line_id: str = ""
|
||||
order_date: date | None = None
|
||||
payment_date: date | None = None
|
||||
product_name: str = ""
|
||||
option_name: str = ""
|
||||
quantity: int = 0
|
||||
discount_amount: int = 0
|
||||
order_status: str = ""
|
||||
raw: dict[str, Any] = field(default_factory=dict)
|
||||
|
||||
def validate(self) -> None:
|
||||
if self.event_type not in EVENT_TYPES:
|
||||
raise ValueError(f"알 수 없는 사건 종류: {self.event_type}")
|
||||
if not self.external_event_id or not self.external_order_id:
|
||||
raise ValueError("external_event_id / external_order_id 가 필요합니다.")
|
||||
if not isinstance(self.amount, int) or isinstance(self.amount, bool):
|
||||
raise ValueError("amount 는 원 단위 정수여야 합니다.")
|
||||
if self.event_type == "SALE" and self.amount < 0:
|
||||
raise ValueError("결제(SALE) 금액은 음수일 수 없습니다.")
|
||||
if self.event_type in ("CANCEL", "RETURN") and self.amount > 0:
|
||||
raise ValueError("취소/반품 금액은 음수(또는 0)여야 합니다.")
|
||||
|
||||
|
||||
class CredentialAccessor(Protocol):
|
||||
def get(self, key: str) -> str: ...
|
||||
|
||||
def set(self, key: str, value: str) -> None: ...
|
||||
|
||||
def has(self, key: str) -> bool: ...
|
||||
|
||||
|
||||
@dataclass
|
||||
class AdapterContext:
|
||||
code: str
|
||||
credentials: CredentialAccessor
|
||||
app_state: Any = None # 공통 연동 계층 재사용(예: 카페24 토큰 저장소)
|
||||
timeout_sec: float = 20.0
|
||||
|
||||
|
||||
# ════════════════════════════════════════════════════════════
|
||||
# 어댑터
|
||||
# ════════════════════════════════════════════════════════════
|
||||
class MarketplaceAdapter(ABC):
|
||||
code: str = ""
|
||||
name: str = ""
|
||||
auth_type: str = "api_key" # api_key / oauth / shared(공통 연동 계층 재사용)
|
||||
docs_url: str = ""
|
||||
implemented: bool = False # 실제 수집(fetch)이 구현됐는가
|
||||
note: str = "" # 설정 화면 안내 문구
|
||||
|
||||
# ── 설정 ──────────────────────────────────────────────
|
||||
def credential_fields(self) -> list[CredentialField]:
|
||||
return []
|
||||
|
||||
def visible_fields(self) -> list[CredentialField]:
|
||||
return [f for f in self.credential_fields() if not f.internal]
|
||||
|
||||
@property
|
||||
def uses_shared_integration(self) -> bool:
|
||||
return self.auth_type == "shared"
|
||||
|
||||
def validate_credentials(self, values: dict[str, str]) -> list[str]:
|
||||
"""저장 전 검사. 값 자체를 오류 문구에 넣지 않는다."""
|
||||
errors: list[str] = []
|
||||
for f in self.visible_fields():
|
||||
v = (values.get(f.key) or "").strip()
|
||||
if f.required and not v:
|
||||
errors.append(f"{f.label} 을(를) 입력하세요.")
|
||||
elif v and len(v) > 2000:
|
||||
errors.append(f"{f.label} 값이 너무 깁니다.")
|
||||
return errors
|
||||
|
||||
def is_configured(self, ctx: AdapterContext) -> bool:
|
||||
return all(ctx.credentials.has(f.key) for f in self.visible_fields() if f.required)
|
||||
|
||||
# ── 인증 ──────────────────────────────────────────────
|
||||
def authenticate(self, ctx: AdapterContext) -> None:
|
||||
"""API 호출 전 준비(토큰 발급 등). 기본은 할 일 없음."""
|
||||
if not self.is_configured(ctx):
|
||||
raise NotConfigured("필수 인증정보가 입력되지 않았습니다.")
|
||||
|
||||
def refresh_token(self, ctx: AdapterContext) -> None:
|
||||
"""OAuth 쇼핑몰: refresh token 으로 access token 재발급 후 ctx.credentials.set(...)."""
|
||||
return None
|
||||
|
||||
def test_connection(self, ctx: AdapterContext) -> str:
|
||||
"""성공 시 사람이 읽을 짧은 문구 반환. 실패는 AdapterError."""
|
||||
self.authenticate(ctx)
|
||||
raise NotImplementedYet(f"{self.name} API 연동은 다음 단계에서 구현됩니다.")
|
||||
|
||||
# ── 수집 ──────────────────────────────────────────────
|
||||
def fetch_orders(self, ctx: AdapterContext, start: date, end: date) -> Iterable[dict[str, Any]]:
|
||||
raise NotImplementedYet(f"{self.name} 주문 수집은 다음 단계에서 구현됩니다.")
|
||||
|
||||
def fetch_refunds(self, ctx: AdapterContext, start: date, end: date) -> Iterable[dict[str, Any]]:
|
||||
return []
|
||||
|
||||
def normalize_order(self, raw: dict[str, Any]) -> list[SaleEvent]:
|
||||
raise NotImplementedYet(f"{self.name} 주문 변환은 다음 단계에서 구현됩니다.")
|
||||
|
||||
def normalize_refund(self, raw: dict[str, Any]) -> list[SaleEvent]:
|
||||
return []
|
||||
|
||||
def collect(self, ctx: AdapterContext, start: date, end: date) -> tuple[int, list[SaleEvent]]:
|
||||
"""기간의 주문·취소/반품을 받아 공통 사건으로 변환. (원본 건수, 사건 목록)."""
|
||||
self.authenticate(ctx)
|
||||
fetched = 0
|
||||
events: list[SaleEvent] = []
|
||||
for raw in self.fetch_orders(ctx, start, end):
|
||||
fetched += 1
|
||||
events.extend(self.normalize_order(raw))
|
||||
for raw in self.fetch_refunds(ctx, start, end):
|
||||
fetched += 1
|
||||
events.extend(self.normalize_refund(raw))
|
||||
for ev in events:
|
||||
ev.validate()
|
||||
return fetched, events
|
||||
@@ -0,0 +1,49 @@
|
||||
"""카페24 — 공통 연동 계층(app/integrations/cafe24) 재사용.
|
||||
|
||||
카페24는 이미 OAuth 로 연결해 쓰고 있다(상품관리). 실적 설정에서 인증정보를 따로
|
||||
받지 않고, 같은 토큰 저장소(cafe24_db)의 연결 상태를 그대로 보여 준다.
|
||||
주문 수집(다음 단계)에는 카페24 앱 권한에 mall.read_order 추가 + 재연결이 필요하다
|
||||
(app/integrations/cafe24/config.py 의 ORDER_SCOPES).
|
||||
"""
|
||||
|
||||
from __future__ import annotations
|
||||
|
||||
from .base import AdapterContext, AuthFailed, MarketplaceAdapter, NotConfigured, TokenExpired
|
||||
|
||||
|
||||
class Cafe24Adapter(MarketplaceAdapter):
|
||||
code = "cafe24"
|
||||
name = "카페24"
|
||||
auth_type = "shared"
|
||||
docs_url = "https://developers.cafe24.com/docs/api/admin/"
|
||||
note = "카페24 상품관리에서 연결한 OAuth 토큰을 함께 씁니다(여기서 따로 입력하지 않음)."
|
||||
|
||||
def is_configured(self, ctx: AdapterContext) -> bool:
|
||||
return True
|
||||
|
||||
def authenticate(self, ctx: AdapterContext) -> None:
|
||||
st = self.shared_status(ctx)
|
||||
if not st.get("connected"):
|
||||
if st.get("missing"):
|
||||
raise NotConfigured("카페24 연동 환경변수가 설정되지 않았습니다.")
|
||||
if st.get("needs_reauth") and st.get("reason", "").startswith("refresh"):
|
||||
raise TokenExpired("카페24 연결이 만료되었습니다. 카페24 상품관리 → 시스템에서 재연결하세요.")
|
||||
raise AuthFailed("카페24에 연결되어 있지 않습니다. 카페24 상품관리 → 시스템에서 연결하세요.")
|
||||
|
||||
def shared_status(self, ctx: AdapterContext) -> dict:
|
||||
from app.integrations.cafe24.config import load_config # 지연 import
|
||||
from app.integrations.cafe24.tokens import TokenService # 지연 import
|
||||
|
||||
repo = getattr(ctx.app_state, "cafe24_store", None) if ctx.app_state is not None else None
|
||||
config = load_config()
|
||||
if repo is None:
|
||||
return {"connected": False, "missing": config.missing or ["CAFE24_DB_URL"], "needs_reauth": False}
|
||||
return TokenService(repo, config).status()
|
||||
|
||||
def test_connection(self, ctx: AdapterContext) -> str:
|
||||
self.authenticate(ctx)
|
||||
st = self.shared_status(ctx)
|
||||
scopes = st.get("scopes") or ""
|
||||
if "mall.read_order" not in scopes:
|
||||
return "카페24 연결 정상. 주문 수집에는 주문 읽기 권한(mall.read_order) 추가가 필요합니다."
|
||||
return "카페24 연결 정상."
|
||||
@@ -0,0 +1,24 @@
|
||||
"""쿠팡 — 쿠팡 윙(마켓플레이스) Open API.
|
||||
|
||||
인증: Vendor ID + Access Key + Secret Key 로 요청마다 HMAC 서명(CEA 헤더).
|
||||
로켓(공급) 매출은 기존 쿠팡 밀크런 모듈의 cupang_sales 에 있다 — 필요 시 별도 연계.
|
||||
"""
|
||||
|
||||
from __future__ import annotations
|
||||
|
||||
from .base import CredentialField, MarketplaceAdapter
|
||||
|
||||
|
||||
class CoupangAdapter(MarketplaceAdapter):
|
||||
code = "coupang"
|
||||
name = "쿠팡"
|
||||
auth_type = "api_key"
|
||||
docs_url = "https://developers.coupangcorp.com/"
|
||||
note = "쿠팡 윙 → 판매자정보 → 추가판매정보 → OPEN API 키 발급에서 확인합니다."
|
||||
|
||||
def credential_fields(self) -> list[CredentialField]:
|
||||
return [
|
||||
CredentialField("vendor_id", "Vendor ID(업체코드)", placeholder="A00012345"),
|
||||
CredentialField("access_key", "Access Key", secret=True),
|
||||
CredentialField("secret_key", "Secret Key", secret=True),
|
||||
]
|
||||
@@ -0,0 +1,21 @@
|
||||
"""11번가 — 11번가 셀러 오픈API.
|
||||
|
||||
인증: 셀러오피스에서 발급한 Open API Key 를 요청 헤더(openapikey)에 넣는다.
|
||||
"""
|
||||
|
||||
from __future__ import annotations
|
||||
|
||||
from .base import CredentialField, MarketplaceAdapter
|
||||
|
||||
|
||||
class ElevenstAdapter(MarketplaceAdapter):
|
||||
code = "elevenst"
|
||||
name = "11번가"
|
||||
auth_type = "api_key"
|
||||
docs_url = "https://openapi.11st.co.kr/"
|
||||
note = "11번가 셀러오피스 → 오픈API 에서 발급한 키를 입력합니다."
|
||||
|
||||
def credential_fields(self) -> list[CredentialField]:
|
||||
return [
|
||||
CredentialField("api_key", "Open API Key", secret=True),
|
||||
]
|
||||
@@ -0,0 +1,23 @@
|
||||
"""G마켓 — ESM(ESM Plus / ESM Trading API).
|
||||
|
||||
인증: ESM 마스터 ID + 판매자 ID + 발급 Secret Key 로 JWT 서명(연동 단계에서 확정).
|
||||
"""
|
||||
|
||||
from __future__ import annotations
|
||||
|
||||
from .base import CredentialField, MarketplaceAdapter
|
||||
|
||||
|
||||
class GmarketAdapter(MarketplaceAdapter):
|
||||
code = "gmarket"
|
||||
name = "G마켓"
|
||||
auth_type = "api_key"
|
||||
docs_url = "https://etapi.gmarket.com/"
|
||||
note = "ESM Plus 에서 발급한 API 인증정보를 입력합니다."
|
||||
|
||||
def credential_fields(self) -> list[CredentialField]:
|
||||
return [
|
||||
CredentialField("master_id", "ESM 마스터 ID"),
|
||||
CredentialField("seller_id", "G마켓 판매자 ID"),
|
||||
CredentialField("secret_key", "Secret Key", secret=True),
|
||||
]
|
||||
@@ -0,0 +1,21 @@
|
||||
"""GS샵 — 협력사 API.
|
||||
|
||||
인증 방식·필드는 연동 단계에서 공식 문서로 확정한다.
|
||||
"""
|
||||
|
||||
from __future__ import annotations
|
||||
|
||||
from .base import CredentialField, MarketplaceAdapter
|
||||
|
||||
|
||||
class GsshopAdapter(MarketplaceAdapter):
|
||||
code = "gsshop"
|
||||
name = "GS샵"
|
||||
auth_type = "api_key"
|
||||
note = "입력 항목은 연동 단계에서 GS샵 협력사 API 문서로 확정합니다."
|
||||
|
||||
def credential_fields(self) -> list[CredentialField]:
|
||||
return [
|
||||
CredentialField("vendor_code", "협력사 코드"),
|
||||
CredentialField("api_key", "API Key", secret=True),
|
||||
]
|
||||
@@ -0,0 +1,21 @@
|
||||
"""카카오 — 카카오쇼핑(톡스토어) 판매자 API.
|
||||
|
||||
인증 방식·필드는 연동 단계에서 공식 문서로 확정한다.
|
||||
"""
|
||||
|
||||
from __future__ import annotations
|
||||
|
||||
from .base import CredentialField, MarketplaceAdapter
|
||||
|
||||
|
||||
class KakaoAdapter(MarketplaceAdapter):
|
||||
code = "kakao"
|
||||
name = "카카오"
|
||||
auth_type = "api_key"
|
||||
note = "입력 항목은 연동 단계에서 카카오쇼핑 판매자 API 문서로 확정합니다."
|
||||
|
||||
def credential_fields(self) -> list[CredentialField]:
|
||||
return [
|
||||
CredentialField("seller_id", "판매자(채널) ID"),
|
||||
CredentialField("api_key", "API Key", secret=True),
|
||||
]
|
||||
@@ -0,0 +1,21 @@
|
||||
"""롯데ON — 롯데ON 판매자 API.
|
||||
|
||||
인증: 거래처번호 + 발급 API Key(연동 단계에서 확정).
|
||||
"""
|
||||
|
||||
from __future__ import annotations
|
||||
|
||||
from .base import CredentialField, MarketplaceAdapter
|
||||
|
||||
|
||||
class LotteonAdapter(MarketplaceAdapter):
|
||||
code = "lotteon"
|
||||
name = "롯데ON"
|
||||
auth_type = "api_key"
|
||||
note = "롯데ON 스토어센터에서 발급한 API 인증정보를 입력합니다."
|
||||
|
||||
def credential_fields(self) -> list[CredentialField]:
|
||||
return [
|
||||
CredentialField("trade_no", "거래처번호"),
|
||||
CredentialField("api_key", "API Key", secret=True),
|
||||
]
|
||||
@@ -0,0 +1,63 @@
|
||||
"""테스트(모의) 매출 데이터 — 실제 API 연동 전 화면 확인용.
|
||||
|
||||
같은 (쇼핑몰, 날짜)면 항상 같은 값이 나온다(재현 가능). 결제뿐 아니라 전체 취소·
|
||||
부분 반품도 섞어 넣어 음수 반영과 합계를 확인할 수 있게 한다.
|
||||
DB 에는 is_sample=TRUE 로 들어가며 설정 화면에서 한 번에 지울 수 있다.
|
||||
"""
|
||||
|
||||
from __future__ import annotations
|
||||
|
||||
import random
|
||||
from datetime import date, timedelta
|
||||
|
||||
from .base import SaleEvent
|
||||
|
||||
# 쇼핑몰별 하루 평균 주문 건수(모의값) — 화면에 차이가 보이도록만 다르게 둔다.
|
||||
_DAILY_ORDERS = {
|
||||
"cafe24": 9, "naver": 14, "coupang": 18, "ohouse": 4, "gmarket": 6,
|
||||
"kakao": 3, "gsshop": 2, "elevenst": 4, "lotteon": 2, "toss": 1,
|
||||
}
|
||||
_PRODUCTS = (
|
||||
("스테인리스 냄비 20cm", 39_000), ("프라이팬 28cm", 45_900), ("밀폐용기 5종 세트", 29_800),
|
||||
("도마 대형", 19_900), ("칼 블록 세트", 89_000), ("주방 가위", 12_900),
|
||||
("냄비 받침", 8_900), ("전골 냄비", 59_000),
|
||||
)
|
||||
|
||||
|
||||
def generate(code: str, start: date, end: date) -> list[SaleEvent]:
|
||||
events: list[SaleEvent] = []
|
||||
base = _DAILY_ORDERS.get(code, 3)
|
||||
d = start
|
||||
while d <= end:
|
||||
rng = random.Random(f"perf-sample:{code}:{d.isoformat()}")
|
||||
weekend = d.weekday() >= 5
|
||||
n = max(0, int(rng.gauss(base * (0.7 if weekend else 1.0), base * 0.35)))
|
||||
for i in range(n):
|
||||
name, price = rng.choice(_PRODUCTS)
|
||||
qty = 1 if rng.random() < 0.8 else rng.randint(2, 3)
|
||||
discount = rng.choice((0, 0, 0, 1000, 2000, 3000))
|
||||
amount = max(0, price * qty - discount)
|
||||
order_id = f"SAMPLE-{code}-{d:%Y%m%d}-{i:03d}"
|
||||
events.append(SaleEvent(
|
||||
event_type="SALE", external_event_id=f"{order_id}-S", external_order_id=order_id,
|
||||
external_line_id="1", order_date=d, payment_date=d, event_date=d, amount=amount,
|
||||
product_name=name, quantity=qty, discount_amount=discount, order_status="결제완료",
|
||||
raw={"sample": True},
|
||||
))
|
||||
roll = rng.random()
|
||||
if roll < 0.05: # 전체 취소(당일~2일 뒤)
|
||||
cd = min(end, d + timedelta(days=rng.randint(0, 2)))
|
||||
events.append(SaleEvent(
|
||||
event_type="CANCEL", external_event_id=f"{order_id}-C", external_order_id=order_id,
|
||||
external_line_id="1", order_date=d, payment_date=d, event_date=cd, amount=-amount,
|
||||
product_name=name, quantity=-qty, order_status="취소완료", raw={"sample": True},
|
||||
))
|
||||
elif roll < 0.08 and qty > 1: # 부분 반품(1개, 3~7일 뒤)
|
||||
rd = min(end, d + timedelta(days=rng.randint(3, 7)))
|
||||
events.append(SaleEvent(
|
||||
event_type="RETURN", external_event_id=f"{order_id}-R", external_order_id=order_id,
|
||||
external_line_id="1", order_date=d, payment_date=d, event_date=rd, amount=-price,
|
||||
product_name=name, quantity=-1, order_status="반품완료", raw={"sample": True},
|
||||
))
|
||||
d += timedelta(days=1)
|
||||
return events
|
||||
@@ -0,0 +1,27 @@
|
||||
"""네이버 스마트스토어 — 네이버 커머스API.
|
||||
|
||||
인증: 애플리케이션 ID + 시크릿으로 전자서명(bcrypt) → OAuth2 client_credentials 토큰.
|
||||
토큰은 발급받아 암호화 저장하고 만료 시 재발급한다(다음 단계에서 구현).
|
||||
"""
|
||||
|
||||
from __future__ import annotations
|
||||
|
||||
from .base import CredentialField, MarketplaceAdapter
|
||||
|
||||
|
||||
class NaverAdapter(MarketplaceAdapter):
|
||||
code = "naver"
|
||||
name = "네이버 스마트스토어"
|
||||
auth_type = "oauth"
|
||||
docs_url = "https://apicenter.commerce.naver.com/"
|
||||
note = "커머스API센터에서 발급한 애플리케이션 ID/시크릿을 입력합니다."
|
||||
|
||||
def credential_fields(self) -> list[CredentialField]:
|
||||
return [
|
||||
CredentialField("client_id", "애플리케이션 ID(Client ID)"),
|
||||
CredentialField("client_secret", "애플리케이션 시크릿(Client Secret)", secret=True),
|
||||
CredentialField("account_id", "판매자 ID", required=False,
|
||||
help="판매자 계정 지정이 필요한 경우에만 입력"),
|
||||
CredentialField("access_token", "Access Token", secret=True, required=False, internal=True),
|
||||
CredentialField("access_token_expires_at", "Access Token 만료", required=False, internal=True),
|
||||
]
|
||||
@@ -0,0 +1,22 @@
|
||||
"""오늘의집 — 파트너(판매자) API.
|
||||
|
||||
인증 방식·필드는 연동 단계에서 오늘의집 파트너 API 문서로 확정한다.
|
||||
"""
|
||||
|
||||
from __future__ import annotations
|
||||
|
||||
from .base import CredentialField, MarketplaceAdapter
|
||||
|
||||
|
||||
class OhouseAdapter(MarketplaceAdapter):
|
||||
code = "ohouse"
|
||||
name = "오늘의집"
|
||||
auth_type = "api_key"
|
||||
note = "입력 항목은 연동 단계에서 오늘의집 파트너 API 문서로 확정합니다."
|
||||
|
||||
def credential_fields(self) -> list[CredentialField]:
|
||||
return [
|
||||
CredentialField("seller_id", "판매자 ID"),
|
||||
CredentialField("api_key", "API Key", secret=True),
|
||||
CredentialField("api_secret", "API Secret", secret=True, required=False),
|
||||
]
|
||||
@@ -0,0 +1,41 @@
|
||||
"""쇼핑몰 어댑터 목록 — 새 쇼핑몰은 여기 한 줄 + 어댑터 파일 하나.
|
||||
|
||||
DB(perf_marketplaces)에 행이 없으면 설정 화면에서 쓸 수 없으므로, 새 쇼핑몰을
|
||||
추가할 때는 scripts/sql 의 seed(INSERT … ON CONFLICT DO NOTHING)에도 한 줄 넣는다.
|
||||
"""
|
||||
|
||||
from __future__ import annotations
|
||||
|
||||
from .base import MarketplaceAdapter
|
||||
from .cafe24 import Cafe24Adapter
|
||||
from .coupang import CoupangAdapter
|
||||
from .elevenst import ElevenstAdapter
|
||||
from .gmarket import GmarketAdapter
|
||||
from .gsshop import GsshopAdapter
|
||||
from .kakao import KakaoAdapter
|
||||
from .lotteon import LotteonAdapter
|
||||
from .naver import NaverAdapter
|
||||
from .ohouse import OhouseAdapter
|
||||
from .toss import TossAdapter
|
||||
|
||||
_ADAPTERS: tuple[MarketplaceAdapter, ...] = (
|
||||
Cafe24Adapter(),
|
||||
NaverAdapter(),
|
||||
CoupangAdapter(),
|
||||
OhouseAdapter(),
|
||||
GmarketAdapter(),
|
||||
KakaoAdapter(),
|
||||
GsshopAdapter(),
|
||||
ElevenstAdapter(),
|
||||
LotteonAdapter(),
|
||||
TossAdapter(),
|
||||
)
|
||||
_BY_CODE = {a.code: a for a in _ADAPTERS}
|
||||
|
||||
|
||||
def all_adapters() -> tuple[MarketplaceAdapter, ...]:
|
||||
return _ADAPTERS
|
||||
|
||||
|
||||
def get_adapter(code: str) -> MarketplaceAdapter | None:
|
||||
return _BY_CODE.get(code)
|
||||
@@ -0,0 +1,22 @@
|
||||
"""토스쇼핑 — 판매자 API.
|
||||
|
||||
인증 방식·필드는 연동 단계에서 공식 문서로 확정한다.
|
||||
"""
|
||||
|
||||
from __future__ import annotations
|
||||
|
||||
from .base import CredentialField, MarketplaceAdapter
|
||||
|
||||
|
||||
class TossAdapter(MarketplaceAdapter):
|
||||
code = "toss"
|
||||
name = "토스쇼핑"
|
||||
auth_type = "api_key"
|
||||
note = "입력 항목은 연동 단계에서 토스쇼핑 판매자 API 문서로 확정합니다."
|
||||
|
||||
def credential_fields(self) -> list[CredentialField]:
|
||||
return [
|
||||
CredentialField("seller_id", "판매자 ID"),
|
||||
CredentialField("api_key", "API Key", secret=True),
|
||||
CredentialField("api_secret", "API Secret", secret=True, required=False),
|
||||
]
|
||||
Reference in New Issue
Block a user