mirror of
https://github.com/Govor-team/Govor.git
synced 2026-11-16 20:56:03 +00:00
29cc51ee0c
Implements message reactions and reaction packs (domain models, services, admin HTTP API, media processing via ImageSharp and limits) and adds reliable push delivery (ChatPushNotification, ChatPushDispatcher, ChatPushWorker, improved ChatNotificationService). Enhances message reading (ReadChat API, unread counts, concurrency-safe receipts) and tightens session security (access-token session validation in JWT, hub filter, SessionAuthorization). Improves SignalR behavior (session groups, reaction/channel events, hub/error mappings). Adds EF migrations, many controller fixes (Forbid handling, password API), tests (Govor.Server.Tests), docs, CI and tooling updates (Dockerfile → .NET 10, GH Actions matrix for sqlite/postgres, Govor.Server.slnx, global.json), and small infra changes (AutoMapper bump, NullPushProvider, storage/token handling).
43 lines
3.0 KiB
Markdown
43 lines
3.0 KiB
Markdown
# Медиа
|
||
|
||
Требуется роль User/Admin.
|
||
|
||
## POST /api/media/upload
|
||
|
||
Content-Type: multipart/form-data. Поля:
|
||
|
||
| Поле | Тип | Назначение |
|
||
| --- | --- | --- |
|
||
| FromFile | файл | Непустое содержимое |
|
||
| Type | число | Image=0, Video=1, Audio=2, File=3, Voice=4 |
|
||
| MimeType | строка ≤255 | MIME типа файла |
|
||
| EncryptedKey | строка | Обязательное поле запроса; сохранение ключа не реализовано |
|
||
| OwnerType | число | Message=0, Avatar=1, GroupAvatar=2, System=3 |
|
||
|
||
Ограничение запроса — 20 000 000 байт, включая multipart; проверка файла также ≤20 000 000. Не следует обещать загрузку файла ровно этого размера: overhead тоже входит в лимит.
|
||
|
||
Успех 200:
|
||
|
||
```json
|
||
{"mediaId":"11111111-1111-1111-1111-111111111111","url":"2026/10/<имя файла>"}
|
||
```
|
||
|
||
url — относительный путь хранилища, не публичный URL. Для скачивания используйте endpoint.
|
||
|
||
## GET /api/media/download/{id}
|
||
|
||
Проверяет HasAccessAsync, затем возвращает бинарный файл с MIME и Content-Disposition. Если доступа нет или запись не найдена — 403, потому что проверка доступа выполняется первой. Сервисные ошибки — через ResultExtensions.
|
||
|
||
## Ограничения
|
||
|
||
Для личного сообщения accesser сравнивает Message.RecipientId с userId, хотя там ID чата: получатель может получить 403. При Send принадлежность вложения загрузившему пользователю не проверяется. OwnerType задаёт клиент, включая публично доступный System, — нужна серверная политика владения.
|
||
|
||
EncryptedKey не хранится ни в MediaFile, ни в MediaAttachments. Нельзя обещать восстановление ключа из истории.
|
||
|
||
Файлы целиком буферизуются в памяти, MIME принимается от клиента. Запись файла и БД не атомарна: возможны файлы без записи. Очистка неиспользуемых загрузок и stream-based выдача требуют реализации.
|
||
|
||
---
|
||
Проверено по исходникам на 03.10.2026, commit `4603be9`. Описано текущее поведение; успешная сборка не означает проверку работающего сервера.
|
||
|
||
Источник: [Govor.API/Controllers/MediaController.cs](https://github.com/Govor-team/Govor/blob/4603be9f714135e0af72d505d17f3d1709834bea/Govor.API/Controllers/MediaController.cs).
|