feat: harden pocketbase migration readiness checks

docs/refactor/local-supabase.md

@@ -116,6 +116,26 @@ npm run pb:import:validate
 
 `pb:import:dry-run` 不写数据库，会先检查 JSON 格式、核心集合、旧 ID、敏感字段、关系断裂和未映射集合。存在 blocker 时先处理问题，不要直接正式导入。
 
+真实生产数据迁移请按完整验收流程执行：
+
+```text
+docs/refactor/pocketbase-real-data-migration-runbook.md
+```
+
+正式切换前建议先跑严格 dry-run：
+
+```bash
+npm run pb:import:dry-run -- --json --fail-on-warnings
+```
+
+导入后校验如需把 warning 也视为阻断：
+
+```powershell
+$env:FAIL_ON_WARNINGS="true"
+npm run pb:import:validate
+Remove-Item Env:\FAIL_ON_WARNINGS
+```
+
 导入真实密钥时必须明确打开开关，且只允许进入 `app_private.tenant_secrets`：
 
 ```bash