Что не нравится в текущем проекте?
Комментарии (1)
Ответ сгенерирован нейросетью и может содержать ошибки
Что не нравится в текущем проекте?
Архитектурные проблемы
В большинстве проектов я встречаюсь со слабой границей между слоями. Главная боль — когда бизнес-логика размазана по контроллерам и моделям базы данных. Это усложняет поддержку и тестирование. Идеально, когда бизнес-логика полностью отделена в domain layer, а остальное — просто адаптеры.
Недостаточное документирование решений
Очень часто нет единого источника истины по архитектурным решениям. Разработчики вынуждены гадать, почему выбран именно этот подход. Это замораживает команду и усложняет онбординг новичков. Нужна структурированная документация с обоснованием: почему REST вместо GraphQL, почему PostgreSQL, почему микросервисы или монолит.
Отсутствие четких API контрактов
В больших проектах API часто развивается хаотично — то добавится trailing slash, то параметры в разных форматах, то 500 ошибок без детальной информации. Нужны OpenAPI спеки, версионирование, consistency в именовании endpoints.
Проблемы с тестированием
- Тесты часто являются просто побочным продуктом разработки, а не живой документацией
- Реальные HTTP запросы в тестах вместо мокирования
- Низкое покрытие на критичных путях
- Отсутствие стратегии тестирования
Миграции и синхронизация
Часто миграции отстают от моделей ORM или наоборот. Source of truth не определён. Нужна четкая цепочка: Goose SQL → SQLAlchemy модель → OpenAPI схема.
Окружение разработки
- Неполное .env в документации
- Отсутствие docker-compose для локальной разработки
- Нет инструкций по бутстрапу проекта
Логирование и error handling
Двойное логирование одной и той же ошибки на разных слоях приводит к noise в логах. Нужна четкая иерархия обработки ошибок: на границах слоев логируем и трансформируем, а внутри слоев просто пробрасываем.
Всё это создает technical debt, замедляет разработку и снижает качество кода.