docs: split messaging and privileges guides

Organize reply/forward and friendship guidance into focused endpoint docs, add Govor+ privilege, profile-tag, and realtime guides, and document migrations and verification results.
This commit is contained in:
Artemy
2026-10-31 18:35:50 +07:00
parent 632ac04b56
commit def724e0ee
9 changed files with 246 additions and 257 deletions
+14
View File
@@ -26,3 +26,17 @@ Bearer token обязателен; отдельная роль в атрибут
Источник: [Govor.API/Controllers/Friends/FriendshipController.cs](https://github.com/stalcker2288969/Govor/blob/a3401ceedf30c2eb6167f7ef6e4ae820883d2de2/Govor.API/Controllers/Friends/FriendshipController.cs).
## Удаление из друзей и блокировка
| HTTP | Действие |
| ------------------------------------ | ---------------------------- |
| `DELETE /api/friends/{userId}` | Удалить принятую дружбу |
| `PUT /api/friends/{userId}/block` | Заблокировать пользователя |
| `DELETE /api/friends/{userId}/block` | Снять собственную блокировку |
Успех — `204`. Идентификатор текущего пользователя всегда берётся из JWT. Пустой ID и действие на себя дают `400`; блокировка несуществующего пользователя — `404`; изменение чужой блокировки — `403`.
Удаление идемпотентно, переводит принятую дружбу в `Rejected`, сохраняет историю чата и не снимает блокировку. Само удаление дружбы не запрещает отправку в ранее созданный чат: для этого нужна блокировка. Блокировка может создаваться без дружбы, исключает пользователя из друзей и запрещает новые сообщения в личном чате в обе стороны, а также новые заявки. Чтение истории и общие группы сохраняются.
Используется существующая модель `FriendshipStatus.Blocked`: у пары одна блокировка, её владелец записан как `RequesterId`. Только владелец может снять её; вторая сторона не может заменить владельца. Повтор собственной блокировки безопасен. Снятие блокировки не восстанавливает дружбу: требуется новая заявка и согласие получателя.