Рефакторинг функции

Отрефактори следующую функцию, улучшив читаемость и поддерживаемость:

```{язык}
{код}
```

Требования:
- Разбей на мелкие функции с понятными именами
- Убери вложенные условия (используй early return)
- Замени магические числа и строки на константы
- Добавь типизацию (если применимо)
- Сохрани исходное поведение — без изменения логики
- Покажи результат с комментариями к каждому изменению

Покажи код ДО и ПОСЛЕ, объясни каждое решение.