Реализовать эндпойнт регистрации

[birthdaysgift]

После того как была разработана архитектура эндпойнтов авторизации (#77), необходимо приступить к реализации этих эндпойнтов. Т.к. процессы аутентификации и авторизации требуют наличия зарегистрированного в системе Аккаунта, то в первую очередь нужно реализовать эндпойнт регистрации (src/auth/routes.py :: create_account).

Планируемая архитектура бд:

Account

• id (primary key)
• login (unique)
• email (unique)
• created_at
• updated_at

PasswordHash

• account_id (foreign key, primary key)
• value

Profile

• account_id (foreign key, primary key)
• avatar (nullable, unique)
• description (nullable)
• name

В рамках этой задачи необходимо написать реализацию для эндпойнта регистрации.

---

В процессе реализации были приняты следующие решения:

• Использование foreign key в качестве primary key для таблиц, имеющих связь один к одному.

  Например, Профиль пользователя всегда связан с одним и только одним Аккаунтом, таким образом в качестве primary key для таблицы Профиля будет использоваться foreign key на айди записи в таблице Аккаунта. Это позволит нам обеспечить соблюдение некоторых инвариантов доменной модели на уровне бд.

• Отказ от использования default и onupdate в колонках даты и времени.

  Это решение было принято в качестве следствия из разработанного подхода работы с бд, а именно: "бд должна автоматизировать проверку как можно большего количества ограничений, но при этом бд не должна автоматизировать какое-либо изменение данных. Следование этому принципу позволит нам, во-первых, сохранить бизнес логику изменения данных на уровне кода приложения, т.е. сохранить её в явном виде, а не спрятать в бд в виде триггеров и процедур. А во-вторых, обеспечить поддержание целостности данных при попытке внесения изменений в обход кода нашего приложения (например, при проведении миграций).

• Расположение логики обработчиков ошибок в src/app.py.

  Это решение является временным компромиссом и, возможно, будет изменено во время будущего рефакторинга. Мы приняли это решение в связи с тем, что fastapi позволяет привязывать обработчики ошибок только к экземпляру приложения, но не к отдельным роутам.

• Отказ от инкапсуляции логики создания зависимых моделей в методах основной модели.

  Например, при создании Аккаунта всегда должен создаваться соответствующий аккаунту Профиль, но на данных момент эндпойнт создания Аккаунта не содержит в себе вызов эндпойнта создания Профиля. Это связано с тем, что после реализации MVP, мы планируем провести рефакторинг кода, связанного с внесением изменений в бд и созданием объектов модели, с помощью внедрения DDD репозиториев, фабрик и агрегатов. Наша "упрощенная" текущая реализация скорее всего позволит перейти на новый подход более безболезненно (по крайней мере сейчас так кажется).

• Сохранение таймзоны в бд и использование timezone-aware объектов даты и времени.

  Это позволит нам всегда точно знать, что в нашей бд все записи даты и времени добавленные/измененные нашим приложением были сделаны с учетом таймзоны.

• Использование .flush() вместо .commit() в методах изменяющих данные в бд.

  Все методы вносящие изменения в данные бд будут использовать .flush(), чтобы в нашем коде, в рамках сессии мы могли видеть данные в изменённом виде, но при этом .commit() будет вызываться только в тирдауне get_db, позволяя нам фиксировать изменения атомарно в рамках всего эндпойнта, а не в рамках вызовов отдельных методов. У это подхода тоже есть серьезный недостаток - в связи с особенностями работы Dependency в fastapi, применение изменений в бд будет происходить уже после того как ответ 200 будет отправлен (см комментарий). Но т.к. для решения этой проблемы необходимо проводить отдельный ресёрч, было принято решение исправить это в рамках другой задачи.

[birthdaysgift]

Заметки чтоб не забыть

https://www.postgresql.org/docs/current/datatype-datetime.html#DATATYPE-TIMEZONES
https://stackoverflow.com/a/59932909/8431075
https://stackoverflow.com/a/72533665/8431075

удалённые created_at можем добавить потом на основании значений из "родительских" сущностей