Українська
Повідомлення й вкладення
Крок 1. Повідомлення
Навіщо. Повідомлення – найчисленніша сутність: в активному чаті їх сотні тисяч. Її проєкт випливає з того, як повідомлення читають і змінюють:
- Ідентифікатор – це курсор. Історію завантажують посторінково: «50 повідомлень перед цим». Оскільки ідентифікатор – UUIDv7, «перед» – це просто «з меншим ідентифікатором», і той самий ідентифікатор є позицією читання
ChatMember.LastReadMessageId. - Відповіді вказують на інше повідомлення того самого чату через
ReplyToMessageId– зовнішній ключ, що допускає null, від таблиці повідомлень до неї самої; це зв’язок на себе (self-referencing). - Редагування зберігає те саме повідомлення й записує
EditedAt, тож клієнти можуть показати «відредаговано». - Видалення м’яке. Рядок лишається й отримує
DeletedAt; сервіс очищає текст і прибирає вкладення (тема 11). Якби рядок зник, відповіді на нього вказували б у нікуди, а позиція читання, що дорівнює його ідентифікаторові, була б втрачена. Клієнти показують «повідомлення видалено».
Що зробити.
cs
namespace Chatex.Data.Entities;
/// <summary>
/// A chat message. <see cref="Id"/> is a UUIDv7, so it sorts by creation time and doubles as the pagination cursor.
/// </summary>
public class Message : IHasCreatedAt
{
public Guid Id { get; set; } = Guid.CreateVersion7();
public Guid ChatId { get; set; }
public Guid SenderId { get; set; }
public required string Body { get; set; }
public Guid? ReplyToMessageId { get; set; }
public DateTimeOffset CreatedAt { get; set; }
public DateTimeOffset? EditedAt { get; set; }
/// <summary>Soft delete: the row stays so replies and read positions keep pointing at it.</summary>
public DateTimeOffset? DeletedAt { get; set; }
public Chat Chat { get; set; } = null!;
public User Sender { get; set; } = null!;
public Message? ReplyTo { get; set; }
public ICollection<Attachment> Attachments { get; set; } = [];
}Body – required, бо повідомлення без тексту створити не можна; порожній текст після видалення – усе ще рядок, а не null. Клас реалізує лише IHasCreatedAt: час редагування задає сервіс, бо «відредагованим» вважається лише зміна тексту, а не кожна зміна рядка.
Крок 2. Вкладення
Навіщо. Як файл потрапляє в повідомлення? Очевидний спосіб – надіслати текст і файл в одному запиті – робить запит повільним і крихким: завантаження 20 МБ, що обривається на 90 %, втрачає й текст, а користувач не бачить ходу завантаження кожного файлу. Chatex використовує підхід «спершу завантажити, потім прив’язати», поширений у месенджерах:
- Клієнт завантажує файл окремо (
POST /api/attachments), щойно користувач його вибрав. Сервер зберігає його й створюєAttachmentзMessageId = null– завантаженням, що ще не належить жодному повідомленню. - Коли користувач натискає «Надіслати», запит повідомлення несе лише ідентифікатори завантажень. Сервіс перевіряє, що вони належать відправникові й ще не використані, і задає їхній
MessageId. - Завантаження, яке так і не надіслали (користувач закрив вкладку), лишається без повідомлення; щогодинне очищення видаляє такі завантаження через 24 години (тема 13).
Ще два рішення захищають сервер:
StoragePathгенерує сервер (2026/10/{guid}), його ніколи не беруть від користувача. Ім’я файлу на кшталт../../etc/passwdніколи не повинно ставати шляхом на диску (обхід шляху, path traversal).FileNameзберігає початкове ім’я, але лише щоб його показувати й пропонувати під час завантаження файлу.
Що зробити.
cs
namespace Chatex.Data.Entities;
/// <summary>
/// A file stored on disk. Uploaded first (with <see cref="MessageId"/> null), then linked to a message when it is sent.
/// </summary>
public class Attachment : IHasCreatedAt
{
public Guid Id { get; set; } = Guid.CreateVersion7();
public Guid? MessageId { get; set; }
public Guid UploaderId { get; set; }
/// <summary>Original client file name, for display only. Never used as a path.</summary>
public required string FileName { get; set; }
public required string ContentType { get; set; }
public long SizeBytes { get; set; }
/// <summary>Path relative to the uploads root, e.g. <c>2026/10/{guid}</c>.</summary>
public required string StoragePath { get; set; }
public DateTimeOffset CreatedAt { get; set; }
public Message? Message { get; set; }
public User Uploader { get; set; } = null!;
}Тут Message? допускає null – на відміну від Chat = null! у Message, – бо вкладення справді може існувати без повідомлення.
Таблиці, до яких ми прагнемо
Модель завершено. У темі 4 EF Core перетворює її на таблиці. Рис. 3.3 показує ключові стовпці трьох таблиць чату такими, якими вони з’являться в PostgreSQL: назви у snake_case, переліки як рядки, складений ключ chat_members.
Рис. 3.3. Ключові стовпці таблиць чату
Перевірка
Проєкт даних тепер збирається:
powershell
dotnet buildВивід закінчується Build succeeded, 0 Warning(s), 0 Error(s), а Source/Chatex.Data/Entities містить десять файлів: Attachment.cs, Chat.cs, ChatMember.cs, ChatMemberRole.cs, ChatType.cs, Message.cs, RefreshToken.cs, Timestamps.cs, User.cs, UserProfile.cs.
Крок 3. Випробування моделі
Навіщо. Збирання доводить, що код компілюється, а не що правила правильні. Справжні тести з’являться в темі 6, коли буде тестова інфраструктура. А поки кілька рядків коду можуть показати сутності в дії. .NET 10 уміє запускати один файл .cs без проєкту (file-based app, застосунок на основі файлу), і такий файл може посилатися на проєкт директивою #:project.
Що зробити. Створіть папку поза вашим репозиторієм, наприклад D:\Work\Playground («пісочницю»), щоб експеримент не потрапив у коміт і не підпадав під суворі налаштування збирання репозиторію. Створіть у ній entities.cs; змініть шлях у першому рядку, якщо ваш репозиторій не в D:\Work\Chatex:
cs
#:project D:\Work\Chatex\Source\Chatex.Data\Chatex.Data.csproj
using Chatex.Data.Entities;
var alice = new User { UserName = "alice" };
var bob = new User { UserName = "bob" };
Console.WriteLine($"Alice: {alice.Id}");
Console.WriteLine($"Bob: {bob.Id}");
Console.WriteLine(Chat.MakeDirectKey(alice.Id, bob.Id));
Console.WriteLine(Chat.MakeDirectKey(bob.Id, alice.Id));
var subscriber = new ChatMember { Role = ChatMemberRole.Subscriber };
Console.WriteLine($"Subscriber posts in a channel: {subscriber.CanPost(ChatType.Channel)}");
Console.WriteLine($"Subscriber posts in a group: {subscriber.CanPost(ChatType.Group)}");
var token = new RefreshToken { TokenHash = "x", ExpiresAt = DateTimeOffset.UtcNow.AddDays(30) };
Console.WriteLine($"Active now: {token.IsActiveAt(DateTimeOffset.UtcNow)}");
Console.WriteLine($"Active in 31 days: {token.IsActiveAt(DateTimeOffset.UtcNow.AddDays(31))}");Запустіть його з цієї папки:
powershell
dotnet run entities.csПеревірка
Вивід виглядає так (ваші ідентифікатори відрізнятимуться):
Alice: 01a1e0ce-526e-742b-8216-1fab814b067a
Bob: 01a1e0ce-526e-70b6-8fa8-8593af081b86
01a1e0ce526e70b68fa88593af081b86:01a1e0ce526e742b82161fab814b067a
01a1e0ce526e70b68fa88593af081b86:01a1e0ce526e742b82161fab814b067a
Subscriber posts in a channel: False
Subscriber posts in a group: True
Active now: True
Active in 31 days: False- Обидва ідентифікатори починаються з однакових цифр – це часова частина, бо двох користувачів створено в одну мілісекунду. Тут ідентифікатор Боба випадково менший за ідентифікатор Аліси, хоча його створено пізніше: у межах однієї мілісекунди порядок випадковий.
- Обидва прямі ключі рівні, хто б не був першим.
- Підписник може писати в групі, але не в каналі; токен зараз активний і прострочений через 31 день.
Спробуйте самостійно кілька змін: створіть ChatMember з роллю Admin і викличте CanPost(ChatType.Channel); задайте RevokedAt токена й знову перевірте IsActiveAt; спробуйте створити new Message() без Body і прочитайте помилку компілятора.