Fluxo de Trabalho de Desenvolvimento Python/FastAPI

Visão Geral

Fluxo de trabalho especializado para construir backends Python prontos para produção com FastAPI, apresentando padrões assíncronos, SQLAlchemy ORM, validação Pydantic e padrões abrangentes de API.

Quando Usar Este Fluxo de Trabalho

Use este fluxo de trabalho quando:

• Construindo novas APIs REST com FastAPI
• Criando backends Python assíncronos
• Implementando integração de banco de dados com SQLAlchemy
• Configurando autenticação de API
• Desenvolvendo microsserviços

Fases do Fluxo de Trabalho

Fase 1: Configuração do Projeto

Habilidades a Invocar

• app-builder - Estrutura de aplicação
• python-development-python-scaffold - Estrutura Python
• fastapi-templates - Templates FastAPI
• uv-package-manager - Gerenciamento de pacotes

Ações

1. Configurar ambiente Python (uv/poetry)
2. Criar estrutura do projeto
3. Configurar aplicativo FastAPI
4. Configurar logging
5. Configurar variáveis de ambiente

Prompts Copiar e Colar

Use @fastapi-templates to scaffold a new FastAPI project

Use @python-development-python-scaffold to set up Python project structure

Fase 2: Configuração do Banco de Dados

Habilidades a Invocar

• prisma-expert - Prisma ORM (alternativa)
• database-design - Design de schema
• postgresql - Configuração PostgreSQL
• pydantic-models-py - Modelos Pydantic

Ações

1. Projetar schema do banco de dados
2. Configurar modelos SQLAlchemy
3. Criar conexão com o banco de dados
4. Configurar migrações (Alembic)
5. Configurar gerenciamento de sessão

Prompts Copiar e Colar

Use @database-design to design PostgreSQL schema

Use @pydantic-models-py to create Pydantic models for API

Fase 3: Rotas da API

Habilidades a Invocar

• fastapi-router-py - Roteadores FastAPI
• api-design-principles - Design de API
• api-patterns - Padrões de API

Ações

1. Projetar endpoints da API
2. Criar roteadores de API
3. Implementar operações CRUD
4. Adicionar validação de requisição
5. Configurar modelos de resposta

Prompts Copiar e Colar

Use @fastapi-router-py to create API endpoints with CRUD operations

Use @api-design-principles to design RESTful API

Fase 4: Autenticação

Habilidades a Invocar

• auth-implementation-patterns - Autenticação
• api-security-best-practices - Segurança de API

Ações

1. Escolher estratégia de autenticação (JWT, OAuth2)
2. Implementar registro de usuário
3. Configurar endpoints de login
4. Criar middleware de autenticação
5. Adicionar hashing de senha

Prompts Copiar e Colar

Use @auth-implementation-patterns to implement JWT authentication

Fase 5: Tratamento de Erros

Habilidades a Invocar

• fastapi-pro - Padrões FastAPI
• error-handling-patterns - Tratamento de erros

Ações

1. Criar exceções personalizadas
2. Configurar manipuladores de exceção
3. Implementar respostas de erro
4. Adicionar logging de requisição
5. Configurar rastreamento de erros

Prompts Copiar e Colar

Use @fastapi-pro to implement comprehensive error handling

Fase 6: Testes

Habilidades a Invocar

• python-testing-patterns - Testes pytest
• api-testing-observability-api-mock - Testes de API

Ações

1. Configurar pytest
2. Criar fixtures de teste
3. Escrever testes unitários
4. Implementar testes de integração
5. Configurar banco de dados de teste

Prompts Copiar e Colar

Use @python-testing-patterns to write pytest tests for FastAPI

Fase 7: Documentação

Habilidades a Invocar

• api-documenter - Documentação de API
• openapi-spec-generation - Especificações OpenAPI

Ações

1. Configurar schema OpenAPI
2. Adicionar documentação de endpoint
3. Criar exemplos de uso
4. Configurar versionamento de API
5. Gerar documentação da API

Prompts Copiar e Colar

Use @api-documenter to generate comprehensive API documentation

Fase 8: Implantação

Habilidades a Invocar

• deployment-engineer - Implantação
• docker-expert - Containerização

Ações

1. Criar Dockerfile
2. Configurar docker-compose
3. Configurar configurações de produção
4. Configurar proxy reverso
5. Implantar na nuvem

Prompts Copiar e Colar

Use @docker-expert to containerize FastAPI application

Pilha de Tecnologia

Portões de Qualidade

• Todos os testes passando (>80% de cobertura)
• Verificação de tipo passando (mypy)
• Linting limpo (ruff, black)
• Documentação da API completa
• Verificação de segurança aprovada
• Benchmarks de desempenho atendidos

Pacotes de Fluxo de Trabalho Relacionados

• development - Desenvolvimento geral

…