bambuddy/backend/app/schemas/group.py

"""Pydantic schemas for Group CRUD operations."""

from datetime import datetime

from pydantic import BaseModel


class GroupBrief(BaseModel):
    """Brief group info for embedding in other responses."""

    id: int
    name: str

    class Config:
        from_attributes = True


class GroupCreate(BaseModel):
    """Schema for creating a new group."""

    name: str
    description: str | None = None
    permissions: list[str] = []
    # Printer scope (#1727): when set, members only see these printers plus
    # every printer in these locations
    restrict_printers: bool = False
    printer_ids: list[int] = []
    locations: list[str] = []


class GroupUpdate(BaseModel):
    """Schema for updating a group."""

    name: str | None = None
    description: str | None = None
    permissions: list[str] | None = None
    restrict_printers: bool | None = None
    printer_ids: list[int] | None = None
    locations: list[str] | None = None


class GroupResponse(BaseModel):
    """Schema for group response."""

    id: int
    name: str
    description: str | None
    permissions: list[str]
    is_system: bool
    restrict_printers: bool = False
    printer_ids: list[int] = []
    locations: list[str] = []
    user_count: int = 0
    created_at: datetime
    updated_at: datetime

    class Config:
        from_attributes = True


class GroupDetailResponse(GroupResponse):
    """Schema for detailed group response including users."""

    users: list["UserBrief"] = []


class UserBrief(BaseModel):
    """Brief user info for embedding in group response."""

    id: int
    username: str
    is_active: bool

    class Config:
        from_attributes = True


class PermissionInfo(BaseModel):
    """Schema for permission information."""

    value: str
    label: str


class PermissionCategory(BaseModel):
    """Schema for a category of permissions."""

    name: str
    permissions: list[PermissionInfo]


class PermissionsListResponse(BaseModel):
    """Schema for listing all permissions by category."""

    categories: list[PermissionCategory]
    all_permissions: list[str]


# Update forward references
GroupDetailResponse.model_rebuild()