feature/boletim-iso8583-bolado

[marcialwushu]

feature/boletim-iso8583-bolado

1) Introdução: “um dev entra num bar e pede um 9F02 on the rocks”

Sentei pra “só revisar um pacote” e acordei em 2003 montando mensagem ISO 8583 com BCD, EMV e aquela sensação gostosa de que o universo foi escrito em TLV por alguém que odeia seres humanos. Enquanto a galera hype-a LLM que escreve poesia em Rust, eu aqui admirando um \u0001?\u0000` que nem o grep entende. Se Dante tivesse conhecido o bit 55, teria uma cornisa do inferno exclusiva para “tags que mudam de tamanho quando te olham”.

Café? Frio. Log? Verboso. Prod? “Está estável” (aquele estável de prédio com rachadura).

2) As “notícias” do front: a guerra santa do BCD vs. o bom senso

Hoje o plantão DevBank™ trouxe três episódios do mesmo multiverso:

• ELO Contactless 0100/0110: o host quer a requisição e a resposta convertidas de binário pra BCD. Porque claro, ASCII é muito mainstream. PAN mascarado, bit_003 obediente, bit_055 vomitando um zoológico de 9F26, 9F27, 95, 9F36… e aquele 9F10 que parece benigno até você tentar decodificar a política de CVM embutida no payload.

• Master Débito 0200/0210 (single message): o pacote vem com a elegância de um Processing Code 002000 e a delicadeza de um bit_063 com cara de “camada de compatibilidade emocional”. bit_055 curto e grosso, 9F26 com energia de hash que não confia em ninguém e os inevitáveis 9F33 e 9F34 medindo sua auto-estima de kernel.

• VISA Crédito 0100/0110 (chip contato): desfile de 003000, bit_052 PIN block olhando pra você como quem diz “se errar padding ISO-0 eu te julgo”. bit_060 aleatório o suficiente pra lembrar feature flag de startup; bit_111 em modo blob porque sempre tem um campo “guarda tudo que sobrar”.

Tudo isso embalado numa trilha sonora de LLVAR, LLLVAR e a eterna pergunta: por que alguns campos são BCD, outros ASCII e o 55 é binário? Porque a vida é assim, jovem padawan do POS. ISO 8583 não é um padrão, é um estilo de vida.

3) Tradução simultânea para quem já derrubou produção às 3h

• “Converter de binário para BCD” = seu payload entra como byte puro (com aqueles controles \u0001, \u0006, etc.), você tira eventual comprimento/TPDU, e o conteúdo dos campos numéricos precisa estar compactado em BCD. Cada dígito vira um nibble. Se ímpar, enfia um zero de brinde. Elegante como JSON com vírgula sobrando.

• Bitmap binário: sim, o primeiro choque cultural. Melhor do que hexdance com string. Se você nunca passou 2 horas achando que o 43 estava presente e era o 34, você não viveu.

• Bit 55 (EMV TLV): é tipo aquela caixa de cabos em cima do rack. Você sabe que tudo passa por ali, mas mexer dói. 9F02 (amount authorized), 9F1A (country code), 95 (TVR), 9A (data), 9C (tipo transação)… Parece legível até virar interoperabilidade internacional e cada bandeira decidir se é “qVSDC-que-não-é-bem-qVSDC” ou “contato com personalidade própria”.

• bit_060, bit_061, bit_111: os campos “caixa de ferramentas”. Tudo que a especificação não quis discutir no almoço cai aqui. E adivinha? Tem variação por adquirente, por arranjo, por humor do firmware do pinpad.

• Resposta 0110/0210: 39=00 e a gente finge que confia. 38 vem com autorização que parece senha de Wi-Fi de padaria. 127 guardando segredos que nem o futuro você vai lembrar por quê existiam.

4) A dev-filosofia do caos: BCD é o YAML dos anos 80

Olha, BCD é tipo YAML de 1987: human-friendly só pra quem nasceu em COBOL. Ele compacta bonito nos nibbles, economiza banda, mas cobra em sanidade. Você acha que “é só converter”? Aham. Até bater com:

• Padding semântico: aquele zero à esquerda que muda o valor, a vida e o SLA.
• Comprimento em BCD vs ASCII: o host jura que é “padrão”, mas o padrão é o host.
• Campo numérico em ASCII: porque sim.
• bit_055 montado com encoder BER-TLV que fica irritado se você não respeitar constructed vs primitive (oi, 0x7F 👋).

Tem também o esporte radical do “Friday deploy de packager”. Você ajusta LLLVAR de 55 e, de repente, 127 morre. Aí reverte, e o PIN block quebra porque o módulo de “segurança” (aspas muito grandes) resolveu aplicar um XOR motivacional. Enquanto isso, o squad de risco inventa uma regra: “se MCC = 7011 e país = 076, expira mais cedo”. Onde? No 9F1A? No 49? Ou no Slack?

E é sempre assim: isso escala mais rápido que microserviço sem observabilidade, porque cada adquirente tem “pequenas diferenças” — que somadas viram a reencarnação do monolito.

5) O PR que eu gostaria de abrir (e ninguém vai aprovar)

• Separar camadas como gente grande: framing/TPDU ➜ ISO8583 ➜ mapeamento de campos ➜ EMV. Sem “atalho” no meio. Span<byte> pra performance, testes com golden vectors dos três arranjos (Elo/Master/Visa) e contract tests com hexdumps reais. Quem nunca trocou YYMM por MMYY que atire a primeira tag 5F24.

• Observabilidade: log estruturado do parse (sem PAN, sem PIN, sem CVV, sem tag sensível — alô LGPD), métrica por bit presente (cardinalidade baixa), tracing nos validadores de TLV. Se você não mede, o host mede você.

• Fuzzing de TLV e LLVAR em CI: não é luxo, é prevenção de domingo triste. Mutar comprimentos e nibbles salva casamento.

• Tabela de arranjos versionada: “no host X, 32 é LLVAR ASCII; no Y, é BCD”. Não é “exceção”; é requisito. Coloque isso num .json e pare de espalhar if (arranjo == Elo) no código.

• Refuse deploy em sexta: se você mexeu em packager, a sexta está cancelada. “Ah, mas é só um padding”. Foi assim que nascemos.

6) Metáforas que ninguém pediu, mas ajudam a dormir

• ISO 8583 é aquele switch de 24 portas: na teoria é plug-and-play; na prática, porta 7 cai quando você ativa o PoE da 13.
• Bit 55 é o drawer de cabo VGA: toda vez que você abre, aparece um DVI que jura que é HDMI.
• BCD é compressão ZIP em 1999: economiza disco, mas precisa do WinRAR da licença de 40 dias (que nunca expira).
• 9F10 é o “README” do chip: todo mundo ignora, mas quando quebra, é o único arquivo que presta.

7) Epílogo: o terminal também filosofa

A gente gosta de dizer que “padrão é bom”. ISO 8583 prova que padrão é bom quando é um padrão. O resto é folclore. O dev moderno, com Prometheus, OpenTelemetry, e “clean architecture no coração”, aprende na marra que cada nibble tem história. E cada história custa um rollback.

No fim, o que fica: o log que te salva, o teste que te perdoa, e aquele script que monta/desmonta BCD pelo que você é — não pelo que você finge ser. Amanhã tem mais 0110 pra decifrar, outro 0210 pra explicar, e um 0100 que vai chegar com bit_060 “só com um detalhezinho novo”.

Se alguém perguntar “por que isso tudo?”, a resposta é simples: porque o mundo rodou cartão antes de rodar Kubernetes. E, de alguma forma, ainda aprova nosso PR.

---

Pós-créditos (extras com gosto de xkcd e café requentado)

• O LLLVAR é o primo do varint que foi estudar letras.
• \u0001\u0006 nos dumps é o “oi, eu sou framing”, não tente ser feliz com Encoding.UTF8.
• “Campo opcional” em adquirência significa “vai quebrar quando faltar”.
• Deploy em sexta é o “CVE” do calendário: conhecido, documentado, ignorado.

Beijo no 9F26 e até a próxima feature/packager-zero-padding-pt2.

---