search

goodtocode / entities

GoodToCode Stack is a collection of common domain entities written in dotNet Core with Gherkin Specflow tests. Focused on DDD, CQRS, Microservices, Serverless and guided by the SOLID principle.
https://www.goodtocode.com
Apache License 2.0
2 stars 0 forks source link
azure-app-services azure-devops azure-functions azure-pipelines ddd-cqrs dotnet dotnet-core entity-framework-core

readme

GoodToCode Entities

The goal of GoodToCode Entities is to quick-start custom software applications by providing easy-to-extend Domain Entities and the APIs/Azure Functions that exposes these entities.

Entities LZ

Subjects LZ

Subjects API

GoodToCode Entities is a Microservice/Serverless centric collection of common Domain Entities that you often include in software applications. These Entities, like Person and Location, can be assembled and used in your business apps and APIs.

GoodToCode Entities is based on DDD, onion-architecture, vertical slice and CQRS in .NET Core and EF Core code-first.

Dev Environment Installation

Environment Variables

  1. Create "ASPNETCORE_ENVIRONMENT" and set it to Development. These relate to the appsettings.ENVIRONMENT.json files.

    • Development
    • Production

    Powershell: $env:ASPNETCORE_ENVIRONMENT="Development"

Azure Infrastructure

Create a Cloud Adoption Framework (CAF) Landing Zone

About CAF Landing Zones

  1. If you are using GitHub Actions

    • Create the shared Entities resource group: .github/workflows/gtc-rg-entities-landingzone.yml
    • Create the Subjects resource group: .github/workflows/gtc-rg-subjects-landingzone.yml
    • Deploy the Subjects API and runs EF Migrations: .github/workflows/gtc-rg-subjects-api.yml

  2. If you are using Azure DevOps Pipelines

    • Create the shared Entities resource group: .azure-devops/pipelines/gtc-entities-landingzone.yml
    • Create the Subjects resource group: .azure-devops/pipelines/gtc-entities-subjects-landingzone.yml
    • Deploy the Subjects API: .azure-devops/pipelines/gtc-entities-subjects-api.yml
    • Deploy the Subjects EF Migrations: .azure-devops/pipelines/gtc-entities-subjects-ef.yml

Azure AD and B2C Identity

Blazor WebAssebly Azure B2C

Projects and Namespaces

Namespace Path Contents
Goodtocode.Subjects.Common /src/Subjects/Common Includes shared kernel library that are candidates to share with other projects.
Goodtocode.Subjects.Domain /src/Subjects/Core/Domain Includes core domain objects, entities and interfaces. This only references .NET.
odtocode.Subjects.Application /src/Subjects/Core/Application Includes core application commands and queries. This only references Domain.
Goodtocode.Subjects.Persistence /src/Subjects/Infrastructure/Persistence Includes infrastructure concerns such as repositories, dbcontexts. This references Domain and Application.
Goodtocode.Subjects.WebApi /src/Subjects/Common Includes presentation Web API. This references Persistence.
Goodtocode.Subjects.Unit /src/Subjects/Specs/Application.Unit Unit tests that exercise Domain and Applicaiton with mocked infrastructure. This references Persistence.
Goodtocode.Subjects.Integration /src/Subjects/Specs/Application.Integration Unit tests that exercise Domain, Application and Presistence. Uses In-memory Database. This references Persistence.

Dev Box Installation

Package Command
OS Windows or Linux (default Windows)
Windows Terminal winget install --id=Microsoft.WindowsTerminal -e
Git SCM winget install --id Git.Git -e --source winget
Visual Studio Code winget install Microsoft.VisualStudioCode -e
.NET 7 SDK winget install dotnet-sdk-74

Visual Studio Code Setup

Action/Command Operation
Extensions C# ms-dotnettools.csharp - https://marketplace.visualstudio.com/items?itemName=ms-dotnettools.csharp
Extensions SQL Server ms-mssql.mssql - https://marketplace.visualstudio.com/items?itemName=ms-mssql.mssql
Ctrl+Shft+P .NET Generate Assets for Build and Debug -> Create tasks.json from Template -> .NET Core

` Type build | Select Tasks: Configure Default Build Task Optional Py/Js/Jsx/Tsx | VisualStudioExptTeam.vscodeintellicode - https://marketplace.visualstudio.com/items?itemName=VisualStudioExptTeam.vscodeintellicode

Notable NuGet packages

Api.WebApi

Package Purpose
dotnet add package Azure.Extensions.AspNetCore.Configuration.Secrets Key Vault Secrets
dotnet add package FluentValidation.AspNetCore Fluent Assertions
dotnet add package Microsoft.AspNetCore.OpenApi OpenAPI (swagger UI)
dotnet add package Swashbuckle.AspNetCore Swagger Gen (swagger.json)

Web.BlazorServer

Package Purpose
dotnet add package Azure.Extensions.AspNetCore.Configuration.Secrets Key Vault Secrets
dotnet add package BlazorPro.Spinkit Spinners for progress