添加中文注释

DMS.Application/Services/VariableAppService.cs

@@ -7,36 +7,57 @@ using DMS.Application.Interfaces;
 namespace DMS.Application.Services;
 
 /// <summary>
-/// 实现变量管理的应用服务。
+/// 变量应用服务，负责处理变量相关的业务逻辑。
+/// 实现 <see cref="IVariableAppService"/> 接口。
 /// </summary>
 public class VariableAppService : IVariableAppService
 {
     private readonly IRepositoryManager _repoManager;
     private readonly IMapper _mapper;
 
+    /// <summary>
+    /// 构造函数，通过依赖注入获取仓储管理器和AutoMapper实例。
+    /// </summary>
+    /// <param name="repoManager">仓储管理器实例。</param>
+    /// <param name="mapper">AutoMapper 实例。</param>
     public VariableAppService(IRepositoryManager repoManager, IMapper mapper)
     {
         _repoManager = repoManager;
         _mapper = mapper;
     }
 
+    /// <summary>
+    /// 异步根据ID获取变量数据传输对象。
+    /// </summary>
+    /// <param name="id">变量ID。</param>
+    /// <returns>变量数据传输对象。</returns>
     public async Task<VariableDto> GetVariableByIdAsync(int id)
     {
         var variable = await _repoManager.Variables.GetByIdAsync(id);
         return _mapper.Map<VariableDto>(variable);
     }
 
+    /// <summary>
+    /// 异步获取所有变量数据传输对象列表。
+    /// </summary>
+    /// <returns>变量数据传输对象列表。</returns>
     public async Task<List<VariableDto>> GetAllVariablesAsync()
     {
         var variables = await _repoManager.Variables.GetAllAsync();
         return _mapper.Map<List<VariableDto>>(variables);
     }
 
+    /// <summary>
+    /// 异步创建一个新变量（事务性操作）。
+    /// </summary>
+    /// <param name="variableDto">要创建的变量数据传输对象。</param>
+    /// <returns>新创建变量的ID。</returns>
+    /// <exception cref="ApplicationException">如果创建变量时发生错误。</exception>
     public async Task<int> CreateVariableAsync(VariableDto variableDto)
     {
         try
         {
-            _repoManager.BeginTranAsync();
+            await _repoManager.BeginTranAsync();
             var variable = _mapper.Map<Variable>(variableDto);
             await _repoManager.Variables.AddAsync(variable);
             await _repoManager.CommitAsync();
@@ -49,11 +70,17 @@ public class VariableAppService : IVariableAppService
         }
     }
 
+    /// <summary>
+    /// 异步更新一个已存在的变量（事务性操作）。
+    /// </summary>
+    /// <param name="variableDto">要更新的变量数据传输对象。</param>
+    /// <returns>表示异步操作的任务。</returns>
+    /// <exception cref="ApplicationException">如果找不到变量或更新变量时发生错误。</exception>
     public async Task UpdateVariableAsync(VariableDto variableDto)
     {
         try
         {
-            _repoManager.BeginTranAsync();
+            await _repoManager.BeginTranAsync();
             var variable = await _repoManager.Variables.GetByIdAsync(variableDto.Id);
             if (variable == null)
             {
@@ -70,11 +97,17 @@ public class VariableAppService : IVariableAppService
         }
     }
 
+    /// <summary>
+    /// 异步删除一个变量（事务性操作）。
+    /// </summary>
+    /// <param name="id">要删除变量的ID。</param>
+    /// <returns>表示异步操作的任务。</returns>
+    /// <exception cref="ApplicationException">如果删除变量时发生错误。</exception>
     public async Task DeleteVariableAsync(int id)
     {
         try
         {
-            _repoManager.BeginTranAsync();
+            await _repoManager.BeginTranAsync();
             await _repoManager.Variables.DeleteByIdAsync(id);
             await _repoManager.CommitAsync();
         }