Українська
Архітектура
Система загалом
У робочому середовищі Chatex працює на одному сервері Ubuntu (рис. 1.3). Браузер спілкується лише з Nginx – вебсервером, що завершує HTTPS. Nginx віддає файли застосунку Angular (index.html, JavaScript, CSS) і пересилає два види запитів до застосунку ASP.NET Core Chatex.Api, який слухає лише локальну адресу 127.0.0.1:5000:
/api/...– звичайні HTTP-запити: вхід, завантаження списку чатів, надсилання повідомлення, завантаження файлу;/hubs/chat– одне довготривале з’єднання WebSocket на кожну вкладку браузера, яким сервер передає події (нове повідомлення, хтось набирає текст) у ту саму мить, коли вони відбуваються.
Chatex.Api зберігає дані в PostgreSQL, а завантажені файли – у папці на диску.
Рис. 1.3. Архітектура системи
Під час розробки картина та сама, лише без Nginx: сервер розробки Angular на порту 4200 пересилає /api і /hubs до API на порту 5214 (тема 15), а PostgreSQL працює в контейнері Docker (тема 2).
Три рівні серверної частини
Серверну частину поділено на три проєкти – рівні, – і кожен рівень посилається лише на рівень під собою (рис. 1.4).
Рис. 1.4. Рівні Chatex
Чому б не покласти все в один проєкт? Тому що кожен рівень має одну причину для змін і його можна зрозуміти, замінити й протестувати окремо:
- Chatex.Data знає, як зберігаються дані: таблиці, індекси, SQL-запити через EF Core. Він нічого не знає про HTTP і про те, кому що дозволено.
- Chatex.Core знає правила месенджера: підписник каналу не може писати, повідомлення, яке редагують, має належати відправникові, токен оновлення можна використати один раз. Він працює з інтерфейсами репозиторіїв і ніколи не торкається контексту бази даних напряму, а про HTTP не знає нічого.
- Chatex.Api знає веб: маршрути, коди стану, токени в заголовках і cookie, з’єднання WebSocket. Кожна кінцева точка – кілька рядків, що читають запит, викликають один метод сервісу й перетворюють результат на HTTP-відповідь.
Напрямок посилань ускладнює порушення правил: компілятор просто не дозволить Chatex.Data викликати сервіс, а Chatex.Core – повернути код стану HTTP.
Інверсія залежностей
Іноді нижчий рівень має запустити щось у вищому: після збереження повідомлення Chatex.Core має сповістити підключені браузери, а це робота SignalR у Chatex.Api. Chatex.Core не може посилатися на Chatex.Api, тому він оголошує інтерфейс IChatNotifier, а Chatex.Api його реалізує. Абстракцією володіє нижчий рівень, реалізацію через впровадження залежностей постачає вищий. Це літера D у SOLID – принцип інверсії залежностей (див. Впровадження залежностей у курсі C#). Ми будуємо це в темах 7 і 14.
Шлях запиту
Простежмо один запит крізь рівні: Аліса надсилає повідомлення (рис. 1.5).
Рис. 1.5. Надсилання повідомлення крізь рівні
- Кінцева точка в Chatex.Api читає ідентифікатор користувача з токена доступу й викликає один метод сервісу.
- Сервіс у Chatex.Core перевіряє команду (текст не порожній і не задовгий).
- Він завантажує чат і членство виконавця через
ChatAccess, що застосовує правила видимості, і перевіряє дозволи: чи може цей учасник писати в цьому чаті? - Він змінює сутності через репозиторії й зберігає їх за допомогою «одиниці роботи» (Unit of Work) у Chatex.Data, у транзакції, коли кілька записів мають виконатися разом.
- Після коміту він викликає
IChatNotifier, а реалізація на SignalR передає подію кожному підключеному учасникові. - Сервіс повертає
Result: або створене повідомлення, або помилку на кшталтcannot_post. Кінцева точка перетворює його на201 Createdабо на відповідь з помилкою в стандартному форматі Problem Details.
Кожна можливість серверної частини йде цим шляхом, тож коли ви побудуєте його для однієї, решта виглядатимуть знайомо.
Технологічний стек
У табл. 1.2 перелічено основні технології та причини їх вибору. Знати їх заздалегідь не потрібно: кожну представлено в темі, де вона вперше з’являється.
Таблиця 1.2. Технологічний стек
| Напрям | Вибір | Чому |
|---|---|---|
| Середовище виконання | .NET 10, C# 14 | випуск із довготривалою підтримкою; одна мова для всіх рівнів серверної частини |
| База даних | PostgreSQL 18; EF Core 10 з Npgsql | безкоштовна надійна реляційна база даних; EF Core відображає класи C# на таблиці й генерує міграції |
| HTTP API | ASP.NET Core Minimal API, Problem Details, OpenAPI зі Scalar | мало церемоній на кінцеву точку; стандартний формат помилок; інтерактивний довідник API |
| Реальний час | ASP.NET Core SignalR | WebSocket з автоматичним запасним варіантом, групами й перепідключенням з коробки |
| Автентифікація | ASP.NET Core Identity, токени JWT bearer, refresh-cookie з HttpOnly | перевірене хешування паролів і блокування облікового запису; токени доступу без стану; токен оновлення, який JavaScript не може прочитати |
| Перевірка даних | FluentValidation | правила перевірки у вигляді малих класів, які легко тестувати |
| Тести | xUnit v3, Shouldly, Testcontainers, Respawn, WebApplicationFactory | тести працюють на справжній PostgreSQL у Docker і на справжньому конвеєрі HTTP |
| Фронтенд | Angular 22 (автономні компоненти, сигнали, без zone.js), Tailwind CSS v4, Angular CDK, @microsoft/signalr, Vitest | повноцінний фреймворк з TypeScript, маршрутизацією, формами й HTTP; стилі за принципом utility-first |
| CI/CD | GitHub Actions | перевіряє кожен пуш; будує реліз і розгортає його на сервері |
| Сервер | Ubuntu 26.04, Nginx, systemd, certbot | стандартний набір Linux: зворотний проксі, менеджер служб і безкоштовні сертифікати HTTPS |
Структура репозиторію
Готовий репозиторій виглядає так. Ви створюватимете ці папки одну за одною; наразі просто відчуйте, де що лежить.
Chatex.slnx the solution
global.json the .NET SDK version and the test runner
Directory.Build.props build settings shared by every project
Directory.Packages.props the versions of all NuGet packages
compose.yaml PostgreSQL 18 for development
Run.ps1 developer commands
Source/
Chatex.Data/ Entities, Configurations, Repositories, Migrations, Storage
Chatex.Core/ Auth, Users, Chats, Messages, Attachments, Common
Chatex.Api/ Endpoints, Hubs, Infrastructure, Maintenance, Program.cs
Chatex.Web/ the Angular app
Tests/
Chatex.Testing/ a shared PostgreSQL container for the tests
Chatex.Data.Tests/ repository and storage tests
Chatex.Core.Tests/ service tests
Chatex.Api.Tests/ HTTP and SignalR tests against the running app
Deploy/ server files: systemd unit, Nginx site, activation script
Docs/ documentation
.github/workflows/ CI and deploymentПеревірка
Відкрийте еталонний репозиторій у вашому IDE (Chatex.slnx у Visual Studio чи Rider, папку – у VS Code). Знайдіть чотири проєкти в Source/ і для кожного відкрийте один файл та скажіть, до якого рівня він належить і чому. Наприклад, Source/Chatex.Data/Entities/Message.cs описує, як зберігається повідомлення, тож він належить до рівня даних.