How nitin27may/clean-architecture-docker-dotnet-angular works
Project Type and Purpose
• The project is a full-stack application following Clean Architecture. Its purpose is to serve as a boilerplate for rapid application development featuring user registration, JWT-based authentication and role-based access control, as well as CRUD operations for contacts.
• The README highlights that the application is designed with modularity, scalability, and maintainability in mind using a layered approach.
& List Main Components
a. Frontend:
• Built with Angular 19.
• Supports Server Side Rendering (SSR) via Node (as suggested by the NodeJS-based Dockerfile used for angular production).
• Contains UI components, HTTP interceptors (e.g., JWT and error handling), guards, and services that interact with the backend API.
b. Backend API:
• Developed in .NET 9 with Clean Architecture principles.
• Contains distinct layers: API Controllers, Application Services (business logic, mappings, use cases), Domain Entities/Interfaces (core business models and exceptions), and Infrastructure (persistence using Dapper, repositories, external service integrations like SMTP).
• Implements essential functionalities such as authentication, role-based API access, middleware for exceptions and activity logging.
c. Database:
• MS SQL Server container (with a Dockerfile provided in the mssql folder).
• Contains seeded data (as per the seed-data.sql script) for users with different roles.
d. Load Balancer:
• Implemented using NGINX (configured under the loadbalancer directory) which likely routes and distributes requests across the containers.
e. Docker & CI/CD Infrastructure:
• Docker Compose orchestration using multiple Dockerfiles (for development and production in both frontend and backend).
• GitHub Actions workflows for building the Angular app, .NET API, and load balancer container.
Architectural Patterns & Technologies
• Use of Dapper for lightweight ORM and AutoMapper for DTO mapping in the Application layer.
• Technologies per component:
• Angular 19, Bootstrap, SSR via NodeJS for Frontend.
• .NET 9 for APIs, JWT-based Authentication, FluentValidation.
• MS SQL for persistence.
• Docker (Docker Compose orchestration), NGINX for load balancing.