2.6 KiB
2.6 KiB
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 也保留;根目录操作使用根目录锁文件。