The system follows a microservices architecture with clear separation of concerns:
1. EGU.PartnerPortal.Web - Blazor WebAssembly frontend
2. EGU.PartnerPortal.ApiService - Core business API
3. EGU.PartnerPortal.IntegrationServiceAPI - External system integration
4. EGU.PartnerPortal.AppHost - .NET Aspire orchestration
5. EGU.PartnerPortal.Shared - Common utilities and DTOs
6. EGU.PartnerPortal.ServiceDefaults - Shared service configurations
Service-Oriented Architecture
- Layer Structure
┌─────────────────┐
│ Presentation │ ← Blazor Components, Pages
├─────────────────┤
│ Application │ ← Controllers, API Services
├─────────────────┤
│ Business │ ← Validation, Mapping, Domain Logic
├─────────────────┤
│ Data Access │ ← Entity Framework, DbContext
├─────────────────┤
│ Integration │ ← External API Services, SOAP
└─────────────────┘
- Dependency Injection Pattern
// Service Registration Example (Program.cs)
builder.Services.AddScoped<IWorkOrderApiService, WorkOrderApiService>();
builder.Services.AddScoped<IWorkOrderValidationService, WorkOrderValidationService>();
builder.Services.AddScoped<IWorkOrderMapperService, WorkOrderMapperService>();
- Project Structure
Services/
├── WorkOrder/
│ ├── ApiServices/
│ │ ├── WorkOrderApiService.cs
│ │ └── Interfaces/
│ │ └── IWorkOrderApiService.cs
│ ├── ValidationServices/
│ │ ├── WorkOrderValidationService.cs
│ │ └── Interfaces/
│ │ └── IWorkOrderValidationService.cs
│ └── MapperServices/
│ ├── WorkOrderMapperService.cs
│ └── Interfaces/
│ └── IWorkOrderMapperService.cs
- Constructor Dependency Injection
public class WorkOrderApiService : IWorkOrderApiService
{
private readonly DatabaseContext _dbContext;
private readonly IWorkOrderValidationService _workOrderValidationService;
private readonly IWorkOrderMapperService _workOrderMapperService;
private readonly IHttpClientFactory _httpClientFactory;
public WorkOrderApiService(
DatabaseContext dbContext,
IWorkOrderValidationService workOrderValidationService,
IWorkOrderMapperService workOrderMapperService,
IHttpClientFactory httpClientFactory)
{
_dbContext = dbContext;
_workOrderValidationService = workOrderValidationService;
_workOrderMapperService = workOrderMapperService;
_httpClientFactory = httpClientFactory;
}
}
- Async/Await Pattern
All service methods must be asynchronous:
// ✅ Good - Consistent async pattern
public async Task<WorkOrderFormResponse?> CreateWorkOrder(WorkOrderCreateRequest request)
{
await _workOrderValidationService.ValidateRegistrationRequest(request.RegistrationCreateRequest);
var workOrder = await _workOrderMapperService.MapperWorkOrder(request.RegistrationCreateRequest);
_dbContext.WorkOrder.Add(workOrder);
await _dbContext.SaveChangesAsync();
return await GetWorkOrderForm(workOrder.ID);
}
// ❌ Bad - Mixing sync and async
public WorkOrderFormResponse CreateWorkOrder(WorkOrderCreateRequest request)
{
var result = ValidateRegistrationRequest(request.RegistrationCreateRequest).Result;
// Causes deadlocks and blocking
}