🚀 AppProject – .NET Enterprise Template

🇧🇷 Português

📌 Sobre o Projeto

Este projeto é um template corporativo moderno em .NET, estruturado com separação clara entre camadas e foco em escalabilidade, organização e testabilidade.

Foi projetado como base reutilizável para aplicações empresariais robustas.

🏗 Visão Geral da Arquitetura

Cliente (Browser/Mobile)
        ↓
Frontend (Blazor)
        ↓
Refit (DTOs)
        ↓
Controllers (API)
        ↓
Services (Regras de Negócio)
        ↓
Infrastructure (Banco, Email, Jobs, IA)
        ↓
Resposta

🔹 Frontend

• Blazor
• Auth0
• Radzen
• Refit
• Internacionalização (.resx)
• Estrutura modular

🔹 Backend

• ASP.NET Core Web API
• Controllers REST
• Camada de Services
• Validações centralizadas
• Tratamento global de exceções
• Cache híbrido
• Swagger

🧱 Estrutura da Solução

🌍 Projetos Globais

• AppProject.Exceptions
• AppProject.Models
• AppProject.Resources
• AppProject.Utils

🟢 Backend

• AppProject.Core.API
• AppProject.Core.Services.<Module>
• AppProject.Core.Contracts
• AppProject.Core.Controllers.<Module>
• AppProject.Core.Infrastructure.Database
• AppProject.Core.Infrastructure.Email
• AppProject.Core.Infrastructure.Jobs
• AppProject.Core.Infrastructure.AI
• AppProject.Core.Models.<Module>

🟣 Frontend

• AppProject.Web
• AppProject.Web.Framework
• AppProject.Web.ApiClient.<Module>
• AppProject.Web.Models.<Module>
• AppProject.Web.Shared
• AppProject.Web.<Module>

🧪 Testes

• AppProject.Core.Tests.<Module>
• AppProject.Web.Tests.<Module>

🛠 Tecnologias

🔷 Core

🗄 Banco de Dados

🔐 Autenticação

🔄 Comunicação com a API

📊 Logs e Qualidade de Código

📬 Serviços Externos

🧪 Testes Automatizados

🧠 Princípios Arquiteturais

• Separação de responsabilidades
• Inversão de dependência
• Modularização por domínio
• Abstração de infraestrutura
• DTOs isolados por camada
• Estratégia de cache híbrido
• Internacionalização
• Alta testabilidade

🚧 Status

🟡 Em desenvolvimento
✔ Estrutura base concluída
🔄 Implementação de módulos em andamento

---

🇺🇸 English

📌 About

This project is a modern enterprise .NET template, designed with clear layer separation, scalability and maintainability in mind.

It serves as a reusable foundation for robust business applications.

🏗 Architecture Overview

Client (Browser/Mobile)
        ↓
Frontend (Blazor)
        ↓
Refit (DTO Contracts)
        ↓
Controllers (API Layer)
        ↓
Services (Business Rules)
        ↓
Infrastructure (Database, Email, Jobs, AI)
        ↓
Response

🔹 Frontend

• Blazor
• Auth0
• Radzen UI Components
• Refit
• Internationalization (.resx)
• Modular structure

🔹 Backend

• ASP.NET Core Web API
• REST Controllers
• Service Layer
• Centralized validations
• Global exception handling
• Hybrid cache strategy
• Swagger documentation

🧱 Solution Structure

🌍 Global Projects

• AppProject.Exceptions
• AppProject.Models
• AppProject.Resources
• AppProject.Utils

🟢 Backend

• AppProject.Core.API
• AppProject.Core.Services.<Module>
• AppProject.Core.Contracts
• AppProject.Core.Controllers.<Module>
• AppProject.Core.Infrastructure.Database
• AppProject.Core.Infrastructure.Email
• AppProject.Core.Infrastructure.Jobs
• AppProject.Core.Infrastructure.AI
• AppProject.Core.Models.<Module>

🟣 Frontend

• AppProject.Web
• AppProject.Web.Framework
• AppProject.Web.ApiClient.<Module>
• AppProject.Web.Models.<Module>
• AppProject.Web.Shared
• AppProject.Web.<Module>

🧪 Tests

• AppProject.Core.Tests.<Module>
• AppProject.Web.Tests.<Module>

🛠 Technologies

🔷 Core

🗄 Database

🔐 Authentication

🔄 API Communication

📊 Logging & Code Quality

📬 External Services

🧪 Testing Stack

🧠 Architectural Principles

• Separation of concerns
• Dependency inversion
• Modular domain organization
• Infrastructure abstraction
• Layer-isolated DTOs
• Hybrid caching
• Internationalization
• High testability

---

🚧 Status

🟡 In development
✔ Base architecture completed
🔄 Domain modules under construction

---

👨‍💻 Author

Lucas Silva
FullStack Developer
.NET • Blazor • ASP.NET Core • SQL Server