From a71c7f6f1a6a97c13ff8c2f7cd2de46d4c8d0935 Mon Sep 17 00:00:00 2001
From: GeWuYou <95328647+GeWuYou@users.noreply.github.com>
Date: Tue, 27 Jan 2026 19:59:02 +0800
Subject: [PATCH] =?UTF-8?q?docs(architecture):=20=E4=B8=BAIArchitecture?=
 =?UTF-8?q?=E6=8E=A5=E5=8F=A3=E6=B7=BB=E5=8A=A0=E6=96=87=E6=A1=A3=E6=B3=A8?=
 =?UTF-8?q?=E9=87=8A?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- 为RegisterSystem方法添加返回值文档注释
- 为RegisterModel方法添加返回值文档注释
- 为RegisterUtility方法添加返回值文档注释
- 为IArchitecture接口添加WaitUntilReadyAsync方法
- 为新添加的方法添加完整的XML文档注释
---
 .../architecture/IArchitecture.cs                        | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/GFramework.Core.Abstractions/architecture/IArchitecture.cs b/GFramework.Core.Abstractions/architecture/IArchitecture.cs
index c81f070..9f1a37e 100644
--- a/GFramework.Core.Abstractions/architecture/IArchitecture.cs
+++ b/GFramework.Core.Abstractions/architecture/IArchitecture.cs
@@ -36,6 +36,7 @@ public interface IArchitecture : IAsyncInitializable
     /// </summary>
     /// <typeparam name="T">系统类型，必须实现ISystem接口</typeparam>
     /// <param name="system">要注册的系统实例</param>
+    /// <returns>注册的系统实例</returns>
     T RegisterSystem<T>(T system) where T : ISystem;
 
     /// <summary>
@@ -43,6 +44,7 @@ public interface IArchitecture : IAsyncInitializable
     /// </summary>
     /// <typeparam name="T">模型类型，必须实现IModel接口</typeparam>
     /// <param name="model">要注册的模型实例</param>
+    /// <returns>注册的模型实例</returns>
     T RegisterModel<T>(T model) where T : IModel;
 
     /// <summary>
@@ -50,6 +52,7 @@ public interface IArchitecture : IAsyncInitializable
     /// </summary>
     /// <typeparam name="T">工具类型，必须实现IUtility接口</typeparam>
     /// <param name="utility">要注册的工具实例</param>
+    /// <returns>注册的工具实例</returns>
     T RegisterUtility<T>(T utility) where T : IUtility;
 
     /// <summary>
@@ -65,4 +68,10 @@ public interface IArchitecture : IAsyncInitializable
     /// <param name="hook">生命周期钩子实例</param>
     /// <returns>注册的钩子实例</returns>
     IArchitectureLifecycle RegisterLifecycleHook(IArchitectureLifecycle hook);
+
+    /// <summary>
+    ///     等待直到架构准备就绪的异步操作
+    /// </summary>
+    /// <returns>表示异步等待操作的任务</returns>
+    Task WaitUntilReadyAsync();
 }
\ No newline at end of file