feat: 打通全栈标注闭环、异步拆帧与模型状态

后端能力： - 新增 Celery app、worker task、ProcessingTask 模型、/api/tasks 查询接口和 media_task_runner，将 /api/media/parse 改为创建后台任务并由 worker 执行 FFmpeg/OpenCV/pydicom 拆帧。 - 新增 Redis 进度事件模块和 FastAPI Redis pub/sub 订阅，将 worker 任务进度广播到 /ws/progress；Dashboard 后端概览接口改为聚合 projects/frames/annotations/templates/processing_tasks。 - 统一项目状态为 pending/parsing/ready/error，新增共享 status 常量，并让前端兼容归一化旧状态值。 - 扩展 AI 后端：新增 SAM registry、SAM2 真实运行状态、SAM3 状态检测与文本语义推理适配入口，以及 /api/ai/models/status GPU/模型状态接口。 - 补齐标注保存/更新/删除、COCO/PNG mask 导出相关后端契约和模板 mapping_rules 打包/解包行为。前端能力： - 新增运行时 API/WS 地址推导配置，前端 API 封装对齐 FastAPI 路由、字段映射、任务轮询、标注归档、导出下载和 AI 预测响应转换。 - Dashboard 改为读取 /api/dashboard/overview，并订阅 WebSocket progress/complete/error/status 更新解析队列和实时流转记录。 - 项目库导入视频/DICOM 后创建项目、上传媒体、触发异步解析并刷新真实项目列表。 - 工作区加载真实帧、无帧时触发解析任务、回显已保存标注、保存未归档 mask、更新 dirty mask、清空当前帧后端标注、导出 COCO JSON。 - Canvas 支持当前帧点/框提示调用后端 AI、渲染推理/已保存 mask、应用模板分类并维护保存状态计数；时间轴按项目 fps 播放。 - AI 页面新增 SAM2/SAM3 模型选择，预测请求携带 model；侧边栏和工作区新增真实 GPU/SAM 状态徽标。 - 模板库和本体面板接入真实模板 CRUD、分类编辑、拖拽排序、JSON 导入、默认腹腔镜分类和本地自定义分类选择。测试与文档： - 新增 Vitest 配置、前端测试 setup、API/config/websocket/store/组件测试，覆盖登录、项目库、Dashboard、Canvas、工作区、模型状态、时间轴、本体和模板库。 - 新增 pytest 后端测试夹具和 auth/projects/templates/media/AI/export/dashboard/tasks/progress 测试，使用 SQLite、fake MinIO、fake SAM registry 和 Redis monkeypatch 隔离外部服务。 - 新增 doc/ 文档结构，冻结当前需求、设计、接口契约、测试计划、前端逐元素审计、实现地图和后续实施计划，并同步更新 README 与 AGENTS。验证： - conda run -n seg_server pytest backend/tests：27 passed。 - npm run test:run：54 passed。 - npm run lint、npm run build、compileall、git diff --check 均通过；Vite 仅提示大 chunk 警告。
2026-05-01 13:29:14 +08:00
parent 4d65c37c73
commit f020ff3b4f
78 changed files with 7089 additions and 456 deletions
--- a/backend/routers/dashboard.py
+++ b/backend/routers/dashboard.py
@@ -0,0 +1,137 @@
+"""Dashboard overview endpoints."""
+
+import os
+from datetime import datetime, timezone
+from typing import Any
+
+from fastapi import APIRouter, Depends
+from sqlalchemy import func
+from sqlalchemy.orm import Session
+
+from database import get_db
+from models import Annotation, Frame, ProcessingTask, Project, Template
+
+router = APIRouter(prefix="/api/dashboard", tags=["Dashboard"])
+
+ACTIVE_TASK_STATUSES = {"queued", "running"}
+
+
+def _system_load_percent() -> int:
+    """Return a real host load estimate without adding a psutil dependency."""
+    try:
+        load_1m = os.getloadavg()[0]
+        cpu_count = os.cpu_count() or 1
+        return min(100, max(0, round((load_1m / cpu_count) * 100)))
+    except (AttributeError, OSError):
+        return 0
+
+
+def _iso_or_none(value: datetime | None) -> str | None:
+    if value is None:
+        return None
+    if value.tzinfo is None:
+        value = value.replace(tzinfo=timezone.utc)
+    return value.isoformat()
+
+
+def _task_payload(task: ProcessingTask) -> dict[str, Any]:
+    return {
+        "id": f"task-{task.id}",
+        "task_id": task.id,
+        "project_id": task.project_id or 0,
+        "name": task.project.name if task.project else f"任务 {task.id}",
+        "progress": task.progress,
+        "status": task.message or task.status,
+        "frame_count": (task.result or {}).get("frames_extracted", 0),
+        "updated_at": _iso_or_none(task.updated_at),
+    }
+
+
+@router.get("/overview", summary="Get dashboard overview")
+def get_dashboard_overview(db: Session = Depends(get_db)) -> dict[str, Any]:
+    """Return live dashboard data derived from persisted backend records."""
+    project_count = db.query(func.count(Project.id)).scalar() or 0
+    frame_count = db.query(func.count(Frame.id)).scalar() or 0
+    annotation_count = db.query(func.count(Annotation.id)).scalar() or 0
+    template_count = db.query(func.count(Template.id)).scalar() or 0
+    active_task_count = (
+        db.query(func.count(ProcessingTask.id))
+        .filter(ProcessingTask.status.in_(ACTIVE_TASK_STATUSES))
+        .scalar()
+        or 0
+    )
+
+    projects = db.query(Project).order_by(Project.updated_at.desc()).all()
+    recent_tasks = (
+        db.query(ProcessingTask)
+        .order_by(ProcessingTask.created_at.desc())
+        .limit(50)
+        .all()
+    )
+    tasks = [_task_payload(task) for task in recent_tasks if task.status in ACTIVE_TASK_STATUSES]
+
+    activities: list[dict[str, Any]] = []
+    for task in recent_tasks[:10]:
+        project_name = task.project.name if task.project else f"项目 {task.project_id}"
+        activities.append({
+            "id": f"task-{task.id}",
+            "kind": "task",
+            "time": _iso_or_none(task.updated_at),
+            "message": task.message or f"任务状态: {task.status}",
+            "project": project_name,
+        })
+
+    for project in projects[:10]:
+        activities.append({
+            "id": f"project-{project.id}",
+            "kind": "project",
+            "time": _iso_or_none(project.updated_at),
+            "message": f"项目状态: {project.status}",
+            "project": project.name,
+        })
+
+    recent_annotations = (
+        db.query(Annotation)
+        .order_by(Annotation.updated_at.desc())
+        .limit(10)
+        .all()
+    )
+    for annotation in recent_annotations:
+        project_name = annotation.project.name if annotation.project else f"项目 {annotation.project_id}"
+        activities.append({
+            "id": f"annotation-{annotation.id}",
+            "kind": "annotation",
+            "time": _iso_or_none(annotation.updated_at),
+            "message": f"标注已更新 #{annotation.id}",
+            "project": project_name,
+        })
+
+    recent_templates = (
+        db.query(Template)
+        .order_by(Template.created_at.desc())
+        .limit(10)
+        .all()
+    )
+    for template in recent_templates:
+        activities.append({
+            "id": f"template-{template.id}",
+            "kind": "template",
+            "time": _iso_or_none(template.created_at),
+            "message": f"模板可用: {template.name}",
+            "project": "系统",
+        })
+
+    activities.sort(key=lambda item: item["time"] or "", reverse=True)
+
+    return {
+        "summary": {
+            "project_count": project_count,
+            "parsing_task_count": active_task_count,
+            "annotation_count": annotation_count,
+            "frame_count": frame_count,
+            "template_count": template_count,
+            "system_load_percent": _system_load_percent(),
+        },
+        "tasks": tasks,
+        "activity": activities[:10],
+    }