Suporte upstream incluído

Arquivos de suporte estão incluídos em caminhos relativos à skill. Veja UPSTREAM-NOTICE.md para suas fontes fixadas, licenças, hashes e alterações de importação.

Roteador FastAPI

Crie roteadores FastAPI seguindo padrões estabelecidos com autenticação adequada, modelos de resposta e códigos de status HTTP.

Início Rápido

Copie o template de assets/template.py e substitua os placeholders:

• {{ResourceName}} → Nome em PascalCase (ex: Project)
• {{resource_name}} → Nome em snake_case (ex: project)
• {{resource_plural}} → Forma plural (ex: projects)

Padrões de Autenticação

# Optional auth - returns None if not authenticated
current_user: Optional[User] = Depends(get_current_user)

# Required auth - raises 401 if not authenticated
current_user: User = Depends(get_current_user_required)

Modelos de Resposta

@router.get("/items/{item_id}", response_model=Item)
async def get_item(item_id: str) -> Item:
    ...

@router.get("/items", response_model=list[Item])
async def list_items() -> list[Item]:
    ...

Códigos de Status HTTP

@router.post("/items", status_code=status.HTTP_201_CREATED)
@router.delete("/items/{id}", status_code=status.HTTP_204_NO_CONTENT)

Passos de Integração

1. Crie o roteador em src/backend/app/routers/
2. Monte em src/backend/app/main.py
3. Crie os modelos Pydantic correspondentes
4. Crie a camada de serviço, se necessário
5. Adicione funções de API frontend

Quando Usar

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

Limitações

• Use esta skill 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 faltarem entradas necessárias, permissões, limites de segurança ou critérios de sucesso.