CAD World
基于 Java 21 + Spring Boot 3 的项目托管后端,支持:
- 手机号短信验证码登录,未注册自动注册
- 用户创建自己的项目
- 项目内文件上传、下载、创建、编辑、移动、删除
- 本地持久化目录保存项目文件
- MySQL 持久化元数据
PCB 设计初版
装配页「生成 PCB」在新页面获取冻结的零件/关节快照并自动创建任务。后端从 src/main/resources/skills/robot-pcb-designer/v2/SKILL.md 读取指令,复用 app.llm.deepseek 配置,按零件级硬件生成 ESP32-DevKitC V4 + PCA9685 载板。明确绑定优先,未标注单轴活动关节推定舵机,连接两端去重,非 PWM 设备保留待适配。每 16 路增加 PCA9685,最多 256 个执行器;Wi-Fi/蓝牙是主控内置能力,不重复采购。模型缺失或失败明确提示,用户可选择默认模板。
任务产物保存在项目工作目录 electronics/pcb/{taskId},包括 PCB、SVG、BOM、连接表、设计记录与 ZIP。设计为 robot-pcb.v2,任务保存 sceneSnapshot,关闭来源页面后仍可刷新下载;旧 v1 文件保留可读,旧任务升级须从装配页重新生成。无需数据库迁移。新任务使用双层迷宫布线,输出铜线及过孔,程序校验全部网络连通与 0.15 mm 铜间距。默认单通道 0.75 A,每 4 路提供独立 5 V / 3 A 馈电接口,总电源按数量扩容,2 oz 外层铜/0.8 mm 电源回流/0.2 mm 逻辑线;数值是演示假设。布线失败的任务不可作为成功产物下载。现已补齐载板接口原理图,自动执行原生 ERC/DRC 与 kicad-happy 审查,详见下方运行环境说明;不提供 Gerber 或固件。
验证命令:mvn -q -Dtest='Pcb*Test' test。浏览器验证使用后端实际产物夹具:先执行 mvn -q -Dtest=PcbReviewTest#realHappyRuntimeAndReportArchive -Dpcb.reviewFixtureDir=/tmp/robot-pcb-review-fixture test,再在前端目录运行 npx playwright test --config tests/pcb.playwright.config.ts;如无 Playwright 自带浏览器,可设置 PLAYWRIGHT_CHROMIUM_EXECUTABLE 为 Chrome 可执行文件。浏览器测试模拟任务接口,不能替代真实模型/数据库联调。
任务调度适用于单进程后端;横向扩容前需要迁移到共享任务存储和分布式 Worker。模型规划有超时、有界队列和取消机制,服务重启后中断任务标记失败,不会伪装成功。
技术栈
- Java 21
- Spring Boot 3
- Spring Security
- MyBatis-Plus
- MySQL 8
- Tencent Cloud SMS SDK
快速启动
- 准备 MySQL 8 数据库,例如
momatchengine - 修改
src/main/resources/application.yml,或通过环境变量覆盖以下配置:SPRING_PROFILES_ACTIVE=local、SPRING_PROFILES_ACTIVE=test或SPRING_PROFILES_ACTIVE=prodAPP_AUTH_SECRETAPP_WORKSPACE_ROOT:必须是绝对路径。生产环境应位于发布目录之外,例如/data/momatchengine/projects,运行账号必须具备读写权限。APP_DB_URLAPP_DB_USERNAMEAPP_DB_PASSWORDAPP_SMS_ENABLEDAPP_SMS_SECRET_IDAPP_SMS_SECRET_KEYAPP_SMS_SDK_APP_IDAPP_SMS_SIGN_NAMEAPP_SMS_TEMPLATE_IDLOG_PATH
- 启动应用:
SPRING_PROFILES_ACTIVE=test mvn spring-boot:run
- 打开接口文档:
http://localhost:8080/swagger-ui.html
主要接口
POST /api/auth/sms-codePOST /api/auth/loginPOST /api/auth/refreshPOST /api/auth/logoutGET /api/auth/mePOST /api/projectsGET /api/projectsGET /api/projects/{projectId}PUT /api/projects/{projectId}DELETE /api/projects/{projectId}GET /api/projects/{projectId}/filesPOST /api/projects/{projectId}/files/uploadPOST /api/projects/{projectId}/foldersPOST /api/projects/{projectId}/filesGET /api/projects/{projectId}/files/contentPUT /api/projects/{projectId}/files/contentDELETE /api/projects/{projectId}/filesPUT /api/projects/{projectId}/files/moveGET /api/projects/{projectId}/files/download
测试
mvn test
环境说明
application.yml:公共配置application-test.yml:测试环境配置application-prod.yml:生产环境配置logback-spring.xml:按 profile 输出控制台和滚动文件日志
项目文件存储与部署
项目元数据保存在 MySQL,项目文件保存在 APP_WORKSPACE_ROOT/{projectCode}。项目创建和文件保存不依赖 Gitea 或 Git。
本地开发和生产服务都使用同一套“项目编码 + 当前服务配置的存储根目录”规则;共享数据库中不保存机器相关的绝对路径。线上环境的 APP_WORKSPACE_ROOT 是项目文件的唯一持久化根目录。
本地调试会直接读写共享测试库,请不要在本地执行清库、批量删除或不可逆迁移操作。
本地前端将全部 /api 请求和组件资源请求直接代理到线上 API,因此项目创建、数据库读写、读取、保存和下载都作用于线上服务,不需要复制项目文件或通过 SSH 挂载目录。本地与服务器使用同一 JWT 签名,使同一登录态访问同一项目。
local Profile 默认启用共享测试环境的腾讯云短信配置,验证码接口会真实发送短信;如需避免测试短信费用,可在 .env.local 设置 APP_SMS_ENABLED=false。
APP_WORKSPACE_ROOT=/data/momatchengine/projects
发布新版本前后都不要清理该目录。备份和恢复必须同时覆盖 MySQL 数据库与 APP_WORKSPACE_ROOT 指向的文件目录;仅恢复其中一项会造成项目元数据和项目文件不一致。
PCB 原生检查与 kicad-happy 自动审查
新任务在布局完成后生成 board.kicad_sch 与 board.kicad_pro、自建符号/封装库及库表,自动执行 KiCad ERC、DRC(包含原理图/PCB 一致性和全部走线错误检查),以及固定版本 kicad-happy 的原理图、PCB、跨域、热估算和 EMC 分析。模型负责规划,检查状态来自真实进程和 JSON;passed、warning、failed(发现问题)、error(运行失败)、not_run(依赖缺失)互不混用。检查发现问题时仍保留草案和报告供修正;任务取消会终止运行中的工具进程。旧任务不会被自动重写,重新生成后才会运行检查。
运行环境需要 KiCad 9+ 和 Python 3.10+。macOS 自动查找 /Applications/KiCad/KiCad.app/Contents/MacOS/kicad-cli,其他环境从 PATH 查找;可通过 APP_PCB_KICAD_CLI(完整可执行路径)、APP_PCB_PYTHON(默认 python3)覆盖。APP_PCB_CHECK_TIMEOUT_SECONDS 为单个分析进程的超时,默认 120 秒,范围 1–600 秒。无需安装 MCP 服务。Linux 部署需将 KiCad CLI 与符号库装入服务运行环境;不要把整段 shell 命令填入可执行路径。
上游源码按 MIT 许可内置于 src/main/resources/pcb-review/kicad-happy.zip,版本与范围见同目录 UPSTREAM.md。任务期间不下载工具,不使用供应商 API。报告包括 erc.json、drc.json、五份 happy-*.json、happy-review.json 完整合并发现、review.json 摘要与 review.log;均使用原有项目所有权检查及下载文件白名单,并包含在设计 ZIP。报告列表最多展示 200 条,原始结果完整保留。
原理图由同一份器件/网络清单生成,包含 PCA9685 输入/输出/电源脚、ESP32 接口以及外接电源来源;没有模拟板外执行器或模块内部电路。USB 电源与每组外部电源均为明确默认假设。没有数据手册逐引脚核验、SPICE、Gerber 或制造放行;kicad-happy 的启发式发现必须复核,热分析可能因没有适用器件而跳过估算。
测试:mvn -q -Dtest='Pcb*Test' test 包含真实 Python 上游脚本和模拟 CLI 契约;添加 -Dpcb.kicadCli=/absolute/path/kicad-cli 可执行原生集成测试。生成浏览器夹具:mvn -q -Dtest=PcbReviewTest#realHappyRuntimeAndReportArchive -Dpcb.kicadCli=/absolute/path/kicad-cli -Dpcb.reviewFixtureDir=/tmp/robot-pcb-review-fixture test。随后执行前端 npx playwright test --config tests/pcb.playwright.config.ts。这些测试不调用生产模型或数据库。
选择本机 CLI 是为了异步后台和 CI 都能以相同方式执行;MCP 更适合交互式编辑器操作,需额外服务/会话;容器可封装相同 CLI 以提升部署一致性,但本轮不引入 Docker 运行依赖。