"""실적 모듈 인스턴스(2026-11-20) — 같은 코드·화면으로 [실적](한국)과 [말레이시아 실적]을 띄운다. app.main 이 router 를 두 번 붙인다: /performance(한국, 기본값) · /malaysia/performance(말레이시아 — 마운트 의존성 use_malaysia 가 이 요청의 ContextVar 를 MY 로). 저장소·권한키·주소·광고 채널·통화는 current() 로 읽는다. 데이터는 DB 로 나뉜다(같은 표 구조 — malaysia_performance_db, app/modules/malaysia_performance/CLAUDE.md). """ from __future__ import annotations from contextvars import ContextVar from dataclasses import dataclass, field from decimal import ROUND_HALF_UP, Decimal from typing import Any @dataclass(frozen=True) class Variant: key: str # kr | my base: str # 주소 앞부분(템플릿·JS 가 이 뒤에 /api/… 를 붙인다) module_key: str # 권한키 module_name: str # 메뉴·탭 이름 store_attr: str # app.state 저장소 이름 db_name: str # 안내 문구용 scale: int = 1 # 금액 저장 단위 — 1 = 원, 100 = 센(RM 소수 2자리를 정수로 저장해 계산은 그대로) currency: str = "₩" # 광고비 탭 채널 — 비면 한국 실적 채널(ad_spend.CHANNELS) ad_channels: tuple[tuple[str, str], ...] = () # 광고 채널 → ROAS 매출 쇼핑몰 코드들(합계) · 매출 실적 열(그룹) → 그 칸 아래 광고비 줄 [(채널, 줄 이름)] ad_roas_sales: dict[str, tuple[str, ...]] = field(default_factory=dict) ad_lines: dict[str, tuple[tuple[str, str], ...]] = field(default_factory=dict) @property def is_kr(self) -> bool: return self.key == "kr" KR = Variant("kr", "/performance", "performance", "실적", "performance_store", "performance_db") # 쇼핑몰마다 그룹(합계 열) + 쇼핑몰·라이브커머스 하위 2개 — 코드는 scripts/sql/malaysia_performance_db_seed.sql 과 같다 _MY_SHOPS = (("tiktok", "틱톡"), ("shopee", "쇼피"), ("lazada", "라자다")) MY = Variant( "my", "/malaysia/performance", "malaysia_performance", "말레이시아 실적", "malaysia_performance_store", "malaysia_performance_db", scale=100, currency="RM", ad_channels=_MY_SHOPS, ad_roas_sales={c: (f"custom_{c}_shop", f"custom_{c}_live") for c, _ in _MY_SHOPS}, ad_lines={f"group_{c}": ((c, ""),) for c, _ in _MY_SHOPS}, ) _current: ContextVar[Variant] = ContextVar("perf_variant", default=KR) def current() -> Variant: return _current.get() async def use_malaysia() -> None: """말레이시아 마운트 의존성 — async 라 요청 태스크 컨텍스트에 설정되고 동기 핸들러(스레드풀)로 복사된다.""" _current.set(MY) def num_text(value: Any) -> str: """금액(저장 단위 정수) → 쉼표 숫자. 원 = 정수, 센 = RM 소수 2자리.""" v = current() if v.scale == 1: return f"{int(value or 0):,}" return f"{(Decimal(int(value or 0)) / v.scale).quantize(Decimal('0.01'), rounding=ROUND_HALF_UP):,.2f}" def money_text(value: Any) -> str: """통화 기호 붙인 금액 — ₩1,234 / RM 1,234.50.""" v = current() return f"₩{num_text(value)}" if v.scale == 1 else f"{v.currency} {num_text(value)}" def input_text(value: Any) -> str: """날짜 칸 편집창에 보일 값(쉼표 없음) — 빈 값은 빈 글자.""" if value in (None, ""): return "" v = current() if v.scale == 1: return str(int(value)) return f"{Decimal(int(value)) / v.scale:.2f}" def template_ctx() -> dict[str, Any]: """모든 실적 화면 공통 — pv(인스턴스), num·money·inval(금액 글자).""" return {"pv": current(), "num": num_text, "money_t": money_text, "inval": input_text}