O app inteiro, aba por aba

Antes de tudoQuem vê o quê

A tela que aparece depende da categoria do usuário — não existe menu com aba bloqueada nem link que burle a permissão. O Administrador tem um seletor de Visão no rodapé da barra lateral e pode olhar o app pelos olhos de qualquer time, inclusive escolhendo uma franquia específica.

Mudou em 27/08 A aba Estoque ficou restrita a Administrador e Franquia — Implantação e CS Proprietário deixaram de vê-la. As duas continuam com Enxoval por Imóvel.

Aba 1Calculadora Enxoval

Rota / · é a tela inicial do app · substitui a planilha de cálculo

Digita o código do imóvel e o app monta o pedido inteiro: proprietário, franquia de destino, configuração de camas e banheiros, itens com quantidade, frete e total. É aqui que a compra nasce — confirmar gera o card no quadro de Pedidos.

• Configuração editável — camas, banheiros e jacuzzi vêm do cadastro do imóvel, mas podem ser ajustados na hora; o que difere do Sapron fica destacado, com botão para voltar ao original.
• Fornecedor e frete — o fornecedor sai da região atendida e o frete da tabela dele para aquela UF, separando capital e interior. Trocar o fornecedor reprecifica o pedido inteiro.
• Itens avulsos — dá para lançar item fora das regras, à mão.
• Compra não vinculada a imóvel — um toggle permite pedido sem imóvel, usado junto com a franquia Decor (criada em 27/08, aparece no topo da lista e pede endereço na hora).
• Simulação — na visão Comercial, escolhe UF e qualquer município do Brasil para orçar antes de o imóvel existir.

Aba 2Pedidos de Itens — a compra

Rota /pedidos · substitui as planilhas de pedido da Matinali e da RM

O quadro onde a compra caminha, do link de pagamento até o embarque. Cada card é um pedido com número próprio (P-0001, P-0002…).

Aguardando Link de Pagamento→ Aguardando pagamento→ Pagamento Confirmado→ Enviado ·Link ExpiradoCancelado

O que trava e o que registra

• Para mover para Enviado: nota fiscal de compra, data de emissão da NF, data de embarque e — desde 26/08 — transportadora e código de rastreio. O pedido também precisa ter passado por Pagamento Confirmado.
• Cancelar exige motivo de uma lista fechada; é isso que o relatório conta por motivo.
• Autor de tudo — quem criou e quem moveu cada card fica registrado no servidor desde 25/08; movimentação anterior a essa data não tem autor e a tela diz isso.
• Comentários com anexo (PDF ou foto) dentro do card.
• Orçamento em PDF e link público para enviar ao proprietário — o link público não mostra os dados do proprietário.
• Franquia no rosto do card e filtro por franquia na barra (27/08), nos dois quadros.

Fornecedor vê o quê Só os pedidos dele. Desde 27/08 ele voltou a ver o CPF/CNPJ do proprietário no card, na calculadora e no orçamento em PDF — o link público continua sem o bloco do proprietário.

Aba 2 · automaçãoOs agentes que mexem no quadro

Dois robôs escrevem no quadro de Pedidos. Eles assinam o que fazem, então dá para saber no histórico do card o que foi pessoa e o que foi automação.

Agente de análise de pagamento

No ar desde 24/08, roda de hora em hora, das 8h às 19h. Ele abre os links de pagamento da Rede de cada card em Aguardando pagamento e decide sozinho:

• algum link pago → move para Pagamento Confirmado;
• todos expirados → move para Link Expirado;
• qualquer outra combinação → não mexe.

A decisão é determinística — não tem IA no meio — e ele assina a movimentação como “Agente de análise de pagamento”. Uma rodada leva cerca de 14 minutos para ~55 cards.

Agente de adequação (externo)

Cria pedidos direto no quadro, com a área, o analista e o link do orçamento. O app confere e corrige franquia de destino, frete e cluster na entrada. Cards dele têm o motivo de cancelamento próprio “Erro Agente”.

Ponto aberto Esse agente é de outro time. Ele carimba a data de criação com a hora do cron (não a do pedido) e chega a sobrescrever o fornecedor; os cards dele merecem conferência.

Aba 3Recompra de Enxoval

Rota /recompra · espelha o PIPE 12 do Pipefy de hora em hora, sem escrever de volta lá

O quadro da troca de enxoval a cada 2 anos. Ao abrir o card, o app recalcula com a situação de hoje — configuração do imóvel, proprietário, franquia responsável agora (que define destino, frete e fornecedor) e preços vigentes — e avisa o que mudou desde que o card nasceu.

Caixa de Entrada→ Contato com Proprietário→ Imóvel com Pendência→ Recompra Validada ·Cancelado

• Checklist de contato — seis passos (primeiro contato, tentativa de ligação, termo enviado, termo assinado, proposta apresentada, aguardando retorno), cada um guardando quem marcou e quando.
• Pendência em mudas — quando o proprietário aceita parte da troca (2 de 3 mudas), o card entra em pendência com o que falta e uma data de vencimento.
• Dois pedidos, no tempo certo — entrar na pendência já gera o pedido do que foi autorizado; validar o resto depois gera um segundo pedido só com o que faltava, sem repetir o que já foi comprado.
• Card manual (25/08) — botão “+ Novo card” cria a recompra de um imóvel na hora, com o retrato de hoje; se o imóvel já tem recompra em aberto, o app avisa antes.

Aba 5 · reformada hojeEstoque da franquia

Rota /estoque · Administrador e Franquia

A tela foi reordenada para a ordem do dia da franquia: ela abre o app para lançar a lavanderia que acabou de sair, não para consultar. O que é consulta desceu e nasce fechado — antes era meia tela de rolagem até chegar no que ela veio fazer.

Por que fechado por padrão São quatro tabelas na mesma tela e três delas são de consulta. Quem lança a rodada do dia não deveria rolar por elas antes de começar.

5.1  Lavanderia por imóvel — agora com vários imóveis

Antes era um imóvel por vez: escolhia, conferia, enviava, repetia. Agora a franquia marca quantos imóveis quiser na mesma rodada. Cada imóvel entra com a muda calculada dele (camas, banheiros e cluster), e a quantidade de cada peça soma sozinha conforme ela vai marcando — não precisa alterar nada.

O dropdown mostra só o código do imóvel; o subtítulo com cidade e proprietário saiu. Marcar não fecha a lista, então dá para marcar cinco seguidos, e o que já foi escolhido vira uma pastilha com ✕.

Lavanderia ou Lavagem em Casa: uma das duas, obrigatória

Cada item tem duas colunas e a franquia marca qual foi. É uma ou a outra, nunca as duas, e não existe padrão: a linha nasce vazia. Enquanto houver item sem escolha, o envio fica bloqueado com o aviso dizendo quais faltam.

Nos dois casos a peça sai do Disponível hoje — ela está fora, suja — e volta quando a remessa é concluída. O que muda é só o registro de onde ela está, que aparece com 🧺 ou 🏠 na remessa e no histórico.

Por que sem padrão Um padrão silencioso carimbaria “lavanderia” em peça que ficou na casa, e ninguém perceberia. O bloqueio é a única forma de o registro dizer a verdade.

Um envio, uma remessa por imóvel

Mandar 3 imóveis de uma vez cria 3 remessas, uma para cada — porque a volta acontece por imóvel: a lavanderia devolve o pacote de um antes do outro. O Concluído continua sendo do imóvel inteiro. Tudo é gravado numa transação só: ou a rodada inteira entra, ou nenhuma.

5.2  Lavagens concluídas — seção própria, fechada

O histórico de lavagem saiu de dentro do lançamento (era um botão “Ver concluídas”) e virou seção própria, fechada por padrão. Abrindo, mostra as remessas que já voltaram: o imóvel, quando foi enviada, quando foi concluída, quantas peças e a observação. Clicar na linha abre as peças, como era antes.

Por que saiu de lá A lista de concluídas cresce para sempre — a franquia lança várias por dia — e competia com o lançamento do dia dentro da mesma seção.

5.3  Disponível hoje — régua nova de um terço

A cor da coluna Disponível passou a olhar quanto está na lavanderia, não quanto sobrou. Passou de um terço do estoque fora, vermelho; abaixo disso, verde. Com 3 mudas, mais de um terço fora quer dizer que sobrou menos de duas mudas na prateleira.

Outros ajustes que entraram na aba

• O campo de contagem não pisca mais o valor antigo ao gravar.
• O botão “+ Registrar movimentação” avulso saiu — movimentação de lavanderia agora é sempre por imóvel.
• O ditado por voz chegou a entrar e foi revertido antes de subir para produção; o que ficou daquela leva é a reordenação da aba e a padronização dos títulos.
• No histórico, a saída lavada em casa aparece com o marcador 🏠 em casa.

Aba 6 · reformada hojeEnxoval por Imóvel

Rota /estoque-imoveis · leitura dos espelhos do Sapron

Esta aba responde quanto enxoval um imóvel já recebeu. Ela ganhou uma quebra por peça — clicar na linha do imóvel abre uma subtabela item a item — e duas fontes novas: a compra lançada como despesa no Sapron e o saldo contra a perda por dano.

Despesas: só duas das três subcategorias

A categoria Enxoval do financeiro do Sapron tem três subcategorias de peça. Agora entram só duas:

A despesa de dano não duplica a coluna de perda: a perda vem do guest_damage, que é a única fonte com quantidade, e a despesa é a compra da peça que substituiu a danificada. São colunas separadas, e é isso que faz o saldo andar.

Nomes de peça: Tapete, e lençol com virol

As fontes escrevem a mesma peça de jeitos diferentes — o catálogo do app usa TAPETE, o Sapron usa Toalha de piso e a operação digita “toalha de pano” (e até Tapete de banehiro, com 121 lançamentos). Tudo isso agora cai na mesma linha, chamada Tapete.

Do mesmo jeito, lençol e virol viraram uma peça só, por tamanho: a operação trata as duas como a mesma coisa e o dano chegava nas três grafias sem ninguém saber qual era. Pano de prato e Pano de copa seguem separados.

O que não casa aparece cru Nome que não bate com nenhum outro vira linha própria, com a grafia da origem. Sumir é pior que duplicar.

Aba 7Relatório e Análise

Rotas /relatorio (interno) e /analise (fornecedor, com os dados dele)

O painel de números do enxoval. Filtra por mês/ano ou intervalo de datas, combinando com fornecedor.

• Venda e comissão — desde 27/08 o que manda é a data de emissão da NF, não a fase do card: nota emitida sem embarque passou a contar, e mês já apurado parou de mudar de valor quando um card sai de Enviado. A comissão segue 5% sobre o valor sem frete.
• Tempo de despacho — média e maior tempo entre pagamento confirmado e embarque, com alerta a partir de 7 dias e a lista de quem ainda não embarcou.
• Cancelamentos por motivo — mostra onde a operação está perdendo pedido.
• Itens comprados — quantidade e valor por item no período.

Aba 8Configuração e Usuários

Grupo /configuracao/* e /usuarios · Administrador

Vista por cima: é aqui que o cálculo é ensinado ao app. Quase nada é fixo no código — item, preço, regra, frete e cluster são cadastro, e mudar aqui muda o próximo pedido calculado.

Cuidado com o token O token de sync dá escrita (cria e altera cards, regrava espelhos). Para outro time consultar “este imóvel tem pedido pago?”, use o token de consulta de Integrações, que é só leitura.

9 · ValidaçãoO que conferir no app

Tudo abaixo já está em produção. O caminho é Estoque e Enxoval por imóvel no menu.

• Ordem da tela de Estoque Lavanderia por imóvel é a primeira; Lavagens concluídas, Disponível hoje e Histórico aparecem fechados, só com o título.
• Marcar 3 imóveis e ver a quantidade somar Os três viram pastilhas; cada peça mostra a soma das mudas; o campo fica fixo. Desmarque até sobrar um: o campo volta a ser editável.
• Tentar enviar sem marcar onde lavou O botão deve estar apagado e o aviso em coral deve listar os itens que faltam.
• Marcar Lavanderia numa linha e Lavagem em Casa noutra, e enviar Devem nascer três remessas — uma por imóvel — e as peças devem aparecer com 🧺 e 🏠 ao clicar na linha.
• Concluir uma remessa Ela some de “Remessas na lavanderia”, aparece em “Lavagens concluídas” com a data de conclusão, e as peças voltam ao Disponível hoje.
• Conferir a cor do Disponível hoje Vermelho só quando mais de um terço do estoque daquele item está na lavanderia.
• Abrir a linha de um imóvel em Enxoval por Imóvel A subtabela deve trazer Ideal, Danos, Despesas e Saldo, com a linha “Tapete” no lugar de “Toalha de piso”.
• Conferir a comissão do mês no Relatório Ela passou a seguir a data de emissão da NF; a lista “Pedidos considerados no fechamento” mostra exatamente o que entrou, e dá para baixar em Excel.
• Olhar um card criado pelo agente de pagamento No histórico do card, a movimentação deve estar assinada como “Agente de análise de pagamento”.
• Testar no celular As tabelas viram cartões abaixo de 768px — inclusive as remessas e as lavagens concluídas.