"""首页入口服务接口。"""

from abc import ABC, abstractmethod

from fastapi_modules.fastapi_leaudit.domian.vo.homeVo import HomeDashboardStatisticsVO, HomeEntryModuleVO


class IHomeService(ABC):
    """首页入口服务接口。"""

    @abstractmethod
    async def GetEntryModules(self, UserId: int) -> list[HomeEntryModuleVO]:
        """获取当前用户可见的首页入口模块。"""
        ...

    @abstractmethod
    async def GetDashboardStatistics(
        self,
        UserId: int,
        Today: str | None = None,
        TypeIds: list[int] | None = None,
        EntryModuleId: int | None = None,
    ) -> HomeDashboardStatisticsVO:
        """获取当前业务入口的首页统计卡片数据。"""
        ...