diff --git a/docs/ROADMAP.md b/docs/ROADMAP.md index 92999aa..669ea3b 100644 --- a/docs/ROADMAP.md +++ b/docs/ROADMAP.md @@ -934,7 +934,23 @@ print-file evidence still need correction before this item can close. and fictional orders. The payment step has no screenshot until Mercado Pago is configured, and the guides name the provisional Kanban domain; regenerate them when either changes. Early work toward Week 3's "orientação à operação". -- `[ ]` Week-2 client report, due end of day 2026-09-25. +- `[x]` Operator guide rebuilt from a committed source (2026-09-25): + `docs/guias/operador/` (HTML and the original screenshots, cropped as + before), printed by `docs/guias/imprimir.sh`. The source of the 09-24 PDF + was never committed. Corrected: stage moves do not update Tiny (only + "Aprovada" and, for pickup, "Pronto para envio", once enabled); WhatsApp + notices go through the client's Tiny -> n8n flow; the correction notice is + not automatic, the reason is in Minha conta; the Tiny card's renewal, + "Verificar" and "Testar conexão" checks. Found while writing it: the + customer's order history showed operators' internal reasons for moving an + order back; it now omits back moves and shows reasons only for corrections. + The Site guide's source is also not in the repository. +- `[x]` Week-2 client report (`Relatorio-Semana-2-DTF.docx`), written 2026-09-25, + sent 2026-09-28. Before sending, the FlexiPRINT import was taken out of + "O que falta" (it is done this week) and the print-file paragraph no longer + names PSD, AI, CDR or multi-page PDFs as hand-preparation cases: generating + those is Week 3 work (1.4). Freight is reported as Jadlog data received, + waiting on packaging weight and dimensions and the charging policy. - `[x]` Week-1 client report (`Relatorio-Semana-1-DTF.docx`), corrected 2026-09-18 to remove the inaccurate "Arquivo por metro permanece separado, com seleção explícita" claim and the internal commit reference. diff --git a/docs/guia-operador-kanban.pdf b/docs/guia-operador-kanban.pdf index dd623f1..ae8d02c 100644 Binary files a/docs/guia-operador-kanban.pdf and b/docs/guia-operador-kanban.pdf differ diff --git a/docs/guias/imprimir.sh b/docs/guias/imprimir.sh new file mode 100755 index 0000000..d496738 --- /dev/null +++ b/docs/guias/imprimir.sh @@ -0,0 +1,8 @@ +#!/bin/sh +# Print the guide sources in docs/guias/ to the PDFs in docs/ with headless +# Chrome (A4, no browser header or footer). Needs Chrome and the DejaVu fonts. +set -eu +cd "$(dirname "$0")" +CHROME=${CHROME:-$(command -v google-chrome-stable || command -v google-chrome || command -v chromium)} +"$CHROME" --headless --disable-gpu --no-pdf-header-footer --run-all-compositor-stages-before-draw \ + --print-to-pdf="$PWD/../guia-operador-kanban.pdf" "file://$PWD/operador/guia-operador-kanban.html" diff --git a/docs/guias/operador/guia-operador-kanban.html b/docs/guias/operador/guia-operador-kanban.html new file mode 100644 index 0000000..1a9409d --- /dev/null +++ b/docs/guias/operador/guia-operador-kanban.html @@ -0,0 +1,320 @@ + + + + + +Kanban DTF · Guia do operador + + + + + +
+
+

GUIA DE OPERAÇÃO

+

Kanban DTF
Guia do operador

+

Como conferir, produzir e entregar os pedidos que chegam pelo Site DTF.

+ + + + +
AcessoQuem usa
dtf.kanban.agenciacompor.com.br
e-mail e senha do operador		Equipe da sala de DTF e atendimento
+

Versão de 25 de setembro de 2026

+
+
+ + +
+
DTF Dropstar - guia do operador
+

VISÃO GERAL

+

O caminho de um pedido

+

O cliente monta a folha e envia as artes pelo Site DTF. Daí em diante, tudo acontece no Kanban: a equipe + confere a cotação, o cliente paga, e o pedido percorre as etapas de produção até ficar pronto para retirada.

+ + + + + + + + + + + + + +
1Cliente enviaMonta a folha no Site, vê a nota e o preço e envia o pedido para conferência.
2Equipe confere a cotaçãoNa aba Cotações: confere arquivos, metragem e nota e aprova.
3Cliente pagaO total aprovado aparece no Site. O pagamento é pelo Mercado Pago (PIX ou cartão).
4Pedido entra na produçãoCom o pagamento aprovado, o pedido aparece em Arte recebida, com o PDF de impressão já gerado.
5Equipe produzAprova o arquivo final, baixa, importa no FlexiPRINT e move o card a cada etapa.
6Pedido prontoEm Finalizado, o pedido fica pronto para retirada e o cliente é avisado (página 7).
+

As quatro abas

+ + + + + + +
AbaPara que serve
ProduçãoO quadro com os pedidos pagos, uma coluna por etapa.
CotaçõesPedidos enviados pelo Site esperando conferência. O número ao lado indica quantos faltam revisar.
PagamentosPagamentos que o sistema não conseguiu ligar a um pedido. Normalmente fica vazia.
IntegraçõesSituação do Tiny, Mercado Pago, frete e WhatsApp, e o registro de tudo o que foi enviado a eles.
+
O quadro não se atualiza sozinho. Clique em Atualizar, no canto superior direito, para ver pedidos e cotações novos.
+
Página 2
+
+ + +
+
DTF Dropstar - guia do operador
+

PRODUÇÃO

+

Entrar e ler o quadro

+
+
+

Acesse dtf.kanban.agenciacompor.com.br e entre com seu e-mail e senha. Cada operador tem o próprio + acesso: é o nome dele que fica registrado em cada movimento do pedido.

+

Depois de várias senhas erradas seguidas, o acesso fica bloqueado por 15 minutos.

+
+
Tela de entrada do Kanban
+
+ Quadro de produção +

Quadro de produção com três pedidos em etapas diferentes.

+

O que cada card mostra

+ +

Os filtros Têxtil, UV e Preparar à mão mostram só esses pedidos. A busca encontra pedido, cliente ou CNPJ.

+
Página 3
+
+ + +
+
DTF Dropstar - guia do operador
+

COTAÇÕES

+

Conferir e aprovar uma cotação

+ Aba Cotações +

À esquerda, as cotações a revisar; à direita, a cotação selecionada.

+
    +
  1. Abra a aba Cotações e clique na cotação em A revisar.
    2. +
  2. Confira a montagem na miniatura. Se precisar, abra os arquivos em Original ou a lista de peças em Manifesto.
    3. +
  3. Confira Metros conferidos e Nota conferida. Os valores do cliente já vêm preenchidos; mude só se + estiverem errados. A nota define o preço do metro.
    4. +
  4. Marque Arquivos, metragem e nota conferidos e clique em Aprovar cotação.
    5. +
+

O cliente vê o total aprovado no Site e tem 24 horas para pagar. As aprovadas ficam em + Aprovadas, aguardando pagamento até o pagamento chegar.

+
Ressalva de resolução aceita pelo cliente: alguma arte tem menos de 300 DPI e o cliente confirmou + que quer imprimir assim. Montagem antiga: a cotação foi feita numa versão anterior do Site; peça ao cliente + para enviar de novo.
+
Página 4
+
+ + +
+
DTF Dropstar - guia do operador
+

PRODUÇÃO

+

Abrir um pedido

+ Painel do pedido +

Clique em qualquer card para abrir o painel do pedido.

+ + + + + + + +
Parte do painelO que tem
TopoNúmero, etapa atual, data do pagamento e os botões para mover o pedido.
Cliente e EntregaE-mail, CNPJ e WhatsApp do cliente; endereço ou Retirada em Franca.
Itens e arquivos de impressãoMontagem de cada item, peças, tamanho da folha e nota. Baixar PDF + baixa o arquivo pronto para o FlexiPRINT; Original baixa o arquivo que o cliente enviou; Manifesto + lista as peças e suas posições.
Arquivos finaisO arquivo que vai ser impresso, aprovado por um operador (próxima página).
HistóricoCada movimento do pedido, com hora, operador e motivo.
+
Página 5
+
+ + +
+
DTF Dropstar - guia do operador
+

PRODUÇÃO

+

Aprovar o arquivo final

+
+
+

Antes de ir para a Fila de impressão, todo item precisa de um arquivo final aprovado. O sistema já gera + um PDF com a montagem que o cliente viu e pagou.

+
    +
  1. Baixe o PDF em Baixar PDF e confira.
    2. +
  2. Deixe marcado Usar o PDF gerado. Se preferir usar outro arquivo, desmarque e envie o seu.
    3. +
  3. Escreva uma Nota da revisão (ex.: “Conferido, pronto para imprimir”).
    4. +
  4. Marque Arquivos conferidos e clique em Aprovar arquivos finais.
    5. +
+

O card passa a mostrar Final aprovado.

+
+
Aprovação do arquivo final
+
+

Quando o PDF não é gerado

+ + + + + +
No card ou no itemO que fazer
Na fila para gerarAguarde alguns segundos e clique em Atualizar.
Preparar à mãoO cliente enviou um formato que o gerador não lê (CDR, AI, PSD, TIFF) + ou pediu correção. Baixe o Original, prepare o arquivo no seu programa e envie-o em Arquivos finais.
Falhou ao gerarClique em Gerar novamente. Se falhar de novo, prepare à mão.
+
Página 6
+
+ + +
+
DTF Dropstar - guia do operador
+

PRODUÇÃO

+

Mover o pedido pelas etapas

+

Use o botão laranja Mover para… no topo do painel ou arraste o card para a coluna seguinte. Ao arrastar, + só as colunas permitidas ficam destacadas.

+ + + + + + + + +
EtapaSignificaAviso ao cliente
Arte recebidaPedido pago, arquivo gerado. Ainda não conferido.Pedido aprovado (automático)
Arte tratadaArquivo conferido e ajustado, se preciso.—
Fila de impressãoPronto para imprimir. Exige o arquivo final aprovado.—
ImprimindoNa máquina.—
FinalizadoImpresso e pronto para retirada ou envio.Pedido pronto para retirada
CorreçãoAlgo no arquivo precisa ser resolvido pelo cliente.O motivo aparece em Minha conta, no Site (página 8)
+
Os avisos por WhatsApp saem pelo número e pelas mensagens que a Dropstar já usa, a partir da situação + do pedido no Tiny: o pedido pago fica Aprovado e, em Finalizado, o pedido de retirada fica + Pronto para envio. Cada aviso sai uma vez só, mesmo que o pedido volte uma etapa e avance de novo. + As outras etapas não mudam o pedido no Tiny. Enquanto essa integração não estiver ativa, avise o cliente como hoje.
+

Moveu errado? Volte uma etapa

+ Botão Voltar para +

Botão Voltar para…: pede um motivo interno e não avisa o cliente.

+

Clique em Voltar para [etapa anterior], escreva o motivo (ex.: “movi por engano”) e confirme. O retorno fica + no histórico como Voltou para…. O cliente não vê esse retorno nem o motivo.

+
Página 7
+
+ + +
+
DTF Dropstar - guia do operador
+

PRODUÇÃO

+

Pedir correção ao cliente

+ Botão Pedir correção +

Botão Pedir correção: o motivo vai para o cliente.

+
    +
  1. No painel do pedido, clique em Pedir correção.
    2. +
  2. Escreva o motivo de forma clara para o cliente (ex.: “A arte escudo.png está com fundo branco. Envie com fundo transparente.”).
    3. +
  3. Clique em Enviar para correção. O pedido vai para a coluna Correção.
    4. +
+

O cliente vê o motivo em Minha conta, no Site, e envia por lá o arquivo corrigido. Esse aviso ainda não sai + pelo WhatsApp: avise o cliente de que há uma correção pendente. O arquivo corrigido aparece em Arquivos finais + como Correção do cliente. Confira, mova o pedido para Arte recebida ou Arte tratada e siga o fluxo normal.

+
Correção é para problemas que só o cliente resolve (resolução, fundo, arte errada). Ajustes que a equipe + faz sozinha não precisam de correção: trate o arquivo em Arte tratada.
+

Histórico

+ Histórico do pedido +

Cada movimento fica registrado com data, hora e operador.

+
Página 8
+
+ + +
+
DTF Dropstar - guia do operador
+

PAGAMENTOS E INTEGRAÇÕES

+

Pagamentos com problema e integrações

+

A aba Pagamentos lista os pagamentos que chegaram mas não puderam virar pedido sozinhos. Exemplos:

+ +

Resolva com o cliente ou no Mercado Pago e clique em Registrar resolução, descrevendo o que foi feito. + O item passa para Resolvidos.

+ Aba Pagamentos +

Integrações

+ Aba Integrações +

Imagem de um ambiente sem integrações ativas. Em produção, cada cartão mostra se a integração está conectada.

+ +
Página 9
+
+ + +
+
DTF Dropstar - guia do operador
+

DÚVIDAS FREQUENTES

+

Mensagens e o que fazer

+ + + + + + + + + + +
Mensagem ou situaçãoO que fazer
“O pedido mudou. Clique em Atualizar.”Outra pessoa mexeu no pedido ao mesmo tempo. Clique em Atualizar e repita a ação.
“Aprove os arquivos finais de todos os itens antes de colocar na fila.”Aprove o arquivo final de cada item (página 6) e tente de novo.
“Informe o motivo da correção.” / “Informe por que o pedido está voltando de etapa.”Preencha o motivo antes de confirmar.
Cotação com Montagem antigaPeça ao cliente para enviar o pedido de novo pelo Site.
Card com Parado há mais de 4 hVeja se o pedido está esperando alguém ou se esqueceram de movê-lo.
Arquivo aparece como expiradoOs arquivos ficam guardados por 30 dias. Depois disso, o cliente precisa enviar de novo.
No topo, Tiny: verificar conexão ou Tiny não conectadoAbra Integrações e siga a mensagem do cartão do Tiny. Se pedir, clique em Reconectar.
A internet da fábrica caiuO Site continua recebendo pedidos e pagamentos. Quando a conexão voltar, clique em Atualizar.
+

Boas práticas

+ +
Página 10
+
+ + + diff --git a/docs/guias/operador/img/arquivo-final.png b/docs/guias/operador/img/arquivo-final.png new file mode 100644 index 0000000..9073377 Binary files /dev/null and b/docs/guias/operador/img/arquivo-final.png differ diff --git a/docs/guias/operador/img/cotacoes.png b/docs/guias/operador/img/cotacoes.png new file mode 100644 index 0000000..b2ffef4 Binary files /dev/null and b/docs/guias/operador/img/cotacoes.png differ diff --git a/docs/guias/operador/img/historico.png b/docs/guias/operador/img/historico.png new file mode 100644 index 0000000..22953fe Binary files /dev/null and b/docs/guias/operador/img/historico.png differ diff --git a/docs/guias/operador/img/integracoes.png b/docs/guias/operador/img/integracoes.png new file mode 100644 index 0000000..e579ce0 Binary files /dev/null and b/docs/guias/operador/img/integracoes.png differ diff --git a/docs/guias/operador/img/login.png b/docs/guias/operador/img/login.png new file mode 100644 index 0000000..8f9ceca Binary files /dev/null and b/docs/guias/operador/img/login.png differ diff --git a/docs/guias/operador/img/pagamentos.png b/docs/guias/operador/img/pagamentos.png new file mode 100644 index 0000000..5b3b05a Binary files /dev/null and b/docs/guias/operador/img/pagamentos.png differ diff --git a/docs/guias/operador/img/painel.png b/docs/guias/operador/img/painel.png new file mode 100644 index 0000000..ad9ade1 Binary files /dev/null and b/docs/guias/operador/img/painel.png differ diff --git a/docs/guias/operador/img/pedir-correcao.png b/docs/guias/operador/img/pedir-correcao.png new file mode 100644 index 0000000..ff27e8a Binary files /dev/null and b/docs/guias/operador/img/pedir-correcao.png differ diff --git a/docs/guias/operador/img/quadro.png b/docs/guias/operador/img/quadro.png new file mode 100644 index 0000000..61278d8 Binary files /dev/null and b/docs/guias/operador/img/quadro.png differ diff --git a/docs/guias/operador/img/voltar-etapa.png b/docs/guias/operador/img/voltar-etapa.png new file mode 100644 index 0000000..145f81a Binary files /dev/null and b/docs/guias/operador/img/voltar-etapa.png differ