RideKeeper

RideKeeper - Descrição Técnica - Sobre o Aplicativo RideKeeper é um aplicativo iOS desenvolvido para gerenciamento completo de motocicletas e acompanhamento de manutenções. Com interface moderna e intuitiva, o app permite aos motociclistas controlar todos os aspectos de suas motos, desde informações básicas até histórico detalhado de manutenções, abastecimentos e calibragem de pneus. - Funcionalidades Principais O aplicativo oferece gestão completa da garagem com cadastro de múltiplas motocicletas, incluindo fotos, especificações técnicas, marca, modelo, ano, placa e quilometragem atual. Cada moto pode ter nickname personalizado e informações detalhadas como tamanho do motor, tipo de combustível e pressões recomendadas dos pneus. O módulo de manutenção permite registro de 14 tipos diferentes de serviços, incluindo troca de óleo, pastilhas de freio, manutenção de corrente, fluido de freio, líquido de arrefecimento, filtro de ar, velas, pneus, bateria, embreagem, suspensão, reparos elétricos, inspeção geral e outros. Cada registro armazena data, quilometragem, custo e observações detalhadas. O controle de abastecimento rastreia consumo de combustível com registro de litros, preço por litro, custo total, tipo de combustível e octanagem opcional. O sistema calcula automaticamente estatísticas de consumo médio e custo total por motocicleta. O gerenciamento de pneus permite cadastrar pneus instalados com marca, modelo, especificação, tipo, posição, data de instalação, quilometragem e custo. O sistema mantém histórico completo de calibragens com pressões dianteira e traseira, comparando com valores recomendados. A tela de configurações oferece seleção de idioma entre sistema, inglês e português, além de gerenciamento de notificações e informações sobre o aplicativo. - Tecnologias Desenvolvido em Swift 5.9 com SwiftUI para interfaces declarativas e responsivas. Utiliza SwiftData como framework de persistência nativo da Apple, substituindo Core Data com API moderna e type-safe. PhotosPicker integrado para seleção e compressão de imagens das motocicletas. A arquitetura segue padrão MVVM com Data Managers centralizados para cada domínio funcional. ModelContainerManager gerencia o container SwiftData com estratégia de recovery automático em caso de corrupção de banco de dados, incluindo fallback para armazenamento in-memory. ServiceLocator implementa injeção de dependências thread-safe com NSLock para serviços de infraestrutura. O código utiliza @MainActor para garantir operações de UI na thread principal e @unchecked Sendable para entidades SwiftData compatíveis com Swift 6. Sistema de localização type-safe com enum StringsKey centralizada contendo mais de 340 chaves de tradução, helper L.localized para interpolação de strings e suporte completo a português brasileiro e inglês. Design System consistente com paleta de cores primária laranja, escala de cinzas completa, componentes reutilizáveis e escala de espaçamento padronizada. - Diferenciais Técnicos Sistema de localização completamente type-safe com validação em tempo de compilação através de enum centralizada. Nenhuma string hardcoded no código, garantindo tradução completa e consistente entre idiomas. ModelContainerManager com recovery automático de banco de dados corrompido através de múltiplas estratégias: remoção de arquivos corrompidos, recriação de diretórios e fallback para container in-memory, garantindo que o app nunca falhe por problemas de persistência. Data Managers especializados por domínio com tratamento de erros centralizado e mensagens localizadas para usuário final. GarageDataManager, FuelDataManager, MaintenanceDataManager e TireDataManager encapsulam toda lógica de acesso a dados com queries otimizadas usando FetchDescriptor e Predicate. Firebase Analytics rastreia eventos granulares incluindo ações específicas de usuário, navegação entre telas, interações com features e erros. Firebase Crashlytics monitora crashes em produção com upload automático de dSYMs para simbolização completa de stack traces. Sistema de review inteligente com ReviewManager que controla solicitações de avaliação baseado em número de launches e interações do usuário, seguindo guidelines da Apple para não ser invasivo. Arquitetura preparada para múltiplos targets com suporte a ambientes de desenvolvimento e produção, configuração diferenciada de Firebase por ambiente e App Icons customizados por target. - Requisitos do Sistema iOS 17.6 ou superior. Xcode 15.0 ou superior para desenvolvimento. Swift 5.9 ou superior. Firebase iOS SDK 10.0 ou superior para analytics e crashlytics.