O problema que o projecto resolve

Patrões que alugam camiões para transporte de mercadorias em Angola perdem o controlo financeiro de cada frete: o motorista guarda recibos de papel, comunica despesas por WhatsApp, e no fim da viagem ninguém sabe ao certo quanto foi realmente gasto nem qual foi o lucro real daquela viagem.

O FrotaCerta Angola resolve isto dando ao motorista uma forma simples de registar, no telemóvel e no momento em que acontece, o valor do frete e cada despesa da estrada — com foto do recibo e localização — enquanto o patrão vê, em tempo real, o lucro exacto de cada viagem.

O percurso, passo a passo
1

O motorista abre a app no telemóvel e regista o início da viagem: cliente, mercadoria, rota e valor cobrado. A localização GPS do telemóvel é capturada automaticamente.

2

Ao longo do trajecto, cada despesa (combustível, comida, manutenção, portagens) é lançada na hora, com foto do recibo opcional.

3

Quando é uma despesa de combustível, o sistema compara o valor lançado com um preço de referência obtido por Web Scraping de uma página pública, e avisa se o valor parecer fora do normal.

4

Ao finalizar a viagem, a IA Generativa escreve um resumo executivo em português simples: lucro líquido, margem e leitura geral das despesas.

5

O patrão consulta tudo isto através de uma API REST própria, protegida seguindo as boas práticas de segurança da OWASP.

Perguntas e respostas
Onde entra o Web Scraping?

O ficheiro includes/scraping.php vai buscar, à página pública do Observatório de Mercado da Sonangol Distribuidora, o preço de referência do gasóleo (em Kz/litro). Esse valor é depois usado para calcular quantos litros a viagem deveria ter gasto e comparar com o que o motorista lançou — se o desvio for grande, entra em acção a detecção de anomalia.

Onde entra a API REST?

Toda a aplicação comunica através de endpoints próprios em api/ (auth.php, veiculos.php, viagens.php, despesas.php, relatorio.php, motoristas.php, alertas.php, recibo.php), que recebem e devolvem JSON — documentados em API.md. Isto significa que os mesmos dados poderiam ser consumidos por uma app móvel nativa no futuro, sem alterar o "motor" do sistema.

Onde entra o OWASP?

Ver o Painel de Segurança, que documenta cada mitigação aplicada: autenticação com passwords encriptadas, autorização por papel e por dono do recurso (motorista vs. patrão), validação de toda a entrada, token CSRF em cada pedido que altera dados, upload seguro de fotos de recibos, e limite de pedidos por minuto.

Onde entra a IA Generativa?

O ficheiro includes/ia.php chama a API do Groq (modelos Llama, tier gratuito) para (1) escrever o resumo executivo de cada viagem finalizada e (2) explicar, em linguagem simples, o alerta quando uma despesa de combustível foge muito do valor de referência.

Analogia: é como ter um contabilista que nunca dorme — sempre que uma viagem termina, ele lê os números e escreve, em poucas frases, o que realmente aconteceu com o dinheiro daquele frete.