Compare commits
75 Commits
| Author | SHA1 | Date | |
|---|---|---|---|
| 275d92abe6 | |||
| 237ceab042 | |||
| 73c20272e5 | |||
| 56a2ed5d31 | |||
| acb90f093d | |||
| 6eb08b6bd4 | |||
| 5a0126417c | |||
| 733519e1d3 | |||
| 6440b262cc | |||
| 420e104df7 | |||
| b04e5acfd6 | |||
| 65c444ad09 | |||
| 2bfbf29ccb | |||
| cbe2c22440 | |||
| 1dc278dbbd | |||
| c2c9a29247 | |||
| 659d9779b3 | |||
| 5c9cb1905b | |||
| a2d3dcc366 | |||
| 12e3d081a7 | |||
| ad967bf0a1 | |||
| d39cc7518b | |||
| 52bec03988 | |||
| 9639048bf7 | |||
| b1585af3f9 | |||
| 155782f50a | |||
| 16972f4734 | |||
| d3d5c4fbca | |||
| 5f1d9a4e2f | |||
| cc45ed9df7 | |||
| 378a589572 | |||
| 50b0ba4498 | |||
| 7154901ce3 | |||
| 8b24a06496 | |||
| 3058908b37 | |||
| 9b1d45ae50 | |||
| fbed0e57c2 | |||
| 362a76961b | |||
| 7a3a4b221b | |||
| 94bb8840ea | |||
| dba7eb3856 | |||
| 7b3b7a9f1d | |||
| 5641de21f8 | |||
| d77ad55fbd | |||
| 4a5cae8f2f | |||
| 313c740470 | |||
| d21cb0a98d | |||
| 16bee1eacb | |||
| c8016f076d | |||
| b1a9f94231 | |||
| 42aadcca2c | |||
| a8319d96a6 | |||
| bf878545b3 | |||
| 22cda312cf | |||
| d112ad061e | |||
| be917f8fb7 | |||
| cb48afeb9c | |||
| 2b8ff711ed | |||
| 9a4ccabd1b | |||
| 32728eec37 | |||
| 905ca253d7 | |||
| d89b79a3f8 | |||
| c4dda7e2e5 | |||
| 662f3681a5 | |||
| a56d7188f2 | |||
| 7e1ee6bc04 | |||
| 6a8881d41d | |||
| 3b3eb1a4cc | |||
| c7109b1017 | |||
| f45d1e8170 | |||
| 8ea5ba771a | |||
| 84578fe43d | |||
| 3e94789cb0 | |||
| 292d0b85d9 | |||
| a8edab029d |
@@ -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.
|
||||||
+209
@@ -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).
|
||||||
@@ -0,0 +1,164 @@
|
|||||||
|
# Histórico do Projeto — Fechamento de Caixa O Frangão
|
||||||
|
|
||||||
|
## Contexto
|
||||||
|
|
||||||
|
**Dono:** Filipe.Tavares — O Frangão (lojas União e Aliança)
|
||||||
|
**Problema original:** Planilhas manuais + webhooks n8n frágeis para registrar fechamento de caixa
|
||||||
|
**Solução:** App desktop Tauri 2 + SQLite offline + Supabase cloud + impressão térmica 80mm
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Repositório
|
||||||
|
|
||||||
|
```
|
||||||
|
https://git.ofrangao.com.br/filipe/fechamento-caixa
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 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`) |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Releases
|
||||||
|
|
||||||
|
| Tag | Data | Descrição |
|
||||||
|
|-----|------|-----------|
|
||||||
|
| `v2.0.4-alianca` | 2026-07-05 | Fix preview modal re-open + sys_total recalc |
|
||||||
|
| `v2.0.3-uniao` | 2026-07-05 | Fix diferença cálculo from array |
|
||||||
|
| `v2.0.2-uniao` | 2026-07-05 | Fix buildPrintHTML sys_total |
|
||||||
|
| `v2.0.1-uniao` | 2026-07-05 | Builds separadas + docs |
|
||||||
|
| `v2.0.0-uniao/alianca/ambos` | 2026-07-04 | Lançamento — app completo com Tauri 2 |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Bugs Corrigidos (desde v2.0.0)
|
||||||
|
|
||||||
|
### Preview + Modal (v2.0.4)
|
||||||
|
- **237ceab** — `confirm-print` não fechava mais o modal antes de abrir o preview; `openPrintPreview` reabria o modal ao fechar se ele ainda estava aberto
|
||||||
|
- **73c2027** — `closeConfirmModal()` era chamada antes de `openPrintPreview()` — preview cobria o modal, mas ao fechar voltava pro form
|
||||||
|
- **56a2ed5** — `buildPrintHTML` usava `data.diferenca` (precomputado, stale) em vez de recalcular `sys_total - saldo_esperado - cancelamentos` inline
|
||||||
|
|
||||||
|
### Cálculo da Diferença (v2.0.3)
|
||||||
|
- **acb90f0** — `diferenca` sempre recalculada da array de cancelamentos (não do escalar `total_cancelamentos`)
|
||||||
|
- **6eb08b6** — mesmo fix em `buildReportHTML`, `buildPrintHTML`, `buildConfirmHTML`
|
||||||
|
- **5a01264** — ignora `data.diferenca` pré-computado, recalcula sempre de `sys_total`
|
||||||
|
|
||||||
|
### Rust ESCPOS (v2.0.3)
|
||||||
|
- **733519e** — Rust `to_escpos`: diferença = `sys_total - saldo_esperado - total_cancelamentos` (não mais `fechamento`)
|
||||||
|
|
||||||
|
### CSS / Layout (v2.0.2)
|
||||||
|
- **6440b26** — `buildReportHTML`: diferença = `sysTotal - saldoEsp - cancelamentos`
|
||||||
|
- **420e104** — `buildConfirmHTML` e `buildPrintHTML` usavam `sysTotal`/`total_cancelamentos` em vez de `sys_total`/`cancelamentos`
|
||||||
|
- **b04e5ac** — `.main min-height:0` (footer invisível em resoluções pequenas)
|
||||||
|
- **65c444a** — seletor loja escondia errado (caracteres asiáticos no DOM)
|
||||||
|
- **2bfbf29** — values das options de loja sem acento (`Uniao`/`Alianca`) — alinhado com `LOJA_FIXA` do Rust
|
||||||
|
|
||||||
|
### Impressão (v2.0.1)
|
||||||
|
- **b1585af / 155782f / 16972f4 / d3d5c4f** — fonte 18px→22px bold nos relatórios e preview
|
||||||
|
- **5f1d9a4 / cc45ed9** — botão "Dia Anterior" agora exige senha antes de abrir
|
||||||
|
|
||||||
|
### Builds (v2.0.0)
|
||||||
|
- **659d977** — `DOBRADO_LOJA` injetado via env no build — 3 binários: `fc-uniao.exe`, `fc-alianca.exe`, `fc-ambos.exe`
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Bugs Pendentes (conhecidos)
|
||||||
|
|
||||||
|
| # | Bug | Prioridade | Status |
|
||||||
|
|---|-----|-----------|--------|
|
||||||
|
| #6 | `salvarEdicaoModal` reconstrói `id_fechamento` dos inputs em vez de usar `full.id_fechamento` — PATCH pode errar se operador mudar loja/data/operador | Média | Pendente |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Arquitetura de Dados
|
||||||
|
|
||||||
|
### SQLite local (offline-first)
|
||||||
|
```
|
||||||
|
%LOCALAPPDATA%/FechamentoCaixa/fechamento.db
|
||||||
|
```
|
||||||
|
|
||||||
|
### Supabase cloud
|
||||||
|
```
|
||||||
|
https://supabase.ofrangao.com.br
|
||||||
|
Tabela: fechamentos_web
|
||||||
|
```
|
||||||
|
|
||||||
|
### Fluxo de sync
|
||||||
|
```
|
||||||
|
App abre → carrega rascunho do SQLite → operador trabalha offline
|
||||||
|
↓
|
||||||
|
operador clica "Salvar/Sincronizar"
|
||||||
|
↓
|
||||||
|
1. Salva em SQLite local
|
||||||
|
2. Envia para Supabase (se online)
|
||||||
|
↓
|
||||||
|
operador clica "Imprimir"
|
||||||
|
↓
|
||||||
|
window.print() → receipt 80mm
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Comandos Tauri (frontend chama via `invoke`)
|
||||||
|
|
||||||
|
| Comando | Descrição |
|
||||||
|
|---------|-----------|
|
||||||
|
| `salvar_fechamento` | Salva estado no SQLite local |
|
||||||
|
| `carregar_rascunho` | Carrega rascunho por loja+data |
|
||||||
|
| `sb_salvar_fechamento` | POST para Supabase |
|
||||||
|
| `sb_listar_recentes` | Lista fechamentos recentes |
|
||||||
|
| `sb_buscar_por_id` | Busca por ID numérico |
|
||||||
|
| `sb_buscar_por_uuid` | Busca por UUID |
|
||||||
|
| `detectar_impressora` | Detecta EPSON TM-T20 |
|
||||||
|
| `imprimir_recibo` | Imprime via ESCPOS ou fallback window.print() |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Builds — 3 versões
|
||||||
|
|
||||||
|
| Binário | Loja | Seletor |
|
||||||
|
|---------|------|---------|
|
||||||
|
| `fc-uniao.exe` | Fixa: UNIÃO | Escondido |
|
||||||
|
| `fc-alianca.exe` | Fixa: ALIANÇA | Escondido |
|
||||||
|
| `fc-ambos.exe` | Livre | Dropdown visível |
|
||||||
|
|
||||||
|
### Como buildar
|
||||||
|
|
||||||
|
```bash
|
||||||
|
cd src-tauri/
|
||||||
|
|
||||||
|
# UNIÃO
|
||||||
|
DOBRADO_LOJA=Uniao cargo build --release --target x86_64-pc-windows-gnu
|
||||||
|
|
||||||
|
# ALIANÇA
|
||||||
|
DOBRADO_LOJA=Alianca cargo build --release --target x86_64-pc-windows-gnu
|
||||||
|
|
||||||
|
# AMBOS
|
||||||
|
cargo build --release --target x86_64-pc-windows-gnu
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Lições Aprendidas
|
||||||
|
|
||||||
|
1. **Cálculos sempre inline** — nunca usar valores pré-computados (`data.diferenca`, `data.total_cancelamentos`) que podem estar stale. Sempre recalcular da fonte.
|
||||||
|
2. **Fechar modal ANTES de abrir overlay** — se um modal vai ser coberto por outro, fechar primeiro e reabrir depois (salvar estado).
|
||||||
|
3. **Cross-compile Linux→Windows** — funciona perfeitamente com `x86_64-pc-windows-gnu` target.
|
||||||
|
4. **Gitea API** — `Authorization: token {TOKEN}` (minúsculo `token`) funciona; `Token {TOKEN}` não. Upload de assets funciona; DELETE de assets retorna 404 (bug do Gitea?).
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Autores
|
||||||
|
|
||||||
|
- **Filipe.Tavares** — dono das lojas / demandante
|
||||||
|
- **Hermes Agent** — desenvolvimento + debugging
|
||||||
@@ -1,140 +1,192 @@
|
|||||||
# Fechamento de Caixa — O Frangão
|
# 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/
|
fechamento-caixa/
|
||||||
├── src/
|
├── src/
|
||||||
│ └── index.html # Frontend completo (HTML + CSS + JS inline)
|
│ └── index.html ← Frontend completo (HTML + CSS + JS)
|
||||||
├── src-tauri/
|
├── 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
|
||||||
|
|||||||
@@ -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_..."
|
||||||
|
}
|
||||||
|
```
|
||||||
@@ -111,6 +111,7 @@ fn main() {
|
|||||||
plugins::printer::ativar_modo_teste_impressao,
|
plugins::printer::ativar_modo_teste_impressao,
|
||||||
// App
|
// App
|
||||||
plugins::app::get_loja,
|
plugins::app::get_loja,
|
||||||
|
plugins::app::get_loja_fixa,
|
||||||
plugins::app::set_loja,
|
plugins::app::set_loja,
|
||||||
plugins::app::get_config,
|
plugins::app::get_config,
|
||||||
plugins::app::set_config,
|
plugins::app::set_config,
|
||||||
|
|||||||
@@ -1,5 +1,8 @@
|
|||||||
//! Plugin de configuração da aplicação (loja, preferências)
|
//! Plugin de configuração da aplicação (loja, preferências)
|
||||||
//! Persistido em config.json ao lado do banco SQLite.
|
//! 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 serde::{Deserialize, Serialize};
|
||||||
use std::fs;
|
use std::fs;
|
||||||
@@ -7,6 +10,9 @@ use std::path::PathBuf;
|
|||||||
use std::sync::Mutex;
|
use std::sync::Mutex;
|
||||||
use tauri::State;
|
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)]
|
#[derive(Debug, Serialize, Deserialize, Clone)]
|
||||||
pub struct AppConfig {
|
pub struct AppConfig {
|
||||||
pub loja: String,
|
pub loja: String,
|
||||||
@@ -15,17 +21,28 @@ pub struct AppConfig {
|
|||||||
pub turno_default: String,
|
pub turno_default: String,
|
||||||
pub sync_automatico: bool,
|
pub sync_automatico: bool,
|
||||||
pub auto_open_printer: 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 {
|
impl Default for AppConfig {
|
||||||
fn default() -> Self {
|
fn default() -> Self {
|
||||||
Self {
|
Self {
|
||||||
loja: "Uniao".to_string(),
|
loja: Self::default_loja(),
|
||||||
pdv_nome: "PDV-01".to_string(),
|
pdv_nome: "PDV-01".to_string(),
|
||||||
operador_default: String::new(),
|
operador_default: String::new(),
|
||||||
turno_default: String::new(),
|
turno_default: String::new(),
|
||||||
sync_automatico: true,
|
sync_automatico: true,
|
||||||
auto_open_printer: false,
|
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()
|
state.config.lock().unwrap().loja.clone()
|
||||||
}
|
}
|
||||||
|
|
||||||
|
#[tauri::command]
|
||||||
|
pub fn get_loja_fixa() -> Option<String> {
|
||||||
|
LOJA_FIXA.map(|s| s.to_string())
|
||||||
|
}
|
||||||
|
|
||||||
#[tauri::command]
|
#[tauri::command]
|
||||||
pub fn set_loja(state: State<'_, AppState>, loja: String) -> Result<(), String> {
|
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.config.lock().unwrap().loja = loja;
|
||||||
state.save()
|
state.save()
|
||||||
}
|
}
|
||||||
|
|||||||
@@ -322,13 +322,12 @@ impl ReciboData {
|
|||||||
out.extend(escpos::divider());
|
out.extend(escpos::divider());
|
||||||
|
|
||||||
// ── DIFERENÇA ──
|
// ── DIFERENÇA ──
|
||||||
// Diferença = total_fechamento - saldo_esperado - cancelamentos
|
// Usa o valor calculado pelo frontend (já correto)
|
||||||
out.extend(escpos::line_bold("DIFERENCA"));
|
out.extend(escpos::line_bold("DIFERENCA"));
|
||||||
let diff = self.fechamento - self.saldo_esperado - self.cancelamentos;
|
let diff_str = if self.diferenca >= 0.0 {
|
||||||
let diff_str = if diff >= 0.0 {
|
format!("+{}", self.fmt_money(self.diferenca))
|
||||||
format!("+{}", self.fmt_money(diff))
|
|
||||||
} else {
|
} else {
|
||||||
self.fmt_money(diff)
|
self.fmt_money(self.diferenca)
|
||||||
};
|
};
|
||||||
out.extend(escpos::title(&diff_str));
|
out.extend(escpos::title(&diff_str));
|
||||||
|
|
||||||
@@ -528,8 +527,10 @@ pub fn caminho_impressora() -> Option<String> {
|
|||||||
|
|
||||||
#[tauri::command]
|
#[tauri::command]
|
||||||
pub fn imprimir_recibo(data: String) -> Result<usize, String> {
|
pub fn imprimir_recibo(data: String) -> Result<usize, String> {
|
||||||
|
eprintln!("[DEBUG RECIBO JSON] {}", &data[..data.len().min(500)]);
|
||||||
let r: ReciboData =
|
let r: ReciboData =
|
||||||
serde_json::from_str(&data).map_err(|e| format!("Erro ao analisar dados: {}", e))?;
|
serde_json::from_str(&data).map_err(|e| format!("Erro ao analisar dados: {}", e))?;
|
||||||
|
eprintln!("[DEBUG DIFERENCA] self.diferenca={}", r.diferenca);
|
||||||
let bytes = r.to_escpos();
|
let bytes = r.to_escpos();
|
||||||
log::info!("Imprimindo recibo: {} bytes ESC/POS", bytes.len());
|
log::info!("Imprimindo recibo: {} bytes ESC/POS", bytes.len());
|
||||||
PRINTER.imprimir_bytes(&bytes)
|
PRINTER.imprimir_bytes(&bytes)
|
||||||
|
|||||||
@@ -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
|
let resp = self
|
||||||
.http
|
.http
|
||||||
.patch(&url)
|
.patch(&url)
|
||||||
.headers(self.headers(true))
|
.headers(self.headers(true))
|
||||||
.json(updates)
|
.header("Prefer", "return=representation")
|
||||||
|
.json(&filtered)
|
||||||
.send()?;
|
.send()?;
|
||||||
|
|
||||||
if resp.status().is_success() {
|
|
||||||
Ok(serde_json::json!({ "ok": true, "id": id.unwrap_or(0) }))
|
|
||||||
} else {
|
|
||||||
let status = resp.status();
|
let status = resp.status();
|
||||||
|
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 body = resp.text().unwrap_or_default();
|
let body = resp.text().unwrap_or_default();
|
||||||
|
log::error!("[PATCH] HTTP {} body: {}", status.as_u16(), body);
|
||||||
Err(SupabaseError::Api(format!(
|
Err(SupabaseError::Api(format!(
|
||||||
"HTTP {}: {}",
|
"HTTP {}: {}",
|
||||||
status.as_u16(),
|
status.as_u16(),
|
||||||
@@ -279,7 +312,7 @@ impl SupabaseClient {
|
|||||||
pub fn listar_recentes(&self, loja: &str, limite: i64) -> Result<Vec<Value>, SupabaseError> {
|
pub fn listar_recentes(&self, loja: &str, limite: i64) -> Result<Vec<Value>, SupabaseError> {
|
||||||
let loja_normalized = sem_acento(&loja.to_lowercase());
|
let loja_normalized = sem_acento(&loja.to_lowercase());
|
||||||
let url = format!(
|
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,
|
self.base_url,
|
||||||
urlencoding::encode(&loja_normalized),
|
urlencoding::encode(&loja_normalized),
|
||||||
limite,
|
limite,
|
||||||
@@ -504,16 +537,13 @@ pub fn sb_buscar_por_id_fechamento(
|
|||||||
sb.buscar_por_id_fechamento(&id_fechamento)
|
sb.buscar_por_id_fechamento(&id_fechamento)
|
||||||
}
|
}
|
||||||
|
|
||||||
#[tauri::command]
|
#[tauri::command(rename_all = "snake_case")]
|
||||||
pub fn sb_atualizar_fechamento(
|
pub fn sb_atualizar_fechamento(
|
||||||
sb: State<'_, SupabaseClient>,
|
sb: State<'_, SupabaseClient>,
|
||||||
id: String,
|
id_fechamento: String,
|
||||||
updates: serde_json::Value,
|
updates: serde_json::Value,
|
||||||
) -> Result<serde_json::Value, SupabaseError> {
|
) -> 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]
|
#[tauri::command]
|
||||||
|
|||||||
+1014
-252
File diff suppressed because it is too large
Load Diff
Reference in New Issue
Block a user