Egov.Fod.ServiceComponents 10.0.3

Fod.ServiceComponents

Blazor component library for FOD public service request workflows. Provides reusable wizard orchestration, requestor/beneficiary data collection, apostillation, delivery, payment, and document attachment components.

Features

• Wizard orchestration — Step-based workflow engine with validation, save, and navigation
• Requestor & Beneficiary — Data collection components for natural/legal persons
• Apostillation — Country selection, pricing, date calculation, and availability checks with built-in caching
• Attachments — Document upload and management components
• Delivery & Reception — Delivery method selection and reception mode handling
• Payment — Payment integration components
• Confirmation — Order summary and confirmation step
• Error handling — Resilient error handler with privacy filtering, queuing, and tracking
• Localization — Built-in support for Romanian (ro) and Russian (ru)

Installation

dotnet add package Egov.FOD.ServiceComponents

Or via the NuGet Package Manager:

Install-Package Egov.FOD.ServiceComponents

Configuration

Register services in your Program.cs:

using Fod.ServiceComponents.Services;

builder.Services.AddApostillationServices();
builder.Services.AddMemoryCache();

Usage

Create a Wizard Step

public class RequestorStep : WizardStepBase
{
    public override string StepId => "requestor";
    public override string StepTitle => "Requestor Information";

    public override async Task<ValidationResult> ValidateAsync()
    {
        var result = new ValidationResult();
        if (string.IsNullOrEmpty(Model.Name))
            result.AddError("Name", "Name is required");
        return result;
    }

    public override async Task<SaveResult> SaveAsync()
    {
        return SaveResult.Successful(Model);
    }
}

Configure Wizard Steps

var steps = new List<WizardStep>
{
    new() { StepId = "requestor", Title = "Requestor", ComponentType = typeof(RequestorStep), Order = 1 },
    new() { StepId = "beneficiary", Title = "Beneficiary", ComponentType = typeof(BeneficiaryStep), Order = 2 },
    new() { StepId = "attachments", Title = "Documents", ComponentType = typeof(AttachmentsStep), Order = 3, IsOptional = true }
};

Use Cached Apostillation Service

// The CachedApostillationService wraps any IApostillationService with memory caching
builder.Services.AddSingleton<IApostillationService, CachedApostillationService>();

// Inject and use
@inject IApostillationService ApostillationService

var countries = await ApostillationService.GetCountriesAsync();

Key Interfaces

Project Structure

Fod.ServiceComponents/          # Main Razor class library
Fod.ServiceComponents.Tests/    # Unit tests (xUnit + bUnit + Moq)
Fod.Services/                   # Service endpoints

Build & Test

# Restore
dotnet restore Fod.ServiceComponents.slnx

# Build
dotnet build Fod.ServiceComponents.slnx

# Run tests
dotnet test Fod.ServiceComponents.slnx

# Pack for NuGet
dotnet pack Fod.ServiceComponents/Fod.ServiceComponents.csproj -c Release

# Format code
dotnet format Fod.ServiceComponents.slnx

Requirements

• .NET 10
• Blazor
• Egov.Fod.ServiceModels
• Egov.FOD.UIComponents

Contributing

See CONTRIBUTING.md for guidelines.

License

This project is licensed under the MIT License — see the LICENSE file for details.