Gerador Abrangente de Projeto de Arquitetura

Variáveis de Configuração

${PROJECT_TYPE="Auto-detect|.NET|Java|React|Angular|Python|Node.js|Flutter|Outro"} <!-- Tecnologia principal --> ${ARCHITECTURE_PATTERN="Auto-detect|Clean Architecture|Microservices|Layered|MVVM|MVC|Hexagonal|Event-Driven|Serverless|Monolithic|Outro"} <!-- Padrão arquitetural principal --> ${DIAGRAM_TYPE="C4|UML|Flow|Component|None"} <!-- Tipo de diagrama de arquitetura --> ${DETAIL_LEVEL="High-level|Detailed|Comprehensive|Implementation-Ready"} <!-- Nível de detalhe a incluir --> ${INCLUDES_CODE_EXAMPLES=true|false} <!-- Incluir exemplos de código para ilustrar padrões --> ${INCLUDES_IMPLEMENTATION_PATTERNS=true|false} <!-- Incluir padrões de implementação detalhados --> ${INCLUDES_DECISION_RECORDS=true|false} <!-- Incluir registros de decisões arquiteturais --> ${FOCUS_ON_EXTENSIBILITY=true|false} <!-- Enfatizar pontos de extensão e padrões -->

Prompt Gerado

"Crie um documento abrangente 'Project_Architecture_Blueprint.md' que analise profundamente os padrões arquiteturais na base de código para servir como uma referência definitiva na manutenção da consistência arquitetural. Use a seguinte abordagem:

1. Detecção e Análise de Arquitetura

• ${PROJECT_TYPE == "Auto-detect" ? "Analise a estrutura do projeto para identificar todas as pilhas de tecnologia e frameworks em uso, examinando:

  • Arquivos de projeto e configuração
  • Dependências de pacotes e instruções de importação
  • Padrões e convenções específicos de frameworks
  • Configurações de build e implantação" : "Concentre-se nos padrões e práticas específicos de ${PROJECT_TYPE}"}

• ${ARCHITECTURE_PATTERN == "Auto-detect" ? "Determine o(s) padrão(ões) arquitetural(is) analisando:

  • Organização de pastas e namespaces
  • Fluxo de dependência e limites de componentes
  • Segregação de interfaces e padrões de abstração
  • Mecanismos de comunicação entre componentes" : "Documente como a arquitetura ${ARCHITECTURE_PATTERN} é implementada"}

2. Visão Geral da Arquitetura

• Forneça uma explicação clara e concisa da abordagem arquitetural geral
• Documente os princípios orientadores evidentes nas escolhas arquiteturais
• Identifique os limites arquiteturais e como eles são impostos
• Observe quaisquer padrões arquiteturais híbridos ou adaptações de padrões padrão

3. Visualização da Arquitetura

${DIAGRAM_TYPE != "None" ? `Crie diagramas ${DIAGRAM_TYPE} em múltiplos níveis de abstração:

• Visão geral arquitetural de alto nível mostrando os principais subsistemas
• Diagramas de interação de componentes mostrando relacionamentos e dependências
• Diagramas de fluxo de dados mostrando como a informação se move pelo sistema
• Garanta que os diagramas reflitam com precisão a implementação real, não padrões teóricos` : "Descreva os relacionamentos dos componentes com base nas dependências reais do código, fornecendo explicações textuais claras de:
• Organização e limites dos subsistemas
• Direções de dependência e interações de componentes
• Fluxo de dados e sequências de processos"}

4. Componentes Arquiteturais Principais

Para cada componente arquitetural descoberto na base de código:

• Propósito e Responsabilidade:

  • Função principal dentro da arquitetura
  • Domínios de negócios ou preocupações técnicas abordadas
  • Limites e escopo

• Estrutura Interna:

  • Organização de classes/módulos dentro do componente
  • Principais abstrações e suas implementações
  • Padrões de design utilizados

• Padrões de Interação:

  • Como o componente se comunica com outros
  • Interfaces expostas e consumidas
  • Padrões de injeção de dependência
  • Mecanismos de publicação/assinatura de eventos

• Padrões de Evolução:

  • Como o componente pode ser estendido
  • Pontos de variação e mecanismos de plugin
  • Abordagens de configuração e personalização

5. Camadas Arquiteturais e Dependências

• Mapeie a estrutura de camadas conforme implementada na base de código
• Documente as regras de dependência entre as camadas
• Identifique mecanismos de abstração que permitem a separação de camadas
• Observe quaisquer dependências circulares ou violações de camadas
• Documente os padrões de injeção de dependência usados para manter a separação

6. Arquitetura de Dados

• Documente a estrutura e organização do modelo de domínio
• Mapeie relacionamentos de entidades e padrões de agregação
• Identifique padrões de acesso a dados (repositórios, mappers de dados, etc.)
• Documente abordagens de transformação e mapeamento de dados
• Observe estratégias e implementações de cache
• Documente padrões de validação de dados

7. Implementação de Preocupações Transversais (Cross-Cutting Concerns)

Documente os padrões de implementação para preocupações transversais:

…