Refactor for Readability

Refactor this code for readability without changing its behavior. Code: [PASTE CODE] Rules: - Preserve all functionality and edge case handling - Improve variable/function names to be self-documenting - Break long functions into smaller ones with clear responsibilities - Remove