refactor: 重构待办事项模块结构与命名

src/Hua.Todo.Maui/MauiProgram.cs

@@ -13,13 +13,14 @@ namespace Hua.Todo.Maui;
 /// <summary>
 /// MAUI 程序启动类
 /// </summary>
-public static class MauiProgram
+public static partial class MauiProgram
 {
 	/// <summary>
 	/// 创建并配置 MAUI 应用程序
 	/// </summary>
 	public static MauiApp CreateMauiApp()
 	{
+		ConfigurePlatformWebViewContainer();
 		var builder = MauiApp.CreateBuilder();
 		builder
 			.UseMauiApp<App>()
@@ -71,7 +72,17 @@ public static class MauiProgram
 
 		// 注册嵌入式 Web 服务器（平台相关）
 #if WINDOWS
-        builder.Services.AddSingleton<IEmbeddedWebServerService, EmbeddedWebServerService>();
+		// Windows 平台下嵌入式 WebServer 的启用策略：
+		// - 静态托管模式（IsUsingStatic=true）：由 MAUI 内置 WebServer 提供 wwwroot 与本地 API。
+		// - 开发三件套模式（IsUsingStatic=false，前端走 Vite）：API 由独立 Host(5173) 提供，避免在 MAUI 内启动 WebServer 导致注入覆盖前端代理配置。
+		if (appSettings.WebServer.IsUsingStatic)
+		{
+			builder.Services.AddSingleton<IEmbeddedWebServerService, EmbeddedWebServerService>();
+		}
+		else
+		{
+			builder.Services.AddSingleton<IEmbeddedWebServerService, NoopEmbeddedWebServerService>();
+		}
 #elif ANDROID
         builder.Services.AddSingleton<IEmbeddedWebServerService, MobileEmbeddedWebServerService>();
 #else
@@ -101,6 +112,8 @@ public static class MauiProgram
 		return app;
 	}
 
+	static partial void ConfigurePlatformWebViewContainer();
+
 	/// <summary>
 	/// 从 appsettings.json 加载配置
 	/// </summary>