TBG Fornecedores - Guia de Setup GCP

Bem-vindo ao Guia de Setup

O que voce vai configurar

Tempo estimado: 2-3 horas

Siga cada etapa com atencao. Ao final, voce tera o sistema completo funcionando em producao.

📋 Etapa 1: Pre-requisitos

O que voce precisa ter

Instalar Node.js

Verificar instalacao

Deve mostrar versao 20.x.x para Node e 10.x.x para npm

Instalar Google Cloud CLI

Instalar Firebase CLI

☁️ Etapa 2: Criar Projeto no Google Cloud

2.1 Acessar o Console GCP

2.2 Criar novo projeto

2.3 Configurar Billing

2.4 Configurar gcloud CLI

🔌 Etapa 3: Habilitar APIs Necessarias

O projeto TBG Fornecedores utiliza 15 APIs do Google Cloud. Execute o comando abaixo para habilitar todas de uma vez:

Linux / Mac / Git Bash:

Windows (CMD ou PowerShell) - Copie em UMA LINHA:

Verificar APIs habilitadas

👤 Etapa 4: Criar Service Account

A Service Account e como um "usuario robo" que permite que as Cloud Functions acessem outros servicos do GCP.

4.1 Criar a Service Account

Linux / Mac / Git Bash:

Windows (CMD/PowerShell) - Uma linha:

4.2 Conceder permissoes

Execute cada comando abaixo. No Windows, use os comandos da secao Windows!

Linux / Mac / Git Bash:

Windows (CMD/PowerShell) - Execute cada linha separadamente:

🗄️ Etapa 5: Configurar Firestore

O Firestore e o banco de dados NoSQL que armazena os dados dos fornecedores.

5.1 Criar o banco de dados

5.2 Estrutura de dados

O sistema usa a seguinte estrutura no Firestore:

📦 Etapa 6: Criar Buckets do Cloud Storage

O sistema utiliza 4 buckets para diferentes propositos:

6.1 Criar os buckets

6.2 Configurar CORS

Para permitir uploads do frontend, configure o CORS:

Linux / Mac / Git Bash:

Windows (PowerShell):

Windows (CMD) - Criar manualmente:

[
  {
    "origin": ["*"],
    "method": ["GET", "POST", "PUT", "DELETE", "HEAD"],
    "responseHeader": ["Content-Type", "Authorization"],
    "maxAgeSeconds": 3600
  }
]

📋 Etapa 7: Configurar Cloud Tasks e Pub/Sub

O Cloud Tasks gerencia a fila de processamento assincrono dos fornecedores.

7.1 Criar a fila

Linux / Mac / Git Bash:

Windows (CMD/PowerShell):

7.2 Criar topico Pub/Sub

7.3 Criar subscription Pub/Sub

Linux / Mac / Git Bash:

Windows (CMD/PowerShell):

7.4 Verificar

🔐 Etapa 8: Configurar Secret Manager

O Secret Manager armazena senhas e chaves de API de forma segura.

8.1 Criar os secrets

Linux / Mac / Git Bash:

Windows (PowerShell) - Execute cada comando separadamente:

8.2 Conceder acesso aos secrets - Service Account do Projeto

Linux / Mac / Git Bash:

Windows (CMD/PowerShell) - Execute cada linha:

8.2.1 Conceder acesso aos secrets - Default Compute Service Account (IMPORTANTE!)

Descobrir o Project Number:

Opcao 1: Conceder acesso a TODOS os secrets (Recomendado)

Esta opcao e mais simples e garante que novas funcoes tambem terao acesso:

Windows (CMD/PowerShell):

Opcao 2: Conceder acesso apenas aos secrets especificos

Use esta opcao se preferir controle mais granular:

Linux / Mac / Git Bash:

Windows (CMD/PowerShell) - Execute cada linha:

8.3 Verificar

8.4 Resumo dos Secrets

📥 Etapa 9: Clonar o Repositorio

9.0 Instalar o Git (se ainda nao tiver)

Windows - Instalar Git:

Linux (Ubuntu/Debian) - Instalar Git:

Linux (Fedora/RHEL) - Instalar Git:

Mac - Instalar Git:

9.1 Clonar o projeto

9.2 Configurar variaveis de ambiente

Linux / Mac / Git Bash:

Windows (CMD):

Windows (PowerShell):

9.3 Preencher variaveis principais

No arquivo .env.production, preencha as variaveis abaixo:

9.4 Validar configuracao

Use o script de validacao para verificar se todas as variaveis estao corretas:

Linux / Mac:

Windows (Git Bash):

Windows (CMD ou PowerShell) - RECOMENDADO:

Windows (Git Bash) - Alternativa:

⚡ Etapa 10: Deploy das Cloud Functions

10.1 Compilar a biblioteca compartilhada

10.2 Executar o deploy

Opcao A: Windows (CMD/PowerShell) - RECOMENDADO:

Opcao B: Linux / Mac:

Opcao C: Windows (Git Bash diretamente):

Abra o Git Bash (clique direito na pasta > "Git Bash Here") e execute:

10.2.1 Deploy Manual de Uma Funcao (Alternativa)

Se os scripts automaticos falharem, siga estes passos manualmente para cada funcao:

10.3 Funcoes que serao deployadas (15 total)

10.4 Verificar deploy

🌐 Etapa 11: Deploy do Frontend

11.1 Configurar Firebase

Passo a passo do firebase init:

11.2 Configurar credenciais do Firebase

O projeto usa variáveis de ambiente para configurar as credenciais do Firebase. O arquivo js/firebase-config.js lê as configurações de js/config.js, que é gerado a partir do arquivo .env.

Passo 1 - Copiar o arquivo de exemplo:

Na pasta frontend, copie o arquivo .env.example para .env:

Windows (PowerShell):

Linux / Mac / Git Bash:

Passo 2 - Obter credenciais do Firebase:

Siga estes passos para obter as credenciais do seu app Firebase:

Valores a copiar do firebaseConfig:

Na tela do SDK, você verá um código similar a este. Copie apenas os 3 valores destacados:

Passo 3 - Editar o arquivo .env:

Abra o arquivo frontend/.env no editor de sua preferencia (Notepad, VS Code, etc.).

O arquivo ja vem pre-configurado. Voce precisa preencher apenas as variaveis marcadas como OBRIGATORIO.

3.1 Variaveis OBRIGATORIAS do Firebase Console:

3.2 Variavel OBRIGATORIA do GCP Console:

3.3 Variaveis JA PREENCHIDAS (nao precisa alterar):

As seguintes variaveis ja estao configuradas corretamente no arquivo .env:

3.4 Variaveis OPCIONAIS (configure se tiver):

Passo 4 - Gerar o arquivo config.js:

Execute o script para gerar o arquivo js/config.js a partir do .env:

Este comando irá:

• Ler as variáveis do arquivo .env
• Gerar o arquivo js/config.js com as configurações
• O arquivo js/firebase-config.js usará automaticamente essas configurações

Passo 5 - Testar localmente (opcional):

Antes de fazer o deploy, você pode testar localmente:

Acesse http://localhost:5000 no navegador e verifique o console do desenvolvedor (F12) para ver se o Firebase foi inicializado corretamente.

Passo 6 - Criar arquivo .firebaseignore (IMPORTANTE!):

O arquivo .gitignore ignora o config.js para não commitar credenciais no Git. Porém, o Firebase Hosting usa o .gitignore como referência, o que faz com que o config.js não seja enviado no deploy.

Crie o arquivo .firebaseignore na pasta frontend:

11.3 Deploy

Configurar Firebase Storage (obrigatorio antes do deploy de storage rules)

Se ao executar firebase deploy --only storage aparecer o erro:

Siga estes passos para configurar o Firebase Storage:

11.4 Indices do Firestore

O arquivo firestore.indexes.json define os seguintes indices:

11.5 Acessar o site

Apos o deploy, seu site estara disponivel em:

• https://tbg-app-robotia-gcnt-cad-forne.web.app
• https://tbg-app-robotia-gcnt-cad-forne.firebaseapp.com

🧪 Etapa 12: Testes e Validacao

12.1 Smoke Tests

12.2 Testar uma Cloud Function

Linux / Mac / Git Bash:

Windows (PowerShell):

Windows (CMD) - Execute cada linha separadamente:

12.3 Testar o Frontend

1. Acesse https://tbg-app-robotia-gcnt-cad-forne.web.app
2. Faca login com sua conta Google
3. Faca upload de uma planilha de teste
4. Verifique se o processamento inicia

12.4 Verificar logs

Linux / Mac / Git Bash:

Windows (CMD/PowerShell):

12.5 Configurar Cloud Scheduler

Linux / Mac / Git Bash:

Windows (PowerShell):

Windows (CMD) - Duas etapas:

🏢 Configuracao SAP (Opcional)

Modos de Integracao SAP

Configurar via Interface Web

Configurar via API (Alternativa)

Linux / Mac / Git Bash:

Windows (PowerShell):

Testar Integracao SAP

Linux / Mac / Git Bash:

Windows (CMD/PowerShell):

📊 Monitoramento e Alertas

Acessar Cloud Monitoring

Acesse: console.cloud.google.com/monitoring

Alertas Recomendados

Criar Alerta de Taxa de Erro

Linux / Mac / Git Bash:

Windows (CMD/PowerShell):

Ver Metricas das Cloud Functions

Linux / Mac / Git Bash:

Windows (CMD) - Metodo simplificado:

Windows (PowerShell) - Com timestamp dinamico:

Dashboard Recomendado

Crie um dashboard no Cloud Monitoring com os seguintes widgets:

• 📈 Execucoes de Cloud Functions por minuto
• ❌ Taxa de erro por funcao
• ⏱️ Latencia P50/P95/P99
• 📊 Status de fornecedores no Firestore
• 💾 Tamanho dos buckets

💰 Alertas de Orcamento

Criar Alerta de Orcamento

Via gcloud CLI

Linux / Mac / Git Bash:

Windows (PowerShell):

Windows (CMD) - Duas etapas:

Custos Estimados (Referencia)

🚀 CI/CD com GitHub Actions (Avancado)

Workflows Disponiveis

Configurar GitHub Secrets

Para que os workflows funcionem, configure os seguintes secrets no repositorio GitHub:

Va em: Repository Settings → Secrets and variables → Actions

Criar Service Account Key para CI/CD

Linux / Mac / Git Bash:

Windows (CMD/PowerShell):

Windows (PowerShell) - Alternativa:

Adicionar o JSON ao GitHub Secrets:

Apos executar o comando que exibe o JSON, siga estes passos:

{
  "type": "service_account",
  "project_id": "tbg-app-robotia-gcnt-cad-forne",
  "private_key_id": "abc123...",
  "private_key": "-----BEGIN PRIVATE KEY-----\n...\n-----END PRIVATE KEY-----\n",
  "client_email": "tbg-app-robotia-gcnt-cad-forne@tbg-app-robotia-gcnt-cad-forne.iam.gserviceaccount.com",
  "client_id": "123456789",
  ...
}

Configurar GitHub Environment (Obrigatorio)

O workflow de producao requer um Environment configurado para o gate de aprovacao:

Criar Tag/Versao para Deploy (OBRIGATORIO)

Siga estes passos para criar e enviar a tag:

Disparar Deploy de Producao

🔧 Troubleshooting

Comandos uteis

Links uteis

• Cloud Functions Console
• Cloud Logging
• Firebase Console
• Cloud Storage

📋 Checklist Final de Validacao

Antes de considerar o setup completo, verifique: