Add media image handling and related endpoints
CI / Backend (build + test) (push) Failing after 1m35s
CI / Frontend (lint + typecheck + build) (push) Successful in 43s

- Introduced `MediaImage` entity to manage images for markdown in instructions and news.
- Updated `IAppDbContext` and `AppDbContext` to include `MediaImages` DbSet.
- Implemented `DeleteMediaImageFilesAsync` method in `FactoryResetCommandHandler` to remove media images during factory reset.
- Added new API endpoints for uploading and retrieving media images, enhancing markdown support.
- Updated frontend components to utilize the new `MarkdownEditor` for image uploads in instructions and news.
- Enhanced documentation to reflect the new media handling features and API specifications.
This commit is contained in:
Leonid Pershin
2026-07-30 04:05:01 +03:00
parent cc7e2a7f8f
commit c2ed3240bd
37 changed files with 2052 additions and 63 deletions
+20
View File
@@ -30,6 +30,7 @@ VpnConfig ─*─ TrafficSample (история трафика; пишетс
AuditLog (append-only журнал действий; ссылается на ActorId/TargetId)
ClientApp (каталог приложений-клиентов; группируется по OperatingSystem)
NewsPost (лента новостей; публикуется админом, видна всем аутентифицированным пользователям)
MediaImage (картинка для markdown инструкций/новостей; диск-хранилище, отдаётся анонимно по Id)
AppUser
└─0..*─ SupportTicket (баг-репорт/предложение либо заявка на продление)
└─1───*─ TicketComment (переписка; первое сообщение = описание/обоснование)
@@ -836,6 +837,25 @@ docker-compose) — первая в проекте функциональнос
Отдаётся авторизованным эндпоинтом (`GET /api/support/attachments/{id}`, проверка владения тикетом
или роли admin), не статикой — вложения могут быть чувствительными.
### MediaImage — картинка для markdown
Картинка, загруженная админом для вставки в markdown инструкций/новостей
(`POST /api/admin/media/images`). То же диск-хранилище (`IFileStorage`), те же ограничения, что и у
вложений тикетов (`image/jpeg|png|webp|gif`, ≤5 МБ), но, в отличие от них, **отдаётся анонимно** по
непрозрачному `Id`: markdown рендерится обычным `<img>`, который не шлёт `Authorization`.
| Поле | Тип | Заметки |
| ---------------- | ---------------- | ------------------------------------------------------------------ |
| `Id` | `Guid` | PK; он же — ссылка `/api/media/images/{id}` в markdown |
| `FileName` | `string` | Оригинальное имя — для `alt` и отображения, не участвует в пути на диске |
| `StoredFileName` | `string` | Серверное GUID-имя на диске |
| `ContentType` | `string` | SVG не допускается (документ со скриптами, а ссылка публичная) |
| `SizeBytes` | `long` | |
| `UploadedBy` | `Guid` | Админ-загрузчик (для расследования, отдельного экрана управления нет) |
| `CreatedAt` | `DateTimeOffset` | |
Связи с инструкцией/новостью нет — картинка живёт только как ссылка внутри markdown-текста, поэтому
удаление вкладки/новости файл не трогает; всё медиа стирается при factory reset.
## Value Objects
- **NodeCredentials** (`Nodes/NodeCredentials.cs`) — `Username` + `ProtectedPassword` (шифротекст,