Почему не рекомендуется смешивать ORM-модели и DTO (request/response схемы) в одном файле?

Определение

ORM-модель — это описание таблицы базы данных и правил работы с ней.
DTO (Data Transfer Object) — это структура данных для передачи информации между слоями или наружу через API.

Почему их нельзя смешивать

Хотя поля могут выглядеть одинаково, назначение у них принципиально разное:

1. Разная ответственность

   • ORM — хранение и целостность данных

   • DTO — контракт API и валидация входных данных

2. Разная скорость изменений

   • API меняется чаще, чем схема БД

   • бизнес-требования влияют на DTO, но не всегда на БД

3. Риск утечек данных

   • ORM может содержать служебные поля

   • DTO должен отдавать только разрешённые данные

Типовая проблема

Если использовать одну модель и для БД, и для ответа API, можно случайно:

• отдать приватные поля

• сломать API при миграции БД

• сделать невозможным версионирование API

Пример плохой практики

class User(Base, BaseModel):
    id: int
    email: str
    password_hash: str

Здесь смешаны:

• логика хранения

• контракт API

Вывод

Разделение ORM и DTO делает код устойчивым к изменениям, безопасным и проще поддерживаемым.