Українська
Тестування репозиторіїв
Кожен крок цього розділу додає тестовий клас (або тести до наявного) для однієї області рівня даних. Наберіть тести, запустіть їх і хоча б для одного тесту в кожному класі зламайте код, який він захищає, та подивіться, як тест падає, як у попередньому розділі.
Крок 1. Історія повідомлень
Навіщо. Посторінкове читання за ключем (тема 5) легко непомітно зіпсувати: помилка на одиницю на межі сторінок, пропущений Take(limit + 1), хибний напрямок сортування для after. Тести використовують 120 повідомлень зі відомим порядком і перевіряють кожну межу.
Що зробити.
cs
using Chatex.Data.Abstractions;
using Chatex.Data.Entities;
namespace Chatex.Data.Tests;
public sealed class MessageRepositoryTests(PostgresFixture fixture) : DbTestBase(fixture)
{
[Fact]
public async Task GetPageAsync_pages_backwards_through_history_newest_first()
{
var alice = await CreateUserAsync("alice");
var chat = await CreateChatAsync(ChatType.Group, alice, []);
var messages = await AddMessagesAsync(chat, alice, 120);
var ids = messages.Select(m => m.Id).ToList();
await using var scope = NewScope();
var repository = Get<IMessageRepository>(scope);
var page1 = await repository.GetPageAsync(chat.Id, before: null, after: null, limit: 50, Ct);
var page2 = await repository.GetPageAsync(chat.Id, before: page1.NextCursor, after: null, limit: 50, Ct);
var page3 = await repository.GetPageAsync(chat.Id, before: page2.NextCursor, after: null, limit: 50, Ct);
page1.Items.Select(m => m.Id).ShouldBe(ids[70..120].AsEnumerable().Reverse());
page2.Items.Select(m => m.Id).ShouldBe(ids[20..70].AsEnumerable().Reverse());
page3.Items.Select(m => m.Id).ShouldBe(ids[0..20].AsEnumerable().Reverse());
page1.NextCursor.ShouldBe(ids[70]);
page3.NextCursor.ShouldBeNull();
page1.Items[0].Sender.Profile.ShouldNotBeNull();
}
[Fact]
public async Task GetPageAsync_after_returns_newer_messages_oldest_first()
{
var alice = await CreateUserAsync("alice");
var chat = await CreateChatAsync(ChatType.Group, alice, []);
var ids = (await AddMessagesAsync(chat, alice, 30)).Select(m => m.Id).ToList();
await using var scope = NewScope();
var repository = Get<IMessageRepository>(scope);
var page1 = await repository.GetPageAsync(chat.Id, before: null, after: ids[9], limit: 15, Ct);
var page2 = await repository.GetPageAsync(chat.Id, before: null, after: page1.NextCursor, limit: 15, Ct);
page1.Items.Select(m => m.Id).ShouldBe(ids[10..25]);
page2.Items.Select(m => m.Id).ShouldBe(ids[25..30]);
page2.NextCursor.ShouldBeNull();
}
[Fact]
public async Task GetPageAsync_only_returns_messages_of_the_chat()
{
var alice = await CreateUserAsync("alice");
var chat = await CreateChatAsync(ChatType.Group, alice, []);
var other = await CreateChatAsync(ChatType.Group, alice, []);
await AddMessagesAsync(chat, alice, 3);
await AddMessagesAsync(other, alice, 5);
await using var scope = NewScope();
var page = await Get<IMessageRepository>(scope).GetPageAsync(chat.Id, null, null, 50, Ct);
page.Items.Count.ShouldBe(3);
page.Items.ShouldAllBe(m => m.ChatId == chat.Id);
}
}- Діапазони на кшталт
ids[70..120]беруть елементи від 70 до 119 (кінець не входить). За 120 повідомлень і сторінок по 50 сторінки – це повідомлення 119–70, 69–20 і 19–0, найновіші першими;.AsEnumerable().Reverse()перетворює висхідний діапазон на такий порядок. ShouldBeдля послідовностей порівнює елементи по порядку й, у разі збою, виводить обидві послідовності та першу відмінність.page1.NextCursor.ShouldBe(ids[70])закріплює контракт курсора: це ідентифікатор останнього повернутого елемента.- Третій тест захищає від найнебезпечнішої помилки – сторінки, що пропускає повідомлення іншого чату.
Крок 2. Учасники й позиції прочитаного
Що зробити.
cs
using Chatex.Data.Abstractions;
using Chatex.Data.Entities;
namespace Chatex.Data.Tests;
public sealed class ChatMemberRepositoryTests(PostgresFixture fixture) : DbTestBase(fixture)
{
[Fact]
public async Task MarkReadAsync_only_moves_the_read_position_forward()
{
var alice = await CreateUserAsync("alice");
var bob = await CreateUserAsync("bob");
var chat = await CreateChatAsync(ChatType.Group, alice, [bob]);
var messages = await AddMessagesAsync(chat, alice, 10);
await using var scope = NewScope();
var repository = Get<IChatMemberRepository>(scope);
(await repository.MarkReadAsync(chat.Id, bob.Id, messages[5].Id, Ct)).ShouldBeTrue();
(await repository.MarkReadAsync(chat.Id, bob.Id, messages[3].Id, Ct)).ShouldBeFalse();
(await repository.MarkReadAsync(chat.Id, bob.Id, messages[7].Id, Ct)).ShouldBeTrue();
var member = await repository.GetAsync(chat.Id, bob.Id, Ct);
member.ShouldNotBeNull().LastReadMessageId.ShouldBe(messages[7].Id);
}
[Fact]
public async Task GetMembersAsync_pages_through_members_with_profiles()
{
var owner = await CreateUserAsync("owner");
var others = new List<User>();
for (var i = 0; i < 4; i++)
{
others.Add(await CreateUserAsync($"user{i}"));
}
var chat = await CreateChatAsync(ChatType.Channel, owner, others);
await using var scope = NewScope();
var repository = Get<IChatMemberRepository>(scope);
var page1 = await repository.GetMembersAsync(chat.Id, afterUserId: null, limit: 3, Ct);
var page2 = await repository.GetMembersAsync(chat.Id, afterUserId: page1.NextCursor, limit: 3, Ct);
page1.Items.Count.ShouldBe(3);
page2.Items.Count.ShouldBe(2);
page2.NextCursor.ShouldBeNull();
page1.Items.Concat(page2.Items).Select(m => m.UserId).ShouldBeUnique();
page1.Items.ShouldAllBe(m => m.User.Profile != null);
(await repository.CountAsync(chat.Id, Ct)).ShouldBe(5);
}
[Fact]
public async Task GetChatIdsForUserAsync_skips_deleted_chats()
{
var alice = await CreateUserAsync("alice");
var kept = await CreateChatAsync(ChatType.Group, alice, []);
var deleted = await CreateChatAsync(ChatType.Group, alice, []);
await using var scope = NewScope();
var chat = await Get<IChatRepository>(scope).GetByIdAsync(deleted.Id, Ct);
chat.ShouldNotBeNull().DeletedAt = DateTimeOffset.UtcNow;
await Get<IUnitOfWork>(scope).SaveChangesAsync(Ct);
var ids = await Get<IChatMemberRepository>(scope).GetChatIdsForUserAsync(alice.Id, Ct);
ids.ShouldBe([kept.Id]);
}
[Fact]
public void Only_owners_and_admins_post_in_channels()
{
new ChatMember { Role = ChatMemberRole.Subscriber }.CanPost(ChatType.Channel).ShouldBeFalse();
new ChatMember { Role = ChatMemberRole.Admin }.CanPost(ChatType.Channel).ShouldBeTrue();
new ChatMember { Role = ChatMemberRole.Member }.CanPost(ChatType.Group).ShouldBeTrue();
}
}MarkReadAsync_only_moves_the_read_position_forwardчитається як його правило: уперед до 5 (змінено), назад до 3 (відмовлено), уперед до 7 (змінено), і збережена позиція – 7.ShouldBeUniqueперевіряє, що дві сторінки учасників не перетинаються.GetChatIdsForUserAsync_skips_deleted_chats«м’яко» видаляє чат через відстежувану сутність іSaveChangesAsync– так це робитиме сервіс у темі 10.Only_owners_and_admins_post_in_channels– звичайний модульний тестChatMember.CanPost; йому не потрібна база даних, і він неasync. Він тут, боCanPostє частиною рівня даних.
Крок 3. Список чатів і публічний пошук
Навіщо. GetUserChatsAsync – найскладніший запит проєкту: порядок, посторінкове читання з двокомпонентним курсором, останнє повідомлення, лічильник непрочитаних із трьома умовами та співрозмовник. Один тест будує маленький світ, у якому важлива кожна умова.
Що зробити. Додайте решту тестів до ChatRepositoryTests (нові рядки виділено зеленим):
cs
using Chatex.Data.Abstractions;
using Chatex.Data.Entities;
using Chatex.Data.Exceptions;
using Microsoft.EntityFrameworkCore;
using Npgsql;
namespace Chatex.Data.Tests;
public sealed class ChatRepositoryTests(PostgresFixture fixture) : DbTestBase(fixture)
{
[Fact]
public async Task A_pair_of_users_can_have_only_one_direct_chat()
{
var alice = await CreateUserAsync("alice");
var bob = await CreateUserAsync("bob");
await CreateChatAsync(ChatType.Direct, alice, [bob]);
var error = await Should.ThrowAsync<UniqueConstraintException>(() => CreateChatAsync(ChatType.Direct, bob, [alice]));
error.ConstraintName.ShouldBe("ix_chats_direct_key");
}
[Fact]
public async Task Only_direct_chats_have_a_direct_key()
{
var alice = await CreateUserAsync("alice");
var bob = await CreateUserAsync("bob");
await using var scope = NewScope();
Get<IChatRepository>(scope).Add(new Chat
{
Type = ChatType.Group,
Title = "group",
DirectKey = Chat.MakeDirectKey(alice.Id, bob.Id),
CreatedById = alice.Id,
});
var error = await Should.ThrowAsync<DbUpdateException>(() => Get<IUnitOfWork>(scope).SaveChangesAsync(Ct));
error.InnerException.ShouldBeOfType<PostgresException>().SqlState.ShouldBe(PostgresErrorCodes.CheckViolation);
}
[Fact]
public async Task GetDirectAsync_finds_the_chat_in_either_order()
{
var alice = await CreateUserAsync("alice");
var bob = await CreateUserAsync("bob");
var chat = await CreateChatAsync(ChatType.Direct, alice, [bob]);
await using var scope = NewScope();
var found = await Get<IChatRepository>(scope).GetDirectAsync(bob.Id, alice.Id, Ct);
found.ShouldNotBeNull().Id.ShouldBe(chat.Id);
}
[Fact]
public async Task GetUserChatsAsync_orders_by_activity_and_counts_unread_messages()
{
var alice = await CreateUserAsync("alice");
var bob = await CreateUserAsync("bob");
var now = DateTimeOffset.UtcNow;
var group = await CreateChatAsync(ChatType.Group, alice, [bob], now.AddHours(-3));
var channel = await CreateChatAsync(ChatType.Channel, bob, [alice], now.AddHours(-2));
var direct = await CreateChatAsync(ChatType.Direct, alice, [bob], now.AddHours(-1));
await CreateChatAsync(ChatType.Group, bob, [], now); // alice is not a member
var fromBob = await AddMessagesAsync(direct, bob, 3);
await AddMessagesAsync(direct, alice, 1); // own messages are never unread
await AddMessagesAsync(channel, bob, 4);
await using var scope = NewScope();
(await Get<IChatMemberRepository>(scope).MarkReadAsync(direct.Id, alice.Id, fromBob[0].Id, Ct)).ShouldBeTrue();
var repository = Get<IChatRepository>(scope);
var page1 = await repository.GetUserChatsAsync(alice.Id, after: null, limit: 2, Ct);
var page2 = await repository.GetUserChatsAsync(alice.Id, after: page1.NextCursor, limit: 2, Ct);
page1.Items.Select(i => i.Chat.Id).ShouldBe([direct.Id, channel.Id]);
page2.Items.Select(i => i.Chat.Id).ShouldBe([group.Id]);
page2.NextCursor.ShouldBeNull();
var directItem = page1.Items[0];
directItem.UnreadCount.ShouldBe(2);
directItem.Peer.ShouldNotBeNull().UserName.ShouldBe("bob");
directItem.LastMessage.ShouldNotBeNull().SenderId.ShouldBe(alice.Id);
var channelItem = page1.Items[1];
channelItem.UnreadCount.ShouldBe(4);
channelItem.Role.ShouldBe(ChatMemberRole.Subscriber);
channelItem.Peer.ShouldBeNull();
page2.Items[0].LastMessage.ShouldBeNull();
page2.Items[0].UnreadCount.ShouldBe(0);
}
[Fact]
public async Task SearchPublicAsync_matches_handle_or_title_of_public_chats_only()
{
var alice = await CreateUserAsync("alice");
await using (var seed = NewScope())
{
var chats = Get<IChatRepository>(seed);
chats.Add(new Chat { Type = ChatType.Channel, Title = "Dotnet news", PublicHandle = "dotnet", CreatedById = alice.Id });
chats.Add(new Chat { Type = ChatType.Group, Title = "Private dotnet", CreatedById = alice.Id });
await Get<IUnitOfWork>(seed).SaveChangesAsync(Ct);
}
await using var scope = NewScope();
var results = await Get<IChatRepository>(scope).SearchPublicAsync("DOTNET", 10, Ct);
results.Select(c => c.PublicHandle).ShouldBe(["dotnet"]);
}
}Світ тесту списку чатів:
| Чат | Роль Alice | Активність | Повідомлення | Очікується |
|---|---|---|---|---|
| особистий з Bob | учасник | 1 годину тому | 3 від Bob, 1 від Alice; Alice прочитала перше повідомлення Bob | перший; 2 непрочитані; співрозмовник bob; останнє повідомлення від Alice |
| канал Bob | підписник | 2 години тому | 4 від Bob | другий; 4 непрочитані; без співрозмовника |
| група Alice | власник | 3 години тому | немає | на сторінці 2; без останнього повідомлення; 0 непрочитаних |
| група Bob | не учасник | зараз | – | у списку взагалі немає |
- «Власні повідомлення ніколи не непрочитані»: власне повідомлення Alice в особистому чаті новіше за її позицію прочитаного, але не повинне враховуватися.
- Група, в якій Alice немає, має найновішу активність; якби запит починався з чатів, а не з членств, вона була б першою.
- Посторінкове читання з лімітом 2 переносить третій чат на сторінку 2, яка має бути останньою.
SearchPublicAsyncшукає у верхньому регістрі ("DOTNET") і має знайти лише публічний канал, а не приватну групу з тим самим словом у назві.
Крок 4. Користувачі, транзакції й токени
Навіщо. Ці тести доводять Unit of Work: реєстрацію, що зберігає і користувача, і профіль в одній транзакції, і реєстрацію, що провалюється на півдорозі й нічого не лишає після себе. Вони також доводять часові мітки перехоплювача й екранування шаблонів пошуку.
Що зробити.
cs
using Chatex.Data.Abstractions;
using Chatex.Data.Entities;
using Microsoft.AspNetCore.Identity;
namespace Chatex.Data.Tests;
public sealed class UserAndAuthTests(PostgresFixture fixture) : DbTestBase(fixture)
{
[Fact]
public async Task Registration_saves_user_and_profile_in_one_transaction()
{
Guid userId;
await using (var scope = NewScope())
{
userId = await Get<IUnitOfWork>(scope).ExecuteInTransactionAsync(async ct =>
{
var user = new User { UserName = "alice", Email = "[email protected]" };
(await Get<UserManager<User>>(scope).CreateAsync(user, "Passw0rd!")).Succeeded.ShouldBeTrue();
Get<IUserRepository>(scope).AddProfile(new UserProfile { UserId = user.Id, DisplayName = "Alice" });
await Get<IUnitOfWork>(scope).SaveChangesAsync(ct);
return user.Id;
}, Ct);
}
await using var check = NewScope();
var saved = await Get<IUserRepository>(check).GetWithProfileAsync(userId, Ct);
saved.ShouldNotBeNull();
saved.CreatedAt.ShouldNotBe(default);
saved.Profile.ShouldNotBeNull().DisplayName.ShouldBe("Alice");
saved.Profile.UpdatedAt.ShouldNotBe(default);
}
[Fact]
public async Task Registration_rolls_back_the_user_when_a_later_step_fails()
{
await using (var scope = NewScope())
{
await Should.ThrowAsync<InvalidOperationException>(() =>
Get<IUnitOfWork>(scope).ExecuteInTransactionAsync(async _ =>
{
var user = new User { UserName = "alice", Email = "[email protected]" };
(await Get<UserManager<User>>(scope).CreateAsync(user, "Passw0rd!")).Succeeded.ShouldBeTrue();
throw new InvalidOperationException("profile step failed");
}, Ct));
}
await using var check = NewScope();
(await Get<UserManager<User>>(check).FindByNameAsync("alice")).ShouldBeNull();
}
[Fact]
public async Task SearchAsync_treats_like_wildcards_as_plain_text()
{
await CreateUserAsync("alice");
await CreateUserAsync("bob_smith");
await using var scope = NewScope();
var repository = Get<IUserRepository>(scope);
(await repository.SearchAsync("_", 10, Ct)).Select(u => u.UserName).ShouldBe(["bob_smith"]);
(await repository.SearchAsync("ALI", 10, Ct)).Select(u => u.UserName).ShouldBe(["alice"]);
}
[Fact]
public async Task RevokeAllForUserAsync_revokes_only_active_tokens_of_that_user()
{
var alice = await CreateUserAsync("alice");
var bob = await CreateUserAsync("bob");
var now = DateTimeOffset.UtcNow;
await using (var seed = NewScope())
{
var tokens = Get<IRefreshTokenRepository>(seed);
tokens.Add(new RefreshToken { UserId = alice.Id, TokenHash = "a1", ExpiresAt = now.AddDays(7) });
tokens.Add(new RefreshToken { UserId = alice.Id, TokenHash = "a2", ExpiresAt = now.AddDays(7) });
tokens.Add(new RefreshToken { UserId = alice.Id, TokenHash = "a-expired", ExpiresAt = now.AddDays(-1) });
tokens.Add(new RefreshToken { UserId = bob.Id, TokenHash = "b1", ExpiresAt = now.AddDays(7) });
await Get<IUnitOfWork>(seed).SaveChangesAsync(Ct);
}
await using var scope = NewScope();
var repository = Get<IRefreshTokenRepository>(scope);
(await repository.RevokeAllForUserAsync(alice.Id, now, Ct)).ShouldBe(2);
(await repository.GetByHashAsync("a1", Ct)).ShouldNotBeNull().IsActiveAt(now).ShouldBeFalse();
(await repository.GetByHashAsync("b1", Ct)).ShouldNotBeNull().IsActiveAt(now).ShouldBeTrue();
(await repository.DeleteStaleAsync(now.AddSeconds(1), Ct)).ShouldBe(3);
}
}- Тест відкоту викидає виняток усередині
ExecuteInTransactionAsyncпісля того, якUserManagerуже зберіг користувача. Нова область шукаєalice– і не повинна її знайти. Без транзакції користувач існував би без профілю. saved.CreatedAt.ShouldNotBe(default)іsaved.Profile.UpdatedAt.ShouldNotBe(default)– це тестиTimestampInterceptor, які обіцяла тема 4.SearchAsync("_", …)має знайти лишеbob_smith: з неекранованим_збігся б кожен користувач.RevokeAllForUserAsyncвідкликає обидва активні токени Alice, але ні її прострочений токен, ні токени Bob; потімDeleteStaleAsyncвидаляє три токени, що прострочені або відкликані.
Крок 5. Unit of Work і сховище файлів
Що зробити.
cs
using Chatex.Data.Abstractions;
using Chatex.Data.Entities;
using Chatex.Data.Exceptions;
namespace Chatex.Data.Tests;
public sealed class StorageAndUnitOfWorkTests(PostgresFixture fixture) : DbTestBase(fixture)
{
[Fact]
public async Task SaveChangesAsync_turns_a_unique_violation_into_UniqueConstraintException()
{
var alice = await CreateUserAsync("alice");
await using var scope = NewScope();
var chats = Get<IChatRepository>(scope);
chats.Add(new Chat { Type = ChatType.Channel, Title = "a", PublicHandle = "taken", CreatedById = alice.Id });
chats.Add(new Chat { Type = ChatType.Channel, Title = "b", PublicHandle = "taken", CreatedById = alice.Id });
var error = await Should.ThrowAsync<UniqueConstraintException>(() => Get<IUnitOfWork>(scope).SaveChangesAsync(Ct));
error.ConstraintName.ShouldBe("ix_chats_public_handle");
}
[Fact]
public async Task LocalFileStorage_saves_reads_and_deletes_a_file()
{
await using var scope = NewScope();
var storage = Get<IFileStorage>(scope);
var path = await storage.SaveAsync(new MemoryStream([1, 2, 3]), Ct);
path.ShouldMatch(@"^\d{4}/\d{2}/[0-9a-f]{32}$");
await using (var read = await storage.OpenReadAsync(path, Ct))
{
var copy = new MemoryStream();
await read.CopyToAsync(copy, Ct);
copy.ToArray().ShouldBe([1, 2, 3]);
}
await storage.DeleteAsync(path, Ct);
await Should.ThrowAsync<FileNotFoundException>(() => storage.OpenReadAsync(path, Ct));
}
[Fact]
public async Task LocalFileStorage_rejects_paths_outside_its_root()
{
await using var scope = NewScope();
await Should.ThrowAsync<ArgumentException>(() => Get<IFileStorage>(scope).OpenReadAsync("../secret.txt", Ct));
}
}- Два чати з однаковим псевдонімом в одному збереженні – друга вставка порушує
ix_chats_public_handle, аUnitOfWorkперетворює помилку PostgreSQL наUniqueConstraintExceptionз цим іменем. ShouldMatchзіставляє шлях у сховищі з регулярним виразом: чотири цифри, дві цифри, 32 шістнадцяткові символи – жодного сліду імені файлу клієнта."../secret.txt"має бути відхилено черезArgumentException, ще до того, як зачеплено файлову систему.
Перевірка
powershell
dotnet test --solution Chatex.slnxTest run summary: Passed!
total: 19
failed: 0
succeeded: 19
skipped: 0Увесь запуск, разом зі стартом контейнера й застосуванням міграції, займає близько 15 секунд.