Modelos Pydantic

Crie modelos Pydantic seguindo o padrão multi-modelo para contratos de API limpos.

Início Rápido

Use os padrões de modelo inline abaixo e adapte nomes de classes e campos ao contrato de API real. Inspecione a versão instalada do Pydantic antes de selecionar a sintaxe de configuração; esses fragmentos exigem as importações e os tipos de aplicativo mostrados pelo seu projeto. Não presuma que um arquivo de modelo autônomo está incluído.

Padrão Multi-Modelo

Aliases camelCase

class MyModel(BaseModel):
    workspace_id: str = Field(..., alias="workspaceId")
    created_at: datetime = Field(..., alias="createdAt")
    
    class Config:
        populate_by_name = True  # Accept both snake_case and camelCase

Campos de Atualização Opcionais

class MyUpdate(BaseModel):
    """All fields optional for PATCH requests."""
    name: Optional[str] = Field(None, min_length=1)
    description: Optional[str] = None

Documento do Banco de Dados

class MyInDB(MyResponse):
    """Adds doc_type for Cosmos DB queries."""
    doc_type: str = "my_resource"

Etapas de Integração

1. Crie modelos em src/backend/app/models/
2. Exporte de src/backend/app/models/__init__.py
3. Adicione tipos TypeScript correspondentes

Quando Usar

Esta habilidade é aplicável para executar o fluxo de trabalho ou as ações descritas na visão geral.

Limitações

• Use esta habilidade apenas quando a tarefa corresponder claramente ao escopo descrito acima.
• Não trate a saída como substituta para validação específica do ambiente, testes ou revisão especializada.
• Pare e peça esclarecimentos se os inputs necessários, permissões, limites de segurança ou critérios de sucesso estiverem ausentes.