后端设计治理：批次 0-4 全部完成（安全/部署/一致性/结构/架构）

按 ROADMAP §3.1 治理批次推进的后端设计审查整改：

- 批次 0（安全）：/api/status/{task_id} 补 JWT 鉴权与任务归属校验；
  pythonocc_available 真实探测；bcrypt 超 72 字节显式拒绝；
  SECRET_KEY/RUSTFS_* 惰性校验，代码侧弱默认移除
- 批次 1（部署正确性）：主处理链路改走 RustFS（分派入参 stp_file_id 化，
  worker 按 object_key 下载）；AUTO_MIGRATE 开关 + 迁移目录 alembic/→migrations/
  修复包遮蔽（自动迁移此前从未真正生效）；OCC 镜像改 conda 原生执行 +
  基础镜像 tag 锁定；compose 关键项改 ${VAR:?} 强制显式配置
- 批次 2（任务一致性）：删除 Redis 进程内存回退，PG 为任务状态单一事实源；
  批量元数据入库（processing_tasks.batch_id，迁移 a3f8c2d91e47）；
  型腔失败任务标 failed 不再静默 completed；事务边界收口
  （数据本体写 flush-only、失败先回滚再置 failed、进度更新保留即时 commit）
- 批次 3（API 与代码结构）：592 行 advanced_router 拆为 design/cost/machining/
  export 四子路由，请求体全量 Pydantic 化；ROUTE_MODULES + route_registry
  （/api/health 呈现 degraded，DEBUG fail fast）；纯计算端点统一 to_thread；
  StorageIntegrationService 按职责三拆；MAX_FILE_SIZE 接线生效、
  celery 复用 Settings.redis_url；管理员重置密码改 JSON body（端到端断裂修复）；
  openapi.json 重导出（76 paths）+ 前端 gen:api
- 批次 4（架构演进）：共享 ORM 按模块拆分（shared/models/base.py + identity.py、
  moldinsight/models/、inventory/models/，删除三条无使用方的跨模块
  relationship，跨模块桥接收敛为裸 FK 硬规则，无兼容 facade）；
  OCC executor 重建补 cancel_futures=True（消除旧队列被慢恢复线程
  并行消化的数据竞争）；OCC 吞吐方案设计先行
  （docs/topics/performance/OCC_THROUGHPUT.md）；顺手清偿 D15
  （vite.config.ts 未用参数致 npm run build 失败）

测试基线：125 passed, 2 skipped（pytest + sqlite+aiosqlite；归属边界、
路由契约、配置治理、鉴权回归等随批新增）
文档同步：STATUS / TECH_DEBT / ROADMAP / ARCHITECTURE / API_CONTRACT /
OPERATIONS / AGENTS

Co-Authored-By: Claude Code <noreply@anthropic.com>

src/moldinsight/api/__init__.py

@@ -3,32 +3,54 @@ import importlib
 
 from shared.config.settings import settings
 from shared.utils.logger import get_logger
+from moldinsight.api.route_registry import route_load_status
 
 logger = get_logger(__name__)
 
 router = APIRouter()
 
-def _safe_include(module_path: str, label: str):
+# 业务路由装载清单：新增路由必须登记于此。
+# 失败语义（原 _safe_include 仅 WARNING 跳过，进程带病启动不可感知）：
+# - 非 DEBUG：记录进 route_load_status["failed"]，/api/health 呈现 degraded
+# - DEBUG：直接抛错 fail fast——开发环境路由缺失必须当场暴露
+ROUTE_MODULES = [
+    # (label, module_path, debug_only)
+    ("健康检查", "moldinsight.api.health_router", False),
+    ("上传", "moldinsight.api.upload_router", False),
+    ("批量", "moldinsight.api.batch_router", False),
+    ("任务", "moldinsight.api.task_router", False),
+    ("历史", "moldinsight.api.history_router", False),
+    ("CAM", "moldinsight.api.cam_router", False),
+    ("设计", "moldinsight.api.design_router", False),
+    ("成本", "moldinsight.api.cost_router", False),
+    ("加工", "moldinsight.api.machining_router", False),
+    ("导出", "moldinsight.api.export_router", False),
+    ("铝价", "moldinsight.api.aluminum_price_routes", False),
+    # 调试端点会 dump 全量任务数据，仅 DEBUG 模式注册（双重防线：还需登录）
+    ("调试", "moldinsight.api.debug_router", True),
+]
+
+
+def _safe_include(label: str, module_path: str, debug_only: bool = False):
+    if debug_only and not settings.DEBUG:
+        route_load_status["disabled"].append({"label": label, "module": module_path})
+        return
     try:
         module = importlib.import_module(module_path)
         router_obj = getattr(module, "router", None)
         if router_obj is None:
             raise ValueError("未找到 router 对象")
         router.include_router(router_obj)
+        route_load_status["loaded"].append({"label": label, "module": module_path})
         logger.info(f"{label} 路由加载成功")
     except Exception as exc:
-        logger.warning(f"{label} 路由加载失败，已跳过: {exc}")
+        route_load_status["failed"].append(
+            {"label": label, "module": module_path, "error": str(exc)}
+        )
+        logger.error(f"{label} 路由加载失败: {exc}")
+        if settings.DEBUG:
+            raise
 
 
-_safe_include("moldinsight.api.health_router", "健康检查")
-_safe_include("moldinsight.api.upload_router", "上传")
-_safe_include("moldinsight.api.batch_router", "批量")
-_safe_include("moldinsight.api.task_router", "任务")
-_safe_include("moldinsight.api.history_router", "历史")
-_safe_include("moldinsight.api.cam_router", "CAM")
-_safe_include("moldinsight.api.advanced_router", "高级")
-_safe_include("moldinsight.api.aluminum_price_routes", "铝价")
-
-# 调试端点会 dump 全量任务数据，仅 DEBUG 模式注册（双重防线：还需登录）
-if settings.DEBUG:
-    _safe_include("moldinsight.api.debug_router", "调试")
+for _label, _module_path, _debug_only in ROUTE_MODULES:
+    _safe_include(_label, _module_path, _debug_only)