Como o Trama funciona

2.1 A peça e a grade

• A peça existe por tamanho, nunca como um número só. Não existem "3.300 camisetas": existem 2.600 M e 700 G. Essa distribuição — a grade — é a identidade do pedido e atravessa tudo: a entrada, a saída de cada oficina, a volta, a falta ou a sobra, o comprovante e a ordem de serviço.
• Cada item do pedido tem a sua grade, e o mesmo produto pode aparecer duas vezes. O pedido se decompõe em itens; cada item é um produto (modelo, cor, tecido) com uma grade dentro. Duas grades do mesmo produto são dois itens.
• A grade é dinâmica. Camiseta é P/M/G/GG/G1; calça é 38 a 48. A lista de tamanhos é do tipo de peça: o produto aprende a grade na primeira vez que ela é digitada num pedido, e a oferece nas seguintes.
• O produto se classifica por nomes concretos — grupo, categoria, tecido e cor —, não por níveis abstratos.
• O cliente é um cadastro, não um nome digitado. O pedido aponta para um cliente que existe antes dele (e pode ser criado sem sair da tela do pedido).

2.2 O movimento

• Um lote está em várias etapas ao mesmo tempo. "O lote está na costura" é falso: ele está parte no corte, parte na estampa, parte na costura. O sistema não guarda "onde o lote está"; ele deriva onde cada peça está a partir das saídas e das voltas.
• O fracionamento é a regra, nas duas pontas, em toda etapa. O corte não corta tudo no mesmo dia; a estampa começa antes de o corte terminar. Sai em partes e volta em partes.
• Cada retirada gera um comprovante novo; a remessa fecha quando a soma alcança o que saiu. O papel que ficou na oficina não é corrigido a cada busca — cada busca tem o seu comprovante numerado.
• Toda etapa registra a grade que saiu e o porquê da diferença. Saem 500, voltam 497: é normal, tem mil causas, e não é erro a impedir — é fato a registrar, com o motivo em texto livre.
• A sobra é um fato diferente da falta. Tem outra causa e outra consequência; tem nome próprio no sistema.
• Uma peça não pode ser contada duas vezes. Ao somar por etapa, desconta-se o que já seguiu adiante. É o erro mais caro dessas telas, porque cada coluna sozinha parece certa — e o total decide compra de tecido e promessa de prazo. Esta regra é a que o portão aplica antes de gravar (§6.1).
• Mover é transferir. Levar as peças do corte direto para a estampa é, para o sistema, uma retirada do corte e uma saída para a estampa — o corte recebe o crédito do que fez.
• A etapa feita em casa registra o mesmo movimento, sem facção (desde a v10.47). Cada etapa se cadastra como feita em casa ou mandada à facção. A feita em casa registra a entrada das peças, a quantidade por tamanho, quem faz (opcional) e a volta — em partes, com a falta e a sobra —, sem ordem de serviço para terceiro: sai o comprovante interno, sem valor. Não tem facção, preço nem prazo. A entrada é de quem gere (quem leva as peças lê "Mandar para a produção em casa é de quem gere: quem leva as peças registra a saída para a facção e as voltas."); a volta, os dois papéis registram. As peças em produção em casa contam na etapa, como as que estão numa facção, mas não "nas facções": o Kanban, o totem da Produção e a régua da cidade as contam à parte ("em produção em casa"; a régua mostra só as das facções), e elas ficam fora das contas do prazo (passaram do prazo, pontualidade, o "buscar" da lista).
• Passar uma etapa a feita em casa não apaga dinheiro. A ordem de serviço que já saiu para uma facção nessa etapa, com valor, segue com a proposta de pagamento de sempre; só a ordem sem valor nenhum — a de antes, de quando a etapa feita em casa se registrava como uma facção — passa a ser lida como processo interno e sai do "Dar o valor". Cadastros diz isso, com quantas são, antes do toque.

2.3 A rota

• A rota é do pedido, e é editável durante a produção. A sequência de etapas (corte → estampa → costura → acabamento…) se define no pedido e pode mudar com a produção andando: incluir uma etapa, tirar, reordenar.
• A rota tem padrão aprendido no produto e execução editável no pedido. O roteiro de uma peça é conhecimento acumulado (mora no produto); o roteiro daquele pedido é uma cópia que se edita, uma só para todos os itens. Só quando os itens precisam de caminhos diferentes cada um fica com a sua rota — e aí o sistema não sugere a próxima etapa do lote.
• A próxima etapa sai da rota e do que já foi feito. O sistema não guarda "a etapa atual" como verdade: ele deriva, para as peças de cada lugar, qual é a primeira etapa da rota por onde elas ainda não passaram. Uma etapa feita dentro de casa (sem oficina) se marca como feita, e conta; desde a v10.47, a etapa cadastrada como feita em casa também se registra peça a peça — a entrada e a volta (§2.2) —, e a volta conta como a de uma facção.

2.4 O tempo

• O prazo quem dá é a oficina, no ato da entrega. Não é cadastro nem cálculo: é o dia que o dono da oficina diz quando recebe as peças. Sem esse dia, a saída não se registra.
• O semáforo tem quatro estados: verde no prazo, amarelo no dia, vermelho depois — e laranja quando a busca veio em parte ("buscada em parte · 30 de 50 já voltaram"). O quarto não é de tempo: é de inteireza.
• O sistema registra fato, não plano. Zero remessas com as peças a caminho do corte não é abandono: é o sistema sendo usado corretamente por quem ainda não entregou. Datas de movimento são as do registro; não há data retroativa.

2.5 O dinheiro

• O preço é por processo e por pedido. O mesmo silk custa diferente em pedidos diferentes; não existe tabela fixa por oficina — a tabela é sugestão.
• O valor é do serviço, combinado no ato. Leva-se o lote à oficina, combina-se quanto por peça, e esse é o valor daquele serviço, congelado na ordem de serviço. Quem leva as peças não vê nem informa preço: desde a v10.47, a ordem que ele registra na rua recebe o preço da tabela, posto pelo sistema (o da facção naquela etapa, vigente no dia), e quem gere o edita no Financeiro se o combinado foi outro; sem preço na tabela, ela fica sem valor, e quem gere o diz depois.
• O preço é por peça, pelo lote, por quilo ou por dia (desde a v10.47). A tabela e o valor combinado no ato dizem a unidade: por peça — o valor de cada peça, que a ordem multiplica pela quantidade —, pelo lote — o valor fechado do lote inteiro daquela saída ("R$ 300,00 pelo lote"), que a ordem guarda como está, sem multiplicar —, ou por quilo e por dia — o preço da unidade ("R$ 6,00 por quilo"), que a ordem guarda; o total combinado (o peso, os dias não se sabem na saída) quem gere dá no Financeiro, ao lançar a conta, e a tela diz isso; o total fica na conta a pagar, e o documento do fechamento o conta "pelo lançado" (sem a conta, a ordem fica fora do total). A ordem por lote se paga pelo valor do lote, e não pelo que voltou. Um valor só pelo lote: a tabela pelo lote vai sozinha só à ordem da saída que leva o lote inteiro; a saída de uma parte do lote sai sem valor — o campo abre vazio e diz "o lote saiu em partes: diga o valor desta" —, e quem gere dá o valor dela, ou divide: a ordem nasce por lote, sem valor, e o que quem gere lançar a pagar entra no fechamento pelo lançado (o mesmo com o campo em branco por quilo ou por dia). Trocar a unidade no campo não leva junto o valor sugerido pela tabela em outra unidade: o campo se limpa, e a ajuda diz a unidade da tabela. Quem leva as peças não vê nem informa a unidade, como não vê o preço.
• "Dar o valor" é da ordem de facção que ficou sem valor (desde a v10.47). Pede valor a quem gere a ordem que ficou sem valor — a da facção nova, que ainda não tem preço na tabela, e a que quem gere deixou em branco. A que saiu da rua com o preço da tabela já tem valor, e não pede: edita-se no lançar, como qualquer outra. A ordem por quilo ou por dia pede o total, até quem gere dá-lo. A da etapa feita em casa não: ela não tem ordem; a de antes, sem valor nenhum, de quando a etapa feita em casa se registrava como uma facção, fica no Financeiro marcada "processo interno".
• Pagar tem valor e dia. As contas a pagar (à oficina, por ordem de serviço, ou soltas: frete, combustível) e a receber (do cliente, por pedido) têm vencimento e baixa. A conta a pagar de uma entrega é proposta pelo que voltou — as peças que a oficina devolveu vezes o valor por peça —, e quem gere a lança com um toque.
• O custo de um pedido sai das ordens de serviço dele, pela mesma régua: a conta lançada quando há; senão, o que voltou vezes o valor por peça; o combinado enquanto nada voltou. Ordem sem valor não soma — é contada, e a margem sai avisada.
• A ordem que vai à oficina não leva valor (desde a v10.46). O papel que fica na parede da facção e a mensagem do WhatsApp dizem o que fazer — o produto e a cor, a grade, o prazo, a observação —, nunca o preço. O valor vai num documento à parte, montado pelo sistema, só a quem aceita valores.
• Cada facção tem os seus contatos, e cada contato, a sua política de valores (desde a v10.46): só a parte operacional (o padrão), recebe os valores, ou pede a sua confirmação a cada vez. O operador recebe a ordem; o dono ou o financeiro, o fechamento.
• O fechamento vai só a quem aceita valores, e a ocorrência se decide (desde a v10.46). Uma falta ou uma avaria é decidida por quem gere: refação, perda absorvida (a empresa absorve) ou descontada da facção (as peças vezes o preço por peça da ordem saem do fechamento). Só a perda com quantidade, de uma ordem com valor, se desconta: a sobra não é perda, e a ordem sem valor não tem o que descontar. Enquanto não é decidida, fica "a decidir", fora do total.

2.6 As pessoas

• Quem leva as peças conta com uma mão, sem teclado; quem gere senta e olha dinheiro. Dois contextos, dois aplicativos, um endereço.
• Cada empresa vê só o que é dela. Toda linha de operação pertence a uma empresa, e a permissão de leitura e de escrita é conferida pelo servidor, não pela tela.
• A máquina lê; quem confirma é gente. A foto de um romaneio vira uma leitura proposta; nada muda no sistema sem um toque de quem gere.
• A fala de quem opera vence a dedução de quem constrói. Quando o sistema e a prática divergem, muda o sistema — e este documento diz onde ele ainda não mudou.

4.1 Início

Quem gere entra e já cai na cidade (desde 08/10/2026, v10.34; a cidade e o escritório sobre ela desde a v10.37): o Início de quem gere é a cidade da confecção (§4.4) ocupando a tela, e o escritório é o que fica por cima dela:

• em cima, a saudação com a frase-resumo ("6 facções com peças, 1 atrasada") e a busca — a facção pelo nome, o lote pelo código e, desde a v10.41, uma tela ou um lugar da cidade pelo nome: a câmera vai até a facção, o lote ou o lugar; a tela abre quando o nome é escolhido da lista ou confirmado com Enter (digitar o nome de uma tela não tira você da cidade no meio da palavra). A barra (/) fora de um campo de texto e Ctrl+K levam ao campo;
• a régua: os cinco números de agora numa linha só — nas facções, em mão, passaram do prazo, a pagar na semana (com as vencidas), pendências —, os mesmos do Kanban, do Financeiro e da Conferência ("nas facções" mais "em mão" é o "Em produção agora" do alto do Kanban — "em mão" é tudo o que está no galpão, o que nunca saiu mais o que voltou; "a pagar na semana" é o primeiro número da aba A pagar do Financeiro). Tocar num número leva à praça dele e abre o painel dela; o custo acumulado e as peças a menos na volta moram nas praças do Dinheiro e da Qualidade;
• as visões, numa coluna à esquerda: Visão geral, Atrasos, Financeiro, Replay, Cinema, mais Ver tudo e Modo leve;
• a etiqueta à direita, presa ao item tocado por um fio, com o que está nele e as ações (Registrar saída para cá, Buscar nesta facção, Editar cadastro); no mesmo lado, a praça aberta numa gaveta, que empurra a câmera para o item continuar à vista; a bússola, que aparece no canto de baixo do mapa quando a cidade foi girada;
• os lugares da cidade, que guardam as telas (v10.41): tocar na expedição, no escritório (a placa diz "Pedidos"), no cadastro, no arquivo ("Documentos"), no quiosque ("Como funciona") ou no mirante abre a etiqueta com as portas — um botão por tela. A expedição abre Registrar, Buscar na facção, Ordens de serviço e Pendentes de envio; a matriz, o Kanban (com o número "em produção" ao lado, o mesmo do alto do quadro) e o Novo lote; cada praça leva à tela dona dela. No computador, sem nada tocado, a etiqueta lista os lugares (e, quando não há o que fazer, ensina os gestos); no celular, toque no lugar no mapa ou use a busca. O menu continua igual: a cidade é mais um caminho, não o único;

  

• Para fazer agora (desde a v10.44): a lista do que pede ação, a mais urgente primeiro, uma ação por linha — buscar a remessa que venceu ou vence hoje (a mais vencida primeiro; as vencidas são as mesmas de "passaram do prazo"), pagar as contas vencidas, conferir o que espera a sua decisão, dar o valor às ordens de serviço que saíram sem valor (as de facção que ficaram sem valor — desde a v10.47, a ordem que sai da rua já recebe o preço da tabela no servidor; ficam sem valor a da facção que ainda não tem preço na tabela e a que quem gere deixou em branco, e essas pedem; a de uma etapa feita em casa, não) e levar o que está em mão para a próxima etapa da rota — quando a próxima é feita em casa, a linha diz "Fazer Corte em casa", e é só de quem gere. A produção em casa não entra no "buscar": não tem facção nem prazo. Na linha de buscar e na de levar, o código do lote abre a tela do lote — o caminho pela rota e o que aconteceu (§4.4); a ação continua uma só, o botão. No computador ela abre a coluna da direita quando nada está tocado e a gaveta está fechada, e os gestos da etiqueta cedem a vez a ela; tocar num item ou abrir uma praça a tira de lá, e ela volta quando nada está tocado. Mostra duas linhas — uma, numa janela como a de 1280 × 800 —, e o resto num "e mais", para a lista dos lugares caber inteira embaixo dela. Numa janela baixa (um notebook de 1366 × 768) as duas não cabem juntas: ela vira uma linha só — "Para fazer agora", com o número e a palavra da mais urgente — que abre no lugar. No celular, o botão Para fazer, ao lado de Visões, a abre numa folha, com o número de linhas ao lado; sem nada a fazer, o botão não aparece. Os números dela são os das telas donas (o prazo pelo dia de São Paulo e a tolerância da empresa, as pendências da Conferência, a régua do Financeiro); se a lista não puder ser montada, ela diz isso, em vez de ficar vazia;
• embaixo, o dock das ações do dia (Registrar remessa, Buscar na facção, Novo pedido, Cadastrar facção) com a fita das etapas do lote ao lado, e a frase do que acabou de acontecer, que sai sozinha depois de alguns segundos.

Sair do Início e voltar devolve a cidade como estava (v10.41): a câmera, a visão e o item tocado — no celular, a câmera e a visão. Vale também ao recarregar a página; fechar a aba esquece. A câmera que ninguém mexeu não é guardada (a cidade se enquadra de novo na janela), e a do Cinema e a do Replay também não.

Os avisos de operação (lote parado, o que espera conferência) não são cartões: são as bandeirinhas no mapa e a marca de pendências na régua, que abre a Praça da Conferência. As faltas, as sobras e as avarias registradas nos últimos 30 dias estão na lista da Praça da Qualidade (v10.41). Só o aviso de sistema (sem sinal, modo leve) aparece, curto, no topo: quando uma leitura falha — sem sinal, ou com o sistema fora do ar —, ele diz de que horas são os números da tela e sai sozinho na leitura seguinte que der certo (desde a v10.40; até ela, a tela seguia com o último número sem avisar). A hora é a da última leitura que chegou, com o dia quando não é de hoje; a leitura que não responde em 30 segundos conta como falha, e a tela tenta de novo; e quando as peças chegam e as contas, as pendências ou o cadastro de facções não, o aviso diz que essa parte da tela pode não ser a de agora. Ao abrir, a câmera mostra a matriz, as praças e todas as facções dentro do espaço que o escritório deixa livre — com poucas facções, de perto (as casas com o nome); com muitas, de mais longe (os bairros como manchas). O escritório só recebe o toque nas suas peças: o mapa por baixo do espaço vazio da coluna da direita e da faixa de baixo responde ao toque. No celular e no tablet em pé (até 900 px de largura, o mesmo corte do resto do app) a cidade ocupa cerca de 62 % da tela (num celular baixo, ou com um aviso no topo, só o que cabe acima da barra de baixo, para os botões do dia não ficarem escondidos), a régua rola de lado, as visões ficam num botão, e a etiqueta, a praça e a fita sobem numa folha, com o arrasto para baixo; o dock é a barra de baixo. O tema escuro é a cidade à noite. Cada facção cadastrada é uma casa no bairro da cidade dela, com ou sem peça; a cadastrada agora nasce no mapa quando se volta ao Início. Na primeira vez, sem nenhuma facção, o Início mostra o primeiro passo sobre a cidade vazia: cadastrar as oficinas — uma remessa precisa de um lote, que precisa de um pedido, que precisa saber para qual oficina a peça vai. Quem leva as peças tem o Início de sempre — os cartões grandes de Registrar e Buscar na facção — e, desde a v10.44, antes dos números, a mesma lista Para fazer agora, só com o que é da rua: buscar o que venceu ou vence hoje e levar o que está em mão para a próxima etapa; cinco linhas à vista, e o resto num "e mais". O código do lote, em cada linha, abre a tela do lote.

4.2 Cadastros

A tela Cadastros tem seis abas — Facções, Clientes, Produtos, Preços, Etapas e Quem leva as peças; Peças e rotas é outra tela, no mesmo grupo.

• Facções (oficinas). Nome, o que cada uma faz, cidade, telefone com DDD (é por ele que a ordem de serviço vai para o WhatsApp da oficina), responsável. Uma oficina desativada some das escolhas e fica na história.

  

• Os contatos de cada facção (desde a v10.46). No cartão da facção, + Contato: o nome, a função (operador, dono, financeiro, outro), o WhatsApp com DDD, se é o principal e a política de valores — só a parte operacional (o padrão), recebe os valores, ou pede a sua confirmação —, com a consequência escrita ao lado da escolha, antes de salvar. O principal vem escolhido na hora de abrir a ordem no WhatsApp. Contato se desativa pela tela: sai da escolha e fica na história. Quem leva as peças vê o nome e a função, nunca a política.
• Preços. A tabela de sugestão: por oficina e etapa, com vigência (o preço de agosto não recalcula julho), e a exceção por pedido ("neste pedido o silk é mais caro"). É sugestão: o valor de cada serviço se diz no ato. Desde a v10.47, cada preço tem a unidade — por peça, pelo lote ("R$ 300,00 pelo lote"), por quilo ou por dia ("R$ 6,00 por quilo") —, com o que ela quer dizer escrito ao lado da escolha (pelo lote: o valor vai sozinho só à ordem da saída que leva o lote inteiro); trocar a unidade é uma vigência nova, como trocar o valor.
• Clientes. Nome, documento, endereço, contato. Um cliente inativo some das escolhas.
• Produtos. Grupo, categoria, tecido, cor, a grade padrão e a rota padrão — os dois aprendidos no primeiro pedido que os usa e oferecidos nos seguintes.
• Quem leva as peças. Quem gere convida: o app gera o código e a senha numérica, mostrados uma vez; uma senha nova derruba as sessões abertas daquela pessoa; desativar encerra o acesso no próximo contato com o servidor.
• Etapas. As etapas de produção da empresa (corte, bordado, estampa, costura reta, costuras diversas, acabamento…), com cor e ordem sugerida. A rota de um pedido escolhe entre elas. Desde a v10.47, cada etapa diz como se faz — feita em casa ou mandada à facção —, ao criar e depois, por Passar a feita em casa e Passar a mandada à facção, com a consequência dita antes do toque: muda a próxima saída para ela; o que já saiu segue como está até voltar; e as ordens de serviço abertas da etapa — as com valor seguem com a proposta de pagamento; as sem valor passam a ser lidas como processo interno e saem do "Dar o valor" (ou, de volta à facção, voltam a pedir valor), com quantas são.
• Peças e rotas. Outra tela, só de leitura: o que se produz, pedido a pedido — cada item com a grade e a rota que segue —, e as facções com o que cada uma faz.

4.3 Pedidos

• Pedidos. A lista, com a grade de cada item, o lote, o prazo em palavras e o semáforo. Abrir um pedido permite corrigir cliente, referência, prazo e valor cobrado; mudar a rota do pedido (incluir, tirar, reordenar) com a produção andando — o botão fica em cada item, e a rota salva vale para todos os itens e tamanhos do pedido; só no pedido cujos itens já seguem rotas diferentes ela vale para aquele item apenas. A tela diz antes para quem vale e o que muda: "Com esta rota, a próxima etapa das 20 peças do lote L-1 que estão em Corte passa a ser Costura"; tirar uma etapa já feita pede um segundo toque e não desfaz o que foi feito. A linha de cada lote diz o que ele já fez e a próxima etapa do lote inteiro — a primeira da rota que o lote ainda não concluiu. Quando o quadro manda todas as peças do lote voltar para essa etapa (uma etapa do começo feita e nunca registrada, ou incluída na rota depois), a linha diz o mesmo que ele, "a rota sugere voltar para Corte; confira", e não a chama de próxima (desde a v10.43). Cada lote tem Ver o lote (a tela do lote, §4.4), e o cartão do pedido com lote tem Consolidado (desde a v10.45). No item sem tamanho de um pedido que tem grade, a tela diz que o lote não abre com ele e oferece Dar tamanho único (U): o item passa a ter o tamanho U, com as mesmas peças, e o lote do pedido pode levá-lo, dito antes do toque. Em pedido com lote antigo o botão pode não aparecer, e a tela diz por quê (desde a v10.46). Limite: as quantidades de cada tamanho de um pedido que já tem lote não se corrigem pela tela; o tamanho único do item sem tamanho, sim (acima).

  

  

• Novo pedido. O cliente (ou "+ Cliente sem sair do pedido"), a referência, o prazo de entrega ao cliente; cada item com o produto, modelo, cor, tecido, um campo por tamanho com o total ao vivo, o preço cobrado por peça e a rota; e a opção "Abrir o lote de produção agora" (marcada por padrão). A gravação é em ordem — o cliente se for novo, o pedido, os itens numa chamada só, a rota numa chamada só, o lote pelo portão — e, se a rede cair no meio, gravar de novo retoma de onde parou sem duplicar. Um pedido não mistura item com tamanho e item sem tamanho: cada saída dele é contada por tamanho, e o lote não abre com uma peça sem tamanho. A tela avisa no cartão do item e não segue, dizendo qual é o item; a peça de tamanho único leva o U — o botão Usar tamanho único (U), no cartão, põe o U e leva a quantidade já digitada (desde a v10.46).
• Começar pela foto (funciona com limite, desde a v10.47). No primeiro passo do Novo pedido, Tirar foto ou Escolher a foto ou o PDF da ficha, do pedido do cliente ou da anotação: a foto fica guardada em Documentos, uma máquina a lê, e o formulário abre preenchido com o cliente, a referência, o prazo, o total e os itens — o produto, a cor, o tecido e a grade nos campos por tamanho. Nada do pedido é gravado até "Gravar pedido": você confere, corrige e grava como sempre. A leitura só preenche o campo vazio; se você já começou os itens, a tela pergunta antes de trocar (Trocar pelos itens da foto ou Manter os meus). Cada campo que a leitura preencheu diz a confiança: lido com 80 % ou mais, confira abaixo disso — e sempre na grade deduzida (quando o papel diz uma regra para vários itens, como "cada cor: P5 M10") —; o que você muda vira corrigido, e o passo de conferir mostra o lido × confirmado. O preço não se lê da foto: o campo fica vazio para você dar. A observação que a foto traz (por exemplo "entregar embalado") aparece no aviso da leitura e não é gravada: o pedido não tem campo para ela — anote onde precisar. Ao gravar, a foto fica ligada ao pedido, com o que foi lido e o que você confirmou. Se a leitura falha — sem sinal no envio, a máquina não leu, mais de 4 minutos, ou nada achado —, a tela diz e o formulário segue como sempre. Também se chega aqui de Documentos, pelo botão Montar o pedido com esta leitura. Limite: a leitura pode levar alguns minutos, e um pedido real nunca foi lido por ela — só fotos de ensaio.
• Novo lote. Quando o pedido sai em partes: o lote com a grade que sai desta vez. Nasce pelo portão, com a grade, e só anda por tamanho. O lote "só com o total" é o do pedido em que nenhum item tem tamanho; num pedido com grade, o item sem tamanho não entra no lote — a tela diz antes, com o nome do item, o botão fica desligado, e o tamanho se dá em Pedidos (desde a v10.46).
• O pedido, consolidado (desde a v10.45). A folha de um pedido, para imprimir: as peças de cada lote — as declaradas, as efetivas (com as faltas e as sobras das ocorrências), as prontas (as que passaram pela última etapa da rota) e as que seguem em produção (as que ainda não passaram por ela), e por tamanho quando a rota está cumprida —; as perdas e as sobras, com a resolução de cada uma; o custo contra o cobrado — o custo das ordens de serviço pela régua de Relatórios (§7.1), com a ordem que saiu sem valor contada e não somada, o valor de venda, a margem e a situação da conta a receber. A margem é a de Relatórios: sem nenhuma ordem de serviço, não há margem ("nenhuma ordem de serviço ainda"); com uma ordem sem valor, ela sai avisada, "falta valor" —; e o que aconteceu com cada lote. Enquanto o pedido está em produção a folha diz que é parcial e o que falta na rota de cada lote; ela fica completa quando todas as etapas da rota fecham para todas as peças — a etapa que ficou para trás, se foi feita, se marca como feita em casa, no quadro. Se os lotes abertos somam menos peças que as combinadas, a folha diz quantas. É de quem gere: tem dinheiro.

4.4 Produção

• Registrar (levar). O passo a passo da saída: o lote, a etapa e a oficina que recebe → a contagem por tamanho (botões grandes; o lote diz quantas de cada tamanho ainda estão em mão) → o prazo que a oficina deu → a foto. Quem gere informa também o valor por peça combinado agora (a tabela como sugestão). Nasce a ordem de serviço, numerada no servidor, com a grade deixada. Se as peças estão numa oficina, o mesmo Registrar leva para outra (mover = transferir). Quem gere escolhe também a unidade do valor: por peça, pelo lote, por quilo ou por dia (desde a v10.47; por quilo e por dia, o total se dá no Financeiro). Com a etapa feita em casa, o Registrar de quem gere muda: o lote e a etapa, sem facção → a contagem → quem faz (opcional) e a observação, sem foto nem prazo → Registrar Corte em casa: as peças entram em produção em casa, sem ordem de serviço, e o comprovante interno fica em Ordens de serviço. Quem leva as peças lê "Mandar para a produção em casa é de quem gere: quem leva as peças registra a saída para a facção e as voltas.", e o botão não segue.

  

  

• Buscar na facção (a volta). As remessas abertas daquela oficina; a contagem por tamanho do que voltou — tudo, ou uma parte com o seu comprovante numerado; "a oficina devolveu tudo o que tinha" fecha a remessa e registra a falta ou a sobra por tamanho, com o porquê. Sem ninguém tocar num contador, o botão diz a conta por extenso: "Contei: voltaram as 50". A remessa da etapa feita em casa aparece na mesma lista, "em produção em casa", e a volta dela é a Volta da produção em casa — a mesma contagem, em partes, com a falta e a sobra —, com o comprovante interno, sem WhatsApp (desde a v10.47).
• Kanban (o quadro). A foto dos lugares: uma coluna por etapa, e em cada uma as remessas abertas e as peças em mão; cada cartão diz "a seguir: …" pela rota. Mover pelo quadro é o Registrar de quem gere, em folha: pergunta por tamanho, o prazo, o valor, e diz a consequência antes do toque. A etapa feita em casa tem botão próprio e não gera ordem. Desde a v10.47, mover para uma etapa cadastrada como feita em casa abre Fazer Corte em casa: a grade e quem faz, sem facção, sem preço e sem prazo; o cartão das peças diz "em casa · Bia Ensaio" e "em produção em casa", e a produção em casa não conta no número de facções do alto. No alto, quatro números: em produção agora, peças paradas, voltaram e não seguiram (o que voltou de uma facção e está na sua mão, à espera da próxima saída) e falta sem explicação. Até a v10.40 o terceiro se chamava "Em mão" — o nome que a régua do Início dá a outra conta, tudo o que está no galpão; desde a v10.41 cada conta tem o seu nome.

  

• Mundo. A operação inteira numa cidade isométrica, só de leitura (desde 08/10/2026) — e, desde a v10.34, o próprio Início de quem gere (§4.1). A cidade (v10.37): a matriz no centro cívico, com o anel viário em volta e as cinco praças; um bairro por cidade das facções, com a avenida que leva o nome dele; cada facção numa casa de frente para a rua, com ou sem peça — a porta aberta (de dia) ou a janela acesa (de noite) diz que há peças lá; cada amarrado de peças no pátio de onde está, na cor do produto; o anel no chão é o pior prazo das peças daquela facção (verde, âmbar, vermelho — e a palavra na etiqueta: a cor diz a gravidade e a palavra, o estado. Com remessa vencida a casa diz "atrasada" — âmbar enquanto o atraso está dentro da tolerância da empresa, vermelho quando passa dela —, e são essas as facções que a frase do alto conta. Um limite conhecido: a remessa aberta e vencida de um lote já concluído entra na conta do alto e na régua, e a casa não a mostra — o mapa não desenha lote concluído. Até a v10.41 a vencida dentro da tolerância dizia "atenção"); o alfinete marca a remessa vencida; a bandeirinha, o que espera decisão. As praças respondem uma pergunta cada, e o totem diz o número de agora pela mesma régua das telas (§7.1): do Prazo (o que vai atrasar? → Kanban e Agenda), do Dinheiro (quanto devo e quanto vou receber? → Financeiro), da Produção (onde está o meu volume? → Kanban e Pedidos), da Conferência (o que espera a minha decisão? → Conferência) e da Qualidade (quanto se perde na volta? → Kanban e Relatórios; o painel dela lista também as ocorrências em aberto dos últimos 30 dias, a mais nova primeiro, cada linha levando à facção); tocar no totem abre o painel da praça, com os gráficos e "Abrir no escritório" — onde a praça tem duas telas donas, um botão para cada ("Abrir no Kanban", "Abrir na Agenda", "Abrir em Pedidos"). A altura do totem não quer dizer nada: só a faixa de cor e o número. Há três níveis de leitura conforme se aproxima: Panorama (os bairros como manchas com o pior status), Bairro (as casas, os anéis, as bandeiras) e Quadra (a etiqueta de cada amarrado ao pairar). Nada se move sem registro: uma saída ou uma volta registrada vira uma van pelas ruas em até 15 segundos; entre dois registros, nada anda. As visões mudam o que acende sem esconder nada (Atrasos deixa na cor o que venceu ou vence hoje e Financeiro, a facção com conta a pagar na semana — a mesma regra no mapa em 3D e no modo leve; Replay toca a semana em 30 segundos; Cinema é a noite com a câmera visitando as praças). Toda ação leva à tela que grava — a etiqueta da facção oferece "Registrar saída para cá", "Buscar nesta facção" e "Editar cadastro", e cada tela de destino já abre nela; aqui nada se grava. A facção cadastrada agora nasce no mapa ao voltar ao Início. Num computador sem placa de vídeo, a mesma cidade aparece vista de cima (modo leve). Em Mais → Produção → Mundo fica a TV: só a cidade, de noite, com o passeio pelas cinco praças e a faixa de baixo dizendo o número de agora de cada uma — sem o escritório. Num aparelho que cai no modo leve o passeio para e a faixa se cala: o mapa visto de cima mostra os cinco números.

  

• Agenda. Em cima, "Fora agora": cada remessa que ainda tem peça numa facção, com o prazo em palavra (no prazo, vence hoje, vencido), a marca "buscada em parte" e o atalho "Buscar". Embaixo, os dias, de hoje para trás, com o que foi registrado em cada um — cada saída e cada volta que fechou uma remessa, no dia e na hora de São Paulo (§7.1), a mais nova primeiro; o dia sem movimento aparece, vazio.
• Pendentes de envio. O que ficou guardado no aparelho (§6.5): de quem é, quando, e o que o servidor respondeu.
• Lotes (desde a v10.45). O caminho de um lote e o que aconteceu com ele, num lugar só — para os dois papéis, e sem dinheiro nenhum. O caminho: as etapas da rota, na ordem, cada uma com a palavra do estado (Feita, Feita em casa, Em parte, Em curso, A seguir, Ainda não) e, embaixo, as peças que estão numa facção dela agora, com o prazo em palavra, a etapa que vem depois e o atalho Buscar — e as que estão em produção em casa, "20 peças em produção em casa (Bia Ensaio)", com o atalho Registrar a volta (desde a v10.47); no alto, as peças em mão, com a próxima etapa delas — a de onde elas estão, a mesma que o quadro diz — e o botão para levar. "A seguir" é a próxima das peças em mão: sem peça em mão, nenhuma etapa se chama assim; e quando a rota manda voltar a uma etapa que ficou para trás, a tela diz que a rota sugere voltar, como o quadro. As peças numa facção de uma etapa que saiu da rota aparecem à parte, "Fora da rota", com o Buscar. O que aconteceu: as saídas (com a ordem de serviço), as ordens e os comprovantes abertos no WhatsApp ("OS-0007 aberta no WhatsApp de Bia Ensaio (operador) às 14h02" — aberta, e não enviada: quem envia é a pessoa, no WhatsApp dela), as retiradas (com o número do comprovante), a entrada em produção em casa e cada volta dela, a remessa que fechou, as ocorrências, as etapas feitas e reabertas em casa e as fotos, do mais novo para o mais antigo, no dia e na hora de São Paulo — a retirada guarda só o dia, e aparece depois da saída da própria remessa. Para quem leva as peças, a ocorrência e a etapa feita em casa aparecem sem a resolução e sem o texto de quem gere. Para quem gere, cada passo diz por quem foi feito, quando se sabe ("por Bia Ensaio"), e a decisão da ocorrência aparece na hora em que foi tomada. Sem um lote escolhido, a tela lista os lotes em produção; quem gere chega também pela linha do lote em Pedidos.

4.5 Conferência e Documentos

• Conferência. O que pede a sua decisão, e nada muda sem um toque: a leitura de uma foto de romaneio, campo a campo, para confirmar ou descartar (com motivo); o aviso de peças que não fecham (chega em segundos, §6.3); o de lote parado e o de remessa sem prazo (chegam de manhã, §6.4). Os avisos dizem o que viram; quem decide é você. Desde a v10.47, cada campo da leitura diz a confiança da máquina nele — lido com 80 % ou mais, confira abaixo disso — e vira corrigido quando o valor na tela não é o que ela leu; depois de aplicar, o documento da foto guarda o lido × confirmado. A leitura de antes, sem a confiança por campo, não ganha marca.

  

  

• Documentos. A foto de romaneio ou de ordem de serviço, ligada à saída ou à volta em que foi tirada; o que a máquina leu dela; "dar baixa" em documento já tratado. A leitura pode levar alguns minutos, e a lista desta tela só se renova numa carga nova do app: para ver o resultado, feche o app e abra de novo. Desde a v10.47: a leitura mostra só os campos de produção (lote, facção, etapa, quantidade, datas, se o papel está assinado) — o valor em dinheiro não aparece; a foto de um pedido (o tipo "Pedido (foto da ficha)", só de quem gere) mostra o cliente, os itens e a grade que a máquina leu, com Montar o pedido com esta leitura (abre o Novo pedido preenchido) ou Virou o pedido quando já foi gravado; e o documento confirmado mostra o lido × confirmado — o que a máquina leu, o que ficou, e o que foi corrigido. Quem leva as peças não vê a foto de um pedido.

  

4.6 Ordens de serviço

Uma por movimento, numerada no servidor (OS-0001, OS-0002…), com a grade deixada, o produto e a cor e o prazo de volta; a via impressa (PDF, uma linha por tamanho para a oficina preencher na devolução) e o Abrir no WhatsApp — que abre o WhatsApp de quem está com o aparelho, com o texto pronto; quem envia é a pessoa, e nada sai pelo servidor. Cada retirada tem o seu comprovante, no fim da tela e impresso junto da ordem. A folha diz quando a ordem foi emitida e quando a entrega foi confirmada, no dia e na hora de São Paulo (§7.1).

• Sem valor, desde a v10.46. A folha impressa e a mensagem do WhatsApp não levam o preço por peça, o combinado nem o "a pagar": a via da parede da oficina é operacional. O valor de uma ordem está no Financeiro e no Com o valor, um toque de quem gere na linha que não imprime: ele mostra o valor da ordem e prepara o documento com o valor para um contato que aceite valores — dois toques, preparar e depois Abrir no WhatsApp de X.
• A quem. O Abrir no WhatsApp tem a escolha Para quem: os contatos da facção (o principal vem escolhido) ou o telefone da facção. Vale no fim do Registrar, no comprovante da retirada, no recibo do Mover e aqui.
• Fica registrado. O toque grava "OS-0007 aberta no WhatsApp de Bia Ensaio (operador) às 14h02" — aberta, nunca "enviada": o sistema sabe que abriu o WhatsApp, não que a mensagem saiu. O registro aparece na história do lote (§4.4); sem sinal, fica guardado no aparelho e sobe sozinho. "Imprimir só esta" também fica registrado, como a via impressa.
• Um texto só. A mensagem que abre no WhatsApp é a mesma que o sistema monta e guarda no registro: a tela e o registro usam a mesma montagem. A última retirada de uma entrega encerrada com diferença diz a falta ou a sobra ("Faltaram 2 (M −2)"; "A entrega está encerrada").
• Sem retirada, sem WhatsApp. Quando nada voltou e a facção devolveu tudo o que tinha, a entrega encerra sem retirada: o comprovante aparece para ler com a facção ou imprimir, e a falta fica registrada no encerramento.
• O comprovante interno (desde a v10.47). A etapa feita em casa não tem ordem: depois das ordens vêm os comprovantes internos, um por entrada em produção em casa — a etapa, quem faz, o que entrou por tamanho, cada volta numerada e a falta ou a sobra —, para imprimir, sem valor e sem WhatsApp.
• A ordem por lote (desde a v10.47). O Com o valor diz Valor do lote — o combinado é o do lote inteiro, e a ordem não tem valor por peça.

4.7 Financeiro

• A receber: uma conta por pedido, lançada com um toque a partir do valor cobrado e do prazo de entrega.
• A pagar: uma conta por ordem de serviço — proposta pelo que voltou (ou pelo combinado, enquanto nada voltou, e a linha diz qual dos dois) —, ou solta (frete, combustível), sem ordem nem pedido.
• A ordem de quem leva as peças chega com o preço da tabela (desde a v10.47): o sistema o põe ao registrar, e quem gere o confere e o edita no lançar, como em qualquer ordem — sem sugestão nem "confira".
• A ordem que ficou sem valor (a da facção que não tinha preço na tabela no dia, ou a que ficou com o valor em branco) aparece, desde a v10.44, com o valor da tabela de preços quando há um para a facção naquela etapa, vigente no dia da emissão — o combinado para o pedido vence o padrão —, vezes o que voltou (ou o deixado, enquanto nada voltou: seria um adiantamento). Desde a v10.47, a tabela pelo lote sugere o valor do lote, como está; a tabela por quilo ou por dia diz o preço da unidade e não sugere total.
• A ordem por lote (desde a v10.47) se propõe pelo valor fechado do lote ("R$ 300,00 pelo lote"), e não pelo que voltou; no fechamento, a coluna do preço diz "pelo lote". A ordem por quilo ou por dia diz o preço da unidade e pede o total: "R$ 6,00 por quilo: o total combinado, diga ao lançar" — o lançar abre vazio; o total fica na conta, e o documento do fechamento o conta pelo lançado. A ordem de uma parte do lote (a tabela pelo lote, uma saída de 50 das 100 peças) sai sem valor e não recebe a sugestão do lote inteiro: a linha e o lançar dizem "o lote saiu em partes: diga o valor desta", e o lançar abre vazio. A ordem SEM valor de uma etapa feita em casa — a de antes, de quando ela se registrava como uma facção — aparece marcada processo interno e não propõe conta (lançar à mão continua livre); a ordem COM valor numa etapa que passou a ser feita em casa segue com a proposta de sempre, com a nota de que a etapa hoje é feita em casa. Na ordem sem valor com a sugestão da tabela, a linha diz que o valor é da tabela e pede conferência; o formulário de lançar abre com ele e repete o aviso, e quem gere lança ou digita o combinado. O custo do pedido não usa a sugestão: até a conta ser lançada, a ordem sem valor continua contada e fora da soma (§2.5).
• No alto da aba A pagar, quatro números: a pagar na semana (o que vence em até 7 dias, com as vencidas e as sem data — o mesmo número da régua do Início e do totem da Praça do Dinheiro, desde a v10.41), em aberto, vencido sem pagar e já pago.

  

• O fechamento de uma facção como documento (desde a v10.46). Na linha da facção, Documento abre a folha do fechamento: as ordens do período com o que voltou e o preço da ordem, as perdas e os ajustes (a ocorrência ainda aberta aparece "a decidir", com o Decidir) e, para cada contato da facção, Imprimir para X e Preparar para o WhatsApp de X — o sistema monta o documento, com o total, e o segundo toque o abre no WhatsApp. O contato que recebe só a parte operacional aparece desligado, com a frase do porquê; o que pede confirmação mostra a caixa "Confirmo enviar os valores a X". O total é do sistema, com as decisões gravadas: a descontada da facção desconta as peças vezes o preço da ordem; a perda absorvida e a refação não descontam. A ordem de valor fechado (pelo lote, por quilo, por dia; desde a v10.47) entra pelo lançado — a conta a pagar dela no Financeiro (o lançado primeiro), o mesmo número dos Relatórios — e, sem conta, pelo combinado, quando a remessa voltou toda; a que ainda tem peça na facção aparece aguardando, fora do total; sem conta nem combinado, fica fora do total; a folha e o "Com o valor" dizem o mesmo número; a perda de uma ordem que não é por peça aparece sem desconto calculado — o desconto, se houver, quem gere combina com a facção —, e o Decidir dela diz isso no lugar de oferecer o desconto.
• Baixa total ou em parte (a parcial acumula); cancelar, nunca apagar. Fechamento por oficina no período: o combinado nas ordens, o lançado, o pago e o que falta — com filtro por datas, oficina e etapa.

  

• Limite: sem parcelas nem estorno; a conta é uma por entrega, não por retirada.

4.8 Relatórios

O custo por pedido contra o cobrado, com a margem e a linha que diz de onde o custo veio (§2.5); o fechamento por oficina; a tabela de preços com vigência; as ocorrências (falta, sobra, lote parado…) e a decisão de cada uma — a que está em aberto se decide em Decidir (desde a v10.46): refação, perda absorvida ou descontada da facção, com a consequência dita antes do toque; o sistema guarda quem decidiu. "Descontada da facção" não aparece para a sobra, para a ocorrência sem quantidade nem para a de uma ordem sem valor — e a tela diz por quê. Nada de fiscal: o sistema calcula quanto pagar; quem paga é você.

4.9 Mais

O tema, o Sair e "Sobre o app": a versão em uso, a privacidade e os termos. Quando sai uma versão nova com o app aberto, aparece uma faixa — termine o que está fazendo e toque nela.

• A página da empresa (desde a v10.42; só para quem gere). No grupo Empresa, que abre o Mais e diz o nome dela. Tem duas partes. A ficha: o que o sistema sabe da empresa para trabalhar — o nome, as etapas na ordem do cadastro, quantas facções estão ativas, quantas pessoas ativas levam as peças (os Cadastros listam também as inativas), a tolerância de atraso que o app aplica (até ela a remessa vencida aparece em âmbar; depois, em vermelho, como parada; sem valor no cadastro, vale 2 dias) e, quando há um gravado para ela, o endereço da empresa no Trama — o que está gravado, não o do navegador; sem endereço gravado, ou se essa leitura falhar, a linha não aparece. O acompanhamento: o texto que a equipe do Trama escreve com a empresa. Enquanto ele não é publicado, a tela diz isso; se a leitura falhar (sem sinal, por exemplo), ela diz que o texto não carregou e oferece "Tentar de novo" — a ficha continua na tela.

  

6.1 O portão — a regra única, antes de gravar

Toda escrita de movimento — levar, buscar, mover, abrir um lote, marcar uma etapa feita em casa, aplicar uma leitura de foto, convidar quem leva as peças — passa por uma única porta do servidor. Antes de gravar, ela lê o estado dos lotes que a ação toca, aplica a regra única e recusa o que não fecha: mais peças saindo do que há em mão, mais voltando do que saiu, número único onde o lote tem grade, saída sem prazo. A mesma regra roda no aparelho, para dizer a recusa antes do toque, e roda no servidor de novo, porque só o servidor tem o estado de todos.

6.2 Onde cada peça está — derivado, não anotado

O sistema não guarda "o lote está na costura". Ele guarda saídas (remessas, com a grade que saiu) e voltas (retiradas, com a grade que voltou) e deriva o lugar de cada peça: em mão = o que nunca saiu mais o que voltou; na oficina X = o que saiu para X menos o que voltou de X. A próxima etapa de um conjunto de peças é a primeira posição da rota por onde elas ainda não passaram. Uma etapa feita em casa se grava como evento e conta como passada.

6.3 A sentinela — o aviso no mesmo dia

Se alguma escrita entrar por fora do portão (uma ferramenta de manutenção, um erro nosso), um vigia dentro do próprio servidor roda a regra única sobre os lotes tocados segundos depois e, se algo não fecha, abre um aviso na Conferência ("excesso"). Ele avisa; não conserta.

6.4 O agente da manhã

Todo dia, cedo, um agente de IA lê a base da empresa (só leitura, com uma credencial de alcance mínimo) e relata: a conferência de quantidade (0 erros é o esperado), lotes parados, remessas sem prazo, o último acesso, o que entrou de novo. O que ele acha vira proposta na Conferência; ele nunca grava movimento, nunca fala com a oficina, nunca envia mensagem. Numa base vazia ele diz só isso: vazia.

6.5 O campo sem sinal

Quem leva as peças tem a sessão e a última carga de trabalho no aparelho (sem dinheiro: preços, contas e clientes ficam de fora). A ação feita sem sinal entra numa fila com dono, com o mesmo identificador único que iria ao portão; quando o sinal volta, a fila sobe em ordem, uma ação por vez, e o portão confere cada uma contra o estado de agora — se alguém moveu as mesmas peças antes, a recusa fica em Pendentes com a frase, e a foto tirada sem sinal espera o registro a que pertence. A fila é de quem registrou: no mesmo aparelho, outra pessoa vê que há registros de outro dono, sem poder enviá-los.

6.6 A versão nova chega sem ninguém pedir — e só entra quando você toca

O app anda por endereços internos (#/registrar, #/pedidos), e por isso o navegador não procuraria versão nova sozinho: o app procura — ao abrir, ao voltar para a aba e a cada 30 minutos —, baixa a versão nova inteira para o aparelho e mostra a faixa "Há uma versão nova do app".

A versão nova espera. A tela em que você está continua inteira na versão anterior até você tocar em "Atualizar agora" — termine antes o que estiver contando ou digitando — ou até fechar o app e abrir de novo. Recarregar a página não troca de versão: a faixa volta. Sem sinal o botão some, e volta com o sinal. Com o app aberto em duas abas, a que recebeu o toque troca na hora e a outra mostra a faixa.

O rodapé e o "Sobre o app" dizem a versão em uso nesta tela; o que muda numa versão está no "Sobre o app".

Por que espera (v10.39). Uma tela que trocasse de versão enquanto carrega receberia metade de cada uma. Uma versão só entra inteira — e o que não faz parte do que abre sem sinal (o mapa de quem gere) é buscado de novo a cada versão, sem aproveitar cópia guardada pelo navegador.

7.1 As contas das praças — a régua de cada número (v10.37; a v10.41 acrescentou duas linhas)

Os números dos totens e dos gráficos das cinco praças da cidade saem de uma conta cada, a mesma da tela dona — se dois lugares mostrarem números diferentes com o mesmo nome, é defeito. Duas regras valem para todas: "hoje" é o dia civil de São Paulo em toda tela (o Início, o Kanban, a Agenda, o Financeiro, o Mundo e as praças) — num aparelho fora do fuso o número muda com o dia da confecção, nunca com o relógio do aparelho —, e toda janela conta em dias civis e inclui hoje ("30 dias" = de hoje − 29 até hoje; as semanas começam na segunda-feira).

Desde a v10.43, o dia e a hora de cada registro — a emissão da ordem e a confirmação da entrega, a saída e a volta na Agenda, o que chega à Conferência, aos Documentos e aos Pendentes de envio — também são os de São Paulo, em qualquer aparelho.