v11.0 · 151 Fases
ADAS & IA Fases 132–135 Implementado · ~3 min (613 palavras) OBD-IISQLiteOpenCV
📄 docs/31-inteligencia-viagens-dtc-fases-132-135.md ↗

31 — Inteligência Útil: DTC em Português, Custo em R$, Diário de Bordo e Nota (Fases 132–135)

Este documento cobre as 4 funções inteligentes voltadas a diagnóstico claro e controle financeiro/condução, correspondentes às Fases 132 a 135.

Zenith AutoOS: 11.0.0 Fases: 151 Guias: 33 Idioma: PT-BR

Categoria: ADAS & IA Fases: 132–135 Status: Implementado OBD-II: stack SQLite: stack OpenCV: stack

🏠 README · 📚 Documentação · ⬅️ 30 · Retrofit 360° · 32 · CarPlay/Telegram ➡️

📑 Neste guia — 5 seções · ~3 min de leitura

DTCs, consumo e nota de condução
Inteligência de viagem: falhas explicadas, consumo real, diário CSV e nota de condução.


🗺️ Visão geral em diagrama

Diagrama Mermaid
flowchart LR
    OBD["OBD-II"] --> DTC["DtcExplainer"]
    OBD --> FUEL["FuelCostEstimator"]
    GPS["GPS"] --> TRIP["TripLogbookDB"]
    FUEL --> TRIP
    TRIP --> CSV["CSV / Diário"]
    TRIP --> SCORE["DrivingScoreAnalyzer"]
    DTC --> UI["Central em português"]
    SCORE --> UI

    style DTC fill:#F97316,color:#fff,stroke:#FDBA74
    style TRIP fill:#1F6FEB,color:#fff,stroke:#93C5FD
    style UI fill:#0A5C36,color:#fff,stroke:#C8A951

Como ler: o diagrama resume o fluxo principal deste guia; os detalhes, pinagens, endpoints e trechos de código aparecem nas seções abaixo.

Fase 132 — Explicação de Códigos de Falha OBD-II em Português (DtcExplainer)

  • Arquivos: zenith_dtc_explainer.py e base offline dtc_knowledge_pt.json.
  • Estrutura da explicação: Para cada código lido na ECU (GET /api/obd/dtc/explain), retorna:
    • titulo e o_que_e: Explicação em linguagem simples para o motorista.
    • gravidade: Classificação (baixa, media, alta, critica).
    • pode_seguir_viagem (bool) e orientacao_viagem: Indica objetivamente se é seguro continuar dirigindo ou se deve parar o motor imediatamente (ex.: P0524 pressão de óleo / P0562 tensão crítica).
    • Refinamento Local Opcional: Quando llama-cli e o modelo .gguf embarcado estão presentes, enriquece a resposta com o perfil específico do carro ativo.

Fase 133 — Consumo Real e Abastecimento Automático (FuelCostEstimator)

  • Cálculo em Tempo Real (zenith_trip_logbook.py):
    • Calcula vazão instantânea (L/h) e consumo (km/L) usando o fluxo de massa de ar (MAF via OBD-II) ou estimativa Speed-Density por RPM + carga do motor em ECUs ISO 9141-2 / KWP2000 antigas.
    • Acumula litros consumidos na viagem e multiplica pelo preço vigente para mostrar cost_brl (custo da viagem em R$).
  • Abastecimento Automático: Ao detectar aumento abrupto no nível do tanque (>= 8% com veículo parado <= 2.5 km/h), ativa refuel_prompt_pending = true com a litragem estimada para o usuário digitar apenas o preço por litro (R$/L) via POST /api/trips/refuel.

Fase 134 — Diário de Bordo Automático + Exportação CSV (TripLogbookDB)

  • Persistência SQLite WAL (/data/trips/zenith_trips.db): Ao finalizar cada viagem (POST /api/trips/finish ou desligamento de ignição), salva data/hora de início e fim, duração, distância (km), velocidades média/máxima, litros, preço/L, custo total em R$, nota de condução e pontos GPS da rota (route_points).
  • Exportação pronta para reembolso: Endpoint GET /api/trips/export.csv gera CSV UTF-8 BOM delimitado por ; compatível com Excel/Google Sheets contendo todas as viagens e coordenadas de origem/destino.

Fase 135 — Nota de Condução e Dicas de Economia (DrivingScoreAnalyzer)

  • Avaliação contínua (0..100, Grau A–E):
    • Penaliza eventos com histerese anti-duplicação: frenagens bruscas (lon_g / desacel <= -3.5 m/s²), acelerações bruscas (>= 3.2 m/s²), marchas esticadas acima de 3900 RPM sustentados e excesso sobre o limite da via.
    • Gera dicas práticas personalizadas em português (tips), exibidas no painel de viagem e no frontend React.

⬅️ 30 · Retrofit 360° · ⬆️ Topo · 📚 Índice · 32 · CarPlay/Telegram ➡️

Zenith AutoOS 11.0 · Documentação técnica · Novembro de 2026 · README principal