27 KiB
新版 API 验证记录
验证日期:2026-10-12,采用 docs/admin-api.md。当前联调目标为 https://dev-cadworld-api.robotquan.com;此前联调记录使用原开发地址。
代码与契约
-
当前仅保留组件库、用户管理、操作日志,以及要求保留的临时登录。
-
删除 32 个废弃源码文件、旧数据库/上传/机械接口测试、历史联调说明和废弃资源样例,清理 198 条不可达 CSS 规则及 JSZip、fake-indexeddb、Zod 依赖。
-
源码导入检查没有不可达业务文件。源码不再包含 IndexedDB、接口库、姿态/BREP、选面选孔、ZIP/备份和旧上传会话 API。
-
单元测试覆盖完整扁平表单、自由分类、非负数及精度、两组自定义字段、STEP/URDF 路径规则、OSS 授权字段/文件顺序、单资源替换、续签/到期/重试、版本合并、通用日志过滤、用户字段映射、登录和 URDF 依赖解析。
-
最终检查:8 个测试文件、39 项测试通过;TypeScript 检查、生产构建和全项目格式检查通过。
实际后端验证
- 组件列表、签名、用户列表、操作日志列表和详情使用新版路由。
- 签名正常返回组件编码、令牌、两类 POST 授权;没有创建会话或 complete 请求。
- 用项目中的公开测试样例从服务端分别直传一个 STEP、一个 URDF 和 STL 依赖文件,OSS 均返回 204。
- 保存完整表单及两组自定义字段成功,组件 version 从 1 开始。
- 表单更新成功,未提交资源替换字段时原 Key 保持不变。
- 浏览器加载后端组件详情,STEP 显示 10 个模型面,URDF 按需下载后显示 2 个 Link、1 个关节;质量 0 和自定义字段均正确恢复。
- 浏览器模拟同时编辑:远端更新名称和说明,本地修改说明;保存收到 409 后显示冲突选择。本地说明与远端新名称合并,重新保存成功,version 增至 4。
- 下载三个资源并计算 SHA-256,均与上传样例字节一致。
- 已删除本次创建的联调组件记录。DELETE 成功,操作日志保留删除前的名称、编码、目标 ID 和请求编号;成功修改、冲突失败及删除均可查询。OSS 中的联调文件依照当前后端策略保留,前端不提供云文件清理接口。
接口复查补充(2026-10-12)
- 通过本机
/admin-api代理重新查询组件、用户、日志列表,以及用户和日志详情,均返回 HTTP 200、code=OK。 - 上传签名与同一令牌续签均返回 HTTP 200、
code=OK,续签令牌保持一致。 - OSS 对
Origin: http://127.0.0.1:8091、请求方法 POST 的跨域预检返回 HTTP 403,仍无Access-Control-Allow-Origin。 - 专门创建临时普通用户,读取详情,修改昵称、角色和停用状态,按手机号/角色/状态筛选,再恢复启用,均成功;重复手机号返回预期的 409
USER_PHONE_DUPLICATE。 - 已逻辑删除本次测试用户,删除返回 HTTP 200;删除后详情返回预期的 404
USER_NOT_FOUND,按测试手机号查询列表为 0 条。没有修改原有用户;按后端规则,逻辑删除的测试手机号仍会占用。 - 上述用户测试是通过代理执行真实 API 请求;没有据此宣称用户页面的每一个交互均已重新进行浏览器测试。组件资源替换、大文件和长时间续传仍需在 OSS CORS 修复后完成浏览器端到端复测。
当前上传状态:正式直传,OSS CORS 待配置
- 上传已恢复为
admin-api.md规定的后端签名、浏览器直传 OSS、后端校验保存;删除本机上传代理、硬编码 Bucket 的适配与对应部署说明。 - 开发、preview 和正式构建都直接使用签名响应的
uploadUrl,上传不带浏览器 Cookie,不依赖 Vite 转发文件。增加测试,验证更换后端返回的生产 Bucket 地址时无需修改业务代码。 - 之前通过同源转发得到的浏览器上传成功记录,只证明文件与保存链路可用,不能作为当前正式直传方式通过的证据。其测试组件记录已清理,OSS 样例文件按后端策略保留;当前没有宣称直传端到端完成。
- 当前 OSS 预检对本机来源返回 403,缺少允许来源的响应头;缺少 OSS 配置权限,未修改云端 CORS。正式前端域名用户已明确为未定。
deployment.md记录目标 Bucket CORS、生产 API 网关、HTTPS 与静态路由回退的配置要求。npm run check:oss-cors可以只读检查指定来源,不自动修改云配置,也不替代真实浏览器上传验收。- 组件 keyword/category 已实测匹配与不匹配;日志 module、action、success、operatorId、keyword、targetId、targetType、targetCode、from、to 各实测匹配与不匹配,共 20 项通过。所有列表展示后端 items/total,查询层限制为文档字段,不做本地业务筛选或排序。
- 先前的组件单资源替换联调中,STEP 替换保留 URDF,URDF 替换保留 STEP,版本递增符合契约;正式 CORS 配置完成后仍需在实际部署来源复测。
- 当前 9 个测试文件、43 项测试覆盖上传、表单、版本冲突、查询契约和预览依赖;正式域名 CORS、大文件与长时间弱网上传未完成验收。
隐藏 URDF 装配测试页(2026-10-12)
- 连续点击 Logo 三次进入受当前登录保护的
/assembly-test,侧边栏不增加入口;刷新测试页可重新加载样例。 - 随项目发布躯干和 H-DOF0-R 的 URDF 与网格,共 9 份原始文件。逐一校验与用户提供的源文件、生产 dist 副本字节相同;运行时不依赖 Downloads 路径。
- 默认分离展示完整模型;J1 与 base_link 仅为手动试装的预选项,不推断坐标系用途。点击试装对齐时,位置为
[-100.38, 10, 0] mm,采用原点重合、Z 相向、X 同向的可切换假设。坐标变换支持非零源安装口偏移、完整旋转、局部轴间距及转角。 - 浏览器实际验证三次点击入口、J3 安装口切换、分离查看、安装对齐、改为 Link1 坐标系并调整旋转关节。B 根位姿随选择和关节角度更新,显示三维原始网格及坐标标记。
- 原始 Link1 网格为空,页面仅说明此事实,不生成替代网格,也不将试装结果标为机械接口已确认。完整显示原始 visual 与全部子零件;已删除测试时的统一染色和子零件隐藏处理,坐标辅助默认关闭。
- 添加 4 项装配矩阵测试;当前共 10 个测试文件、47 项通过,TypeScript、生产构建与格式检查通过。
上传时读取 URDF 点位(2026-10-12)
- 右侧新增“安装点位”标签,选择 URDF 后自动进入。仅展示原始 joint/origin;XYZ 为米,RPY 为弧度,不生成安装角色或配对,不换算或改写原始数值。
- 浏览器验证躯干 J1~J4 的读取与切换、更换为 H-DOF0-R 后刷新为 Link1(revolute),读取轴向及上下限、力矩、速度;移除文件后清空点位。
- 数据读取先于网格预览;编辑已有组件时按需下载现有 URDF,新增流程没有新增 API 字段或请求。测试过程未点击保存或修改后端数据。
- 新增 5 项原始点位解析测试,覆盖两份实际样例、排除 visual/inertial 坐标、缺省值与精度、非法结构/数值。共 11 个测试文件、52 项通过;TypeScript、生产构建、格式检查通过。
- 测试页将普通子 Link 从点位选择列表移除,根 Link 明确标为参考坐标系,关节保留文件类型 fixed/revolute,避免将 fixed 误称为已确认安装位。
安装关系完全由机械文件定义(2026-10-12)
- 删除测试页的默认 J1/base_link 配对、Z 轴朝向选择、旋转/间距补偿、关节角度修改、坐标标记与安装结果计算;删除仅用于上述假设的 assembly.ts 及其 4 项测试。
- 保留三次点击 Logo 的入口,改为 URDF 文件检查:用标签分别预览原始文件,不改变模型根位姿,不将两份缺少跨文件安装关系的 URDF 自动拼装。
- 点位只读解析器不再为缺失的 xyz/rpy/axis 属性填入默认数值,界面标明“文件未定义”。原文件始终按原始字节上传;父子关系来自文件,不提供编辑或重绑定。
- 浏览器验证两个原文件标签切换及点位展示,确认已无试装对齐、坐标补偿、关节调节或安装结果控件。历史手动试装记录仅描述此前版本,已被本节变更取代。
- 当前 10 个测试文件、49 项通过;TypeScript、生产构建及格式检查通过。新增回归检查确保缺失的 origin 属性与 axis 不会被补成坐标值。
统一只读展示(2026-10-12)
- 上传页与隐藏文件检查页共用同一个只读组件;移除坐标系下拉框与选中状态,按文件顺序列出全部 joint/origin。
- 点位列表只用于查看文件内容,父子关系、坐标、轴向、限位全部来自原文件;没有重新绑定、手动调整或安装选择操作。
- 安装关系仍须由机械文件明确,程序不通过名字或第一个点位猜测配对。
- 浏览器核对躯干 J1~J4 全部列出且数值与文件一致,点位面板没有选择框;URDF 原始信息及模型读取相关 9 项测试、TypeScript、生产构建和格式检查通过。
两个标签与原始点位悬停高亮(2026-10-12)
- 上传页右侧统一为“安装点位”和“匹配信息”,点位在前。原基本信息/参数表单合并到匹配信息,同一表单继续保留原 API 字段和校验。
- 悬停/聚焦点位时显示预览专用蓝色点标记,位置读取对应 URDF joint 的真实世界变换;标记单独放在预览场景,不修改原始模型位姿、材质或层级。移开、切换标签或资源后移除。
- 不在 STEP 与 URDF 之间猜测点位映射;悬停时切回 URDF 预览。已有组件优先读取 URDF,STEP 预览按需加载。
- 新增测试核对嵌套旋转关节下的原始点位位置与模型不变,并拒绝其他文件的旧点位引用。
- 浏览器验证两个标签、J1/J2 点位联动高亮、切换表单后标记消失、填写值跨标签保留;测试填写值已还原,未点击保存。共 11 个测试文件、51 项通过,TypeScript、生产构建及格式检查通过。
- 父/子 Link 标签改为“文件内父节点/子节点”,注明这些字段仅表示单份 URDF 内部结构,不代表跨零件安装关系;BASE 原值直接来自文件的 parent/link。
自由旋转与点位自动取景(2026-10-12)
- 悬停/聚焦文件点位时,相机在 500ms 内平滑转到点位所在方向并将点位居中。手动操作相机立即中止自动取景;不修改模型姿态、材质、内部关系、文件数值或上传内容。取景方向不作为安装数据。
- 统一预览改为自由轨迹球控制,可越过旋转极点及查看底部;左键旋转、右键平移、滚轮缩放,地面网格已移除。
- 右下角 XYZ 为实时视图方向指示,按相机姿态投影,增大字体并避开标签重叠,不添加模型坐标系。
- 使用用户提供的躯干文件验证 J1/J2 自动定位、手动翻转、重置视角和无网格显示,未提交保存或调用上传接口。
- 新增相机取景不改模型、中心点退化处理及底部视角 XYZ 投影测试;12 个测试文件共 54 项通过,TypeScript、生产构建及格式检查通过。
窗口自适应与标签调整(2026-10-12)
- 上传页标签依次为“零件描述 / 基本信息”,默认零件描述,保留原表单和文件点位内容。导入 URDF 不再强制切换标签;键盘 Home/End 与左右键顺序同步调整。
- 外壳约束为窗口高度,上传页与文件检查页左右面板上下边界对齐,模型预览填满剩余空间,长表单与点位独立滚动。列表页工具栏、分页固定在面板内,表格/卡片独立滚动,长筛选区限制高度。
- 浏览器测量上传页在 1920×1080、1280×720、1024×768 下左右底边一致,文档宽高等于窗口;390×844 下采用上下布局,工作区内部滚动,文档无溢出。
- 文件检查页在 1280×720 下左右均为 464px 高,点位内容 1335px 在 407px 容器内滚动;日志页 390×844 下筛选区内部滚动,分页仍在窗口内。日志接口此次返回 HTTP 500,仅验证错误状态布局,未修改接口请求或后端数据。
- 导入躯干后仍默认展示零件描述,基本信息显示原始 J1~J4;Home 键切回首个描述标签。聚焦底部标签字段时表单内部滚动约 400px,文档及 page 容器滚动均保持 0。
- 生产构建及格式检查通过;未增加布局单元测试,使用实际浏览器尺寸、边界和滚动高度验证。
官方视角控件(2026-10-12)
- 统一模型预览直接使用 Three.js 自带 ViewHelper;删除自绘 SVG、坐标投影函数、旧外框和相应样式。本节取代此前自绘 XYZ 指示实现。
- 控件由 Three.js 在独立视口渲染,点击轴可围绕当前查看中心切换视角。与 TrackballControls 同步相机朝向,保留 360° 旋转、平移、缩放、重置及原始点位自动取景。
- 新增实际 ViewHelper 与 TrackballControls 的衔接回归测试:非零查看中心、Z 朝上的初始视角切换到 X 轴后,相机仍准确朝向查看中心,中心坐标不变。
- 浏览器使用原始躯干文件核对控件显示、点击 X 轴后模型居中、基本信息点位高亮与自动取景;未调用保存上传。13 个测试文件共 54 项通过,生产构建及格式检查通过。
预览过曝与孔位细节(2026-10-12)
- 移除过强且带色偏的照明,使用中性半球补光(0.35)、主方向光(1.4)和弱补光(0.25),启用 ACES 色调映射,曝光 0.85。
- 主光启用 2048px PCFSoft 阴影;光源位置、阴影相机范围和法线偏移随模型包围盒尺寸适配。模型投射/接收自身阴影,预览卸载时恢复原始阴影标记;没有修改材质、几何、文件变换或上传数据。
- 浏览器使用同一份原始躯干 URDF,放大及旋转核对多个侧面的孔位、接口和凹槽;白色表面不再整片过曝,凹槽可见遮挡阴影。未保存或上传资源。
- 生产构建、54 项现有测试及格式检查通过;照明变化通过实际渲染验证。
新开发域名接口复查(2026-10-12)
目标:https://dev-cadworld-api.robotquan.com,通过运行中的同源 /admin-api 代理测试。直连组件列表与代理均为 HTTP 200 / OK。
| 接口 | 实测结果 |
|---|---|
POST /admin-api/storage/upload-signature |
首次申请、原会话续签、已有组件资源替换均 200;续签保留令牌、编码及两类资源前缀 |
GET /admin-api/components |
分页与 keyword/category 查询 200,测试组件精确检出,清理后 total=0 |
POST /admin-api/components |
小样例实际直传后保存 200,初始 version=1,完整表单返回一致 |
GET /admin-api/components/{id} |
测试组件详情 200,表单、资源清单与保存内容一致 |
PUT /admin-api/components/{id} |
全量表单更新、单独替换 STEP、单独替换 URDF 均 200;版本递增,未替换的资源保持原引用 |
DELETE /admin-api/components/{id} |
仅删除本次新建测试组件,200;删除后详情 404 / COMPONENT_NOT_FOUND |
GET /admin-api/component-assets/{objectKey} |
STEP、URDF、STL 均 200,下载 SHA-256 与项目样例一致 |
GET /admin-api/users |
分页、keyword、userType、status 请求均 200,能检出已知记录 |
GET /admin-api/users/{id} |
现有记录详情 200,文档字段齐全;不存在记录 404 / USER_NOT_FOUND |
POST /admin-api/users |
非法手机号返回 422 / INVALID_REQUEST;正常新增未实测,避免占用手机号 |
PUT /admin-api/users/{id} |
非法输入返回 422 / INVALID_REQUEST;未修改现有用户,正常修改未实测 |
DELETE /admin-api/users/{id} |
不存在记录返回 404 / USER_NOT_FOUND;未删除现有用户,正常逻辑删除未实测 |
GET /admin-api/operation-logs |
分页及文档十项筛选均 200;测试组件留下 CREATE、三次 UPDATE、DELETE 五条成功日志,目标 ID/编码/名称可回查 |
GET /admin-api/operation-logs/{id} |
已有记录详情 200,字段匹配;不存在记录 404 / OPERATION_LOG_NOT_FOUND |
参数校验:空组件请求、非法用户手机号、互斥签名参数、倒置日志时间区间均按约定返回 422;不存在的组件/用户删除按约定 404。这些是正常校验响应,不是接口故障。现有前端 54 项测试和 TypeScript 检查通过。
尚未打通的是浏览器 OSS 跨域上传。 使用签名返回的真实地址测试,http://127.0.0.1:8091 和 http://localhost:8091 的 POST 预检均为 403,未返回允许来源/方法/请求头。命令行实际 POST 六个小样例资源均返回 204,但也没有 Access-Control-Allow-Origin;命令行不受浏览器 CORS 约束,所以这些成功不能视为页面上传验收成功。需由 Bucket 管理员配置允许来源、POST 和 Content-Type,详见部署文档;无需修改组件 API 的前端参数或添加临时上传代理。
本次未改动现有用户与业务组件。测试组件 ID=3 已删除;按后端既定保留策略,联调审计日志及六个小样例 OSS 对象(总计 266056 字节)仍保留。未记录签名字段、上传令牌或用户手机号。
定位请求编号:首次签名 8afe25984e7a4621983ae4fc257d8479;组件新增 e7e97eb59b2f4d408c2aa0cab41d1cf1;STEP 替换 ec3b7d5090d14717b1c4be47a50c7f25;URDF 替换 00d3c2778d4942b5b7af4a1995a70bb8;测试组件删除 da4bc76147644ff291bdfeedc4b743db。
STEP 与 URDF 统一预览颜色(2026-10-12)
- 两种格式统一通过显示副本使用中性灰 MeshStandardMaterial(颜色
#e0e0e0、金属度 0、粗糙度 0.75),共享当前预览灯光和曝光。本节取代此前预览直接使用原始文件材质的显示策略。 - 原模型、原材质及文件字节不改动,副本只共享几何;保留模型变换、材质槽、透明度和可见性,副本卸载不释放源模型的几何或材质。
- 背面投影及随模型大小适配的法线偏移减少 STEP 的自阴影条纹,继续显示接口凹槽。
- 使用同一个躯干的 STEP 和新 URDF,在独立浏览器页中切换比对灰色和细节,未保存或上传,不覆盖用户编辑页。构建、56 项测试及格式检查通过;新增测试覆盖两种原始材质的统一显示、源数据不变、材质槽/透明度保留及独立资源释放。
截图
screenshots/urdf-readonly-points.jpg:上传页统一只读列出全部文件点位,没有坐标系选择操作。screenshots/urdf-file-inspection.jpg:只读原始 URDF 文件检查,不添加安装规则。screenshots/component-new-api.jpg:后端详情、STEP 预览及新表单扩展字段(联调记录清理前)。screenshots/activity-new-api.jpg:新通用日志与目标快照。screenshots/three-view-helper.png:官方 ViewHelper 与原始 URDF 预览。screenshots/model-lighting-detail.png:调整照明及自身阴影后的孔位细节。screenshots/step-neutral-preview.png、screenshots/urdf-neutral-preview.png:同一躯干的两种格式使用统一灰色预览材质。
STEP 解析期间的独立文件选择(2026-10-12)
- 生产构建
vite preview本机 8092:使用实际躯干.STEP,STEP 仍显示“正在解析 STEP 预览…”时,点击 URDF 文件夹选择器约 270 ms 打开;两份实际模型都加载成功。 - 重新选择 STEP 后,在其解析期间切换已加载 URDF 成功,URDF 更换按钮保持可用;截图
screenshots/independent-model-import.png。没有保存或上传业务数据。 - 回归覆盖 Worker 返回几何、保留源文件字节、取消解析、解析失败清理、已取消任务不启动,以及 STEP 忙时 URDF 仍可选、连续点击仅一个窗口、cancel/change 后正常恢复。
- 8091 开发模式实际 STEP 解析成功,显示 6612 个模型面,URDF 选择按钮保持可用,浏览器无 error 日志。
- 最终
npm run build、npm run format:check和 61 项测试均通过。
按名称识别零件与接口类型(2026-10-12)
- 单元测试覆盖 24 个中英文名称、两种分隔符、12 个匹配键、左右组合限制、未知名称、接口前缀规则、坐标不变、basicFields 序列化与旧类型替换;66 项测试通过。
- 浏览器导入机械新躯干模型的临时副本,仅主文件改为
躯干-0-机械型号.urdf:识别TORSO_0;J1/J2/J3/J4 子节点分别识别ARM_R/HEAD_0/ARM_L/WAIST_0。点位数值保留原精度,J2 可正常高亮。 - 截图
screenshots/part-name-identity.png与screenshots/interface-name-identity.png。没有修改原机械文件,也没有保存后端测试记录。 npm run build、npm run format:check通过。类型按已有 basicFields 契约提交;后端按 partType/partSide 查询候选零件尚需增加 API 支持。
零件分类自动识别与标签图标(2026-10-12)
- 右侧两个标签使用 lucide-react 的 FilePenLine(零件描述)和 Network(基本信息),主品牌 Logo 保持既有图片。
- 分类只读,使用 URDF 主文件名识别出的规范键;取消上方重复类型面板和手动分类建议。提交时 category 与 partType/partSide 由同一识别结果生成,防止旧“结构件”等手填分类混入。
- 浏览器选择实际
躯干_0_宽躯躯干:分类为 TORSO_0 且 readOnly;替换为头_0_卤蛋零自由度头后即时更新为 HEAD_0,模型正常加载。截图screenshots/automatic-part-category.png;未上传或保存后端记录。 - 列表提供 12 种规范分类建议,仍通过已有 category 精确筛选参数请求后端,没有添加前端记录筛选或未支持的查询字段。
- 构建、格式检查和 67 项测试通过。
自定义字段排版(2026-10-12)
- 两组自定义字段统一为横向标题栏:标题、独立计数标记、右侧添加按钮。计数字号与标题分离,按钮为 30 px 紧凑高度;窄面板不足时自动换行。
- 新增字段采用独立卡片,名称与删除按钮对齐,内容区单独一行,统一 12 px 间距。两组的添加、输入、删除已在浏览器验证。
- 实测右侧内容宽 263 px,无横向溢出,两组添加按钮的左右边界一致;页面根节点无整体滚动溢出。
- 截图
screenshots/custom-fields-layout.png、screenshots/custom-fields-layout-detail.png;构建与格式检查通过。本次仅调整展示结构和样式,未保存业务数据。
零件描述精简(2026-10-12)
- 描述页仅保留自动分类、自由度、材质、功能、形状、大小、扭矩、质量(kg)和自由描述输入框。移除名称/编码/厂商/标签及自定义字段编辑器,删除无引用的编辑组件与样式。
- 名称由当前 URDF 主文件名生成(去扩展名),替换文件后更新;保存时再次从文件名取值。组件编码分配与上传请求沿用原流程。
- 自由度/功能/形状/大小/扭矩保存到已有 parameterFields 的同名条目,支持详情回填、修改和清空;material/massKg/description 使用现有字段。完整 PUT 保留历史隐藏数据,避免编辑新表单时丢失旧记录。
- 70 项测试、TypeScript 和生产构建通过。新增测试覆盖参数保存/回填/清空、历史数据保留和文件名称派生。浏览器导入躯干文件自动识别 TORSO_0,验证九个显示字段、内部滚动和整页无溢出;未向真实后端新增测试组件。
- 页面截图:screenshots/part-description.png。
BOM Excel 导入(2026-10-12)
- 零件描述底部增加 BOM 清单、下载模板和上传 Excel。模板包含参考图中的八个业务字段与首条示例,序号不进入 JSON。
- ExcelJS 4.4.0 在独立 Worker 解析第一张工作表。按表头映射,保留 DOF 0 与单位文本,跳过空行;公式/日期、缺少名称、重复/缺少表头、超出行数及单元格限制时整份导入失败,保留已有清单。
- BOM 支持预览、分页、重新上传、清空和编辑回填。JSON 保存请求新增可选 bom 对象数组,未导入时不增加此字段;清空显式提交 []。后端支持情况尚未联调,待办见 bom-contract.md。
- 保存响应缺少或改变 BOM 时不提示整体成功,保留输入与已保存记录 ID,避免重复创建。
- 77 项自动测试通过,覆盖真实模板解析、表头映射、空白与零、行校验、JSON 数组保存与清空、详情回填、后端忽略字段检测。生产构建通过,依赖审计无已知漏洞。
- 浏览器验证开发服务的模板下载、真实文件导入和完整清单。另使用生产构建预览验证打包后的 Worker 成功解析同一文件,结果与模板一致;未向真实后端写入测试组件。
- 预览截图:screenshots/bom-preview.png。
2026-10-12 最新后台 API(admin-api(3).md)
- docs/admin-api.md 已同步用户提供的最新文档;用户、日志、OSS 签名及资源路径协议无变化。
- POST/PUT 按新扁平字段提交 degreesOfFreedom(整数)、functionDescription、shape、size、torqueNm(N·m 数值),移除 manufacturer、tags、lengthMm/widthMm/heightMm 及旧的自动参数映射。材质/质量/描述及已有扩展字段保留。
- BOM 正式字段使用 bomList,始终随全量表单提交;Excel 八列结构不变,后端其他自由 JSON 结构也能查看并原样保留。
- 基本信息按同一份 URDF 解析数据生成必填 urdfInfo,保留名称、文件内父子节点、XYZ/RPY、axis、limits 和名称识别类型,不补坐标、不推断装配。替换文件时更新,撤销替换时恢复详情,仅改表单/STEP 不覆盖原 JSON。
- 保存响应校对两份 JSON;不一致时保留输入及已保存 ID,避免重复创建。
- 80 项测试通过,覆盖字段默认值/范围/单位、JSON 对象/数组回填、缺失 urdfInfo、POST/仅表单 PUT、缺省坐标与精度、BOM 导入及响应差异。
- 生产构建通过。浏览器使用用户的躯干_0_宽躯躯干文件夹验证四个点位、名称/分类自动识别及 Excel Worker 导入;控制台无错误。
- 只读请求测试环境组件列表返回 OK、items 为空;没有可用于详情验证的已有记录,本次未向远程服务器写入测试组件。真实 OSS 上传、保存及再打开的完整回填仍待实际联调。