Feature/add todolist usecase (#11)

* feat(TodoList): add commands

* feat(use-case): add crud todo list and item

* feat(usecase): add perfomance behavior and use case

* fix: fix template and add params

.template.config/dotnetcli.host.json

@@ -2,6 +2,12 @@
   "symbolInfo": {
     "UseOracle": {
       "longName": "use-oracle"
+    },
+    "EnableContainerSupport": {
+      "longName": "enable-container-support"
+    },
+    "UseController": {
+      "longName": "use-controller"
     }
   }
 }

.template.config/ide.host.json

@@ -6,12 +6,28 @@
     {
       "id": "UseOracle",
       "name": {
-        "text": "Use Oracle"
+        "text": "Use oracle"
       },
       "description": {
-        "text": "Use Oracle for database (default is LocalDB)."
+        "text": "Use oracle for database (default is LocalDB)."
       },
       "isVisible": true
+    },
+    {
+      "id": "EnableContainerSupport",
+      "name": {
+        "text": "Enable container support"
+      },
+      "description": {
+        "text": "Enable container support and add Docker file for linux."
+      },
+      "isVisible": true
+    },
+    {
+      "id": "UseController",
+      "name": {
+        "text": "Use controller instead of minimals APIs."
+      }
     }
   ]
 }

.template.config/template.json

@@ -31,6 +31,18 @@
       "type": "computed",
       "value": "(!UseOracle)"
     },
+    "UseController": {
+      "type": "parameter",
+      "datatype": "bool",
+      "defaultValue": "true",
+      "description": "Use controller instead of minimals APIs."
+    },
+    "EnableContainerSupport": {
+      "type": "parameter",
+      "datatype": "bool",
+      "defaultValue": "false",
+      "description": "Enable container support (Docker for linux)."
+    },
     "fcaRepositoryUrl": {
       "type": "generated",
       "generator": "constant",
@@ -44,7 +56,7 @@
       "generator": "constant",
       "replaces": "fcaPackageVersion",
       "parameters": {
-        "value": "8.0.8"
+        "value": "8.0.1"
       }
     }
   },
@@ -93,6 +105,19 @@
             "appsettings.Oracle.json": "appsettings.json",
             "TestDatabase.Oracle.cs": "TestDatabase.cs"
           }
+        },
+        {
+          "condition": "(!UseController)",
+          "exclude": [
+            "src/API/Controllers"
+          ]
+        },
+        {
+          "condition": "(!EnableContainerSupport)",
+          "exclude": [
+            "src/API/Dockerfile",
+            ".dockerignore"
+          ]
         }
       ]
     }

Directory.Build.props

@@ -0,0 +1,8 @@
+<Project>
+  <PropertyGroup>
+    <TargetFramework>net8.0</TargetFramework>
+    <TreatWarningsAsErrors>true</TreatWarningsAsErrors>
+    <ImplicitUsings>enable</ImplicitUsings>
+    <Nullable>enable</Nullable>
+  </PropertyGroup>
+</Project>

FastCleanArchitecture.nuspec

@@ -1,33 +1,35 @@
 <?xml version="1.0" encoding="utf-8"?>
 <package xmlns="http://schemas.microsoft.com/packaging/2012/06/nuspec.xsd">
-	<metadata>
+  <metadata>
 
-		<id>Fast.Clean.Architecture.Solution.Template</id>
-		<version>8.0.1</version>
-		<title>Fast Clean Architecture Solution Template</title>
-		<authors>christiandr</authors>
-		<description>Fast Clean Architecture Solution Template for .NET 8.</description>
-		<summary>
-			A Clean Architecture Solution Template for creating apps using Web API only with DotNet.
-		</summary>
+    <id>Fast.Clean.Architecture.Solution.Template</id>
+    <version>8.0.1</version>
+    <title>Fast Clean Architecture Solution Template</title>
+    <authors>christiandr</authors>
+    <description>Fast Clean Architecture Solution Template for .NET 8.</description>
+    <summary>
+      A Clean Architecture Solution Template for create apps.
+    </summary>
+    <releaseNotes>
+    </releaseNotes>
 
-		<projectUrl>https://github.com/christianrd/FastCleanArchitecture</projectUrl>
-		<repository type="git" url="https://github.com/christianrd/FastCleanArchitecture.git" branch="main" />
+    <projectUrl>https://github.com/christianrd/FastCleanArchitecture</projectUrl>
+    <repository type="git" url="https://github.com/christianrd/FastCleanArchitecture.git" branch="main" />
 
-		<license type="expression">MIT</license>
-		<requireLicenseAcceptance>false</requireLicenseAcceptance>
-		<tags>fast-clean-architecture clean-architecture project template csharp dotnet</tags>
-		<icon>icon.png</icon>
-		<readme>README.md</readme>
+    <license type="expression">MIT</license>
+    <requireLicenseAcceptance>false</requireLicenseAcceptance>
+    <tags>fast-clean-architecture clean-architecture project template csharp dotnet</tags>
+    <icon>icon.png</icon>
+    <readme>README.md</readme>
 
-		<packageTypes>
-			<packageType name="Template" />
-		</packageTypes>
-	</metadata>
+    <packageTypes>
+      <packageType name="Template" />
+    </packageTypes>
+  </metadata>
 
-	<files>
-		<file src=".template.config\icon.png" />
-		<file src="README.md" />
-		<file src=".\**" target="content" exclude="**\bin\**;**\obj\**;.\.vs\**;.\.vscode\**;content\Directory.Build.*;.\.git\**;.\.github\workflows\package.yml;.\.github\workflows\codeql.yml;.\.github\workflows\build.yml;.\.github\ISSUE_TEMPLATE\**;.\.github\icon.png;.\.github\FUNDING.md;.\CODE_OF_CONDUCT.md;.\LICENSE;.\README.md;" />
-	</files>
+  <files>
+    <file src=".template.config\icon.png" />
+    <file src="README.md" />
+    <file src=".\**" target="content" exclude="**\bin\**;**\obj\**;.\.vs\**;.\.vscode\**;content\Directory.Build.*;.\.git\**;.\.github\workflows\package.yml;.\.github\workflows\codeql.yml;.\.github\workflows\build.yml;.\.github\ISSUE_TEMPLATE\**;.\.github\icon.png;.\.github\FUNDING.md;.\CODE_OF_CONDUCT.md;.\LICENSE;.\README.md;" />
+  </files>
 </package>

README.md

@@ -14,7 +14,6 @@ Starting is quick and easy-just install the .NET template (detailed instructions
 The following prerequisites are required to build and run the solution:
 
 - [.NET 8.0 SDK](https://dotnet.microsoft.com/download/dotnet/8.0) (latest version)
-- [Node.js](https://nodejs.org/) (latest LTS, only required if you are using Angular or React)
 
 The easiest way to get started is to install the [.NET template](https://www.nuget.org/packages/Fast.Clean.Architecture.Solution.Template):
 ```
@@ -85,6 +84,8 @@ The template includes a full CI/CD pipeline. The pipeline is responsible for bui
 * [ASP.NET Core 8](https://docs.microsoft.com/en-us/aspnet/core/introduction-to-aspnet-core)
 * [Entity Framework Core 8](https://docs.microsoft.com/en-us/ef/core/)
 * [MediatR](https://github.com/jbogard/MediatR)
+* [Maspter](https://github.com/MapsterMapper/Mapster)
+* [FluentResult](https://github.com/altmann/FluentResults)
 * [FluentValidation](https://fluentvalidation.net/)
 * [NUnit](https://nunit.org/), [FluentAssertions](https://fluentassertions.com/), [Moq](https://github.com/devlooped/moq) & [Respawn](https://github.com/jbogard/Respawn)
 

fastCleanArchitecture.sln

@@ -19,10 +19,11 @@ Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "Infrastructure", "src\Infra
 EndProject
 Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "API", "src\API\API.csproj", "{3A7EAD0E-2F46-4022-9119-96593FFEC72D}"
 EndProject
-Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "SolutionItems", "SolutionItems", "{C7FBE7FF-00ED-4E1B-B015-CC61AE8E0FD3}"
+Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "Solution Items", "Solution Items", "{C7FBE7FF-00ED-4E1B-B015-CC61AE8E0FD3}"
 	ProjectSection(SolutionItems) = preProject
 		.gitignore = .gitignore
 		FastCleanArchitecture.nuspec = FastCleanArchitecture.nuspec
+		README-template.md = README-template.md
 		README.md = README.md
 	EndProjectSection
 EndProject

src/API/API.csproj

@@ -5,16 +5,20 @@
     <Nullable>enable</Nullable>
     <ImplicitUsings>enable</ImplicitUsings>
     <UserSecretsId>f5e32e1e-4b42-4557-9635-b9a0c84f3591</UserSecretsId>
+    <!--#if (EnableContainerSupport)-->
     <DockerDefaultTargetOS>Linux</DockerDefaultTargetOS>
     <DockerfileContext>..\..</DockerfileContext>
+    <!--#endif-->
 	  <CompanyName>FastCleanArchitecture</CompanyName>
 	  <Company>$(CompanyName)</Company>
 	  <RootNamespace>$(CompanyName.Replace(" ", "")).$(MSBuildProjectName.Replace(" ", ""))</RootNamespace>
 	  <AssemblyName>$(CompanyName.Replace(" ", "")).$(MSBuildProjectName.Replace(" ", ""))</AssemblyName>
   </PropertyGroup>
 
   <ItemGroup>
+    <!--#if (EnableContainerSupport)-->
     <PackageReference Include="Microsoft.VisualStudio.Azure.Containers.Tools.Targets" Version="1.21.0" />
+    <!--#endif-->
     <PackageReference Include="Swashbuckle.AspNetCore" Version="6.4.0" />
     <PackageReference Include="Microsoft.EntityFrameworkCore.Design" Version="8.0.8">
       <PrivateAssets>all</PrivateAssets>

src/API/Controllers/BaseController.cs → src/API/Controllers/ApiControllerBase.cs

@@ -4,9 +4,9 @@
 namespace FastCleanArchitecture.API.Controllers;
 
 [ApiController]
-public abstract class BaseController : ControllerBase
+public abstract class ApiControllerBase : ControllerBase
 {
     protected readonly ISender Sender;
 
-    public BaseController(ISender Sender) => this.Sender = Sender;
-}
+    public ApiControllerBase(ISender Sender) => this.Sender = Sender;
+}

src/API/Controllers/TodoItems/TodoItemsController.cs

@@ -0,0 +1,36 @@
+using FastCleanArchitecture.Application.TodoItems.Commands.CreateTodoItem;
+using FastCleanArchitecture.Application.TodoItems.Commands.DeleteTodoItem;
+using FastCleanArchitecture.Application.TodoItems.Commands.UpdateTodoItem;
+using MediatR;
+using Microsoft.AspNetCore.Mvc;
+
+namespace FastCleanArchitecture.API.Controllers.TodoItems;
+
+[Route("api/[controller]")]
+public sealed class TodoItemsController(ISender sender) : ApiControllerBase(sender)
+{
+    [HttpPost]
+    public async Task<IActionResult> CreateTodoItem([FromBody] CreateTodoItemCommand request)
+    {
+        await Sender.Send(request);
+
+        return NoContent();
+    }
+
+    [HttpPut("{Id}")]
+    public async Task<IActionResult> UpdateTodoItem(UpdateTodoItemCommand request)
+    {
+        var result = await Sender.Send(request);
+        if (result.IsFailed)
+            return NotFound("Item not found.");
+
+        return NoContent();
+    }
+
+    [HttpDelete("{Id}")]
+    public async Task<IActionResult> DeleteTodoItem([FromRoute] DeleteTodoItemCommand request)
+    {
+        await Sender.Send(request);
+        return NoContent();
+    }
+}

src/API/Controllers/TodoLists/TodoListsController.cs

@@ -0,0 +1,46 @@
+using FastCleanArchitecture.Application.TodoLists.Commands.Create;
+using FastCleanArchitecture.Application.TodoLists.Commands.Delete;
+using FastCleanArchitecture.Application.TodoLists.Commands.Update;
+using FastCleanArchitecture.Application.TodoLists.Queries.GetTodos;
+using MediatR;
+using Microsoft.AspNetCore.Mvc;
+
+namespace FastCleanArchitecture.API.Controllers.TodoLists;
+
+[Route("api/[controller]")]
+public sealed class TodoListsController(ISender Sender) : ApiControllerBase(Sender)
+{
+    [HttpGet(Name = nameof(GetTodoLists))]
+    public async Task<IActionResult> GetTodoLists()
+    {
+        var result = await Sender.Send(new GetTodosQuery());
+        return Ok(result.ValueOrDefault);
+    }
+
+    [HttpPost]
+    public async Task<IActionResult> CreateTodoList(CreateTodoListCommand request)
+    {
+        var result = await Sender.Send(request);
+        if (result.IsFailed)
+            return BadRequest(result.Errors);
+
+        return CreatedAtRoute(nameof(GetTodoLists), result.Value);
+    }
+
+    [HttpPut("{Id}")]
+    public async Task<IActionResult> UpdateTodoList(UpdateTodoListCommand request)
+    {
+        var result = await Sender.Send(request);
+        if (result.IsFailed)
+            return BadRequest(result.Errors);
+
+        return NoContent();
+    }
+
+    [HttpDelete("{Id}")]
+    public async Task<IActionResult> DeleteTodoList([FromRoute] DeleteTodoListCommand request)
+    {
+        await Sender.Send(request);
+        return NoContent();
+    }
+}

src/API/Program.cs

@@ -2,8 +2,9 @@
 using FastCleanArchitecture.Infrastructure;
 
 var builder = WebApplication.CreateBuilder(args);
-
+#if (UseController)
 builder.Services.AddControllers();
+#endif
 
 builder.Services.AddEndpointsApiExplorer();
 builder.Services.AddSwaggerGen();
@@ -22,8 +23,10 @@
 
 app.UseHttpsRedirection();
 
+#if (UseController)
 app.MapControllers();
+#endif
 
 await app.UseInfrastructureAsync();
 
-app.Run();
+app.Run();

src/Application/.templating.config/dotnetcli.host.json

@@ -0,0 +1,16 @@
+{
+  "symbolInfo": {
+    "featureName": {
+      "longName": "feature-name",
+      "shortName": "fn"
+    },
+    "returnType": {
+      "longName": "return-type",
+      "shortName": "rt"
+    },
+    "useCaseType": {
+      "longName": "usecase-type",
+      "shortName": "ut"
+    }
+  }
+}