NextHelios.FiscalCalendar.Data 1.0.0

NextHelios.FiscalCalendar.Data

Librairie partagée .NET pour les microservices de l'écosystème NextHelios.
Standardise la vérification d'autorisation d'écriture comptable via le calendrier fiscal centralisé (MSComptabilite).

C'est une librairie NuGet légère que chaque microservice importe pour poser une seule question avant de poster une écriture :

"Est-ce que j'ai le droit d'écrire en base pour ce tenant, à cette date, pour cette activité ?"

Ce qu'elle fournit concrètement Une seule méthode principale :

Task<FiscalCalendarAuthorizationResult> CheckAuthorizationAsync( Guid tenantId, DateOnly date, string activity // "PRODUCTION", "CLAIM" ou "ACCOUNTING" ); Un résultat structuré :

result.IsAuthorized // true ou false result.Reason // pourquoi c'est refusé (null si autorisé) result.PeriodCode // "202605" result.PeriodStatus // "OPEN" result.ActivityStatus // "OPEN" // + calendarId, periodId, dates... Ce qu'elle vérifie en interne (la cascade)

tenantId + date + activity │ ▼

1. Existe-t-il un calendrier ACTIVE ? → Non → refusé │ ▼
2. Y a-t-il une période couvrant la date ? → Non → refusé │ ▼
3. Cette période est-elle OPEN ? → Non → refusé (CLOSED, LOCKED…) │ ▼
4. L'activité est-elle OPEN ? → Non → refusé (activité fermée) │ ▼ ✅ Autorisé

Fonctionnalités

• Vérification en cascade : calendrier ACTIVE → période OPEN → activité OPEN.
• Retourne toujours un résultat structuré (FiscalCalendarAuthorizationResult) — jamais d'exception métier.
• Support de trois activités : PRODUCTION, CLAIM, ACCOUNTING.
• Filtrage automatique des enregistrements supprimés (IsDeleted = 0).
• Configuration simple via IServiceCollection (deux surcharges).

Installation

dotnet add reference ../NextHelios.FiscalCalendar.Data/NextHelios.FiscalCalendar.Data.csproj
# ou via NuGet (une fois publié) :
dotnet add package NextHelios.FiscalCalendar.Data

Configuration

Option 1 — via appsettings.json

// appsettings.json
{
  "ConnectionStrings": {
    "FiscalCalendarDb": "Server=...;Database=MSComptabilite;..."
  }
}

// Program.cs
builder.Services.AddFiscalCalendarDatabase(builder.Configuration);

Option 2 — Configuration manuelle

builder.Services.AddFiscalCalendarDatabase(options =>
{
    options.ConnectionString = "Server=...;Database=MSComptabilite;...";
});

Utilisation

public class ProductionService(IFiscalCalendarDatabaseService fiscalCalendar)
{
    public async Task PostEntryAsync(Guid tenantId, DateOnly date, decimal amount)
    {
        var auth = await fiscalCalendar.CheckAuthorizationAsync(
            tenantId, date, "PRODUCTION");

        if (!auth.IsAuthorized)
            throw new InvalidOperationException($"Écriture refusée : {auth.Reason}");

        // ... logique de saisie
    }
}

Tables SQL requises (base MSComptabilite)

Les valeurs de Status sont les chaînes : DRAFT, ACTIVE, OPEN, CLOSED, LOCKED, CANCELLED.
Les valeurs de Activity sont : PRODUCTION, CLAIM, ACCOUNTING.

NextHelios Team — 2026