RideKeeper

RideKeeper - Technical Description - About the Application RideKeeper is an iOS application developed for complete motorcycle management and maintenance tracking. With a modern and intuitive interface, the app allows motorcyclists to control all aspects of their bikes, from basic information to detailed history of maintenance, fuel consumption, and tire pressure monitoring. - Main Features The application offers complete garage management with registration of multiple motorcycles, including photos, technical specifications, brand, model, year, license plate, and current mileage. Each motorcycle can have a personalized nickname and detailed information such as engine size, fuel type, and recommended tire pressures. The maintenance module allows recording of 14 different types of services, including oil change, brake pads, chain maintenance, brake fluid, coolant, air filter, spark plugs, tires, battery, clutch, suspension, electrical repairs, general inspection, and miscellaneous. Each record stores date, mileage, cost, and detailed notes. The fuel tracking system monitors fuel consumption with recording of liters, price per liter, total cost, fuel type, and optional octane rating. The system automatically calculates average consumption statistics and total cost per motorcycle. The tire management allows registering installed tires with brand, model, specification, type, position, installation date, mileage, and cost. The system maintains complete calibration history with front and rear pressures, comparing with recommended values. The settings screen offers language selection between system, English, and Portuguese, along with notification management and application information. - Technologies Developed in Swift 5.9 with SwiftUI for declarative and responsive interfaces. Uses SwiftData as Apple's native persistence framework, replacing Core Data with a modern and type-safe API. Integrated PhotosPicker for selection and compression of motorcycle images. The architecture follows MVVM pattern with centralized Data Managers for each functional domain. ModelContainerManager handles the SwiftData container with automatic recovery strategy in case of database corruption, including fallback to in-memory storage. ServiceLocator implements thread-safe dependency injection with NSLock for infrastructure services. The code uses @MainActor to ensure UI operations on the main thread and @unchecked Sendable for SwiftData entities compatible with Swift 6. Type-safe localization system with centralized StringsKey enum containing over 340 translation keys, L.localized helper for string interpolation, and complete support for Brazilian Portuguese and English. Consistent Design System with orange primary color palette, complete gray scale, reusable components, and standardized spacing scale. - Technical Differentials Completely type-safe localization system with compile-time validation through centralized enum. No hardcoded strings in the code, ensuring complete and consistent translation between languages. ModelContainerManager with automatic database corruption recovery through multiple strategies: removal of corrupted files, directory recreation, and fallback to in-memory container, ensuring the app never fails due to persistence issues. Specialized Data Managers per domain with centralized error handling and localized messages for end users. GarageDataManager, FuelDataManager, MaintenanceDataManager, and TireDataManager encapsulate all data access logic with optimized queries using FetchDescriptor and Predicate. Firebase Analytics tracks granular events including specific user actions, screen navigation, feature interactions, and errors. Firebase Crashlytics monitors production crashes with automatic dSYM upload for complete stack trace symbolication. Intelligent review system with ReviewManager that controls review requests based on number of launches and user interactions, following Apple guidelines to avoid being intrusive. Architecture prepared for multiple targets with support for development and production environments, differentiated Firebase configuration per environment, and custom App Icons per target. - System Requirements iOS 17.6 or higher. Xcode 15.0 or higher for development. Swift 5.9 or higher. Firebase iOS SDK 10.0 or higher for analytics and crashlytics.