feat: generate print files, collect delivery addresses, add provider adapters

Week 2 work that did not need client inputs.

Print files (1.4): each paid item gets a PDF the width of the film and the
length of the approved layout, with every copy at its reviewed position,
rotation and mirror. Sources are embedded once at original resolution; JPEG
bytes pass through and PNG alpha becomes a soft mask. Artwork the generator
cannot reproduce goes to hand preparation with the reason. The worker renders
outside any transaction, and the operator approves the generated file as the
final one through the existing review.

Delivery address (3.8): required for any non-pickup quote, bound to the
quoted CEP, carried into the order snapshot, the Kanban card and Tiny.

Kanban (1.5): print-file status per item, and a panel of payment events that
need a person (money without an order, refunds after an order) until an
operator records the resolution.

Mercado Pago and Tiny (1.1, 1.3): adapters written from the public API
documentation and tested against fake transports only. Selectable for
sandbox testing with their credentials; the production preflight still
blocks release. Adds payment intents and a PIX step on the Site.

MinIO: Docker Hub and quay.io now refuse anonymous pulls, so local and CI
storage use Chainguard's MinIO build, pinned by digest.

Verified with the full CI integration sequence on a fresh local build,
including the new print_file_test and both browser suites.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

web/cart.js

@@ -35,6 +35,9 @@
         if(entrega.tipo==='frete'){entrega.cotado=false;entrega.valor=0;}
         for(const [id,key] of [['fCnpj','cnpj'],['fZap','zap'],['fMail','mail']])$(id).value=cliente[key];
         $('cepIn').value=entrega.cep;
+        entrega.end=entrega.end||{};
+        for(const [id,key] of [['eNome','nome'],['eRua','rua'],['eNum','num'],['eComp','comp'],
+                               ['eBairro','bairro'],['eCidade','cidade'],['eUf','uf']])$(id).value=entrega.end[key]||'';
         $('atual').style.display='none';pintaEntrega();
         notice.textContent='Carrinho recuperado. Remova e adicione novamente um item se precisar alterar sua montagem.';
       }else{

web/checkout.js

@@ -73,6 +73,7 @@
     if (busy) return;
     if (draftId) { await refresh(); status.scrollIntoView({behavior:'smooth',block:'nearest'}); return; }
     if (!clienteOk() || !entrega.cotado) return;
+    if (!enderecoOk()) return message('Preencha o endereço de entrega.');
     if (!cartPodeEnviar()) return message('Revise a qualidade e confirme a ressalva de cada item antes de enviar o pedido.');
     const cart = [...pedido,...(itemAtual?[itemAtual]:[])];
     if (!cart.length) return message('Adicione um item ao pedido.');
@@ -95,6 +96,8 @@
           quality_status:item.qualityStatus,quality_acknowledged:item.qualityAcknowledged});
       }
       const content = {customer:{...cliente},items,freight:{service:entrega.tipo==='retira'?'pickup':'mock-standard',postal_code:entrega.tipo==='retira'?'':entrega.cep}};
+      const destination = destinoApi();
+      if (destination) content.destination = destination;
       if (cartSnapshot()!==initialCart) throw new Error('O carrinho mudou durante o envio. Confira os itens e envie de novo.');
       const serialized = JSON.stringify(content);
       if (!requestKey || serialized !== requestBody) {
@@ -127,6 +130,15 @@
         message('Arquivos enviados. No Kanban, confira metragem e nota e aprove a cotação '+draftId.slice(0,8)+'.');
       } else if (quote.status==='approved') {
         message('Total validado no servidor: '+rs(quote.approved.total_cents/100)+' · inclui frete. Cotação válida por 24 horas.');
+        if ((await ready).payment_provider === 'mercadopago') {
+          button('Pagar com PIX',async event=>{
+            if (!quotedCart || quotedCart!==cartSnapshot()) { await refresh(); return; }
+            event.target.disabled=true;
+            try { showPix(await api('/payments/intent',{quote_id:draftId,method:{type:'pix'}})); }
+            catch(error) { message(error.message); event.target.disabled=false; }
+          });
+          return;
+        }
         if ((await ready).environment !== 'local') {
           message('Cotação revisada. O pagamento online ainda não está disponível.');
           return;
@@ -156,6 +168,36 @@
       button('Limpar referência e tentar de novo',clearDraft);
     }
   }
+  // PIX: the provider's QR code and copy-and-paste code. The order is created
+  // by the provider's notification, not by this page, so the page only waits.
+  let pixTimer=null;
+  function showPix(intent) {
+    actions.replaceChildren();
+    if (!intent.pix_qr_code) { message('Não foi possível gerar o PIX. Tente de novo em instantes.'); return; }
+    message('Pague o PIX de '+rs(intent.total_cents/100)+'. O pedido entra na produção assim que o pagamento for confirmado.');
+    if (intent.pix_qr_code_base64) {
+      const img=document.createElement('img');
+      img.src='data:image/png;base64,'+intent.pix_qr_code_base64;
+      img.alt='QR code do PIX';img.width=220;img.height=220;img.style.display='block';
+      actions.append(img);
+    }
+    const code=document.createElement('input');
+    code.readOnly=true;code.value=intent.pix_qr_code;code.style.cssText='width:100%;margin-top:8px;padding:8px';
+    actions.append(code);
+    button('Copiar código PIX',async()=>{ try{ await navigator.clipboard.writeText(intent.pix_qr_code); message('Código copiado.'); }catch(_){ code.select(); } });
+    clearInterval(pixTimer);
+    pixTimer=setInterval(async()=>{
+      try {
+        const quote=await api('/quotes/'+draftId);
+        if (quote.status==='paid') {
+          clearInterval(pixTimer);
+          pedido=[]; itemAtual=null; limpaPaineis();
+          await window.dtfClearCart?.();
+          await refresh();
+        }
+      } catch(_) {}
+    },5000);
+  }
   const quoteFromPortal=new URLSearchParams(location.search).get('quote');
   if(quoteFromPortal && /^[0-9a-f-]{36}$/.test(quoteFromPortal)){
     if(draftId!==quoteFromPortal){quotedCart=null;localStorage.removeItem('dtf-quote-cart');}

web/index.html

@@ -644,6 +644,8 @@ h1 em{font-style:normal;color:var(--laranja)}
  font-family:"Inter",sans-serif;font-weight:600;font-size:12.5px}
 .cepL button:hover{border-color:var(--laranja);color:var(--laranja)}
 .cep p{font-size:11.5px;color:var(--fraco);margin-top:9px;line-height:1.5}
+.cep .endereco{margin-top:12px}
+.cep .err{color:var(--vermelho)}
 .avisoE:empty{display:none}
 .avisoE{font-size:11.5px;color:#1F5C3A;background:#F1FBF5;border:1px solid #BFE6CE;
  border-radius:8px;padding:10px 12px;line-height:1.5;margin-top:9px}
@@ -1229,6 +1231,23 @@ footer a:hover{color:var(--laranja2)}
               <button id="bCep">Calcular</button>
             </div>
             <p id="cepMsg"></p>
+            <div class="campos endereco" id="endereco">
+              <div class="cp larga"><label>Quem recebe</label>
+                <input id="eNome" maxlength="120" autocomplete="name" placeholder="Nome ou empresa"></div>
+              <div class="cp larga"><label>Rua / avenida</label>
+                <input id="eRua" maxlength="160" autocomplete="address-line1"></div>
+              <div class="cp"><label>Número</label>
+                <input id="eNum" maxlength="20" placeholder="123 ou S/N"></div>
+              <div class="cp"><label>Complemento (opcional)</label>
+                <input id="eComp" maxlength="80" autocomplete="address-line2"></div>
+              <div class="cp"><label>Bairro</label>
+                <input id="eBairro" maxlength="80"></div>
+              <div class="cp"><label>Cidade</label>
+                <input id="eCidade" maxlength="80" autocomplete="address-level2"></div>
+              <div class="cp"><label>UF</label>
+                <input id="eUf" maxlength="2" autocomplete="address-level1" placeholder="SP"></div>
+            </div>
+            <p class="err" id="eEnd"></p>
           </div>
           <p class="avisoE" id="avisoE"></p>
         </div>

web/kanban.html

@@ -10,12 +10,12 @@ button,input,select{font:inherit;border:1px solid #56616d;border-radius:5px;padd
 button{cursor:pointer}button:hover{border-color:var(--ciano)}button:disabled{opacity:.5}input[type=number]{width:100px}
 label{display:inline-flex;gap:8px;align-items:center;margin:5px}#kan{display:grid;grid-template-columns:repeat(6,minmax(220px,1fr));gap:10px;overflow-x:auto;padding-bottom:16px}
 .col{background:var(--card);border:1px solid var(--linha);border-radius:9px;min-height:250px;padding:10px}.col h2{font-size:14px;border-bottom:2px solid var(--cc);padding-bottom:10px}.col.alvo{border-color:var(--ciano)}
-.cd,.review{background:var(--card2);border:1px solid var(--linha);border-left:3px solid var(--cc,var(--ciano));border-radius:6px;padding:12px;margin-bottom:10px}.cd{cursor:grab}.cd p{overflow-wrap:anywhere}.meta{color:var(--fraco);font-size:12px}.actions{display:flex;gap:6px;flex-wrap:wrap;margin-top:8px}.error{color:#ffad83}#status{min-height:24px}details{margin:16px 0}pre{white-space:pre-wrap;overflow-wrap:anywhere}a{color:var(--ciano)}
+.cd,.review{background:var(--card2);border:1px solid var(--linha);border-left:3px solid var(--cc,var(--ciano));border-radius:6px;padding:12px;margin-bottom:10px}.cd{cursor:grab}.cd p{overflow-wrap:anywhere}.meta{color:var(--fraco);font-size:12px}.actions{display:flex;gap:6px;flex-wrap:wrap;margin-top:8px}.error{color:#ffad83}.print{margin-top:8px;padding-top:8px;border-top:1px solid var(--linha)}.print button{margin-left:6px}#status{min-height:24px}details{margin:16px 0}pre{white-space:pre-wrap;overflow-wrap:anywhere}a{color:var(--ciano)}
 </style></head><body>
 <header><h1>Kanban DTF</h1><button id="refresh">Atualizar</button><button id="logout">Sair</button></header>
 <div class="aviso">Confira a cotação manualmente. Em Arquivos de produção, envie e aprove os arquivos finais de todos os itens antes de colocar o pedido na fila. Não há validação automática de arte.</div>
 <form id="login"><label>E-mail <input id="email" type="email" autocomplete="username" required></label><label>Senha <input id="password" type="password" autocomplete="current-password" required></label><button>Entrar</button></form>
 <p id="status" role="status"></p>
-<section id="reviews"></section><div id="kan"></div>
+<section id="payments"></section><section id="reviews"></section><div id="kan"></div>
 <details><summary>Eventos locais de integração</summary><pre id="events"></pre></details>
-<script src="/upload.js"></script><script src="/kanban.js?v=operator-email-1"></script></body></html>
+<script src="/upload.js"></script><script src="/kanban.js?v=print-files-1"></script></body></html>

web/kanban.js

@@ -40,6 +40,52 @@ function productionLines(container,item){
     ' cm · giro '+source.rotation_degrees+'°'+(source.mirrored?' · espelhada':'')+
     ' · medida '+source.measurement+' · arquivo '+source.upload_id.slice(0,8),'meta')));
 }
+const PRINT_STATUS={pending:'na fila para gerar',rendering:'gerando…',ready:'pronto',
+  manual:'preparar à mão',failed:'falhou ao gerar'};
+function download(uid){return async()=>{
+  const result=await api('/uploads/'+uid+'/download');
+  const link=node('a');link.href=result.url;link.referrerPolicy='no-referrer';link.download=result.name;link.click();
+};}
+function printFiles(card,order){
+  const rows=order.print_files||[];
+  const box=node('div',undefined,'print');
+  box.append(node('b','Arquivo de impressão'));
+  order.snapshot.items.forEach((item,index)=>{
+    const row=rows.find(r=>r.item_index===index);
+    const line=node('p','Item '+(index+1)+' · '+(row?PRINT_STATUS[row.status]:'não gerado'),'meta');
+    if(row?.status==='ready'){
+      line.textContent+=' · '+row.detail.film_width_cm+' × '+row.detail.height_cm+' cm'+
+        (row.detail.min_dpi?' · menor resolução '+row.detail.min_dpi+' DPI':'');
+      line.append(action('Baixar PDF',download(row.upload_id)));
+    }
+    if(row?.status==='manual')line.append(node('span',' · '+row.detail.reason));
+    box.append(line);
+  });
+  const retry=order.snapshot.items.some((_,index)=>{const row=rows.find(r=>r.item_index===index);
+    return !row||row.status==='manual'||row.status==='failed';});
+  if(retry&&['rec','tra'].includes(order.state))
+    box.append(action('Gerar arquivos de impressão',async()=>{await api('/orders/'+order.id+'/print-files',{});await load();}));
+  card.append(box);
+}
+function paymentIssues(){
+  $('payments').replaceChildren();
+  if(!board.payment_issues?.length)return;
+  $('payments').append(node('h2','Pagamentos que precisam de atenção · '+board.payment_issues.length));
+  $('payments').append(node('p','Um pagamento chegou sem virar pedido (valor diferente, cotação vencida) ou foi '+
+    'estornado depois do pedido. Confira no painel do provedor, resolva com o cliente e registre o que foi feito.','meta'));
+  for(const issue of board.payment_issues){
+    const card=node('article',undefined,'review');
+    card.append(node('b',issue.provider+' · evento '+issue.event_id),
+      node('p',(issue.amount_cents==null?'valor não informado':money(issue.amount_cents))+' · cotação '+
+        (issue.reference||'—')+' · '+new Date(issue.received_at).toLocaleString('pt-BR'),'meta'),
+      node('p',issue.outcome));
+    card.append(action('Registrar resolução',async()=>{
+      const note=prompt('O que foi feito? (ex.: estornado no Mercado Pago em 25/09)');if(!note)return;
+      await api('/payment-events/'+issue.id+'/resolve',{note});await load();
+    }));
+    $('payments').append(card);
+  }
+}
 async function load(){
   try{
     board=await api('/board');
@@ -63,6 +109,7 @@ async function loadMoreQuotes(kind){
   render();
 }
 function render(){
+  paymentIssues();
   $('reviews').replaceChildren();
   if(board.pending_total || board.approved_total)
     $('reviews').append(node('h2','Cotações · '+board.pending_total+' pendentes · '+
@@ -107,11 +154,15 @@ function render(){
     column.append(node('h2',title+' · '+count));
     for(const order of orders){
       const card=node('article',undefined,'cd');card.draggable=true;card.dataset.order=order.id;
-      card.append(node('b','#'+order.number+' · Pago local'),node('p',order.snapshot.customer.mail,'meta'),node('p',money(order.snapshot.total_cents)));
+      card.append(node('b','#'+order.number+' · '+(order.payment?.provider==='fake'?'Pago local':'Pago')),node('p',order.snapshot.customer.mail,'meta'),node('p',money(order.snapshot.total_cents)));
+      const to=order.snapshot.destination;
+      card.append(node('p',to?'Entrega: '+to.recipient+' · '+to.street+', '+to.number+(to.complement?' '+to.complement:'')+
+        ' · '+to.district+' · '+to.city+'/'+to.state+' · CEP '+to.postal_code:'Retirada em Franca','meta'));
       for(const item of order.snapshot.items){
         card.append(node('p',item.mode+' · '+item.billed_metres+' m · nota '+item.grade,'meta'));
         productionLines(card,item);
       }
+      printFiles(card,order);
       const actions=node('div',undefined,'actions');files(actions,order.snapshot.items);
       const artwork=node('div');
       actions.append(action('Arquivos de produção',()=>artworkPanel(order,artwork)));
@@ -140,22 +191,39 @@ async function artworkPanel(order,container){
   for(const file of revisions){
     const row=node('p',(file.kind==='final'?'Final':'Correção do cliente')+' · item '+(file.item_index+1)+' · '+file.name+' · '+(file.expired?'expirado':file.active?'atual':'substituído'),'meta');
     row.append(node('p',file.note));
-    if(!file.expired)row.append(action('Baixar '+file.name,async()=>{const result=await api('/uploads/'+file.upload_id+'/download');const link=node('a');link.href=result.url;link.download=result.name;link.referrerPolicy='no-referrer';link.click();}));
+    if(!file.expired)row.append(action('Baixar '+file.name,download(file.upload_id)));
     container.append(row);
   }
   if(!['rec','tra','cor'].includes(order.state))return;
   const form=node('form');
   form.append(node('p','Enviar um conjunto final completo. Pode haver várias partes por item. Um novo conjunto substitui o anterior.'));
-  const inputs=order.snapshot.items.map((item,index)=>{const label=node('label','Item '+(index+1)+' · '+item.mode);label.style.display='block';const input=node('input');input.type='file';input.multiple=true;input.required=true;input.dataset.finalItem=index;input.style.width='100%';label.append(input);form.append(label);return input;});
+  // A generated print file reproduces the approved layout; offer it first, and
+  // keep the upload for items that need hand preparation. Not after a
+  // correction: the file was made from artwork the customer has replaced.
+  const corrected=revisions.some(file=>file.kind==='correction');
+  const inputs=order.snapshot.items.map((item,index)=>{
+    const label=node('label','Item '+(index+1)+' · '+item.mode);label.style.display='block';
+    const input=node('input');input.type='file';input.multiple=true;input.required=true;input.dataset.finalItem=index;input.style.width='100%';
+    const generated=corrected?null:(order.print_files||[]).find(r=>r.item_index===index&&r.status==='ready');
+    if(generated){
+      const use=node('input');use.type='checkbox';use.checked=true;input.required=false;input.hidden=true;
+      use.onchange=()=>{input.hidden=use.checked;input.required=!use.checked;};
+      const choice=node('label',' Usar o arquivo gerado ('+generated.name+')');choice.prepend(use);choice.style.display='block';
+      label.append(choice);input.generated=()=>use.checked?generated.upload_id:null;
+    }
+    label.append(input);form.append(label);return input;});
   const note=node('input');note.placeholder='Nota da revisão';note.required=true;note.maxLength=1000;note.style.width='100%';form.append(note);
   const check=node('input');check.type='checkbox';check.required=true;const label=node('label','Conferi estes arquivos finais para impressão manual.');label.prepend(check);form.append(label);
   const submit=node('button','Aprovar arquivos finais');submit.type='submit';form.append(submit);
   form.onsubmit=async event=>{event.preventDefault();submit.disabled=true;try{
     const refs=[];
-    for(const [index,input] of inputs.entries())for(const file of input.files){
+    for(const [index,input] of inputs.entries()){
+      const generated=input.generated?.();
+      if(generated){refs.push({item_index:index,upload_id:generated});continue;}
+      for(const file of input.files){
       const uid=await dtfUpload(file,{api,startPath:'/orders/'+order.id+'/uploads',scope:'operator:'+order.id+':'+order.version,progress:text=>$('status').textContent=text});
       refs.push({item_index:index,upload_id:uid});
-    }
+    }}
     await api('/orders/'+order.id+'/final-files',{version:order.version,files:refs,note:note.value});
     await load();
   }catch(error){$('status').textContent=error.message;submit.disabled=false;}};

web/site-cart.js

@@ -53,7 +53,7 @@ function pintaPedido(){
   $('bPagar').textContent = (pedido.length + (itemAtual?1:0))>1
     ? 'Pagar os '+(pedido.length+(itemAtual?1:0))+' itens de uma vez'
     : 'Ir para o pagamento';
-  $('bPagar').disabled = !cartPodeEnviar() || !entrega.cotado || !clienteOk();
+  $('bPagar').disabled = !cartPodeEnviar() || !entrega.cotado || !clienteOk() || !enderecoOk();
   if(pedido.length || itemAtual) $('carr').classList.add('on');
   if($('cartLink')) $('cartLink').textContent='Carrinho ('+n+')';
   window.dispatchEvent(new Event('dtf-cart-changed'));

web/site-config.js

@@ -75,7 +75,7 @@ let pedido=[];                             // itens já fechados · o pagamento
 // A escolha de entrega vale para o pedido inteiro, não por item. No Tiny, retirada
 // grava forma_envio X, transportador DropStar e frete por conta do remetente — igual
 // ao que a expedição já recebe hoje, sem criar processo novo.
-let entrega={tipo:'retira', cep:'', valor:0, cotado:true};
+let entrega={tipo:'retira', cep:'', valor:0, cotado:true, end:{}};
 let cliente={cnpj:'', zap:'', mail:''};
 let caminho='auto';                        // o que o cliente diz que vai mandar
 
@@ -93,6 +93,19 @@ function cnpjOk(v){
 const zapOk=v=>{ const d=(v||'').replace(/\D/g,''); return d.length===10||d.length===11; };
 const mailOk=v=>/^[^\s@]+@[^\s@]+\.[a-z]{2,}$/i.test((v||'').trim());
 const clienteOk=()=>cnpjOk(cliente.cnpj)&&zapOk(cliente.zap)&&mailOk(cliente.mail);
+// Frete cotado pelo CEP não entrega nada sozinho: a transportadora e o Tiny
+// precisam do endereço completo antes do pagamento.
+const UFS='AC AL AP AM BA CE DF ES GO MA MT MS MG PA PB PR PE PI RJ RN RS RO RR SC SP SE TO'.split(' ');
+const enderecoOk=()=>{
+  if(entrega.tipo!=='frete') return true;
+  const e=entrega.end||{}, t=v=>(v||'').trim();
+  return t(e.nome).length>=2 && t(e.rua).length>=2 && t(e.num).length>=1 &&
+    t(e.bairro).length>=2 && t(e.cidade).length>=2 && UFS.includes(t(e.uf).toUpperCase());
+};
+const destinoApi=()=>entrega.tipo!=='frete' ? null : {
+  recipient:entrega.end.nome.trim(), street:entrega.end.rua.trim(), number:entrega.end.num.trim(),
+  complement:(entrega.end.comp||'').trim(), district:entrega.end.bairro.trim(),
+  city:entrega.end.cidade.trim(), state:entrega.end.uf.trim().toUpperCase(), postal_code:entrega.cep};
 const larguraFilme=()=>MODOS[modo].larg;
 // cobrança proporcional: arredonda para cima em 10 cm · 2,75 m vira 2,80 m
 const cobrar=m=>Math.max(MINIMO_M, Math.ceil(m*10)/10);

web/site-flow.js

@@ -87,7 +87,9 @@ function pintaEntrega(){
     ? 'DTF é impresso depois que você paga. Avisamos no WhatsApp quando estiver '+
       '<b>pronto para retirar</b> — não venha antes do aviso.'
     : '';
-  $('bPagar').disabled = !entrega.cotado || !clienteOk() || !cartPodeEnviar();
+  $('bPagar').disabled = !entrega.cotado || !clienteOk() || !enderecoOk() || !cartPodeEnviar();
+  $('eEnd').textContent = entrega.tipo==='frete' && entrega.cotado && !enderecoOk()
+    ? 'Preencha o endereço de entrega para seguir.' : '';
   pintaPedido();
 }
 
@@ -144,6 +146,14 @@ $('cepIn').addEventListener('input',e=>{
   e.target.value = v.length>5 ? v.slice(0,5)+'-'+v.slice(5) : v;
   entrega.cep=v; entrega.cotado=false; entrega.valor=0; pintaEntrega();
 });
+for(const [id,chave] of [['eNome','nome'],['eRua','rua'],['eNum','num'],['eComp','comp'],
+                         ['eBairro','bairro'],['eCidade','cidade'],['eUf','uf']]){
+  $(id).addEventListener('input',e=>{
+    if(chave==='uf') e.target.value=e.target.value.replace(/[^a-z]/gi,'').toUpperCase();
+    entrega.end={...(entrega.end||{}),[chave]:e.target.value};
+    pintaEntrega();
+  });
+}
 $('bCep').addEventListener('click',async()=>{
   if(entrega.cep.length!==8){ $('cepMsg').innerHTML='CEP incompleto.'; return; }
   if(window.dtfFreight){ await window.dtfFreight(); return; }