Пахомов Леонид Лаб. 1 Группа 6512

Client.Wasm/Components/StudentCard.razor

@@ -4,10 +4,10 @@
     </CardHeader>
     <CardBody>
         <UnorderedList Unstyled>
-            <UnorderedListItem>Номер <Strong>№X "Название лабораторной"</Strong></UnorderedListItem>
-            <UnorderedListItem>Вариант <Strong>№Х "Название варианта"</Strong></UnorderedListItem>
-            <UnorderedListItem>Выполнена <Strong>Фамилией Именем 65ХХ</Strong> </UnorderedListItem>
-            <UnorderedListItem><Link To="https://puginarug.com/">Ссылка на форк</Link></UnorderedListItem>
+            <UnorderedListItem>Номер <Strong>№1 "Кэширование"</Strong></UnorderedListItem>
+            <UnorderedListItem>Вариант <Strong>№31 "Товар на складе"</Strong></UnorderedListItem>
+            <UnorderedListItem>Выполнил <Strong>Пахомов Леонид 6512</Strong> </UnorderedListItem>
+            <UnorderedListItem><Link To="https://github.com/Sonya-From-IBAS/cloud-development">Ссылка на форк</Link></UnorderedListItem>
         </UnorderedList>
     </CardBody>
 </Card>

Client.Wasm/Properties/launchSettings.json

@@ -12,7 +12,7 @@
     "http": {
       "commandName": "Project",
       "dotnetRunMessages": true,
-      "launchBrowser": true,
+      "launchBrowser": false,
       "inspectUri": "{wsProtocol}://{url.hostname}:{url.port}/_framework/debug/ws-proxy?browser={browserInspectUri}",
       "applicationUrl": "http://localhost:5127",
       "environmentVariables": {
@@ -22,7 +22,7 @@
     "https": {
       "commandName": "Project",
       "dotnetRunMessages": true,
-      "launchBrowser": true,
+      "launchBrowser": false,
       "inspectUri": "{wsProtocol}://{url.hostname}:{url.port}/_framework/debug/ws-proxy?browser={browserInspectUri}",
       "applicationUrl": "https://localhost:7282;http://localhost:5127",
       "environmentVariables": {
@@ -31,7 +31,7 @@
     },
     "IIS Express": {
       "commandName": "IISExpress",
-      "launchBrowser": true,
+      "launchBrowser": false,
       "inspectUri": "{wsProtocol}://{url.hostname}:{url.port}/_framework/debug/ws-proxy?browser={browserInspectUri}",
       "environmentVariables": {
         "ASPNETCORE_ENVIRONMENT": "Development"

Client.Wasm/wwwroot/appsettings.json

@@ -6,5 +6,5 @@
     }
   },
   "AllowedHosts": "*",
-  "BaseAddress": ""
+  "BaseAddress": "https://localhost:7284/api/warehouse-item"
 }

CloudDevelopment.sln

@@ -5,6 +5,12 @@ VisualStudioVersion = 17.14.36811.4
 MinimumVisualStudioVersion = 10.0.40219.1
 Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "Client.Wasm", "Client.Wasm\Client.Wasm.csproj", "{AE7EEA74-2FE0-136F-D797-854FD87E022A}"
 EndProject
+Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "WarehouseApp.AppHost", "WarehouseApp\WarehouseApp.AppHost\WarehouseApp.AppHost.csproj", "{62DA23FA-2BAF-4F9A-B719-B4EE06809BA0}"
+EndProject
+Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "WarehouseApp.ServiceDefaults", "WarehouseApp\WarehouseApp.ServiceDefaults\WarehouseApp.ServiceDefaults.csproj", "{ADCEFD5A-DE46-3D8E-DD7F-B5FD83A993DF}"
+EndProject
+Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "WarehouseApp.Api", "WarehouseApp.Api\WarehouseApp.Api.csproj", "{6D2468DE-58C5-E4A1-2839-0E91AF620D88}"
+EndProject
 Global
 	GlobalSection(SolutionConfigurationPlatforms) = preSolution
 		Debug|Any CPU = Debug|Any CPU
@@ -15,6 +21,18 @@ Global
 		{AE7EEA74-2FE0-136F-D797-854FD87E022A}.Debug|Any CPU.Build.0 = Debug|Any CPU
 		{AE7EEA74-2FE0-136F-D797-854FD87E022A}.Release|Any CPU.ActiveCfg = Release|Any CPU
 		{AE7EEA74-2FE0-136F-D797-854FD87E022A}.Release|Any CPU.Build.0 = Release|Any CPU
+		{62DA23FA-2BAF-4F9A-B719-B4EE06809BA0}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{62DA23FA-2BAF-4F9A-B719-B4EE06809BA0}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{62DA23FA-2BAF-4F9A-B719-B4EE06809BA0}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{62DA23FA-2BAF-4F9A-B719-B4EE06809BA0}.Release|Any CPU.Build.0 = Release|Any CPU
+		{ADCEFD5A-DE46-3D8E-DD7F-B5FD83A993DF}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{ADCEFD5A-DE46-3D8E-DD7F-B5FD83A993DF}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{ADCEFD5A-DE46-3D8E-DD7F-B5FD83A993DF}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{ADCEFD5A-DE46-3D8E-DD7F-B5FD83A993DF}.Release|Any CPU.Build.0 = Release|Any CPU
+		{6D2468DE-58C5-E4A1-2839-0E91AF620D88}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{6D2468DE-58C5-E4A1-2839-0E91AF620D88}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{6D2468DE-58C5-E4A1-2839-0E91AF620D88}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{6D2468DE-58C5-E4A1-2839-0E91AF620D88}.Release|Any CPU.Build.0 = Release|Any CPU
 	EndGlobalSection
 	GlobalSection(SolutionProperties) = preSolution
 		HideSolutionNode = FALSE

README.md

@@ -1,128 +1,52 @@
-# Современные технологии разработки программного обеспечения
-[Таблица с успеваемостью](https://docs.google.com/spreadsheets/d/1an43o-iqlq4V_kDtkr_y7DC221hY9qdhGPrpII27sH8/edit?usp=sharing)
-
-## Задание
-### Цель
-Реализация проекта микросервисного бекенда.
-
-### Задачи
-* Реализация межсервисной коммуникации,
-* Изучение работы с брокерами сообщений,
-* Изучение архитектурных паттернов,
-* Изучение работы со средствами оркестрации на примере .NET Aspire,
-* Повторение основ работы с системами контроля версий,
-* Интеграционное тестирование.
-
-### Лабораторные работы
-<details>
-<summary>1.	«Кэширование» - Реализация сервиса генерации контрактов, кэширование его ответов</summary>
-<br> 
-
-В рамках первой лабораторной работы необходимо:
-* Реализовать сервис генерации контрактов на основе Bogus,
-* Реализовать кеширование при помощи IDistributedCache и Redis,
-* Реализовать структурное логирование сервиса генерации,
-* Настроить оркестрацию Aspire. 
-
-</details>
-<details>
-<summary>2.	«Балансировка нагрузки» - Реализация апи гейтвея, настройка его работы</summary>
-<br> 
-
-В рамках второй лабораторной работы необходимо:
-* Настроить оркестрацию на запуск нескольких реплик сервиса генерации,
-* Реализовать апи гейтвей на основе Ocelot,
-* Имплементировать алгоритм балансировки нагрузки согласно варианту.
-
-<br> 
-</details>
-<details>
-<summary>3.	«Интеграционное тестирование» - Реализация файлового сервиса и объектного хранилища, интеграционное тестирование бекенда</summary>
-<br> 
-
-В рамках третьей лабораторной работы необходимо:
-* Добавить в оркестрацию объектное хранилище,
-* Реализовать файловый сервис, сериализующий сгенерированные данные в файлы и сохраняющий их в объектном хранилище,
-* Реализовать отправку генерируемых данных в файловый сервис посредством брокера,
-* Реализовать интеграционные тесты, проверяющие корректность работы всех сервисов бекенда вместе.
-
-<br> 
-</details>
-<details>
-<summary>4.	(Опционально) «Переход на облачную инфраструктуру» - Перенос бекенда в Yandex Cloud</summary>
-<br>  
-
-В рамках четвертой лабораторной работы необходимо перенестиервисы на облако все ранее разработанные сервисы:
-* Клиент - в хостинг через отдельный бакет Object Storage,
-* Сервис генерации - в Cloud Function,
-* Апи гейтвей - в Serverless Integration как API Gateway,
-* Брокер сообщений - в Message Queue,
-* Файловый сервис - в Cloud Function,
-* Объектное хранилище - в отдельный бакет Object Storage,  
-
-<br> 
-</details>
-
-## Задание. Общая часть
-**Обязательно**:
-* Реализация серверной части на [.NET 8](https://learn.microsoft.com/ru-ru/dotnet/core/whats-new/dotnet-8/overview).
-* Оркестрация проектов при помощи [.NET Aspire](https://learn.microsoft.com/ru-ru/dotnet/aspire/get-started/aspire-overview).
-* Реализация сервиса генерации данных при помощи [Bogus](https://github.com/bchavez/Bogus).
-* Реализация тестов с использованием [xUnit](https://xunit.net/?tabs=cs).
-* Создание минимальной документации к проекту: страница на GitHub с информацией о задании, скриншоты приложения и прочая информация.
-
-**Факультативно**:
-* Перенос бекенда на облачную инфраструктуру Yandex Cloud
-
-Внимательно прочитайте [дискуссии](https://github.com/itsecd/cloud-development/discussions/1) о том, как работает автоматическое распределение на ревью.
-Сразу корректно называйте свои pr, чтобы они попали на ревью нужному преподавателю.
-
-По итогу работы в семестре должна получиться следующая информационная система:
-<details>
-<summary>C4 диаграмма</summary>
-<img width="1584" height="771" alt="Современные_технологии_разработки_ПО_drawio" src="https://github.com/user-attachments/assets/71d6356f-7eb4-463d-b9f3-c953e5312993" />
-</details>
-
-## Варианты заданий
-Номер варианта задания присваивается в начале семестра. Изменить его нельзя. Каждый вариант имеет уникальную комбинацию из предметной области, базы данных и технологии для общения сервиса генерации данных и сервера апи.
-
-[Список вариантов](https://docs.google.com/document/d/1WGmLYwffTTaAj4TgFCk5bUyW3XKbFMiBm-DHZrfFWr4/edit?usp=sharing)  
-[Список предметных областей и алгоритмов балансировки](https://docs.google.com/document/d/1PLn2lKe4swIdJDZhwBYzxqFSu0AbY2MFY1SUPkIKOM4/edit?usp=sharing)  
-
-## Схема сдачи
-
-На каждую из лабораторных работ необходимо сделать отдельный [Pull Request (PR)](https://docs.github.com/en/pull-requests).
-
-Общая схема:
-1. Сделать форк данного репозитория
-2. Выполнить задание
-3. Сделать PR в данный репозиторий
-4. Исправить замечания после code review
-5. Получить approve
-
-## Критерии оценивания
-
-Конкурентный принцип.
-Так как задания в первой лабораторной будут повторяться между студентами, то выделяются следующие показатели для оценки:
-1. Скорость разработки
-2. Качество разработки
-3. Полнота выполнения задания
-
-Быстрее делаете PR - у вас преимущество.
-Быстрее получаете Approve - у вас преимущество.
-Выполните нечто немного выходящее за рамки проекта - у вас преимущество.
-Не укладываетесь в дедлайн - получаете минимально возможный балл.
-
-### Шкала оценивания
-
-- **3 балла** за качество кода, из них:
-  - 2 балла - базовая оценка
-  - 1 балл (но не более) можно получить за выполнение любого из следующих пунктов:
-    - Реализация факультативного функционала
-    - Выполнение работы раньше других: первые 5 человек из каждой группы, которые сделали PR и получили approve, получают дополнительный балл
-
-## Вопросы и обратная связь по курсу
-
-Чтобы задать вопрос по лабораторной, воспользуйтесь [соответствующим разделом дискуссий](https://github.com/itsecd/cloud-development/discussions/categories/questions) или заведите [ишью](https://github.com/itsecd/cloud-development/issues/new).  
-Если у вас появились идеи/пожелания/прочие полезные мысли по преподаваемой дисциплине, их можно оставить [здесь](https://github.com/itsecd/cloud-development/discussions/categories/ideas).
-
+# Лабораторная работа №1 — «Кэширование»
+
+Реализация сервиса генерации данных о товарах на складе с кэшированием ответов через Redis, оркестрацией через .NET Aspire и Blazor WebAssembly клиентом.
+
+## Стек технологий
+
+| Технология | Назначение |
+|---|---|
+| .NET 8 | Серверная часть |
+| ASP.NET Core Minimal API | HTTP-сервис |
+| .NET Aspire | Оркестрация сервисов |
+| Redis + `IDistributedCache` | Распределённое кэширование |
+| Bogus | Генерация тестовых данных |
+| Blazor WebAssembly | Клиентское приложение |
+
+## API
+
+**Endpoint**: `GET /api/warehouse-item?id={int}`
+
+При первом запросе генерирует товар и кэширует его. При повторном запросе с тем же `id` возвращает данные из кэша. Время жизни записи в кэше настраивается через `CacheExpirationMinutes` в `appsettings.json` (по умолчанию 10 минут).
+
+**Пример ответа**:
+
+```json
+{
+  "id": 42,
+  "productName": "Fantastic Metal Shoes",
+  "category": "Electronics",
+  "quantity": 317,
+  "pricePerUnit": 1234.56,
+  "weightPerUnit": 2.45,
+  "dimensions": "30х15х10 см",
+  "isFragile": false,
+  "lastDeliveryDate": "2024-11-03",
+  "nextDeliveryDate": "2025-06-18"
+}
+```
+
+## Сущность «Товар на складе»
+
+| № | Поле | Тип | Правило генерации |
+|---|---|---|---|
+| 1 | `id` | `int` | Передаётся из запроса |
+| 2 | `productName` | `string` | `Commerce.ProductName()` |
+| 3 | `category` | `string` | `Commerce.Categories(1)[0]` |
+| 4 | `quantity` | `int` | Случайное `[0, 1000]` |
+| 5 | `pricePerUnit` | `decimal` | Случайное `[1, 10000]`, 2 знака |
+| 6 | `weightPerUnit` | `double` | Случайное `[0.1, 500]`, 2 знака |
+| 7 | `dimensions` | `string` | Формат `**х**х** см` |
+| 8 | `isFragile` | `bool` | Случайный `bool` |
+| 9 | `lastDeliveryDate` | `DateOnly` | Прошедшая дата ≤ сегодня |
+| 10 | `nextDeliveryDate` | `DateOnly` | Дата ≥ `lastDeliveryDate` |

WarehouseApp.Api/Generation/WarehouseItemGenerator.cs

@@ -0,0 +1,38 @@
+using Bogus;
+using WarehouseApp.Api.Models;
+
+namespace WarehouseApp.Api.Generation;
+
+/// <summary>
+/// Генератор товаров на складе на основе Bogus
+/// </summary>
+public static class WarehouseItemGenerator
+{
+    private static readonly Faker<WarehouseItem> _faker = new Faker<WarehouseItem>()
+        .RuleFor(x => x.ProductName, f => f.Commerce.ProductName())
+        .RuleFor(x => x.Category, f => f.Commerce.Categories(1)[0])
+        .RuleFor(x => x.Quantity, f => f.Random.Int(0, 1000))
+        .RuleFor(x => x.PricePerUnit, f => Math.Round(f.Random.Decimal(1m, 10000m), 2))
+        .RuleFor(x => x.WeightPerUnit, f => Math.Round(f.Random.Double(0.1, 500.0), 2))
+        .RuleFor(x => x.Dimensions, f =>
+            $"{f.Random.Int(1, 99)}х{f.Random.Int(1, 99)}х{f.Random.Int(1, 99)} см")
+        .RuleFor(x => x.IsFragile, f => f.Random.Bool())
+        .RuleFor(x => x.LastDeliveryDate, f =>
+            DateOnly.FromDateTime(f.Date.Past(2, DateTime.Today)))
+        .RuleFor(x => x.NextDeliveryDate, (f, item) => DateOnly.FromDateTime(
+            f.Date.Between(
+                item.LastDeliveryDate.ToDateTime(TimeOnly.MinValue),
+                DateTime.Today.AddYears(1))));
+
+    /// <summary>
+    /// Генерирует товар на складе с указанным идентификатором
+    /// </summary>
+    /// <param name="id">Идентификатор товара в системе</param>
+    /// <returns>Сгенерированный товар на складе</returns>
+    public static WarehouseItem Generate(int id)
+    {
+        var item = _faker.Generate();
+        item.Id = id;
+        return item;
+    }
+}

WarehouseApp.Api/Models/WarehouseItem.cs

@@ -0,0 +1,57 @@
+namespace WarehouseApp.Api.Models;
+
+/// <summary>
+/// Товар на складе
+/// </summary>
+public class WarehouseItem
+{
+    /// <summary>
+    /// Идентификатор в системе
+    /// </summary>
+    public int Id { get; set; }
+
+    /// <summary>
+    /// Наименование товара
+    /// </summary>
+    public required string ProductName { get; init; }
+
+    /// <summary>
+    /// Категория товара
+    /// </summary>
+    public required string Category { get; init; }
+
+    /// <summary>
+    /// Количество на складе
+    /// </summary>
+    public int Quantity { get; init; }
+
+    /// <summary>
+    /// Цена за единицу товара
+    /// </summary>
+    public decimal PricePerUnit { get; init; }
+
+    /// <summary>
+    /// Вес единицы товара
+    /// </summary>
+    public double WeightPerUnit { get; init; }
+
+    /// <summary>
+    /// Габариты единицы товара
+    /// </summary>
+    public required string Dimensions { get; init; }
+
+    /// <summary>
+    /// Товар хрупкий
+    /// </summary>
+    public bool IsFragile { get; init; }
+
+    /// <summary>
+    /// Дата последней поставки
+    /// </summary>
+    public DateOnly LastDeliveryDate { get; init; }
+
+    /// <summary>
+    /// Дата следующей поставки
+    /// </summary>
+    public DateOnly NextDeliveryDate { get; init; }
+}