Add Genocs.Persistence.EFCore project and enhancements

- Introduced a new project "Genocs.Persistence.EFCore" in the solution.
- Updated solution configuration and documentation in `Genocs.Common.csproj`.
- Enhanced `MessageAttribute` and `PublicContractAttribute` classes.
- Added MongoDB support in `Program.cs`.
- Changed `UpdatedBy` property type to `DefaultIdType?` in auditing classes.
- Introduced new interfaces for job scheduling and notifications.
- Created `DomainEvent`, `AuditDto`, and `Trail` classes for event handling and logging.
- Implemented connection string validation and security.
- Enhanced database context management and added global query filters.
- Updated `README_NUGET.md` for better documentation.

Author: GioemaNocco

genocs.sln

@@ -133,6 +133,8 @@ Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "Genocs.OpenTelemetry", "src
 EndProject
 Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "Genocs.Core.Demo.HelloWorld", "src\Genocs.Core.Demo.HelloWorld\Genocs.Core.Demo.HelloWorld.csproj", "{D7C394CF-487D-470D-B05C-CC2DD7EC290B}"
 EndProject
+Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "Genocs.Persistence.EFCore", "src\Genocs.Persistence.EFCore\Genocs.Persistence.EFCore.csproj", "{69A6FE21-8FB1-4D4D-8C6B-B18C06EFF2CF}"
+EndProject
 Global
 	GlobalSection(SolutionConfigurationPlatforms) = preSolution
 		Debug|Any CPU = Debug|Any CPU
@@ -307,6 +309,10 @@ Global
 		{D7C394CF-487D-470D-B05C-CC2DD7EC290B}.Debug|Any CPU.Build.0 = Debug|Any CPU
 		{D7C394CF-487D-470D-B05C-CC2DD7EC290B}.Release|Any CPU.ActiveCfg = Release|Any CPU
 		{D7C394CF-487D-470D-B05C-CC2DD7EC290B}.Release|Any CPU.Build.0 = Release|Any CPU
+		{69A6FE21-8FB1-4D4D-8C6B-B18C06EFF2CF}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{69A6FE21-8FB1-4D4D-8C6B-B18C06EFF2CF}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{69A6FE21-8FB1-4D4D-8C6B-B18C06EFF2CF}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{69A6FE21-8FB1-4D4D-8C6B-B18C06EFF2CF}.Release|Any CPU.Build.0 = Release|Any CPU
 	EndGlobalSection
 	GlobalSection(SolutionProperties) = preSolution
 		HideSolutionNode = FALSE

src/Genocs.Common/Genocs.Common.csproj

@@ -7,14 +7,18 @@
         <AssemblyName>Genocs.Common</AssemblyName>
         <Title>The Genocs common components.</Title>
         <Description>The common components to build .NET Core projects along with Genocs Library.</Description>
+        <Summary>The common components to build .NET Core projects along with Genocs Library.</Summary>
         <GeneratePackageOnBuild>true</GeneratePackageOnBuild>
         <MinClientVersion>5.0.0</MinClientVersion>
         <Authors>Nocco Giovanni Emanuele</Authors>
         <PackageTags>microservice microservices solid solid-principles genocs</PackageTags>
         <PackageReadmeFile>README_NUGET.md</PackageReadmeFile>
-        <PackageReleaseNotes>Upgraded to NET9.0</PackageReleaseNotes>
         <EnableNETAnalyzers>True</EnableNETAnalyzers>
         <AnalysisLevel>latest</AnalysisLevel>
+        <PackageReleaseNotes>
+            The change log and breaking changes are listed here.
+            https://github.com/Genocs/genocs-library/releases
+        </PackageReleaseNotes>
     </PropertyGroup>
 
 </Project>

src/Genocs.Common/Interfaces/ICurrentUser.cs

@@ -0,0 +1,39 @@
+using System.Security.Claims;
+
+namespace Genocs.Common.Interfaces;
+
+/// <summary>
+/// The CurrentUser interface.
+/// </summary>
+public interface ICurrentUser
+{
+    /// <summary>
+    /// The user id.
+    /// </summary>
+    string? Name { get; }
+
+    /// <summary>
+    /// Gets the user id.
+    /// </summary>
+    /// <returns>The default Id Type.</returns>
+    DefaultIdType GetUserId();
+
+    string? GetUserEmail();
+
+    string? GetTenant();
+
+    bool IsAuthenticated();
+
+    /// <summary>
+    /// Checks if the user is in a specific role.
+    /// </summary>
+    /// <param name="role">Role to check.</param>
+    /// <returns>True in case of sucesful otherwise False.</returns>
+    bool IsInRole(string role);
+
+    /// <summary>
+    /// Gets the user claims.
+    /// </summary>
+    /// <returns>List of the claims.</returns>
+    IEnumerable<Claim>? GetUserClaims();
+}

src/Genocs.Common/Interfaces/IDto.cs

@@ -0,0 +1,6 @@
+namespace Genocs.Common.Interfaces;
+
+/// <summary>
+/// Interface for DTOs.
+/// </summary>
+public interface IDto;

src/Genocs.Common/Interfaces/IJobService.cs

@@ -0,0 +1,43 @@
+using System.Linq.Expressions;
+
+namespace Genocs.Common.Interfaces;
+
+/// <summary>
+/// Interface for job service.
+/// TODO: This interface is used to define the methods for job scheduling and management.
+/// Will be used in the future.
+/// </summary>
+public interface IJobService : ITransientService
+{
+    string Enqueue(Expression<Action> methodCall);
+
+    string Enqueue(Expression<Func<Task>> methodCall);
+
+    string Enqueue<T>(Expression<Action<T>> methodCall);
+
+    string Enqueue<T>(Expression<Func<T, Task>> methodCall);
+
+    string Schedule(Expression<Action> methodCall, TimeSpan delay);
+
+    string Schedule(Expression<Func<Task>> methodCall, TimeSpan delay);
+
+    string Schedule(Expression<Action> methodCall, DateTimeOffset enqueueAt);
+
+    string Schedule(Expression<Func<Task>> methodCall, DateTimeOffset enqueueAt);
+
+    string Schedule<T>(Expression<Action<T>> methodCall, TimeSpan delay);
+
+    string Schedule<T>(Expression<Func<T, Task>> methodCall, TimeSpan delay);
+
+    string Schedule<T>(Expression<Action<T>> methodCall, DateTimeOffset enqueueAt);
+
+    string Schedule<T>(Expression<Func<T, Task>> methodCall, DateTimeOffset enqueueAt);
+
+    bool Delete(string jobId);
+
+    bool Delete(string jobId, string fromState);
+
+    bool Requeue(string jobId);
+
+    bool Requeue(string jobId, string fromState);
+}

src/Genocs.Common/Interfaces/INotificationSender.cs

@@ -0,0 +1,20 @@
+using Genocs.Common.Notifications;
+
+namespace Genocs.Common.Interfaces;
+
+/// <summary>
+/// This interface is used to send notifications.
+/// </summary>
+public interface INotificationSender : ITransientService
+{
+    Task BroadcastAsync(INotificationMessage notification, CancellationToken cancellationToken);
+    Task BroadcastAsync(INotificationMessage notification, IEnumerable<string> excludedConnectionIds, CancellationToken cancellationToken);
+
+    Task SendToAllAsync(INotificationMessage notification, CancellationToken cancellationToken);
+    Task SendToAllAsync(INotificationMessage notification, IEnumerable<string> excludedConnectionIds, CancellationToken cancellationToken);
+    Task SendToGroupAsync(INotificationMessage notification, string group, CancellationToken cancellationToken);
+    Task SendToGroupAsync(INotificationMessage notification, string group, IEnumerable<string> excludedConnectionIds, CancellationToken cancellationToken);
+    Task SendToGroupsAsync(INotificationMessage notification, IEnumerable<string> groupNames, CancellationToken cancellationToken);
+    Task SendToUserAsync(INotificationMessage notification, string userId, CancellationToken cancellationToken);
+    Task SendToUsersAsync(INotificationMessage notification, IEnumerable<string> userIds, CancellationToken cancellationToken);
+}

src/Genocs.Common/Interfaces/IScopedService.cs

@@ -0,0 +1,6 @@
+namespace Genocs.Common.Interfaces;
+
+/// <summary>
+/// Interface for scoped services.
+/// </summary>
+public interface IScopedService;

src/Genocs.Common/Interfaces/ISerializerService.cs

@@ -0,0 +1,19 @@
+namespace Genocs.Common.Interfaces;
+
+/// <summary>
+/// It is used to serialize and deserialize objects.
+/// </summary>
+public interface ISerializerService : ITransientService
+{
+    /// <summary>
+    /// The method is used to serialize an object.
+    /// </summary>
+    /// <typeparam name="T">The type of object to serialize.</typeparam>
+    /// <param name="obj">Instance of object to serialize.</param>
+    /// <returns></returns>
+    string Serialize<T>(T obj);
+
+    string Serialize<T>(T obj, Type type);
+
+    T Deserialize<T>(string text);
+}

src/Genocs.Common/Interfaces/ITransientService.cs

@@ -0,0 +1,6 @@
+namespace Genocs.Common.Interfaces;
+
+/// <summary>
+/// It is used to mark the service as a transient service.
+/// </summary>
+public interface ITransientService;

src/Genocs.Common/Notifications/BasicNotification.cs

@@ -0,0 +1,16 @@
+namespace Genocs.Common.Notifications;
+
+public class BasicNotification : INotificationMessage
+{
+    public enum LabelType
+    {
+        Information,
+        Success,
+        Warning,
+        Error
+    }
+
+    public string? Message { get; set; }
+
+    public LabelType Label { get; set; }
+}