Українська
Чати й учасники
Крок 1. Типи чатів і ролі
Навіщо. Особистий чат, група й канал відрізняються тим, хто може бути учасником і хто може писати (табл. 3.1), але мають спільне все інше: назву, учасників, повідомлення, історію. Одна сутність Chat із типом охоплює всі три, замість трьох класів із великою кількістю дубльованого коду.
Таблиця 3.1. Типи чатів і ролі, які вони використовують
| Тип | Учасники | Хто пише | Ролі |
|---|---|---|---|
Direct | рівно двоє користувачів | обидва | Member |
Group | до 1000 | усі | Owner, Admin, Member |
Channel | необмежено | власник та адміністратори | Owner, Admin, Subscriber |
Що зробити. Два переліки описують типи й ролі:
cs
namespace Chatex.Data.Entities;
public enum ChatType
{
/// <summary>One-to-one conversation between exactly two users.</summary>
Direct,
/// <summary>Many members, everyone can post.</summary>
Group,
/// <summary>Broadcast: only owner and admins post, everyone else subscribes.</summary>
Channel,
}cs
namespace Chatex.Data.Entities;
public enum ChatMemberRole
{
Owner,
Admin,
/// <summary>Can post. Used in direct chats and groups.</summary>
Member,
/// <summary>Read-only member of a channel.</summary>
Subscriber,
}У темі 4 база даних зберігає ці значення як рядки ('Direct', 'Owner'), а не як числа. Тоді рядок добре читається в psql, а вставлення нового значення в середину переліку не може непомітно змінити сенс уже наявних рядків.
Крок 2. Чат
Навіщо. Окрім спільних даних, чат має три властивості зі спеціальним значенням:
PublicHandle– унікальний@handle, наприклад@dotnet_news. Група чи канал із псевдонімом публічні: будь-хто може знайти їх у пошуку й приєднатися. Без псевдоніма (null) вони приватні, невидимі для сторонніх.DirectKey– Chatex ніколи не повинен створювати два особисті чати між тими самими двома людьми. Правила «спершу перевірити, потім вставити» недостатньо: два запити, що надійшли одночасно, можуть обидва пройти перевірку. Надійний спосіб – унікальний індекс у базі даних, який відхиляє другу вставку. Але унікальному індексу потрібен один стовпець, значення якого однакове для пари (Аліса, Боб) і пари (Боб, Аліса).DirectKey– саме такий стовпець: обидва ідентифікатори в відсортованому порядку, тож порядок користувачів не має значення. Групи й канали лишають йогоnull.LastActivityAt– час найновішого повідомлення або час створення. Список чатів упорядковано за ним, найновіші зверху; зберігання його в чаті (і оновлення разом із кожним новим повідомленням) робить таке впорядкування одним простим скануванням індексу замість пошуку найновішого повідомлення в кожному чаті.
Чат ніколи не видаляється насправді: DeletedAt позначає його видаленим (м’яке видалення, soft delete), і кожен запит такі чати пропускає. Історія лишається узгодженою для інших посилань, а випадкове видалення можна розслідувати.
Що зробити.
cs
namespace Chatex.Data.Entities;
/// <summary>A conversation: a direct chat, a group or a channel (see <see cref="ChatType"/>).</summary>
public class Chat : IHasCreatedAt, IHasUpdatedAt
{
public Guid Id { get; set; } = Guid.CreateVersion7();
public ChatType Type { get; set; }
/// <summary>Null for direct chats; clients show the other member's name instead.</summary>
public string? Title { get; set; }
public string? Description { get; set; }
public string? AvatarPath { get; set; }
/// <summary>Unique lower-case public @handle that makes a group or channel findable. Null means private.</summary>
public string? PublicHandle { get; set; }
/// <summary>Set only for direct chats, see <see cref="MakeDirectKey"/>. Unique, so a pair of users has one direct chat.</summary>
public string? DirectKey { get; set; }
public Guid CreatedById { get; set; }
public DateTimeOffset CreatedAt { get; set; }
public DateTimeOffset UpdatedAt { get; set; }
/// <summary>Time of the newest message, or creation time. Orders the user's chat list.</summary>
public DateTimeOffset LastActivityAt { get; set; }
public DateTimeOffset? DeletedAt { get; set; }
public User CreatedBy { get; set; } = null!;
public ICollection<ChatMember> Members { get; set; } = [];
public ICollection<Message> Messages { get; set; } = [];
public static string MakeDirectKey(Guid userA, Guid userB) =>
userA.CompareTo(userB) <= 0 ? $"{userA:N}:{userB:N}" : $"{userB:N}:{userA:N}";
}MakeDirectKey – static: йому не потрібен об’єкт чату, лише два ідентифікатори, а сервіси викликають його ще до існування чату («чи є вже особистий чат із цим ключем?»). Специфікатор формату N записує Guid як 32 шістнадцяткові цифри без дефісів, а тернарний оператор ставить менший ідентифікатор першим.
Крок 3. Учасник
Навіщо. ChatMember – зв’язок «багато до багатьох» між користувачами й чатами, збагачений даними:
- Ключ – пара
(ChatId, UserId), тобто складений ключ. Користувач може бути в чаті лише один раз, і база даних забезпечує це без додаткового унікального індексу. (Сам ключ налаштовується в темі 4.) Role– що учасник може робити (табл. 3.1).LastReadMessageId– найновіше повідомлення, яке учасник прочитав. Оскільки ідентифікатори повідомлень – UUIDv7 і сортуються за часом, кожне повідомлення з більшим ідентифікатором непрочитане. Один стовпець замінює таблицю рядків «повідомлення X прочитав користувач Y», яка росла б з кожним повідомленням, помноженим на кожного учасника. Позиція рухається лише вперед: відкриття старішої частини історії не повинно знову позначати новіші повідомлення непрочитаними.IsMuted– учасник не хоче сповіщень із цього чату.
Що зробити.
cs
namespace Chatex.Data.Entities;
/// <summary>Membership of a user in a chat, with role and read position.</summary>
public class ChatMember : IHasCreatedAt
{
public Guid ChatId { get; set; }
public Guid UserId { get; set; }
public ChatMemberRole Role { get; set; }
public DateTimeOffset JoinedAt { get; set; }
/// <summary>Newest message the user has read. Only moves forward; unread = messages with a greater id.</summary>
public Guid? LastReadMessageId { get; set; }
public bool IsMuted { get; set; }
public Chat Chat { get; set; } = null!;
public User User { get; set; } = null!;
DateTimeOffset IHasCreatedAt.CreatedAt
{
get => JoinedAt;
set => JoinedAt = value;
}
public bool CanPost(ChatType chatType) =>
chatType != ChatType.Channel || Role is ChatMemberRole.Owner or ChatMemberRole.Admin;
}Тут два фрагменти C# заслуговують на увагу.
Явна реалізація інтерфейсу. Перехоплювач із теми 4 заповнює CreatedAt кожної сутності IHasCreatedAt. Для учасника час створення краще називати JoinedAt. Замість другої властивості ChatMember реалізує IHasCreatedAt.CreatedAt явно: властивість видима лише через інтерфейс, а її getter і setter переспрямовують на JoinedAt. Код, що працює з ChatMember, бачить лише JoinedAt; перехоплювач, який працює з IHasCreatedAt, задає те саме значення.
Зіставлення зі зразком у CanPost. Правило читається так: у будь-якому чаті, що не є каналом, писати може кожен учасник; у каналі – лише власник та адміністратори. Role is ChatMemberRole.Owner or ChatMemberRole.Admin – це шаблон (pattern) із комбінатором or (C# 9): коротший і зрозуміліший, ніж Role == ChatMemberRole.Owner || Role == ChatMemberRole.Admin.
Перевірка
Зберіть проєкт даних:
powershell
dotnet build Source/Chatex.DataЗбирання все ще падає, але тепер лише тому, що бракує Message (його використовує Chat.Messages). Це тема наступного розділу.