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.
🏠 README · 📚 Documentação · ⬅️ 30 · Retrofit 360° · 32 · CarPlay/Telegram ➡️
📑 Neste guia — 5 seções · ~3 min de leitura
- 🗺️ Visão geral em diagrama
- Fase 132 — Explicação de Códigos de Falha OBD-II em Português (DtcExplainer)
- Fase 133 — Consumo Real e Abastecimento Automático (FuelCostEstimator)
- Fase 134 — Diário de Bordo Automático + Exportação CSV (TripLogbookDB)
- Fase 135 — Nota de Condução e Dicas de Economia (DrivingScoreAnalyzer)
Inteligência de viagem: falhas explicadas, consumo real, diário CSV e nota de condução.
🗺️ Visão geral em diagrama
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:#C8A951Como 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:tituloeo_que_e: Explicação em linguagem simples para o motorista.gravidade: Classificação (baixa,media,alta,critica).pode_seguir_viagem(bool) eorientacao_viagem: Indica objetivamente se é seguro continuar dirigindo ou se deve parar o motor imediatamente (ex.:P0524pressão de óleo /P0562tensão crítica).- Refinamento Local Opcional: Quando
llama-clie o modelo.ggufembarcado 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 (MAFvia OBD-II) ou estimativa Speed-Density porRPM + carga do motorem 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$).
- Calcula vazão instantânea (
- Abastecimento Automático: Ao detectar aumento abrupto no nível do tanque (
>= 8%com veículo parado<= 2.5 km/h), ativarefuel_prompt_pending = truecom a litragem estimada para o usuário digitar apenas o preço por litro (R$/L) viaPOST /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/finishou 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.csvgera 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, GrauA–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 de3900 RPMsustentados 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.
- Penaliza eventos com histerese anti-duplicação: frenagens bruscas (
⬅️ 30 · Retrofit 360° · ⬆️ Topo · 📚 Índice · 32 · CarPlay/Telegram ➡️
Zenith AutoOS 11.0 · Documentação técnica · Novembro de 2026 · README principal