Skip to content

About

DPI Mimaki Tracker - App desktop de análise de produção Mimaki RasterLink6Plus

Resources

Contributing

Stars

0 stars

Watchers

0 watching

Forks

 
 

Latest commit

 

History

25 Commits

Folders and files

Repository files navigation

DPI Mimaki Tracker

Aplicação desktop Electron para rastreamento de produção e análise de custos de tinta Mimaki RasterLink6Plus.

Tech Stack

  • 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)

Estrutura de Pastas

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

Comandos

# 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.js

Terminal de Desenvolvimento

Acesse o terminal de desenvolvimento pressionando Shift+T.

Comandos disponíveis

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

Segurança

  • 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@2026

A senha é predefinida e atualizada automaticamente a cada release instalado (o app compara a versão em settings.dev_password_version com a versão atual e redefine o hash de dpi@2026 no boot). Ela é armazenada apenas como hash SHA-256 (settings.dev_terminal_password_hash).

Para redefinir manualmente (com o app fechado):

  1. Localize o mimaki.db — em produção fica em %APPDATA%\DPI Mimaki Tracker\mimaki.db (no dev, o comando show-db-path mostra o caminho exato).
  2. Abra-o com um editor SQLite e execute: DELETE FROM settings WHERE key = 'dev_terminal_password_hash';
  3. Inicie o app e abra o terminal (Shift+T) — a senha voltará a ser dpi@2026.

Auto-Update

O app verifica atualizações automaticamente via GitHub Releases.

Configuração

  1. Crie um release no GitHub com tag v2.6.2
  2. Adicione os arquivos de build como assets
  3. O app detecta e instala atualizações automaticamente

Fluxo

  1. Verificação a cada 4 horas (via setTimeout recursivo)
  2. Download em background
  3. Notificação ao usuário
  4. Reinicialização para instalar

Banco de Dados

Schema principal

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

  • Migrações automáticas ao iniciar
  • INSERT OR REPLACE para jobs existentes
  • Auto-migração de path com \Elm para path correto
  • Migração automática das chaves legadas next_api_url/next_api_key para graficaos_api_url/mimaki_secret_code; default machine_id = "MIMAKI_JV300"

Sincronização

Watcher em tempo real

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

Manual

  • Clique em "Sincronizar Agora" na TopBar
  • Atalho: Shift+T (apenas no dev)

Automática

  • 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

Checkpoint e jobs incompletos

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

Correlação XML

Os XMLs são correlacionados por IDs (não por timestamps de pasta):

ElementDir.xml → CompositeDir.xml (via elementID)
                → LayoutDir.xml (via compositeID)

Mídia (raw_material_name)

O campo raw_material_name é extraído best-effort dos XMLs, nesta ordem de precedência:

  1. CompositeDir.xml → mediaName
  2. propertyMap do ElementDir.xml (chaves Media, MediaName, MaterialName, etc.)
  3. deviceProfileName no XML
  4. null (nenhum candidato encontrado)

Integração GraficaOS (M2M)

O app sincroniza os jobs com o GraficaOS Server (máquina para máquina).

Descoberta do servidor

  • Automática (UDP): broadcast GRAFICAOS_DISCOVER na porta 41234 (inclui sonda local 127.0.0.1 para 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

Envio de jobs

  • 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-Secret e Authorization: Bearer (enviados juntos)
  • synced_to_api = 1 apenas quando a API responde 200/201; falhas/timeouts (30s) mantêm o job pendente
  • Timeout de 30s por requisição (AbortController)

Configurações

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.

UI

  • 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)

Testando localmente

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 teste

Tray e Background

O 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
  • Sair encerra o app de verdade (fecha banco, watcher, scheduler e auto-updater)

Exportação XLSX

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

Licença

MIT

About

DPI Mimaki Tracker - App desktop de análise de produção Mimaki RasterLink6Plus

Resources

Contributing

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages