2026-10-15 10:40:26 +08:00
2026-10-15 10:40:26 +08:00
2026-10-15 10:40:26 +08:00
2026-10-15 10:40:26 +08:00
2026-10-15 10:40:26 +08:00
2026-10-15 10:40:26 +08:00
2026-10-15 10:40:26 +08:00
2026-10-15 10:40:26 +08:00
2026-10-15 10:40:26 +08:00

CAD World 管理后台

React + TypeScript + Vite 管理后台,包含组件库、STEP/URDF 上传与预览、Excel 物料清单、零件信息编辑、用户管理及操作日志。

本地运行

要求 Node.js >= 22.12.0。在仓库根目录执行:

npm ci
npm run dev -- --port 8092

访问 http://127.0.0.1:8092/。默认通过本地代理请求开发 API。覆盖后端地址时,在终端设置 ADMIN_API_TARGET 后启动,例如:

ADMIN_API_TARGET=http://127.0.0.1:8992 npm run dev -- --port 8092

验证与打包

npm test
npm run build

构建输出为 Management/dist/,将该文件夹部署到静态网站目录。

网站 API
本机 / 局域网 本地代理,默认 https://dev-cadworld-api.robotquan.com
dev-cadworld-admin.robotquan.com https://dev-cadworld-api.robotquan.com
cadworld-admin.robotquan.com https://cadworld-api.robotquan.com

模型资源从 https://linkerbot.oss-cn-beijing.aliyuncs.com 下载。上传使用后端签名后浏览器直传对象存储。

Nginx 静态站点需要路由回退,确保直接访问 /components/new 等页面可用:

location / {
    try_files $uri $uri/ /index.html;
}

当前约定

  • 新增零件仅 STEP/STP 必填;URDF 与其余表单字段选填。已提供的 URDF 文件夹仍须完整且可解析。
  • 原样读取 URDF 的 link/joint、origin、轴向与限制,不改写文件坐标或自动翻转零件。
  • 按最新 LINK_部件_左右 命名规则识别接口和分类,详见 命名规范。
  • rotationAxis 选填,支持 x/y/z/-x/-y/-z,保存到组件顶层字段;未设置为 null。前台用其在装配接口上增加活动关节,详见 接口文档。
  • Excel 内容解析为 bomList 提交并在编辑页回填,详见 物料清单约定。

目录

  • Management/:管理后台源码、资源、测试及详细文档。
  • shared/:后台必需的公共模块,需与 Management/ 一同保留。
  • Client/:仅包含前后台 URDF 坐标一致性回归测试需要的前台装配模块及相关部署说明,不包含前台应用入口,不参与后台生产构建。

仓库使用 npm workspaces,在根目录安装依赖,确保跨目录测试能使用同一份 Three.js。原 Management/package-lock.json 也保留;根目录操作使用根目录锁文件。

详见 后台说明、部署说明 和 接口文档。

S
Description
No description provided
Readme 16 MiB
Languages
TypeScript 85.1%
CSS 14.1%
JavaScript 0.7%
HTML 0.1%