From 5f11352ab7b789d86037ad91030aa4f2b92b3441 Mon Sep 17 00:00:00 2001 From: Luiz Silva Date: Wed, 12 Aug 2026 15:26:26 -0300 Subject: [PATCH] =?UTF-8?q?agente=20documenta=C3=A7=C3=A3o?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- DOCUMENTACAO/INDICE | 60 ++++++++++----- DOCUMENTACAO/README | 73 ++++++++++++++----- .../{arquitetura => _templates}/_template-adr | 7 +- .../_template-contrato | 11 ++- .../_templates/_template-especificacao | 52 +++++++++++++ .../{fluxos => _templates}/_template-fluxo | 22 +++--- .../_templates/_template-regras-negocio | 43 +++++++++++ DOCUMENTACAO/modulos/_template-modulo | 36 --------- DOCUMENTACAO/regras-negocio/_template-regra | 34 --------- manifesto.json | 49 ++++++------- rules/ddd-documentacao-primeiro.md | 10 +-- 11 files changed, 239 insertions(+), 158 deletions(-) rename DOCUMENTACAO/{arquitetura => _templates}/_template-adr (84%) rename DOCUMENTACAO/{contratos => _templates}/_template-contrato (74%) create mode 100644 DOCUMENTACAO/_templates/_template-especificacao rename DOCUMENTACAO/{fluxos => _templates}/_template-fluxo (53%) create mode 100644 DOCUMENTACAO/_templates/_template-regras-negocio delete mode 100644 DOCUMENTACAO/modulos/_template-modulo delete mode 100644 DOCUMENTACAO/regras-negocio/_template-regra diff --git a/DOCUMENTACAO/INDICE b/DOCUMENTACAO/INDICE index 0604ea1..66375e4 100644 --- a/DOCUMENTACAO/INDICE +++ b/DOCUMENTACAO/INDICE @@ -1,40 +1,64 @@ --- type: structural name: INDICE -description: Índice central navegável de todas as categorias de documentação +description: Índice central navegável da documentação organizada por funcionalidade updatedAt: "2026-08-12" --- -# Índice de Documentação +# Índice de Documentação — Qualifica -Este documento serve como ponto central de navegação para todas as documentações do ecossistema. Os documentos serão listados aqui conforme forem criados. +Este documento serve como ponto central de navegação para toda a documentação do módulo Qualifica. A documentação é organizada por **funcionalidade**, onde cada pasta agrupa especificação técnica, regras de negócio, contratos e fluxos. -## Arquitetura -Decisões técnicas e arquiteturais (ADRs) que impactam o sistema. -**Template**: `DOCUMENTACAO/arquitetura/_template-adr` +**Templates**: `DOCUMENTACAO/_templates/` +**Funcionalidades**: `DOCUMENTACAO/funcionalidades/` + +--- + +## Avaliações +Ciclos de avaliação, envios, análise e preenchimento — funcionalidade core do sistema. + +- `funcionalidades/avaliacoes/especificacao.md` — Spec técnica (schemas Zod, DDL, fluxos) +- `funcionalidades/avaliacoes/regras-negocio.md` — Ciclos, prazos, envios e reenvios + +## Empresas +Cadastro de empresas, painel da empresa, empreendedores, empreendimentos e contatos. - *(Nenhum documento criado ainda)* -## Módulos -Documentação do domínio, glossário e entidades de cada módulo do sistema. -**Template**: `DOCUMENTACAO/modulos/_template-modulo` +## Formulários +Builder de formulários, seções, campos e respostas. - *(Nenhum documento criado ainda)* -## Regras de Negócio -Regras operacionais e de negócio extraídas do código ou definidas pelos operadores. -**Template**: `DOCUMENTACAO/regras-negocio/_template-regra` +## Contratos Comerciais +Gestão de contratos comerciais. - *(Nenhum documento criado ainda)* -## Contratos -Definição de contratos de API, schemas de dados e especificações de endpoints. -**Template**: `DOCUMENTACAO/contratos/_template-contrato` +## Relatórios +Relatórios em PDF, histórico, documentos e eventos. - *(Nenhum documento criado ainda)* -## Fluxos -Mapeamento de jornadas do usuário, interações de interface e fluxos de uso do sistema. -**Template**: `DOCUMENTACAO/fluxos/_template-fluxo` +## Importador +Importação de dados externos. + +- *(Nenhum documento criado ainda)* + +## Ajuda e Suporte +Sistema de chamados, diagnóstico de ambiente e suporte contextual. + +- `funcionalidades/ajuda-suporte/especificacao.md` — Arquitetura, componentes, fluxos e UX + +## Validade +Controle de validade. + +- *(Nenhum documento criado ainda)* + +--- + +## Transversais +Decisões arquiteturais (ADRs) e documentação que cruza funcionalidades. +**Template ADR**: `_templates/_template-adr` - *(Nenhum documento criado ainda)* diff --git a/DOCUMENTACAO/README b/DOCUMENTACAO/README index 26618e0..a0ea024 100644 --- a/DOCUMENTACAO/README +++ b/DOCUMENTACAO/README @@ -8,33 +8,72 @@ updatedAt: "2026-08-12" # Documentation-Driven Development (DDD) ## Manifesto -No ecossistema Azteca, a documentação precede o código. Nenhum artefato (regra, skill, workflow, módulo, API, decisão técnica) deve ser implementado sem documentação prévia. A documentação é a especificação viva. +No ecossistema Azteca, a documentação precede o código. Nenhum artefato (regra, skill, workflow, funcionalidade, API, decisão técnica) deve ser implementado sem documentação prévia. A documentação é a especificação viva. ## Princípios 1. **Doc First** — Nenhum artefato novo sem documentação prévia. 2. **Doc como Contrato** — A documentação é a especificação; o código a implementa. 3. **Código Satisfaz Doc** — Se o código diverge da doc, o código está errado. 4. **Sincronia Obrigatória** — Mudança no código → atualização da doc; mudança na doc → atualização no código. -5. **Templates Padronizados** — Cada categoria tem seu template; nenhuma documentação é criada do zero. -6. **Leitura Antes de Escrita** — Antes de documentar, leia o que já existe. +5. **Templates Padronizados** — Cada tipo de documento tem seu template centralizado em `_templates/`. +6. **Co-localização** — Toda documentação de uma funcionalidade fica na pasta daquela funcionalidade. +7. **Leitura Antes de Escrita** — Antes de documentar, leia o que já existe. -## Categorias de Documentação +## Organização — Por Funcionalidade -| Categoria | Diretório | O que documenta | Template | -| :--- | :--- | :--- | :--- | -| Arquitetura | `DOCUMENTACAO/arquitetura/` | Decisões técnicas e arquiteturais (ADRs) | `_template-adr` | -| Módulos | `DOCUMENTACAO/modulos/` | Domínio, glossário e entidades de cada módulo | `_template-modulo` | -| Regras de Negócio | `DOCUMENTACAO/regras-negocio/` | Regras extraídas do código ou definidas pelo operador | `_template-regra` | -| Contratos | `DOCUMENTACAO/contratos/` | Contratos de API, schemas, endpoints | `_template-contrato` | -| Fluxos | `DOCUMENTACAO/fluxos/` | Jornadas do usuário e fluxos de uso | `_template-fluxo` | +A `DOCUMENTACAO/` é organizada por **funcionalidade/domínio funcional** do módulo Qualifica, não por tipo de documento. + +### Estrutura + +```text +DOCUMENTACAO/ +├── README.md ← Índice geral (público) +├── funcionalidades/ ← Subdivisão por funcionalidade +│ └── / ← Uma pasta por funcionalidade +│ ├── especificacao.md ← Spec técnica (schemas, DDL, componentes) +│ ├── regras-negocio.md ← Regras de negócio em linguagem natural +│ ├── contratos.md ← Endpoints de API (quando aplicável) +│ └── fluxo.md ← Fluxograma detalhado (quando aplicável) +├── _transversais/ ← ADRs e decisões que cruzam funcionalidades +│ └── adr-NNN-titulo.md +└── _templates/ ← Templates (espelhados de .agent/DOCUMENTACAO/_templates/) +``` + +### Funcionalidades do Qualifica + +| Funcionalidade | Pasta | Domínio | +| :--- | :--- | :--- | +| Avaliações | `funcionalidades/avaliacoes/` | Ciclos de avaliação, envios, análise, preenchimento | +| Empresas | `funcionalidades/empresas/` | Cadastro, painel, empreendedores, contatos | +| Formulários | `funcionalidades/formularios/` | Builder, seções, campos, respostas | +| Contratos Comerciais | `funcionalidades/contratos-comerciais/` | Gestão de contratos | +| Relatórios | `funcionalidades/relatorios/` | PDFs, histórico, documentos, eventos | +| Importador | `funcionalidades/importador/` | Importação de dados | +| Ajuda e Suporte | `funcionalidades/ajuda-suporte/` | Chamados, diagnóstico, suporte contextual | +| Validade | `funcionalidades/validade/` | Controle de validade | + +### Tipos de Documento (dentro de cada funcionalidade) + +| Arquivo | Template | Quando criar | +| :--- | :--- | :--- | +| `especificacao.md` | `_templates/_template-especificacao` | Sempre — é o doc mínimo de cada funcionalidade | +| `regras-negocio.md` | `_templates/_template-regras-negocio` | Quando a funcionalidade tem lógica de decisão não-trivial | +| `contratos.md` | `_templates/_template-contrato` | Quando a funcionalidade expõe endpoints de API | +| `fluxo.md` | `_templates/_template-fluxo` | Quando a funcionalidade tem ciclo de vida complexo | + +### Documentação Transversal + +Decisões arquiteturais (ADRs) e documentação que cruza múltiplas funcionalidades ficam em `_transversais/`, usando o template `_templates/_template-adr`. ## Workflow DDD 1. **Receber demanda** -2. **Documentar** (criar/atualizar documentação na categoria apropriada usando o template) -3. **Revisar** (apresentar a documentação ao operador para validação) -4. **Implementar** (codificar de acordo com a documentação aprovada) -5. **Validar** (verificar se o código satisfaz a doc 100%) -6. **Sincronizar** (atualizar a documentação se a implementação revelou ajustes necessários) +2. **Identificar funcionalidade** — Determinar a qual funcionalidade a demanda pertence +3. **Consultar template** — Usar o template adequado de `_templates/` +4. **Documentar** — Criar/atualizar documentação na pasta da funcionalidade +5. **Revisar** — Apresentar a documentação ao operador para validação +6. **Implementar** — Codificar de acordo com a documentação aprovada +7. **Validar** — Verificar se o código satisfaz a doc 100% +8. **Sincronizar** — Atualizar a documentação se a implementação revelou ajustes ## Integração com o Ecossistema @@ -42,7 +81,7 @@ No ecossistema Azteca, a documentação precede o código. Nenhum artefato (regr | :--- | :--- | | `rules/regras-negocio-md.md` | Define formato e obrigatoriedade de documentar regras de negócio | | `skills/documentar-decisao-tecnica` | Fornece habilidade para criar e atualizar ADRs | -| `skills/documentar-dominio-modulo` | Estrutura para levantar glossário e domínio de módulos | +| `skills/documentar-dominio-modulo` | Estrutura para levantar glossário e domínio | | `skills/documentar-regras-negocio` | Habilidade para extrair e redigir regras | | `rules/diagnostico-antes-correcao.md`| Diagnóstico exige leitura e alinhamento com doc antes de corrigir bugs | diff --git a/DOCUMENTACAO/arquitetura/_template-adr b/DOCUMENTACAO/_templates/_template-adr similarity index 84% rename from DOCUMENTACAO/arquitetura/_template-adr rename to DOCUMENTACAO/_templates/_template-adr index 787437b..314a616 100644 --- a/DOCUMENTACAO/arquitetura/_template-adr +++ b/DOCUMENTACAO/_templates/_template-adr @@ -1,7 +1,7 @@ --- type: template name: _template-adr -description: Template para Architecture Decision Records (ADRs) +description: Template para Architecture Decision Records (ADRs) — decisões transversais updatedAt: "2026-08-12" --- @@ -31,18 +31,15 @@ updatedAt: "2026-08-12" ### Positivas - -- [...] ### Negativas - -- [...] ### Neutras - -- [...] ## Impacto no Monorepo - + ## Referências diff --git a/DOCUMENTACAO/contratos/_template-contrato b/DOCUMENTACAO/_templates/_template-contrato similarity index 74% rename from DOCUMENTACAO/contratos/_template-contrato rename to DOCUMENTACAO/_templates/_template-contrato index 0839805..14eb7ed 100644 --- a/DOCUMENTACAO/contratos/_template-contrato +++ b/DOCUMENTACAO/_templates/_template-contrato @@ -1,14 +1,14 @@ --- type: template name: _template-contrato -description: Template para definição de contratos de API e schemas +description: Template para definição de contratos de API e schemas de uma funcionalidade updatedAt: "2026-08-12" --- -# Contrato: +# Contrato de API — ## Serviço - + ## Base URL `` @@ -54,17 +54,16 @@ updatedAt: "2026-08-12" --- ## Schema Zod de Referência - ```typescript // z.object({ ... }) ``` ## Exemplos de Uso - ```bash curl -X GET ... ``` ## Referências - +- Especificação: `especificacao.md` (co-localizado) +- Regras de negócio: `regras-negocio.md` (co-localizado) - [...] diff --git a/DOCUMENTACAO/_templates/_template-especificacao b/DOCUMENTACAO/_templates/_template-especificacao new file mode 100644 index 0000000..85b873f --- /dev/null +++ b/DOCUMENTACAO/_templates/_template-especificacao @@ -0,0 +1,52 @@ +--- +type: template +name: _template-especificacao +description: Template para especificação técnica de uma funcionalidade do módulo +updatedAt: "2026-08-12" +--- + +# Especificação: + +## Área de Conhecimento + + +## Glossário + +| Termo | Definição | Contexto de Uso | +| :--- | :--- | :--- | +| `` | `` | `` | + +## Entidades Principais + +- **Entidade A**: . + +## Schemas Zod + +- `_entidade.ts` — + +## Estrutura de Dados (DDL) + +```sql +-- DDL da tabela principal +``` + +## Componentes de Interface + +- `PaginaX/` — +- `ComponenteY.vue` — + +## Fluxos do Domínio + +- **Fluxo Principal**: [...] + +## Legislação Aplicável + +- [...] + +## Vocabulário de Interface + +- [...] + +## Referências +- Regras de negócio: `regras-negocio.md` (co-localizado) +- [...] diff --git a/DOCUMENTACAO/fluxos/_template-fluxo b/DOCUMENTACAO/_templates/_template-fluxo similarity index 53% rename from DOCUMENTACAO/fluxos/_template-fluxo rename to DOCUMENTACAO/_templates/_template-fluxo index 40e6476..f56dfc9 100644 --- a/DOCUMENTACAO/fluxos/_template-fluxo +++ b/DOCUMENTACAO/_templates/_template-fluxo @@ -1,7 +1,7 @@ --- type: template name: _template-fluxo -description: Template para mapeamento de jornadas do usuário e fluxos de uso +description: Template para mapeamento de jornadas do usuário e fluxos de uso de uma funcionalidade updatedAt: "2026-08-12" --- @@ -11,38 +11,38 @@ updatedAt: "2026-08-12" ## Ator(es) - + - [...] ## Pré-condições - + - [...] ## Fluxo Principal - + 1. [...] 2. [...] 3. [...] ## Fluxos Alternativos - + - **Alternativa A** (Ocorre no passo X se a condição Y for verdadeira): 1. [...] 2. [...] (retorna ao passo Z do fluxo principal) ## Tratamento de Erros -- **Erro 1** (Falha no passo X): Ação de mitigação e mensagem de erro apresentada. +- **Erro 1** (Falha no passo X): Ação de mitigação e mensagem apresentada. ## Regras de Negócio Aplicáveis - -- `Regra X`: [...] -- `Regra Y`: [...] + +- Regra X: [...] ## Telas Envolvidas - + - [...] ## Referências - +- Especificação: `especificacao.md` (co-localizado) +- Regras de negócio: `regras-negocio.md` (co-localizado) - [...] diff --git a/DOCUMENTACAO/_templates/_template-regras-negocio b/DOCUMENTACAO/_templates/_template-regras-negocio new file mode 100644 index 0000000..0820d52 --- /dev/null +++ b/DOCUMENTACAO/_templates/_template-regras-negocio @@ -0,0 +1,43 @@ +--- +type: template +name: _template-regras-negocio +description: Template para especificação de regras de negócio de uma funcionalidade +updatedAt: "2026-08-12" +--- + +# Regras de Negócio — + +Funcionalidade: `` +Localização: `DOCUMENTACAO//` + +--- + +## Contexto + + +## Critérios de Entrada / Identificação + +- Condição 1: [...] +- Condição 2: [...] + +## Regras de Processamento + +1. [...] +2. [...] +3. [...] + +## Casos de Revisão Manual + +- Cenário A: [...] + +## Estratégia de Fusão / Resultado + +- [...] + +## Dependências Externas + +- [...] + +## Referências +- Especificação: `especificacao.md` (co-localizado) +- [...] diff --git a/DOCUMENTACAO/modulos/_template-modulo b/DOCUMENTACAO/modulos/_template-modulo deleted file mode 100644 index 1bdb6b5..0000000 --- a/DOCUMENTACAO/modulos/_template-modulo +++ /dev/null @@ -1,36 +0,0 @@ ---- -type: template -name: _template-modulo -description: Template para documentação de módulos e domínios -updatedAt: "2026-08-12" ---- - -# Módulo: - -## Área de Conhecimento - - -## Glossário do Módulo - -| Termo | Definição | Contexto de Uso | -| :--- | :--- | :--- | -| `` | `` | `` | -| `` | `` | `` | - -## Entidades Principais - -- **Entidade A**: . -- **Entidade B**: . - -## Legislação Aplicável - -- [...] - -## Fluxos do Domínio - -- **Fluxo Principal X**: [...] -- **Fluxo Principal Y**: [...] - -## Vocabulário de Interface - -- [...] diff --git a/DOCUMENTACAO/regras-negocio/_template-regra b/DOCUMENTACAO/regras-negocio/_template-regra deleted file mode 100644 index 3305c76..0000000 --- a/DOCUMENTACAO/regras-negocio/_template-regra +++ /dev/null @@ -1,34 +0,0 @@ ---- -type: template -name: _template-regra -description: Template para especificação de regras de negócio -updatedAt: "2026-08-12" ---- - -# Regra: - -## Contexto - - -## Critérios de Entrada / Identificação - -- Condição 1: [...] -- Condição 2: [...] - -## Regras de Processamento - -1. [...] -2. [...] -3. [...] - -## Casos de Revisão Manual - -- Cenário A: [...] - -## Estratégia de Fusão / Resultado - -- [...] - -## Dependências Externas - -- [...] diff --git a/manifesto.json b/manifesto.json index a839ee8..b80f940 100644 --- a/manifesto.json +++ b/manifesto.json @@ -50,32 +50,29 @@ "diretorio": "DOCUMENTACAO", "manifesto": "DOCUMENTACAO/README", "indice": "DOCUMENTACAO/INDICE", - "categorias": { - "arquitetura": { - "diretorio": "DOCUMENTACAO/arquitetura", - "template": "DOCUMENTACAO/arquitetura/_template-adr", - "descricao": "Decisões técnicas e arquiteturais (ADRs)" - }, - "modulos": { - "diretorio": "DOCUMENTACAO/modulos", - "template": "DOCUMENTACAO/modulos/_template-modulo", - "descricao": "Domínio, glossário e entidades de cada módulo" - }, - "regras-negocio": { - "diretorio": "DOCUMENTACAO/regras-negocio", - "template": "DOCUMENTACAO/regras-negocio/_template-regra", - "descricao": "Regras de negócio extraídas do código ou declaradas pelo operador" - }, - "contratos": { - "diretorio": "DOCUMENTACAO/contratos", - "template": "DOCUMENTACAO/contratos/_template-contrato", - "descricao": "Contratos de API, schemas e endpoints" - }, - "fluxos": { - "diretorio": "DOCUMENTACAO/fluxos", - "template": "DOCUMENTACAO/fluxos/_template-fluxo", - "descricao": "Jornadas do usuário e fluxos de uso" - } + "organizacao": "por-funcionalidade", + "templates": { + "diretorio": "DOCUMENTACAO/_templates", + "especificacao": "DOCUMENTACAO/_templates/_template-especificacao", + "regras-negocio": "DOCUMENTACAO/_templates/_template-regras-negocio", + "contrato": "DOCUMENTACAO/_templates/_template-contrato", + "fluxo": "DOCUMENTACAO/_templates/_template-fluxo", + "adr": "DOCUMENTACAO/_templates/_template-adr" + }, + "diretorioFuncionalidades": "DOCUMENTACAO/funcionalidades", + "funcionalidades": [ + "avaliacoes", + "empresas", + "formularios", + "contratos-comerciais", + "relatorios", + "importador", + "ajuda-suporte", + "validade" + ], + "transversais": { + "diretorio": "DOCUMENTACAO/_transversais", + "descricao": "Decisões arquiteturais e documentação que cruzam funcionalidades" } }, "agents": { diff --git a/rules/ddd-documentacao-primeiro.md b/rules/ddd-documentacao-primeiro.md index c078938..af228f2 100644 --- a/rules/ddd-documentacao-primeiro.md +++ b/rules/ddd-documentacao-primeiro.md @@ -14,14 +14,14 @@ updatedAt: "2026-08-12" Implementar sem documentar leva ao acúmulo de conhecimento implícito, código inconsistente e perda do conhecimento institucional. Para garantir que as decisões de design, regras de negócio e fluxos estejam claros antes de qualquer código ser escrito, adotamos o Documentation-Driven Development (DDD). A documentação atua como o contrato formal do que será construído. ## Regra -Antes de implementar qualquer novo artefato (regra, skill, workflow, módulo, endpoint de API, decisão técnica) ou realizar alterações substanciais em artefatos existentes, o agente **DEVE OBRIGATORIAMENTE** criar ou atualizar a documentação na pasta `DOCUMENTACAO/` utilizando o template apropriado da respectiva categoria. +Antes de implementar qualquer novo artefato (regra, skill, workflow, funcionalidade, endpoint de API, decisão técnica) ou realizar alterações substanciais em artefatos existentes, o agente **DEVE OBRIGATORIAMENTE** criar ou atualizar a documentação na pasta `DOCUMENTACAO/funcionalidades//` utilizando o template apropriado de `DOCUMENTACAO/_templates/`. ## Protocolo DDD Para toda nova demanda ou funcionalidade, siga rigorosamente os passos abaixo: -1. **Identificar Categoria**: Analisar a demanda e determinar em qual(is) categoria(s) de documentação ela se encaixa (arquitetura, módulos, regras-negócio, contratos, fluxos). -2. **Consultar Template**: Consultar o respectivo template em `DOCUMENTACAO//_template-*`. +1. **Identificar Funcionalidade**: Analisar a demanda e determinar a qual funcionalidade ela pertence (avaliacoes, empresas, formularios, contratos-comerciais, relatorios, importador, ajuda-suporte, validade). Para decisões transversais, usar `DOCUMENTACAO/_transversais/`. +2. **Consultar Template**: Consultar o respectivo template em `DOCUMENTACAO/_templates/_template-*`. 3. **Criar/Atualizar Documentação**: Redigir a documentação na categoria adequada usando a estrutura do template. Se a funcionalidade altera algo existente, a documentação prévia deve ser atualizada. 4. **Apresentar ao Operador**: Validar a documentação redigida com o operador (usuário humano) antes de iniciar qualquer código. 5. **Implementar**: Escrever o código de forma que ele satisfaça e implemente *exatamente* o que foi estabelecido na documentação aprovada. @@ -38,10 +38,10 @@ Esta regra pode ser ignorada apenas para alterações triviais que não impactam ## Exemplos ✅ **Correto**: -- O operador pede um novo endpoint. O agente cria `DOCUMENTACAO/contratos/novo-endpoint` detalhando a API e os schemas usando o template. Após aprovação, cria o código na API. +- O operador pede um novo endpoint de avaliações. O agente cria/atualiza `DOCUMENTACAO/funcionalidades/avaliacoes/contratos.md` detalhando a API usando o template `_templates/_template-contrato`. Após aprovação, cria o código na API. ❌ **Incorreto**: -- O operador pede uma nova regra de negócio complexa e o agente já cria a função ou arquivo `.ts` sem antes registrar a regra em `DOCUMENTACAO/regras-negocio/` para validação. +- O operador pede uma nova regra de negócio complexa para empresas e o agente já cria a função ou arquivo `.ts` sem antes registrar a regra em `DOCUMENTACAO/funcionalidades/empresas/regras-negocio.md` para validação. - O agente toma uma decisão técnica grande (ex: trocar a biblioteca de state management) e apenas implementa no código sem gerar um ADR. ## Impacto