Первый UseCase

2025-08-18 21:53:03 +03:00
parent 457526bd10
commit 94b5dd066c
1 changed files with 30 additions and 0 deletions
@@ -25,6 +25,36 @@
 * Выводится сообщение об ошибке
 ### 7.Постусловия
 * Пользователь с указанным логином сохранен в БД
+### 8.Маршруты
+* `/api/v1/auth/register` - Регистрация пользователя
+### 9.Контракт
+#### Request
+```
+{
+  "login": "ivan_89",
+  "password": "S3cureP@ssw0rd"
+}
+```
+#### Требования к валидации:
+* login: 3-50 символов, [a–z0–9._-], уникальное значение
+* password: ≥ 8 символов
+
+#### Response - 201 - Created
+```
+{
+  "user": {
+    "login": "ivan_89"
+  }
+}
+```
+
+#### Errors
+* `409 USER_EXISTS` — пользователь с таким логином уже есть
+* `422 VALIDATION_FAILED` — пустой логин/неправильный пароль
+* `400 BAD_REQUEST` — сервер не смог десереализовать JSON
+
+### 10. Используемые сущности ДБ
+* users(guid, login, hashed_password)

 ## UseCase №2
 ### 1.Название: Авторизация пользователя