"""
合同审查相关 Protocol 接口定义

包含: IReviewService
"""

from pathlib import Path
from typing import Any, Protocol
from uuid import UUID


class IReviewService(Protocol):
    """
    合同审查服务接口

    定义合同审查服务的公共方法，供其他模块使用
    """

    def upload_contract(
        self,
        file: Any,
        user: Any,
        model_name: str = "",
    ) -> Any:
        """
        上传合同：验证 → 保存 → 提取内容 → 识别甲乙方 → 创建任务

        Args:
            file: 上传的 docx 文件
            user: 操作用户
            model_name: LLM 模型名称

        Returns:
            ReviewTask 任务对象
        """
        ...

    def confirm_party(
        self,
        task_id: UUID,
        represented_party: str,
        user: Any,
        reviewer_name: str = "",
        selected_steps: list[str] | None = None,
    ) -> Any:
        """
        确认代表方，提交异步审查任务

        Args:
            task_id: 任务 ID
            represented_party: 用户代表的各方 (party_a/party_b/party_c/party_d)
            user: 操作用户
            reviewer_name: 修订人名称
            selected_steps: 选中的处理步骤

        Returns:
            ReviewTask 任务对象
        """
        ...

    def get_task_status(self, task_id: UUID) -> Any:
        """
        查询任务状态

        Args:
            task_id: 任务 ID

        Returns:
            ReviewTask 任务对象
        """
        ...

    def get_result_file(self, task_id: UUID) -> Path:
        """
        获取结果文件路径

        Args:
            task_id: 任务 ID

        Returns:
            输出文件路径
        """
        ...

    def get_original_file(self, task_id: UUID) -> Path:
        """
        获取原始上传文件路径

        Args:
            task_id: 任务 ID

        Returns:
            原始文件路径
        """
        ...