mirror of
https://github.com/Govor-team/Govor.git
synced 2026-11-16 20:56:03 +00:00
57 lines
5.2 KiB
Markdown
57 lines
5.2 KiB
Markdown
# Запуск и конфигурация
|
||
|
||
## Требования
|
||
|
||
.NET SDK 10 с корректной feature band, PostgreSQL, доступ к NuGet, файл `libs/SmartRes.dll`, каталог `Govor.API/configs` и Firebase service account в `Govor.API/secrets/firebase-adminsdk.json`.
|
||
|
||
В `global.json` записана некорректная версия SDK `10.0.0`; замените её в отдельном исправлении на установленную версию, например `10.0.400`. Во время диагностики SDK 10.0.400 всё же собрал отдельный проект API.
|
||
|
||
## Команды из корня репозитория
|
||
|
||
```powershell
|
||
dotnet restore Govor.API/Govor.API.csproj
|
||
dotnet build Govor.API/Govor.API.csproj --no-restore
|
||
dotnet ef database update --project Govor.Domain --startup-project Govor.API
|
||
dotnet run --project Govor.API/Govor.API.csproj
|
||
```
|
||
|
||
Команда миграции требует установленного инструмента dotnet-ef; она приведена как инструкция и не выполнялась на пользовательской БД. Перед обновлением существующей БД проверьте миграции и резервную копию.
|
||
|
||
## Конфигурация
|
||
|
||
| Ключ / ресурс | Назначение |
|
||
| ----------------------------------------- | ----------------------------------------------------------- |
|
||
| ConnectionStrings:GovorDbContext | PostgreSQL connection string |
|
||
| JwtAccessOption:SecretKey | Ключ подписи JWT |
|
||
| JwtAccessOption:Minutes | Срок access token в минутах |
|
||
| JwtRefreshOption:RefreshTokenLifetimeDays | Срок refresh-сессии |
|
||
| MessageEditingOptions:Enabled | Применять ли срок редактирования |
|
||
| MessageEditingOptions:MaxEditTimeMinutes | Срок редактирования; значение класса по умолчанию 15 |
|
||
| configs/ban\_usernames.json | UsernameModeration: BlockedExact, BlockedContains, Reserved |
|
||
| secrets/firebase-adminsdk.json | Обязательные учётные данные Firebase при старте |
|
||
| uploads/ | Файлы относительно ContentRootPath |
|
||
|
||
Не переносите реальные ключи, пароли и service account в документацию или Git. Не рассчитывайте только на переменные окружения: Program.cs повторно добавляет appsettings.json после стандартных провайдеров, поэтому JSON может перекрыть их значения. Это нужно исправить.
|
||
|
||
Firebase создаётся безусловно. Наличие NullPushProvider не даёт выключить Firebase конфигурацией в текущем DI.
|
||
|
||
## Развёртывание и проверка
|
||
|
||
Dockerfile устарел: использует .NET 8 и ссылается на удалённые Govor.Core/Govor.Data. Solution также ссылается на внешний проект SmartRes. До исправления используйте сборку конкретного API-проекта.
|
||
|
||
HTTPS redirection отключён; TLS и forwarded headers требуют отдельной настройки. SessionKeysController содержит RequireHttps, поэтому HTTP для его методов не подходит.
|
||
|
||
`GET /server/ping` — маршрут проверки доступности, но возвращает MVC OkResult из minimal API (предупреждение ASP0004); не считайте его полноценным health check БД и Firebase.
|
||
|
||
Swagger включён во всех окружениях. UseSwagger обслуживает документ через middleware; поздний MapSwagger.RequireAuthorization не является надёжным подтверждением защиты всех Swagger-маршрутов.
|
||
|
||
## Что проверено
|
||
|
||
Restore API-зависимостей и сборка API завершились. Первая сборка: 90 предупреждений, 0 ошибок. Restore Govor.API.Tests завершился NU1201: net8.0 не может ссылаться на net10.0. Сервер с БД и Firebase не запускался; контейнер и миграции не проверялись.
|
||
|
||
***
|
||
|
||
Проверено по исходникам на 03.10.2026, commit `4603be9`. Описано текущее поведение; успешная сборка не означает проверку работающего сервера.
|
||
|
||
Источник: [Govor.API/Program.cs](https://github.com/Govor-team/Govor/blob/4603be9f714135e0af72d505d17f3d1709834bea/Govor.API/Program.cs).
|