← Artigos IA

Escala 5x2: o projeto pessoal que nasceu de um áudio do meu irmão

Um áudio no WhatsApp virou uma PoC de escala 5x2 no ar em uma noite e, agora, um sistema para lojas e contadores, com Laravel, PostgreSQL e agentes de IA.

Iago Frota

No começo de novembro, meu irmão me mandou dois áudios no WhatsApp. Ele gerencia a loja da minha mãe e estava preocupado com dezembro.

A preocupação era simples de explicar e chata de resolver. Com o fim da escala 6x1, cada funcionário passa a ter duas folgas por semana. E alguém precisa montar isso. Toda semana.

A ideia dele era quase um pedido: um sistema em que você joga os nomes e ele distribui as folgas. No mesmo papo, ele lembrou da minha irmã, que tem uma loja com dois funcionários e ia passar pelo mesmo problema.

Fiquei com aquilo na cabeça… Este artigo conta como esse pedido virou uma PoC no ar e, agora, um sistema que estou terminando. É um projeto pessoal, feito no meu tempo livre, e quero ser transparente sobre o que já funciona e o que ainda está em construção.

Bora lá.

O problema da escala 5x2

A Emenda Constitucional 141 foi promulgada em 16 de outubro de 2026 e acaba com a escala 6x1. A partir de meados de dezembro, o repouso semanal passa a ser de dois dias, um deles preferencialmente no domingo. A jornada também cai, primeiro para 42 horas e depois para 40.

Parece só trocar um 6 por um 5. Não é.

Numa loja pequena, a escala vira um quebra-cabeça. A loja continua abrindo seis ou sete dias, ninguém pode emendar dias demais de trabalho, o domingo precisa de rodízio e o horário de pico precisa de gente. Some feriado, almoço e quem pode abrir e fechar as portas… Complica, né?

Quando pesquisei o mercado, encontrei dois extremos. De um lado, sistemas que geram a escala sozinhos, mas vendidos por consultor e pensados para redes grandes. Do outro, ferramentas baratas ou grátis em que a escala ainda é digitada à mão.

No meio da pesquisa, um dado me chamou atenção: tutoriais de planilha de escala no YouTube com dezenas de milhares de visualizações. No fim das contas, é assim que muita gente está resolvendo.

Antes de pensar em produto, eu queria responder uma pergunta só: meu irmão olharia para uma escala gerada automaticamente e diria “isso dá para usar”?

Para isso eu não precisava de login, banco de dados nem servidor. Fiz uma PoC (prova de conceito) em React com TypeScript, totalmente estática. A escala inteira vai no próprio link, então quem abre o link vê exatamente a mesma escala. O motor que distribui as folgas é TypeScript puro, separado da tela e sempre gera o mesmo resultado para a mesma entrada.

Do primeiro commit ao site publicado foram cerca de seis horas, numa única noite.

Ela continua no ar em escala5x2.up.railway.app. Você conta como a loja funciona, quem trabalha nela e quais feriados caem no período, e recebe a grade com as folgas já distribuídas e checadas contra as regras.

Admito que não foi tão limpo quanto parece. A primeira versão, só com a grade de folgas, ficou pronta em 49 minutos. Em vez de mandar para o meu irmão, eu pedi o “fluxo completo”: feriados, horas, mês seguinte, exportação.

O escopo cresceu antes de qualquer pessoa usar, e todo o retrabalho daquela noite veio daí. Um bug no campo de jornada chegou a ficar cerca de uma hora e meia no ar, de madrugada.

A lição ficou anotada: PoC precisa de um critério de pronto escrito do ponto de vista do usuário. E a versão mínima vai para ele antes de crescer.

O primeiro retorno

Logo depois da publicação, meu irmão testou e mandou outro áudio. A loja abre de manhã, fecha no meio do dia e abre de novo à tarde. E o almoço por lá é longo, de três horas a três horas e meia.

Nada disso estava previsto.

Os ajustes foram publicados cerca de 55 minutos depois do áudio, com os testes de ponta a ponta rodando também numa tela do tamanho de um celular.

Foi aí que caiu a ficha. A regra que eu imaginava sozinho no computador não é a regra da loja de verdade. Cada loja tem a sua rotina, e o sistema precisa acomodar isso sem virar uma planilha com outro nome.

A PoC provou a ideia, mas tem um limite claro: ela não guarda nada. Toda mudança gera um link novo.

Mostrando o projeto para uma contadora que já monta alternativas de escala à mão para os clientes, apareceu um segundo público. O escritório de contabilidade é quem orienta a loja sobre a lei, e é quem vai receber todas as dúvidas em dezembro.

Por isso estou terminando um sistema completo, em que:

  1. A empresa se cadastra com o CNPJ e cria as lojas, a equipe, os horários de funcionamento e os feriados.
  2. O sistema gera a escala do mês, com folgas e turnos, e aponta o que fere as regras.
  3. O gestor ajusta qualquer célula da grade, e a validação roda de novo a cada mudança.
  4. A contadora cadastra a empresa do cliente, monta uma escala e propõe. O dono aprova pelo celular.
  5. A escala sai em link de leitura, com prazo de validade, para mandar no WhatsApp, ou em planilha CSV e impressão.

Enquanto ele não sai, a PoC continua no ar para quem quiser testar.

Sobre a arquitetura

Aqui entra a parte técnica, que é a que eu mais gosto de contar.

Neste projeto eu não escrevo código. Eu especifico, defino a arquitetura e valido. Quem implementa são agentes de IA, e isso pesou em todas as escolhas.

Escolhi Laravel, com Inertia e React na tela, e PostgreSQL no banco. A primeira sugestão que recebi foi TypeScript de ponta a ponta, com bibliotecas mais novas. Recusei: elas dão liberdade demais para o código sair do trilho. O Laravel tem convenção para quase tudo, e convenção é exatamente o que eu quero quando quem escreve é um agente.

O código segue Actions organizadas por domínio, um DDD sem seguir o livro à risca. Cada caso de uso é uma classe com nome de verbo: GerarEscala, EditarCelulaDaEscala, EnviarPropostaDeEscala, DecidirPropostaDeEscala. Elas ficam agrupadas por contexto, como cadastro, equipe, lojas e escala. Bate o olho na pasta e você entende o que o sistema faz.

Algumas curiosidades desse caminho:

  1. O motor da escala é PHP puro. Ele não conhece o Laravel. E isso não é só combinado: um teste de arquitetura do Pest quebra o build se o motor usar qualquer coisa de Illuminate.
  2. O motor foi portado da PoC com paridade célula a célula. São 72 casos gerados pela versão em TypeScript que a versão em PHP precisa reproduzir exatamente. Se o porte mudar uma folga de lugar, o teste acusa.
  3. O isolamento entre empresas mora no próprio PostgreSQL, com Row Level Security. E os testes rodam com o mesmo usuário restrito da aplicação. Como superusuário, o banco ignoraria as políticas e o teste passaria sem testar nada.
  4. Toda alteração deixa rastro. A auditoria é feita por trigger no banco, então a mudança fica registrada com autor e diferença, venha de onde vier.

Testes como contrato

Ninguém lê todo o código linha a linha. Então os testes são o contrato entre mim e os agentes.

Sou QA, e essa é a parte em que eu mais me envolvi. Defini a arquitetura de testes com apoio dos próprios agentes, e algumas regras não se negociam:

  1. TDD sempre. Cada regra de negócio vira um cenário em Gherkin, sem Cucumber. O agente escreve o teste, mostra ele falhando e só depois implementa.
  2. O nome do teste é o título do cenário, com o código da regra. Um portão automático confere se todo cenário documentado tem um teste com o mesmo nome.
  3. Pest para o PHP e Playwright para o navegador, cada um no que faz de melhor. As jornadas rodam em tela de celular e de computador.
  4. Teste de mutação no motor. Não basta a linha estar coberta: o Pest altera o código de propósito e o teste precisa perceber. Hoje o motor está em torno de 99%.
  5. O QA é sempre outro modelo. Quem implementa não aprova a própria entrega.

Hoje são mais de mil testes no Pest, fora os de ponta a ponta.

Uma coisa me surpreendeu. Com essa estrutura de pé, passei a intervir pouco: faço revisões e olho pontos específicos. Para quem é QA, aceitar que nem tudo precisa da minha atenção foi um exercício e tanto de confiança no processo.

Para quem é

Se você tem uma loja pequena e está preocupado com dezembro, o sistema é para você. Você cadastra a equipe uma vez e, no mês seguinte, volta e monta a próxima escala a partir da anterior.

Se você é contador, também é para você. Em dezembro, a mesma pergunta vai chegar de vários clientes ao mesmo tempo. Ter um lugar só para montar, propor e acompanhar a escala de cada um economiza muita mensagem de WhatsApp.

Uma ressalva importante: a escala sai checada só contra as regras que eu programei. Antes de publicar para a equipe, vale passar pelo seu contador e olhar o acordo da sua categoria, que muda de cidade para cidade.

Conclusão

Por fim, o que começou com dois áudios de WhatsApp virou um site no ar em uma noite e, agora, um sistema quase pronto para lojas e escritórios de contabilidade.

Ainda tenho coisa para ajustar antes de abrir para todo mundo, porém, já é um começo!

Teste a PoC em escala5x2.up.railway.app com a sua equipe e me conta o que faltou. E se você é lojista ou contador e quer usar o sistema quando ele sair, me manda um e-mail em [email protected]. 👉

#escala-5x2#fim-da-escala-6x1#projeto-pessoal#laravel#postgresql#agentes-de-ia#testes

Acompanhe os próximos artigos

Assine o feed RSS ou me siga no LinkedIn, onde aviso quando sai texto novo.

Assinar o RSS Seguir no LinkedIn