let's try

.gitignore

@@ -0,0 +1,17 @@
+################################################################################
+# Данный GITIGNORE-файл был автоматически создан Microsoft(R) Visual Studio.
+################################################################################
+
+/.vs/TestTaskForVersta/FileContentIndex
+/.vs
+/backend/CargoDelivery.API/bin/Debug/net8.0
+/backend/CargoDelivery.API/.vs
+/backend/CargoDelivery.API/obj
+/backend/CargoDelivery.Application/bin/Debug/net8.0
+/backend/CargoDelivery.Application/obj
+/backend/CargoDelivery.Core/bin/Debug/net8.0
+/backend/CargoDelivery.Core/obj
+/backend/CargoDelivery.DataAccess/bin/Debug/net8.0
+/backend/CargoDelivery.DataAccess/obj
+/frontend/node_modules
+/frontend

README.md

@@ -1 +1,151 @@
-# TestTaskForVersta
+# TestTaskForVersta
+## Техническое задание:
+*Реализовать простое Web приложение для приемки заказа на доставку со следующим функционалом:*
+
+*1. Форма создания нового заказа (все поля обязательны для заполнения):*
+*Город отправителя
+Адрес отправителя
+Город получателя
+Адрес получателя
+Вес груза
+Дата забора груза*
+
+*2. Форма отображения списка заказов: все созданные заказы должны отображаться в отдельной форме. Помимо полей, введенных пользователем при создании заказа, должен отображаться автоматически сгенерированный номер заказа.*
+
+*3. Форма просмотра созданного заказа в режиме чтения. Должна открываться при клике на заказ в списке заказов.*
+
+___
+## Стек технологий:
+
+* ASP.NET 8 на backend
+* Razor Pages
+* Entity Framework
+* PostgreSQL
+* Docker
+___
+## Backend:
+ Я решил написать данное приложение с использованием луковой(чистой) архитектуры. Как известно, всё начинается с доменных сущностей:
+
+ ![image](https://github.com/VladislavRkm/TestTaskForVersta/assets/113041279/4af54062-a543-42bd-bcbb-fc0799627fb9)
+ (Все слои и взаимодействия можно увидеть в структкуре проекта.)
+
+ Не буду тянуть. Когда все сущности, модели, контекст, репозитории, интерфейсы, сервисы и контроллеры были написаны, я подключил базу данных PostgreSQL и поднял её в Docker-контейнере.
+ ![image](https://github.com/VladislavRkm/TestTaskForVersta/assets/113041279/0785811f-eac8-4ee0-a266-43d88a19e48d)
+ ![image](https://github.com/VladislavRkm/TestTaskForVersta/assets/113041279/608d291e-1f46-4b99-b3b5-e36904ec9453)
+ ___
+ Можно запускать проект. При запуске у нас открывается страница Swagger'a со следующими http-запросами:
+ ![image](https://github.com/VladislavRkm/TestTaskForVersta/assets/113041279/b6f43d69-5cd5-4f92-9833-a6e7d51b3f41)
+ ___
+ Проверим их работоспособность, и первым делом создадим заказ на перевозку груза:
+ ![image](https://github.com/VladislavRkm/TestTaskForVersta/assets/113041279/b6295f9b-87f5-4351-8108-d92a115f9e1b)
+ ![image](https://github.com/VladislavRkm/TestTaskForVersta/assets/113041279/13440220-455c-4132-ae4b-100dd13e67c1)
+ Видим код "200", радуемся жизни и отправляем GET-запрос и получаем наши заказы, дабы убедиться, что всё не зря:
+ ![image](https://github.com/VladislavRkm/TestTaskForVersta/assets/113041279/79abdfb1-084a-4aba-ae17-1e00c607851f)
+ Перед нами два заказа, один из которых не несёт в себе никакой содержательной информации. Удалим его и проверим работоспособность DELETE-запроса. Копируем id заказа, который хотим удалить и вставляем в поле для заполнения.
+![image](https://github.com/VladislavRkm/TestTaskForVersta/assets/113041279/62a83acf-4280-4615-9302-679a4fb4e8b8)
+![image](https://github.com/VladislavRkm/TestTaskForVersta/assets/113041279/81e87d2e-8e1c-4648-aeee-76e147cfe6de)
+___
+Теперь представим, что экспедитору попался ненадёжный заказчик и ему нужно подкорректировать детали заказа. Корректируем данные, отправляем UPDATE-запрос, а затем GET-запрос, чтобы убедиться, что внесённые изменения сохранены.
+![image](https://github.com/VladislavRkm/TestTaskForVersta/assets/113041279/b179ba10-056d-48a0-a1cd-4f87aea475da)
+![image](https://github.com/VladislavRkm/TestTaskForVersta/assets/113041279/e9a901ac-846b-403a-a423-bca654235a71)
+![image](https://github.com/VladislavRkm/TestTaskForVersta/assets/113041279/83d16269-7291-4858-955a-db6e0e3fc1f9)
+___
+Наконец, убедимся, что в базе данных всё также сохраняется:
+![image](https://github.com/VladislavRkm/TestTaskForVersta/assets/113041279/434803a5-0f7e-4220-b1a1-e545dc57aa44)
+___
+
+## Frontend:
+Главная страница выглядит следующим образом. Мы можем увидеть кнопку для формирования нового заказа и форму для просмотра уже существующих заказов (пока что она пуста):
+
+![image](https://github.com/user-attachments/assets/997906dc-ab77-48f9-b29e-9870da7f7b07)
+
+Убедимся, что наша база данных также пуста и перейдём к ручному тестированию функционала страницы.
+
+![image](https://github.com/user-attachments/assets/5b2ec1cb-35a7-4e27-8d13-a933d150d421)
+___
+Создадим новый заказ, нажимаем кнопку "Отправить". Возращаемся на главную станицу и видим, что заказ отобразился.
+![image](https://github.com/user-attachments/assets/1cd30de6-62d4-43db-870e-eb0c99e0ba12)
+![image](https://github.com/user-attachments/assets/ba0b8325-d65a-41b2-a635-03ffb5a38973)
+
+Проверим его наличие в БД:
+![image](https://github.com/user-attachments/assets/224a4216-a08d-4151-a4bb-fa5fa5285177)
+
+Видим, что заказ отобразился и все данные совпадают с тем, что отражено на странице.
+___
+Перейдём к тестированию кнопок "Просмотр заказа", "Редактировать", "Удалить":
+
+Просмотр осуществляется в режиме чтения. Открываем заказ, попробуем стереть введённые данные:
+![image](https://github.com/user-attachments/assets/bf404dc5-5cee-4ffb-9ea8-9989e7076f4a)
+
+Нажимаем кнопку закрыть и всё возвращается на свои места:
+![image](https://github.com/user-attachments/assets/f5cf7bea-d3f1-4273-944c-667c6b5081ec)
+___
+
+Теперь отредактируем наш заказ:
+![image](https://github.com/user-attachments/assets/bb6d4ccb-7ead-4db0-84fd-f5c43e989c4c)
+
+Заказ отобразился, при этом заметим, что номер заказа у нас _не редактируется и не меняется_, то есть с точки зрения бизнес-логики это тот же самый заказ, в котором изменились некоторые поля.
+![image](https://github.com/user-attachments/assets/ecbbc533-71b8-44b6-bd57-2e4f0ea95346)
+
+В базе данных изменения также отображаются:
+![image](https://github.com/user-attachments/assets/07975d8e-81c7-4451-b370-fc715e1b9bd8)
+___
+
+Давайте теперь удалим наш заказ. Для этого воспользуемся кнопкой "Удалить".
+![image](https://github.com/user-attachments/assets/feec350c-2542-4a53-b6b8-d4585a98dc51)
+
+Из базы данных запись удаляется соответственно:
+![image](https://github.com/user-attachments/assets/2c8d6622-7766-4b8b-a012-65ff7f3dc977)
+___
+Теперь проверим синхронизацию бэкенда и фронтенда. Создадим какой-нибудь заказ через Swagger UI.
+![image](https://github.com/user-attachments/assets/2cbc660b-5a27-46a6-ae19-ec1f84619986)
+Обновим страницу и увидим заказ на нашей страничке:
+
+![image](https://github.com/user-attachments/assets/21bf185a-d473-435b-8eca-c5408e37c556)
+___
+Теперь в обратную сторону, проверим как работают http-запросы с заказами, созданными через Razor Pages.
+![image](https://github.com/user-attachments/assets/37ecdbee-ee90-4d59-b253-8531e0474239)
+![image](https://github.com/user-attachments/assets/424f9451-5918-47b9-9deb-8d256ead09a7)
+
+Выполняем GET-запрос в Swagger UI и он нам возвращает наши заказы.
+![image](https://github.com/user-attachments/assets/caebeab5-1699-4ce3-a430-9eac87b128dc)
+
+Остальные запросы выполнять не будем, так как очевидно, что они будут работать.
+___
+Подведём итоги.
+Технические требования к реализации:
+
+- [x] Форма заказа с обязательными для заполнения полями
+- [x] Форма для отображения сформированных заказов с автоматически сгенерированным номером для каждого заказа
+- [x] Форма для просмотра заказа в режиме чтения
+
+Технологии:
+
+- [x] ASP.NET 8 на backend
+- [ ] React.JS (предпочтительно) на front
+- [x] Razor Pages на front
+- [x] Entity Framework
+- [x] Docker (дополнительно)
+- [x] PostgreSQL
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+

backend/CargoDelivery.API/.dockerignore

@@ -0,0 +1,30 @@
+**/.classpath
+**/.dockerignore
+**/.env
+**/.git
+**/.gitignore
+**/.project
+**/.settings
+**/.toolstarget
+**/.vs
+**/.vscode
+**/*.*proj.user
+**/*.dbmdl
+**/*.jfm
+**/azds.yaml
+**/bin
+**/charts
+**/docker-compose*
+**/Dockerfile*
+**/node_modules
+**/npm-debug.log
+**/obj
+**/secrets.dev.yaml
+**/values.dev.yaml
+LICENSE
+README.md
+!**/.gitignore
+!.git/HEAD
+!.git/config
+!.git/packed-refs
+!.git/refs/heads/**

backend/CargoDelivery.API/CargoDelivery.API.csproj

@@ -0,0 +1,32 @@
+<Project Sdk="Microsoft.NET.Sdk.Web">
+
+  <PropertyGroup>
+    <TargetFramework>net8.0</TargetFramework>
+    <Nullable>enable</Nullable>
+    <ImplicitUsings>enable</ImplicitUsings>
+    <UserSecretsId>70e9f40d-985e-4d30-b9f2-959dabf4dc9c</UserSecretsId>
+    <DockerDefaultTargetOS>Linux</DockerDefaultTargetOS>
+    <DockerfileContext>.</DockerfileContext>
+  </PropertyGroup>
+
+  <ItemGroup>
+    <PackageReference Include="Microsoft.EntityFrameworkCore" Version="8.0.6" />
+    <PackageReference Include="Microsoft.EntityFrameworkCore.Design" Version="8.0.6">
+      <PrivateAssets>all</PrivateAssets>
+      <IncludeAssets>runtime; build; native; contentfiles; analyzers; buildtransitive</IncludeAssets>
+    </PackageReference>
+    <PackageReference Include="Microsoft.EntityFrameworkCore.Tools" Version="8.0.6">
+      <PrivateAssets>all</PrivateAssets>
+      <IncludeAssets>runtime; build; native; contentfiles; analyzers; buildtransitive</IncludeAssets>
+    </PackageReference>
+    <PackageReference Include="Microsoft.VisualStudio.Azure.Containers.Tools.Targets" Version="1.20.1" />
+    <PackageReference Include="Npgsql.EntityFrameworkCore.PostgreSQL" Version="8.0.4" />
+    <PackageReference Include="Swashbuckle.AspNetCore" Version="6.4.0" />
+  </ItemGroup>
+
+  <ItemGroup>
+    <ProjectReference Include="..\CargoDelivery.Application\CargoDelivery.Application.csproj" />
+    <ProjectReference Include="..\CargoDelivery.DataAccess\CargoDelivery.DataAccess.csproj" />
+  </ItemGroup>
+
+</Project>

backend/CargoDelivery.API/CargoDelivery.API.csproj.user

@@ -0,0 +1,9 @@
+<?xml version="1.0" encoding="utf-8"?>
+<Project ToolsVersion="Current" xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
+  <PropertyGroup>
+    <ActiveDebugProfile>http</ActiveDebugProfile>
+  </PropertyGroup>
+  <PropertyGroup Condition="'$(Configuration)|$(Platform)'=='Debug|AnyCPU'">
+    <DebuggerFlavor>ProjectDebugger</DebuggerFlavor>
+  </PropertyGroup>
+</Project>

backend/CargoDelivery.API/CargoDelivery.API.http

@@ -0,0 +1,6 @@
+@CargoDelivery.API_HostAddress = http://localhost:5298
+
+GET {{CargoDelivery.API_HostAddress}}/weatherforecast/
+Accept: application/json
+
+###

backend/CargoDelivery.API/CargoDelivery.sln

@@ -0,0 +1,47 @@
+
+Microsoft Visual Studio Solution File, Format Version 12.00
+# Visual Studio Version 17
+VisualStudioVersion = 17.10.35013.160
+MinimumVisualStudioVersion = 10.0.40219.1
+Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "CargoDelivery.API", "CargoDelivery.API.csproj", "{539CE379-B35B-41B7-A20A-F581CEEDE422}"
+	ProjectSection(ProjectDependencies) = postProject
+		{60CC839E-94A5-4F41-88C8-EACFED9FC89D} = {60CC839E-94A5-4F41-88C8-EACFED9FC89D}
+		{D9E9F7C0-6649-4DF0-B236-57748F306AC9} = {D9E9F7C0-6649-4DF0-B236-57748F306AC9}
+	EndProjectSection
+EndProject
+Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "CargoDelivery.Core", "..\CargoDelivery.Core\CargoDelivery.Core.csproj", "{AB950833-2C0F-4E3C-AA4B-B57F44C631BD}"
+EndProject
+Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "CargoDelivery.DataAccess", "..\CargoDelivery.DataAccess\CargoDelivery.DataAccess.csproj", "{D9E9F7C0-6649-4DF0-B236-57748F306AC9}"
+EndProject
+Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "CargoDelivery.Application", "..\CargoDelivery.Application\CargoDelivery.Application.csproj", "{60CC839E-94A5-4F41-88C8-EACFED9FC89D}"
+EndProject
+Global
+	GlobalSection(SolutionConfigurationPlatforms) = preSolution
+		Debug|Any CPU = Debug|Any CPU
+		Release|Any CPU = Release|Any CPU
+	EndGlobalSection
+	GlobalSection(ProjectConfigurationPlatforms) = postSolution
+		{539CE379-B35B-41B7-A20A-F581CEEDE422}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{539CE379-B35B-41B7-A20A-F581CEEDE422}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{539CE379-B35B-41B7-A20A-F581CEEDE422}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{539CE379-B35B-41B7-A20A-F581CEEDE422}.Release|Any CPU.Build.0 = Release|Any CPU
+		{AB950833-2C0F-4E3C-AA4B-B57F44C631BD}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{AB950833-2C0F-4E3C-AA4B-B57F44C631BD}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{AB950833-2C0F-4E3C-AA4B-B57F44C631BD}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{AB950833-2C0F-4E3C-AA4B-B57F44C631BD}.Release|Any CPU.Build.0 = Release|Any CPU
+		{D9E9F7C0-6649-4DF0-B236-57748F306AC9}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{D9E9F7C0-6649-4DF0-B236-57748F306AC9}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{D9E9F7C0-6649-4DF0-B236-57748F306AC9}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{D9E9F7C0-6649-4DF0-B236-57748F306AC9}.Release|Any CPU.Build.0 = Release|Any CPU
+		{60CC839E-94A5-4F41-88C8-EACFED9FC89D}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{60CC839E-94A5-4F41-88C8-EACFED9FC89D}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{60CC839E-94A5-4F41-88C8-EACFED9FC89D}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{60CC839E-94A5-4F41-88C8-EACFED9FC89D}.Release|Any CPU.Build.0 = Release|Any CPU
+	EndGlobalSection
+	GlobalSection(SolutionProperties) = preSolution
+		HideSolutionNode = FALSE
+	EndGlobalSection
+	GlobalSection(ExtensibilityGlobals) = postSolution
+		SolutionGuid = {BC1836CA-DD1B-40EF-8EFC-4F4B3101097D}
+	EndGlobalSection
+EndGlobal

backend/CargoDelivery.API/Contracts/OrderRequest.cs

@@ -0,0 +1,11 @@
+namespace CargoDelivery.API.Contracts;
+public record OrderRequest 
+    (
+    string SenderCity,
+    string SenderAddress,
+    string RecipientCity,
+    string RecipientAddress,
+    float Weight,
+    DateTime PickUpDate
+    );
+

backend/CargoDelivery.API/Contracts/OrderResponse.cs

@@ -0,0 +1,13 @@
+namespace CargoDelivery.API.Contracts;
+
+public record OrderResponse(
+    Guid id, 
+    string OrderNumber,
+    string SenderCity, 
+    string SenderAddress, 
+    string RecipientCity, 
+    string RecipientAddress, 
+    float Weight, 
+    DateTime PickUpDate
+    );
+

backend/CargoDelivery.API/Controllers/OrdersController.cs

@@ -0,0 +1,57 @@
+using CargoDelivery.API.Contracts;
+using CargoDelivery.Application.Services;
+using CargoDelivery.Core.Models;
+using Microsoft.AspNetCore.Http.HttpResults;
+using Microsoft.AspNetCore.Mvc;
+
+namespace CargoDelivery.API.Controllers;
+
+[ApiController]
+[Route("[controller]")]
+public class OrdersController : ControllerBase
+{
+    private readonly IOrderService _orderService;
+
+    public OrdersController(IOrderService orderService)
+    {
+        _orderService = orderService;
+    }
+    [HttpGet]
+    public async Task<ActionResult<List<OrderResponse>>> GetOrders()
+    {
+        var orders = await _orderService.GetAllOrders();
+
+        var response = orders.Select(o => new OrderResponse(o.Id, o.OrderNumber, o.SenderCity, o.SenderAddress, o.RecipientCity, o.RecipientAddress, o.Weight, o.PickUpDate));
+        return Ok(response);
+    }
+    [HttpPost]
+    public async Task<ActionResult<Guid>> CreateOrder([FromBody] OrderRequest orderRequest)
+    {
+        var (order, error) = Order.Create(
+            Guid.NewGuid(),
+            orderRequest.SenderCity,
+            orderRequest.SenderAddress,
+            orderRequest.RecipientCity,
+            orderRequest.RecipientAddress,
+            orderRequest.Weight,
+            orderRequest.PickUpDate);
+
+        if (!string.IsNullOrEmpty(error))
+        {
+            return BadRequest(error);
+        }
+        var orderId = await _orderService.CreateOrder(order);
+        return Ok(orderId);
+    }
+    [HttpPut("{id:guid}")]
+    public async Task<ActionResult<Guid>> UpdateOrder(Guid id, string orderNumber, [FromBody] OrderRequest orderRequest)
+    {
+        var orderId = await _orderService.UpdateOrder(id, orderRequest.SenderCity, orderRequest.SenderAddress, orderRequest.RecipientCity, orderRequest.RecipientAddress, orderRequest.Weight, orderRequest.PickUpDate);
+        return Ok(orderId);
+    }
+    [HttpDelete("{id:guid}")]
+    public async Task<ActionResult<Guid>> DeleteOrder(Guid id)
+    {
+        return Ok(await _orderService.DeleteOrder(id));
+    }
+}