From 7693d31bceecc4ef2f7f1a77f6e41b18349ea10a Mon Sep 17 00:00:00 2001
From: Rodrigo Fernando Silva <rodrigo.fernando@zup.com.br>
Date: Mon, 11 Apr 2022 09:42:01 -0300
Subject: [PATCH 1/3] add documentation stack

---
 about.md            |   0
 pictures/studio.png | Bin 0 -> 5728 bytes
 stack.yaml          |  12 +++++++++++-
 useCase.md          |   0
 4 files changed, 11 insertions(+), 1 deletion(-)
 create mode 100644 about.md
 create mode 100644 pictures/studio.png
 create mode 100644 useCase.md

diff --git a/about.md b/about.md
new file mode 100644
index 0000000..e69de29
diff --git a/pictures/studio.png b/pictures/studio.png
new file mode 100644
index 0000000000000000000000000000000000000000..16dc6f899c0c2d2b1dee3e0a6d8f48ebd0be4bb5
GIT binary patch
literal 5728
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
SfHji<0000<MNUMnLSTZtH2XpT

literal 0
HcmV?d00001

diff --git a/stack.yaml b/stack.yaml
index e405cbb..13bb9ee 100644
--- a/stack.yaml
+++ b/stack.yaml
@@ -1,2 +1,12 @@
-description: Stack that provides the ability to build applications with Kotlin and Spring, beyond to provide the minimum setup to deploy the app on AWS EKS via CDK
+description: Stack que oferece a capacidade de construir aplicativos com Kotlin e Spring, além de fornecer a configuração mínima para implantar o aplicativo no AWS EKS via CDK
 name: zup-kotlin-stack
+displayName: Kotlin/Spring Stack
+picture: "pictures/studio.jpeg"
+category: Backend
+compatibility:
+  - Java 11
+technologies: ["Kotlin", "SpringBoot", "Logging", "Metrics", "AWS CloudWatch", "Prometheus", "Tracing", "Jaeger", "AWS X-Ray", "AWS SQS", "Relational Database", "MariaDB", "MySQL", "PostgreSQL", "Database Migrations", "Flyway", "Liquibase", "CDK"]
+about: about.md
+useCases:
+  - title: Criar microserviço com Kotlin e Spring
+  - content: useCase.md
\ No newline at end of file
diff --git a/useCase.md b/useCase.md
new file mode 100644
index 0000000..e69de29

From 122a4bced7c5c231cfe2d8438735269d95e12b3d Mon Sep 17 00:00:00 2001
From: Rodrigo Fernando Silva <rodrigo.fernando@zup.com.br>
Date: Wed, 13 Apr 2022 09:47:10 -0300
Subject: [PATCH 2/3] add documentation stack

---
 README.md  |  2 ++
 stack.yaml |  6 +++---
 useCase.md | 17 +++++++++++++++++
 3 files changed, 22 insertions(+), 3 deletions(-)

diff --git a/README.md b/README.md
index b621b24..8a438fd 100644
--- a/README.md
+++ b/README.md
@@ -1 +1,3 @@
 # zup-kotlin-stack
+
+Stack para criação e configuração de infraestrutura AWS EKS e criação de aplicações na liguagem Kotlin e framework Spring com opção de inclusão de capacidades extras como observability, banco de dados relacional, messageria SQS e Argo Rollouts para configuração de deploy canário
diff --git a/stack.yaml b/stack.yaml
index 13bb9ee..6777f1c 100644
--- a/stack.yaml
+++ b/stack.yaml
@@ -1,6 +1,6 @@
-description: Stack que oferece a capacidade de construir aplicativos com Kotlin e Spring, além de fornecer a configuração mínima para implantar o aplicativo no AWS EKS via CDK
-name: zup-kotlin-stack
-displayName: Kotlin/Spring Stack
+description: Stack para criação e configuração de infraestrutura AWS EKS e criação de aplicações na liguagem Kotlin e framework Spring com opção de inclusão de capacidades extras como observability, banco de dados relacional, messageria SQS e Argo Rollouts para configuração de deploy canário
+name: zup-kotlin
+displayName: Kotlin + Spring Stack
 picture: "pictures/studio.jpeg"
 category: Backend
 compatibility:
diff --git a/useCase.md b/useCase.md
index e69de29..305b9db 100644
--- a/useCase.md
+++ b/useCase.md
@@ -0,0 +1,17 @@
+### Capacidades da stack
+
+#### Base dados relacional
+
+O **relational-database-app-kt-plugin** funciona com base no Spring Boot e Spring Data JPA.
+Ele adiciona as dependências das bibliotecas necessárias, o driver JDBC referente ao banco de dados escolhido e, caso opte por uma ferramenta de migração, sua dependência também será adicionada.
+A configuração básica para utilização do banco de dados relacional é adicionada nos respectivos arquivos do projeto, assim como o código CDK para provisionamento do RDS na AWS.
+
+#### Metrics
+
+O **metrics-app-kt-plugin** é um plugin que tem como objetivo padronizar as métricas geradas pelas aplicações. Ao adicionar o plugin na aplicação é possível escolher se as métricas serão enviadas para o [AWS CloudWatch](https://aws.amazon.com/pt/cloudwatch/) ou para o [Prometheus](https://prometheus.io/docs/introduction/overview/).
+
+#### Tracing
+
+O **tracing-app-kt-plugin** visa padronizar o *tracing* gerado pela aplicação utilizando OpenTelemetry para exportação dos dados.
+É possível escolher se o *tracing* gerado será enviado para **Jaeger** ou **AWS X-Ray**.
+

From ecb2ef36d1fc4d358a562302fb3c0527253fa876 Mon Sep 17 00:00:00 2001
From: Rodrigo Fernando Silva <rodrigo.fernando@zup.com.br>
Date: Wed, 13 Apr 2022 09:51:14 -0300
Subject: [PATCH 3/3] add documentation stack

---
 useCase.md | 13 +++++++++++++
 1 file changed, 13 insertions(+)

diff --git a/useCase.md b/useCase.md
index 305b9db..252ba44 100644
--- a/useCase.md
+++ b/useCase.md
@@ -1,5 +1,14 @@
 ### Capacidades da stack
 
+#### Infraestrutura EKS
+
+
+#### Aplicação linguagem Kotlin e framework SpringBoot
+
+
+#### Infraestrutura Argo Rollouts
+
+
 #### Base dados relacional
 
 O **relational-database-app-kt-plugin** funciona com base no Spring Boot e Spring Data JPA.
@@ -15,3 +24,7 @@ O **metrics-app-kt-plugin** é um plugin que tem como objetivo padronizar as mé
 O **tracing-app-kt-plugin** visa padronizar o *tracing* gerado pela aplicação utilizando OpenTelemetry para exportação dos dados.
 É possível escolher se o *tracing* gerado será enviado para **Jaeger** ou **AWS X-Ray**.
 
+#### Messageria
+
+
+#### Deploy Canário
\ No newline at end of file