62 lines
2.2 KiB
Markdown
62 lines
2.2 KiB
Markdown
# 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)。
|