car_mms/SETTINGS_TESTING_GUIDE.md

🧪 Settings System Testing Guide

✅ Setup Complete!

The settings system is now fully operational. Here's how to test it:

🔗 Access URLs

• Application: http://localhost:5174/
• Settings Page: http://localhost:5174/settings (Admin only)

🧪 Testing Steps

1. Login as Admin

URL: http://localhost:5174/login
Credentials: Use admin account (authLevel 2 or higher)

2. Access Settings Page

URL: http://localhost:5174/settings
Expected: Settings management interface with:
- Date format options (ar-SA / en-US)
- Currency selection (JOD, USD, EUR, SAR, AED)
- Number format options (ar-SA / en-US)
- Currency symbol input
- Real-time preview section

3. Test Date Format Changes

1. Change date format from Arabic to English
2. Click "حفظ الإعدادات" (Save Settings)
3. Navigate to maintenance visits, vehicles, or customers
4. Verify dates now show in English format (11/9/2025 vs ٩/١١/٢٠٢٥)

4. Test Currency Changes

1. Change currency from JOD to USD
2. Update currency symbol from "د.أ" to "$"
3. Save settings
4. Check maintenance visit costs and financial displays
5. Verify format changes from "1,234.56 د.أ" to "1,234.56 $"

5. Test Number Format Changes

1. Change number format from Arabic to English
2. Save settings
3. Check kilometer displays and numeric values
4. Verify format changes from "١٬٢٣٤" to "1,234"

6. Test Real-time Preview

• Change any setting and observe the preview section
• Should show immediate formatting changes before saving

📍 Where to See Changes

Maintenance Visits (/maintenance-visits)

• Visit costs (currency formatting)
• Visit dates (date formatting)
• Kilometer readings (number formatting)

Vehicle Details (/vehicles)

• Last visit dates
• Creation/update dates
• Maintenance history costs

Customer Details (/customers)

• Customer creation dates
• Last update dates
• Associated vehicle information

🎯 Expected Behavior

Arabic Settings (ar-SA)

Date: ٩/١١/٢٠٢٥
Currency: ١٬٢٣٤٫٥٦ د.أ
Numbers: ١٬٢٣٤٫٥٦
Kilometers: ٤٥٬٠٠٠ كم

English Settings (en-US)

Date: 11/9/2025
Currency: 1,234.56 $
Numbers: 1,234.56
Kilometers: 45,000 كم

🔧 Admin Features

Settings Management

• ✅ Real-time preview of changes
• ✅ Form validation
• ✅ Reset to defaults button
• ✅ Success/error messages
• ✅ Admin-only access control

Supported Currencies

• JOD (د.أ) - Jordanian Dinar
• USD ($) - US Dollar
• EUR (€) - Euro
• SAR (ر.س) - Saudi Riyal
• AED (د.إ) - UAE Dirham

🚨 Troubleshooting

Settings Page Not Accessible

• Ensure you're logged in as admin (authLevel 2+)
• Check URL: http://localhost:5174/settings

Changes Not Appearing

• Refresh the page after saving settings
• Check browser console for errors
• Verify settings were saved (check preview section)

Formatting Not Applied

• Clear browser cache
• Restart development server
• Check that components use useSettings() hook

✨ Success Indicators

When working correctly, you should see:

1. Settings page loads without errors
2. Preview updates in real-time as you change settings
3. Save confirmation message appears after updating
4. Formatting changes appear across all pages immediately
5. Consistent formatting throughout the application

🎉 Features Verified

• ✅ Centralized settings management
• ✅ Real-time formatting preview
• ✅ Admin access control
• ✅ Database persistence
• ✅ Error handling and fallbacks
• ✅ Cross-component formatting consistency
• ✅ Arabic/English localization support

---

Status: Ready for Testing
Server: http://localhost:5174/
Settings: http://localhost:5174/settings