# CAD World 前台 机器人设计与装配工作台。用户输入文字或图片需求后,前台请求业务后端,加载返回的 `components`、URDF 和网格文件,并按接口坐标装配展示。 ## 目录 - `Client/`:React、TypeScript、Vite 前台源码、开发代理、测试与文档。 - `shared/`:前台所需的 API 环境路由、对象存储地址、零件命名、旋转轴等公共模块。请与 `Client/` 一起保留。 本仓库只包含设计前台及其依赖,管理后台和社区项目分别维护。 ## 本地运行 要求 Node.js >= 22.12.0。 ```sh cd Client npm ci npm run dev ``` 访问 `http://127.0.0.1:8091/`。默认通过本地代理请求开发 API;需要覆盖时,复制 `Client/.env.example` 为 `Client/.env.local` 并修改 `ROBOT_API_TARGET`。 ## 验证与打包 在 `Client/` 目录执行: ```sh npm test npm run build ``` 构建输出为 `Client/dist/`,将其内容部署到网站目录即可。源码仓库不提交依赖目录、构建产物或本地环境文件。 ## 环境与资源 | 网站 | API | | --- | --- | | 本机 / 局域网 | 本地开发代理,默认连接开发 API | | `dev-cadworld.robotquan.com` | `https://dev-cadworld-api.robotquan.com` | | `cadworld.robotquan.com` | `https://cadworld-api.robotquan.com` | 模型资源直接从 `https://linkerbot.oss-cn-beijing.aliyuncs.com` 下载。后端和对象存储需允许相应网站来源跨域。 静态网站如使用 history 路由,Nginx 配置路由回退: ```nginx location / { try_files $uri $uri/ /index.html; } ``` ## 装配与交互 - 返回的零件全部进入画布,不加载默认机器人;无法唯一配对的零件仍单独展示。 - 安装对齐使用父接口变换乘以子接口变换的逆,不按部件名称猜测方向或额外翻转模型。 - 保留 URDF 自带的几何体、关节与坐标;可选 `rotationAxis` 在装配连接点增加活动关节。 - 零件库按组件实例展示;物料清单读取后端返回的 `component.bomList`。 - 本地版本保存包含视角、显示状态及装配关节角度。 详细说明见 [前台说明](Client/README.md)、[零件命名与旋转轴](Client/docs/part-naming.md)、[后端匹配说明](Client/docs/backend-direct-matching.md)。