imported>Kkarpea: Migrated current public revision from wiki.cs.hse.ru

2023-12-03T23:42:35Z

Migrated current public revision from wiki.cs.hse.ru

Новая страница

== О курсе ==

Это страница курса "Дизайн систем" 2023-2024 года (1-2 модуль 4 курса ПМИ).

Занятия проходят по четвергам в 18:10 - 21:00 онлайн, объявления о любых изменениях будут в Telegram-канале.

Преподаватели: [https://t.me/schetinnikov Стас Щетинников], [https://t.me/artemasmith Артем Кузнецов], [https://t.me/izhigalko Илья Жигалко], [https://t.me/ekarp Егор Карпов]

== Полезные ссылки ==

'''Ведомость:''' [https://docs.google.com/spreadsheets/d/1H-_6stGdmCN96wvdsjuY_qcv7LiUlzY_ZSDZ8AvR3AU https://docs.google.com/spreadsheets/d/1H-_6stGdmCN96wvdsjuY_qcv7LiUlzY_ZSDZ8AvR3AU]

'''Канал курса:''' [https://t.me/+ZikB0F8elb1kOTE6 https://t.me/+ZikB0F8elb1kOTE6]

'''Чат курса:''' [https://t.me/+0azNletbfBQ1NDRi https://t.me/+0azNletbfBQ1NDRi]

'''Все записи:''' [https://disk.yandex.ru/d/jMjWZTmQP_-GoQ https://disk.yandex.ru/d/jMjWZTmQP_-GoQ]

== Лекции и семинары ==

* '''07.09. Основы системного проектирования.''' [[https://disk.yandex.ru/i/w6vFjLcuKxVkhQ Презентация] | [https://disk.yandex.ru/d/jMjWZTmQP_-GoQ/%D0%9B%D0%B5%D0%BA%D1%86%D0%B8%D1%8F%2B%D0%A1%D0%B5%D0%BC%D0%B8%D0%BD%D0%B0%D1%80%2020230907-162454.mp4 Запись]] Архитектура. Жизненный цикл архитектуры. Архитектурные драйверы и архитектурно значимые требования (ASR). Проектирование и оценка архитектуры. Waterfall.
* '''14.09. Docker''' [[https://disk.yandex.ru/i/3oLiSxU1HsZEEQ Презентация] | [https://disk.yandex.ru/d/jMjWZTmQP_-GoQ/%D0%9B%D0%B5%D0%BA%D1%86%D0%B8%D1%8F%2B%D0%A1%D0%B5%D0%BC%D0%B8%D0%BD%D0%B0%D1%80%202023-09-14T15-28-07Z.mp4 Запись]] Архитектурные паттерны. CI/CD. VM vs Containers. Конфигурирование приложения. Паттерны деплоя. Service discovery. Health check. Docker.
* '''21.09 Функциональная декомпозиция''' [[https://disk.yandex.ru/i/7KQtzYMsFEtAQA Презентация] | [https://disk.yandex.ru/d/jMjWZTmQP_-GoQ/%D0%9B%D0%B5%D0%BA%D1%86%D0%B8%D1%8F%2B%D0%A1%D0%B5%D0%BC%D0%B8%D0%BD%D0%B0%D1%80%202023-09-21T14-59-52Z.mp4 Запись]] Модифицируемость и ее оценка. Louse coupling & high cohesion. Строительные блоки. DDD. Модель предметной области.
* '''29.09 Взаимодействие сервисов''' [[https://disk.yandex.ru/i/SSqbt71muPBRLg Презентация] | [https://disk.yandex.ru/d/jMjWZTmQP_-GoQ/%D0%9B%D0%B5%D0%BA%D1%86%D0%B8%D1%8F%20GMT20230929-163154.mp4 Лекция] [https://disk.yandex.ru/d/jMjWZTmQP_-GoQ/%D0%A1%D0%B5%D0%BC%D0%B8%D0%BD%D0%B0%D1%80%20GMT20230930-063014.mp4 Семинар]] Синхронное и асинхронное API. Паттерны. Оркестрация и хореография. Версионирование. IDL и API first дизайн. Rich vs Data Centric API. REST. gRPC.
* '''05.10 Событийная модель и кафка''' [[https://disk.yandex.ru/i/aU_5L9KXDH4c0w Презентация] | [https://disk.yandex.ru/d/jMjWZTmQP_-GoQ/%D0%9B%D0%B5%D0%BA%D1%86%D0%B8%D1%8F%2B%D0%A1%D0%B5%D0%BC%D0%B8%D0%BD%D0%B0%D1%80%202023-10-05T15-40-24Z.mp4 Запись]] События. Паттерны проектирования событий. Event sourcing. Stream processing. RabbitMQ. Kafka.
* '''12.10 Хранилища, модели хранения данных''' [[https://disk.yandex.ru/i/BNFq0Wc2oS0Xqw Презентация] | [https://disk.yandex.ru/d/jMjWZTmQP_-GoQ/%D0%9B%D0%B5%D0%BA%D1%86%D0%B8%D1%8F%2B%D0%A1%D0%B5%D0%BC%D0%B8%D0%BD%D0%B0%D1%80%202023-10-12T15-30-24Z.mp4 Запись]]
* '''19.10 Надежность и отказоустойчивость''' [[https://disk.yandex.ru/i/Ols3m0BWcatqgw Презентация] | [https://disk.yandex.ru/d/jMjWZTmQP_-GoQ/%D0%9B%D0%B5%D0%BA%D1%86%D0%B8%D1%8F%2B%D0%A1%D0%B5%D0%BC%D0%B8%D0%BD%D0%B0%D1%80%202023-10-19T15-11-43Z.mp4 Запись]] Терминология. Нагрузочное тестирование. Rate limiting и throttling. Retry, circuit breaker, load shedding. Надежность пишущей нагрузки. Надежность асинхронного взаимодействия.
* '''02.11 Безопасность''' [[https://disk.yandex.ru/i/CPd1y53fmCipZw Презентация] | [https://disk.yandex.ru/d/jMjWZTmQP_-GoQ/%D0%9B%D0%B5%D0%BA%D1%86%D0%B8%D1%8F%2B%D0%A1%D0%B5%D0%BC%D0%B8%D0%BD%D0%B0%D1%80%202023-11-02T15-09-25Z.mp4 Запись]]
* '''09.11 Наблюдаемость и надежность''' [[https://disk.yandex.ru/d/jMjWZTmQP_-GoQ/%D0%9B%D0%B5%D0%BA%D1%86%D0%B8%D1%8F%2B%D0%A1%D0%B5%D0%BC%D0%B8%D0%BD%D0%B0%D1%80%202023-11-09T15-09-16Z.mp4 Запись]] Kubernetes. Мониторинг. Алертинг. Service mesh.
* '''16.11 Аналитика''' ETL. MapReduce. Data Warehouse (DWH).
* '''23.11 Фронтенд. Мобильные архитектуры''' [[https://disk.yandex.ru/d/jMjWZTmQP_-GoQ/%D0%9B%D0%B5%D0%BA%D1%86%D0%B8%D1%8F%2B%D0%A1%D0%B5%D0%BC%D0%B8%D0%BD%D0%B0%D1%80%202023-11-23T16-10-00Z.mp4 Запись]] Архитектура UI. Мобильная платформа. Кросс платформенные приложения. MVC, MVVM, MVI. Тестирование. Дистрибуция. Server Side Rendering. Микрофронтенды.
* '''30.11 Масштабирование, Балансировка, API Gateway''' [[https://disk.yandex.ru/d/jMjWZTmQP_-GoQ/%D0%9B%D0%B5%D0%BA%D1%86%D0%B8%D1%8F%2B%D0%A1%D0%B5%D0%BC%D0%B8%D0%BD%D0%B0%D1%80%202023-11-30T14-59-18Z.mp4 Запись]]

== Домашние задания ==

=== 1. Docker ===

'''Форма для сдачи:''' https://docs.google.com/forms/d/1c52c2IKsGEqNQb6NdBh07biV_rd3mHS2jcIHBdtbhgE

'''Дедлайн: 25 октября 23:59'''

''Шаг 1.'' Создать веб сервис, который доступен в сети на порту 8000 и имеет один http-метод:

<code>
GET /health/

RESPONSE: {"status": "OK"}
</code>

Можно использовать любой язык программирования и любые фреймворки. Проще всего будет начать с Python и FastAPI, пример его использования был на семинаре по Docker.

''Шаг 2.'' Cобрать локально образ приложения в докер контейнер под архитектуру AMD64.

''Шаг 3. (8 баллов)'' Сохранить код сервиса и Dockerfile в '''приватный''' репозиторий на github и добавить в коллабораторы karpp.

''Шаг 4. (2 балла)'' Запушить образ в dockerhub. ([https://docs.docker.com/get-started/04_sharing_app/ Документация])

'''Примечания'''

Обратите внимание, что при сборке на M1 при запуске вашего контейнера на стандартных платформах будет ошибка такого вида: <code>standard_init_linux.go:228: exec user process caused: exec format error</code>. Чтобы избежать этого для сборки нужно указать тип платформы linux/amd64: <code>docker build --platform linux/amd64 -t tag</code>. Более подробно можно прочитать в статье: https://programmerah.com/how-to-solve-docker-run-error-standard_init_linux-go219-exec-user-process-caused-exec-format-error-39221/.

=== 2. CRUD ===

'''Форма для сдачи:''' https://docs.google.com/forms/d/1YGDpg-odldRJiqW6ZqBb5znJsAfHt2l-3TlQsINajaA

'''Дедлайн: 8 ноября 23:59'''

'''Задание''': Сделать RESTful CRUD по созданию, удалению, просмотру и обновлению пользователей. Данные должны сохраняться в базе данных, которую вы можете выбрать на ваше усмотрение и запускать в docker-compose локально. Сервис должен предоставлять [http://18.193.188.156:8000/docs API аналогичное данному] (такие же методы и такая же структура пользователя).

На данный момент не требуется делать какую-либо аутентификацию, это будет в следующем дз.

В форму нужно сдать ссылку на репозиторий, содержащий код, Dockerfile и docker-compose.yml для запуска сервиса и базы данных.

=== 3. Взаимодействие сервисов ===

'''Форма для сдачи''': [https://docs.google.com/forms/d/1h6qrFM5RuME33CLgh04-XPCGReUcbSqOZkJu5A8uOWU https://docs.google.com/forms/d/1h6qrFM5RuME33CLgh04-XPCGReUcbSqOZkJu5A8uOWU]

'''Дедлайн: 3 декабря 23:59'''

'''Задание''': Разработать API для интернет-магазина. За основу взять нужно взять ДЗ-2, доработать сервис авторизации и сделать новые сервисы заказа и биллинга.

* Сервис авторизации должен проверять логин и пароль пользователя и выдавать ему токен для обращения к другим сервисам. Во всех дальнейших запросах токен должен передаваться в хедере 'Authorization: Bearer <token>'. Сервис должен удовлетворять базовым требованиям безопасности.

* В сервисе биллинга должна быть возможность положить деньги на аккаунт пользователя, проверить баланс и снять деньги.

* Сервис заказа должен позволять создать заказ, посмотреть предыдущие заказы. При заказе нужно снимать с пользователя деньги, при недостаточном балансе возвращать ошибку и сохранять неуспешный заказ.

Несмотря на то, что все это называется сервисами, вы можете сами выбирать, использовать микросервисную или монолитную архитектуру, одну БД или несколько и тд.

'''Оценивание'''

Оценивание состоит из двух частей
* Теоретическая часть (5 баллов) – спроектировать взаимодействие сервисов, отобразить схему картинкой и описанием API.
* Практическая часть (5 баллов) – реализовать спроектированный сервис.

Также нужно приложить bash/python скрипт, тестирующий ваш сервис по следующему сценарию:
# Создать пользователя
# Положить деньги на счет пользователя
# Сделать заказ, на который хватает денег
# Убедиться, что деньги сняли
# Сделать заказ, на который не хватает денег
# Проверить, что заказ сохранился как неуспешный
# Проверить, что баланс не изменился

'''Примечания'''

Как и прошлое домашнее задание, это нужно сдать в виде github репозитория, картинки и описания нужно добавить туда же. Это может быть тот же репозиторий с отдельной веткой под ДЗ-3. Все приложение должно запускаться через docker-compose.

=== 4. Распределенные транзакции ===

'''Дедлайн: 12 декабря 23:59'''

'''Задание''': Для интернет-магазина из ДЗ-3 доработать сервисы "Склад", "Доставка". При создании заказа необходимо:
* в сервисе "Склад" зарезервировать конкретный товар на складе
* в сервисе "Доставка" зарезервировать курьера на конкретный слот времени.
* если хотя бы один из пунктов не получилось сделать, необходимо откатить все остальные изменения.

В задании необходимо реализовать [https://neerc.ifmo.ru/wiki/index.php?title=%D0%A2%D1%80%D0%B0%D0%BD%D0%B7%D0%B0%D0%BA%D1%86%D0%B8%D0%B8_%D0%B2_%D1%80%D0%B0%D1%81%D0%BF%D1%80%D0%B5%D0%B4%D0%B5%D0%BB%D1%91%D0%BD%D0%BD%D1%8B%D1%85_%D1%81%D0%B8%D1%81%D1%82%D0%B5%D0%BC%D0%B0%D1%85 механизм распределенных транзакций]. Рекомендуется использовать [https://neerc.ifmo.ru/wiki/index.php?title=2_Phase_Commit алгоритм двухфазного коммита] или паттерн "Сага" ([https://habr.com/ru/articles/427705/ rus], [https://microservices.io/patterns/data/saga.html eng])

'''Оценивание'''

Оценивание состоит из двух частей
* Теоретическая часть (5 баллов) – отобразить [https://en.wikipedia.org/wiki/Sequence_diagram sequence-диаграмой] схему взаимодействия сервисов при создании заказа, коротко описать текстом, какой паттерн использовался и почему на ваш взгляд он больше всего подходит
* Практическая часть (5 баллов) – реализовать спроектированный сервис.

ДЗ сдается полностью аналогично предыдущим. Для тестирования нужно добавить такой же скрипт, как и в ДЗ-3, с проверкой статусов в новых сервисах.

=== 5. Архитектурные ката ===

'''Дедлайн: 19 декабря 23:59'''

'''Задание''': Возьмите любой кейс из [https://www.architecturalkatas.com/ архитектурных ката] и спроектируйте его решение.

В решении необходимо предоставить:
* Пользовательские сценарии
* Общую схему взаимодействия сервисов.
** Для каждого сервиса опишите назначение сервиса и его зону ответственности.
** Опишите контракты взаимодействия сервисов друг с другом.
* Диаграмму контейнеров приложения на основе выбранной модели функциональной декомпозиции
* Декомпозицию слоя данных: какие данные в каких БД хранятся

Решение можно опубликовать в dropbox/яндекс диске/google диске/github/etc.

== Итоговая оценка за курс ==

Итог = min(Округл(0.2 * ДЗ1 + 0.3 * ДЗ2 + 0.5 * ДЗ3 + 0.6 * ДЗ4 + 0.3 * ДЗ5 + 0.3 * Э), 10)

ДЗ –– оценки за домашние задания

Э –– устный экзамен

Округление арифметическое.

Дизайн систем 23/24 - История изменений

imported>Kkarpea: Migrated current public revision from wiki.cs.hse.ru