O NaturalOrg organiza a alimentação: cardápio da semana, lista de compras, despensa e diário com calorias e macros pela tabela TACO. Dois recursos deram mais trabalho de engenharia: ler a nota fiscal do mercado e funcionar sem internet.
Da nota fiscal à despensa
A NFC-e (nota fiscal de consumidor eletrônica) tem um QR Code. O app lê o código pela câmera e consulta a nota na Secretaria da Fazenda. No Paraná, descobrimos que a consulta aceita uma URL montada somente com a chave de acesso de 44 dígitos, no formato .../nfce/qrcode?p=<chave>|3|1. Isso funciona até para QR Codes de versão antiga e para os impressos por totens de terceiros, o que simplificou muito o leitor.
Algumas regras aprendidas na prática:
- Só notas emitidas em modo normal são aceitas, não as de contingência;
- No layout da página do Paraná, a descrição do item fica em um elemento diferente do que a documentação sugere, e o código (EAN ou interno) em outro;
- Outros estados só entram depois de testados com uma nota real, para o app não prometer o que não sabe ler. Quando o estado não é suportado, o log diz isso claramente, e a chave digitada é o plano B;
- A chave da nota já aceita o CNPJ alfanumérico: o padrão é seis dígitos, doze caracteres alfanuméricos e vinte e seis dígitos, com o dígito verificador calculado pelo valor ASCII menos 48.
Perguntar antes de somar no estoque
Uma nota antiga não deve somar produtos que já foram consumidos. Por isso, ao importar, o app pergunta: "somar no estoque" ou "só no histórico". O padrão é somar quando a nota tem até três meses, e registrar só no histórico (com aviso) quando é mais antiga. O histórico de cada produto mostra o ritmo de compra, base para sugerir reposição.
Um bug que ensina: a "tela preta"
A primeira versão da importação enviava um item por vez. Com notas grandes, estourava o limite de requisições da API (120 por minuto); a resposta de erro (429) era tratada como se fosse dado e a tela ficava preta. A correção foi dupla: a importação virou uma única requisição, tudo ou nada, e o cliente passou a tratar a resposta de erro como erro. Moral: operações em lote precisam ser atômicas e o cliente precisa distinguir erro de dado.
Offline de verdade
O NaturalOrg é um PWA: instala no celular, e as mudanças feitas sem conexão entram numa fila que sincroniza quando a internet volta. Outro bug real: com a atualização automática do service worker, páginas já abertas nunca recarregavam, e celulares ficavam dias rodando JavaScript antigo. Passamos a recarregar a página quando o novo service worker assume o controle, mas só se a aba estiver oculta e sem nenhuma janela de edição aberta, para nunca perder o que o usuário está digitando.
Stack e capacidade
Monolito Laravel 12 com PostgreSQL servindo a interface React/TypeScript no mesmo domínio, em um container com limites de CPU e memória. O front estático ficou no teto do nosso teste de carga, com mais de 780 usuários simultâneos em um teste anterior.
Teste o NaturalOrg ou veja os outros sistemas.