Українська
Chatex – вебмесенджер реального часу
Chatex – відкритий вебмесенджер із прямими чатами, групами й каналами, який працює на chatex.mvano.com. Цей курс будує його крок за кроком, від порожньої папки до розгорнутого сервера. Попутно видно, як технології, що вивчаються окремо, складаються в один справжній застосунок: ООП мовами C# і TypeScript, вебAPI, бази даних, обмін повідомленнями в реальному часі, автоматизоване тестування, CI/CD і адміністрування віртуального сервера Ubuntu.
Курс є демонстраційним проєктом до дисципліни «Об’єктно-орієнтоване програмування C# (GUI)». Лабораторних робіт у ньому немає: кожна тема – це один етап побудови, а весь курс подано ще й в одній презентації.
Як працювати з цим посібником
Застосунок будується рівень за рівнем, у порядку залежностей між рівнями: спочатку модель бази даних, потім бізнес-логіка над нею, далі HTTP API і SignalR, потім клієнт на Angular, що їх викликає, і насамкінець автоматичні перевірки та сервер. Кожен рівень завершують і тестують, перш ніж почати наступний, тож у кожній контрольній точці ви маєте код, який збирається й працює.
- Тема – це один етап побудови. Її перша сторінка каже, де цей етап міститься в архітектурі, що вже має працювати і що працюватиме наприкінці.
- Розділ – це група кроків. Кожен крок має однакову будову: Навіщо (проблема й проєктне рішення), Що зробити (файли, які треба створити, і команди, які треба виконати) та Перевірка (як переконатися, що крок спрацював).
- Контрольна точка наприкінці кожної теми містить команди, що мають проходити, повідомлення коміту, типові помилки, питання для самоперевірки та вправи, які виходять за межі еталонного коду.
- Еталонний код – це репозиторій Chatex на коміті
27c83c6. Кожен лістинг називає свій файл і взятий із цього коміту; усі посилання на код ведуть на нього, тож сторінки й код ніколи не розходяться. Коли щось не виходить, порівняйте свій файл з еталонним. - Друкуйте код самі, а не копіюйте файли цілком: найбільше користі дає той момент, коли компілятор або тест показує, що ви пропустили.
Програма курсу
Початок роботи
- Огляд Chatex: можливості, архітектура, стек технологій і план посібника
- Інструменти та каркас рішення: .NET SDK, спільні налаштування збирання, централізоване керування пакетами, PostgreSQL у Docker і команди розробника
Рівень даних (Chatex.Data)
- Модель предметної області: сутності користувачів, чатів, учасників, повідомлень і вкладень
- Entity Framework Core і PostgreSQL: контекст бази даних, конфігурації, перехоплювачі та міграції
- Репозиторії та Unit of Work: транзакції, посторінкове читання за ключем, запити списку чатів і сховище файлів
- Тестування рівня даних: xUnit v3, Testcontainers, Respawn і Shouldly
Бізнес-рівень (Chatex.Core)
- Основи бізнес-рівня: патерн Result, помилки, перевірка даних, параметри й впровадження залежностей
- Логіка автентифікації: ASP.NET Core Identity, токени доступу JWT і токени оновлення з ротацією
- Профілі й аватари: сервіс профілів, зміна пароля, пошук користувачів і безпечні завантаження
- Чати та дозволи: прямі чати, групи, канали, ролі, членство й події реального часу
- Повідомлення й вкладення: завантаження, надсилання, відповіді, редагування, видалення та сторінки історії
Вебрівень API (Chatex.Api)
- HTTP API на Minimal API: групи кінцевих точок, Problem Details, автентифікація JWT, корінь композиції та OpenAPI
- Захист і експлуатація API: кінцеві точки файлів, обмеження запитів, обмеження частоти, пересилання заголовків, перевірки стану та обслуговування
- Реальний час з ASP.NET Core SignalR: типізований хаб, групи, присутність і індикатори набору тексту
Клієнт на Angular (Chatex.Web)
- Проєкт Angular: автономні компоненти, виявлення змін без zone.js, Tailwind CSS і проксі сервера розробки
- Клієнт API та автентифікація: типізовані моделі, HTTP-сервіси, сесія на сигналах, перехоплювач і охоронці маршрутів
- Маршрутизація, форми й компонування: маршрути з відкладеним завантаженням, форми входу й реєстрації, адаптивна оболонка
- Список чатів: сховище на сигналах, аватари, нові чати й пошук публічних чатів
- Розмова: сховище повідомлень з оптимістичним надсиланням, посторінкове читання історії, поле введення та вкладення
- Клієнт реального часу: з’єднання SignalR, типізовані події, донавантаження після перепідключень, присутність і набір тексту
- Відомості про чат і налаштування: учасники й ролі, профіль, аватар, пароль і тема
Якість та експлуатація
- Безперервна інтеграція з GitHub Actions
- Віртуальний сервер Ubuntu: брандмауер, PostgreSQL, systemd, Nginx і HTTPS
- Безперервне розгортання: пакети релізів, міграції бази даних, активація з відкатом
Перш ніж почати
Ви маєте впевнено орієнтуватися в класах, інтерфейсах, узагальненнях, LINQ та async/await мови C#. Курс «Об’єктно-орієнтоване програмування C# (GUI)» дає підґрунтя, на яке спирається цей посібник: Git, async/await, впровадження залежностей, EF Core, REST API і SignalR. TypeScript і Angular пояснюються в міру появи, але базові знання HTML, CSS і JavaScript стануть у пригоді.
Програмне забезпечення
| Програма | Для чого |
|---|---|
| .NET 10 SDK, Visual Studio 2026 або JetBrains Rider | Серверна частина на C# 14 |
| Node.js 24 і Visual Studio Code | Клієнт на Angular 22 |
| Docker Desktop | PostgreSQL 18 для розробки й тестів |
| PowerShell 7 | Команди розробника Run.ps1 |
| Git і обліковий запис GitHub | Керування версіями, CI/CD |
| Віртуальний сервер Ubuntu 26.04 і домен | Розгортання (теми 23–24) |
Тема 2 показує, як установити й перевірити кожну з них.
Матеріали курсу
- Презентація курсу (англійською) – 65 слайдів із нотатками доповідача (режим доповідача
/presenter) - Вихідний код Chatex – репозиторій GitHub із документацією в папці
Docs; посібник відповідає коміту27c83c6 - chatex.mvano.com – працюючий застосунок