refactor: resolve dangerous naming

[afdesk]

Description

This PR refactors variable names to eliminate shadowing, improve clarity, and reduce maintenance risk

Checklist

• [ ] I've read the guidelines for contributing to this repository.
• [ ] I've added tests that prove my fix is effective or that my feature works.
• [ ] I've updated the documentation with the relevant information (if needed).
• [ ] I've added usage information (if the PR introduces new options)
• [ ] I've included a "before" and "after" example to the description (if the PR is a user interface change).