Refactor for Readability and Maintainability

Refactor the following code to improve readability and maintainability, without changing behaviour.
  
  Goals:
  - Use clearer naming for variables and functions.
  - Reduce nesting and deeply indented blocks.
  - Extract small, reusable helper functions where it makes sense.
  - Remove dead code and obvious duplication.
  
  Code:
  
  [Paste code here]