Add base Postgres user entity and UserRole enum

Introduced BasePostgresUser class with identity, contact, preferences, permissions, and role properties, mapped for PostgreSQL with EF Core. Added UserRole enum for role-based access control. Updated project references for shared models and cleaned up unused usings.

Author: Vadim Belov

Sources/EasyExtensions.EntityFrameworkCore.Npgsql/Database/BaseUser.cs

@@ -0,0 +1,116 @@
+using EasyExtensions.EntityFrameworkCore.Abstractions;
+using EasyExtensions.Models.Enums;
+using Microsoft.EntityFrameworkCore;
+using System.ComponentModel.DataAnnotations.Schema;
+using System.Text;
+
+namespace EasyExtensions.EntityFrameworkCore.Npgsql.Database
+{
+    /// <summary>
+    /// Represents a base user account with identity, contact, and profile information.
+    /// </summary>
+    /// <remarks>This class provides common user properties for authentication, authorization, and
+    /// personalization scenarios. It is intended to be used as a base type for user entities in applications that
+    /// require user management. The class enforces unique email addresses and supports user preferences, permissions,
+    /// and role-based access control.</remarks>
+    [Table("users")]
+    [Index(nameof(Email), IsUnique = true)]
+    public class BasePostgresUser : BaseEntity<Guid>
+    {
+        /// <summary>
+        /// Gets the full name, consisting of the first and last name combined with a space.
+        /// </summary>
+        [NotMapped]
+        public string FullName => GetFullName();
+
+        private string GetFullName()
+        {
+            var sb = new StringBuilder();
+            sb.Append(FirstName);
+            if (!string.IsNullOrWhiteSpace(MiddleName))
+            {
+                sb.Append(' ').Append(MiddleName);
+            }
+            sb.Append(' ').Append(LastName);
+            return sb.ToString().Trim();
+        }
+
+        /// <summary>
+        /// Gets or sets the first name of the person.
+        /// </summary>
+        [Column("first_name", TypeName = "citext")]
+        public string FirstName { get; set; } = null!;
+
+        /// <summary>
+        /// Gets or sets the middle name of the person.
+        /// </summary>
+        [Column("middle_name", TypeName = "citext")]
+        public string? MiddleName { get; set; } = null!;
+
+        /// <summary>
+        /// Gets or sets the last name of the person.
+        /// </summary>
+        [Column("last_name", TypeName = "citext")]
+        public string LastName { get; set; } = null!;
+
+        /// <summary>
+        /// Gets or sets the avatar image data in WebP format.
+        /// </summary>
+        [Column("avatar_webp_bytes")]
+        public byte[]? AvatarWebPBytes { get; set; }
+
+        /// <summary>
+        /// Gets or sets the email address associated with the entity.
+        /// </summary>
+        [Column("email", TypeName = "citext")]
+        public string Email { get; set; } = null!;
+
+        /// <summary>
+        /// Gets or sets the phone number associated with the entity.
+        /// </summary>
+        [Column("phone_number")]
+        public long? PhoneNumber { get; set; }
+
+        /// <summary>
+        /// Gets or sets the collection of user preferences as key-value pairs.
+        /// </summary>
+        /// <remarks>Each entry in the dictionary represents a user preference, where the key is the
+        /// preference name and the value is its corresponding setting. Preference names and values are case-sensitive.
+        /// Modifying this collection updates the user's stored preferences.</remarks>
+        [Column("preferences")]
+        public Dictionary<string, string> Preferences { get; set; } = [];
+
+        /// <summary>
+        /// Gets or sets the collection of permissions assigned to the entity.
+        /// </summary>
+        [Column("permissions")]
+        public ICollection<string> Permissions { get; set; } = [];
+
+        /// <summary>
+        /// Gets or sets a value indicating whether the entity is active.
+        /// </summary>
+        [Column("is_active")]
+        public bool IsActive { get; set; } = true;
+
+        /// <summary>
+        /// Gets or sets the password hash in PHC (Password Hashing Competition) string format.
+        /// </summary>
+        /// <remarks>The value is typically a string produced by a password hashing algorithm that follows
+        /// the PHC string format, which includes information about the algorithm, parameters, salt, and hash. This
+        /// property may be null if no password is set.</remarks>
+        [Column("password_phc")]
+        public string? PasswordPhc { get; set; }
+
+        /// <summary>
+        /// Gets or sets the role assigned to the user.
+        /// </summary>
+        [Column("role")]
+        public UserRole Role { get; set; }
+
+        /// <summary>
+        /// Gets or sets the token used to authorize a password reset request for the user.
+        /// </summary>
+        [Column("reset_password_token", TypeName = "citext")]
+        public string? ResetPasswordToken { get; set; }
+    }
+}

Sources/EasyExtensions.EntityFrameworkCore.Npgsql/EasyExtensions.EntityFrameworkCore.Npgsql.csproj

@@ -34,6 +34,7 @@
 		<PackageReference Include="Microsoft.SourceLink.GitHub" Version="8.0.0" PrivateAssets="All" />
 	</ItemGroup>
 	<ItemGroup>
+	  <ProjectReference Include="..\EasyExtensions.EntityFrameworkCore\EasyExtensions.EntityFrameworkCore.csproj" />
 	  <ProjectReference Include="..\EasyExtensions\EasyExtensions.csproj" />
 	</ItemGroup>
 </Project>

Sources/EasyExtensions.EntityFrameworkCore.Npgsql/Providers/PostgresConnectionStringProvider.cs

@@ -2,9 +2,6 @@
 using EasyExtensions.EntityFrameworkCore.Npgsql.Builders;
 using Microsoft.Extensions.Configuration;
 using Npgsql;
-using System;
-using System.Collections.Generic;
-using System.Text;
 
 namespace EasyExtensions.EntityFrameworkCore.Npgsql.Providers
 {

Sources/EasyExtensions/Models/Enums/UserRole.cs

@@ -0,0 +1,28 @@
+namespace EasyExtensions.Models.Enums
+{
+    /// <summary>
+    /// Specifies the set of roles that can be assigned to a user within the system.
+    /// </summary>
+    /// <remarks>Use this enumeration to define user permissions and access levels. The roles represent
+    /// increasing levels of responsibility and access, from standard users to administrators. The meaning and usage of
+    /// the 'Custom' role may vary depending on application-specific requirements.</remarks>
+    public enum UserRole
+    {
+        /// <summary>
+        /// Indicates that the value is unknown or not specified.
+        /// </summary>
+        /// <remarks>Use this value when the actual value cannot be determined or is not applicable. This
+        /// is typically used as a default or placeholder value.</remarks>
+        Unknown = 1,
+
+        /// <summary>
+        /// Represents a standard user account with typical permissions and access rights.
+        /// </summary>
+        User = 2,
+
+        /// <summary>
+        /// Specifies an administrator role with elevated permissions.
+        /// </summary>
+        Admin = 4,
+    }
+}