From 94bbff17a78eb1dd4642e41c85e5b7ff0ccaceb6 Mon Sep 17 00:00:00 2001
From: Rafael Alves Lopes <rafael.lopes@sothis.com.br>
Date: Wed, 27 May 2026 15:15:46 -0300
Subject: [PATCH] =?UTF-8?q?Adicionar=20ADRs=20-=20Decisoes=20T=C3=A9cnicas?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 ADRs - Decisoes T%C3%A9cnicas.-.md | 118 +++++++++++++++++++++++++++++
 1 file changed, 118 insertions(+)
 create mode 100644 ADRs - Decisoes T%C3%A9cnicas.-.md

diff --git a/ADRs - Decisoes T%C3%A9cnicas.-.md b/ADRs - Decisoes T%C3%A9cnicas.-.md
new file mode 100644
index 0000000..6e6da24
--- /dev/null
+++ b/ADRs - Decisoes T%C3%A9cnicas.-.md	
@@ -0,0 +1,118 @@
+# ADRs - Decisoes Tecnicas
+
+Este arquivo registra decisoes importantes. Formato simplificado: contexto, decisao, consequencias.
+
+## ADR 001 - Usar WhatsApp Web para MVP
+
+### Contexto
+
+O produto precisava demonstrar atendimento WhatsApp rapidamente, com envio/recebimento real.
+
+### Decisao
+
+Usar `whatsapp-web.js` no backend.
+
+### Consequencias
+
+Positivas:
+
+- entrega rapida;
+- QR Code simples;
+- conversa real no WhatsApp.
+
+Negativas:
+
+- dependencia de sessao WhatsApp Web;
+- Puppeteer/Chromium no servidor;
+- risco operacional maior que API oficial;
+- nao e ideal para producao robusta.
+
+## ADR 002 - React/Vite com estilos inline
+
+### Contexto
+
+Velocidade de prototipacao e demo.
+
+### Decisao
+
+Usar React + Vite e estilos inline com variaveis globais.
+
+### Consequencias
+
+Positivas:
+
+- desenvolvimento rapido;
+- componentes autocontidos.
+
+Negativas:
+
+- arquivos grandes;
+- dificil reaproveitamento visual;
+- refatoracao futura recomendada.
+
+## ADR 003 - PostgreSQL como fonte operacional
+
+### Contexto
+
+Era necessario controlar usuarios, filas, templates, contatos e auditoria.
+
+### Decisao
+
+Usar PostgreSQL com SQL direto via `pg`.
+
+### Consequencias
+
+Positivas:
+
+- controle claro do schema;
+- queries explicitas;
+- pouca dependencia de ORM.
+
+Negativas:
+
+- precisa disciplina de migrations;
+- risco de SQL duplicado/espalhado.
+
+## ADR 004 - JWT proprio da aplicacao
+
+### Contexto
+
+LDAP e Microsoft autenticam identidades, mas o sistema precisa de perfis e areas proprios.
+
+### Decisao
+
+Emitir JWT proprio apos autenticar no provedor externo.
+
+### Consequencias
+
+Positivas:
+
+- token unico para frontend;
+- inclui perfis e areas do sistema.
+
+Negativas:
+
+- ainda falta guard backend;
+- precisa revisar armazenamento do token para producao.
+
+## ADR 005 - Migrations SQL versionadas
+
+### Contexto
+
+Schema evoluiu rapido durante MVP.
+
+### Decisao
+
+Versionar migrations SQL em `database/migrations`.
+
+### Consequencias
+
+Positivas:
+
+- historico legivel;
+- facil revisar mudancas.
+
+Negativas:
+
+- ainda falta runner formal;
+- compose nao aplica automaticamente a pasta atual.