"""Слой доступа к данным (CRUD) — по файлу на сущность. Правила слоя: * функции принимают открытую sqlalchemy Session первым аргументом; * возвращают ORM-объекты (или None), но НЕ HTTP-ошибки: решать, что значит «не найдено» (404) или «занято» (409), — задача domain; * НЕ вызывают session.commit()/rollback(): границу транзакции задаёт domain; максимум — session.flush(), чтобы получить ошибки ограничений сразу; * только параметризованные запросы через ORM / sqlalchemy.select (никакого f-string SQL). """