DOC: Atualizado setup do deploy e estrutura do repositório

.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
+frontend/dist

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:

backend

@@ -1 +0,0 @@
-Subproject commit 8790ce70d05d0256ded89ea8fb9335afad41bfa8

deploy-dev.bat

@@ -1 +0,0 @@
-ssh desenvolvimento@10.0.120.75 -p 60000 "/home/desenvolvimento/scripts/deploy-omnichannel-dev.sh"

frontend

@@ -1 +0,0 @@
-Subproject commit 7dc07c2a806d6352d2a84c333f09974d997918b0