Trinta documentos de uma só vez

A sétima e última funcionalidade da segunda vaga resolve aquilo de que a vaga partiu: o DocuTract faz um documento de forma cómoda e trinta de forma incómoda. Trinta contratos de trabalho são trinta vezes os mesmos seis passos: criar, escolher o modelo, carregar a digitalização, verificar os valores, gerar. O tempo não vai para o documento, vai para a repetição.

Agora, a entrada é recebida de uma só vez.

Duas entradas, porque um escritório tem duas

Um arquivo de pastas. Uma pasta é um negócio, os ficheiros que contém são as suas digitalizações. Pastas dentro de pastas não são problema: tudo o que está em «Кравченко» pertence a Кравченко, mesmo que esteja numa subpasta chamada «скани». Um arquivo criado num Mac traz __MACOSX e .DS_Store, e não os mostramos como negócios autónomos. Os nomes de pastas em cirílico são lidos tal como foram escritos, e não como «Ð равченко». São estes pormenores que decidem se uma importação funciona à primeira.

Uma tabela. CSV ou XLSX, uma linha é um documento, uma coluna é um campo. O cabeçalho é associado ao campo do modelo, por isso «Full name» encontra full_name, e o ponto e vírgula que o Excel escreve nesta parte do mundo é lido da mesma forma que uma vírgula. Uma coluna que o modelo não tem trava a execução antes de começar e indica o próprio nome. Descobrir na linha duzentos que o produto tem estado a ignorar uma coluna em silêncio é pior do que nem sequer começar.

Primeiro, fica a saber quanto custa

Carregar não inicia nada. Lemos o ficheiro e mostramo-lo: trinta itens encontrados, trinta gerações que vai custar, doze disponíveis. E só então aparece o botão Iniciar.

Se não houver gerações suficientes, a execução não começa de todo. Não há arranques parciais, e isso é propositado: quem carregou trinta pastas e recebeu doze documentos tem agora de descobrir quais são os dezoito em falta e se lhe foram cobrados. Não há nada pior do que isso.

O dinheiro em si é gasto como sempre, um documento de cada vez, à medida que cada um fica pronto. Assim, um item que falhou não custa nada.

Uma execução que não para por causa de uma pasta

Duas pastas chegaram corrompidas. Isso não é motivo para parar as outras vinte e oito. Esses dois itens recebem o seu motivo em linguagem simples, o resto segue até ao fim, e a execução termina como «parcial», porque não está concluída nem falhada, e chamar-lhe uma coisa ou outra seria mentir.

Depois, dois botões. Repetir os falhados inicia exatamente as linhas que não funcionaram: as que ficaram prontas não são tocadas nem pagas duas vezes. Descarregar tudo entrega o que já existe num único arquivo, mesmo enquanto dois itens ainda estão a ser resolvidos, porque vinte e oito documentos prontos já valem a pena agora.

Os ficheiros do arquivo têm o nome que tinham na sua entrada: «Кравченко.docx», e não a nossa referência interna. É por esse nome que vai procurar.

Porque é que não ocupa a fila inteira

Não há maquinaria nova lá dentro: os mesmos processos, os mesmos workers, a mesma quota. A única coisa acrescentada é um limite de concorrência: no máximo alguns itens de um mesmo espaço de trabalho são executados em simultâneo. Um cliente com um arquivo de trezentas pastas não deve ficar à frente na fila de alguém que carregou em «gerar» num único documento, e agora não fica.

Uma pasta vazia ou uma linha vazia é marcada como ignorada e não como falhada. Não é uma avaria, é o que estava no ficheiro de entrada, e não há nada para repetir.

Se uma execução demorar mais do que alguns minutos, chega um e-mail sobre ela quando termina. Uma mais curta não envia nada: a pessoa ainda está a olhar para o ecrã, e e-mails de que ninguém precisava são a razão por que todas as notificações acabam desligadas.

O que vem a seguir

Isto completa a segunda vaga: a recolha de documentos junto do cliente, os processos, as verificações cruzadas, o diretório de partes, os blocos condicionais com versões de modelos, a API com webhooks e a geração em lote. Sete funcionalidades, cada uma a eliminar um tipo de trabalho manual em vez de acrescentar mais um ecrã.

As instruções passo a passo para os lotes estão no centro de ajuda, e a lista completa do que foi planeado está em o que estamos a construir a seguir.