FinSight
☁️

Google Cloud Storage

Cache Ilimitado
Não configurado
Por que usar o Google Cloud Storage?
O localStorage do navegador tem limite de 5–10 MB, o que pode ser insuficiente para bases com muitos lançamentos OMIE. O GCS armazena o cache sem limite de tamanho, permite sincronização automática entre dispositivos e mantém histórico permanente dos dados.

Configuração do Bucket GCS

Habilitar Google Cloud Storage

Nome exato do bucket criado no Google Cloud Console. Deve ser globalmente único.

Prefixo adicionado aos arquivos no bucket. Padrão: finsight/

Leitura pública (allUsers → objectViewer)

Permite download sem autenticação. Upload ainda requer Access Token.

Token de curta duração (~1h) do Google OAuth2. Obtenha em OAuth Playground com o escopo https://www.googleapis.com/auth/devstorage.read_write.

Gerenciar Cache no GCS

Configure e habilite o GCS para gerenciar o cache.

Última Sincronização

Carregando…

Guia Passo a Passo — Configuração do GCS

1

Criar o Bucket no Google Cloud Console

Acesse console.cloud.google.com/storage e clique em "Criar Bucket".
• Nome: use algo como finsight-cache-suaempresa
• Região: us-central1 (gratuito no Free Tier)
• Controle de acesso: Uniforme
• Não habilite criptografia gerenciada pelo cliente por ora.

2

Configurar CORS no Bucket

Para permitir acesso do navegador (Cross-Origin), configure o CORS via Cloud Shell ou gsutil:

# Crie o arquivo cors.json: [{ "origin": ["*"], "method": ["GET", "POST", "PUT", "DELETE", "HEAD"], "responseHeader": ["Content-Type", "Authorization", "x-goog-meta-*"], "maxAgeSeconds": 3600 }] # Aplique o CORS ao bucket: gsutil cors set cors.json gs://SEU-BUCKET-AQUI

Ou use o botão "Editar CORS" diretamente no console.

3

Habilitar Leitura Pública (recomendado)

No Console → Bucket → Permissões → Conceder acesso:
• Principal: allUsers
• Função: Storage Object Viewer

Isso permite que o FinSight leia o cache sem autenticação. O upload ainda requerirá o Access Token.

4

Obter o Access Token OAuth2

Acesse o Google OAuth 2.0 Playground:
1. Clique no ⚙️ e marque "Use your own OAuth credentials" (ou use as credenciais padrão)
2. Na Etapa 1, selecione: Cloud Storage API v1 → devstorage.read_write
3. Clique em "Authorize APIs" e faça login com sua conta Google
4. Na Etapa 2, clique em "Exchange authorization code for tokens"
5. Copie o Access Token gerado (válido por ~1 hora)

5

Configurar e Testar no FinSight

1. Volte para a aba Configuração
2. Preencha o Nome do Bucket e cole o Access Token
3. Clique em "Testar Conexão"
4. Se OK, clique em "Salvar Configurações"
5. Clique em "Sincronizar OMIE → GCS" para fazer o primeiro upload

6

Renovação Automática do Token

O Access Token expira em ~1 hora. Para uso em produção, há duas opções:
• Manual: Acesse a aba "Renovar Token" e cole o novo token antes de sincronizar
• Service Account: Para renovação automática, configure um Cloudflare Worker para assinar JWTs (veja worker-setup.html)

Custo estimado: O GCS cobra pelo armazenamento e transferência. Para o FinSight (cache ~5–20 MB, 1–2 sincronizações/dia), o custo estimado é menos de R$ 1,00/mês no Free Tier (5 GB gratuitos/mês de armazenamento e 1 GB de transferência).

Status & Diagnóstico do GCS

Verificando status do GCS…

Renovar Access Token OAuth2

Os Access Tokens do Google OAuth2 expiram em ~1 hora. Você precisa renová-los antes de realizar uploads para o GCS. Para o FinSight, a renovação é manual — acesse o OAuth Playground e cole o novo token abaixo.

Obtenha em: developers.google.com/oauthplayground
Selecione o escopo: Cloud Storage API v1 → devstorage.read_write

Abrir OAuth Playground

Renovação Automática via Service Account (Avançado)

Para renovação automática sem intervenção manual, você precisará de um Service Account com permissão Storage Object Admin no bucket. O FinSight pode usar a chave JSON do Service Account para gerar tokens automaticamente via Cloudflare Worker — veja worker-setup.html para configurar.

Cole aqui apenas para visualização/configuração do Worker. A chave não é enviada para nenhum servidor externo.