Integrar AutoSINAPI como fonte externa de dados SINAPI

[viviangiulia]

Contexto

Atualmente, o SINAPI+ utiliza arquivos Excel locais como fonte de dados para
composições e preços.

Como o objetivo da aplicação é trabalhar com dados SINAPI reais, deve ser
avaliada e implementada a integração com a API AutoSINAPI como fonte externa
de dados de referência.

A integração não deve acoplar o domínio ao contrato HTTP externo. Os dados
recebidos da AutoSINAPI devem ser convertidos para os modelos existentes do
domínio.

Objetivo

Criar uma camada de integração com a AutoSINAPI capaz de consultar dados SINAPI
e convertê-los para os modelos de domínio do SINAPI+.

Critérios de aceite

• Existe um cliente HTTP dedicado à comunicação com a AutoSINAPI.
• O domínio não depende de schemas ou modelos específicos da AutoSINAPI.
• Respostas externas são convertidas para objetos do domínio.
• Erros de rede e respostas inválidas possuem tratamento explícito.
• A integração possui testes sem depender de chamadas reais à API.
• A configuração da URL externa não está hardcoded na regra de negócio.

Questões a responder

• Quais endpoints da AutoSINAPI serão utilizados?
• A API fornece composições, componentes, coeficientes e preços?
• Como são representados UF e competência?
• Os preços são desonerados ou não desonerados?
• A aplicação consultará a API em tempo real ou manterá cache/base local?