deploy-webapp 1.0.0

package/README.md

@@ -0,0 +1,338 @@
+# Deploy WebApp - Guia Passo a Passo
+
+Este projeto automatiza o processo de migração de workflows do ambiente QA para PROD no WebApp.
+
+## 📋 Índice
+
+1. [Pré-requisitos](#pré-requisitos)
+2. [Configuração](#configuração)
+3. [Estrutura de Arquivos](#estrutura-de-arquivos)
+4. [Como Executar](#como-executar)
+5. [Empacotamento](#empacotamento)
+6. [Fluxo do Processo](#fluxo-do-processo)
+7. [Sequência de Operações](#sequência-de-operações)
+8. [Troubleshooting](#troubleshooting)
+
+## 🔧 Pré-requisitos
+
+- Node.js instalado
+- Yarn ou npm instalado
+- Acesso aos ambientes QA e PROD
+- Credenciais de autenticação para ambos os ambientes
+
+## ⚙️ Configuração
+
+### 1. Instalar Dependências
+
+```bash
+yarn install
+# ou
+npm install
+```
+
+### 2. Configurar Variáveis de Ambiente
+
+Crie um arquivo `.env` na raiz do projeto com as seguintes variáveis:
+
+```env
+# Configurações Gerais
+CLIENT=seu_client_id
+SERVICE_KEY=sua_service_key
+
+# Ambiente QA
+CLIENT_ID_QA=client_id_qa
+EMAIL_LOGIN_QA=email@qa.com
+PASSWORD_LOGIN_QA=senha_qa
+URL_QA=https://url-qa.com
+
+# Ambiente PROD
+CLIENT_ID_PROD=client_id_prod
+EMAIL_LOGIN_PROD=email@prod.com
+PASSWORD_LOGIN_PROD=senha_prod
+URL_PROD=https://url-prod.com
+```
+
+### 3. Preparar Arquivos de Configuração
+
+#### `src/utils/ids.csv`
+
+Arquivo CSV com os IDs dos workflows a serem migrados. Formato:
+
+```csv
+workflow_id
+d8e1d640-f734-4051-b296-1938cbf47e86
+outro-workflow-id
+```
+
+#### `src/utils/updateWorkflow.json`
+
+Arquivo JSON com configurações de atualização do workflow. Exemplo:
+
+```json
+{
+  "flow_form_id": "id do form de produção",
+  "pendency_custom_filters": "função stringficada (se tiver)", // DICA: coloque os ids de QA e de PROD junto, feito isso nao tera problemas em deploys futuros
+  "updateWorkflowProtocolFunction": "função stringficada (se tiver)" // DICA: coloque os ids de QA e de PROD junto, feito isso nao tera problemas em deploys futuros
+}
+```
+
+## 📁 Estrutura de Arquivos
+
+```
+deployWebApp/
+├── src/
+│   ├── 0_index.ts                 # Ponto de entrada
+│   ├── 0.1_migrator.ts            # Lógica principal de migração
+│   ├── apis/
+│   │   ├── qa-client.ts          # Cliente API QA
+│   │   └── prod-client.ts        # Cliente API PROD
+│   ├── functions/
+│   │   ├── 1_workflow.ts         # Processamento de workflows
+│   │   ├── 1.1_workflow_group.ts # Processamento de grupos
+│   │   ├── 1.2_workflow_group_item.ts
+│   │   ├── 2_workflow_step.ts    # Processamento de steps
+│   │   ├── 2.1_workflow_step_forms.ts
+│   │   ├── 2.1.1_workflow_forms.ts
+│   │   ├── 3_client_function.ts
+│   │   └── 4_workflow_form_groups.ts
+│   └── utils/
+│       ├── constants.ts          # Constantes e configurações
+│       ├── data-processing.ts   # Processamento de dados
+│       ├── ids.csv              # IDs dos workflows
+│       ├── updateWorkflow.json  # Configurações de atualização
+│       ├── history_created.txt  # Histórico de criados
+│       └── history_updated.txt  # Histórico de atualizados
+└── package.json
+```
+
+## 🚀 Como Executar
+
+### Executar Migração
+
+```bash
+yarn start
+# ou
+npm start
+```
+
+O script irá:
+1. Limpar os históricos anteriores
+2. Fazer login nos ambientes QA e PROD
+3. Processar cada workflow do arquivo `ids.csv`
+4. Exibir logs de progresso
+5. Salvar histórico de operações
+
+## 🔄 Fluxo do Processo
+
+### Visão Geral
+
+O processo segue esta sequência para cada workflow:
+
+1. **Publicar Workflow em QA**
+2. **Obter Workflow de QA**
+3. **Processar Workflow** (CREATE ou UPDATE em PROD)
+4. **Processar Workflow Steps**
+5. **Processar Client Functions**
+6. **Processar Workflow Form Groups**
+7. **Publicar Workflow em PROD**
+
+### Sequência Detalhada
+
+#### 1. Workflow Principal
+
+```
+GET QA → GET PROD → CREATE/UPDATE PROD
+```
+
+- Se existe em PROD: **UPDATE**
+- Se não existe em PROD: **CREATE**
+
+#### 2. Workflow Group
+
+```
+GET QA → GET PROD → CREATE/UPDATE PROD
+```
+
+#### 3. Workflow Group Items
+
+```
+Para cada item:
+  GET QA → GET PROD → CREATE/UPDATE PROD
+```
+
+#### 4. Workflow Steps
+
+```
+Para cada step:
+  GET QA → GET PROD → CREATE/UPDATE PROD
+  
+  Para cada workflow-step-form:
+    GET QA (workflow-form) → GET PROD (workflow-form) → CREATE/UPDATE PROD (workflow-form)
+    GET QA (workflow-step-form) → GET PROD (workflow-step-form) → CREATE/UPDATE PROD (workflow-step-form)
+```
+
+#### 5. Workflow Forms
+
+**IMPORTANTE:** Sempre segue a sequência:
+
+```
+GET QA → GET PROD → CREATE/UPDATE PROD
+```
+
+A função `WorkflowForms` garante que:
+- Sempre faz GET em QA primeiro
+- Depois faz GET em PROD para verificar existência
+- Finalmente faz CREATE ou UPDATE conforme necessário
+
+#### 6. Workflow Form Groups
+
+```
+GET QA → GET PROD → CREATE/UPDATE PROD
+
+Para cada workflow-form dentro do grupo:
+  GET QA → GET PROD → CREATE/UPDATE PROD
+```
+
+## 📊 Sequência de Operações
+
+### Ordem de Execução para Cada Workflow
+
+```
+1. Login QA ✅
+2. Login PROD ✅
+3. Publish Workflow QA ✅
+4. Get Workflow QA ✅
+5. Get Workflow PROD ✅
+6. Create/Update Workflow PROD ✅
+7. Get Workflow Group QA ✅
+8. Get Workflow Group PROD ✅
+9. Create/Update Workflow Group PROD ✅
+10. Para cada Workflow Group Item:
+    - Get QA → Get PROD → Create/Update PROD ✅
+11. Para cada Workflow Step:
+    - Get QA → Get PROD → Create/Update PROD ✅
+    - Para cada Workflow Step Form:
+      - Get Workflow Form QA ✅
+      - Get Workflow Form PROD ✅
+      - Create/Update Workflow Form PROD ✅
+      - Get Workflow Step Form QA ✅
+      - Get Workflow Step Form PROD ✅
+      - Create/Update Workflow Step Form PROD ✅
+12. Process Client Function ✅
+13. Para cada Workflow Form Group:
+    - Get QA → Get PROD → Create/Update PROD ✅
+    - Para cada Workflow Form:
+      - Get QA → Get PROD → Create/Update PROD ✅
+14. Publish Workflow PROD ✅
+```
+
+## 🔍 Regras de Negócio
+
+### Sanitização de Dados
+
+O sistema sanitiza automaticamente os dados de `workflow-form`:
+
+- **placeholder**: Se vazio/null → `"   "` (3 espaços)
+- **required**: Se null/undefined → `false`
+- **index**: Se null/undefined → `1`
+- **title**: Se vazio/null → `"   "` (3 espaços)
+- **length**: Se null/undefined ou não é número → `0`
+
+### Substituição de Strings
+
+O sistema substitui automaticamente:
+
+- URLs de QA → URLs de PROD
+- Client IDs de QA → Client IDs de PROD
+- Configurações de ambiente
+- Flags de mock
+
+#### Como Adicionar Mais Strings para Mapeamento
+
+Para adicionar novas regras de substituição de strings, edite o arquivo `src/utils/constants.ts` e adicione novos objetos ao array `replacementRules`:
+
+**Exemplo prático:**
+Se você precisa substituir um ID específico ou uma URL customizada:
+
+```typescript
+// No arquivo constants.ts
+export const CUSTOM_ID_QA = "id-qa-123"; // string como esta em qa
+export const CUSTOM_ID_PROD = "id-prod-456"; // string como vai ficar em prod
+
+export const replacementRules = [
+  // ... regras existentes ...
+  { from: CUSTOM_ID_QA, to: CUSTOM_ID_PROD },
+];
+```
+
+**Importante:**
+- As substituições são feitas recursivamente em todos os objetos e arrays
+- A ordem das regras importa: as substituições são aplicadas sequencialmente
+- Use strings exatas que correspondem ao que você quer substituir
+
+### Histórico
+
+- `history_created.txt`: Registra todos os recursos criados
+- `history_updated.txt`: Registra todos os recursos atualizados
+
+## ⚠️ Troubleshooting
+
+### Erro: "WorkflowForm is not found"
+
+**Causa:** Tentativa de UPDATE sem verificar existência em PROD.
+
+**Solução:** O sistema já foi corrigido para sempre fazer GET em PROD antes de UPDATE. Se ainda ocorrer, verifique:
+- A função `WorkflowForms` está sendo chamada corretamente
+- O GET em PROD está sendo executado antes do UPDATE
+
+### Erro: "Variáveis de ambiente não definidas"
+
+**Solução:** Verifique se o arquivo `.env` existe e contém todas as variáveis necessárias.
+
+### Erro: "Workflow X not found in QA"
+
+**Causa:** O workflow não existe no ambiente QA.
+
+**Solução:** Verifique se o ID do workflow está correto no arquivo `ids.csv`.
+
+### CREATE executado após "DEPLOYMENT COMPLETED!"
+
+**Causa:** Promise não aguardada corretamente.
+
+**Solução:** Já corrigido. O sistema agora usa `await` em todas as operações assíncronas.
+
+### Erro de validação: "length must be a number"
+
+**Causa:** Campo `length` não está sendo sanitizado.
+
+**Solução:** Já corrigido. O sistema agora sanitiza o campo `length` automaticamente.
+
+## 📝 Logs
+
+O sistema exibe logs coloridos:
+
+- 🟢 **Verde**: Sucesso
+- 🔴 **Vermelho**: Erro
+- 🟡 **Amarelo**: Aviso/Info
+- 🔵 **Azul**: Informação
+
+## 🔐 Segurança
+
+- **NUNCA** commite o arquivo `.env` no repositório
+- Mantenha as credenciais seguras
+- Use variáveis de ambiente em produção
+- Revise os logs antes de executar em produção
+
+## 📞 Suporte
+
+Em caso de problemas:
+
+1. Verifique os logs de erro
+2. Confirme que todas as variáveis de ambiente estão configuradas
+3. Verifique se os arquivos de configuração estão corretos
+4. Revise o histórico de operações (`history_created.txt` e `history_updated.txt`)
+
+---
+
+**Última atualização:** 12/2025
+**Versão:** 1.0.0

package/dist/0.1_migrator.js

@@ -0,0 +1,101 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runMigration = void 0;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const console_1 = require("console");
+const constants_1 = require("./utils/constants");
+const qa_client_1 = require("./apis/qa-client");
+const prod_client_1 = require("./apis/prod-client");
+const _2_workflow_step_1 = require("./functions/2_workflow_step");
+const _3_client_function_1 = require("./functions/3_client_function");
+const _4_workflow_form_groups_1 = require("./functions/4_workflow_form_groups");
+const _1_workflow_1 = require("./functions/1_workflow");
+const logsDirectory = path.resolve(__dirname, "./utils");
+const runMigration = async () => {
+    if (!constants_1.emailLoginQA || !constants_1.passwordLoginQA || !constants_1.emailLoginPROD || !constants_1.passwordLoginPROD || !constants_1.client || !constants_1.serviceKey) {
+        throw new Error("Variáveis de ambiente WEBAPP_QA_EMAIL_LOGIN, WEBAPP_QA_PASSWORD_LOGIN, WEBAPP_PROD_EMAIL_LOGIN, WEBAPP_PROD_PASSWORD_LOGIN, CLIENT_ID e/ou SERVICE_KEY não definidas");
+    }
+    // Limpa os arquivos de histórico antes de começar
+    (0, constants_1.clearHistoryCreated)();
+    (0, constants_1.clearHistoryUpdated)();
+    (0, console_1.log)(`${constants_1.cor.Yellow}Históricos limpos. Iniciando migração...${constants_1.cor.Reset}`);
+    const access_token_qa = await (0, qa_client_1.loginQA)(constants_1.client, constants_1.serviceKey, constants_1.emailLoginQA, constants_1.passwordLoginQA);
+    const access_token_prod = await (0, prod_client_1.loginPROD)(constants_1.client, constants_1.serviceKey, constants_1.emailLoginPROD, constants_1.passwordLoginPROD);
+    const updateWorkflow = path.resolve(logsDirectory, "updateWorkflow.json");
+    const getUpdateWorkflow = fs.readFileSync(updateWorkflow, "utf8");
+    const updateWorkflowData = JSON.parse(getUpdateWorkflow);
+    const csvFilePath = path.resolve(logsDirectory, "ids.csv");
+    const csv = require("csvtojson");
+    const jsonArray = await csv({ delimiter: ";" }).fromFile(csvFilePath);
+    const arrayIds = jsonArray.map((row) => ({
+        id: row.workflow_id
+    }));
+    const execute = async (info) => {
+        var _a, _b;
+        try {
+            //////////////////////// PUBLISH WORKFLOW QA ////////////////////////
+            await (0, qa_client_1.publishWorkflowQA)(access_token_qa, info.id, constants_1.client, constants_1.serviceKey, `techforms/workflow/${info.id}`, "workflow");
+            //////////////////////// WORKFLOW ////////////////////////
+            const workflow = await (0, qa_client_1.getQA)(access_token_qa, undefined, constants_1.client, constants_1.serviceKey, `techforms/workflow/${info.id}`, "workflow", info.id);
+            const groupItems = workflow.workflow_group_item || [];
+            if (!workflow) {
+                (0, console_1.log)(`${constants_1.cor.Blue}Workflow ${info.id} not found in QA${constants_1.cor.Reset}`);
+                return;
+            }
+            await (0, _1_workflow_1.Workflow)(access_token_qa, access_token_prod, workflow, constants_1.client, constants_1.serviceKey, info.id, updateWorkflowData);
+            //////////////////////// WORKFLOW STEPS ////////////////////////
+            const workflowSteps = workflow.workflow_steps;
+            await (0, _2_workflow_step_1.WorkflowSteps)(workflowSteps, access_token_qa, access_token_prod, constants_1.client, constants_1.serviceKey, undefined, undefined, updateWorkflowData);
+            //////////////////////// CLIENT-FUNCTION ////////////////////////
+            const update_workflow_protocol_function_id = workflow.update_workflow_protocol_function_id;
+            await (0, _3_client_function_1.ClientFunction)(update_workflow_protocol_function_id, access_token_qa, access_token_prod, constants_1.client, constants_1.serviceKey, updateWorkflowData);
+            //////////////////////// WORKFLOW FORM GROUP ////////////////////////
+            const workflowFormGroupQA = workflow.workflow_form_groups;
+            await (0, _4_workflow_form_groups_1.WorkflowFormGroups)(workflowFormGroupQA, access_token_qa, access_token_prod, constants_1.client, constants_1.serviceKey, info.id, updateWorkflowData);
+            //////////////////////// PUBLISH WORKFLOW PROD ////////////////////////
+            await (0, prod_client_1.publishWorkflowPROD)(access_token_prod, info.id, constants_1.client, constants_1.serviceKey, `techforms/workflow/${info.id}`, "workflow");
+        }
+        catch (error) {
+            (0, console_1.log)(`${constants_1.cor.Red}Error to process ID ${info.id}: ${JSON.stringify((_b = (_a = error === null || error === void 0 ? void 0 : error.response) === null || _a === void 0 ? void 0 : _a.data) === null || _b === void 0 ? void 0 : _b.message)}${constants_1.cor.Reset}`);
+        }
+    };
+    for (const info of arrayIds) {
+        await execute(info);
+    }
+    (0, console_1.log)(`${constants_1.cor.Green}DEPLOYMENT COMPLETED!${constants_1.cor.Reset}`);
+};
+exports.runMigration = runMigration;

package/dist/0_index.js

@@ -0,0 +1,16 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runMigration = void 0;
+const dotenv_1 = __importDefault(require("dotenv"));
+const _0_1_migrator_1 = require("./0.1_migrator");
+Object.defineProperty(exports, "runMigration", { enumerable: true, get: function () { return _0_1_migrator_1.runMigration; } });
+if (require.main === module) {
+    dotenv_1.default.config();
+    (0, _0_1_migrator_1.runMigration)().catch(error => {
+        console.error("Migration failed:", error);
+        process.exit(1);
+    });
+}