后端设计治理：批次 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>
2026-09-17 16:15:49 +08:00
parent 4537faf2c4
commit 0e6b3b1811
82 changed files with 6513 additions and 3709 deletions
@@ -0,0 +1,131 @@
+# services/file_history_service.py
+"""文件历史查询视图——按文件名分组的多版本上传历史。
+
+批次 3 自 storage_integration_rustfs.py 按职责拆分（见 task_storage_service.py 头注）。
+"""
+from typing import Optional
+
+from sqlalchemy import select, func, desc
+from sqlalchemy.ext.asyncio import AsyncSession
+from sqlalchemy.orm import joinedload
+
+from moldinsight.models import STPFile, ProcessingTask
+from shared.utils.logger import get_logger
+
+logger = get_logger(__name__)
+
+
+class FileHistoryService:
+    """按文件名聚合的上传历史查询"""
+
+    async def get_file_history_by_filename(
+        self,
+        session: AsyncSession,
+        filename: str,
+        user_id: Optional[int] = None,
+        limit: int = 50
+    ) -> list:
+        """获取同一文件名的所有上传历史记录"""
+
+        query = select(STPFile).options(
+            joinedload(STPFile.processing_tasks)
+        ).where(
+            STPFile.original_filename == filename
+        ).order_by(STPFile.upload_time.desc())
+
+        if user_id:
+            query = query.where(STPFile.user_id == user_id)
+
+        query = query.limit(limit)
+
+        result = await session.execute(query)
+        files = result.unique().scalars().all()
+
+        return [
+            {
+                'id': f.id,
+                'task_id': f.processing_tasks[0].task_id if f.processing_tasks else None,
+                'upload_batch': f.upload_batch,
+                'upload_time': f.upload_time.strftime('%Y-%m-%d %H:%M:%S') if f.upload_time else None,
+                'file_size': f.file_size,
+                'status': f.status,
+                'volume': f.volume,
+                'surface_area': f.surface_area,
+                'product_weight': f.product_weight,
+                'has_analysis': f.status == 'completed'
+            }
+            for f in files
+        ]
+
+    async def get_all_file_groups(
+        self,
+        session: AsyncSession,
+        user_id: Optional[int] = None,
+        limit: int = 100
+    ) -> list:
+        """获取所有文件分组（按文件名分组），包含每个文件的最新分析结果"""
+
+        # 子查询：获取每个文件名的最新上传
+        subquery = (
+            select(
+                STPFile.original_filename,
+                func.max(STPFile.upload_time).label('latest_upload')
+            )
+            .group_by(STPFile.original_filename)
+            .order_by(desc('latest_upload'))
+            .limit(limit)
+        )
+
+        if user_id:
+            subquery = subquery.where(STPFile.user_id == user_id)
+
+        subquery = subquery.subquery()
+
+        # 主查询：获取最新记录和统计信息
+        query = (
+            select(STPFile).options(
+                joinedload(STPFile.processing_tasks)
+            )
+            .join(
+                subquery,
+                (STPFile.original_filename == subquery.c.original_filename) &
+                (STPFile.upload_time == subquery.c.latest_upload)
+            )
+            .order_by(STPFile.upload_time.desc())
+        )
+
+        result = await session.execute(query)
+        latest_files = result.unique().scalars().all()
+
+        # 一次性聚合每个文件名的上传次数（替代逐文件 count 的 N+1 查询）
+        count_subquery = (
+            select(STPFile.original_filename, func.count().label("upload_count"))
+            .group_by(STPFile.original_filename)
+        )
+        if user_id:
+            count_subquery = count_subquery.where(STPFile.user_id == user_id)
+        count_result = await session.execute(count_subquery)
+        upload_counts = {
+            row.original_filename: row.upload_count for row in count_result
+        }
+
+        # 获取每个文件名的上传次数
+        file_groups = []
+        for f in latest_files:
+            task_id = f.processing_tasks[0].task_id if f.processing_tasks else None
+            upload_count = upload_counts.get(f.original_filename, 1)
+
+            file_groups.append({
+                'filename': f.original_filename,
+                'latest_id': f.id,
+                'latest_task_id': task_id,
+                'latest_upload_time': f.upload_time.strftime('%Y-%m-%d %H:%M:%S') if f.upload_time else None,
+                'latest_status': f.status,
+                'upload_count': upload_count,
+                'file_size': f.file_size,
+                'volume': f.volume,
+                'surface_area': f.surface_area,
+                'product_weight': f.product_weight
+            })
+
+        return file_groups