tô feliz demais com o sendnf.
comecei querendo emitir nota fiscal sem dor de cabeça e virou api, whitelabel pra saas e um mcp pra agente de ia emitir conversando.
vídeo dele rodando aí embaixo
Melhor modelo de deploy é: Merge na main -> gera tag -> entrega tag -> revert pra tag anterior se der problema
A pior hora pra descobrir que você não tem rollback rápido é quando o bug já está em produção
Na primeira vez que isso acontece num sistema de pagamento, você aprende rápido
Hoje a primeira pergunta que eu faço em qualquer deploy é: quanto tempo leva pra voltar?
2
30
guardar tudo em UTC é a regra certa até a data de emissão da nota. nota emitida às 22h30 em Brasília já é dia seguinte em UTC, e aí a competência cai no mês errado no último dia do mês. data civil que importa pra lei vai com o fuso junto, não só o instante.
a OpenAI divulgou dados de como a IA mudou a pesquisa lá dentro: o uso sobe de forma exponencial e as tarefas que ela conclui sozinha ficam mais longas, mas o humano segue no centro. tarefa longa sem ninguém olhando é erro mais caro de achar. em produto, o que escala é a revisão.
7
UUID v4 como chave primária espalha as inserções pelo índice inteiro e a tabela grande sente isso. UUID v7 nasce ordenado por tempo e insere sempre no fim, e o Postgres 18 já tem uuidv7() nativo. mantém o id que não dá pra adivinhar sem pagar a fragmentação.
9
N+1 não aparece em dev com 10 registros. aparece em produção, na tela que lista 300 itens e faz uma query por linha. a tela abre em 8 segundos e ninguém acha o erro no código. log de query por requisição mostra o padrão na hora: a mesma consulta repetida 300 vezes.
1
51
cancelar nota fiscal não é apagar. é um evento com motivo, e a prefeitura pode negar depois do prazo. guarda a nota original intacta e o cancelamento como registro à parte. quem troca o status com UPDATE perde o histórico que o contador vai pedir.
154
a OpenAI disse que o ChatGPT for Healthcare agora usa computer use e ganhou mais de 20 plugins de saúde. clicar em tela é fácil. em área regulada o difícil é provar depois o que foi feito e por quê. quem constrói pra esse setor precisa registrar cada ação antes.
1
89
rate limit por IP pune quem está atrás do mesmo NAT: um escritório inteiro vira um usuário só e toma 429. limita por chave de API ou por conta e deixa o IP só como camada grossa contra abuso. e o 429 tem que mandar Retry-After, senão o cliente tenta de novo na hora e piora.
111
índice composto (a, b) no Postgres não ajuda quem filtra só por b. a ordem das colunas importa: a que você sempre filtra com igualdade vem primeiro. muita query lenta em produção tem índice criado, só que na ordem errada. o EXPLAIN mostra em 10 segundos.
2
304
mensagem de rejeição da prefeitura vem em texto livre e muda de redação sem aviso. decidir por regex na frase quebra no dia que trocam uma palavra. guarda a mensagem original e o código, e classifica por cima. erro novo cai em "não sei" em vez de virar "emitida" por engano.
339
lote de 200 itens com 1 falhando: se o job inteiro repete, os 199 bons rodam de novo. processa item a item, marca cada um como feito e deixa só o ruim voltar pra fila. reprocessar o lote todo é descobrir tarde que o código não era idempotente.
476
enum nativo do Postgres: adicionar valor é fácil, remover não dá sem recriar o tipo. texto com check constraint troca numa migration simples. o ganho do enum é pequeno perto da dor de mexer depois.
698
Pilulas de sabedoria
Replying to @willsbrit @binhara
pprt eu não aqueci nenhuma das contas que eu usei
nem insta, tiktok, nem youtube para rodar essas contas
o que eu fiz
1. nos primeiros 4 dias eu postei 1 por di
2. depois comecei a postar 6 por dia
3. depois subi para 12 por dia
4. agora to postando 20
1
515
dinheiro em float dá diferença de centavo que só aparece no total. guarda em centavos inteiros e arredonda uma vez só, na regra certa. em nota fiscal, total que não bate com a soma dos itens é motivo clássico de rejeição, e o bug nasce numa conta que ninguém olhou.
288
certificado digital A1 vence em 1 ano e ninguém lembra. no dia que vence a emissão de nota falha e o cliente só descobre na hora de emitir. aviso 30, 15 e 5 dias antes, com a data na tela e não só no e-mail.
1
245
o Simon Willison apontou que no Gemini 4 o Argon e o Carbon custam o mesmo token, e os dois dobram de preço em 1º/12. são 18 dias de aviso pra quem já tem produto no ar. quem depende de um modelo só fica refém. meça o custo por tarefa e deixe o modelo trocável por configuração.
85
paginação por offset repete e pula linha quando entra registro novo no meio da leitura. quem consome a lista vê item duplicado e nem percebe. cursor pelo id do último item resolve isso.
135





