From 6fbbb1a3a3d96eaca9f780c4f5080d6ae85ece2d Mon Sep 17 00:00:00 2001
From: Sther <72408918+stherzada@users.noreply.github.com>
Date: Mon, 3 Aug 2026 19:44:34 -0300
Subject: [PATCH 1/3] docs(issues): update templates issues

---
 .github/ISSUE_TEMPLATE/bug_report.md          |  48 ++++++++
 .github/ISSUE_TEMPLATE/feature_request.md     |  55 ++++++++++
 .../prd---m\303\263dulo-de-dom\303\255nio.md" | 103 ++++++++++++++++++
 3 files changed, 206 insertions(+)
 create mode 100644 .github/ISSUE_TEMPLATE/bug_report.md
 create mode 100644 .github/ISSUE_TEMPLATE/feature_request.md
 create mode 100644 ".github/ISSUE_TEMPLATE/prd---m\303\263dulo-de-dom\303\255nio.md"

diff --git a/.github/ISSUE_TEMPLATE/bug_report.md b/.github/ISSUE_TEMPLATE/bug_report.md
new file mode 100644
index 00000000..f448ab54
--- /dev/null
+++ b/.github/ISSUE_TEMPLATE/bug_report.md
@@ -0,0 +1,48 @@
+---
+name: Bug report
+about: Reporte um comportamento inesperado para nos ajudar a melhorar
+title: ''
+labels: bug
+assignees: ''
+type: Bug
+
+---
+
+## Descrição do problema
+<!-- Descreva de forma clara e objetiva o que está acontecendo. -->
+
+
+## Comportamento esperado
+<!-- O que você esperava que acontecesse? -->
+
+
+## Comportamento atual
+<!-- O que de fato acontece hoje? -->
+
+
+## Passos para reproduzir
+<!-- Liste o passo a passo exato. Quanto mais detalhado, mais rápido resolvemos. -->
+1. Vá até '...'
+2. Clique em '...'
+3. Preencha '...'
+4. Veja o erro
+
+
+## Ambiente
+<!-- Preencha os dados relevantes ao seu caso. -->
+- **Sistema operacional:** <!-- ex: Windows 11, macOS 14, Ubuntu 22.04 -->
+- **Navegador / versão:** <!-- ex: Chrome 120, Firefox 121 -->
+- **Ambiente:** <!-- prod/ local -->
+
+
+## Evidências
+<!-- Prints, vídeos, payloads, logs, stack traces ou qualquer material que ajude. -->
+
+
+##  Sugestão de correção (opcional)
+<!-- Se tiver contexto técnico, sugira melhorias. Caso contrário, deixe em branco
+     para a comunidade interagir livremente. -->
+
+
+##  Contexto adicional
+<!-- Qualquer outra informação relevante sobre o problema. -->
diff --git a/.github/ISSUE_TEMPLATE/feature_request.md b/.github/ISSUE_TEMPLATE/feature_request.md
new file mode 100644
index 00000000..6af5a632
--- /dev/null
+++ b/.github/ISSUE_TEMPLATE/feature_request.md
@@ -0,0 +1,55 @@
+---
+name: Feature request
+about: Descreve uma feature a ser construída, com critérios de aceite e testes
+title: ''
+labels: type:feat
+assignees: ''
+type: Feature
+
+---
+
+##  Parent
+<!-- Issue/épico ao qual esta feature pertence. Ex: #342. Caso não tenha deixa em branco -->
+#
+
+
+##  O que construir
+<!-- O que precisa ser implementado, de forma objetiva. Cite Actions, papéis, transações
+     e o comportamento esperado. Uma linha de contexto + os pontos técnicos. -->
+-
+-
+-
+
+
+##  Critérios de aceite
+<!-- Condições verificáveis para considerar a feature pronta. Cada item deve ser testável. -->
+- [ ]
+- [ ]
+- [ ]
+
+
+##  Teste
+
+### BDD
+<!-- Cenários em Gherkin (pt). Cubra o caso feliz e as regras/invariantes importantes. -->
+```gherkin
+
+Funcionalidade: <nome da funcionalidade>
+
+  Cenário: <cenário principal>
+    Dado <pré-condição>
+    E <pré-condição>
+    Quando <ação>
+    Então <resultado esperado>
+    E <resultado esperado>
+
+  Cenário: <cenário de regra/invariante>
+    Dado <pré-condição>
+    Então <garantia>
+```
+
+
+##  Bloqueada por
+<!-- Issues que precisam ser concluídas antes desta. Deixe em branco se não houver. -->
+- [ ] <feat(...): descrição> #
+- [ ] <feat(...): descrição> #
diff --git "a/.github/ISSUE_TEMPLATE/prd---m\303\263dulo-de-dom\303\255nio.md" "b/.github/ISSUE_TEMPLATE/prd---m\303\263dulo-de-dom\303\255nio.md"
new file mode 100644
index 00000000..dbf733cc
--- /dev/null
+++ "b/.github/ISSUE_TEMPLATE/prd---m\303\263dulo-de-dom\303\255nio.md"
@@ -0,0 +1,103 @@
+---
+name: PRD / Módulo de Domínio
+about: Documento de requisitos para uma nova feature ou módulo de domínio
+title: ''
+labels: prd
+assignees: ''
+
+---
+
+# <Nome do Módulo / Feature>
+
+> Uma linha resumindo o que este documento entrega.
+
+---
+
+## Descrição do problema
+<!-- Descreva o estado atual e a dor. Como as coisas funcionam hoje (informalmente, manualmente)?
+     O que está faltando? Que pergunta o sistema não consegue responder? Seja concreto sobre
+     o gap, não sobre a solução ainda. -->
+
+
+## Solução
+<!-- O que este módulo/feature passa a ser (a "fonte da verdade" para o quê?).
+     Deixe claro o limite de escopo: o que ele conduz ativamente vs. o que apenas registra.
+     Se decisões são tomadas fora do sistema, diga que o módulo grava o resultado. -->
+
+
+## User Stories
+<!-- Formato: "Como <papel>, quero <ação>, para que <benefício>."
+     Agrupe por ator quando fizer sentido. Cubra os casos felizes e os bloqueios/gates. -->
+
+- Como **<papel>**, quero **<ação>**, para que **<benefício>**.
+- Como **<papel>**, quero **<ação>**, para que **<benefício>**.
+- Como **<plataforma>**, quero **<invariante/regra técnica>**, para que **<garantia>**.
+
+
+## Decisões de implementação
+<!-- As escolhas técnicas já fechadas. Referencie ADRs quando existirem. -->
+
+### Módulo / Namespace
+<!-- Onde vive o código? Namespace, ServiceProvider, escopo (ex: tenant-scoped). -->
+
+### Autoridade & Autorização
+<!-- Quem pode fazer o quê? Papéis, políticas (Policy), overrides. -->
+
+### Modelo de dados
+<!-- Liste tabelas, colunas relevantes, constraints (UNIQUE, partial unique, índices),
+     chaves (UUID?), e o que é derivado vs. denormalizado. -->
+
+| Tabela | Colunas-chave | Constraints / Índices | Observações |
+|--------|---------------|-----------------------|-------------|
+| `<tabela>` | `<colunas>` | `<unique / index>` | `<notas>` |
+
+### Enums
+<!-- Enumerações e seus valores possíveis. -->
+
+### Gates / Pré-condições
+<!-- Que estado precisa ser verdadeiro para uma ação acontecer? De onde o módulo lê isso? -->
+
+### Actions
+<!-- Os casos de uso públicos (verbos do domínio). Ex: CreateX, ApplyToY, DecideZ. -->
+
+### Invariantes
+<!-- Regras que sempre precisam valer (ex: "no máximo 1 ativo"). Onde são garantidas?
+     Defense-in-depth: banco + camada de aplicação. -->
+
+
+## Decisões de teste
+<!-- O que será testado e por qual superfície (Actions/Policy públicas, estado persistido,
+     eventos emitidos — não helpers privados). Liste os cenários confirmados em escopo. -->
+
+- **<Grupo de invariantes>:** <o que asserir>
+- **<Política/Autorização>:** <o que asserir>
+- **<Fluxo principal>:** <casos felizes e de bloqueio>
+
+**Prior art / referências:** <testes ou padrões existentes a seguir>
+
+
+## Fora de escopo
+<!-- O que explicitamente NÃO faz parte desta entrega. Evita scope creep e alinha expectativas. -->
+
+- <item> — <por quê / onde é tratado>
+- <item> — <por quê / onde é tratado>
+
+
+## 📝 Notas adicionais
+<!-- Decisões sutis, follow-ups de doc (não bloqueantes), caminho de evolução futura,
+     perguntas em aberto que não travam a implementação. -->
+
+- **Follow-up:** <pendência de documentação ou revisão>
+- **Evolução:** <como isso pode crescer sem retrabalho>
+
+
+## Subtarefas
+<!-- Quebra em tracer bullets, em ordem de dependência. Vincule as tasks criadas no git aqui. -->
+
+---
+
+### 🔗 Referências
+<!-- ADRs, PRDs relacionados, issues, docs de arquitetura. -->
+
+- ADR-XXXX — <título>
+- <link / issue relacionada>

From c094225dd6621de387290f8d8f3474969c0d0784 Mon Sep 17 00:00:00 2001
From: Sther <72408918+stherzada@users.noreply.github.com>
Date: Mon, 3 Aug 2026 19:52:45 -0300
Subject: [PATCH 2/3] chore: lint docs

---
 .github/ISSUE_TEMPLATE/feature_request.md | 9 +++++----
 1 file changed, 5 insertions(+), 4 deletions(-)

diff --git a/.github/ISSUE_TEMPLATE/feature_request.md b/.github/ISSUE_TEMPLATE/feature_request.md
index 6af5a632..ae496303 100644
--- a/.github/ISSUE_TEMPLATE/feature_request.md
+++ b/.github/ISSUE_TEMPLATE/feature_request.md
@@ -1,6 +1,6 @@
 ---
 name: Feature request
-about: Descreve uma feature a ser construída, com critérios de aceite e testes
+about: Descreva uma feature a ser construída, com critérios de aceite e testes
 title: ''
 labels: type:feat
 assignees: ''
@@ -8,12 +8,12 @@ type: Feature
 
 ---
 
-##  Parent
+## Parent
 <!-- Issue/épico ao qual esta feature pertence. Ex: #342. Caso não tenha deixa em branco -->
 #
 
 
-##  O que construir
+## O que construir
 <!-- O que precisa ser implementado, de forma objetiva. Cite Actions, papéis, transações
      e o comportamento esperado. Uma linha de contexto + os pontos técnicos. -->
 -
@@ -21,7 +21,7 @@ type: Feature
 -
 
 
-##  Critérios de aceite
+## Critérios de aceite
 <!-- Condições verificáveis para considerar a feature pronta. Cada item deve ser testável. -->
 - [ ]
 - [ ]
@@ -33,6 +33,7 @@ type: Feature
 ### BDD
 <!-- Cenários em Gherkin (pt). Cubra o caso feliz e as regras/invariantes importantes. -->
 ```gherkin
+# language: pt
 
 Funcionalidade: <nome da funcionalidade>
 

From b02815ea5add59c2a5a015f14ebb69ed7e33abea Mon Sep 17 00:00:00 2001
From: Sther <72408918+stherzada@users.noreply.github.com>
Date: Mon, 3 Aug 2026 20:07:08 -0300
Subject: [PATCH 3/3] chore: remove hash and edit portuguese sentence

---
 .github/ISSUE_TEMPLATE/feature_request.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/.github/ISSUE_TEMPLATE/feature_request.md b/.github/ISSUE_TEMPLATE/feature_request.md
index ae496303..9ec38b66 100644
--- a/.github/ISSUE_TEMPLATE/feature_request.md
+++ b/.github/ISSUE_TEMPLATE/feature_request.md
@@ -9,8 +9,8 @@ type: Feature
 ---
 
 ## Parent
-<!-- Issue/épico ao qual esta feature pertence. Ex: #342. Caso não tenha deixa em branco -->
-#
+<!-- Issue/épico ao qual esta feature pertence. Ex: #342. Caso não tenha, deixe em branco -->
+
 
 
 ## O que construir