Merge pull request #9 from thangchung/feature/net6

Author: thangchung

.dockerignore

@@ -28,3 +28,11 @@ README.md
 .devcontainer/certs
 .logs
 out/
+assets/
+rs/
+.github
+.config
+components
+src/Web
+nuget.config
+global.json

README.md

@@ -1,42 +1,42 @@
-# practical-clean-ddd
+# clean-architecture-dotnet
 
-The practical repository uses coolstore domain which is mainly borrowed from `https://github.com/zkavtaskin/Domain-Driven-Design-Example` to demonstrate how to apply Domain Driven Design seamlessly with Clean Architecture.
+"Everything should be made as simple as possible, but not simpler." - Albert Einstein
 
-[![Sparkline](https://stars.medv.io/thangchung/practical-clean-ddd.svg)](https://stars.medv.io/thangchung/practical-clean-ddd)
+"Mọi thứ đều nên đơn giản, càng đơn giản càng tốt, nhưng không nên đơn giản hơn bản chất của nó." - Vietnamese translated
+
+We know that, and that's a reason we publish these libraries and samples. These are distillations with all best practices, tips, and tricks, and whatever made us spend a lot of time struggling to solve.
+
+In the end of our journey, we would like to give these simplified and effortless libraries and samples as a reward for you. Enjoy the Minimal Clean Architecture, Domain-driven Design Lite, CQRS Lite, and just enough Cloud-native patterns!
+
+[![Sparkline](https://stars.medv.io/thangchung/clean-architecture-dotnet.svg)](https://stars.medv.io/thangchung/clean-architecture-dotnet)
+
+> Even we're trying to do the best, but make sure you stress test carefully if you want to use these libs in the production environment.
 
 ## Give a star ⭐
 
 If you're using this repository for your samples, workshop, your project or whatever, please give a star ⭐. Thank you very much :+1:
 
-> Plz, use this project with care because we're using this repository for brainstorming new ideas in .NET and containerization worlds! 
-
 # Give it a try!
 
 - Prerequisite
-  - .NET SDK: 5.0.200-preview.21079.7
-  - Rust: v1.50.0
-  - nodejs: v15.5.1
-  - tye: 0.7.0-alpha.21070.7+eb3b50699b7a5f2d0997a5cc8c5185d056dde8ec
-  - dapr: 1.0.0
+  - [.NET SDK](https://dotnet.microsoft.com/download/dotnet/6.0): 6.0.100-preview.5.21271.2
+  - [nodejs](https://nodejs.org/en/download): v15.5.1
+  - [tye](https://github.com/dotnet/tye): 0.8.0-alpha.21301.1+0fed0b38e730cd07caf0a90287090638c110b77d
+  - [dapr](https://dapr.io/): 1.2.0
+  - Dev tools:
+    - [vscode tye](https://marketplace.visualstudio.com/items?itemName=ms-azuretools.vscode-tye) extension
+    - [vscode REST Client](https://marketplace.visualstudio.com/items?itemName=humao.rest-client) extension
 
 - Starting the Api
 
 ```
 $ tye run
 ```
 
-- Starting the web application
-
-```
-$ cd src\Web
-$ npm i
-$ npm run dev
-```
-
 - Public Apis:
 
 > Tye Dashboard: [http://localhost:8000](http://localhost:8000)
-> 
+>
 > Play around at [restclient.http](restclient.http)
 
 <table>
@@ -68,12 +68,7 @@ $ npm run dev
     </tr>
     <tr>
       <td>5</td>
-      <td>audit (internal)</td>
-      <td><a href="http://localhost:5010">http://localhost:5010</a></td>
-    </tr>
-    <tr>
-      <td>6</td>
-      <td>frontend</td>
+      <td>frontend (not updated)</td>
       <td><a href="http://localhost:3000">http://localhost:3000</a></td>
     </tr>
   </tbody>
@@ -93,36 +88,42 @@ $ npm run dev
 
 # Clean Domain Driven-design
 
-Domain-driven Design demonstrates it can help the business tidy and organized in many years. But it is hard to approach and use, we need to make it easier to use in the real project when we get started. 
+Domain-driven Design demonstrates it can help the business tidy and organized in many years. But it is hard to approach and use, we need to make it easier to use in the real project when we get started.
 
 Clean Architecture helps the project structure easier to refactor and evolve in medium and big projects. Especially in the Microservice world, we always want to do and try with a lot of time in the project lifetime.
 
 Clean Domain-driven Design is a collection of basic building blocks and project structure to help we get starting the project with less code boilerplate and effortless. We focus on the Microservice approach of how can we organize code, the project with the monorepo approach, and you can use it for modular monolith project as well.
 
-![](assets/projects_structure.png)
+![](assets/DomainDrivenHexagon.png)
+Reference to https://github.com/Sairyss/domain-driven-hexagon
+
+# Project structure
+
+![](assets/productapp_minimal_template.png)
+
+## Project dependencies
+
+![](assets/projects_dependencies.png)
 
 ## Core project
 ### Domain
 
-TODO
-
-### Repository
+This contains all things to get start the project. Almost there are DDD-lite components just like Entity, AggregateRoot, Specification, Repository.
 
-TODO
+Assembly: N8T.Core.dll
 
 ## Infrastructure project
 
-TODO
+This is where some of component for Clean Architecture resides such as drivers (Entity Framework for PostgresDB, Authentication, Dapr Bus, MVC, Logging, Service Invocation with Dapr, Service Status model, Swagger with SwashBuckle, Transactional Outbox with Dapr, Tye configuration, Validation Model, OpenTelemetry components)
 
-## Application project
+Assemblies: N8T.Infrastructure.dll, N8T.Infrastructure.EfCore.dll, N8T.Infrastructure.OTel.dll
 
-TODO
-
-# Public CRUD interface
+# Additionals
+## Public CRUD interface
 
 In medium and large software projects, we normally implement the CRUD actions over and over again. And it might take around 40-50% codebase just to do CRUD in the projects. The question is can we make standardized CRUD APIs, then we can use them in potential projects in the future? That is in my mind for a long time when I started and finished many projects, and I decide to take time to research and define the public interfaces for it as below
 
-## Common
+### Common
 
 ```csharp
 public record ResultModel<T>(T Data, bool IsError = false, string? ErrorMessage = default);
@@ -136,7 +137,7 @@ public interface ICommand<T> : IRequest<ResultModel<T>> {}
 public interface IQuery<T> : IRequest<ResultModel<T>> {}
 ```
 
-## [R]etrieve
+### [R]etrieve
 
 ```csharp
 // input model for list query (normally using for the table UI control with paging, filtering and sorting)
@@ -163,7 +164,7 @@ public interface IItemQuery<TId, TResponse> : IQuery<TResponse>
 }
 ```
 
-## [C]reate
+### [C]reate
 
 ```csharp
 public interface ICreateCommand<TRequest, TResponse> : ICommand<TResponse>, ITxRequest
@@ -172,7 +173,7 @@ public interface ICreateCommand<TRequest, TResponse> : ICommand<TResponse>, ITxR
 }
 ```
 
-## [U]pdate
+### [U]pdate
 
 ```csharp
 public interface IUpdateCommand<TRequest, TResponse> : ICommand<TResponse>, ITxRequest
@@ -181,7 +182,7 @@ public interface IUpdateCommand<TRequest, TResponse> : ICommand<TResponse>, ITxR
 }
 ```
 
-## [D]elete
+### [D]elete
 
 ```csharp
 public interface IDeleteCommand<TId, TResponse> : ICommand<TResponse> where TId : struct
@@ -190,11 +191,12 @@ public interface IDeleteCommand<TId, TResponse> : ICommand<TResponse> where TId
 }
 ```
 
-# Service Invocation
+# Dapr components
+## Service Invocation
 
 - RestEase with Dapr handler. More information is at https://dev.to/thangchung/how-to-make-dapr-client-works-well-with-refit-and-restease-40m
 
-# Event Bus
+## Event Bus
 
 ```csharp
 public interface IEventBus
@@ -207,7 +209,7 @@ public interface IEventBus
 
 - Dapr provider
 
-# Transactional Outbox
+## Transactional Outbox
 
 ```csharp
 public class OutboxEntity
@@ -243,38 +245,14 @@ public class OutboxEntity
 
 - Dapr provider
 
-# Private `nuget` for NetCoreKit
-
-Fork this repository!
-
-Set global nuget for accessing in Visual Studio
-
-```
-# edit C:\Users\<current user>\AppData\Roaming\NuGet\NuGet.Config
-
-```
-
-```xml
-<?xml version="1.0" encoding="utf-8"?>
-<configuration>
-  <packageSources>
-    <add key="nuget.org" value="https://api.nuget.org/v3/index.json" protocolVersion="3" />
-    <add key="github" value="https://nuget.pkg.github.com/thangchung/index.json" />
-  </packageSources>
-  <packageSourceCredentials>
-    <github>
-      <add key="Username" value="<your github username>" />
-      <add key="ClearTextPassword" value="<Github Token>" />
-    </github>
-  </packageSourceCredentials>
-</configuration>
-```
-
 # Sample pages
 
+> We haven't have enough time to update the front-end API just yet :(
+
 ![](assets/products_screen.png)
 
 # Refs
+- https://github.com/zkavtaskin/Domain-Driven-Design-Example
 - [Ant Design Components](https://ant.design/components/overview)
 - [C4 PlaintUML Model](https://github.com/plantuml-stdlib/C4-PlantUML/blob/master/samples/C4CoreDiagrams.md)
 - [Real world PlantUML](https://real-world-plantuml.com)