JetCheck 新增功能 PRD v2（评审版）

返回首页

1. 文档说明

本文档用于明确当前评审版本的真实产品口径。若本文与 v1 文档存在不一致，以本文为准。

2. 评审基线与使用说明

2.1 本文基于的实现基线

  1. 以 ../demo/client.html、../demo/client.js、../demo/platform.html、../demo/platform.js 的当前实现为基线。
  2. 本轮文档目标不是保留历史方案，而是对齐“当前 demo 已体现的产品设计”。
  3. demo 中保留了少量 Demo: 按钮，仅用于演示场景切换，不属于正式业务功能。

2.2 当前版本的边界说明

  1. 当前 demo 采用静态数据与本地状态模拟，不代表真实后端接口、相机 SDK、文件导出或模型下载实现已最终定稿。
  2. 采图记录模块当前仅保留占位，不作为本轮详细评审对象。
  3. 检测运行的正式触发方为外部控制系统，demo 中使用 Demo: 模拟信号 替代真实触发。

3. 本轮目标

  1. 建立基于手机号账号与设备自动绑定的客户端身份体系。
  2. 明确平台端客户端管理、账号中心与客户端配额展示口径。
  3. 将模型管理从检测实例内能力拆出为客户端独立模块。
  4. 将相机与参数组升级为客户端独立资源，并支撑检测工具配置。
  5. 建立显式可配置的存储提醒、阻断与清理机制。
  6. 完成检测工具配置、运行与检测记录结构的重构。

4. 本轮范围

4.1 本轮纳入评审

  1. 客户端登录、自动绑定、已绑定设备直达系统、客户端本地解绑
  2. 平台端客户端管理与账号中心
  3. 客户端模型管理
  4. 客户端相机管理与参数组管理
  5. 客户端存储管理
  6. 检测工具配置与运行
  7. 检测记录列表、详情、结果查看、导出
  8. 采图工具简化版流程

4.2 本轮暂不展开或仅占位

  1. 采图记录详细页面与导出能力
  2. 平台端除客户端管理外的其他模块
  3. 真实外部系统触发协议、真实相机实时流、真实导出文件结构落地
  4. 服务端接口协议、权限体系、异常恢复机制的技术细节

5. 相对 v1 的关键口径调整

  1. 模型管理不再仅作为“模型选择二级抽屉”，而是升级为客户端一级模块。
  2. 本地模型来源口径收敛为两类：云端同步、本地上传，不再保留“离线导入”。
  3. 平台端客户端列表不再展示企业账号、最近登录时间、最近心跳时间；列表只保留当前账号下已绑定客户端。
  4. 登录页不再提前区分复杂状态，统一按“首次绑定/未绑定”展示，离线与额度已满在点击登录时校验。
  5. 检测记录底层结构已调整为三层：总记录、图像记录、子图记录；页面表现为一级列表 + 二级详情。
  6. 采图工具改为简化版“选相机/参数组 -> 开始采图 -> 运行占位页”。
  7. 采图记录模块当前仅保留占位，不再按 v1 方案要求评审完整列表与导出。

6. 模块需求

6.1 客户端登录与绑定管理

6.1.1 功能目标

  1. 用户使用手机号和登录密码登录客户端。
  2. 登录成功后自动校验当前设备硬件识别码，并完成绑定。
  3. 已绑定设备后续进入客户端时直接进入系统，不再回到登录页。

6.1.2 当前口径

  1. 登录表单包含：
  1. 登录成功后，系统将当前客户端名称写入绑定记录。
  2. 若当前设备未绑定且额度充足，则自动绑定并进入系统。
  3. 若当前设备已绑定，则后续直接进入系统。
  4. 若用户在设置中解绑当前客户端，则设备回到未绑定状态。
  5. 若当前离线或客户端额度已满，均在点击登录按钮后给出失败反馈。

6.1.3 业务规则

  1. 客户端额度按企业账号统一控制。
  2. 同一硬件设备再次登录同一账号，不重复占用额度。
  3. 当前设备解绑后释放额度。
  4. 平台端不提供解绑入口。
  5. 当前 demo 中客户端状态展示仍保留在线/离线模拟，但登录前不再单独铺陈多种页面态。

6.2 平台端客户端管理

6.2.1 功能目标

  1. 展示当前账号下的客户端配额使用情况。
  2. 展示当前账号下已绑定客户端列表。
  3. 提供账号中心，用于维护手机号、联系人、登录密码和企业名称。

6.2.2 当前页面口径

  1. 页面标题右侧展示：客户端配额：已用/总量
  2. 客户端列表字段为：
  1. 筛选项仅包含：

6.2.3 明确不再评审的旧口径

  1. 企业账号字段
  2. 未绑定状态
  3. 最近登录时间
  4. 最近心跳时间
  5. 平台端解绑入口

6.3 模型管理

6.3.1 功能目标

  1. 建立本地模型统一管理页。
  2. 将云端模型作为“添加方式”而不是并列主页面。
  3. 检测实例只能选择本地模型运行。

6.3.2 当前页面结构

  1. 客户端新增一级页面：模型管理
  2. 本地模型页提供：
  1. 云端模型以抽屉方式打开，仅用于查询与下载到本地。

6.3.3 本地模型口径

  1. 本地模型字段为：
  1. 来源仅允许：
  1. 引用情况仅区分：
  1. 场景类型当前支持：

6.3.4 云端模型口径

  1. 支持按“模型名称或版本编号”关键词查询。
  2. 支持按场景类型筛选。
  3. 每个云端模型按模型名聚合展示，版本以列表形式呈现。
  4. 版本项展示：

6.3.5 选择模型规则

  1. 检测实例中使用模型时，只能从本地模型选择。
  2. 图像处理实例若选择“目标检测分类”模式，只能选择 分类 类型模型。
  3. 已被检测工具引用的本地模型不可删除。

6.4 相机管理与参数组管理

6.4.1 功能目标

  1. 将相机作为客户端独立资源管理。
  2. 支持每台相机维护多个参数组。
  3. 为检测工具和采图工具提供可选的相机与参数组资源。

6.4.2 相机管理列表口径

  1. 列表字段为：
  1. 操作包含：
  1. 相机列表不再提供预览操作。
  2. 添加相机时，已添加相机直接过滤不显示。
  3. 离线相机不出现在“添加相机”搜索结果中。

6.4.3 参数组管理口径

  1. 只有相机状态为 空闲 时，才允许进入参数组管理。
  2. 参数组管理采用左右布局：
  1. 参数修改为实时保存，不再需要底部“取消/保存”按钮。
  2. 新增参数组时直接插入左侧列表，并切换到右侧编辑。
  3. 删除入口位于参数组卡片中。
  4. 参数详情区采用更紧凑的多列排布。

6.5 存储管理

6.5.1 功能目标

  1. 让用户感知剩余空间与高风险阈值。
  2. 支持手动清理检测记录与采图记录相关数据。
  3. 将提醒与阻断行为显式化。

6.5.2 当前页面结构

  1. 设置页仅保留两个子页签：
  1. 存储管理当前展示 3 张空间卡片：
  1. 模型文件卡片与模型清理能力已移除。
  2. 页面下方保留阈值设置：

6.5.3 提醒与阻断规则

  1. 当剩余空间低于提醒阈值时，客户端顶部显示提醒条，并提供 去清理 快捷入口。
  2. 当剩余空间低于阻断阈值时，客户端顶部显示阻断提醒，并提供 去清理 快捷入口。
  3. 去清理 跳转到设置页的存储管理。

6.5.4 清理规则

  1. 清理入口放在对应空间卡片内部。
  2. 当前支持清理对象：
  1. 清理时间支持预设：
  1. 支持自定义时间范围。
  2. 清理前需提示用户先导出备份。
  3. 清理检测或采图数据时，会同时清理对应记录及其关联图片，不再沿用“仅清图不清记录”的旧口径。

6.6 检测工具配置

6.6.1 功能目标

  1. 支持以工具为单位组织完整检测流程。
  2. 支持图像获取、图像处理、图像检测三类私有配置对象。
  3. 面向质量负责人提供配置入口，面向操作工提供运行入口。

6.6.2 工具总览口径

  1. 工具列表页仅展示工具卡片。
  2. 工具卡片需区分 未运行 与 运行中 状态。
  3. 当工具处于 未运行 状态时，点击卡片空白区域先打开“启动检测工具”对话框。
  4. 当工具处于 运行中 状态时，点击卡片空白区域进入运行页。
  5. 工具卡片上的 编辑 进入工具配置页。
  6. 新建工具通过底部新建卡片进入。

6.6.3 配置页口径

  1. 配置页标题为工具名称，工具名称右侧提供 编辑名称。
  2. 配置流程分为三步：
  1. 三类实例均设置安全上限 20，展示为 当前数/20，位于新增按钮左侧。

6.6.4 图像获取实例

  1. 图像获取实例支持两种来源：
  1. 创建图像获取实例时，需要上传示例图片。
  2. 示例图片会在后续图像处理配置与运行展示中复用。

6.6.5 图像处理实例

  1. 图像处理实例基于某个图像获取实例创建。
  2. 当前支持三种处理方式：
  1. 手绘 ROI 模式支持：
  1. 全图处理为默认方式，不再通过“全图 ROI”表达。
  2. 当处理方式为“模型 ROI”时，需要选择一个支持类别输出的本地模型。
  3. 若模型存在多个类别，则图像检测实例需按具体类别选择输入目标。
  4. 处理说明字段已取消。

6.6.6 图像检测实例

  1. 图像检测实例关联的是“图像获取实例下的输入目标”。
  2. 页面按图像获取实例分组展示可选输入项。
  3. 对 全图处理 与 手绘 ROI，按处理实例选择。
  4. 对 模型 ROI，按具体类别选择。
  5. 若模型切换导致类别失效，需提示用户重新选择并阻断完整检测运行。
  6. 检测模型从本地模型中选择。

6.7 检测工具运行

6.7.1 运行层级定义

当前检测结果分为三层：

  1. 总结果
  1. 每张图结果
  1. 每张子图结果

6.7.2 当前页面结构

  1. 顶部运行信息：
  1. 左侧：
  1. 中间：
  1. 右侧：

6.7.3 运行规则

  1. 用户必须在进入运行页前选择运行模式。
  2. 确认开始运行后，工具进入 运行中，表示当前资源已被占用并等待外部信号。
  3. 运行中不可切换模式。
  4. 正式单次任务触发由外部系统控制。
  5. demo 中保留 Demo: 调试按钮，仅用于演示，不属于正式业务功能。
  6. 一次检测执行后，页面按图像获取实例顺序自动展示每张图结果。
  7. 所有图像播放完成后，展示最终总结果。
  8. 图像推理结果基于原图显示；手绘 ROI 与 模型 ROI 按 ROI 映射回原图，全图处理 直接显示完整检测结果叠加。
  9. ROI 模式下仅显示 ROI 级业务结果 OK/NG。
  10. 只有全图处理结果才展示类别、置信度或测量结果。
  11. 标签信息支持给当前检测最多添加 3 个自定义标签。
  12. 若当前图像来源为接口输入，则相机信息区域展示为“接口来源，不显示相机信息”。

6.8 检测记录

6.8.1 数据结构口径

检测记录当前按三层组织：

  1. 总记录
  2. 图像记录
  3. 子图记录

6.8.2 页面结构

当前页面采用“两级展示 + 结果查看弹层”的方式：

  1. 一级列表：总记录列表
  2. 二级详情：某条总记录的图像记录列表
  3. 结果查看：复用与运行页相近的结果图查看器
  4. 子图查看：复用与运行页相近的子图结果展示

6.8.3 一级列表字段

  1. 记录编号
  2. 工具名称
  3. 触发时间
  4. 业务结果
  5. 标签
  6. 操作（查看详情）

6.8.4 二级详情字段

  1. 图像获取实例
  2. 输入来源
  3. 图像业务结果
  4. 子图数量
  5. 操作

6.8.5 筛选与分页

  1. 支持按工具筛选。
  2. 支持按业务结果筛选。
  3. 支持时间范围筛选。
  4. 支持关键词搜索（记录编号、工具名称）。
  5. 一级列表支持分页，当前每页 10 条。

6.8.6 导出规则

  1. 导出对象为当前筛选范围内的检测记录。
  2. 导出弹窗按三组勾选：
  1. 各组支持选择对应图片与 Excel 文档导出项。
  2. 当前导出弹窗已做轻量化，不再显示大量说明性文字。

6.9 采图工具与采图记录

6.9.1 采图工具

  1. 采图工具当前简化为：
  1. 开始采图后进入独立运行页。
  2. 当前运行页内容为占位态，后续再补充。

6.9.2 采图记录

  1. 采图记录页面当前仅保留占位。
  2. 本轮开发测试评审不以采图记录页面完整能力为验收目标。

7. 本轮评审重点

  1. 登录、绑定、解绑、额度校验口径是否清晰
  2. 平台端客户端管理字段是否与当前账号体系一致
  3. 模型管理从“选择器能力”升级为独立模块的方案是否可接受
  4. 相机管理、参数组管理、检测工具之间的资源关系是否清晰
  5. 存储提醒、阻断、清理入口和清理范围是否符合预期
  6. 检测工具三步配置是否能支撑现阶段业务
  7. 检测运行三层结果结构是否符合业务表达
  8. 检测记录列表、详情、结果查看与导出是否与三层结构一致
  9. 采图工具与采图记录的当前简化范围是否认可

8. 验收口径建议

  1. 绑定与解绑以手机号账号 + 自动绑定设备为准，不再按旧的多状态登录页口径验收。
  2. 平台端客户端管理以“当前账号下已绑定客户端列表”口径验收。
  3. 本地模型只验收 云端同步 / 本地上传 两类来源，不验收离线导入。
  4. 相机列表不验收预览入口，参数组管理仅验收空闲相机可进入。
  5. 存储管理只验收当前 3 张空间卡片与阈值设置。
  6. 检测运行和检测记录均按“三层结果结构”进行验收。
  7. 采图记录当前不列入完整功能验收。