"""企查查服务接口。"""

from __future__ import annotations

from abc import ABC, abstractmethod

from fastapi_modules.fastapi_leaudit.domian.vo.qichachaVo import (
    QichachaBatchQueryVO,
    QichachaCompanyQueryVO,
    QichachaRecordStatusVO,
)


class IQichachaService(ABC):
    """企查查服务接口。"""

    @abstractmethod
    async def QueryCompany(self, Keyword: str, ForceRefresh: bool = False) -> QichachaCompanyQueryVO:
        """查询企业完整信息。"""
        ...

    @abstractmethod
    async def QueryEnterpriseOnly(self, Keyword: str, ForceRefresh: bool = False) -> QichachaCompanyQueryVO:
        """仅查询企业工商信息。"""
        ...

    @abstractmethod
    async def QueryDishonestyOnly(self, Keyword: str, ForceRefresh: bool = False) -> QichachaCompanyQueryVO:
        """仅查询企业失信信息。"""
        ...

    @abstractmethod
    async def BatchQuery(self, Keywords: list[str], ForceRefresh: bool = False) -> QichachaBatchQueryVO:
        """批量查询企业信息。"""
        ...

    @abstractmethod
    async def GetRecordStatus(self, Keyword: str) -> QichachaRecordStatusVO:
        """查询企业缓存状态。"""
        ...