fix: diferenca calculada sempre a partir da array de cancelamentos (nao do escalar)

- app.rs: LOJA_FIXA via option_env!(DOBRADO_LOJA), get_loja_fixa command
- app.rs: set_loja bloqueado se build fixa
- index.html: DOMContentLoaded detecta loja fixa e esconde seletor
- 3 executáveis: fc-uniao.exe / fc-alianca.exe / fc-ambos.exe

API_INTEGRATION.md

@@ -0,0 +1,139 @@
+# Integração Frontend ↔ Tauri (Rust) ↔ Supabase
+
+## Visão geral da comunicação
+
+```
+┌─────────────────┐         ┌─────────────────┐         ┌──────────────────┐
+│  JavaScript     │ invoke  │  Tauri/Rust     │ HTTP    │  Supabase       │
+│  (index.html)   │────────▶│  commands       │────────▶│  (cloud)        │
+│                 │◀────────│                 │◀────────│                 │
+└─────────────────┘ response└─────────────────┘ response└──────────────────┘
+```
+
+O frontend **nunca faz requisições HTTP direto** para o Supabase. Toda comunicação passa pelos comandos Tauri (Rust).
+
+---
+
+## Comandos Tauri disponíveis
+
+### App
+| Comando | O que faz |
+|---------|-----------|
+| `get_loja` | Retorna a loja configurada |
+| `get_loja_fixa` | Retorna `"Uniao"`, `"Alianca"` ou `null` (se build fixa) |
+| `set_loja(loja)` | Define a loja (bloqueado se build fixa) |
+| `get_config` | Retorna config completo `{ loja, pdv_nome, operador_default, ... }` |
+| `set_config(cfg)` | Salva config |
+
+### Storage (SQLite local)
+| Comando | O que faz |
+|---------|-----------|
+| `salvar_fechamento(estado)` | Salva estado completo no SQLite local |
+| `carregar_rascunho(loja, data)` | Retorna último rascunho para loja+data |
+| `listar_fechamentos(loja, limite)` | Lista fechamentos de uma loja |
+| `buscar_fechamento_por_id(id)` | Busca por ID local |
+| `pendentes_sync` | Retorna fechamentos que ainda não foram syncados |
+
+### Supabase
+| Comando | O que faz |
+|---------|-----------|
+| `sb_salvar_fechamento(estado)` | Upsert no Supabase via service_role JWT |
+| `sb_carregar_rascunho(loja, data)` | Busca rascunho mais recente |
+| `sb_listar_recentes(loja, limite)` | Lista fechamentos recentes |
+| `sb_buscar_por_id(id)` | Busca por ID |
+| `sb_buscar_por_uuid(uuid)` | Busca por UUID |
+| `sb_buscar_por_id_fechamento(id_fechamento)` | Busca por chave natural |
+| `sb_atualizar_fechamento(id_fechamento, updates)` | PATCH campos específicos |
+| `sb_salvar_listas(loja, listas)` | Salva operadores/gerentes customizados |
+| `sb_carregar_listas(loja)` | Carrega listas salvas |
+| `sb_online` | Retorna `true`/`false` se Supabase está acessível |
+
+### Printer
+| Comando | O que faz |
+|---------|-----------|
+| `detectar_impressora` | Detecta EPSON TM-T20 USB |
+| `configurar_impressora(caminho)` | Define caminho da impressora |
+| `caminho_impressora` | Retorna caminho configurado |
+| `imprimir_recibo(html)` | Envia HTML puro para impressora |
+| `teste_impressora` | Imprime página de teste |
+| `ativar_modo_teste_impressao` | Ativa modo teste (salva PDF em vez de imprimir) |
+
+---
+
+## Fluxo de salvar um fechamento
+
+```javascript
+// No frontend (index.html), quando operador clica "Salvar":
+async function salvarFechamento() {
+  const estado = buildEstado(); // coleta todos os campos do formulário
+
+  // 1. Salva localmente (sempre funciona offline)
+  await invoke('salvar_fechamento', { estado });
+
+  // 2. Tenta sync com Supabase
+  try {
+    await invoke('sb_salvar_fechamento', { estado });
+    toast('✅ Salvo e sincronizado');
+  } catch(e) {
+    // Supabase offline — fica pendente no SQLite
+    toast('💾 Salvo localmente (sync pendente)');
+  }
+}
+```
+
+---
+
+## Como o Rust conversa com o Supabase
+
+Em `supabase.rs`, o plugin usa `reqwest` (HTTP client) com:
+
+```rust
+fn headers(&self, use_service: bool) -> reqwest::header::HeaderMap {
+    let key = if use_service { &self.service_role_key } else { &self.anon_key };
+    let mut headers = reqwest::header::HeaderMap::new();
+    headers.insert(
+        reqwest::header::AUTHORIZATION,
+        format!("Bearer {}", key).parse().unwrap(),
+    );
+    headers
+}
+```
+
+- **`use_service = true`:** para INSERT/UPDATE (salvar fechamento)
+- **`use_service = false`:** para GET (listar, buscar)
+
+---
+
+## Upsert — salvar sem duplicar
+
+O Supabase não tem UPSERT nativo via REST. O plugin usa um truque:
+
+```http
+POST /fechamentos_web HTTP/1.1
+Prefer: resolution=merge-duplicates
+```
+
+Se o `id_fechamento` já existe, o PostgREST faz um UPDATE em vez de INSERT. Se não existe, faz INSERT.
+
+---
+
+## UUID vs id_fechamento
+
+| Campo | O que é | Quem gera |
+|-------|---------|-----------|
+| `id` | ID sequencial do PostgreSQL | Supabase (auto) |
+| `uuid` | UUID único do registro local | Frontend JS (`crypto.randomUUID()`) |
+| `id_fechamento` | Chave natural: `{loja}_{data}_{operador}` | Frontend JS (construído na hora) |
+
+O `id_fechamento` é a chave de negócio. O `uuid` é para rastrear registros entre local e cloud.
+
+---
+
+## Offline first — como funciona
+
+1. **Operador/edita** → `salvar_fechamento` → SQLite (sempre funciona)
+2. **Operador/edita** → `sb_salvar_fechamento` → Supabase (só se online)
+3. **Se offline:** o fechamento fica no SQLite com `sync_status = "local"`
+4. **Quando conecta:** `pendentes_sync` retorna os pendentes → sync automático
+
+O sync automático é controlado por `sync_automatico` na config da app.

BUILDS_FARM.md

@@ -0,0 +1,209 @@
+# Builds — Como gerar fc-uniao.exe, fc-alianca.exe, fc-ambos.exe
+
+## Conceito
+
+O mesmo código gera 3 binários diferentes. A diferença entre eles é apenas o valor da variável de ambiente `DOBRADO_LOJA` passado na hora da compilação Rust.
+
+- **Build fixa (União ou Aliança):** o operador **não consegue trocar a loja** no formulário
+- **Build livre (Ambós):** o operador escolhe entre União e Aliança no dropdown
+
+---
+
+## Mecanismo: `option_env!` em Rust
+
+Em `src-tauri/src/plugins/app.rs`:
+
+```rust
+/// DOBRADO_LOJA é uma variável de ambiente lida em TEMPO DE COMPILAÇÃO.
+/// Se não definida, retorna None.
+pub const LOJA_FIXA: Option<&'static str> = option_env!("DOBRADO_LOJA");
+```
+
+O `option_env!` é uma macro built-in do Rust que avalia expressões const em tempo de compilação. Se `DOBRADO_LOJA` estiver definida como env var, `LOJA_FIXA` contém o valor. Se não, `None`.
+
+### Por que compile-time?
+
+Se fosse runtime (`std::env::var`), o valor estaría hardcoded no binário da mesma forma, mas compile-time é mais limpo porque o Rust elimina código morto (dead code elimination). Se `LOJA_FIXA` é `None`, o Rust pode optimizar o código de "loja fixa" para fora do binário final.
+
+---
+
+## Comportamento por build
+
+| Build | `DOBRADO_LOJA` | Seletor loja | `set_loja` | `get_loja_fixa` |
+|-------|----------------|-------------|-------------|-----------------|
+| União | `Uniao` | **Escondido** | Bloqueado com erro | `"Uniao"` |
+| Aliança | `Alianca` | **Escondido** | Bloqueado com erro | `"Alianca"` |
+| Ambos | _(não definido)_ | Visível + funcional | Permitido | `null` |
+
+---
+
+## Como buildar (Linux → Windows cross-compile)
+
+### Pré-requisitos
+
+```bash
+# Instalar target cross-compile
+rustup target add x86_64-pc-windows-gnu
+
+# Ou via apt (Ubuntu/Debian)
+sudo apt install mingw-w64
+```
+
+### Comandos
+
+```bash
+cd src-tauri/
+
+# ── UNIÃO ─────────────────────────────────────────────
+DOBRADO_LOJA=Uniao \
+  cargo build --release --target x86_64-pc-windows-gnu
+
+# Binário gerado:
+# src-tauri/target/x86_64-pc-windows-gnu/release/fechamento-caixa.exe
+
+# ── ALIANÇA ──────────────────────────────────────────
+DOBRADO_LOJA=Alianca \
+  cargo build --release --target x86_64-pc-windows-gnu
+
+# ── AMBOS ────────────────────────────────────────────
+cargo build --release --target x86_64-pc-windows-gnu
+# (sem DOBRADO_LOJA → loja livre)
+```
+
+### Local do binário
+
+```
+src-tauri/target/x86_64-pc-windows-gnu/release/fechamento-caixa.exe
+```
+
+Renomear para `fc-uniao.exe`, `fc-alianca.exe`, `fc-ambos.exe` antes de distribuir.
+
+### ⚠️ Distribuição: WebView2Loader.dll
+
+O binário **precisa da `WebView2Loader.dll` na mesma pasta** para funcionar. Esta DLL é o loader do WebView2 (o navegador embutido do Tauri).
+
+```
+Pasta de distribuição (cada build):
+├── fc-uniao.exe
+├── WebView2Loader.dll    ← copiar junto!
+```
+
+A DLL está em:
+```
+src-tauri/target/x86_64-pc-windows-gnu/release/WebView2Loader.dll
+```
+
+Para copiar junto ao buildar:
+```bash
+DLL="src-tauri/target/x86_64-pc-windows-gnu/release/WebView2Loader.dll"
+cp ${DLL} /tmp/fc-uniao/
+cp ${DLL} /tmp/fc-alianca/
+cp ${DLL} /tmp/fc-ambos/
+```
+
+---
+
+## O que acontece no frontend quando a loja é fixa
+
+Em `src/index.html`, `DOMContentLoaded`:
+
+```javascript
+document.addEventListener('DOMContentLoaded', async () => {
+  try {
+    const fixa = await window.__TAURI__.core.invoke('get_loja_fixa');
+    if (fixa) {
+      // Build fixa: esconde o <select id="f-loja">
+      const sel = document.getElementById('f-loja');
+      sel.style.display = 'none';
+      sel.disabled = true;
+
+      // Esconde o label "Loja"
+      const label = document.querySelector('.meta-label');
+      if (label && label.textContent.trim() === 'Loja') {
+        label.style.display = 'none';
+      }
+
+      estado.loja = fixa; // define sem precisar do select
+    }
+  } catch(e) {
+    console.warn('get_loja_fixa não disponível:', e);
+  }
+  // ... resto do init
+});
+```
+
+---
+
+## O que acontece no Rust quando a loja é fixa
+
+```rust
+// set_loja retorna erro se a build tem loja fixa
+#[tauri::command]
+pub fn set_loja(state: State<'_, AppState>, loja: String) -> Result<(), String> {
+    if LOJA_FIXA.is_some() {
+        return Err("Loja fixa em tempo de build — não é possível trocar.".to_string());
+    }
+    state.config.lock().unwrap().loja = loja;
+    state.save()
+}
+```
+
+---
+
+## Testar localmente (dev mode)
+
+```bash
+cd src-tauri/
+
+# Com loja fixa (dev)
+DOBRADO_LOJA=Uniao cargo tauri dev
+
+# Com loja livre (dev)
+cargo tauri dev
+```
+
+---
+
+## Criar release no Gitea
+
+```bash
+# 1. Buildar as 3 versões e copiar para /tmp/
+cp src-tauri/target/x86_64-pc-windows-gnu/release/fechamento-caixa.exe /tmp/fc-uniao.exe
+cp src-tauri/target/x86_64-pc-windows-gnu/release/fechamento-caixa.exe /tmp/fc-alianca.exe
+cp src-tauri/target/x86_64-pc-windows-gnu/release/fechamento-caixa.exe /tmp/fc-ambos.exe
+
+# 2. Criar releases via Gitea API
+GITEA_TOKEN="seu_token_aqui"
+REPO="filipe/fechamento-caixa"
+
+for build in uniao alianca ambos; do
+  TAG="v2.0.0-${build}"
+  FILE="/tmp/fc-${build}.exe"
+
+  # Criar release
+  RESP=$(curl -s -H "Authorization: token ${GITEA_TOKEN}" \
+    -H "Content-Type: application/json" \
+    -d "{\"tag_name\":\"${TAG}\",\"name\":\"${TAG}\",\"body\":\"Build ${build}\"}" \
+    "https://git.ofrangao.com.br/api/v1/repos/${REPO}/releases")
+  ID=$(echo $RESP | python3 -c "import sys,json; print(json.load(sys.stdin)['id'])")
+
+  # Upload asset
+  curl -s -H "Authorization: token ${GITEA_TOKEN}" \
+    -H "Content-Type: application/octet-stream" \
+    --data-binary @${FILE} \
+    "https://git.ofrangao.com.br/api/v1/repos/${REPO}/releases/${ID}/assets?name=fc-${build}.exe"
+done
+```
+
+---
+
+## Arquivos que mudam entre builds
+
+**Nenhum arquivo fonte muda.** O binário é identico exceto pelo valor de `LOJA_FIXA` hardcoded.
+
+Para verificar o valor hardcoded no binário:
+```bash
+strings fc-uniao.exe | grep -E "Uniao|Alianca"
+```
+
+O binário `fc-uniao.exe` contém a string `Uniao` no lugar de `LOJA_FIXA`, enquanto `fc-ambos.exe` não contém nada (ou contém `None` ou não tem referência).

README.md

@@ -1,140 +1,192 @@
 # Fechamento de Caixa — O Frangão
 
-App desktop nativo para fechamento de caixa com impressão em impressora térmica 80mm.
+## O que é
 
-## Stack
+App desktop nativo para registrar o fechamento de caixa diário das lojas **União** e **Aliança** do O Frangão. Cada fechamento registra: saldo em dinheiro, cartões de crédito/débito/alimentação/PIX, vales, sangrias, despesas, PIX CNPJ, e itens a receber.
 
-- **Backend:** Tauri 2 + Rust
+## Ideia central
-- **Frontend:** HTML + CSS + JavaScript (vanilla, ~1700 linhas)
-- **Storage local:** SQLite (rusqlite) — funciona offline
-- **Sync:** Supabase REST API
-- **Impressão:** ESC/POS via USB (TM-T20 e compatíveis, Windows)
 
-## Estrutura do Projeto
+O app é um **formulário inteligente** que:
+
+1. Captura todos os dados de fechamento de caixa (dinheiro, cartões, despesas, etc.)
+2. Salva localmente em **SQLite** (funciona offline)
+3. Envia automaticamente para o **Supabase** (cloud) quando há conexão
+4. Gera um **recibo térmico 80mm** para impressão
+
+O objetivo é substituir planilhas manuais e webhooks frágeis, dando uma fonte única de verdade para os dados de caixa.
+
+---
+
+## Arquitetura geral
+
+```
+┌─────────────────┐     ┌──────────────────┐     ┌────────────────────┐
+│  HTML/JS        │────▶│  Tauri (Rust)    │────▶│  SQLite (local)    │
+│  (frontend)     │◀────│  plugins:        │◀────│  fechamentos.db     │
+│                 │     │  app, storage,    │     │  - funciona offline │
+│  - formulário   │     │  supabase,       │     │  - sync automático  │
+│  - impressão    │     │  printer         │     └────────────────────┘
+│  - estado JS    │     └────────┬─────────┘              │
+└─────────────────┘              │                      ▼
+                                │              ┌────────────────────┐
+                                │              │  Supabase Cloud    │
+                                │              │  (supabase.       │
+                                └─────────────▶│   ofrangao.com.br) │
+                                               │  - PostgreSQL     │
+                                               │  - RLS + JWT auth │
+                                               │  - API REST       │
+                                               └────────────────────┘
+```
+
+---
+
+## Stack técnica
+
+| Camada | Tecnologia |
+|--------|-----------|
+| Frontend | HTML5 + CSS + JavaScript vanilla (single-file `src/index.html`) |
+| Runtime | [Tauri 2](https://tauri.app/) (Rust + WebView2) |
+| Dados local | SQLite via `rusqlite` |
+| Dados cloud | [Supabase](https://supabase.com/) — PostgreSQL + REST API |
+| Impressão | HTML → `window.print()` com CSS @media print (80mm) |
+| Build | Cross-compile Linux → Windows (`x86_64-pc-windows-gnu`) |
+
+---
+
+## Repositório
+
+```
+https://git.ofrangao.com.br/filipe/fechamento-caixa
+```
+
+### Estrutura de arquivos
 
 ```
 fechamento-caixa/
 ├── src/
-│   └── index.html          # Frontend completo (HTML + CSS + JS inline)
+│   └── index.html        ← Frontend completo (HTML + CSS + JS)
 ├── src-tauri/
-│   ├── Cargo.toml          # Dependências Rust
+│   ├── src/
-│   ├── tauri.conf.json     # Config do app Tauri
+│   │   ├── main.rs       ← Entry point + plugin initialization
-│   └── src/
+│   │   └── plugins/
-│       ├── main.rs         # Entry point — registra comandos Tauri
+│   │       ├── app.rs      ← Config da app (loja, PDV, sync)
-│       └── plugins/
+│   │       ├── storage.rs  ← SQLite local
-│           ├── supabase.rs # Integração Supabase (REST API)
+│   │       ├── supabase.rs ← Sync com Supabase
-│           ├── printer.rs  # Geração ESC/POS + envio USB
+│   │       ├── printer.rs  ← Impressão
-│           ├── storage.rs  # SQLite local
+│   │       └── escpos.rs   ← Helpers ESCPOS
-│           ├── app.rs      # Config da app (loja, operador default)
+│   └── tauri.conf.json   ← Config Tauri (janela, bundle, etc.)
-│           └── escpos.rs   # Helpers ESC/POS (INIT, CUT, divider, etc.)
+├── SPEC.md              ← Este arquivo
-└── README.md
+├── SUPABASE_SCHEMA.md   ← Schema do banco de dados
+├── API_INTEGRATION.md   ← Como o frontend se comunica com Supabase
+└── BUILS_FARM.md        ← Como gerar fc-uniao.exe, fc-alianca.exe, fc-ambos.exe
 ```
 
-## Pré-requisitos
+---
 
-- Rust 1.70+ (`rustup install stable`)
+## Builds — 3 versões do app
-- Node.js 18+ (para build do frontend Tauri)
-- Windows 10/11 (impressão USB só funciona no Windows)
 
-## Setup
+O mesmo código gera 3 binários diferentes conforme a variável de ambiente `DOBRADO_LOJA`:
 
-### 1. Clonar o repositório
+## Downloads
 
-```bash
+| Binário | Loja | Download |
-git clone https://git.ofrangao.com.br/filipe/fechamento-caixa.git
+|---------|------|----------|
-cd fechamento-caixa
+| `fc-uniao.exe` | **Travada: UNIÃO** | [Baixar](https://git.ofrangao.com.br/filipe/fechamento-caixa/releases/download/v2.0.0-uniao/fc-uniao.exe) |
-```
+| `fc-alianca.exe` | **Travada: ALIANÇA** | [Baixar](https://git.ofrangao.com.br/filipe/fechamento-caixa/releases/download/v2.0.0-alianca/fc-alianca.exe) |
+| `fc-ambos.exe` | **Seletor livre** | [Baixar](https://git.ofrangao.com.br/filipe/fechamento-caixa/releases/download/v2.0.0-ambos/fc-ambos.exe) |
 
-### 2. Configurar chaves do Supabase
+Quando a loja é fixa, o seletor de loja no formulário é **escondido via JavaScript** e tentativas de mudar via API retornam erro.
 
-Crie o arquivo `config.json` em `%LOCALAPPDATA%\FechamentoCaixa\config.json` (Windows):
+---
 
-```json
+## Fluxo de um fechamento
-{
-  "SUPABASE_ANON_KEY": "sua_chave_anon_aqui",
-  "SUPABASE_SERVICE_KEY": "sua_chave_service_role_aqui"
-}
-```
-
-O app procura esse arquivo na inicialização. Sem ele, tenta ler das variáveis de ambiente `SUPABASE_ANON_KEY` e `SUPABASE_SERVICE_KEY`.
-
-### 3. Build
-
-```bash
-cd src-tauri
-cargo build --release --target x86_64-pc-windows-gnu
-```
-
-O executável fica em:
-```
-src-tauri/target/x86_64-pc-windows-gnu/release/fechamento-caixa.exe
-```
-
-Para gerar o pacote de distribuição:
-```bash
-cp src-tauri/target/x86_64-pc-windows-gnu/release/fechamento-caixa.exe .
-cp src-tauri/target/x86_64-pc-windows-gnu/release/WebView2Loader.dll .
-tar -czf fechamento-caixa-vX.X.X.tar.gz fechamento-caixa.exe WebView2Loader.dll
-```
-
-## Códigos de comando Tauri
-
-O frontend chama esses comandos via `window.__TAURI__.core.invoke()`:
-
-| Comando | Arquivo | Descrição |
-|---------|---------|-----------|
-| `salvar_fechamento` | storage.rs | Salva no SQLite local |
-| `carregar_rascunho` | storage.rs | Busca rascunho por loja+data |
-| `listar_fechamentos` | storage.rs | Lista histórico do SQLite |
-| `buscar_fechamento_por_id` | storage.rs | Busca por ID no SQLite |
-| `sb_salvar_fechamento` | supabase.rs | Envia para Supabase |
-| `sb_carregar_rascunho` | supabase.rs | Busca rascunho no Supabase |
-| `sb_listar_recentes` | supabase.rs | Lista fechamentos recentes |
-| `sb_buscar_por_id` | supabase.rs | Busca por ID no Supabase |
-| `sb_salvar_listas` | supabase.rs | Salva operadores/gerentes |
-| `sb_carregar_listas` | supabase.rs | Carrega listas do servidor |
-| `sb_online` | supabase.rs | Verifica conectividade |
-| `imprimir_recibo` | printer.rs | Envia bytes ESC/POS pra USB |
-| `detectar_impressora` | printer.rs | Detecta porta USB |
-| `configurar_impressora` | printer.rs | Define porta manual |
-| `teste_impressora` | printer.rs | Imprime página de teste |
-| `get_loja` / `set_loja` | app.rs | Loja atual |
-| `get_config` / `set_config` | app.rs | Config completo |
-
-## Fluxo de dados
 
 ```
-[Usuário preenche formulário]
+1. Operador abre o app
-         │
+   ↓
-         ▼ (auto-save a cada 1.5s)
+2. Seleciona Data, Operador, Turno, Loja (se não for fixa)
-    SQLite local (fechamento.db)
+   ↓
-         │
+3. Preenche os campos:
-         ├── [Botão Enviar] ──► Supabase (fechamentos_web)
+   - Saldo de Troy
-         │
+   - Cartões (crédito, débito, alimentação, PIX) — um valor por vez
-         └── [Botão Recibo] ──► printer.rs ──► to_escpos() ──► USB
+   - Despesas (descrição + valor)
-                                │
+   - Sangrias (hora + gerente + valor)
-                                ├── Sucesso: imprime
+   - PIX CNPJ (nome + valor)
-                                └── Falha: openPrintPreview() ──► iframe ──► window.print()
+   - Vales (nome + observação + valor)
+   - A Receber (nome + valor)
+   - Cancelamentos (número + motivo + valor)
+   ↓
+4. App calcula:
+   TOTAL SISTEMA = soma de todos os campos acima
+   DIFERENÇA = TOTAL SISTEMA − Saldo Esperado − Cancelamentos
+   ↓
+5. Operador clica "💾 Salvar / Sincronizar"
+   → Salva em SQLite local
+   → Envia para Supabase (se online)
+   ↓
+6. Operador clica "🖨️ Imprimir"
+   → Abre preview do recibo 80mm
+   → window.print() para impressora térmica
 ```
 
-## Campos do formulário
+---
 
-| Campo | Tabela Supabase | Notas |
+## Tauri — o runtime desktop
-|-------|----------------|-------|
-| uuid, loja, data, operador, turno | fechamentos_web | PK composto |
-| saldo_troco, saldo_esperado, fechamento, diferenca | fechamentos_web | diferenca = fechamento - saldo_esperado |
-| despesas[], sangrias[], vales[], receber[], pixcnpj[], cancelamentos[] | dados (JSON) | Arrays de {desc/nome, valor, ...} |
-| cartoes{credito[],debito[],alimentacao[],pix[]} | dados (JSON) | Arrays de {valor} |
-| operadores[], gerentes[], despesas_custom[], clientes[] | listas_personalizadas | Listas por loja |
 
-## Problemas conhecidos
+O app roda como **Tauri 2**, um runtime que embute um navegador WebView2 (Windows) dentro de um processo Rust.
 
-- Impressão USB só funciona no Windows
+### O que o Tauri fornece
-- `service_role_key` no cliente desktop é risco de segurança — usar apenas anon_key + RLS
-- Sem testes automatizados
 
-## Version History
+| Recurso | Como é usado |
+|---------|-------------|
+| **Janela nativa** | A janela do app com barra de título, controls de redimensionar, ícone |
+| **Sistema de arquivos** | Lê/escreve `config.json` e `fechamento.db` em `%LOCALAPPDATA%/FechamentoCaixa/` |
+| **Invocação de comandos Rust** | Frontend JS chama `invoke('nome_comando', args)` → Rust executa e retorna |
+| **HTTP client** | Plugin `supabase.rs` usa `reqwest` para falar com o Supabase |
+| **Shell** | Abre diálogo de impressoras, executa `cmd /C copy` para impressão |
+| **Diálogos nativos** | `tauri_plugin_dialog` para escolher arquivos, pastas, impressora |
 
-- **v1.2.7** — 2026-06-24: 4 bugs críticos concertados (impressão, enviar, dia anterior, localStorage)
+### Comandos Tauri (Rust → JS)
-- **v1.2.6** — 2026-06-24: WebView2Loader.dll incluso; init() restaura operador+turno
+
-- **v1.2.5** — 2026-06-24: diferenca = fechamento - esperado (não mais saldo_troco - esperado)
+O frontend **nunca acessa** Supabase, SQLite ou impressora diretamente. Tudo passa por `invoke`:
+
+```javascript
+// Salvar fechamento (SQLite + Supabase)
+await invoke('salvar_fechamento', { estado });
+
+// Sync com Supabase
+await invoke('sb_salvar_fechamento', { estado });
+
+// Detectar impressora
+await invoke('detectar_impressora');
+
+// Imprimir
+await invoke('imprimir_recibo', { html: reciboHTML });
+```
+
+### Estrutura dos plugins Rust
+
+```
+src-tauri/src/plugins/
+├── app.rs        — Config da app (loja, operador default, sync)
+├── storage.rs    — SQLite local (fonte primária offline)
+├── supabase.rs   — Cliente HTTP para Supabase (service_role JWT)
+├── printer.rs    — Detecção EPSON TM-T20, fallback para window.print()
+└── escpos.rs    — Helpers ESCPOS (alinhamento, negrito, corte)
+```
+
+### Onde os dados ficam
+
+| Dado | Local |
+|------|-------|
+| Config (SUPABASE keys, loja default) | `%LOCALAPPDATA%/FechamentoCaixa/config.json` |
+| Banco SQLite (fechamentos) | `%LOCALAPPDATA%/FechamentoCaixa/fechamento.db` |
+| Rascunho auto-save | `%LOCALAPPDATA%/FechamentoCaixa/fechamento_rascunho.db` |
+
+---
+
+## Autores & Contexto
+
+- **Desenvolvedor:** Filipe.Tavares
+- **Dono das lojas:** O Frangão — União e Aliança
+- **Objetivo:** Substituir planilhas manuais e webhooks n8n por um sistema de fechamento de caixa confiável e offline-first

SUPABASE_SCHEMA.md

@@ -0,0 +1,142 @@
+# Schema do Supabase — Fechamento de Caixa
+
+## Servidor
+
+- **URL:** `https://supabase.ofrangao.com.br`
+- **Instância:** O Frangão — PostgreSQL hospedado
+
+---
+
+## Tabela principal: `fechamentos_web`
+
+```sql
+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`
+
+```json
+{
+  "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:
+
+1. **Anon (chave pública):** pode ler registros
+2. **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
+
+```http
+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.
+
+```json
+// config.json (opcional — sobrepõe a embedada)
+{
+  "SUPABASE_ANON_KEY": "sb_publishable_...",
+  "SUPABASE_SERVICE_KEY": "sb_secret_..."
+}
+```

src-tauri/src/main.rs

@@ -111,6 +111,7 @@ fn main() {
             plugins::printer::ativar_modo_teste_impressao,
             // App
             plugins::app::get_loja,
+            plugins::app::get_loja_fixa,
             plugins::app::set_loja,
             plugins::app::get_config,
             plugins::app::set_config,

src-tauri/src/plugins/app.rs

@@ -1,5 +1,8 @@
 //! Plugin de configuração da aplicação (loja, preferências)
 //! Persistido em config.json ao lado do banco SQLite.
+//!
+//! LOJA_FIXA: definido em tempo de build via env DOBRADO_LOJA (Uniao | Alianca).
+//! Quando definido, a loja é travada e o seletor do formulário fica desabilitado.
 
 use serde::{Deserialize, Serialize};
 use std::fs;
@@ -7,6 +10,9 @@ use std::path::PathBuf;
 use std::sync::Mutex;
 use tauri::State;
 
+/// Indica se a loja foi fixada em tempo de build.
+pub const LOJA_FIXA: Option<&'static str> = option_env!("DOBRADO_LOJA");
+
 #[derive(Debug, Serialize, Deserialize, Clone)]
 pub struct AppConfig {
     pub loja: String,
@@ -15,17 +21,28 @@ pub struct AppConfig {
     pub turno_default: String,
     pub sync_automatico: bool,
     pub auto_open_printer: bool,
+    /// Verdadeiro quando a build tem loja fixa (não permite trocar no formulário)
+    #[serde(skip_serializing_if = "Option::is_none")]
+    pub loja_fixa: Option<bool>,
+}
+
+impl AppConfig {
+    /// Loja padrão: o env DOBRADO_LOJA se existir, senão "Uniao"
+    pub fn default_loja() -> String {
+        LOJA_FIXA.unwrap_or("Uniao").to_string()
+    }
 }
 
 impl Default for AppConfig {
     fn default() -> Self {
         Self {
-            loja: "Uniao".to_string(),
+            loja: Self::default_loja(),
             pdv_nome: "PDV-01".to_string(),
             operador_default: String::new(),
             turno_default: String::new(),
             sync_automatico: true,
             auto_open_printer: false,
+            loja_fixa: LOJA_FIXA.map(|_| true),
         }
     }
 }
@@ -65,8 +82,17 @@ pub fn get_loja(state: State<'_, AppState>) -> String {
     state.config.lock().unwrap().loja.clone()
 }
 
+#[tauri::command]
+pub fn get_loja_fixa() -> Option<String> {
+    LOJA_FIXA.map(|s| s.to_string())
+}
+
 #[tauri::command]
 pub fn set_loja(state: State<'_, AppState>, loja: String) -> Result<(), String> {
+    // Se loja_fixa está ativa, não permite alterar
+    if LOJA_FIXA.is_some() {
+        return Err("Loja fixa em tempo de build — não é possível trocar.".to_string());
+    }
     state.config.lock().unwrap().loja = loja;
     state.save()
 }

src-tauri/src/plugins/printer.rs

@@ -322,9 +322,9 @@ impl ReciboData {
         out.extend(escpos::divider());
 
         // ── DIFERENÇA ──
-        // Diferença = total_fechamento - saldo_esperado - cancelamentos
+        // Diferença = TOTAL SISTEMA - saldo_esperado - cancelamentos
         out.extend(escpos::line_bold("DIFERENCA"));
-        let diff = self.fechamento - self.saldo_esperado - self.cancelamentos;
+        let diff = self.sys_total - self.saldo_esperado - self.cancelamentos;
         let diff_str = if diff >= 0.0 {
             format!("+{}", self.fmt_money(diff))
         } else {

src-tauri/src/plugins/supabase.rs

@@ -248,27 +248,60 @@ impl SupabaseClient {
         }
     }
 
-    /// Atualiza campos específicos de um fechamento pelo id numérico (pk) ou UUID.
+    /// Atualiza campos específicos de um fechamento pelo id_fechamento.
-    pub fn atualizar_fechamento(&self, id: Option<i64>, uuid: &str, updates: &serde_json::Value) -> Result<Value, SupabaseError> {
+    pub fn atualizar_fechamento(&self, id_fechamento: &str, updates: &serde_json::Value) -> Result<Value, SupabaseError> {
-        // Se temos id numerico, usa id=eq.; senao usa id=eq.UUID
+        // Campos que o frontend envia mas NÃO existem como colunas na tabela.
-        let url = if let Some(num) = id {
+        // Arrays e objetos são guardados no JSONB `dados` — não em colunas escalar.
-            format!("{}/rest/v1/fechamentos_web?id=eq.{}", self.base_url, num)
+        static BLOCKED: &[&str] = &[
-        } else {
+            "id", "uuid", "criado_em", "atualizado_em", "enviado_por",
-            format!("{}/rest/v1/fechamentos_web?id=eq.{}", self.base_url, uuid)
+            "ip_origem", "user_agent", "id_fechamento",
-        };
+            // arrays e objetos que existem dentro do JSONB `dados`
+            "vales", "despesas", "sangrias", "cancelamentos",
+            "pixcnpj", "receber",
+            "cartoes_credito", "cartoes_debito",
+            "cartoes_alimentacao", "cartoes_pix",
+        ];
+
+        let map = updates.as_object().cloned().unwrap_or_default();
+
+        // Remove campos bloqueados
+        let filtered: serde_json::Map<String, serde_json::Value> = map
+            .into_iter()
+            .filter(|(k, _)| !BLOCKED.contains(&k.as_str()))
+            .collect();
+
+        if filtered.is_empty() {
+            return Err(SupabaseError::Api("Nenhum campo para atualizar".into()));
+        }
+
+        let url = format!(
+            "{}/rest/v1/fechamentos_web?id_fechamento=eq.{}",
+            self.base_url,
+            urlencoding::encode(id_fechamento)
+        );
+
+        log::info!("[PATCH] url={} body={:#?}", url, filtered);
 
         let resp = self
             .http
             .patch(&url)
             .headers(self.headers(true))
-            .json(updates)
+            .header("Prefer", "return=representation")
+            .json(&filtered)
             .send()?;
 
-        if resp.status().is_success() {
+        let status = resp.status();
-            Ok(serde_json::json!({ "ok": true, "id": id.unwrap_or(0) }))
+        if status.is_success() {
+            // Ler a resposta real do Supabase (retorna o registro atualizado)
+            if let Ok(ret) = resp.json::<serde_json::Value>() {
+                log::info!("[PATCH] sucesso — resposta: {}", ret);
+            } else {
+                log::warn!("[PATCH] sucesso mas não conseguiu ler resposta");
+            }
+            Ok(serde_json::json!({ "ok": true, "id_fechamento": id_fechamento }))
         } else {
-            let status = resp.status();
             let body = resp.text().unwrap_or_default();
+            log::error!("[PATCH] HTTP {} body: {}", status.as_u16(), body);
             Err(SupabaseError::Api(format!(
                 "HTTP {}: {}",
                 status.as_u16(),
@@ -279,7 +312,7 @@ impl SupabaseClient {
     pub fn listar_recentes(&self, loja: &str, limite: i64) -> Result<Vec<Value>, SupabaseError> {
         let loja_normalized = sem_acento(&loja.to_lowercase());
         let url = format!(
-            "{}/rest/v1/fechamentos_web?loja=eq.{}&order=data.desc,atualizado_em.desc&limit={}&select=id,id_fechamento,data,operador,turno,saldo_troco,saldo_esperado,fechamento_dinheiro,fechamento_cartoes,fechamento_areceber,diferenca,status_diferenca,observacoes,atualizado_em",
+            "{}/rest/v1/fechamentos_web?loja=eq.{}&order=data.desc,atualizado_em.desc&limit={}&select=id,id_fechamento,data,operador,turno,saldo_troco,saldo_credito,saldo_debito,saldo_alimentacao,saldo_vales,saldo_areceber,saldo_esperado,total_pixcnpj,total_cartao_credito,total_cartao_debito,total_cartao_alimentacao,total_cartao_pix,total_cancelamentos,fechamento_dinheiro,fechamento_cartoes,fechamento_areceber,diferenca,status_diferenca,observacoes,atualizado_em,dados",
             self.base_url,
             urlencoding::encode(&loja_normalized),
             limite,
@@ -504,16 +537,13 @@ pub fn sb_buscar_por_id_fechamento(
     sb.buscar_por_id_fechamento(&id_fechamento)
 }
 
-#[tauri::command]
+#[tauri::command(rename_all = "snake_case")]
 pub fn sb_atualizar_fechamento(
     sb: State<'_, SupabaseClient>,
-    id: String,
+    id_fechamento: String,
     updates: serde_json::Value,
 ) -> Result<serde_json::Value, SupabaseError> {
-    // Tenta primeiro como i64 (id numerico), depois como String (UUID)
+    sb.atualizar_fechamento(&id_fechamento, &updates)
-    let id_i64 = id.parse::<i64>().ok();
-    let id_str = &id;
-    sb.atualizar_fechamento(id_i64, id_str, &updates)
 }
 
 #[tauri::command]