docs: 更新项目架构与数据模型文档

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

docs/architecture/database/DbContext工厂.md

@@ -1,16 +1,14 @@
 # DbContext 工厂
 
-> 所属模块：[数据库切换支持](./概览.md)
+> 所属模块：[数据库支持](./概览.md)
 
 ---
 
-## 1. 接口定义
+## 1. 本地库工厂
 
 ```csharp
-// Data/IDbContextFactory.cs
-using Gpulse.WCT.DataAnalyzer.Data;
-
-namespace Gpulse.WCT.DataAnalyzer.Data;
+// Infrastructure/LocalData/IDbContextFactory.cs
+namespace Gpulse.WCT.DataAnalyzer.Core.Infrastructure.LocalData;
 
 public interface IDbContextFactory
 {
@@ -18,105 +16,68 @@ public interface IDbContextFactory
 }
 ```
 
+工厂实现读取 `Database:LocalPath`（fallback `Database:Path`），支持 SQLite 和 PostgreSQL。
+
 ---
 
-## 2. 工厂实现
+## 2. 发布库工厂
 
 ```csharp
-// Data/DbContextFactory.cs
-using Microsoft.EntityFrameworkCore;
-using Microsoft.Extensions.Configuration;
+// Infrastructure/ReleaseData/IReleaseDbContextFactory.cs
+namespace Gpulse.WCT.DataAnalyzer.Core.Infrastructure.ReleaseData;
 
-namespace Gpulse.WCT.DataAnalyzer.Data;
-
-public class DbContextFactory : IDbContextFactory
+public interface IReleaseDbContextFactory
 {
-    private readonly IConfiguration _configuration;
-
-    public DbContextFactory(IConfiguration configuration)
-    {
-        _configuration = configuration;
-    }
-
-    public WctMinerDbContext CreateDbContext()
-    {
-        var dbType = _configuration["Database:Type"]?.ToLower() ?? "sqlite";
-        var optionsBuilder = new DbContextOptionsBuilder<WctMinerDbContext>();
-
-        switch (dbType)
-        {
-            case "postgresql":
-            case "postgres":
-                var pgConnStr = BuildPostgreSqlConnectionString();
-                optionsBuilder.UseNpgsql(pgConnStr);
-                break;
-            
-            case "sqlite":
-            default:
-                var dbPath = _configuration["Database:Path"] ?? "./data/database/wctminer.db";
-                EnsureDirectoryExists(dbPath);
-                optionsBuilder.UseSqlite($"Data Source={dbPath}");
-                break;
-        }
-
-#if DEBUG
-        optionsBuilder.EnableSensitiveDataLogging();
-        optionsBuilder.EnableDetailedErrors();
-#endif
-
-        return new WctMinerDbContext(optionsBuilder.Options);
-    }
-
-    private string BuildPostgreSqlConnectionString()
-    {
-        var host = _configuration["Database:Host"] ?? "localhost";
-        var port = _configuration["Database:Port"] ?? "5432";
-        var name = _configuration["Database:Name"] ?? "wctminer";
-        var user = _configuration["Database:User"] ?? "postgres";
-        var password = _configuration["Database:Password"] ?? "";
-
-        return $"Host={host};Port={port};Database={name};Username={user};Password={password}";
-    }
-
-    private static void EnsureDirectoryExists(string dbPath)
-    {
-        var directory = Path.GetDirectoryName(dbPath);
-        if (!string.IsNullOrEmpty(directory) && !Directory.Exists(directory))
-        {
-            Directory.CreateDirectory(directory);
-        }
-    }
+    ReleaseDbContext CreateDbContext();
 }
 ```
 
+工厂实现读取 `Database:ReleasePath`，支持 SQLite 和 PostgreSQL。PostgreSQL 时使用 `Release*` 前缀配置（`ReleaseHost`, `ReleasePort`, `ReleaseName`, `ReleaseUser`, `ReleasePassword`），未设置时回退到 local 的对应配置。
+
 ---
 
-## 3. 依赖注入扩展
+## 3. DI 注册
 
 ```csharp
-// Extensions/ServiceCollectionExtensions.cs
-using Microsoft.Extensions.DependencyInjection;
-using Gpulse.WCT.DataAnalyzer.Data;
-
-namespace Gpulse.WCT.DataAnalyzer.Extensions;
-
-public static class ServiceCollectionExtensions
+// Infrastructure/Extensions/ServiceCollectionExtensions.cs
+public static IServiceCollection AddDatabaseServices(
+    this IServiceCollection services,
+    IConfiguration configuration)
 {
-    public static IServiceCollection AddDatabaseServices(
-        this IServiceCollection services, 
-        IConfiguration configuration)
+    // 本地库
+    services.AddScoped<IDbContextFactory, DbContextFactory>();
+    services.AddScoped<WctMinerDbContext>(sp =>
     {
-        // 注册 DbContext 工厂
-        services.AddScoped<IDbContextFactory, DbContextFactory>();
-        
-        // 注册 DbContext（通过工厂创建）
-        services.AddScoped<WctMinerDbContext>(sp =>
-        {
-            var factory = sp.GetRequiredService<IDbContextFactory>();
-            return factory.CreateDbContext();
-        });
+        var factory = sp.GetRequiredService<IDbContextFactory>();
+        return factory.CreateDbContext();
+    });
 
-        return services;
-    }
+    // 发布库（独立）
+    services.AddScoped<IReleaseDbContextFactory, ReleaseDbContextFactory>();
+    services.AddScoped<ReleaseDbContext>(sp =>
+    {
+        var factory = sp.GetRequiredService<IReleaseDbContextFactory>();
+        return factory.CreateDbContext();
+    });
+
+    return services;
 }
+```
+
+## 4. 启动初始化
+
+```csharp
+// Program.cs
+using var scope = app.Services.CreateScope();
+
+// 初始化本地库
+var dbContext = scope.ServiceProvider.GetRequiredService<WctMinerDbContext>();
+await dbContext.Database.EnsureCreatedAsync();
+
+// 初始化发布库
+var releaseContext = scope.ServiceProvider.GetRequiredService<ReleaseDbContext>();
+await releaseContext.Database.EnsureCreatedAsync();
+
+// 本地库种子数据
+SeedData.Initialize(dbContext);
 ```