feat: 实现字典管理后端

2025-12-30 19:38:13 +08:00
parent a427b0f22a
commit dc9f6136d6
83 changed files with 6901 additions and 50 deletions
--- a/src/Domain/TakeoutSaaS.Domain/Dictionary/Repositories/IDictionaryItemRepository.cs
+++ b/src/Domain/TakeoutSaaS.Domain/Dictionary/Repositories/IDictionaryItemRepository.cs
@@ -0,0 +1,64 @@
+using TakeoutSaaS.Domain.Dictionary.Entities;
+
+namespace TakeoutSaaS.Domain.Dictionary.Repositories;
+
+/// <summary>
+/// 字典项仓储契约。
+/// </summary>
+public interface IDictionaryItemRepository
+{
+    /// <summary>
+    /// 根据 ID 获取字典项。
+    /// </summary>
+    /// <param name="itemId">字典项 ID。</param>
+    /// <param name="cancellationToken">取消标记。</param>
+    /// <returns>字典项或 null。</returns>
+    Task<DictionaryItem?> GetByIdAsync(long itemId, CancellationToken cancellationToken = default);
+
+    /// <summary>
+    /// 获取分组下字典项列表。
+    /// </summary>
+    /// <param name="tenantId">租户 ID。</param>
+    /// <param name="groupId">分组 ID。</param>
+    /// <param name="cancellationToken">取消标记。</param>
+    /// <returns>字典项集合。</returns>
+    Task<IReadOnlyList<DictionaryItem>> GetByGroupIdAsync(long tenantId, long groupId, CancellationToken cancellationToken = default);
+
+    /// <summary>
+    /// 获取合并后的系统/租户字典项。
+    /// </summary>
+    /// <param name="tenantId">租户 ID。</param>
+    /// <param name="systemGroupId">系统分组 ID。</param>
+    /// <param name="includeOverrides">是否包含租户覆盖。</param>
+    /// <param name="cancellationToken">取消标记。</param>
+    /// <returns>字典项集合。</returns>
+    Task<IReadOnlyList<DictionaryItem>> GetMergedItemsAsync(long tenantId, long systemGroupId, bool includeOverrides, CancellationToken cancellationToken = default);
+
+    /// <summary>
+    /// 新增字典项。
+    /// </summary>
+    /// <param name="item">字典项实体。</param>
+    /// <param name="cancellationToken">取消标记。</param>
+    Task AddAsync(DictionaryItem item, CancellationToken cancellationToken = default);
+
+    /// <summary>
+    /// 更新字典项。
+    /// </summary>
+    /// <param name="item">字典项实体。</param>
+    /// <param name="cancellationToken">取消标记。</param>
+    Task UpdateAsync(DictionaryItem item, CancellationToken cancellationToken = default);
+
+    /// <summary>
+    /// 删除字典项。
+    /// </summary>
+    /// <param name="item">字典项实体。</param>
+    /// <param name="cancellationToken">取消标记。</param>
+    Task RemoveAsync(DictionaryItem item, CancellationToken cancellationToken = default);
+
+    /// <summary>
+    /// 持久化更改。
+    /// </summary>
+    /// <param name="cancellationToken">取消标记。</param>
+    /// <returns>异步任务。</returns>
+    Task SaveChangesAsync(CancellationToken cancellationToken = default);
+}