Integrar criação e geração de orçamento com a API FastAPI

[viviangiulia]

Contexto

A interface utiliza inicialmente dados mockados para validar a experiência do usuário. Após a disponibilização dos contratos da API, o fluxo de criação e geração de orçamento deve consumir os casos de uso reais do backend.

O frontend deve atuar como cliente HTTP, sem reproduzir as regras de geração, resolução de composições ou precificação pertencentes ao domínio Python.

Objetivo

Substituir os mocks do fluxo de entrada e geração de orçamento por chamadas HTTP reais à API FastAPI.

Escopo

• Criar ou utilizar uma camada centralizada de acesso à API.
• Serializar os dados de entrada conforme o contrato HTTP definido.
• Enviar a requisição de geração de orçamento.
• Processar a resposta retornada pelo backend.
• Navegar para o resultado correspondente.
• Implementar estados de loading durante a operação.
• Implementar apresentação adequada de erros.
• Preservar a experiência visual consolidada durante a fase de prototipação.

Fora de escopo

• Reimplementar regras do domínio em TypeScript.
• Calcular oficialmente o orçamento no frontend.
• Acessar diretamente o banco de dados.
• Acoplar componentes visuais a classes Python ou modelos ORM.

Critérios de aceite

• O frontend envia um payload válido à API.
• A geração do orçamento é executada pelo backend.
• O frontend apresenta o resultado retornado.
• Estados de loading são exibidos durante a requisição.
• Erros da API são tratados e apresentados ao usuário.
• Nenhuma regra oficial de precificação é duplicada no frontend.
• Os mocks correspondentes ao fluxo integrado são removidos ou isolados do caminho de produção.

Dependências

• Experiência de entrada para elementos quantificáveis.
• Definição dos contratos HTTP.
• M3 — Fundação da API.