services/common/schemas.py

"""Pydantic schemas used by multiple microservices."""

from typing import List, Optional

from pydantic import BaseModel, Field


class FaceRecord(BaseModel):
    """Face identity and vector payload."""

    identity_id: str
    embedding: List[float]
    metadata: dict = Field(default_factory=dict)


class EnrollRequest(BaseModel):
    """Request payload for face enrollment."""

    identity_id: str
    image_b64: str
    metadata: Optional[dict] = None


class SearchRequest(BaseModel):
    """Request payload for face similarity search."""

    image_b64: str
    top_k: int = 5


class SearchResult(BaseModel):
    """Single vector match result."""

    identity_id: str
    score: float