first commit

backend/F9WebAiTest.Domain/Common/BaseEntity.cs

@@ -0,0 +1,13 @@
+using FreeSql.DataAnnotations;
+
+namespace F9WebAiTest.Domain.Common;
+
+/// <summary>所有旧实体的基类（自增主键 + 软删除）</summary>
+public abstract class BaseEntity : IEntity
+{
+    [Column(IsPrimary = true, IsIdentity = true)]
+    public long Id { get; set; }
+    public DateTime CreatedAt { get; set; } = DateTime.Now;
+    public DateTime? UpdatedAt { get; set; }
+    public bool IsDeleted { get; set; }
+}

backend/F9WebAiTest.Domain/Common/IEntity.cs

@@ -0,0 +1,10 @@
+namespace F9WebAiTest.Domain.Common;
+
+/// <summary>实体公共字段接口（Id/CreatedAt/UpdatedAt/IsDeleted），用于统一新旧两套实体基类</summary>
+public interface IEntity
+{
+    long Id { get; set; }
+    DateTime CreatedAt { get; set; }
+    DateTime? UpdatedAt { get; set; }
+    bool IsDeleted { get; set; }
+}

backend/F9WebAiTest.Domain/Common/IRepository.cs

@@ -0,0 +1,23 @@
+using System.Linq.Expressions;
+
+namespace F9WebAiTest.Domain.Common;
+
+/// <summary>通用仓储接口</summary>
+public interface IRepository<T> where T : IEntity
+{
+    Task<T> GetByIdAsync(long id);
+    Task<List<T>> GetAllAsync();
+    Task<List<T>> FindAsync(Expression<Func<T, bool>> predicate);
+    Task<T> FirstOrDefaultAsync(Expression<Func<T, bool>> predicate);
+    Task<bool> AnyAsync(Expression<Func<T, bool>> predicate);
+    Task<long> CountAsync(Expression<Func<T, bool>> predicate);
+    Task<T> AddAsync(T entity);
+    Task AddRangeAsync(IEnumerable<T> entities);
+    Task UpdateAsync(T entity);
+    Task DeleteAsync(T entity);
+    Task DeleteRangeAsync(IEnumerable<T> entities);
+    // 物理删除（不软删除，用于关联表避免唯一索引冲突）
+    Task HardDeleteAsync(T entity);
+    Task HardDeleteRangeAsync(IEnumerable<T> entities);
+    Task<int> SaveChangesAsync();
+}