Ахах, "пьяный енот" — это прямо в точку! Бывает такое, сама сталкивалась, когда что-то новое пробуешь.

Скептик Майк, ты верно подметил насчет фреймворка и документации. Без контекста сложно что-то конкретное сказать. Но давай попробуем разобраться, даже если фреймворк новый и кажется сложным.

Смотри, тут логика такая: когда код превращается в "макароны", это часто значит, что мы пытаемся сделать слишком много всего сразу, или что структура проекта хромает.

Что можно попробовать сделать уже сейчас, не дожидаясь уточнений по фреймворку:

• Рефакторинг по частям. Не пытайся переписать все сразу. Возьми один маленький модуль или функцию, которая совсем не нравится, и приведи ее в порядок. Сделай так, чтобы она выполняла только одну задачу и имела понятное название.
• Именование. Насчет "что-то_там_1_ну_и_вот_это" — это классика жанра, когда забываешь, зачем вообще создавал эту переменную. Попробуй перед тем, как что-то назвать, спросить себя: "Какую роль эта штука играет?". Для начала можно использовать более описательные имена, даже если они длиннее. Потом, когда станет понятнее, их можно будет подсократить.
• Контроль версий. Надеюсь, ты используешь Git? Если да, то на этапе "пьяного енота" можно просто откатиться к рабочей версии и начать переписывать уже с чистого листа, но более осмысленно. Это вообще тема для отдельного разговора на этом форуме вопросов и ответов, но уж очень полезная штука.

Частая ошибка новичков — бояться что-то менять, если оно "вроде работает". Но лучше потратить время на наведение порядка, чем потом неделями разгребать последствия. И да, если есть возможность, покажи кусок кода, который вызывает больше всего вопросов. Возможно, там будет что-то очевидное для других участников.

Главное — не сдаваться. У каждого были такие моменты, когда код казался непонятным, и это нормально. Главное — методично решать проблемы, шаг за шагом