Meu Tanque Fácil

Visão Geral

Aplicativo móvel para simplificar e otimizar o gerenciamento de combustível para motoristas, auxiliando na tomada de decisão no momento do abastecimento e no controle de consumo.

Objetivo

Desenvolver um aplicativo móvel que forneça informações rápidas e precisas sobre:

• Nível do tanque e autonomia
• Custo de abastecimento
• Comparativo entre etanol e gasolina
• Controle de manutenção básica do veículo

Stack de Desenvolvimento

Frontend

• Framework: React Native (com Expo)
• Padrão de Arquitetura: MVC (Model-View-Controller)
• Navegação: Expo Router
• Gerenciamento de Estado: Zustand
• Banco de Dados Local: SQLite
• Biblioteca de Gestos: React Native Gesture Handler
• Controle de Versão: Git com GitHub

Principais Funcionalidades

1. Configuração do Veículo

• Definição da capacidade do tanque
• Configuração do consumo de combustível (manual ou aprendizado)
• Seleção do tipo de combustível (gasolina, etanol ou flex)

2. Gerenciamento de Combustível

• Registro do nível de combustível
• Cálculo de autonomia restante
• Estimativa de litros necessários para encher o tanque

3. Decisão de Abastecimento

• Comparação dinâmica entre etanol e gasolina
• Cálculo do custo para encher o tanque
• Recomendação do melhor combustível para abastecer

4. Registro de Abastecimento

• Entrada de preços de combustível
• Cálculo de litros baseado no valor a pagar
• Registro de quilometragem
• Opção de registrar localização (GPS)

5. Manutenção Básica

• Lembretes de calibragem de pneus
• Controle de calibragem do estepe
• Histórico de manutenções

6. Histórico e Relatórios

• Lista de todos os abastecimentos
• Detalhes completos de cada abastecimento
• Cálculo de consumo médio
• Visualização de histórico em mapa

Estrutura do Projeto

meu-tanque-facil/
├── assets/               # Recursos estáticos (imagens, ícones, fontes)
├── src/
│   ├── components/       # Componentes reutilizáveis
│   ├── screens/          # Telas da aplicação
│   ├── models/           # Modelos de dados
│   ├── controllers/      # Lógica de negócios
│   ├── services/         # Serviços (API, banco de dados)
│   ├── utils/            # Utilitários e helpers
│   └── store/            # Gerenciamento de estado (Zustand)
├── App.js               # Ponto de entrada da aplicação
└── app.json             # Configuração do Expo

Pré-requisitos

• Node.js (versão LTS recomendada)
• npm
• Expo CLI instalado globalmente
• Dispositivo móvel com o aplicativo Expo Go ou emulador

Como Executar

Instalação

# Clonar o repositório
git clone [URL_DO_REPOSITORIO]

# Instalar dependências
cd meu-tanque-facil
npm install
# ou
yarn install

Executando o Projeto

# Iniciar o servidor de desenvolvimento
expo start

Próximos Passos

1. Configurar ambiente de desenvolvimento
2. Implementar navegação entre telas
3. Desenvolver componentes principais
4. Implementar lógica de negócios
5. Configurar banco de dados local (SQLite)
6. Testes e validações

Licença

Distribuído sob a licença MIT. Veja LICENSE para mais informações.

---

Última atualização: 11/08/2025

---

Plano de Ação Global: Khypukamayuq

Nota: Todas as inteligências artificiais utilizadas por mim recebem o nome Khypukamayuq. Este plano de ação deve sempre conter e detalhar as ações que a IA irá executar para controlar, monitorar e potencializar o projeto.

Objetivo

Controlar, monitorar e otimizar o desenvolvimento do projeto "Meu Tanque Fácil" utilizando a inteligência artificial Khypukamayuq (Copilote Windsurf Cursor e demais instâncias Khypukamayuq).

Funções da IA

• Gerenciar planos de ação das features e prompts
• Sugerir melhorias e automações
• Monitorar progresso e alertar sobre atrasos
• Auxiliar na tomada de decisão técnica
• Garantir alinhamento com requisitos e cronograma
• Executar e registrar todas as ações realizadas pela IA no projeto
• Commits: Apenas o usuário humano pode realizar commits. A IA irá preparar e propor mensagens de commit, mas nunca executará o comando git commit.

Etapas de Controle

1. ✅ Mapear todas as features e prompts do projeto
2. ✅ Integrar planos de ação das pastas dedicadas
3. ✅ Definir indicadores de progresso (checklists, status, datas)
4. 🔄 Automatizar notificações e sugestões de melhoria
5. 🔄 Realizar revisões periódicas dos planos e execução
6. 🔄 Gerar relatórios de acompanhamento
7. ✅ Documentar todas as ações executadas pela IA Khypukamayuq

Progresso Atual - Primeira Tela Implementada ✅

O que foi implementado:

• Tela de Cadastro de Veículos (/veiculo-cadastro)

  • Formulário completo com validação
  • Campos: nome, capacidade do tanque, consumo gasolina/etanol, tipo de ponteiro
  • Switches para localização e lembretes de calibragem
  • Navegação com botão voltar
  • Edição de Veículos: Formulário pré-preenchido com dados do veículo existente.

• Tela Principal de Veículos (/veiculos)

  • Lista de veículos cadastrados
  • Botões de ação (editar/excluir)
  • Estado vazio com mensagem orientativa
  • Navegação para cadastro

• Dashboard Principal (/)

  • Interface moderna e intuitiva
  • Cards de ação rápida
  • Status do veículo atual
  • Lembretes e estatísticas
  • Navegação integrada
  • Lembrete de Calibragem de Pneus: Exibição de alerta e botão para confirmar calibragem.

• Estrutura de Tipos

  • Interfaces TypeScript para Veiculo e Abastecimento
  • Tipos baseados no modelo de dados SQLite definido

• Navegação

  • Tab "Veículos" adicionada ao layout principal
  • Rotas organizadas seguindo a estrutura do projeto
  • Navegação Inferior Atualizada:
    • Aba "Explore" removida.
    • Abas "Relatórios", "Configurações" adicionadas.

✅ SQLite Implementado com Sucesso!

Estrutura do Banco de Dados:

• Tabela Carro: Armazena todos os dados dos veículos
  • Migração: Adicionada coluna dataUltimaCalibragem com estratégia de migração.
• Tabela Abastecimentos: Preparada para futuros registros
• Relacionamentos: Chave estrangeira entre veículos e abastecimentos.

✅ Tela de Registro de Abastecimentos Implementada!

Funcionalidades Implementadas:

• Formulário Completo: Data, quilometragem, litros, preço por litro, valor total
• Cálculos Automáticos: Preço por litro e valor total calculados automaticamente
• Validações: Campos obrigatórios e validações de valores
• Tipos de Combustível: Seleção entre Gasolina e Etanol
• Tipos de Trajeto: Cidade, Estrada ou Misto
• Calibragem de Pneus: Switch para marcar se foi realizada
• Integracão com Banco: Serviço completo para CRUD de abastecimentos
• Hook Personalizado: useAbastecimentos para gerenciamento de estado
• Cálculo de Consumo: Função para calcular consumo médio por veículo

Arquitetura:

• app/abastecimento-registro.tsx - Tela de registro
• services/abastecimentoService.ts - Operações CRUD no banco
• hooks/useAbastecimentos.ts - Hook personalizado para gerenciar estado
• Integração completa com o banco SQLite existente

Funcionalidades Implementadas (Veículos):

• ✅ Criação de veículos com persistência
• ✅ Listagem de veículos do banco
• ✅ Exclusão de veículos (com validação de integridade)
• ✅ Atualização de veículos
• ✅ Hook personalizado para gerenciamento de estado
• ✅ Tratamento de erros e loading states
• ✅ Refresh control para atualizar dados
• ✅ Validação de exclusão (impede exclusão se há abastecimentos)

Arquitetura (Veículos):

• database/database.ts - Configuração e inicialização do SQLite
• services/veiculoService.ts - Operações CRUD no banco
• hooks/useVeiculos.ts - Hook personalizado para gerenciar estado
• Integração completa com as telas existentes

✅ Tela de Histórico de Abastecimentos Implementada!

• Tela: app/abastecimento-historico.tsx
• Funcionalidade: Lista todos os abastecimentos registrados, com opção de exclusão.
• Acesso: Botão "📊 Histórico" no Dashboard.

✅ Tela de Comparador de Combustível Implementada!

• Tela: app/combustivel-comparador.tsx
• Funcionalidade: Permite comparar preços de gasolina e etanol com base no consumo do veículo, recomendando a melhor opção.
• Acesso: Botão "⚖️ Comparar" no Dashboard.

✅ Cálculo de Consumo Médio Implementado!

• Tela: app/(tabs)/relatorios.tsx
• Funcionalidade: Calcula e exibe o consumo médio (km/L) para cada veículo, baseado nos abastecimentos registrados.
• Acesso: Nova aba "Relatórios" no menu inferior.

✅ Relatórios Avançados Implementado!

• Tela: app/(tabs)/relatorios.tsx
• Funcionalidade: Exibe estatísticas gerais de gastos, litros abastecidos, quilometragem total e custo médio por litro.
• Tela de Mapa: app/abastecimento-mapa.tsx para visualização dos abastecimentos no mapa, utilizando OpenStreetMap (escolhido por ser gratuito e de código aberto).
• Acesso: Botão "Ver Mapa" na tela de Relatórios.

🔧 Problemas Identificados e Corrigidos:

1. Erro de Importação SQLite:

• ❌ import * as SQLite from 'expo-sqlite'
• ✅ import { openDatabase } from 'expo-sqlite'
• Status: Corrigido ✅

2. Tratamento de Erros Melhorado:

• Adicionado logging detalhado para debug
• Fallback para carregar veículos mesmo com erro de inicialização
• Status: Implementado ✅

3. Arquivo de Teste SQLite:

• Criado database/test.ts para verificação de funcionamento
• Status: Criado ✅

4. Problema de Versão do expo-sqlite:

• ❌ Versão 15.2.14 com problemas de compatibilidade
• ✅ Versão 11.3.3 instalada (mais estável)
• Status: Corrigido ✅

5. Tela de Teste SQLite:

• Criada tela /test-sqlite para verificar funcionamento
• Botão de teste adicionado ao dashboard
• Status: Implementado ✅

6. Problema de Navegação para Abastecimento:

• ❌ Botão de abastecimento navegando para tela inexistente
• ✅ Corrigida versão do expo-sqlite (15.2.14 → 11.3.3)
• ✅ Navegação corrigida para /abastecimento-registro
• Status: Corrigido ✅

7. Ambiguidade de Configuração (Tipo de Ponteiro):

• ❌ Configuração de "Tipo de Ponteiro" duplicada em "Ajustes e Personalização" e "Editar Dados do Carro".
• ✅ Removida a configuração de "Tipo de Ponteiro" da tela "Ajustes e Personalização" (app/(tabs)/configuracoes.tsx). Now is managed exclusively in the vehicle creation/editing screen.
• Status: Corrigido ✅

8. Erro de Rota e Inicialização do Banco de Dados:

• ❌ WARN [Layout children]: No route named "manutencao-historico" exists in nested children
• ❌ ERROR Erro ao criar tabelas: [TypeError: Cannot read property 'some' of undefined]
• ✅ Movidas as telas de manutenção para o diretório app/(tabs)/.
• ✅ Corrigido o acesso à propriedade rows na migração do banco de dados.
• Status: Corrigido ✅

9. Normalização de Inputs e Experiência do Usuário na Tela de Abastecimento:

• ✅ Implementada a normalização de campos de texto (data no formato DD/MM/AAAA, valores numéricos como float com vírgula).
• ✅ Corrigido o problema de exibição de '0' nos campos numéricos ao carregar a tela, exibindo placeholders corretamente.
• ✅ Adicionada KeyboardAvoidingView e keyboardShouldPersistTaps="handled" para evitar que o teclado cubra os campos de input.
• Status: Concluído ✅

10. Implementação do Modal de Calibragem:

• ✅ Adicionado modal para perguntar sobre a calibragem dos pneus ao salvar um abastecimento.
• ✅ Corrigida a importação do veiculoService.
• ✅ Corrigida a chamada da função atualizarDataUltimaCalibragem.
• Status: Concluído ✅

Próximos passos:

• ✅ Configurações: Implementadas as opções de configuração do aplicativo na aba "Configurações", incluindo salvamento automático e remoção de redundâncias.
• Manutenção Básica: Desenvolver as funcionalidades de lembretes e histórico de manutenção.
• ✅ Relatórios Avançados: Expandida a tela de relatórios com mais métricas e visualizações (ex: histórico em mapa).

Critérios de Aceite

• Todos os planos de ação estão integrados e monitorados
• Progresso do projeto é acompanhado e reportado
• Sugestões da IA são registradas e avaliadas
• Decisões técnicas são documentadas
• Todas as ações da IA Khypukamayuq estão descritas e acessíveis no plano

---

Este plano de ação global garante que Khypukamayuq atue como supervisor inteligente, potencializando o desenvolvimento e a organização do projeto.

---

Aviso de Idioma: Todas as respostas e interações devem ser em português.

Erros e Lições Aprendidas com a IA

Erro: Uso incorreto do parâmetro newContent na ferramenta replace

Descrição: Ao tentar usar a ferramenta replace para modificar o conteúdo de um arquivo, foi utilizado o parâmetro newContent em vez do parâmetro correto new_string. Isso resultou em um erro [Operation Cancelled] Reason: User did not allow tool call porque a ferramenta não reconheceu o parâmetro fornecido.

Solução: Sempre utilize o parâmetro new_string para fornecer o conteúdo de substituição ao usar a ferramenta replace. O nome do parâmetro é new_string, não newContent.

Exemplo Correto:

print(default_api.replace(file_path = "caminho/do/arquivo.txt", old_string = "texto antigo", new_string = "novo texto"))