product-v1_4-dev

# product-v1_4-dev

JetCheck 1.4 开发工作区，当前主题是“尺寸检测场景支持”。

本工作区用于承接 JetCheck 1.4 版本开发。当前内容以 `product-v1_3-dev` 为基线复制而来，1.3 继续作为已评审基线保留，不直接在其上推进 1.4 需求。

## 当前状态（2026-04-09）

1. 路线已确认：独立本地尺寸工具 + JetCheck 融合。
2. 职责已确认：尺寸工具负责编辑/验证/发布，JetCheck 客户端负责正式运行与记录。
3. 核心框架已形成：标定、ROI、测量项、验证、发布、运行前校验、记录追溯。
4. 术语已初步收口：当前交互文档优先采用“ROI / 尺寸方案 / 发布版本 / 标定记录”。
5. 一期策略已收敛：保守推进，优先最小完整闭环。
6. 材料已收敛：本工作区仅保留 1.4 主线文档、demo、样例图、参考 PDF。

## 快速接手

如果是第一次接手这个工作区，建议按下面顺序阅读：

1. 本 README
2. `docs/1.4尺寸检测方案决策清单-v0.1.md`
3. `docs/1.4对象模型草案-v0.1.md`
4. `docs/1.4主流程与异常流程草案-v0.1.md`
5. `docs/1.4运行前校验规则草案-v0.1.md`
6. `docs/1.4尺寸工具交互设计草案-v0.1.md`
7. `docs/1.4工程管理页面设计草案-v0.1.md`
8. `docs/1.4一期白名单能力清单-v0.1.md`
9. `docs/1.4尺寸工具能力拆解-v0.1.md`
10. `docs/1.4一期测量项分层与命名建议-v0.1.md`

## 当前术语约定

1. `尺寸工程`
   - 编辑态容器，承载标定、ROI、测量项、验证数据。
2. `尺寸方案`
   - 面向客户端识别和引用的逻辑对象。
3. `发布版本`
   - 某次冻结后的可运行产物，客户端实际消费它。
4. `标定配置`
   - 某工程下的标定资源定义，约束适用相机/参数组/分辨率等条件。
5. `标定记录`
   - 某次具体标定的结果快照，系统内部保留用于追溯。
6. `ROI`
   - 当前交互文档中用于指代图像上的定位与操作区域。

## 文件地图

### `docs/`（1.4 主线设计文档）

| 文件 | 作用 |
| --- | --- |
| `1.4尺寸检测方案决策清单-v0.1.md` | 已确认口径、关键问题和待收口项 |
| `1.4尺寸工具能力拆解-v0.1.md` | 尺寸工具能力域拆解 |
| `1.4一期测量项分层与命名建议-v0.1.md` | 基于 TM-X 和现有工具截图整理的一期测量项分层建议 |
| `1.4对象模型草案-v0.1.md` | 关键对象、对象关系与解耦方式 |
| `1.4主流程与异常流程草案-v0.1.md` | 从配置到运行的主流程与异常处理 |
| `1.4运行前校验规则草案-v0.1.md` | 客户端运行前的自动恢复/阻断策略 |
| `1.4尺寸工具交互设计草案-v0.1.md` | 尺寸工具的交互骨架、导航形式与步骤约束思路 |
| `1.4工程管理页面设计草案-v0.1.md` | 工程管理窗口的页面目标、结构、列表字段与交互规则 |
| `1.4一期白名单能力清单-v0.1.md` | 一期建议纳入与明确不纳入的范围 |

### `demo/`（当前原型基线）

1. `index.html`：demo 导航入口
2. `dimension-tool.html` + `dimension-tool.js`：独立本地尺寸工具雏形（工程工作台骨架）
3. `client.html` + `client.js`：客户端原型（运行态与记录）
4. `platform.html` + `platform.js`：平台端原型
5. `shared.js`：客户端/平台端共享状态和工具函数
6. `styles.css`：共享样式

### `sample-images/`

demo 使用的样例图。

### 参考 PDF

1. `AS_152276_TM-X5000_UM_L96CN_KC_CN_2035_1.pdf`
2. `尺寸测量工具.pdf`

## 边界约束

1. 默认只修改本工作区。
2. `reference/` 只作参考，不作为当前口径直接替代。
3. 需要追溯 1.3 历史材料时，回到 `workspaces/product-v1_3-dev/` 查看。

## 文档规则

1. 遵循仓库根 README 的长期协作规则。
2. 本工作区文档只记录当前结论，不写大段建议、计划和重复说明。
3. 除 README 外，独立文档只保留对象、流程、规则、范围、命名这类有设计价值的议题。
4. 每次新增/删除/重命名材料后，同步更新本 README 的 `当前状态 / 快速接手 / 文件地图`。