mirror of
https://github.com/Govor-team/Govor.git
synced 2026-11-16 20:56:03 +00:00
def724e0ee
Organize reply/forward and friendship guidance into focused endpoint docs, add Govor+ privilege, profile-tag, and realtime guides, and document migrations and verification results.
74 lines
7.2 KiB
Markdown
74 lines
7.2 KiB
Markdown
# Тестирование
|
|
|
|
## Серверный набор
|
|
|
|
Из корня репозитория:
|
|
|
|
```powershell
|
|
dotnet restore Govor.Server.slnx
|
|
dotnet build Govor.Server.slnx --no-restore -c Release
|
|
dotnet test Govor.Server.slnx --no-build --no-restore -c Release --logger trx --results-directory artifacts/test-results
|
|
```
|
|
|
|
По умолчанию каждый тест создаёт изолированную SQLite in-memory БД. HTTP/SignalR тесты поднимают приложение внутри тестового хоста; Firebase и хранилище подменяются. Production-БД, реальные push credentials и пользовательские файлы не нужны.
|
|
|
|
| Проект | Область |
|
|
| --- | --- |
|
|
| `tests/Govor.Domain.Tests` | Ограничения БД и миграции |
|
|
| `tests/Govor.Application.Tests` | Прикладные сервисы, права, токены, хранение, валидация |
|
|
| `tests/Govor.API.Tests` | Контроллеры, хабы, фильтры и транспортные границы |
|
|
| `tests/Govor.Server.Tests` | HTTP/JWT, SignalR, E2EE, восстановление, push и группы |
|
|
|
|
На Windows криптографические тесты требуют обычного профиля Windows CNG. Ограниченная sandbox-учётная запись может дать ошибку импорта PKCS#8; это не следует устранять изменением криптографического протокола.
|
|
|
|
## PostgreSQL
|
|
|
|
Используйте отдельную БД с именем, заканчивающимся `_tests`, и пользователя с правом создания/удаления схем. **Не указывайте рабочую БД.**
|
|
|
|
```powershell
|
|
$env:TEST_POSTGRES_CONNECTION = 'Host=localhost;Port=5432;Database=govor_tests;Username=govor;Password=YOUR_TEST_PASSWORD'
|
|
dotnet test Govor.Server.slnx -c Release
|
|
Remove-Item Env:TEST_POSTGRES_CONNECTION
|
|
```
|
|
|
|
Каждый тест использует отдельную схему и применяет миграции; соединения без пула защищают лимит PostgreSQL. CI запускает SQLite и PostgreSQL; состав job задан в `.github/workflows/dotnet.yml`.
|
|
|
|
## Проверенная ревизия
|
|
|
|
30.10.2026 на `a3401ce` прошли **735 тестов** Release на SQLite: Domain — 8, Application — 296, API — 271, Server — 160; ошибок и пропусков нет. Запуск выполнялся до fast-forward слияния, которое сохранило тот же коммит. В этой проверке PostgreSQL, настоящий Firebase, контейнер и UI устройств не запускались.
|
|
|
|
Сборка выдала предупреждения компилятора и NuGet, включая известные уязвимости `SixLabors.ImageSharp 3.1.12`. Успешные тесты не означают отсутствие этих проблем.
|
|
|
|
## Покрытие
|
|
|
|
```powershell
|
|
dotnet test Govor.Server.slnx --no-build --no-restore -c Release --collect 'XPlat Code Coverage;Format=json,cobertura' --results-directory artifacts/coverage
|
|
./tests/Measure-ApplicationCoverage.ps1 -ResultsDirectory artifacts/coverage
|
|
./tests/Measure-ApplicationCoverage.ps1 -ResultsDirectory artifacts/coverage -AssemblyName Govor.API -ExcludeGeneratedSources -MinimumLineCoverage 98 -MinimumBranchCoverage 92
|
|
```
|
|
|
|
CI проверяет пороги 98% строк и 92% ветвей для Application и исходников API. Проценты из разных проектов нельзя складывать: они покрывают пересекающиеся сборки. Отчёты от 24.10.2026 в `tests/APPLICATION-COVERAGE.md` и `tests/API-COVERAGE.md` — исторические измерения; после добавления тестов восстановления они не пересчитывались в текущем запуске.
|
|
|
|
Перед релизом дополнительно проверьте HTTPS/WSS, доставку на физические устройства, восстановление архива на чистом устройстве, старые вложения после деплоя и восстановление резервной копии. [Порядок обновления](operations.md).
|
|
|
|
## Проверка расширений API от 31.10.2026
|
|
|
|
Проверки находятся в `ReplyAndForwardTests`, `UserBenefitsTests`, `E2eeTests` и `ReadApiTests` (`UserBenefitsHttpTests.cs`). Они проверяют SQL-хранение, отсутствие доступа к чужим сообщениям, шифрование пересылки для нового адресата, идемпотентность, права админа, валидацию оформления и доставку выдачи/изменения/сброса/отзыва статуса через реальные WebSocket-подключения трёх пользователей.
|
|
|
|
```powershell
|
|
dotnet test Govor.Server.slnx --no-restore
|
|
```
|
|
|
|
### Результат проверки 31.10.2026
|
|
|
|
На итоговом исходном коде `dotnet test Govor.Server.slnx --no-restore -c Release` с Coverlet завершился успешно: **771 тест**, из них **36 новых**. Использовались SQLite in-memory, HTTP TestServer и реальные SignalR WebSocket-соединения. Миграции проверены через `has-pending-model-changes` и генерацию PostgreSQL SQL-скрипта; применение к живой PostgreSQL в этом прогоне не выполнялось.
|
|
|
|
Для сравнения исходный коммит `a3401ce` проверен отдельной временной рабочей копией с теми же Release-настройками и штатным скриптом измерения покрытия:
|
|
|
|
| Сборка | Исходные строки / ветви | Итоговые строки / ветви |
|
|
| -------------------------------- | ----------------------- | ----------------------- |
|
|
| Govor.Application | 98,06% / 88,18% | 98,10% / 88,80% |
|
|
| Govor.API, без generated sources | 97,03% / 90,91% | 97,05% / 91,06% |
|
|
|
|
Пороги CI 98% строк и 92% ветвей **не достигнуты в обеих версиях**; они не снижались. Это остаётся ограничением общего покрытия репозитория. Новый `UserBenefitsService`, `FriendManagementController`, `MessageLookupController`, а также изменённые `MessageSendingService` и `FriendshipService` покрыты по строкам на 100%. `UserBenefitsController` — 20 из 21 исполняемой строки; непокрытым остаётся HTTP-ответ 409 на конкурентное создание прав (сам конфликт проверен интеграционным тестом сервиса).
|