Wally.CleanArchitecture.Template 1.3.3541

Wally.CleanArchitecture

Installation

dotnet new install Wally.CleanArchitecture.Template

Usage

dotnet new wally.cleanarchitecture --output . --name MyCompanyName.MyAppName --serviceName MyServiceName -proxy=true -service=true -frontend=true -storybook=true

Details

Architecture

classDiagram
    class IEntity {
        +Id: Guid
    }
    
    class User {
        +Id: Guid
        +Name: string
        +Email: string
    }
    
    class IRepository {
        +GetById(id: Guid)
        +Add(entity)
    }

    class IUserRepository {
        +GetByEmail(email: string): User
    }
    
    class IUseCase {
        +Execute()
    }
    
    class RegisterUserUseCase {
        +Execute(request: RegisterUserRequest)
    }
    
    class RegisterUserRequest {
        +Name: string
        +Email: string
    }
    
    class EfUserRepository {
        +GetByEmail(email: string): User
    }
    
    class UserController {
        +Register(request: RegisterUserRequest)
    }
    
    User --> IEntity
    IUserRepository <|-- EfUserRepository
    IRepository <|-- IUserRepository
    RegisterUserUseCase --> IUserRepository
    UserController --> RegisterUserUseCase

• .Net 8 WebApi ReverseProxy
  • YARP
• .Net 8 WebApi MicroService
  • AppSettings
  • CORS
  • FluentValidation
  • OAuth2
• Swagger
• Serilog
• HealthChecks
  • UI
  • MicroService endpoint
• MediatR
  • LogBehavior
  • TransactionBehavior
  • ValidatorBehavior (IComamnd, IQuery)
  • DomainEventBehavior
  • NotificationBehavior
  • UpdateMetadataBehavior
  • SoftDeleteBehavior
• MassTransit
  • Azure ServiceBus
  • RabbitMQ
  • Kafka
• Scrutor github
• OData
• HttpGlobalExceptionFilter
• Entity Framework
  • MySql
  • MS Sql
  • PostgreSQL
  • SQLite
  • InMemoryDb
  • Optimistic Concurrency
  • Generic Repository + Specific Repository
• xUnit

  • ApprovalTests

  • IntegrationTests

  • UnitTests

    • NetArchTest

      Issue	Description	Status
      License	https://raw.githubusercontent.com/BenMorris/NetArchTest/refs/heads/master/LICENSE	MIT
      Popularity	https://github.com/BenMorris/NetArchTest/stargazers	>1.5k stars
      .	https://github.com/BenMorris/NetArchTest/forks	>85 forks
      Activity	https://github.com/BenMorris/NetArchTest/activity	last commit 7 months ago
      Issues	https://github.com/BenMorris/NetArchTest/issues	21 Open, 52 Closed
      Frameworks	https://www.nuget.org/packages/NetArchTest.Rules/#supportedframeworks-body-tab	net8.0, net9.0
      Vulnerabilities	https://secure.software/nuget/packages/NetArchTest.Rules/vulnerabilities	0

    • ArchUnitNET

      Issue	Description	Status
      License	https://github.com/TNG/ArchUnitNET/tree/main#Apache-2.0-1-ov-file	Apache-2.0
      Popularity	https://github.com/TNG/ArchUnitNET/stargazers	>990 stars
      .	https://github.com/TNG/ArchUnitNET/forks	>61 forks
      Activity	https://github.com/TNG/ArchUnitNET/activity	last commit 12 min ago
      Issues	https://github.com/TNG/ArchUnitNET/issues	30 Open, 69 Closed
      Frameworks	https://www.nuget.org/packages/TngTech.ArchUnitNET/#supportedframeworks-body-tab	netstandard2.0, netstandard2.1, net8.0, net9.0
      Vulnerabilities	https://secure.software/nuget/packages/TngTech.ArchUnitNET/vulnerabilities	0

  • ConventionTests

  • Verify github

  • [-] FluentAssertions github

  • Shouldly github

• AppInsights Metrics
• OpenTelemetry
• IaC
  • Terraform
  • Bicep
• Mapper
  • [-] Mapster github
  • AutoMapper github
    • Validation
    • Profiles
• SignalR
• GitHub
  • Workflow
• Docker

Info

doc

TODO

• Fix [CS1591] Missing XML comment warnings
• Move CORS settings to ApiGateway
• Authentication in ApiGateway
• Authorization in MicroService
• SignalR Hub Service
• Move Application.Contracts to Presentation layer
• EntityId YT
• Entity Framework Repository GH
• Multitenancy GH
• IRequestContext with CorrelationId + SeriLog.Enrich.CorrelationId 1. 2.
• Graceful Shutdown post