Registro de decisões de arquitetura¶
Cada arquivo aqui descreve uma decisão que mudou o rumo do projeto: qual era o problema, o que foi decidido, o que se perdeu com isso e o que aprendemos.
O formato é ADR (Architecture Decision Record). São curtos de propósito —
a intenção é que o próximo desenvolvedor (ou o mesmo daqui a seis meses)
entenda por que o código é como é sem precisar arqueologia no git log.
| # | Decisão | Status |
|---|---|---|
| 0001 | CLI em vez de API REST | Aceita |
| 0002 | Troca do parser de PKCS#12 | Aceita |
| 0003 | Ancorar o gerador de XML no XSD oficial | Aceita |
| 0004 | A assinatura digital nunca verificou | Aceita |
| 0005 | Cliente da Sefin reescrito contra a especificação oficial | Aceita |
| 0006 | Validar a alíquota do ISS antes de enviar | Aceita |
| 0007 | Preencher a configuração a partir do certificado e do cadastro público | Aceita |
| 0008 | Quatro defeitos que só a emissão real revelou | Aceita |
| 0009 | Embutir a lista nacional de serviços e procurar o cTribNac | Aceita |
| 0010 | Substituição de NFS-e e DANFSe | Aceita |
| 0011 | Bibliotecas de PDF e QR Code para gerar o DANFSe | Aceita |
| 0012 | Traduzir o código do município por consulta, não por tabela embutida | Aceita |
| 0013 | Município informado pelo nome, resolvido por consulta e guardado em cache | Aceita |
| 0014 | Validar a DPS lendo os XSDs oficiais, com um validador próprio | Aceita |
| 0015 | IBS/CBS: o grupo fica para quando for obrigatório e houver tabela | Aceita |
| 0016 | Site de documentação no GitHub Pages, com as rejeições tiradas do ANEXO I | Aceita |
| 0019 | Rejeições explicadas no terminal, com uma tabela gerada do ANEXO I | Aceita |
| 0020 | Binários publicados com proveniência assinada | Aceita |