diff --git a/PT/asciidoc/arc42-template.adoc b/PT/asciidoc/arc42-template.adoc
new file mode 100644
index 0000000..983036c
--- /dev/null
+++ b/PT/asciidoc/arc42-template.adoc
@@ -0,0 +1,102 @@
+// header file for arc42-template,
+// including all help texts
+//
+// ====================================
+
+// configure EN settings for asciidoc
+include::src/config.adoc[]
+
+= Modelo image:arc42-logo.png[arc42]
+:title: Modelo arc42
+:revnumber: 8.2 PT
+:revdate: Setembro de 2024
+:revremark: (baseado na versão AsciiDoc)
+:version-label: Versão
+// toc-title definition MUST follow document title without blank line!
+:toc-title: Sumário
+
+//additional style for arc42 help callouts
+ifdef::backend-html5[]
+++++
+<style>
+.arc42help {font-size:small; width: 14px; height: 16px; overflow: hidden; position: absolute; right: 0; padding: 2px 0 3px 2px;}
+.arc42help::before {content: "?";}
+.arc42help:hover {width:auto; height: auto; z-index: 100; padding: 10px;}
+.arc42help:hover::before {content: "";}
+@media print {
+	.arc42help {display:none;}
+}
+</style>
+++++
+endif::backend-html5[]
+
+
+include::src/about-arc42.adoc[]
+
+// horizontal line
+***
+
+ifdef::arc42help[]
+[role="arc42help"]
+****
+[NOTE]
+====
+Esta versão do modelo contém algumas ajudas e explicações.
+É usada para familiarização com arc42 e compreensão dos conceitos.
+Para a documentação do seu próprio sistema, é melhor usar a versão _plain_.
+====
+****
+endif::arc42help[]
+
+// numbering from here on
+:numbered:
+
+<<<<
+// 1. Introduction and Goals
+include::src/01_introduction_and_goals.adoc[]
+
+<<<<
+// 2. Architecture Constraints
+include::src/02_architecture_constraints.adoc[]
+
+<<<<
+// 3. Context and Scope
+include::src/03_context_and_scope.adoc[]
+
+<<<<
+// 4. Solution Strategy
+include::src/04_solution_strategy.adoc[]
+
+<<<<
+// 5. Building Block View
+include::src/05_building_block_view.adoc[]
+
+<<<<
+// 6. Runtime View
+include::src/06_runtime_view.adoc[]
+
+<<<<
+// 7. Deployment View
+include::src/07_deployment_view.adoc[]
+
+<<<<
+// 8. Concepts
+include::src/08_concepts.adoc[]
+
+<<<<
+// 9. Architecture Decisions
+include::src/09_architecture_decisions.adoc[]
+
+<<<<
+// 10. Quality Requirements
+include::src/10_quality_requirements.adoc[]
+
+<<<<
+// 11. Technical Risks
+include::src/11_technical_risks.adoc[]
+
+<<<<
+// 12. Glossary
+include::src/12_glossary.adoc[]
+
+
diff --git a/PT/asciidoc/src/01_introduction_and_goals.adoc b/PT/asciidoc/src/01_introduction_and_goals.adoc
new file mode 100644
index 0000000..1b28773
--- /dev/null
+++ b/PT/asciidoc/src/01_introduction_and_goals.adoc
@@ -0,0 +1,100 @@
+ifndef::imagesdir[:imagesdir: ../images]
+
+[[section-introduction-and-goals]]
+== Introdução e Objetivos
+
+ifdef::arc42help[]
+[role="arc42help"]
+****
+Descreve os requisitos relevantes e as forças motrizes que os arquitetos de software e a equipe de desenvolvimento devem considerar.
+Isso inclui
+
+* objetivos de negócios subjacentes,
+* recursos essenciais,
+* requisitos funcionais essenciais,
+* objetivos de qualidade para a arquitetura e
+* partes interessadas relevantes e suas expectativas
+****
+endif::arc42help[]
+
+=== Visão Geral dos Requisitos
+
+ifdef::arc42help[]
+[role="arc42help"]
+****
+.Conteúdo
+Descrição curta dos requisitos funcionais, forças motrizes, excerto (ou resumo)
+dos requisitos. Link para (esperançosamente existentes) documentos de requisitos
+(com número da versão e informações sobre onde encontrá-lo).
+
+.Motivação
+Do ponto de vista dos usuários finais, um sistema é criado ou modificado para
+melhorar o suporte e/ou melhorar a qualidade de uma atividade negocial.
+
+.Forma
+Descrição textual curta, provavelmente em formato tabular de casos de uso.
+Se existirem documentos de requisitos, esta visão geral deve se referir a esses documentos.
+
+Mantenha esses trechos o mais curtos possível. Equilibre a legibilidade deste documento com a redundância potencial em relação aos documentos de requisitos.
+
+.Mais informações
+
+Consulte https://docs.arc42.org/section-1/[Introduction and Goals] na documentação do arc42.
+
+****
+endif::arc42help[]
+
+=== Objetivos de Qualidade
+
+ifdef::arc42help[]
+[role="arc42help"]
+****
+.Conteúdo
+Os três principais (máx. cinco) objetivos de qualidade para a arquitetura cujo cumprimento é de maior importância para as principais partes interessadas.
+Nós realmente queremos dizer objetivos de qualidade para a arquitetura. Não os confunda com objetivos de projeto.
+Eles não são necessariamente idênticos.
+
+Considere esta visão geral de tópicos potenciais (com base no padrão ISO 25010):
+
+image::01_2_iso-25010-topics-EN.drawio.png["Categorias de Requisitos de Qualidade"]
+
+.Motivação
+Você deve saber os objetivos de qualidade de suas partes interessadas mais importantes, pois elas influenciarão decisões arquiteturais fundamentais.
+Certifique-se de ser muito concreto sobre essas qualidades, evite chavões.
+Se você, como arquiteto, não sabe como a qualidade do seu trabalho será julgada...
+
+.Forma
+Uma tabela com objetivos de qualidade e cenários concretos, ordenados por prioridades
+****
+endif::arc42help[]
+
+=== Partes Interessadas
+
+ifdef::arc42help[]
+[role="arc42help"]
+****
+.Conteúdo
+Visão geral explícita das partes interessadas do sistema, ou seja, todas as pessoas, funções ou organizações que
+
+* devem conhecer a arquitetura
+* precisam ser convencidas da arquitetura
+* precisam trabalhar com a arquitetura ou com código
+* precisam da documentação da arquitetura para seu trabalho
+* precisam tomar decisões sobre o sistema ou seu desenvolvimento
+
+.Motivação
+Você deve conhecer todas as partes envolvidas no desenvolvimento do sistema ou afetadas pelo sistema.
+Caso contrário, você pode ter surpresas desagradáveis ​​mais tarde no processo de desenvolvimento.
+Essas partes interessadas determinam a extensão e o nível de detalhes do seu trabalho e seus resultados.
+
+.Forma
+Tabela com nomes de funções, nomes de pessoas e suas expectativas com relação à arquitetura e sua documentação.
+****
+endif::arc42help[]
+
+[options="header",cols="1,2,2"]
+|===
+|Função/Nome|Contato|Expectativas
+| _<Função-1>_ | _<Contato-1>_ | _<Expectativa-1>_
+| _<Função-2>_ | _<Contato-2>_ | _<Expectativa-2>_
+|===
diff --git a/PT/asciidoc/src/02_architecture_constraints.adoc b/PT/asciidoc/src/02_architecture_constraints.adoc
new file mode 100644
index 0000000..aa3fcd9
--- /dev/null
+++ b/PT/asciidoc/src/02_architecture_constraints.adoc
@@ -0,0 +1,28 @@
+ifndef::imagesdir[:imagesdir: ../images]
+
+[[section-architecture-constraints]]
+== Restrições Arquiteturais
+
+
+ifdef::arc42help[]
+[role="arc42help"]
+****
+.Conteúdo
+Qualquer requisito que restrinja arquitetos de software em sua liberdade de decisões de design e implementação ou decisão sobre o processo de desenvolvimento. Essas restrições às vezes vão além de sistemas individuais e são válidas para organizações e empresas inteiras.
+
+.Motivação
+Arquitetos devem saber exatamente onde são livres em suas decisões de design e onde devem aderir às restrições.
+Restrições devem sempre ser tratadas; elas podem ser negociáveis, no entanto.
+
+.Forma
+Tabelas simples de restrições com explicações.
+Se necessário, você pode subdividi-las em
+restrições técnicas, restrições organizacionais e políticas e
+convenções (por exemplo, diretrizes de programação ou controle de versão, convenções de documentação ou nomenclatura)
+
+.Mais informações
+
+Consulte https://docs.arc42.org/section-2/[Architecture Constraints] na documentação do arc42.
+
+****
+endif::arc42help[]
diff --git a/PT/asciidoc/src/03_context_and_scope.adoc b/PT/asciidoc/src/03_context_and_scope.adoc
new file mode 100644
index 0000000..92c75be
--- /dev/null
+++ b/PT/asciidoc/src/03_context_and_scope.adoc
@@ -0,0 +1,78 @@
+ifndef::imagesdir[:imagesdir: ../images]
+
+[[section-context-and-scope]]
+== Contexto e Escopo
+
+
+ifdef::arc42help[]
+[role="arc42help"]
+****
+.Conteúdo
+Contexto e escopo - como o nome sugere - delimita seu sistema (ou seja, seu escopo) de todos os seus parceiros de comunicação
+(sistemas e usuários vizinhos, ou seja, o contexto do seu sistema). Ele especifica, portanto, as interfaces externas.
+
+Se necessário, diferencie o contexto de negócios (entradas e saídas específicas do domínio) do contexto técnico (canais, protocolos, hardware).
+
+.Motivação
+As interfaces de domínio e as interfaces técnicas para parceiros de comunicação estão entre os aspectos mais críticos do seu sistema. Certifique-se de entendê-las completamente.
+
+.Forma
+Várias opções:
+
+* Diagramas de contexto
+* Listas de parceiros de comunicação e suas interfaces.
+
+.Mais informações
+
+Consulte https://docs.arc42.org/section-3/[Context and Scope] na documentação do arc42.
+
+****
+endif::arc42help[]
+
+=== Contexto Negocial
+
+ifdef::arc42help[]
+[role="arc42help"]
+****
+.Conteúdo
+Especificação de *todos* os parceiros de comunicação (usuários, sistemas de TI, ...) com explicações de entradas e saídas ou interfaces específicas do domínio.
+Opcionalmente, você pode adicionar formatos específicos do domínio ou protocolos de comunicação.
+
+.Motivação
+Todas as partes interessadas devem entender quais dados são trocados com o ambiente do sistema.
+
+.Forma
+Todos os tipos de diagramas que mostram o sistema como uma caixa preta e especificam as interfaces de domínio para os parceiros de comunicação.
+
+Como alternativa (ou adicionalmente), você pode usar uma tabela.
+O título da tabela é o nome do seu sistema, as três colunas contêm o nome do parceiro de comunicação, as entradas e as saídas.
+****
+endif::arc42help[]
+
+**<Diagrama ou Tabela>**
+
+**<opcionalmente: Explicação das interfaces de domínio externo>**
+
+=== Contexto Técnico
+
+ifdef::arc42help[]
+[role="arc42help"]
+****
+.Conteúdo
+Interfaces técnicas (canais e mídias de transmissão) que vinculam seu sistema ao seu ambiente. Além disso, um mapeamento de entrada/saída específica de domínio para os canais, ou seja, uma explicação de qual E/S usa qual canal.
+
+.Motivação
+Muitas partes interessadas tomam decisões arquiteturais com base nas interfaces técnicas entre o sistema e seu contexto. Especialmente os designers de infraestrutura ou hardware decidem essas interfaces técnicas.
+
+.Forma
+Por exemplo, diagrama de implantação UML descrevendo canais para sistemas vizinhos,
+junto com uma tabela de mapeamento mostrando os relacionamentos entre canais e entrada/saída.
+
+****
+endif::arc42help[]
+
+**<Diagrama ou Tabela>**
+
+**<opcionalmente: Explicação das interfaces técnicas>**
+
+**<Mapeamento de entrada/saída para canais>**
diff --git a/PT/asciidoc/src/04_solution_strategy.adoc b/PT/asciidoc/src/04_solution_strategy.adoc
new file mode 100644
index 0000000..721ae3c
--- /dev/null
+++ b/PT/asciidoc/src/04_solution_strategy.adoc
@@ -0,0 +1,33 @@
+ifndef::imagesdir[:imagesdir: ../images]
+
+[[section-solution-strategy]]
+== Estratégia de Solução
+
+
+ifdef::arc42help[]
+[role="arc42help"]
+****
+.Conteúdo
+Um breve resumo e explicação das decisões fundamentais e estratégias de solução que moldam a arquitetura do sistema. Inclui
+
+* decisões de tecnologia
+* decisões sobre a decomposição de nível superior do sistema, por exemplo, uso de um padrão arquitetural ou _design pattern_
+* decisões sobre como atingir as principais metas de qualidade
+* decisões organizacionais relevantes, por exemplo, selecionar um processo de desenvolvimento ou delegar certas tarefas a terceiros.
+
+.Motivação
+Essas decisões formam os pilares da sua arquitetura. Elas são a base para muitas outras decisões detalhadas ou regras de implementação.
+
+.Forma
+Mantenha as explicações dessas decisões-chave curtas.
+
+Motive o que foi decidido e por que foi decidido dessa forma,
+com base na declaração do problema, metas de qualidade e principais restrições.
+Consulte os detalhes nas seções a seguir.
+
+.Mais informações
+
+Consulte https://docs.arc42.org/section-4/[Solution Strategy] na documentação do arc42.
+
+****
+endif::arc42help[]
diff --git a/PT/asciidoc/src/05_building_block_view.adoc b/PT/asciidoc/src/05_building_block_view.adoc
new file mode 100644
index 0000000..82e431d
--- /dev/null
+++ b/PT/asciidoc/src/05_building_block_view.adoc
@@ -0,0 +1,225 @@
+ifndef::imagesdir[:imagesdir: ../images]
+
+[[section-building-block-view]]
+
+
+== Visão de Blocos de Construção
+
+ifdef::arc42help[]
+[role="arc42help"]
+****
+.Conteúdo
+A visão de blocos de construção mostra a decomposição estática do sistema em blocos de construção (módulos, componentes, subsistemas, classes, interfaces, pacotes, bibliotecas, frameworks, camadas, partições, níveis, funções, macros, operações, estruturas de dados, ...) bem como suas dependências (relacionamentos, associações, ...)
+
+Esta visão é obrigatória para toda documentação de arquitetura.
+Em analogia a uma casa, esta é a _planta baixa_.
+
+.Motivação
+Mantenha uma visão geral do seu código-fonte tornando sua estrutura compreensível por meio de
+abstração.
+
+Isso permite que você se comunique com suas partes interessadas em um nível abstrato sem revelar detalhes de implementação.
+
+.Forma
+A visão de blocos de construção é uma coleção hierárquica de caixas pretas e caixas brancas
+(veja a figura abaixo) e suas descrições.
+
+image::05_building_blocks-EN.png["Hierarquia de blocos de construção"]
+
+*Nível 1* é a descrição da caixa branca do sistema geral, juntamente com descrições
+de caixa preta de todos os blocos de construção contidos.
+
+*Nível 2* amplia alguns blocos de construção do nível 1.
+Portanto, ele contém a descrição da caixa branca dos blocos de construção selecionados do nível 1, juntamente com descrições de caixa preta de seus blocos de construção internos.
+
+*Nível 3* amplia os blocos de construção selecionados do nível 2, e assim por diante.
+
+
+.Mais informações
+
+Consulte https://docs.arc42.org/section-5/[Building Block View] na documentação do arc42.
+
+****
+endif::arc42help[]
+
+=== Visão Sistêmica Geral de Caixa Branca
+
+ifdef::arc42help[]
+[role="arc42help"]
+****
+Aqui você descreve a decomposição geral do sistema usando o seguinte modelo de caixa branca. Ele contém
+
+* um diagrama de visão geral
+* uma motivação para a decomposição
+* descrições de caixa preta dos blocos de construção contidos. Para isso, oferecemos alternativas:
+
+** use _uma_ tabela para uma visão geral curta e pragmática de todos os blocos de construção contidos e suas interfaces
+** use uma lista de descrições de caixa preta dos blocos de construção de acordo com o modelo de caixa preta (veja abaixo).
+Dependendo da sua escolha de ferramenta, esta lista pode ser subcapítulos (em arquivos de texto), subpáginas (em um Wiki) ou elementos aninhados (em uma ferramenta de modelagem).
+
+
+* (opcional:) interfaces importantes, que não são explicadas nos modelos de caixa preta de um bloco de construção, mas são muito importantes para entender a caixa branca.
+Já que há tantas maneiras de especificar interfaces, por que não fornecer um modelo específico para elas?
+No pior caso, você tem que especificar e descrever sintaxe, semântica, protocolos, tratamento de erros,
+restrições, versões, qualidades, compatibilidades necessárias e muito mais.
+Na melhor das hipóteses, você conseguirá usar exemplos ou assinaturas simples.
+
+****
+endif::arc42help[]
+
+_**<Diagrama de Visão Geral>**_
+
+Motivação::
+
+_<explicação textual>_
+
+
+Blocos de Construção Contidos::
+_<Descrição dos blocos de construção contidos (caixas pretas)>_
+
+Interfaces Importantes::
+_<Descrição de interfaces importantes>_
+
+ifdef::arc42help[]
+[role="arc42help"]
+****
+Insira suas explicações de caixas pretas do nível 1:
+
+Se você usar a forma tabular, você descreverá apenas suas caixas pretas com nome e
+responsabilidade de acordo com o seguinte esquema:
+
+[cols="1,2" options="header"]
+|===
+| **Nome** | **Responsabilidade**
+| _<caixa preta 1>_ | _<Texto>_
+| _<caixa preta 2>_ | _<Texto>_
+|===
+
+
+
+Se você usar uma lista de descrições de caixa preta, então você preenche um modelo de caixa preta separado para cada bloco de construção importante.
+Seu título é o nome da caixa preta.
+****
+endif::arc42help[]
+
+==== <Nome Caixa Preta 1>
+
+ifdef::arc42help[]
+[role="arc42help"]
+****
+Aqui você descreve <caixa preta 1>
+de acordo com o seguinte modelo de caixa preta:
+
+* Propósito/Responsabilidade
+* Interface(s), quando não são extraídas como parágrafos separados. Essas interfaces podem incluir qualidades e características de desempenho.
+* (Opcional) Características de qualidade/desempenho da caixa preta, por exemplo, disponibilidade, comportamento de tempo de execução, ....
+* (Opcional) Local do diretório/arquivo
+* (Opcional) Requisitos atendidos (se você precisar de rastreabilidade para requisitos).
+* (Opcional) Problemas/questões/riscos abertos
+
+****
+endif::arc42help[]
+
+_<Propósito/Responsabilidade>_
+
+_<Interface(s)>_
+
+_<(Opcional) Características de Qualidade/Desempenho>_
+
+_<(Opcional) Local do Diretório/Arquivo>_
+
+_<(Opcional) Requisitos Cumpridos>_
+
+_<(opcional) Problemas/Riscos Abertos>_
+
+
+
+
+==== <Nome Caixa Preta 2>
+
+_<modelo de caixa preta>_
+
+==== <Nome Caixa Preta n>
+
+_<modelo de caixa preta>_
+
+
+==== <Nome Interface 1>
+
+...
+
+==== <Nome Interface m>
+
+
+
+=== Nível 2
+
+ifdef::arc42help[]
+[role="arc42help"]
+****
+Aqui você pode especificar a estrutura interna de (alguns) blocos de construção do nível 1 como caixas brancas.
+
+Você tem que decidir quais blocos de construção do seu sistema são importantes o suficiente para justificar uma descrição tão detalhada.
+Por favor, prefira relevância à completude. Especifique blocos de construção importantes, surpreendentes, arriscados, complexos ou voláteis.
+Deixe de fora partes normais, simples, chatas ou padronizadas do seu sistema
+****
+endif::arc42help[]
+
+==== Caixa Branca _<Bloco de Construção 1>_
+
+ifdef::arc42help[]
+[role="arc42help"]
+****
+...descreve a estrutura interna do _bloco de construção 1_.
+****
+endif::arc42help[]
+
+_<modelo de caixa branca>_
+
+==== Caixa Branca _<Bloco de Construção 2>_
+
+
+_<modelo de caixa branca>_
+
+...
+
+==== Caixa Branca _<Bloco de Construção m>_
+
+
+_<modelo de caixa branca>_
+
+
+
+=== Nível 3
+
+ifdef::arc42help[]
+[role="arc42help"]
+****
+Aqui você pode especificar a estrutura interna de (alguns) blocos de construção do nível 2 como caixas brancas.
+
+Quando precisar de níveis mais detalhados de sua arquitetura, copie esta
+parte do arc42 para níveis adicionais.
+****
+endif::arc42help[]
+
+==== Caixa Branca <_Bloco de Construção x.1_>
+
+ifdef::arc42help[]
+[role="arc42help"]
+****
+Especifica a estrutura interna do _bloco de construção x.1_.
+****
+endif::arc42help[]
+
+_<modelo de caixa branca>_
+
+
+==== Caixa Branca <_Bloco de Construção x.2_>
+
+_<modelo de caixa branca>_
+
+
+
+==== Caixa Branca <_Bloco de Construção y.1_>
+
+_<modelo de caixa branca>_
diff --git a/PT/asciidoc/src/06_runtime_view.adoc b/PT/asciidoc/src/06_runtime_view.adoc
new file mode 100644
index 0000000..7e8fd0e
--- /dev/null
+++ b/PT/asciidoc/src/06_runtime_view.adoc
@@ -0,0 +1,52 @@
+ifndef::imagesdir[:imagesdir: ../images]
+
+[[section-runtime-view]]
+== Visão de Tempo de Execução
+
+
+ifdef::arc42help[]
+[role="arc42help"]
+****
+.Conteúdo
+A visão de tempo de execução descreve o comportamento concreto e as interações dos blocos de construção do sistema na forma de cenários das seguintes áreas:
+
+* casos de uso ou recursos importantes: como os blocos de construção os executam?
+* interações em interfaces externas críticas: como os blocos de construção cooperam com os usuários e sistemas vizinhos?
+* operação e administração: lançamento, inicialização, parada
+* cenários de erro e exceção
+
+Observação: O principal critério para a escolha de cenários possíveis (sequências, fluxos de trabalho) é sua *relevância arquitetural*. *Não* é importante descrever um grande número de cenários. Você deve documentar uma seleção representativa.
+
+.Motivação
+Você deve entender como (instâncias de) blocos de construção do seu sistema realizam seu trabalho e se comunicam em tempo de execução.
+Você capturará principalmente cenários em sua documentação para comunicar sua arquitetura às partes interessadas que estão menos dispostas ou capazes de ler e entender os modelos estáticos (visão de bloco de construção, visão de implantação).
+
+.Forma
+Há muitas notações para descrever cenários, por exemplo,
+
+* lista numerada de etapas (em linguagem natural)
+* diagramas de atividade ou fluxogramas
+* diagramas de sequência
+* BPMN ou EPCs (cadeias de processos de eventos)
+* máquinas de estado
+* ...
+
+.Mais informações
+
+
+Consulte https://docs.arc42.org/section-6/[Runtime View] na documentação do arc42.
+
+****
+endif::arc42help[]
+
+=== <Cenário de Tempo de Execução 1>
+
+* _<inserir diagrama de tempo de execução ou descrição textual do cenário>_
+* _<inserir descrição dos aspectos notáveis ​​das interações entre as
+instâncias do bloco de construção descritas neste diagrama.>_
+
+=== <Cenário de Tempo de Execução 2>
+
+=== ...
+
+=== <Cenário de Tempo de Execução n>
diff --git a/PT/asciidoc/src/07_deployment_view.adoc b/PT/asciidoc/src/07_deployment_view.adoc
new file mode 100644
index 0000000..1600d8a
--- /dev/null
+++ b/PT/asciidoc/src/07_deployment_view.adoc
@@ -0,0 +1,100 @@
+ifndef::imagesdir[:imagesdir: ../images]
+
+[[section-deployment-view]]
+
+
+== Visão de Implantação
+
+ifdef::arc42help[]
+[role="arc42help"]
+****
+.Conteúdo
+A visão de implantação descreve:
+
+1. infraestrutura técnica usada para executar seu sistema, com elementos de infraestrutura como localizações geográficas, ambientes, computadores, processadores, canais e topologias de rede, bem como outros elementos de infraestrutura e
+
+2. mapeamento de blocos de construção (de software) para esses elementos de infraestrutura.
+
+Frequentemente, os sistemas são executados em ambientes diferentes, por exemplo, ambiente de desenvolvimento, ambiente de teste, ambiente de produção. Nesses casos, você deve documentar todos os ambientes relevantes.
+
+Documente especialmente uma visão de implantação se seu software for executado como um sistema distribuído com mais de um computador, processador, servidor ou contêiner ou quando você projeta e constrói seus próprios processadores e chips de hardware.
+
+De uma perspectiva de software, é suficiente capturar apenas os elementos de uma infraestrutura que são necessários para mostrar uma implantação de seus blocos de construção. Arquitetos de hardware podem ir além disso e descrever uma infraestrutura em qualquer nível de detalhe que precisem capturar.
+
+.Motivação
+O software não roda sem hardware.
+Essa infraestrutura subjacente pode e influenciará um sistema e/ou alguns
+conceitos transversais. Portanto, é necessário conhecer a infraestrutura.
+
+.Forma
+
+Talvez um diagrama de implantação de nível mais alto já esteja contido na seção 3.2. como
+contexto técnico com sua própria infraestrutura como UMA caixa preta. Nesta seção, pode-se
+ampliar esta caixa preta usando diagramas de implantação adicionais:
+
+* UML oferece diagramas de implantação para expressar essa visão. Use-o, provavelmente com diagramas aninhados,
+quando sua infraestrutura for mais complexa.
+* Quando suas partes interessadas (de hardware) preferirem outros tipos de diagramas em vez de um diagrama de implantação, deixe-os usar qualquer tipo que seja capaz de mostrar nós e canais da infraestrutura.
+
+
+.Mais informações
+
+Consulte https://docs.arc42.org/section-7/[Deployment View] na documentação do arc42.
+
+****
+endif::arc42help[]
+
+=== Nível de Infraestrutura 1
+
+ifdef::arc42help[]
+[role="arc42help"]
+****
+Descreva (geralmente em uma combinação de diagramas, tabelas e texto):
+
+* distribuição de um sistema para vários locais, ambientes, computadores, processadores, .., bem como conexões físicas entre eles
+* justificativas ou motivações importantes para esta estrutura de implantação
+* recursos de qualidade e/ou desempenho desta infraestrutura
+* mapeamento de artefatos de software para elementos desta infraestrutura
+
+Para vários ambientes ou implantações alternativas, copie e adapte esta seção do arc42 para todos os ambientes relevantes.
+****
+endif::arc42help[]
+
+_**<Diagrama de Visão Geral>**_
+
+Motivação::
+
+_<explicação em forma de texto>_
+
+Características de Qualidade e/ou Desempenho::
+
+_<explicação em forma de texto>_
+
+Mapeamento de Blocos de Construção para Infraestrutura::
+_<descrição do mapeamento>_
+
+
+=== Nível de Infraestrutura 2
+
+ifdef::arc42help[]
+[role="arc42help"]
+****
+Aqui você pode incluir a estrutura interna de (alguns) elementos de infraestrutura do nível 1.
+
+Copie a estrutura do nível 1 para cada elemento selecionado.
+****
+endif::arc42help[]
+
+==== _<Elemento de Infraestrutura 1>_
+
+_<diagrama + explicação>_
+
+==== _<Elemento de Infraestrutura 2>_
+
+_<diagrama + explicação>_
+
+...
+
+==== _<Elemento de Infraestrutura n>_
+
+_<diagrama + explicação>_
\ No newline at end of file
diff --git a/PT/asciidoc/src/08_concepts.adoc b/PT/asciidoc/src/08_concepts.adoc
new file mode 100644
index 0000000..4ad43e5
--- /dev/null
+++ b/PT/asciidoc/src/08_concepts.adoc
@@ -0,0 +1,74 @@
+ifndef::imagesdir[:imagesdir: ../images]
+
+[[section-concepts]]
+== Conceitos Transversais
+
+
+ifdef::arc42help[]
+[role="arc42help"]
+****
+.Conteúdo
+Esta seção descreve globalmente, as principais regulamentações e ideias de soluções que são relevantes em várias partes (= transversais) do seu sistema.
+Esses conceitos geralmente estão relacionados a vários blocos de construção.
+Eles podem incluir muitos tópicos diferentes, como
+
+* modelos, especialmente modelos de domínio
+* padrões de arquitetura ou _design patterns_
+* regras para usar tecnologia específica
+* principais decisões, geralmente técnicas, de natureza abrangente (= transversais)
+* regras de implementação
+
+
+.Motivação
+Os conceitos formam a base para a _integridade conceitual_ (consistência, homogeneidade) da arquitetura.
+Portanto, eles são uma contribuição importante para atingir as qualidades internas do seu sistema.
+
+Alguns desses conceitos não podem ser atribuídos a blocos de construção individuais, por exemplo segurança ou proteção.
+
+
+.Forma
+A forma pode ser variada:
+
+* documentos conceituais com qualquer tipo de estrutura
+* trechos ou cenários de modelos transversais usando notações das visualizações de arquitetura
+* amostra de implementações, especialmente para conceitos técnicos
+* referência ao uso típico de _frameworks_ padrão (por exemplo, usando Hibernate para mapeamento de objeto/relacional)
+
+.Estrutura
+Uma estrutura potencial (mas não obrigatória) para esta seção poderia ser:
+
+* Conceitos de domínio
+* Conceitos de Experiência do Usuário (UX)
+* Conceitos de proteção e segurança
+* Padrões de arquitetura e _design patterns_
+* Estruturas internas
+* Conceitos de desenvolvimento
+* Conceitos operacionais
+
+Observação: pode ser difícil atribuir conceitos individuais a um tópico específico
+nesta lista.
+
+image::08-Crosscutting-Concepts-Structure-EN.png["Tópicos possíveis para conceitos transversais"]
+
+
+.Mais informações
+
+Veja https://docs.arc42.org/section-8/[Concepts] na documentação do arc42.
+****
+endif::arc42help[]
+
+=== _<Conceito 1>_
+
+_<explicação>_
+
+
+
+=== _<Conceito 2>_
+
+_<explicação>_
+
+...
+
+=== _<Conceito n>_
+
+_<explicação>_
diff --git a/PT/asciidoc/src/09_architecture_decisions.adoc b/PT/asciidoc/src/09_architecture_decisions.adoc
new file mode 100644
index 0000000..c43517f
--- /dev/null
+++ b/PT/asciidoc/src/09_architecture_decisions.adoc
@@ -0,0 +1,37 @@
+ifndef::imagesdir[:imagesdir: ../images]
+
+[[section-design-decisions]]
+== Decisões Arquiteturais
+
+
+ifdef::arc42help[]
+[role="arc42help"]
+****
+.Conteúdo
+Decisões arquiteturais importantes, caras, de grande escala ou arriscadas, incluindo justificativas.
+Com "decisões", queremos dizer selecionar uma alternativa com base em critérios fornecidos.
+
+Use seu julgamento para decidir se uma decisão de arquitetura deve ser documentada
+aqui nesta seção central ou se é melhor documentá-la localmente
+(por exemplo, dentro do modelo de caixa branca de um bloco de construção).
+
+Evite redundância.
+Consulte a seção 4, onde você já capturou as decisões mais importantes da sua arquitetura.
+
+.Motivação
+As partes interessadas do seu sistema devem ser capazes de compreender e refazer suas decisões.
+
+.Forma
+Várias opções:
+
+* ADR (Architecture Decision Record) (https://cognitect.com/blog/2011/11/15/documenting-architecture-decisions[Documentando Decisões de Arquitetura]) para cada decisão importante
+* Lista ou tabela, ordenada por importância e consequências ou:
+* mais detalhada em forma de seções separadas por decisão
+
+.Mais informações
+
+Veja https://docs.arc42.org/section-9/[Architecture Decisions] na documentação do arc42.
+Lá você encontrará links e exemplos sobre ADR.
+
+****
+endif::arc42help[]
diff --git a/PT/asciidoc/src/10_quality_requirements.adoc b/PT/asciidoc/src/10_quality_requirements.adoc
new file mode 100644
index 0000000..665175c
--- /dev/null
+++ b/PT/asciidoc/src/10_quality_requirements.adoc
@@ -0,0 +1,79 @@
+ifndef::imagesdir[:imagesdir: ../images]
+
+[[section-quality-scenarios]]
+== Requisitos de qualidade
+
+
+ifdef::arc42help[]
+[role="arc42help"]
+****
+
+.Conteúdo
+Esta seção contém todos os requisitos de qualidade como árvore de qualidade com cenários. Os mais importantes já foram descritos na seção 1.2. (objetivos de qualidade)
+
+Aqui você também pode capturar requisitos de qualidade com menor prioridade,
+que não criarão altos riscos quando não forem totalmente alcançados.
+
+.Motivação
+Como os requisitos de qualidade terão muita influência nas decisões arquiteturais,
+você deve saber para cada parte interessada o que é realmente importante para eles,
+concreto e mensurável.
+
+
+.Mais informações
+
+Veja https://docs.arc42.org/section-10/[Quality Requirements] na documentação do arc42.
+
+****
+endif::arc42help[]
+
+=== Árvore de qualidade
+
+ifdef::arc42help[]
+[role="arc42help"]
+****
+.Conteúdo
+A árvore de qualidade (conforme definido no ATAM – Architecture Tradeoff Analysis Method) com cenários de qualidade/avaliação como folhas.
+
+.Motivação
+A estrutura de árvore com prioridades fornece uma visão geral para um número às vezes grande de requisitos de qualidade.
+
+.Forma
+A árvore de qualidade é uma visão geral de alto nível das metas e requisitos de qualidade:
+
+* refinamento em forma de árvore do termo "qualidade". Use "qualidade" ou "utilidade" como raiz
+* um mapa mental com categorias de qualidade como ramos principais
+
+Em qualquer caso, a árvore deve incluir links para os cenários da seção a seguir.
+
+
+****
+endif::arc42help[]
+
+=== Cenários de Qualidade
+
+ifdef::arc42help[]
+[role="arc42help"]
+****
+.Conteúdo
+Concretização de requisitos de qualidade (às vezes vagos ou implícitos) usando cenários (de qualidade).
+
+Esses cenários descrevem o que deve acontecer quando um estímulo chega ao sistema.
+
+Para arquitetos, dois tipos de cenários são importantes:
+
+* Cenários de uso (também chamados de cenários de aplicação ou cenários de caso de uso) descrevem a reação do tempo de execução do sistema a um determinado estímulo. Isso também inclui cenários que descrevem a eficiência ou o desempenho do sistema. Exemplo: O sistema reage à solicitação de um usuário em um segundo.
+* Cenários de mudança descrevem uma modificação do sistema ou de seu ambiente imediato. Exemplo: Funcionalidade adicional é implementada ou requisitos para um atributo de qualidade mudam.
+
+.Motivação
+Os cenários tornam os requisitos de qualidade concretos e permitem
+medir ou decidir mais facilmente se eles são atendidos.
+
+Especialmente quando você quer avaliar sua arquitetura usando métodos como
+ATAM você precisa descrever suas metas de qualidade (da seção 1.2)
+mais precisamente até um nível de cenários que podem ser discutidos e avaliados.
+
+.Form
+Tabular ou texto livre.
+****
+endif::arc42help[]
diff --git a/PT/asciidoc/src/11_technical_risks.adoc b/PT/asciidoc/src/11_technical_risks.adoc
new file mode 100644
index 0000000..0cba61e
--- /dev/null
+++ b/PT/asciidoc/src/11_technical_risks.adoc
@@ -0,0 +1,27 @@
+ifndef::imagesdir[:imagesdir: ../images]
+
+[[section-technical-risks]]
+== Riscos e Débitos Técnicos
+
+
+ifdef::arc42help[]
+[role="arc42help"]
+****
+.Conteúdo
+Uma lista de riscos técnicos identificados ou débitos técnicos, ordenadas por prioridade
+
+.Motivação
+“Gerenciamento de riscos é gerenciamento de projetos para adultos” (Tim Lister, Atlantic Systems Guild.)
+
+Este deve ser seu lema para detecção e avaliação sistemáticas de riscos e débitos técnicos na arquitetura, que serão necessárias para as partes interessadas da gerência (por exemplo, gerentes de projeto, proprietários de produtos) como parte da análise geral de riscos e planejamento de medição.
+
+.Forma
+Lista de riscos e/ou débitos técnicos, provavelmente incluindo medidas sugeridas para minimizar, mitigar ou evitar riscos ou reduzir débitos técnicos.
+
+
+.Mais informações
+
+Veja https://docs.arc42.org/section-11/[Risks and Technical Debt] na documentação do arc42.
+
+****
+endif::arc42help[]
diff --git a/PT/asciidoc/src/12_glossary.adoc b/PT/asciidoc/src/12_glossary.adoc
new file mode 100644
index 0000000..9b64b7b
--- /dev/null
+++ b/PT/asciidoc/src/12_glossary.adoc
@@ -0,0 +1,44 @@
+ifndef::imagesdir[:imagesdir: ../images]
+
+[[section-glossary]]
+== Glossário
+
+ifdef::arc42help[]
+[role="arc42help"]
+****
+.Conteúdo
+Os termos técnicos e de domínio mais importantes que suas partes interessadas usam ao discutir o sistema.
+
+Você também pode ver o glossário como fonte para traduções se trabalhar em equipes multilíngues.
+
+.Motivação
+Você deve definir claramente seus termos, para que todas as partes interessadas
+
+* tenham um entendimento idêntico desses termos
+* não usem sinônimos e homônimos
+
+
+.Forma
+
+Uma tabela com colunas <Termo> e <Definição>.
+
+Possivelmente mais colunas, caso precise de traduções.
+
+
+.Mais informações
+
+Veja https://docs.arc42.org/section-12/[Glossary] na documentação do arc42.
+
+****
+endif::arc42help[]
+
+[cols="e,2e" options="header"]
+|===
+|Termo |Definição
+
+|<Termo-1>
+|<definição-1>
+
+|<Termo-2>
+|<definição-2>
+|===
\ No newline at end of file
diff --git a/PT/asciidoc/src/about-arc42.adoc b/PT/asciidoc/src/about-arc42.adoc
new file mode 100644
index 0000000..5a0fb89
--- /dev/null
+++ b/PT/asciidoc/src/about-arc42.adoc
@@ -0,0 +1,14 @@
+:homepage: https://arc42.org
+
+:keywords: software-architecture, documentation, template, arc42
+
+:numbered!:
+**Sobre o arc42**
+
+[role="lead"]
+arc42, o template para documentação de software e arquitetura de sistemas.
+
+Versão do template {revnumber}. {revremark}, {revdate}
+
+Criado, mantido e (C) pelo Dr. Peter Hruschka, Dr. Gernot Starke e colaboradores.
+Veja https://arc42.org.
\ No newline at end of file
diff --git a/PT/asciidoc/src/config.adoc b/PT/asciidoc/src/config.adoc
new file mode 100644
index 0000000..9068242
--- /dev/null
+++ b/PT/asciidoc/src/config.adoc
@@ -0,0 +1,10 @@
+// asciidoc settings for EN (English)
+// ==================================
+:toc-title: table of contents
+
+// enable table-of-contents
+:toc:
+
+// where are images located?
+:imagesdir: ./images
+:arc42help: