Schema do Supabase — Fechamento de Caixa

Servidor

URL: https://supabase.ofrangao.com.br
Instância: O Frangão — PostgreSQL hospedado

Tabela principal: `fechamentos_web`

CREATE TABLE public.fechamentos_web (
  id              SERIAL PRIMARY KEY,
  id_fechamento   TEXT UNIQUE NOT NULL,  -- chave natural: {loja}_{data}_{operador}
  loja            TEXT NOT NULL,          -- "Uniao" | "Alianca"
  data            DATE NOT NULL,          -- data do fechamento (YYYY-MM-DD)
  operador        TEXT NOT NULL,          -- nome do operador
  turno           TEXT NOT NULL,          -- "manha" | "tarde"
  observacoes     TEXT DEFAULT 'rascunho', -- "rascunho" | "finalizado"

  -- Totais de fechamento (campos escalares)
  fechamento_dinheiro  REAL DEFAULT 0,    -- dinheiro no caixa
  fechamento_cartoes   REAL DEFAULT 0,    -- total cartões
  fechamento_receber   REAL DEFAULT 0,    -- a receber
  fechamento          REAL DEFAULT 0,     -- TOTAL: dinheiro + cartões + receber

  -- Totais do sistema (valores lidos do sistema PAF-ECF)
  sys_total          REAL DEFAULT 0,     -- soma: troco+crédito+débito+alimentação+vales+receber+pixCartao+pixCnpj
  saldo_esperado     REAL DEFAULT 0,     -- quanto deveria ter (informado pelo operador)

  -- Controle
  criado_em          TIMESTAMPTZ DEFAULT NOW(),
  atualizado_em      TIMESTAMPTZ DEFAULT NOW(),
  enviado_por        TEXT,
  ip_origem          TEXT,
  user_agent         TEXT,

  -- Dados variáveis em formato livre (JSONB)
  dados             JSONB DEFAULT '{}'::jsonb
);

Comentários sobre colunas

Coluna	O que guarda
`id_fechamento`	Chave natural única. Ex: `uniao_2026-06-19_filipe`. Formato: `{loja}_{data}_{operador}` em minúsculas, espaços → `_`
`sys_total`	Total calculado pelo sistema — é a soma de todos os campos de cartão + vales + despesas + sangrias + etc
`saldo_esperado`	Valor informado pelo operador — o quanto ele espera ter em caixa
`dados`	JSONB com todos os arrays: `cartoes_credito[]`, `cartoes_debito[]`, `cartoes_alimentacao[]`, `cartoes_pix[]`, `despesas[]`, `sangrias[]`, `pixcnpj[]`, `vales[]`, `receber[]`, `cancelamentos[]`
`observacoes`	`rascunho` enquanto.edita, `finalizado` quando o operador confirma

Fórmula de diferença

DIFERENÇA = sys_total − saldo_esperado − total_cancelamentos

Se DIFERENÇA = 0 → ✅ OK (caixa fecha perfeito) Se DIFERENÇA > 0 → ⚠️ Sobrou dinheiro Se DIFERENÇA < 0 → 🔴 Faltou dinheiro

Colunas dentro do JSONB `dados`

{
  "cartoes_credito":  [152.00, 123.50, ...],
  "cartoes_debito":   [15.45, 20.00, ...],
  "cartoes_alimentacao": [12.55, ...],
  "cartoes_pix":      [112.50, ...],
  "despesas":         [{"desc": "luz", "valor": 150.00}, ...],
  "sangrias":         [{"hora": "14:30", "gerente": "João", "retirada": 50.00, "valor": 50.00}, ...],
  "pixcnpj":          [{"nome": "João Silva", "valor": 80.00}, ...],
  "vales":            [{"nome": "Maria", "obs": "vale transporte", "valor": 30.00}, ...],
  "receber":          [{"nome": "Pedro", "valor": 45.00}, ...],
  "cancelamentos":    [{"numero": "001", "motivo": "erro digitação", "valor": 25.00}, ...]
}

Row Level Security (RLS)

A tabela usa RLS com duas políticas:

Anon (chave pública): pode ler registros
Service role: pode ler + escrever registros (usado pelo app com JWT service_role)

Chave anon (pública)

Usada para consultasreadonly pelo frontend.

Chave service_role

Usada pelo app Tauri para INSERT/UPDATE via plugin supabase.rs. Esta chave nunca deve ser exposta publicamente — está embedada no binário compilado.

Endpoints da API REST

Base: https://supabase.ofrangao.com.br/rest/v1/

Método	Endpoint	Uso
`GET`	`/fechamentos_web?loja=eq.uniao&data=eq.2026-06-19&select=*`	Lista fechamentos
`GET`	`/fechamentos_web?id_fechamento=eq.uniao_2026-06-19_filipe`	Busca por chave
`POST`	`/fechamentos_web`	Cria/atualiza (upsert via `Prefer: resolution=merge-duplicates`)
`PATCH`	`/fechamentos_web?id_fechamento=eq.uniao_2026-06-19_filipe`	Atualiza campos

Header de autenticação

Authorization: Bearer {SUPABASE_SERVICE_ROLE_JWT}
apikey: {SUPABASE_ANON_KEY}
Content-Type: application/json
Prefer: resolution=merge-duplicates  (para upsert no POST)

Supabase — Configuração do projeto

Projeto: O Frangão
Host: https://supabase.ofrangao.com.br
Banco: PostgreSQL 15+
API: REST via PostgREST
Auth: JWT (anon key + service role key)

O app busca a service_role key via config.json local (em %LOCALAPPDATA%/FechamentoCaixa/config.json). O fallback é a chave embedada no binário.

// config.json (opcional — sobrepõe a embedada)
{
  "SUPABASE_ANON_KEY": "sb_publishable_...",
  "SUPABASE_SERVICE_KEY": "sb_secret_..."
}

4.9 KiB Raw Blame History Unescape Escape