后端设计治理：批次 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/models/__init__.py

@@ -0,0 +1,28 @@
+"""moldinsight 域模型出口。
+
+全量模型注册点见 shared/models/base.py 模块 docstring；
+业务代码按需 `from moldinsight.models import STPFile, ...`。
+"""
+from moldinsight.models.stp_analysis import (
+    STPFile,
+    GeometryData,
+    MeshData,
+    HTMLFile,
+    ProcessingTask,
+    MoldCavityData,
+    FeatureDetection,
+    DesignRecommendation,
+    AnalysisMetrics,
+)
+
+__all__ = [
+    "STPFile",
+    "GeometryData",
+    "MeshData",
+    "HTMLFile",
+    "ProcessingTask",
+    "MoldCavityData",
+    "FeatureDetection",
+    "DesignRecommendation",
+    "AnalysisMetrics",
+]

src/moldinsight/models/stp_analysis.py

@@ -0,0 +1,352 @@
+"""moldinsight 域模型：STEP 分析链路（源文件 + 各阶段产物 + 任务）。
+
+从旧 shared/models/database.py 拆出（D3，2026-09-17）。
+跨模块桥接只保留裸 FK，不建 ORM relationship（base.py 约定）：
+- STPFile.user_id -> users.id（原 user relationship 无使用方，已删）
+- STPFile.product_id -> products.id（原 product relationship 无使用方，已删；
+  分析结果一键转成品的桥接在 inventory/api/product_routes.py 显式 select 两表）
+"""
+from sqlalchemy import Column, Integer, String, Text, DateTime, JSON, LargeBinary, Boolean, Float, ForeignKey
+from sqlalchemy.sql import func
+from sqlalchemy.orm import relationship
+
+from shared.models.base import Base
+
+
+class STPFile(Base):
+    """STP源文件元数据表 - 支持同一文件多次上传"""
+    __tablename__ = "stp_files"
+
+    id = Column(Integer, primary_key=True, index=True)
+    user_id = Column(Integer, ForeignKey("users.id"), nullable=True, index=True)
+    # 关联进销存成品（P2-1：分析结果可一键创建为成品并回写；裸 FK，见模块 docstring）
+    product_id = Column(Integer, ForeignKey("products.id"), nullable=True, index=True)
+
+    # 对象存储信息
+    object_key = Column(String(500), nullable=False, index=True)  # MinIO对象键
+    storage_bucket = Column(String(100), nullable=False)       # 存储桶名称
+    object_url = Column(String(1000), nullable=True)          # 预签名URL（可选）
+
+    # 文件信息
+    original_filename = Column(String(255), nullable=False, index=True)  # 添加索引支持按文件名查询
+    file_size = Column(Integer, nullable=False)
+    file_hash = Column(String(64), index=True)  # 移除unique约束，允许同一文件多次上传
+    mime_type = Column(String(50), default="application/octet-stream")
+
+    # 上传批次标识 - 用于区分同一文件的多次上传
+    upload_batch = Column(String(36), index=True)  # UUID批次号
+
+    # 时间戳
+    upload_time = Column(DateTime, default=func.now())
+    processed_time = Column(DateTime, nullable=True)
+
+    # 状态
+    status = Column(String(20), default="pending", index=True)  # pending, processing, completed, failed
+    error_message = Column(Text, nullable=True)
+
+    # 分析摘要 - 快速查询字段
+    volume = Column(Float, nullable=True)  # 体积 mm³
+    surface_area = Column(Float, nullable=True)  # 表面积 mm²
+    product_weight = Column(Float, nullable=True)  # 产品重量 g
+
+    # 保留旧字段以兼容
+    file_path = Column(String(500), nullable=True)  # 本地路径（已弃用）
+    file_content = Column(LargeBinary, nullable=True)  # 本地存储（已弃用）
+    filename = Column(String(255), nullable=True)  # 已弃用
+
+    # 关联关系（均为本模块内子表）
+    geometry_data = relationship("GeometryData", back_populates="stp_file", uselist=False)
+    mesh_data = relationship("MeshData", back_populates="stp_file", uselist=False)
+    mold_cavity_data = relationship("MoldCavityData", back_populates="stp_file", uselist=False)
+    html_file = relationship("HTMLFile", back_populates="stp_file", uselist=False)
+    analysis_metrics = relationship("AnalysisMetrics", back_populates="stp_file", uselist=False)
+    feature_detections = relationship("FeatureDetection", back_populates="stp_file")
+    design_recommendations = relationship("DesignRecommendation", back_populates="stp_file")
+    processing_tasks = relationship("ProcessingTask", back_populates="stp_file")
+
+    def __repr__(self):
+        return f"<STPFile(id={self.id}, original_filename='{self.original_filename}', status='{self.status}')>"
+
+class GeometryData(Base):
+    """几何数据JSON元数据表"""
+    __tablename__ = "geometry_data"
+
+    id = Column(Integer, primary_key=True, index=True)
+    stp_file_id = Column(Integer, ForeignKey("stp_files.id"), nullable=False, index=True)
+
+    # 对象存储信息
+    object_key = Column(String(500), nullable=False)
+    storage_bucket = Column(String(100), nullable=False)
+    object_url = Column(String(1000), nullable=True)
+
+    # 分析方法
+    analysis_method = Column(String(50), default="pythonocc")  # pythonocc, simulated
+
+    # 时间戳
+    created_time = Column(DateTime, default=func.now())
+
+    # 几何属性摘要（便于快速查询）
+    volume = Column(Float, nullable=True)
+    surface_area = Column(Float, nullable=True)
+    bounding_box_min = Column(JSON, nullable=True)
+    bounding_box_max = Column(JSON, nullable=True)
+    center_of_mass = Column(JSON, nullable=True)
+
+    # 拓扑信息
+    topology_faces = Column(Integer, nullable=True)
+    topology_edges = Column(Integer, nullable=True)
+    topology_vertices = Column(Integer, nullable=True)
+
+    # 关联关系
+    stp_file = relationship("STPFile", back_populates="geometry_data")
+
+    def __repr__(self):
+        return f"<GeometryData(id={self.id}, stp_file_id={self.stp_file_id})>"
+
+
+class MeshData(Base):
+    """网格数据JSON元数据表（详细网格存 RustFS，PostgreSQL 存摘要）"""
+    __tablename__ = "mesh_data"
+
+    id = Column(Integer, primary_key=True, index=True)
+    stp_file_id = Column(Integer, ForeignKey("stp_files.id"), nullable=False, index=True)
+
+    # 对象存储信息
+    object_key = Column(String(500), nullable=False)
+    storage_bucket = Column(String(100), nullable=False)
+    object_url = Column(String(1000), nullable=True)
+
+    # 生成设置
+    quality = Column(String(20), default="medium")  # low / medium / high
+
+    # 网格规模信息
+    vertex_count = Column(Integer, nullable=True)
+    face_count = Column(Integer, nullable=True)
+    point_count = Column(Integer, nullable=True)  # 采样点云数量
+
+    # 网格边界框（便于快速查询）
+    bounding_box_min = Column(JSON, nullable=True)
+    bounding_box_max = Column(JSON, nullable=True)
+
+    # 时间戳
+    created_time = Column(DateTime, default=func.now())
+
+    # 关联关系
+    stp_file = relationship("STPFile", back_populates="mesh_data")
+
+    def __repr__(self):
+        return f"<MeshData(id={self.id}, stp_file_id={self.stp_file_id}, quality='{self.quality}')>"
+
+class HTMLFile(Base):
+    """网页文件元数据表"""
+    __tablename__ = "html_files"
+
+    id = Column(Integer, primary_key=True, index=True)
+    stp_file_id = Column(Integer, ForeignKey("stp_files.id"), nullable=False, index=True)
+
+    # 对象存储信息
+    object_key = Column(String(500), nullable=False)
+    storage_bucket = Column(String(100), nullable=False)
+    object_url = Column(String(1000), nullable=True)
+
+    # 文件信息
+    filename = Column(String(255), nullable=False)
+    generated_time = Column(DateTime, default=func.now())
+
+    # 可视化相关元数据
+    visualization_type = Column(String(50), default="3d_viewer")
+    has_interactive_elements = Column(Boolean, default=True)
+
+    # 保留旧字段以兼容
+    file_path = Column(String(500), nullable=True)
+    html_content = Column(Text, nullable=True)
+
+    # 关联关系
+    stp_file = relationship("STPFile", back_populates="html_file")
+
+    def __repr__(self):
+        return f"<HTMLFile(id={self.id}, stp_file_id={self.stp_file_id}, object_key='{self.object_key}')>"
+
+class ProcessingTask(Base):
+    """处理任务记录表"""
+    __tablename__ = "processing_tasks"
+
+    id = Column(Integer, primary_key=True, index=True)
+    task_id = Column(String(36), unique=True, index=True, nullable=False)
+    stp_file_id = Column(Integer, ForeignKey("stp_files.id"), nullable=False, index=True)
+
+    # 批量上传聚合 ID（批次 2：批量元数据入库——PG 为单一事实源，
+    # 同批任务经此列聚合查询，不再依赖 Redis/进程内存存批量元数据）
+    batch_id = Column(String(36), nullable=True, index=True)
+
+    # 任务类型和状态
+    task_type = Column(String(50), default="stp_parsing")  # stp_parsing, geometry_analysis, mold_generation
+    status = Column(String(20), default="pending")  # pending, processing, completed, failed
+
+    # 时间戳
+    created_time = Column(DateTime, default=func.now())
+    started_time = Column(DateTime, nullable=True)
+    completed_time = Column(DateTime, nullable=True)
+
+    # 处理进度
+    progress = Column(Integer, default=0)  # 0-100
+    current_step = Column(String(100), nullable=True)
+
+    # 错误信息
+    error_message = Column(Text, nullable=True)
+    error_stack = Column(Text, nullable=True)
+
+    # 处理参数
+    parameters = Column(JSON, nullable=True)  # 任务参数
+
+    # 关联关系
+    stp_file = relationship("STPFile", back_populates="processing_tasks")
+
+    def __repr__(self):
+        return f"<ProcessingTask(id={self.id}, task_id='{self.task_id}', status='{self.status}')>"
+
+class MoldCavityData(Base):
+    """模具型腔数据元数据表"""
+    __tablename__ = "mold_cavity_data"
+
+    id = Column(Integer, primary_key=True, index=True)
+    stp_file_id = Column(Integer, ForeignKey("stp_files.id"), nullable=False, index=True)
+
+    # 对象存储信息
+    detailed_object_key = Column(String(500), nullable=False)  # 完整三维数据
+    storage_bucket = Column(String(100), nullable=False)
+
+    # 模具类型和材料
+    mold_material = Column(String(100), default="Aluminum Alloy 7075")
+    mold_type = Column(String(50), default="single_cavity")  # single_cavity, multi_cavity
+
+    # 工艺参数
+    shrinkage_rate = Column(Float, nullable=False)
+    draft_angle = Column(Float, nullable=False)
+    parting_line_length = Column(Float, nullable=True)
+
+    # 生成时间
+    generated_time = Column(DateTime, default=func.now())
+
+    # 关键信息摘要（快速查询字段）
+    cavity_key_info = Column(JSON, nullable=True)  # 完整关键信息
+
+    # 提取的字段（便于查询和排序）
+    mold_size_length = Column(Float, nullable=True)
+    mold_size_width = Column(Float, nullable=True)
+    mold_size_height = Column(Float, nullable=True)
+    estimated_clamping_force = Column(String(50), nullable=True)
+    product_weight = Column(String(50), nullable=True)
+    product_volume = Column(Float, nullable=True)
+    wall_thickness_range = Column(String(50), nullable=True)
+    complexity_score = Column(Float, nullable=True)
+
+    # 质量评估
+    weld_line_risk = Column(String(50), nullable=True)  # 熔接痕风险
+    sink_mark_risk = Column(String(50), nullable=True)   # 缩痕风险
+    warpage_risk = Column(String(50), nullable=True)     # 翘曲风险
+
+    # 多方案可信化摘要（第1周阶段1）
+    best_scheme_id = Column(String(64), nullable=True, index=True)
+    confidence_score = Column(Float, nullable=True)
+    is_fallback = Column(Boolean, nullable=True, index=True)
+    fallback_reason = Column(Text, nullable=True)
+
+    # 关联关系
+    stp_file = relationship("STPFile", back_populates="mold_cavity_data")
+
+    def __repr__(self):
+        return f"<MoldCavityData(stp_file_id={self.stp_file_id}, mold_material='{self.mold_material}')>"
+
+
+class FeatureDetection(Base):
+    """特征检测结果表"""
+    __tablename__ = "feature_detections"
+
+    id = Column(Integer, primary_key=True, index=True)
+    stp_file_id = Column(Integer, ForeignKey("stp_files.id"), nullable=False, index=True)
+
+    # 特征信息
+    feature_type = Column(String(50), nullable=False, index=True)  # thin_wall, thick_wall, wall_non_uniform, rib, boss, draft_angle, high_curvature, fillet
+    confidence = Column(Float, nullable=False)  # 0.0 - 1.0
+
+    # 位置和尺寸
+    location = Column(JSON, nullable=True)  # [x, y, z]
+    dimensions = Column(JSON, nullable=True)  # [length, width, height]
+
+    # 特征参数
+    parameters = Column(JSON, nullable=True)  # 自定义参数
+
+    # 检测时间
+    detected_at = Column(DateTime, default=func.now())
+
+    # 关联的几何数据
+    geometry_data_id = Column(Integer, ForeignKey("geometry_data.id"), nullable=True)
+
+    # 关联关系
+    stp_file = relationship("STPFile", back_populates="feature_detections")
+
+    def __repr__(self):
+        return f"<FeatureDetection(id={self.id}, feature_type='{self.feature_type}', confidence={self.confidence})>"
+
+
+class DesignRecommendation(Base):
+    """设计建议表"""
+    __tablename__ = "design_recommendations"
+
+    id = Column(Integer, primary_key=True, index=True)
+    stp_file_id = Column(Integer, ForeignKey("stp_files.id"), nullable=False, index=True)
+
+    # 建议信息
+    rec_type = Column(String(50), nullable=False)  # wall_thickness, draft_angle, etc.
+    priority = Column(String(20), nullable=False)  # high, medium, low
+    description = Column(String(500), nullable=False)
+    reason = Column(Text, nullable=True)
+
+    # 建议参数
+    parameters = Column(JSON, nullable=True)
+
+    # 状态
+    status = Column(String(20), default="pending")  # pending, accepted, rejected
+    user_notes = Column(Text, nullable=True)
+
+    # 时间戳
+    created_at = Column(DateTime, default=func.now())
+    updated_at = Column(DateTime, nullable=True)
+
+    # 关联关系
+    stp_file = relationship("STPFile", back_populates="design_recommendations")
+
+    def __repr__(self):
+        return f"<DesignRecommendation(id={self.id}, rec_type='{self.rec_type}', priority='{self.priority}')>"
+
+
+class AnalysisMetrics(Base):
+    """分析指标表"""
+    __tablename__ = "analysis_metrics"
+
+    id = Column(Integer, primary_key=True, index=True)
+    stp_file_id = Column(Integer, ForeignKey("stp_files.id"), nullable=False, index=True)
+
+    # 质量指标
+    volume_utilization = Column(Float, default=0)  # 体积利用率
+    topology_complexity = Column(Float, default=0)  # 拓扑复杂度
+    wall_uniformity = Column(Float, default=0)      # 壁厚均匀性
+
+    # 分析摘要
+    analysis_summary = Column(Text, nullable=True)
+
+    # FreeCAD 验证结果
+    verification_status = Column(String(20), nullable=True)  # passed, failed, pending, error
+    verification_volume_diff = Column(Float, nullable=True)  # 体积差异百分比
+    verification_area_diff = Column(Float, nullable=True)    # 表面积差异百分比
+    verification_details = Column(JSON, nullable=True)       # 完整验证结果
+
+    # 时间戳
+    created_at = Column(DateTime, default=func.now())
+
+    # 关联关系
+    stp_file = relationship("STPFile", back_populates="analysis_metrics")
+
+    def __repr__(self):
+        return f"<AnalysisMetrics(stp_file_id={self.stp_file_id}, volume_utilization={self.volume_utilization})>"