Commit 64c41a

2024-03-16 21:34:23 Hargata Softworks: z
vehicle management.md ..
@@ 9,6 9,26 @@
![](/Vehicle%20Management/a/image-1708205404357.png)
+ ### Odometer Adjustments
+ Odometer Adjustments are conversions that will be applied to the odometer field when **adding** a new Service/Repair/Upgrade/Fuel Record.
+
+ #### Odometer Multiplier
+ The multiplier that will be applied on the record's odometer field. Primarily used for vehicles where the odometer uses a different unit compared to the user's settings. E.g.: A user residing in the U.S. or U.K. which uses miles as the distance unit imports a vehicle that uses kilometers(Kei trucks, motorcycles, etc).
+
+ The user will have to enter 0.621 as the odometer multiplier to convert kilometers to miles. When the user creates a new record, they can just enter the reading off the odometer in the vehicle(i.e.: 15000 km) and the app will automatically convert it to 9315 miles when the record is being saved. In the opposite scenario where a user imports a vehicle with miles as its distance and they use kilometers by default, they will have to enter 1.609 as the odometer multiplier.
+
+ Note that this field has a limit of 3 decimal places.
+
+ #### Odometer Difference
+ This is primarily used for vehicles where the dash cluster was swapped out and hence the odometer no longer reflects actual mileage. E.g.: The user swapped out the dash cluster when their vehicle had 200000 miles but the new dash cluster only has 15000 miles. The user will have to enter 185000 as the odometer difference. The next time the user creates a new record, they can just enter the reading off the odometer in the vehicle(i.e.: 17500 miles) and the app will automatically add 185000 to the odometer field when the record is being saved. The user can also input negative values in here if the new dash cluster has more miles than the user's original odometer.
+
+ Note that this field only takes in whole numbers(no decimals).
+
+ Note that in the event the user has a negative odometer difference, the record will not save if the odometer field falls below 0 after applying the odometer difference, it will throw a validation error.
+
+ #### Odometer Difference and Multiplier Combined(Edge Case)
+ The app will always apply the odometer difference first before applying the multiplier. Therefore if a dash cluster swap was performed the user must input the converted odometer difference.
+
### Sorting Vehicles
To sort vehicles by Year, simply right click on the Garage tab while the tab is selected.
0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9