refactor: ♻️ 框架&业务代码分离 (#185)

Co-authored-by: tk <fiyne1a@dingtalk.com>

src/backend/NetAdmin.Domain/DbMaps/Dependency/Fields/IFieldModifiedUser.cs

@@ -1,7 +1,7 @@
 namespace NetAdmin.Domain.DbMaps.Dependency.Fields;
 
 /// <summary>
-///     更新用户字段接口
+///     修改用户字段接口
 /// </summary>
 public interface IFieldModifiedUser
 {

src/backend/NetAdmin.Domain/DbMaps/Dependency/Fields/IFieldSummary.cs

@@ -1,12 +1,12 @@
 namespace NetAdmin.Domain.DbMaps.Dependency.Fields;
 
 /// <summary>
-///     描述字段接口
+///     备注字段接口
 /// </summary>
 public interface IFieldSummary
 {
     /// <summary>
-    ///     描述
+    ///     备注
     /// </summary>
     string Summary { get; init; }
 }

src/backend/NetAdmin.Domain/DbMaps/Dependency/ImmutableEntity.cs

@@ -3,7 +3,9 @@ namespace NetAdmin.Domain.DbMaps.Dependency;
 /// <inheritdoc />
 public abstract record ImmutableEntity : ImmutableEntity<long>
 {
-    /// <inheritdoc cref="EntityBase{T}.Id" />
+    /// <summary>
+    ///     唯一编码
+    /// </summary>
     [Column(IsIdentity = false, IsPrimary = true, Position = 1)]
     [CsvIgnore]
     [Snowflake]
@@ -17,19 +19,25 @@ public abstract record ImmutableEntity : ImmutableEntity<long>
 public abstract record ImmutableEntity<T> : LiteImmutableEntity<T>, IFieldCreatedUser
     where T : IEquatable<T>
 {
-    /// <inheritdoc cref="IFieldCreatedUser.CreatedUserId" />
+    /// <summary>
+    ///     创建者编号
+    /// </summary>
     [Column(CanUpdate = false, Position = -1)]
     [CsvIgnore]
     [JsonIgnore]
     public long? CreatedUserId { get; init; }
 
-    /// <inheritdoc cref="IFieldCreatedUser.CreatedUserName" />
+    /// <summary>
+    ///     创建者用户名
+    /// </summary>
     [Column(DbType = Chars.FLG_DB_FIELD_TYPE_VARCHAR_31, CanUpdate = false, Position = -1)]
     [CsvIgnore]
     [JsonIgnore]
     public virtual string CreatedUserName { get; init; }
 
-    /// <inheritdoc cref="EntityBase{T}.Id" />
+    /// <summary>
+    ///     唯一编码
+    /// </summary>
     [Column(IsIdentity = false, IsPrimary = true, Position = 1)]
     [CsvIgnore]
     public override T Id { get; init; }

src/backend/NetAdmin.Domain/DbMaps/Dependency/LiteImmutableEntity.cs

@@ -3,7 +3,9 @@ namespace NetAdmin.Domain.DbMaps.Dependency;
 /// <inheritdoc />
 public abstract record LiteImmutableEntity : LiteImmutableEntity<long>
 {
-    /// <inheritdoc cref="EntityBase{T}.Id" />
+    /// <summary>
+    ///     唯一编码
+    /// </summary>
     [Column(IsIdentity = false, IsPrimary = true, Position = 1)]
     [CsvIgnore]
     [Snowflake]
@@ -17,13 +19,17 @@ public abstract record LiteImmutableEntity : LiteImmutableEntity<long>
 public abstract record LiteImmutableEntity<T> : EntityBase<T>, IFieldCreatedTime
     where T : IEquatable<T>
 {
-    /// <inheritdoc cref="IFieldCreatedTime.CreatedTime" />
+    /// <summary>
+    ///     创建时间
+    /// </summary>
     [Column(ServerTime = DateTimeKind.Local, CanUpdate = false, Position = -1)]
     [CsvIgnore]
     [JsonIgnore]
     public virtual DateTime CreatedTime { get; init; }
 
-    /// <inheritdoc cref="EntityBase{T}.Id" />
+    /// <summary>
+    ///     唯一编码
+    /// </summary>
     [Column(IsIdentity = false, IsPrimary = true, Position = 1)]
     [CsvIgnore]
     [JsonIgnore]

src/backend/NetAdmin.Domain/DbMaps/Dependency/LiteMutableEntity.cs

@@ -3,7 +3,9 @@ namespace NetAdmin.Domain.DbMaps.Dependency;
 /// <inheritdoc />
 public abstract record LiteMutableEntity : LiteMutableEntity<long>
 {
-    /// <inheritdoc cref="EntityBase{T}.Id" />
+    /// <summary>
+    ///     唯一编码
+    /// </summary>
     [Column(IsIdentity = false, IsPrimary = true, Position = 1)]
     [CsvIgnore]
     [Snowflake]
@@ -16,12 +18,16 @@ public abstract record LiteMutableEntity : LiteMutableEntity<long>
 public abstract record LiteMutableEntity<T> : LiteImmutableEntity<T>, IFieldModifiedTime
     where T : IEquatable<T>
 {
-    /// <inheritdoc cref="EntityBase{T}.Id" />
+    /// <summary>
+    ///     唯一编码
+    /// </summary>
     [Column(IsIdentity = false, IsPrimary = true, Position = 1)]
     [CsvIgnore]
     public override T Id { get; init; }
 
-    /// <inheritdoc cref="IFieldModifiedTime.ModifiedTime" />
+    /// <summary>
+    ///     修改时间
+    /// </summary>
     [Column(ServerTime = DateTimeKind.Local, CanInsert = false, Position = -1)]
     [CsvIgnore]
     [JsonIgnore]

src/backend/NetAdmin.Domain/DbMaps/Dependency/LiteVersionEntity.cs

@@ -3,7 +3,9 @@ namespace NetAdmin.Domain.DbMaps.Dependency;
 /// <inheritdoc />
 public abstract record LiteVersionEntity : LiteVersionEntity<long>
 {
-    /// <inheritdoc cref="EntityBase{T}.Id" />
+    /// <summary>
+    ///     唯一编码
+    /// </summary>
     [Column(IsIdentity = false, IsPrimary = true, Position = 1)]
     [CsvIgnore]
     [Snowflake]
@@ -16,13 +18,17 @@ public abstract record LiteVersionEntity : LiteVersionEntity<long>
 public abstract record LiteVersionEntity<T> : LiteMutableEntity<T>, IFieldVersion
     where T : IEquatable<T>
 {
-    /// <inheritdoc cref="EntityBase{T}.Id" />
+    /// <summary>
+    ///     唯一编码
+    /// </summary>
     [Column(IsIdentity = false, IsPrimary = true, Position = 1)]
     [CsvIgnore]
     [Snowflake]
     public override T Id { get; init; }
 
-    /// <inheritdoc cref="IFieldVersion.Version" />
+    /// <summary>
+    ///     数据版本
+    /// </summary>
     [Column(IsVersion = true, Position = -1)]
     [CsvIgnore]
     [JsonIgnore]

src/backend/NetAdmin.Domain/DbMaps/Dependency/MutableEntity.cs

@@ -3,7 +3,9 @@ namespace NetAdmin.Domain.DbMaps.Dependency;
 /// <inheritdoc />
 public abstract record MutableEntity : MutableEntity<long>
 {
-    /// <inheritdoc cref="EntityBase{T}.Id" />
+    /// <summary>
+    ///     唯一编码
+    /// </summary>
     [Column(IsIdentity = false, IsPrimary = true, Position = 1)]
     [CsvIgnore]
     [Snowflake]
@@ -16,30 +18,40 @@ public abstract record MutableEntity : MutableEntity<long>
 public abstract record MutableEntity<T> : LiteMutableEntity<T>, IFieldCreatedUser, IFieldModifiedUser
     where T : IEquatable<T>
 {
-    /// <inheritdoc />
+    /// <summary>
+    ///     创建者编号
+    /// </summary>
     [Column(CanUpdate = false, Position = -1)]
     [CsvIgnore]
     [JsonIgnore]
     public virtual long? CreatedUserId { get; init; }
 
-    /// <inheritdoc />
+    /// <summary>
+    ///     创建者用户名
+    /// </summary>
     [Column(DbType = Chars.FLG_DB_FIELD_TYPE_VARCHAR_31, CanUpdate = false, Position = -1)]
     [CsvIgnore]
     [JsonIgnore]
     public virtual string CreatedUserName { get; init; }
 
-    /// <inheritdoc cref="EntityBase{T}.Id" />
+    /// <summary>
+    ///     唯一编码
+    /// </summary>
     [Column(IsIdentity = false, IsPrimary = true, Position = 1)]
     [CsvIgnore]
     public override T Id { get; init; }
 
-    /// <inheritdoc cref="IFieldModifiedUser.ModifiedUserId" />
+    /// <summary>
+    ///     修改者编号
+    /// </summary>
     [Column(CanInsert = false, Position = -1)]
     [CsvIgnore]
     [JsonIgnore]
     public long? ModifiedUserId { get; init; }
 
-    /// <inheritdoc cref="IFieldModifiedUser.ModifiedUserName" />
+    /// <summary>
+    ///     修改者用户名
+    /// </summary>
     [Column(DbType = Chars.FLG_DB_FIELD_TYPE_VARCHAR_31, CanInsert = false, Position = -1)]
     [CsvIgnore]
     [JsonIgnore]

src/backend/NetAdmin.Domain/DbMaps/Dependency/SimpleEntity.cs

@@ -3,7 +3,9 @@ namespace NetAdmin.Domain.DbMaps.Dependency;
 /// <inheritdoc />
 public abstract record SimpleEntity : SimpleEntity<long>
 {
-    /// <inheritdoc cref="EntityBase{T}.Id" />
+    /// <summary>
+    ///     唯一编码
+    /// </summary>
     [Column(IsIdentity = false, IsPrimary = true, Position = 1)]
     [CsvIgnore]
     [Snowflake]

src/backend/NetAdmin.Domain/DbMaps/Dependency/VersionEntity.cs

@@ -3,7 +3,9 @@ namespace NetAdmin.Domain.DbMaps.Dependency;
 /// <inheritdoc />
 public abstract record VersionEntity : VersionEntity<long>
 {
-    /// <inheritdoc cref="EntityBase{T}.Id" />
+    /// <summary>
+    ///     唯一编码
+    /// </summary>
     [Column(IsIdentity = false, IsPrimary = true, Position = 1)]
     [CsvIgnore]
     [Snowflake]
@@ -16,30 +18,40 @@ public abstract record VersionEntity : VersionEntity<long>
 public abstract record VersionEntity<T> : LiteVersionEntity<T>, IFieldModifiedUser, IFieldCreatedUser
     where T : IEquatable<T>
 {
-    /// <inheritdoc />
+    /// <summary>
+    ///     创建者编号
+    /// </summary>
     [Column(CanUpdate = false, Position = -1)]
     [CsvIgnore]
     [JsonIgnore]
     public virtual long? CreatedUserId { get; init; }
 
-    /// <inheritdoc />
+    /// <summary>
+    ///     创建者用户名
+    /// </summary>
     [Column(DbType = Chars.FLG_DB_FIELD_TYPE_VARCHAR_31, CanUpdate = false, Position = -1)]
     [CsvIgnore]
     [JsonIgnore]
     public virtual string CreatedUserName { get; init; }
 
-    /// <inheritdoc cref="EntityBase{T}.Id" />
+    /// <summary>
+    ///     唯一编码
+    /// </summary>
     [Column(IsIdentity = false, IsPrimary = true, Position = 1)]
     [CsvIgnore]
     public override T Id { get; init; }
 
-    /// <inheritdoc cref="IFieldModifiedUser.ModifiedUserId" />
+    /// <summary>
+    ///     修改者编号
+    /// </summary>
     [Column(CanInsert = false, Position = -1)]
     [CsvIgnore]
     [JsonIgnore]
     public virtual long? ModifiedUserId { get; init; }
 
-    /// <inheritdoc cref="IFieldModifiedUser.ModifiedUserName" />
+    /// <summary>
+    ///     修改者用户名
+    /// </summary>
     [Column(DbType = Chars.FLG_DB_FIELD_TYPE_VARCHAR_31, CanInsert = false, Position = -1)]
     [CsvIgnore]
     [JsonIgnore]