架构地图

这里是「概念（架构）」板块的导航页。每篇文档回答一个「为什么」或「是什么」，而非「怎么做」。

想做具体操作？去 How-to。想排查问题？去 故障排查。

先看哪里

新人路径：
  系统全景（overview）
    → 业务域模型（project / batch / task / annotation / review）
      → 工作流机制（状态机 / 派题 / 锁 / 权限）
        → 端到端流程（batch lifecycle / AI handoff）
          → AI 子系统 / 平台实现

总览

• 架构地图： 概念章节入口与阅读顺序
• 系统全景： 各模块是什么、怎么拼在一起

业务域模型

• 项目模块： Project 承载哪些配置、权限和统计边界
• 批次模块： Batch 状态机、分派、调度联动和 bulk 行为
• 任务模块： Task 状态机、锁、审核流和可见性如何工作
• 标注模块： Annotation 的数据模型、采纳、版本控制与 task / batch 回写
• 视频标注工作台： 视频元数据、manifest、video_bbox schema 与前端 Stage 边界
• 审核模块： Task review、batch review、角色矩阵与通知审计联动

工作流与协作机制

• 状态机总览： Project / Batch / Task 三套状态机如何联动
• Scheduler 与派题： /tasks/next 如何选题、过滤和上锁
• Task Lock： 锁的 TTL、接管、续期和并发保护
• 可见性与权限： 用户为什么能看到某个 project / batch / task
• 计数与派生字段： 聚合字段如何回写、哪些页面依赖它们
• 审计与通知： 业务动作如何落审计、怎样 fan-out 到在线用户

端到端业务流程

• 批次生命周期（端到端）： 从建批、预标、送审到归档 / 重置的完整链路
• AI 预标注接管： pre_annotated 的进入、人工接管、清理与回滚
• 数据流： 一条标注从上传到导出走哪些节点

AI 与推理子系统

• 预标注流水线： Job 生命周期、Celery 任务链、错误处理
• AI 模型集成： GroundingDINO / SAM 怎么接入，预测怎么存

平台实现架构

• 后端分层： FastAPI / Service / Repository 各层边界
• 前端分层： 页面 / 组件 / Store / API Client 的关系
• 工作台 Shell 架构： 标注 / 审核模式与 image / video / 3D Stage 边界
• API Schema 边界： 前后端契约在哪里定义、如何保证一致
• 后端基础设施（容器）： 哪些容器，各自职责，容器间网络
• 部署拓扑： 生产环境的网络拓扑与服务边界
• 性能 HUD： 开发期内置性能面板的原理与使用

尚未覆盖（待补充）

• WebSocket 实时通知架构（详见 ws-protocol，ADR 层面的 rationale 待写）
• 多租户 / 权限边界（见 安全模型）