持久层重构为独立 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 追踪数据库结构
- 优化代码结构，解耦领域与持久层，提升扩展性与安全性

MiGu.Server/README.md

@@ -97,6 +97,88 @@ $env:SimpleLite__Enabled = "true"
 
 > 如果只想跑 MiGu.Server 单进程调试（不拉 SimpleLite），把 `appsettings.json:SimpleLite.Enabled` 改为 `false` 即可。
 
+## 数据库启动流程
+
+持久层在独立工程 **[MiGu.DB](../MiGu.DB/README.md)**；Server 通过 `PlatformPersistence` 接入。
+
+### 启动顺序（`Program.cs`）
+
+```text
+AddPlatformPersistence(configuration)     # 注册 AddMiGuDb + Wms/SimpleFields 等业务服务
+        │
+        ▼
+builder.Build()
+        │
+        ▼
+EnsurePlatformDatabaseAsync()             # → MiGu.DB.MigrateMiGuDbAsync()
+        │                                 #    Schema 初始化 + 可选 IDataMigrator
+        ▼
+… 其余中间件 …
+UseMiddleware<HttpActorContextMiddleware> # 请求级写入 IActorContext（审计戳）
+```
+
+### 配置（`appsettings*.json`）
+
+```json
+"Database": {
+  "Provider": "sqlite",
+  "SchemaMode": "Migrate",
+  "ApplyDataMigratorsOnStartup": true
+},
+"ConnectionStrings": {
+  "Platform": "Data Source=data/platform.db"
+}
+```
+
+| 配置项 | 含义 | 取值 |
+|--------|------|------|
+| `Provider` | 数据库种类 | `sqlite`（默认）/ `mysql` / `npgsql` / `sqlserver` |
+| `SchemaMode` | 启动时如何初始化 Schema | 见下表 |
+| `ApplyDataMigratorsOnStartup` | Schema 完成后是否跑数据修补 | `true`（默认）/ `false` |
+
+当前仓库约定：
+
+- `appsettings.json` → `"SchemaMode": "Migrate"`（发版/默认）
+- `appsettings.Development.json` → `"SchemaMode": "EnsureCreated"`（本地开发）
+
+也可用环境变量覆盖，例如：`$env:Database__SchemaMode = "Migrate"`。
+
+### SchemaMode 行为
+
+| 值 | 行为 | 适用 |
+|----|------|------|
+| **`Migrate`** | 旧库无 `__EFMigrationsHistory` 时先写 Initial 基线 → `MigrateAsync` →（可选）DataMigrator | 测试 / 预发 / 生产 |
+| **`EnsureCreated`** | 仅 `EnsureCreated`（按**当前模型**建空库），**不**跑 Migrations →（可选）DataMigrator | 开发期改实体、暂不生成迁移 |
+
+流程图：
+
+```text
+SchemaMode = EnsureCreated
+  → EnsureCreatedAsync（库已存在则不改结构）
+  → IDataMigrator（ApplyDataMigratorsOnStartup=true 时）
+
+SchemaMode = Migrate
+  → 程序集无 Migration → EnsureCreated 兜底
+  → 否则：基线（如需）→ MigrateAsync
+  → IDataMigrator（可选）
+```
+
+**开发注意（EnsureCreated）：**
+
+- 改实体后结构不会自动升级；请删除 `MiGu.Server/data/platform.db*` 再启动。
+- 不会写入迁移历史；以后改回 `Migrate` 时，对已有库会走基线再应用 Migrations。
+
+**发版注意：**
+
+- 现场务必使用 `Migrate`，并随包带上 `MiGu.DB/Migrations/Sqlite/`。
+- 开发期若长期 `EnsureCreated` 改模型，发版前必须对**当前模型**执行 `dotnet ef migrations add`，再切回 `Migrate` 验证；否则空库只会落到旧 Migration，结构落后于代码。
+- 从 EnsureCreated 库切到 `Migrate`：若无 History，启动会把**全部** pending Migration 写入基线（假定库已对齐模型 tip）。结构不对齐时应删库重建或手工处理。
+
+### 相关文档
+
+- 持久层总览与 SchemaMode 摘要：[MiGu.DB/README.md](../MiGu.DB/README.md)
+- 如何生成/管理 Migration：[MiGu.DB/MIGRATIONS.md](../MiGu.DB/MIGRATIONS.md)
+
 ## 安全须知（生产部署必读）
 
 > **重要：以下默认值仅供本地开发，切勿原样用于生产环境。**
@@ -136,7 +218,7 @@ $env:SimpleLite__Enabled = "true"
 - 健康检查：`/api/health`；
 - Swagger：开发环境下 `/swagger`。
 
-> 不在本轮范围：真实 SimpleLite WebAPI、SystemMission 拉起、真实 JWT/RBAC、SQLite/EF Core 持久层。
+> 能力补充：平台库由 **MiGu.DB**（EF Core）承载，启动流程见「[数据库启动流程](#数据库启动流程)」。
 
 ## 目录结构
 
@@ -242,3 +324,5 @@ YARP 路由配置见 `appsettings.json`：
 
 - [ARCHITECTURE.md](ARCHITECTURE.md) — v1.6 总体架构（§4 进程拓扑、§6.3 YARP 配置、§9 配置中心、§10 交互序列、§17 视觉规范）
 - [（见 Simple 仓库）frontends/README.md](（见 Simple 仓库）frontends/README.md) — 前端启动与联调说明（含「迷毂」品牌与紫色主题约定）
+- [MiGu.DB/README.md](../MiGu.DB/README.md) — 持久层框架；[MIGRATIONS.md](../MiGu.DB/MIGRATIONS.md) — 生成 Migration 手册
+- 本文「[数据库启动流程](#数据库启动流程)」— SchemaMode / EnsureCreated / Migrate