Compétences architecture-patterns
📦

architecture-patterns

Sûr

Implementar Padrões de Arquitetura de Backend

Également disponible depuis: Barnhardt-Enterprises-Inc,AdamManuel-dev

Construir sistemas de backend sustentáveis requer padrões de arquitetura comprovados. Esta habilidade ajuda você a implementar Arquitetura Limpa, Arquitetura Hexagonal e Design Orientado por Domínio para criar aplicações testáveis e escaláveis com separação adequada de responsabilidades.

Prend en charge: Claude Codex Code(CC)
📊 71 Adéquat
1

Télécharger le ZIP du skill

2

Importer dans Claude

Allez dans Paramètres → Capacités → Skills → Importer un skill

3

Activez et commencez à utiliser

Tester

Utilisation de "architecture-patterns". Create a Clean Architecture structure for a user management system

Résultat attendu:

A habilidade gera uma estrutura de diretório completa com domain/entities contendo entidade User, domain/interfaces com porta IUserRepository, use_cases contendo CreateUserUseCase e UpdateUserUseCase, adapters/repositories com implementação PostgresUserRepository, e adapters/controllers com UserController para tratamento HTTP. Cada componente demonstra fluxo de dependência adequado e separação de responsabilidades.

Utilisation de "architecture-patterns". Implement a payment gateway adapter using hexagonal architecture

Résultat attendu:

A habilidade cria uma interface PaymentGatewayPort definindo o contrato do método charge, então implementa tanto StripePaymentAdapter para produção quanto MockPaymentAdapter para teste. Ambos os adaptadores implementam a mesma interface de porta, permitindo troca fácil sem alterar a lógica de negócio. O exemplo inclui tratamento de erros e padrões assíncronos adequados.

Utilisation de "architecture-patterns". Design an Order aggregate with DDD patterns

Résultat attendu:

A habilidade projeta uma entidade Order como raiz de agregado com métodos add_item, calculate_total e submit encapsulando regras de negócio. Inclui entidade OrderItem, objeto de valor Money para manipulação de moeda, enum OrderStatus para gerenciamento de estado, e eventos de domínio como OrderSubmittedEvent. O agregado impõe invariantes e mantém limites de consistência.

Audit de sécurité

Sûr
v5 • 1/21/2026

All 43 static analysis findings are false positives from educational code examples in documentation. The skill teaches software architecture patterns through Python examples showing Clean Architecture, Hexagonal Architecture, and Domain-Driven Design. No executable code, network access, or security vulnerabilities present.

2
Fichiers analysés
909
Lignes analysées
0
résultats
5
Total des audits
Aucun problème de sécurité trouvé

Score de qualité

38
Architecture
100
Maintenabilité
87
Contenu
31
Communauté
100
Sécurité
91
Conformité aux spécifications

Ce que vous pouvez construire

Projetar Arquitetura de Novo Serviço de Backend

Planejar e implementar um novo microserviço usando princípios de Arquitetura Limpa com separação adequada de camadas, injeção de dependência e lógica de negócio testável.

Refatorar Aplicação Monolítica

Transformar uma aplicação monolítica fortemente acoplada em uma arquitetura hexagonal bem estruturada com portas e adaptadores para teste e manutenção mais fáceis.

Implementar Padrões de Design Orientado por Domínio

Modelar domínios de negócio complexos usando padrões táticos de DDD, incluindo agregados, entidades, objetos de valor e eventos de domínio para melhor alinhamento com o domínio.

Essayez ces prompts

Gerar Estrutura de Arquitetura Limpa
Criar uma estrutura de pastas de Arquitetura Limpa para um sistema de gerenciamento de pedidos de e-commerce com entidades de domínio, casos de uso e adaptadores.
Implementar Porta e Adaptador de Repositório
Implementar uma interface de porta de repositório de usuário e adaptador PostgreSQL seguindo princípios de arquitetura hexagonal com acesso assíncrono ao banco de dados.
Criar Entidades de Domínio com Lógica de Negócio
Projetar um agregado Order com entidades de domínio, objetos de valor e regras de negócio para adicionar itens, calcular totais e transições de estado.
Refatorar Controlador para Padrão de Caso de Uso
Refatorar este endpoint FastAPI que tem lógica de negócio no controlador para um caso de uso adequado com injeção de dependência e separação de responsabilidades.

Bonnes pratiques

  • Sempre direcione dependências das camadas externas para as internas, nunca permita que a camada de domínio dependa de infraestrutura
  • Use interfaces e portas para definir contratos na camada de domínio, implemente adaptadores em camadas externas para testabilidade
  • Mantenha a lógica de negócio em entidades de domínio e casos de uso, controladores devem apenas tratar preocupações HTTP e delegar para casos de uso

Éviter

  • Colocar lógica de negócio em controladores ou manipuladores de API em vez de casos de uso e entidades de domínio
  • Criar modelos de domínio anêmicos com apenas propriedades de dados e sem comportamento, colocando toda lógica em serviços
  • Acoplar fortemente a camada de domínio a frameworks específicos, bancos de dados ou APIs externas sem interfaces de abstração

Foire aux questions

Quando devo usar Arquitetura Limpa versus padrões mais simples?
Use Arquitetura Limpa para lógica de negócio complexa com múltiplas integrações e necessidades de manutenção de longo prazo. Aplicações CRUD simples com fluxos de trabalho básicos podem não se beneficiar das camadas de abstração adicionais. Considere o trade-off entre sustentabilidade e complexidade baseado na complexidade do seu projeto.
Como a arquitetura hexagonal difere da Arquitetura Limpa?
Ambas impõem inversão de dependência e separação de responsabilidades. Arquitetura Limpa enfatiza camadas concêntricas com regras de dependência estritas fluindo para dentro. Arquitetura Hexagonal foca em portas e adaptadores onde o núcleo de domínio é cercado por adaptadores intercambiáveis. São abordagens complementares frequentemente usadas juntas.
Qual é a diferença entre entidades e objetos de valor em DDD?
Entidades têm identidade e ciclo de vida únicos, duas entidades com os mesmos atributos ainda são diferentes se os IDs forem diferentes. Objetos de valor são definidos por seus atributos e são imutáveis, dois objetos de valor com os mesmos atributos são considerados iguais. Use entidades para coisas que mudam ao longo do tempo, objetos de valor para características descritivas.
Como testar casos de uso que dependem de repositórios e serviços externos?
Use injeção de dependência para fornecer implementações mock de interfaces de repositório e serviço. Crie test doubles que implementam as mesmas interfaces de porta, mas retornam dados controlados em vez de acessar bancos de dados ou APIs reais. Isso permite testar lógica de negócio em isolamento sem dependências de infraestrutura.
Posso aplicar esses padrões a bases de código existentes ou apenas a novos projetos?
Você pode refatorar incrementalmente código existente em direção a esses padrões. Comece com um módulo ou funcionalidade, extraia lógica de negócio em casos de uso, crie interfaces de repositório e implemente adaptadores. Migração gradual é mais segura que reescritas completas. Foque primeiro em áreas de alta mudança para máximo benefício.
Esta habilidade funciona com frameworks além de FastAPI e PostgreSQL?
Os princípios se aplicam a qualquer framework ou banco de dados. Exemplos usam FastAPI e PostgreSQL para demonstração, mas os mesmos padrões funcionam com Django, Flask, Express, MongoDB, MySQL ou outras tecnologias. A chave é manter código específico de frameworks em camadas de adaptadores externas separado da lógica de negócio.

Détails du développeur

Structure de fichiers

📄 SKILL.md