[Docs]: Add inline documentation for complex algorithms

[rubentalstra]

Description

Complex algorithms need inline documentation.

Target Areas

• Fuzzy matching algorithm
• Normalization rules
• Validation logic

Expected Documentation

• Algorithm explanation
• Complexity analysis
• Edge cases

Acceptance Criteria

• Document fuzzy matching
• Document normalization
• Document validation rules
• Tests pass