Fechamento de Caixa — O Frangão

O que é

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.

Ideia central

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 (Rust + WebView2)
Dados local	SQLite via rusqlite
Dados cloud	Supabase — 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)
├── src-tauri/
│   ├── src/
│   │   ├── main.rs       ← Entry point + plugin initialization
│   │   └── plugins/
│   │       ├── app.rs      ← Config da app (loja, PDV, sync)
│   │       ├── storage.rs  ← SQLite local
│   │       ├── supabase.rs ← Sync com Supabase
│   │       ├── printer.rs  ← Impressão
│   │       └── escpos.rs   ← Helpers ESCPOS
│   └── tauri.conf.json   ← Config Tauri (janela, bundle, etc.)
├── SPEC.md              ← Este arquivo
├── 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

---

Builds — 3 versões do app

O mesmo código gera 3 binários diferentes conforme a variável de ambiente DOBRADO_LOJA:

Binário	Loja	Como buildar
fc-uniao.exe	Travada: UNIÃO	DOBRADO_LOJA=Uniao cargo build --release --target x86_64-pc-windows-gnu
fc-alianca.exe	Travada: ALIANÇA	DOBRADO_LOJA=Alianca cargo build --release --target x86_64-pc-windows-gnu
fc-ambos.exe	Livre (União / Aliança)	cargo build --release --target x86_64-pc-windows-gnu (sem env)

Quando a loja é fixa, o seletor de loja no formulário é escondido via JavaScript e tentativas de mudar via API retornam erro.

---

Fluxo de um fechamento

1. Operador abre o app
   ↓
2. Seleciona Data, Operador, Turno, Loja (se não for fixa)
   ↓
3. Preenche os campos:
   - Saldo de Troy
   - Cartões (crédito, débito, alimentação, PIX) — um valor por vez
   - Despesas (descrição + valor)
   - Sangrias (hora + gerente + valor)
   - PIX CNPJ (nome + valor)
   - 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

---

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