From 309c51b6202522a466366610009cd2191f5d342a Mon Sep 17 00:00:00 2001
From: Rafael Lopes <rafael.lopes@sothis.com.br>
Date: Wed, 27 May 2026 16:26:02 -0300
Subject: [PATCH] =?UTF-8?q?DOC:=20Atualizado=20setup=20do=20deploy=20e=20e?=
 =?UTF-8?q?strutura=20do=20reposit=C3=B3rio?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .gitignore     |  6 +++++-
 README.md      | 36 ++++++++++++++++++++++++++++++++++++
 backend        |  1 -
 deploy-dev.bat |  1 -
 frontend       |  1 -
 5 files changed, 41 insertions(+), 4 deletions(-)
 delete mode 160000 backend
 delete mode 100644 deploy-dev.bat
 delete mode 160000 frontend

diff --git a/.gitignore b/.gitignore
index bc13c1b..3b1a470 100644
--- a/.gitignore
+++ b/.gitignore
@@ -4,6 +4,10 @@ dist
 *.log
 .DS_Store
 
+# Repos clonados separadamente dentro do deploy
+/backend/
+/frontend/
+
 # Backend Specific Ignore
 backend/node_modules
 backend/dist
@@ -14,4 +18,4 @@ backend/test-api-out.json
 
 # Frontend Specific Ignore
 frontend/node_modules
-frontend/dist
\ No newline at end of file
+frontend/dist
diff --git a/README.md b/README.md
index bf52214..0185c5e 100644
--- a/README.md
+++ b/README.md
@@ -4,6 +4,29 @@ Plataforma omnichannel para atendimento com foco inicial em WhatsApp. O sistema
 
 O projeto foi construído para validar e evoluir um MVP de atendimento corporativo, com perfis de agente, supervisor e administrador.
 
+## Clonando o Projeto
+
+Este repositório funciona como o repositório de deploy/orquestração. O backend e o frontend ficam em repositórios separados e devem ser clonados dentro das pastas esperadas pelo `docker-compose.yml`.
+
+Em uma pasta vazia:
+
+```bash
+git clone https://chaleiradev.sothistelecom.com/Sothis/omnichannel-deploy.git .
+git clone https://chaleiradev.sothistelecom.com/Sothis/omnichannel-backend.git backend
+git clone https://chaleiradev.sothistelecom.com/Sothis/omnichannel-frontend.git frontend
+```
+
+Ao final, a estrutura deve ficar assim:
+
+```txt
+omnichannel/
+├── backend/
+├── frontend/
+├── database/
+├── docker-compose.yml
+└── README.md
+```
+
 ## Principais Recursos
 
 - Login corporativo via LDAP/Active Directory.
@@ -91,6 +114,19 @@ Health:
 curl http://localhost:4001/health
 ```
 
+## Deploy Automatizado
+
+O deploy deve seguir pelo Gitea Actions. O antigo fluxo manual via arquivo `.bat` não faz mais parte do processo recomendado.
+
+Responsabilidades esperadas da pipeline:
+
+- baixar/clonar os repositórios necessários;
+- configurar variáveis de ambiente do ambiente alvo;
+- buildar backend e frontend;
+- subir os serviços com Docker Compose;
+- executar validações pós-deploy;
+- não gerenciar o banco dentro do compose.
+
 ## Como Rodar em Desenvolvimento
 
 Backend:
diff --git a/backend b/backend
deleted file mode 160000
index 8790ce7..0000000
--- a/backend
+++ /dev/null
@@ -1 +0,0 @@
-Subproject commit 8790ce70d05d0256ded89ea8fb9335afad41bfa8
diff --git a/deploy-dev.bat b/deploy-dev.bat
deleted file mode 100644
index 2c56623..0000000
--- a/deploy-dev.bat
+++ /dev/null
@@ -1 +0,0 @@
-ssh desenvolvimento@10.0.120.75 -p 60000 "/home/desenvolvimento/scripts/deploy-omnichannel-dev.sh"
diff --git a/frontend b/frontend
deleted file mode 160000
index 7dc07c2..0000000
--- a/frontend
+++ /dev/null
@@ -1 +0,0 @@
-Subproject commit 7dc07c2a806d6352d2a84c333f09974d997918b0