Aplicação desktop Electron para rastreamento de produção e análise de custos de tinta Mimaki RasterLink6Plus.
- Frontend: React 18 + TypeScript + TailwindCSS + React Query
- Backend: Electron 30 + Node.js
- Watch de arquivos: chokidar (detecção em tempo real de jobs novos)
- Database: SQLite (better-sqlite3 + Drizzle ORM)
- Build: electron-vite + electron-builder
- Charts: Recharts
- Tests: Vitest (39 testes) + Playwright (E2E)
- Auto-update: electron-updater (GitHub Releases)
mimaki-tracker/
├── src/
│ ├── main/ # Processo principal (Node.js)
│ │ ├── db/ # Schema SQLite, migrações, CRUD
│ │ │ ├── database.ts
│ │ │ ├── schema.ts # Drizzle ORM
│ │ │ └── migrations.ts
│ │ ├── ipc/ # Handlers IPC (main ↔ renderer)
│ │ │ └── handlers.ts
│ │ ├── parser/ # Parsers XML do RasterLink
│ │ │ ├── xmlParser.ts
│ │ │ └── xmlParser.test.ts
│ │ ├── sync/ # Sincronização automática
│ │ │ ├── syncer.ts # Checkpoint + incomplete_folders
│ │ │ ├── scheduler.ts # Cron 15 min (safety net)
│ │ │ ├── watcher.ts # Watch chokidar em tempo real
│ │ │ ├── discovery.ts # Descoberta UDP do GraficaOS
│ │ │ └── *.test.ts
│ │ ├── export/ # Exportação XLSX e API
│ │ │ ├── excelExport.ts
│ │ │ ├── apiSync.ts # M2M GraficaOS (1 job/POST)
│ │ │ └── *.test.ts
│ │ ├── updater.ts # Auto-update via GitHub Releases
│ │ └── index.ts # Entry point do Electron (tray + single-instance)
│ ├── preload/ # Bridge seguro (contextBridge)
│ │ └── index.ts
│ └── renderer/ # Frontend React
│ └── src/
│ ├── components/
│ │ ├── layout/ # TopBar (status GraficaOS), Sidebar
│ │ ├── ui/ # Skeleton, StatCard
│ │ └── dev/ # Terminal de desenvolvimento
│ ├── hooks/ # React Query hooks
│ ├── pages/ # Dashboard, JobsList, JobDetail, Settings, MonthlyReport
│ ├── lib/ # QueryClient config
│ ├── types/ # TypeScript interfaces
│ └── App.tsx # Router + lazy loading
├── mock-graficaos/ # Servidor mock (UDP+HTTP) e smoke test do pipeline M2M
│ ├── server.js
│ └── smoke-test.js
├── docs/ # Planos de features (ex.: PLAN-metadata-file-parser.md)
├── e2e/ # Testes E2E (Playwright)
├── tests/fixtures/ # Fixtures XML para testes
├── watcher-m2m-pipeline.md # Documentação do pipeline watcher/M2M
└── electron-builder.yml # Configuração de build
# Desenvolvimento
npm run dev
# Build production
npm run build
# Empacotar (build + electron-builder)
npm run package
# Testes unitários
npm run test
# Testes E2E
npm run test:e2e
# Testes E2E com UI
npm run test:e2e:ui
# Mock GraficaOS (testar o pipeline M2M localmente)
node mock-graficaos/server.js
node mock-graficaos/smoke-test.jsAcesse o terminal de desenvolvimento pressionando Shift+T.
| Comando | Descrição |
|---|---|
help |
Lista todos os comandos |
version |
Mostra versão do app |
show-db-path |
Mostra caminho do banco de dados |
reset-checkpoint |
Reseta checkpoint de sincronização |
re-sync |
Força re-sincronização completa |
reprocess-copy |
Reprocessa copy_number de jobs existentes |
resend-graficaos |
Marca todos os jobs para reenvio à GraficaOS (synced_to_api = 0); o próximo ciclo automático reenvia |
clear-db |
Limpa o banco de dados (requer confirmação) |
export-db |
Exporta cópia do banco de dados |
open-data-folder |
Abre a pasta de dados no explorador |
- Produção: Terminal protegido por senha (SHA-256 hashed)
- 3 tentativas falhas: Bloqueio por 5 minutos
- Desenvolvimento: Acesso direto sem senha
Senha do terminal (produção):
dpi@2026A senha é predefinida e atualizada automaticamente a cada release instalado (o app compara a versão em
settings.dev_password_versioncom a versão atual e redefine o hash dedpi@2026no boot). Ela é armazenada apenas como hash SHA-256 (settings.dev_terminal_password_hash).Para redefinir manualmente (com o app fechado):
- Localize o
mimaki.db— em produção fica em%APPDATA%\DPI Mimaki Tracker\mimaki.db(no dev, o comandoshow-db-pathmostra o caminho exato).- Abra-o com um editor SQLite e execute:
DELETE FROM settings WHERE key = 'dev_terminal_password_hash';- Inicie o app e abra o terminal (Shift+T) — a senha voltará a ser
dpi@2026.
O app verifica atualizações automaticamente via GitHub Releases.
- Crie um release no GitHub com tag
v2.6.2 - Adicione os arquivos de build como assets
- O app detecta e instala atualizações automaticamente
- Verificação a cada 4 horas (via setTimeout recursivo)
- Download em background
- Notificação ao usuário
- Reinicialização para instalar
CREATE TABLE jobs (
id INTEGER PRIMARY KEY AUTOINCREMENT,
folder_timestamp TEXT UNIQUE NOT NULL,
job_name TEXT,
order_code TEXT,
quantity_units INTEGER,
ink_cyan_cc REAL,
ink_magenta_cc REAL,
ink_yellow_cc REAL,
ink_black_cc REAL,
ink_white1_cc REAL,
ink_white2_cc REAL,
ink_varnish1_cc REAL,
ink_varnish2_cc REAL,
ink_total_cc REAL,
print_time_ms INTEGER,
rip_time_ms INTEGER,
width_mm REAL,
height_mm REAL,
spool_date TEXT,
last_print_date TEXT,
pages INTEGER,
copy_number INTEGER,
total_print INTEGER,
pass_count INTEGER,
resolution_dpi INTEGER,
print_direction TEXT,
raw_xml_path TEXT,
raw_material_name TEXT,
synced_to_api INTEGER DEFAULT 0,
created_at TEXT DEFAULT (datetime('now'))
);
CREATE TABLE incomplete_folders (
folder_timestamp TEXT PRIMARY KEY,
created_at TEXT DEFAULT (datetime('now'))
);- Migrações automáticas ao iniciar
INSERT OR REPLACEpara jobs existentes- Auto-migração de path com
\Elmpara path correto - Migração automática das chaves legadas
next_api_url/next_api_keyparagraficaos_api_url/mimaki_secret_code; defaultmachine_id = "MIMAKI_JV300"
O app usa chokidar para vigiar as pastas Elm, Cmp e Lay do RasterLink em tempo real (substituiu o polling cego):
- XML novo em qualquer pasta relevante dispara um ciclo de sincronização após debounce de 5s (
awaitWriteFinish) - O ciclo roda
runSync()e, se houver jobs novos, envia à API GraficaOS automaticamente - Se o caminho da pasta RasterLink mudar nas configurações, o watcher é reiniciado automaticamente (verificação a cada 15s)
- Coexiste com o cron de 15 minutos (safety net); o mutex protege contra execução concorrente
- Clique em "Sincronizar Agora" na TopBar
- Atalho: Shift+T (apenas no dev)
- Watcher chokidar em tempo real (debounce 5s)
- Cron a cada 15 minutos como safety net
- Concorrência bloqueada (flag
isSyncing) - Notificação via IPC
sync:completed
O checkpoint avançou para o maior folder escaneado. Jobs cujo LayoutDir.xml ainda não foi gerado não são mais perdidos:
- Pasta incompleta → registrada em
incomplete_folders - Próximo ciclo processa:
incomplete ∪ folders > checkpoint - Quando o Layout chega, o job é inserido e a pasta sai da lista de pendentes
Os XMLs são correlacionados por IDs (não por timestamps de pasta):
ElementDir.xml → CompositeDir.xml (via elementID)
→ LayoutDir.xml (via compositeID)
O campo raw_material_name é extraído best-effort dos XMLs, nesta ordem de precedência:
CompositeDir.xml→mediaNamepropertyMapdoElementDir.xml(chavesMedia,MediaName,MaterialName, etc.)deviceProfileNameno XMLnull(nenhum candidato encontrado)
O app sincroniza os jobs com o GraficaOS Server (máquina para máquina).
- Automática (UDP): broadcast
GRAFICAOS_DISCOVERna porta41234(inclui sonda local127.0.0.1para mock/servidor na mesma máquina), timeout de 3s; a resposta{name, ip, port}é cacheada - Fallback manual: IP (
graficaos_manual_ip) ou URL base (graficaos_api_url) configurados nas Configurações sempre vencem a descoberta - Invalidação: em erro de conexão (
ECONNREFUSED,ENOTFOUND, etc.) o cache é invalidado e uma nova descoberta é tentada no próximo ciclo
- 1 job por requisição POST em
${base}/api/integrations/mimaki/jobs - Payload conforme spec:
machine_id,folder_timestamp,job_name,order_code,quantity_units,pages,width_mm,height_mm,ink_*_cc(8 canais + total),raw_material_name,copy_number,total_print,pass_count,resolution_dpi,print_direction - Headers:
X-API-SecreteAuthorization: Bearer(enviados juntos) synced_to_api = 1apenas quando a API responde 200/201; falhas/timeouts (30s) mantêm o job pendente- Timeout de 30s por requisição (AbortController)
| Chave | Descrição | Default |
|---|---|---|
mimaki_secret_code |
Secret enviado como X-API-Secret + Bearer |
— |
graficaos_manual_ip |
IP manual (fallback quando a descoberta falha) | — |
graficaos_api_url |
URL base completa (fallback) | — |
machine_id |
Identificador da máquina no payload | MIMAKI_JV300 |
Chaves legadas (next_api_url/next_api_key) são migradas automaticamente na inicialização.
- TopBar: chip de status da conexão (Conectado / Buscando / Offline)
- Contador de jobs pendentes de envio
- Botão "Reenviar Pendentes": retry manual (descoberta fresca + envio imediato)
Suba o mock e rode o smoke test para validar o pipeline:
node mock-graficaos/server.js # UDP 41234 + HTTP 3001
node mock-graficaos/smoke-test.js # descobre o servidor e envia um job de testeO app roda em background com ícone na bandeja do sistema:
- Fechar (X) minimiza para a bandeja (não encerra)
- Menu do tray: Abrir Mimaki Tracker / Forçar Sincronização / Sair
- Single-instance: duas instâncias são bloqueadas (evita conflito no SQLite); a segunda tenta focar a primeira
- Watcher e cron continuam importando jobs com a janela oculta
Sairencerra o app de verdade (fecha banco, watcher, scheduler e auto-updater)
Formato que espelha a planilha Consumo Mimaki.xlsx:
| Coluna | Descrição |
|---|---|
| Nome | Nome do job |
| Resolução | 600x600 VD |
| Passadas | Número de passadas |
| Direção da impressão | Unidirecional/Bidirecional |
| C, M, Y, K, B, B2, V, V3 | Tinta por canal (cc) |
| Total | Total de tinta (cc) |
| Tempo | Tempo de impressão |
| Tamanho | Largura x Altura (mm) |
| Pagina | Número de páginas |
MIT