持久层重构为独立 MiGu.DB 工程并优化集成

- 新增 MiGu.DB 项目，迁移所有领域实体与枚举，统一模型约定 - 实现 Entity/Repository/UoW/Provider/Exception 等接口与实现 - 支持数据修补机制，完善 Sqlite 初始迁移与数据库管理 - Server 侧移除 EF Core 相关，依赖 MiGu.DB，PlatformPersistence 适配 - 业务服务注入 UoW/Repository，状态字段统一用 enum 及辅助类 - 统一异常处理，Controller 映射 HTTP 状态码 - 配置项与文档补充数据库启动、SchemaMode、迁移说明 - 新增 GlobalUsings.Db.cs、WmsStatusAliases.cs 简化类型引用 - 新增 HttpActorContextMiddleware 支持操作者上下文一致性 - 新增 MiGuDbContextModelSnapshot 追踪数据库结构 - 优化代码结构，解耦领域与持久层，提升扩展性与安全性
2026-07-27 14:26:04 +08:00
parent bdcd88608c
commit 51c3fc1994
57 changed files with 6663 additions and 1396 deletions
@@ -0,0 +1,116 @@
+namespace MiGu.DB.Domains.Wms;
+
+/// <summary>
+/// 枚举辅助类（复数命名）：承接 API/DTO 的字符串入参，解析为实体上的枚举。
+/// 与同名枚举分离，避免「属性 LocationKind 初始值引用实例属性」一类编译冲突。
+/// Server 侧通过 global using 别名（如 StorageStatuses）引用本文件类型。
+/// </summary>
+public static class AreaLayoutModes
+{
+    public static readonly HashSet<AreaLayoutMode> All = new() { AreaLayoutMode.Flat, AreaLayoutMode.Grid };
+
+    public static AreaLayoutMode ParseOr(string? value, AreaLayoutMode fallback = AreaLayoutMode.Flat) =>
+        Enum.TryParse<AreaLayoutMode>(value, true, out var e) && All.Contains(e) ? e : fallback;
+}
+
+public static class LocationKinds
+{
+    public const LocationKind Grid = LocationKind.Grid;
+    public const LocationKind Station = LocationKind.Station;
+    public static readonly HashSet<LocationKind> All = new() { Grid, Station };
+
+    public static LocationKind ParseOr(string? value, LocationKind fallback = LocationKind.Station) =>
+        Enum.TryParse<LocationKind>(value, true, out var e) && All.Contains(e) ? e : fallback;
+}
+
+public static class StorageStatuses
+{
+    public const StorageStatus Empty = StorageStatus.Empty;
+    public const StorageStatus EmptyContainer = StorageStatus.EmptyContainer;
+    public const StorageStatus FullContainer = StorageStatus.FullContainer;
+    public const StorageStatus Disabled = StorageStatus.Disabled;
+
+    public static readonly HashSet<StorageStatus> All = new()
+        { Empty, EmptyContainer, FullContainer, Disabled };
+
+    /// <summary>
+    /// 写路径归一：兼容历史字符串 Available/Idle/Occupied。
+    /// 库内残留旧值须靠 DataMigrator 刷掉，不能依赖 converter 读侧归一（WHERE 会漏行）。
+    /// </summary>
+    public static StorageStatus Normalize(string? status) => status switch
+    {
+        "Available" or "Idle" => Empty,
+        "Occupied" => FullContainer,
+        _ when Enum.TryParse<StorageStatus>(status, true, out var e) && All.Contains(e) => e,
+        _ => Empty
+    };
+}
+
+public static class ContainerStatuses
+{
+    public const ContainerStatus EmptyMaterial = ContainerStatus.EmptyMaterial;
+    public const ContainerStatus FullMaterial = ContainerStatus.FullMaterial;
+    public static readonly HashSet<ContainerStatus> All = new() { EmptyMaterial, FullMaterial };
+
+    public static ContainerStatus ParseOr(string? value, ContainerStatus fallback = ContainerStatus.EmptyMaterial) =>
+        Enum.TryParse<ContainerStatus>(value, true, out var e) && All.Contains(e) ? e : fallback;
+}
+
+public static class ContainerLocationTypes
+{
+    public const ContainerLocationType Storage = ContainerLocationType.Storage;
+    public const ContainerLocationType Car = ContainerLocationType.Car;
+    public static readonly HashSet<ContainerLocationType> All = new() { Storage, Car };
+
+    public static bool IsDefined(string? value) =>
+        Enum.TryParse<ContainerLocationType>(value, true, out var e) && All.Contains(e);
+
+    public static ContainerLocationType ParseOr(string? value, ContainerLocationType fallback = ContainerLocationType.Storage) =>
+        Enum.TryParse<ContainerLocationType>(value, true, out var e) && All.Contains(e) ? e : fallback;
+
+    public static bool EqualsString(ContainerLocationType value, string? other) =>
+        Enum.TryParse<ContainerLocationType>(other, true, out var e) && e == value;
+}
+
+public static class ContainerLocationStatuses
+{
+    public const ContainerLocationStatus Active = ContainerLocationStatus.Active;
+    public const ContainerLocationStatus Locked = ContainerLocationStatus.Locked;
+    public const ContainerLocationStatus Exception = ContainerLocationStatus.Exception;
+    public static readonly HashSet<ContainerLocationStatus> All = new() { Active, Locked, Exception };
+
+    public static bool IsDefined(string? value) =>
+        Enum.TryParse<ContainerLocationStatus>(value, true, out var e) && All.Contains(e);
+
+    public static ContainerLocationStatus ParseOr(string? value, ContainerLocationStatus fallback = ContainerLocationStatus.Active) =>
+        Enum.TryParse<ContainerLocationStatus>(value, true, out var e) && All.Contains(e) ? e : fallback;
+}
+
+public static class ContainerMaterialStatuses
+{
+    public const ContainerMaterialStatus Bound = ContainerMaterialStatus.Bound;
+    public const ContainerMaterialStatus Loaded = ContainerMaterialStatus.Loaded;
+    public const ContainerMaterialStatus Unloaded = ContainerMaterialStatus.Unloaded;
+    public const ContainerMaterialStatus Adjusted = ContainerMaterialStatus.Adjusted;
+    public const ContainerMaterialStatus Frozen = ContainerMaterialStatus.Frozen;
+
+    public static readonly HashSet<ContainerMaterialStatus> ActiveBind = new()
+        { Bound, Loaded, Adjusted, Frozen };
+}
+
+public static class MaterialLifecycles
+{
+    public const MaterialLifecycle Active = MaterialLifecycle.Active;
+    public const MaterialLifecycle Archived = MaterialLifecycle.Archived;
+    public static readonly HashSet<MaterialLifecycle> All = new() { Active, Archived };
+
+    public static MaterialLifecycle ParseOr(string? value, MaterialLifecycle fallback = MaterialLifecycle.Active) =>
+        Enum.TryParse<MaterialLifecycle>(value, true, out var e) && All.Contains(e) ? e : fallback;
+}
+
+public static class StockEventTypes
+{
+    public const StockEventType Bind = StockEventType.Bind;
+    public const StockEventType Unbind = StockEventType.Unbind;
+    public const StockEventType ContainerMove = StockEventType.ContainerMove;
+}