"""
主账 HTTP 客户端：只打主账 API，不直连 TMS / MySQL。

正式写操作必须带幂等键；Graph 成功 ≠ 主账成功。
骨架：仅占位客户端。
"""

from __future__ import annotations

from dataclasses import dataclass


@dataclass
class LedgerClient:
    """
    主账客户端骨架。

    参数：base_url 来自 BIZ_API_BASE_URL。
    禁止：在本类拼 TMS 签名或写工单 SQL。
    """

    base_url: str

    def health_url(self) -> str:
        """返回主账健康检查 URL，供后续联调；骨架不发请求。"""
        return f"{self.base_url.rstrip('/')}/health"