"""数据库抽象基类，定义统一的CRUD接口."""

from abc import ABC, abstractmethod
from typing import Any, Dict, List, Optional


class VectorDBClient(ABC):
    """向量数据库客户端抽象基类.

    定义了统一的向量数据CRUD接口，支持Elasticsearch和PostgreSQL等后端。
    """

    @abstractmethod
    async def connect(self) -> None:
        """建立数据库连接."""
        pass

    @abstractmethod
    async def disconnect(self) -> None:
        """断开数据库连接."""
        pass

    @abstractmethod
    async def health_check(self) -> bool:
        """检查数据库连接健康状态.

        Returns:
            bool: 连接正常返回True，否则返回False
        """
        pass