carmanagement/docs/input_validation_plan.md

User Input Validation and Formatting Plan

Table of Contents

1. Global Rules
2. Field-Specific Rules
3. Implementation Logic
4. Formatting Functions
5. Error Handling
6. Processing Order
7. Field Configuration Reference
8. Phone Validation

---

Global Rules

Allowed Characters

All fields accept only:

• Letters (A-Z, a-z)
• Numbers (0-9)
• Special characters: @, -, /
• Spaces (where applicable)

Global Regex Pattern:

^[a-zA-Z0-9@\-\/\s]*$

---

Field-Specific Rules

Group 1: Title Case Fields (Uppercase First Letter, Lowercase Rest)

Fields: Name, Nationality, Street Address, City, Pick-up Location, Return Location, Country

Property	Value
Format	Uppercase first letter, lowercase rest
Max Characters	50 (Name, Nationality, City, Locations, Country) / 100 (Street Address)
Allowed Characters	Letters, spaces, - (Street Address also allows numbers and /; Pick-up/Return Location also allows numbers, /)
Transformation	toTitleCase()

Examples:

"john doe" → "John Doe"

"MARIA" → "Maria"

"new york" → "New York"

"123 main st." → "123 Main St"

Group 2: Title Case All Words Fields

Fields: Full Address, Commercial Name, Legal Company Name

Property	Value
Format	Uppercase first letter of every word
Max Characters	200 (Full Address) / 100 (Company Names)
Allowed Characters	Letters, numbers, spaces, -, /, ,
Transformation	toTitleCaseAll()

Examples:

"123 main street, apt 4b" → "123 Main Street, Apt 4b"

"acme corporation" → "Acme Corporation"

Group 3: Lowercase Fields

Fields: Email

Property	Value
Format	All lowercase
Max Characters	100
Allowed Characters	Letters, numbers, @, ., _, %, +, -
Transformation	toLowerCase()
Validation	Must match email format

Validation Regex:

^[a-zA-Z0-9._%+\-]+@[a-zA-Z0-9.\-]+\.[a-zA-Z]{2,}$

Examples:

"John.Doe@Example.COM" → "john.doe@example.com"

Group 4: Uppercase Fields

Fields: License Plate, VIN, CIN, Passport Number, International Permit Number, Driver License Number, License Category, ICE Number, Commercial Registry (RC)

Property	Value
Format	ALL UPPERCASE letters, numbers unchanged
Max Characters	30
Allowed Characters	Letters, numbers, -
Transformation	toUpperCase()

Examples:

"abc-123" → "ABC-123"

"ab123cd" → "AB123CD"

Group 5: Car Fields

Fields: Car Mark, Car Model, Car Color

Property	Value
Format	Uppercase first letter, lowercase rest
Max Characters	30
Allowed Characters	Letters, numbers, spaces, -
Transformation	toTitleCase()

Examples:

"TOYOTA" → "Toyota"

"midnight-blue" → "Midnight-Blue"

Group 6: Preserved Format Fields

Fields: ZIP Code

Property	Value
Format	As entered (no case transformation)
Max Characters	10
Allowed Characters	Letters, numbers, spaces, -
Transformation	preserveOriginal()

Examples:

"12345" → "12345"

"SW1A 1AA" → "SW1A 1AA"

---

Phone Validation

Morocco Phone Numbers

Property	Value
Format	As entered (digits, spaces, + preserved)
Max Characters	n/a (constrained by regex match)
Allowed Characters	Digits, spaces, +
Validation	Must match Morocco phone format

Validation Regex:

^(?:(?:\+|00)212|0)\s?[5-7](?:\s?\d){8}$

Accepted formats:

"+212 6 00 00 00 00" → "+212 6 00 00 00 00"

"00212600000000" → "00212600000000"

"0600000000" → "0600000000"

"+212700000000" → "+212700000000"

Rejected formats:

International codes other than +212

Numbers not starting with 5, 6, or 7 after the prefix

Wrong digit count

---

Implementation Logic

Main Processing Function

function sanitizeAndFormatInput(value, fieldType) {
    // Step 1: Remove disallowed characters
    let sanitized = removeDisallowedChars(value, fieldType);
    
    // Step 2: Trim leading/trailing whitespace
    sanitized = sanitized.trim();
    
    // Step 3: Validate format (if applicable)
    if (fieldType === 'email' && !isValidEmail(sanitized)) {
        throw new Error('Invalid email format');
    }
    
    // Step 4: Apply field-specific formatting
    let formatted = applyFormatting(sanitized, fieldType);
    
    // Step 5: Truncate to max length
    formatted = truncateToMaxLength(formatted, fieldType);
    
    return formatted;
}

Processing Order

1. Sanitize — Remove invalid characters
2. Trim — Remove leading/trailing whitespace
3. Validate — Check format (email, phone, required fields)
4. Format — Apply case transformation
5. Truncate — Enforce max length
6. Return — Output formatted value

---

Formatting Functions

Function	Description	Used For
toTitleCase()	First letter uppercase, rest lowercase per word	Name, Nationality, Street Address, City, Locations, Country, Car fields
toTitleCaseAll()	First letter of every word uppercase	Full Address, Commercial Name, Legal Company Name
toLowerCase()	All characters to lowercase	Email
toUpperCase()	All letters to uppercase, numbers unchanged	License Plate, VIN, CIN, Passport, Permit, Driver License, License Category, ICE, RC
preserveOriginal()	No transformation	ZIP Code

Function Implementations

function toTitleCase(str) {
    return str.replace(/\b\w+/g, (word) => word.charAt(0).toUpperCase() + word.slice(1).toLowerCase());
}

function toTitleCaseAll(str) {
    return str.replace(/\b\w+/g, (word) => word.charAt(0).toUpperCase() + word.slice(1).toLowerCase());
}

function toLowerCase(str) {
    return str.toLowerCase();
}

function toUpperCase(str) {
    return str.replace(/[a-zA-Z]/g, (char) => char.toUpperCase());
}

---

Error Handling

Condition	Error Message
Invalid characters	"Only letters, numbers, @, -, and / are allowed"
Invalid email format	"Please enter a valid email address"
Invalid phone format	"Please enter a valid Morocco phone number"
Required field empty	"This field is required"
Exceeds max length	"Maximum [X] characters allowed"

Validation Flow

User Input
    │
    ▼
Character Validation ────► Invalid ────► Error Message
    │
    ▼
Format Validation ────► Invalid ────► Error Message
    │
    ▼
Apply Transformation
    │
    ▼
Check Max Length ────► Exceeds ────► Truncate / Warning
    │
    ▼
Return Formatted Value

---

Field Configuration Reference

#	Field	Max Length	Format	Transformation
1	Name	50	Title Case	toTitleCase()
2	Nationality	50	Title Case	toTitleCase()
3	Street Address	100	Title Case	toTitleCase()
4	City	50	Title Case	toTitleCase()
5	Pick-up Location	50	Title Case	toTitleCase()
6	Return Location	50	Title Case	toTitleCase()
7	Country	50	Title Case	toTitleCase()
8	Full Address	200	Title Case All	toTitleCaseAll()
9	Email	100	Lowercase	toLowerCase()
10	Car Mark	30	Title Case	toTitleCase()
11	Car Model	30	Title Case	toTitleCase()
12	Car Color	30	Title Case	toTitleCase()
13	License Plate	30	Uppercase	toUpperCase()
14	VIN	30	Uppercase	toUpperCase()
15	CIN	30	Uppercase	toUpperCase()
16	Passport Number	30	Uppercase	toUpperCase()
17	International Permit Number	30	Uppercase	toUpperCase()
18	Driver License Number	30	Uppercase	toUpperCase()
19	License Category	30	Uppercase	toUpperCase()
20	ICE Number	30	Uppercase	toUpperCase()
21	Commercial Registry (RC)	30	Uppercase	toUpperCase()
22	Commercial Name	100	Title Case All	toTitleCaseAll()
23	Legal Company Name	100	Title Case All	toTitleCaseAll()
24	ZIP Code	10	Preserved	preserveOriginal()
25	Phone	—	Preserved	Morocco regex validation

---

Quick Reference Card

Email Validation

^[a-zA-Z0-9._%+\-]+@[a-zA-Z0-9.\-]+\.[a-zA-Z]{2,}$

Morocco Phone Validation

^(?:(?:\+|00)212|0)\s?[5-7](?:\s?\d){8}$

Global Character Allowlist

^[a-zA-Z0-9@\-\/\s]*$

Rules Summary

Group	Fields	Transformation
Title Case	Name, Nationality, Address, City, Locations, Country	"John Doe"
Title Case All	Full Address, Company Names	"Acme Corporation Ltd."
Lowercase	Email	"user@domain.com"
Uppercase	IDs, Licenses, Documents	"ABC-123"
Preserved	ZIP Code, Phone	As entered