jonatanritter
032151af34
Copies the 6 pure fiscal modules (domains, chave_acesso, tpag, presets, resolver, xml_builder) from sowai-auto's backend/app/modules/fiscal/ into this standalone lib, with only the two mechanical changes required to drop the app.* dependency: import prefix rename, and TaxRule (ORM) -> TaxRuleLike (structural Protocol) in the resolver. No other line changes -- byte-level parity with the auto is the point. Ports the pure test suites (domains, chave_acesso, resolver with a local FakeTaxRule satisfying TaxRuleLike, xml_builder) plus a new test_presets_data covering the PRESETS dict directly (the auto's equivalent test exercises the apply-preset HTTP/DB flow, which isn't part of the extracted pure core). 55 tests pass locally via `uv run pytest`, no Postgres/k8s required.
1.9 KiB
sowai-fiscal
Núcleo fiscal puro da SowAI: motor de regras tributário (imposto-como-dado),
chave de acesso de NF-e (módulo 11) e builder do XML NF-e 55 (leiaute NT
2025.002 v1.40, bindings nfelib 2.5.x). Extraído do produto sowai-auto
(F1 do plano sowai-fiscal-svc) como lib versionada — zero I/O, zero
SQLAlchemy, zero FastAPI, zero acoplamento a nenhum produto: a interface com
o ORM do consumidor é o Protocol estrutural sowai_fiscal.types.TaxRuleLike.
Módulos
domains— catálogoTaxDomain/DOMAIN_FIELDS/MATCHER_WEIGHTS+ transposição de CFOP intra→interestadual.chave_acesso— DV módulo 11, sorteio decNF, montagem da chave de 44 dígitos.tpag— tabela de códigostPag(MOC, grupo YA02).presets— presets fiscais seed-editáveis (perfis reais extraídos do iCode da Thiago Auto Center).resolver—resolve_fiscal:FiscalOperation× regras (TaxRuleLike) →FiscalResult. Puro, determinístico, fail-closed.xml_builder—build_nfe:DadosEmissao(já resolvido) → objetoNfe(bindingsnfelib).types—TaxRuleLike, oProtocolque desacopla o resolver do ORM do produto.golden_helpers—dados_from_json/serialize_infnfe, usados pelo corpus golden (goldens/) e pelo teste de paridade do produto consumidor.
Corpus golden
src/sowai_fiscal/goldens/caso_<nome>.{input.json,expected.xml} — pares
determinísticos (dh_emi/cnf/chave_acesso pinados no input) que travam
o leiaute XML pré-assinatura gerado a partir de um DadosEmissao. São dados
de pacote (lidos via importlib.resources), para que o produto consumidor
compare byte a byte contra os MESMOS arquivos da lib instalada — nenhuma
cópia que possa divergir. Regenerar com uv run python scripts/gen_goldens.py
apenas quando uma NT mudar o leiaute DE PROPÓSITO.
Testes
uv sync
uv run pytest
100% local — sem Postgres, sem k8s.