feat(performance): 메타 외화(USD) 광고 계정 — 그날 환율로 원화 환산
- 예전엔 원화가 아닌 계정이면 "원화 계정만" 오류로 저장 안 함 → 이제 지출 금액·구매 전환값을 그날 환율로 원화 환산해 다른 계정과 합산(광고비 = 지출 × 환율 × 1.1, ROAS 는 비율이라 그대로). - fx.py: Frankfurter v2(키 없음, 중앙은행 고시 환율 종합, 매일)에서 기간 환율 한 번에, 빈 날은 앞 가장 가까운 날, 못 구하면 그 회차 저장 안 함, 지난 날 환율은 프로세스 캐시. - 계정 탭에 지출 금액(USD)·적용 환율(원)(합계 = 광고비 가중 평균), 연결 테스트·설정 안내 문구 갱신. - 테스트: 혼합 계정 환산·빈 날 환율·환율 장애·캐시·환율 합계, 실제 Frankfurter 응답으로 파싱 확인. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
@@ -0,0 +1,90 @@
|
||||
"""외화 → 원화 날짜별 환율(2026-10-16 사용자 요청: 메타 USD 광고 계정 — "그날 환율로 원화 환산").
|
||||
|
||||
출처: Frankfurter(https://frankfurter.dev, API 키 없음) v2 `GET /v2/rates?base=USD"es=KRW&from=&to=`
|
||||
— 여러 나라 중앙은행 고시 환율을 합친 값(blended)이고 주말·공휴일 포함 매일 있다. 서울외국환중개 매매기준율과는
|
||||
조금(보통 0.5% 안쪽) 다를 수 있다. 응답: [{"date": "2026-10-01", "base": "USD", "quote": "KRW", "rate": 1357.92}, …]
|
||||
그날 값이 없으면(오늘처럼 아직 안 나온 날 등) 그 앞 가장 가까운 날 값을 쓴다(LOOKBACK_DAYS 안).
|
||||
지난 날(2일 이상 지난) 환율은 프로세스 안에 기억해 30분마다 도는 자동 업데이트가 같은 날을 다시 묻지 않게 한다.
|
||||
"""
|
||||
|
||||
from __future__ import annotations
|
||||
|
||||
import threading
|
||||
from datetime import date, timedelta
|
||||
from decimal import Decimal, InvalidOperation
|
||||
|
||||
import httpx
|
||||
|
||||
from app.timezone import today_kst
|
||||
|
||||
FX_API = "https://api.frankfurter.dev/v2/rates"
|
||||
SOURCE_LABEL = "Frankfurter(중앙은행 고시 환율 종합)"
|
||||
LOOKBACK_DAYS = 10 # 그날 환율이 없으면 이만큼 앞까지 찾는다
|
||||
_SETTLED_AFTER = 2 # 오늘에서 이만큼 지난 날 환율만 기억(최근 값은 나중에 고시될 수 있음)
|
||||
|
||||
_cache_lock = threading.Lock()
|
||||
_cache: dict[tuple[str, date], Decimal] = {}
|
||||
|
||||
|
||||
class FxError(Exception):
|
||||
"""환율을 가져오지 못함 — 문구는 화면에 그대로 보인다."""
|
||||
|
||||
|
||||
def krw_rates(client: httpx.Client, currency: str, start: date, end: date, *, today: date | None = None) -> dict[date, Decimal]:
|
||||
"""start~end(양 끝 포함) 날마다 1 {currency} = ? 원. 하루라도 못 정하면 FxError(일부만 환산해 저장하지 않게)."""
|
||||
cur = (currency or "").upper()
|
||||
if cur == "KRW":
|
||||
return {start + timedelta(days=i): Decimal(1) for i in range((end - start).days + 1)}
|
||||
days = [start + timedelta(days=i) for i in range((end - start).days + 1)]
|
||||
with _cache_lock:
|
||||
known = {d: _cache[(cur, d)] for d in days if (cur, d) in _cache}
|
||||
if len(known) == len(days):
|
||||
return known
|
||||
fetched = _fetch(client, cur, start - timedelta(days=LOOKBACK_DAYS), end)
|
||||
today = today or today_kst()
|
||||
out: dict[date, Decimal] = {}
|
||||
for d in days:
|
||||
rate = next((fetched[d - timedelta(days=k)] for k in range(LOOKBACK_DAYS + 1) if d - timedelta(days=k) in fetched), None)
|
||||
if rate is None:
|
||||
raise FxError(f"{d.isoformat()} 의 {cur}→KRW 환율을 찾지 못했습니다({SOURCE_LABEL}).")
|
||||
out[d] = rate
|
||||
with _cache_lock:
|
||||
for d, rate in out.items():
|
||||
if d in fetched and (today - d).days >= _SETTLED_AFTER:
|
||||
_cache[(cur, d)] = rate
|
||||
return out
|
||||
|
||||
|
||||
def _fetch(client: httpx.Client, cur: str, start: date, end: date) -> dict[date, Decimal]:
|
||||
try:
|
||||
resp = client.get(FX_API, params={"base": cur, "quotes": "KRW", "from": start.isoformat(), "to": end.isoformat()})
|
||||
except httpx.HTTPError as exc:
|
||||
raise FxError(f"환율 서버({SOURCE_LABEL})에 연결하지 못했습니다({type(exc).__name__}).") from None
|
||||
if resp.status_code != 200:
|
||||
try:
|
||||
msg = str((resp.json() or {}).get("message") or "")
|
||||
except ValueError:
|
||||
msg = ""
|
||||
raise FxError(f"환율을 가져오지 못했습니다(HTTP {resp.status_code}{': ' + msg[:120] if msg else ''}).")
|
||||
try:
|
||||
rows = resp.json()
|
||||
except ValueError:
|
||||
raise FxError("환율 서버 응답을 읽을 수 없습니다.") from None
|
||||
out: dict[date, Decimal] = {}
|
||||
for r in rows if isinstance(rows, list) else []:
|
||||
if not isinstance(r, dict) or str(r.get("quote") or "").upper() != "KRW":
|
||||
continue
|
||||
try:
|
||||
d = date.fromisoformat(str(r.get("date")))
|
||||
rate = Decimal(str(r.get("rate")))
|
||||
except (ValueError, InvalidOperation):
|
||||
continue
|
||||
if rate > 0:
|
||||
out[d] = rate
|
||||
return out
|
||||
|
||||
|
||||
def clear_cache() -> None:
|
||||
"""테스트용."""
|
||||
with _cache_lock:
|
||||
_cache.clear()
|
||||
Reference in New Issue
Block a user