Integração da API Frota162 com aplicação
hoje às 17:53Descrição do Projeto:
Segue também PRD abaixo com os passos já mapeados:
1. Setup - credenciais, sandbox e confirmação com a Frota162
Objetivo: preparar tudo que depende do fornecedor antes de escrever código.
2. Backend - módulo fleet-fine-integration: gateway de saída (indicate-driver / update)
Objetivo: criar o módulo backend novo e a camada de chamadas de saída para a API Frota162, seguindo o scaffold obrigatório (apps/service-hub-platform-backend/ia-context/SCAFFOLD_IMPLEMENTACAO_BACKEND.md).
3. Backend - recebimento de webhook (ingestão assíncrona)
Objetivo: criar o endpoint público que recebe os eventos da Frota162 (multa nova, atualização de multa, notificação nova/atualizada, status de indicação de motorista) e processá-los de forma assíncrona e idempotente.
4. Backend - mapear eventos de multa/notificação para o domínio FleetFine existente
Objetivo: alimentar a entidade FleetFine já existente (modules/fleet) a partir dos eventos processados da Frota162, sem criar um domínio de multa paralelo.
Contexto: hoje modules/fleet/domain/entity/fleet-fine.entity.ts é alimentada só por importação manual de planilha do "Ecar" (ver modules/fleet/domain/service/ecar-fine-status.mapper.ts como exemplo de mapper equivalente). Esta subtask cria o mapper equivalente para a fonte Frota162.
5. Backend - Indicação de motorista (NIC) via API v2 (beta) e alertas de prazo
Objetivo: implementar a submissão formal de indicação de condutor (NIC/AIT) usando a API v2 (beta) da Frota162, incluindo acompanhamento assíncrono de status e alerta de prazo legal.
6. CI/CD - secrets, variáveis e pipeline
Objetivo: garantir que o novo módulo tenha suas credenciais e variáveis corretamente provisionadas em cada ambiente e que os workflows existentes cubram o build do módulo novo.
Contexto: o backend já usa dois workflows (ci-dev.yml para PR->dev, ci-release.yml para PR->hml/main), ambos com Node 24, lint + build (testes/cobertura saíram do CI desde 2026-08-04, mas continuam obrigatórios localmente - ia-context/CICD_PIPELINES.md §3.7).
7. Docker / Infraestrutura - exposição pública do endpoint de webhook
Objetivo: garantir que o endpoint de recebimento de webhook (subtask 3) seja alcançável publicamente via HTTPS pela Frota162, sem abrir superfície de ataque desnecessária.
8. Testar o cadastro do webhook em hml apontando para o domínio público de homologação, validando entrega ponta a ponta a partir do sandbox da Frota162.
Critério de conclusão: rota pública validada em hml recebendo evento real do sandbox da Frota162, sem exigir mudança de imagem Docker além do código da subtask 3.
Bloqueada por: subtask 3 (endpoint implementado) e 6 (variáveis provisionadas em hml).
Objetivo: garantir que o módulo novo atenda ao padrão obrigatório de testes do scaffold (ia-context/SCAFFOLD_IMPLEMENTACAO_BACKEND.md §9-10) antes de qualquer PR ser aberto.
9. Documentação - ia-context do módulo novo
Objetivo: cumprir a exigência do scaffold de documentar toda integração externa nova em ia-context, seguindo o modelo já usado para a integração Control iD.
Referência de formato: apps/service-hub-platform-backend/ia-context/FLEET_GATEHOUSE_CONTROLID.md (objetivo, feature flag, fluxo passo a passo, envs, limitações conhecidas, contexto de decisões).
10. (Fase opcional) E-mail padronizado de contestação às locadoras via Resend
Objetivo: atender ao pedido de negócio registrado em comentário do card por Otávio Anjos ("em conversa com Juliano, ele pediu um email com formato e todos os dados para questionamento para as Locadoras"), reaproveitando a integração Resend já existente no módulo notification.
Habilidades desejadas:
Desenvolvimento Back-End Desenvolvimento de API Engenharia de Sistemas Integração Integração de Dados
Arquivos anexados:
Entre ou Cadastre-se para ver os arquivos anexados.
Atividades do cliente nesse projeto:
Última visualização: hoje às 18:12
Tem dúvidas? Faça uma pergunta.
ou
Informações adicionais
| Categoria: | Web, Mobile & Software |
|---|---|
| Subcategoria: | Desenvolvimento Web |
| Orçamento: | Aberto |
| Nível de experiência: | Iniciante |
| Visibilidade: | Público |
| Propostas: | 38 |
| Interessados: | 42 |
| Tempo restante: | |
| Valor Mínimo: | R$ 50,00 |
-
Submetido: | Oferta: Privado | Duração estimada: Privado
-
Submetido: | Oferta: Privado | Duração estimada: Privado
-
Submetido: | Oferta: Privado | Duração estimada: Privado
-
Submetido: | Oferta: Privado | Duração estimada: Privado
-
Submetido: | Oferta: Privado | Duração estimada: Privado
-
Submetido: | Oferta: Privado | Duração estimada: Privado
-
Submetido: | Oferta: Privado | Duração estimada: Privado
-
Submetido: | Oferta: Privado | Duração estimada: Privado
-
Submetido: | Oferta: Privado | Duração estimada: Privado
-
Submetido: | Oferta: Privado | Duração estimada: Privado
-
Submetido: | Oferta: Privado | Duração estimada: Privado
-
Submetido: | Oferta: Privado | Duração estimada: Privado
-
Submetido: | Oferta: Privado | Duração estimada: Privado
-
Submetido: | Oferta: Privado | Duração estimada: Privado
-
Submetido: | Oferta: Privado | Duração estimada: Privado
-
Submetido: | Oferta: Privado | Duração estimada: Privado
-
Submetido: | Oferta: Privado | Duração estimada: Privado
-
Submetido: | Oferta: Privado | Duração estimada: Privado
-
Submetido: | Oferta: Privado | Duração estimada: Privado
-
Submetido: | Oferta: Privado | Duração estimada: Privado
Catálogo online de temas de acervo para empresa de decoração - Olá! Busco profissional para criar um site simples que funcione como um catálogo de temas do nosso acervo para empresa de decoração de festas. A ideia é que, com ...
Desenvolver front-end, ajustes e complementação de plataforma - Ajuda com orçamentos e planejamento da plataforma, além de ajustes técnicos e complementares. Necessito de desenvolvimento front-end e suporte para complementação...
Sistema de gestão multimarketplace com CRM e dashboard de lucro - Preciso desenvolver um sistema web personalizado para gestão e controle de vendas em múltiplos marketplaces brasileiros. Contexto da operação: Vendo nos marketplaces Me...
Migração para WhatsApp Cloud API com Embedded Signup em Django multi-tenant - Possuo um **SaaS de gestão de clínicas desenvolvido em Python/Django**, atualmente em produção e utilizado por diversas clínicas. O sistema possui, entre outras f...
Criar site de e-commerce no WordPress com urgência - Olá, estou precisando de alguém para criar um site no estilo e-commerce no WordPress. A pessoa realmente precisa saber desenvolver sites na plataforma. A pessoa que fez para mim da &u...
