modischfabrications/cutsolver_frontend

CutSolver（前端）

https://github.com/ModischFabrications/CutSolverFrontend/actions/workflows/ci.yml/badge.svg](https://github.com/ModischFabrications/CutSolverFrontend/actions/workflows/ci.yml) https://img.shields.io/docker/v/modischfabrications/cutsolver_frontend?sort=semver](https://hub.docker.com/r/modischfabrications/cutsolver_frontend) https://img.shields.io/docker/pulls/modischfabrications/cutsolver_frontend](https://hub.docker.com/r/modischfabrications/cutsolver_frontend)

镜像概述和主要用途

该镜像是https://github.com/ModischFabrications/CutSolver%E7%9A%84%E5%89%8D%E7%AB%AF%E7%95%8C%E9%9D%A2%EF%BC%8C%E5%90%8E%E8%80%85%E6%98%AF%E4%B8%80%E4%B8%AA%E7%94%A8%E4%BA%8E%E8%AE%A1%E7%AE%97%E7%90%86%E6%83%B3%E6%9D%90%E6%96%99%E5%88%87%E5%89%B2%E9%95%BF%E5%BA%A6%E7%9A%84%E5%90%8E%E7%AB%AF%E6%B1%82%E8%A7%A3%E5%99%A8%E3%80%82%E6%9C%AC%E5%B7%A5%E5%85%B7%E6%97%A8%E5%9C%A8%E8%A7%A3%E5%86%B3%E5%B8%B8%E8%A7%81%E7%9A%84%E5%88%87%E5%89%B2%E5%B8%83%E5%B1%80%E9%97%AE%E9%A2%98%EF%BC%8C%E5%8D%B3%E5%A6%82%E4%BD%95%E4%B8%BA%E6%8C%87%E5%AE%9A%E9%95%BF%E5%BA%A6%E7%9A%84%E6%9D%90%E6%96%99%E6%89%BE%E5%88%B0%E6%9C%80%E4%BD%B3%E5%88%87%E5%89%B2%E4%BD%8D%E7%BD%AE%E3%80%82%E7%9B%AE%E5%89%8D%E7%BC%BA%E4%B9%8F%E5%85%B6%E4%BB%96%E5%85%8D%E8%B4%B9%E6%9C%8D%E5%8A%A1%E4%BB%A5%E6%98%93%E7%94%A8%E6%A0%BC%E5%BC%8F%E8%A7%A3%E5%86%B3%E6%AD%A4%E7%B1%BB%E9%97%AE%E9%A2%98%EF%BC%8C%E5%9B%A0%E6%AD%A4%E6%9C%AC%E9%A1%B9%E7%9B%AE%E5%BA%94%E8%BF%90%E8%80%8C%E7%94%9F%E3%80%82

!https://github.com/ModischFabrications/CutSolverFrontend/raw/main/docs/mobile.png

核心功能和特性

• 整数计算：仅使用整数进行计算，无需任意精度（目前）。如需处理分数，可将数值按小数点移位处理
• 无单位概念：不限制单位，用户可根据需求使用任何单位（如毫米、厘米等）
• 智能算法：针对2D"切割库存问题"（NP难问题，可简化为装箱问题BPP），采用分级算法：
  • 小任务（<10个条目）：使用暴力法计算最优解
  • 大任务：使用FFD（首次适应递减）算法快速生成解决方案
• 多场景适应：不同组合可能产生相同的废料量，因此可能返回不同但同样优的结果

使用场景和适用范围

适用于需要优化材料切割以减少废料的场景，例如：

• 木工、金属加工等制造业的材料切割规划
• 包装行业的材料利用率优化
• 任何需要将长材料切割为指定短长度的应用场景

使用方法和配置说明

直接使用

可直接使用提供的在线服务：<[***]>

使用步骤：

1. 输入原材料长度
2. 输入切割设备的宽度（如3mm的钢锯）
3. 输入所需切割的数量和长度
4. 获取优化的切割方案

Docker托管

前提条件

需自行部署https://github.com/ModischFabrications/CutSolver

环境变量配置

通过环境变量或compose文件设置后端路径：

• VUE_APP_BACKEND_SOLVER_URL：后端求解器的URL地址

Docker Compose示例

创建docker-compose.yml文件：

yaml
version: '3'
services:
  cutsolver-frontend:
    image: docker.xuanyuan.run/modischfabrications/cutsolver_frontend:latest
    environment:
      - VUE_APP_BACKEND_SOLVER_URL=http://your-backend-url:port
    ports:
      - "8080:80"
    restart: unless-stopped

启动服务：

bash
docker-compose up [-d]

构建与开发环境

依赖安装

bash
npm install

开发命令

• 开发环境编译及热重载：npm run serve
• 生产环境编译及压缩：npm run build
• 代码检查：npm run lint
• 单元测试：npm run test:unit

依赖更新

bash
# 完全更新依赖
vue upgrade && npm install

# 检查过时依赖
npm outdated

# 迁移到新版本
npm install <package>@latest

Docker镜像构建与推送

多架构构建环境配置（一次性）

bash
docker buildx create --name multibuilder --use
docker buildx inspect multibuilder --bootstrap

构建并推送多架构镜像

bash
docker login -u modischfabrications
docker buildx build --platform linux/amd64,linux/arm/v7,linux/arm64 \
  -t modischfabrications/cutsolver_frontend:<VERSION> \
  -t modischfabrications/cutsolver_frontend:latest \
  --push .

技术依赖

• https://vuejs.org/%EF%BC%9AWeb%E6%A1%86%E6%9E%B6
• Vue Bootstrap：样式框架
• https://vue-showdown.js.org/%EF%BC%9AMarkdown%E8%A7%A3%E6%9E%90
• https://eslint.vuejs.org/%EF%BC%9A%E4%BB%A3%E7%A0%81%E6%A3%80%E6%9F%A5%E4%B8%8E%E6%A0%BC%E5%BC%8F%E5%8C%96
• https://jestjs.io/%EF%BC%9A%E6%B5%8B%E8%AF%95%E6%A1%86%E6%9E%B6

所有依赖由Docker和NPM自动处理。