面向船舶设计院审图组的 AGPL-3.0 开源智能审图平台。系统采用 Web 审图平台形态，支持 DXF 解析，并预留基于 LibreDWG 的 DWG 解析能力、基于 YOLOv8 的图纸符号识别能力和基于 OCR 的文字证据能力，提供图纸上传、解析、规则审查、问题整改、版本对比、统计看板和审查报告导出能力。
- 前端：Vue 3 + TypeScript + Vite + dxf-viewer WebGL正式预览，Canvas仅作诊断视图，工作台提供审图流程状态和当前上下文选择
- 后端：Spring Boot 3 + Spring Data JPA + Flyway + OpenAPI
- 审查任务队列：本地默认内存队列；容器和云原生部署可启用 Redis 协议队列，当前部署骨架默认使用 Valkey
- 对象存储：本地默认文件系统；后端提供 S3 兼容适配，可接 MinIO 或其它 S3-compatible 对象存储
- CAD Worker：Python + FastAPI + ezdxf + matplotlib 渲染 + LibreDWG 命令行适配
- Vision Worker：Python + FastAPI + Ultralytics YOLOv8
- OCR Worker：Python + FastAPI + Tesseract OCR
- 规则引擎：Easy Rules
- 开发数据库：H2 + Flyway；生产数据库：达梦 DM8 + 显式 DIsql 版本脚本
- 部署目标：开源自托管、私有化内网部署
当前仓库已经按前端、后端、CAD Worker、Vision Worker、OCR Worker 拆分。上传文件先生成版本记录，原始图纸、渲染图、证据图片和报告 Markdown 进入 ObjectStorageService；本地开发默认写入本地文件系统，S3 兼容模式会上传到对象存储并保留一份本地缓存供 CAD/AI Worker 或附件下载读取。审查任务进入 ReviewTaskQueue，本地开发默认由后端内存队列执行，容器/云原生部署可切换为 Redis 协议队列，再由后台执行器调用 CAD Worker 解析并执行规则审查。审查任务可选自动采集视觉/OCR证据：先将图纸版本渲染为 PNG，再调用 YOLOv8 和 OCR Worker，最后统一进入规则引擎。每个审查任务会记录当前阶段和 PARSE、RENDER、VISION、OCR、RULES 步骤状态，前端提供任务详情页用于查看每一步的状态、时间和错误细节。DWG 解析通过 LibreDWG dwg2dxf 适配；训练数据、模型权重和真实图纸不进入仓库。
工具已统一放在当前项目 .tools 目录，Python 依赖放在 .venv。
推荐使用开发脚本启动核心链路：
# 启动 CAD Worker、Spring Boot 后端和 Vue 前端
.\deploy\start-dev.ps1
# 启动时同时拉起 Vision/OCR Worker
.\deploy\start-dev.ps1 -WithVision -WithOcr
# 如果只需要跑后端验收，不启动前端
.\deploy\start-dev.ps1 -NoFrontend常用运维脚本：
# 检查后端、OpenAPI、CAD Worker、前端和可选 Worker 健康状态
.\deploy\test-health.ps1
.\deploy\test-health.ps1 -IncludeVision -IncludeOcr
# 跑完整 golden dataset 演示验收
.\deploy\run-demo.ps1
# 生成双版本 Markdown 演示走查摘要（输出到 .run/）
.\deploy\run-demo-walkthrough.ps1
# 验证四类角色权限边界和审计日志
.\deploy\run-access-control-e2e.ps1
# 跑 golden dataset + mock Vision/OCR 多模态验收
.\deploy\run-demo.ps1 -Multimodal
# 跑真实 MinIO/S3 对象存储验收，会临时启动独立 MinIO 和后端
.\deploy\run-object-storage-e2e.ps1
# 跑真实 Redis 协议队列验收，会临时启动便携 Redis 和独立后端
.\deploy\run-redis-queue-e2e.ps1
# 验证坏DXF失败、失败任务重试、完成任务拒绝重试和审计日志
.\deploy\run-task-retry-e2e.ps1
# 跑 Docker Compose 容器栈验收，会构建后端、前端、CAD Worker 并使用 Valkey 队列
.\deploy\run-compose-e2e.ps1
# 停止由 start-dev.ps1 启动的开发服务
.\deploy\stop-dev.ps1start-dev.ps1 会把运行状态和日志写入 .run/，该目录仅用于本地运行，不进入仓库。
手动启动方式如下：
# 1. 启动 CAD Worker，用于 DXF / DWG 解析
.\.venv\Scripts\python.exe -m uvicorn cad_worker.app.main:app --host 127.0.0.1 --port 9000
# 2. 可选：启动 YOLOv8 Vision Worker
# 需要先安装 vision_worker/requirements.txt 并配置 YOLO_MODEL_PATH
.\.venv\Scripts\python.exe -m uvicorn vision_worker.app.main:app --host 127.0.0.1 --port 9100
# 3. 可选：启动 OCR Worker
# 需要先安装 ocr_worker/requirements.txt 和 Tesseract OCR
.\.venv\Scripts\python.exe -m uvicorn ocr_worker.app.main:app --host 127.0.0.1 --port 9200
# 4. 启动 Spring Boot 后端
$env:JAVA_HOME=(Resolve-Path .tools\jdk-17).Path
$env:SPRING_PROFILES_ACTIVE="dev"
.\.tools\maven\bin\mvn.cmd -f backend-spring\pom.xml spring-boot:run
# 5. 启动 Vue 前端
cd frontend-vue
npm run dev访问地址：
- 前端：http://127.0.0.1:5173
- 后端 API：http://127.0.0.1:8080
- OpenAPI：http://127.0.0.1:8080/swagger-ui.html
- CAD Worker：http://127.0.0.1:9000/docs
- Vision Worker：http://127.0.0.1:9100/docs
- OCR Worker：http://127.0.0.1:9200/docs
健康检查：
- 核心健康接口：http://127.0.0.1:8080/api/health
- 前端系统状态页：登录前后均可在“系统状态”查看后端、数据库、审查任务队列、OpenAPI、CAD Worker 和可选 Vision/OCR Worker 状态
- PowerShell 检查：
.\deploy\test-health.ps1
本地开发默认账号：
admin / admin123 系统管理员
expert / expert123 审图专家
engineer / engineer123 设计工程师
viewer / viewer123 只读访客
这些账号只会在 dev Profile 下初始化，供本地开发和自动化验收使用。start-dev.ps1 与当前 Docker Compose 开发编排会显式启用该 Profile；生产环境不得启用它。
系统现已使用数据库持久化会话：客户端只持有随机 Token，数据库只保存 Token 的 SHA-256 摘要。会话默认 8 小时过期，注销、修改密码、管理员重置密码、停用账号或变更角色都会立即撤销相关会话。
生产环境首次启动时，必须通过环境变量创建初始管理员。初始化只会在用户表为空时执行，创建成功后应从运行环境中移除明文密码：
$env:SPRING_PROFILES_ACTIVE="prod"
$env:SHIPCAD_DATASOURCE_URL="jdbc:dm://dm8.example.internal:5236"
$env:SHIPCAD_DATASOURCE_USERNAME="SHIPCAD"
$env:SHIPCAD_DATASOURCE_PASSWORD="ReplaceWithDatabasePassword"
$env:SHIPCAD_REVIEW_QUEUE_MODE="redis"
$env:SHIPCAD_REDIS_HOST="valkey.example.internal"
$env:SHIPCAD_REDIS_PORT="6379"
$env:SHIPCAD_OBJECT_STORAGE_MODE="s3"
$env:SHIPCAD_S3_ENDPOINT="http://minio.example.internal:9000"
$env:SHIPCAD_S3_BUCKET="shipcad-artifacts"
$env:SHIPCAD_S3_ACCESS_KEY="ReplaceWithAccessKey"
$env:SHIPCAD_S3_SECRET_KEY="ReplaceWithSecretKey"
$env:SHIPCAD_BOOTSTRAP_ADMIN_USERNAME="admin"
$env:SHIPCAD_BOOTSTRAP_ADMIN_PASSWORD="ReplaceWithStrongPassword123"
$env:SHIPCAD_BOOTSTRAP_ADMIN_DISPLAY_NAME="系统管理员"生产密码要求为 10-128 个字符，并同时包含字母和数字。首次启动前必须按 deploy/database/README.md 在空 DM8 模式中依次执行版本脚本；生产 Profile 使用达梦 JDBC Driver 和基于官方 Hibernate 6.6 方言的项目适配层，并通过 ddl-auto=validate 拒绝不完整结构。
.\.venv\Scripts\python.exe -m pytest cad_worker\tests ocr_worker\tests vision_worker\tests tools\tests -q
.\.venv\Scripts\python.exe tools\check_python_requirements.py
.\.venv\Scripts\python.exe tools\check_action_pins.py
.\.venv\Scripts\python.exe tools\check_rule_golden_coverage.py
.\.venv\Scripts\python.exe tools\check_complex_dxf_dataset.py
.\.venv\Scripts\python.exe tools\validate_vision_dataset.py
.\.venv\Scripts\python.exe tools\run_secret_scan.py
$env:JAVA_HOME=(Resolve-Path .tools\jdk-17).Path
.\.tools\maven\bin\mvn.cmd -f backend-spring\pom.xml test
cd frontend-vue
node ..\tools\check_dxf_viewer_dataset.mjs
npm run build同一组基础门禁会由 .github/workflows/ci.yml 在 push 和 pull request 时自动执行；CI 还会检查复杂 DXF parser/render 基线、dxf-viewer parser 兼容性、每条默认规则的 golden 正反样例覆盖，并启动真实 CAD Worker 与后端运行 golden dataset 和审查任务失败重试 E2E。.github/workflows/secret-scan.yml 会用校验过的 Gitleaks CLI 扫描完整 Git 历史，.github/workflows/sbom.yml 会按后端、前端和三个 Worker 生成 SPDX JSON 组件 SBOM 工件。Docker Compose、MinIO、Redis/Valkey、DM8 与真实 YOLO 权重仍按独立环境验收。
复杂 DXF 解析与 dxf-viewer parser 兼容基线不需要启动后端：
.\.venv\Scripts\python.exe tools\generate_complex_dxf_dataset.py
.\.venv\Scripts\python.exe tools\check_complex_dxf_dataset.py
node tools\check_dxf_viewer_dataset.mjs
.\deploy\run-dxf-viewer-smoke.ps1这组样例位于 datasets/parser/，用于验证块参照、属性、尺寸、文字、多图层、HATCH 填充、较高实体数量、CAD Worker 渲染和 dxf-viewer parser 兼容性；Canvas 诊断视图不作为通过条件。发布或演示前还应启动后端、CAD Worker 和前端，走真实产品链路确认 DxfViewerPreview 能通过 /api/versions/{versionId}/file 加载 DXF Blob、显示图层和非空 WebGL 画面。
.\deploy\run-dxf-viewer-smoke.ps1 会自动启动核心开发栈、上传复杂 DXF 样例，并在 .run/ 写入正式预览 WebGL smoke 的 JSON 报告和 canvas 截图。问题定位链路可额外运行：
.\deploy\run-dxf-issue-focus-smoke.ps1该脚本会上传会触发 LAYER_NAME_STANDARD 的 DXF、发起真实审查任务、在前端点击生成的问题卡片，并验证正式 dxf-viewer WebGL 画面出现选中问题的红色 CAD 范围高亮。它验证的是 ReviewIssue -> ReviewEvidence.location -> DxfViewerPreview 定位闭环，不代表 YOLO/OCR 模型精度。
真实开源 DXF 候选只在 datasets/external/manifest.json 中记录，不直接进入仓库。以下命令会把固定 commit 的 Baby AUV 和 RC boat hull 文件下载到 .run/external-dxf-candidates/，校验许可证元数据、SHA-256、CAD Worker 解析/渲染以及 dxf-viewer parser 兼容性：
.\.venv\Scripts\python.exe tools\check_external_dxf_candidates.py
node tools\check_external_dxf_viewer_candidates.mjsGolden dataset 端到端验收需要后端和 CAD Worker 已启动。tools/run_golden_e2e.py 会按 datasets/rules/expected.json 逐个上传合成 DXF，校验问题数量、规则代码、解析摘要、证据链、报告和版本文件下载；包含自动 Vision/OCR 的样例会启动确定性 mock Worker，用来验证编排和规则消费，不代表真实 YOLO/OCR 精度：
.\.venv\Scripts\python.exe tools\run_golden_e2e.py --keep-going
# 或
.\deploy\run-demo.ps1
# 生成可人工查阅的双版本演示走查摘要
.\deploy\run-demo-walkthrough.ps1真实 MinIO/S3 对象存储验收会临时启动 MinIO API 9002、MinIO Console 9001 和独立后端 8085，上传 golden DXF 并生成报告后删除本地缓存，再验证图纸文件下载、审查任务和报告附件下载能从对象存储恢复文件：
.\deploy\run-object-storage-e2e.ps1
# 如果 .tools\minio\minio.exe 不存在，可下载到项目 .tools 目录
.\deploy\run-object-storage-e2e.ps1 -DownloadMinio真实 Redis 协议队列验收会临时启动 Redis 6380 和独立后端 8086，把后端切到 SHIPCAD_REVIEW_QUEUE_MODE=redis，先用 stale processing payload 验证启动恢复，再跑完整 golden dataset。Windows 开发机默认使用 MIT 许可的便携 redis-windows-fork，下载到 .tools\redis-windows，不进入仓库；Valkey 容器仍由 Docker Compose 骨架覆盖：
.\deploy\run-redis-queue-e2e.ps1
# 如果 .tools\redis-windows 不存在，可下载到项目 .tools 目录
.\deploy\run-redis-queue-e2e.ps1 -DownloadRedis审查任务失败重试验收需要后端和 CAD Worker 已启动。脚本会上传一个故意损坏的 .dxf，验证任务进入 FAILED、PARSE 步骤失败、失败任务可重试且写入 REVIEW_RETRY 审计；随后上传一个正常 DXF，验证已完成任务不能被重试：
.\deploy\run-task-retry-e2e.ps1Docker Compose 容器栈验收会使用 deploy/docker-compose.yml 构建后端、前端和 CAD Worker，并用 Valkey 容器验证 Redis 协议任务队列。脚本会生成临时 override，把容器数据挂载到 .run/compose-e2e/，避免污染项目根目录 data/：
.\deploy\run-compose-e2e.ps1
# 同时启用 MinIO，并验证 S3 对象存储模式下的缓存恢复
.\deploy\run-compose-e2e.ps1 -WithObjectStorageMultimodal evidence E2E needs the backend and CAD Worker running. By default it starts deterministic mock Vision/OCR workers on 127.0.0.1:9100 and 127.0.0.1:9200, so it can validate review-task orchestration for CAD rendering, YOLO evidence, OCR evidence, rule consumption, and report output without real YOLO weights or Tesseract:
.\.venv\Scripts\python.exe tools\run_multimodal_evidence_e2e.pyIf Windows blocks 9100/9200, start the backend with matching ports and pass the same ports to the script:
.\deploy\start-dev.ps1 -NoFrontend -VisionPort 9110 -OcrPort 9210
.\deploy\run-demo.ps1 -Multimodal -VisionPort 9110 -OcrPort 9210- DXF 上传、异步解析和实体几何提取
- DWG 上传入口和 LibreDWG 转 DXF 解析适配，需要本机安装
dwg2dxf - CAD Worker 图纸渲染：支持将 DXF/DWG 版本渲染为 PNG，并缓存到
data/rendered/{versionId}；复杂合成 DXF parser/render 基线已覆盖块参照、属性、尺寸、文字、多图层、HATCH 填充和密集实体 - 对象存储边界：原始图纸、渲染图、Vision/OCR 输入图片和报告 Markdown 通过统一接口保存；默认本地文件系统，S3 兼容模式可接 MinIO，并保留 Worker/下载本地缓存
- 审查任务队列：支持 PENDING、RUNNING、FINISHED、FAILED 状态、阶段/步骤进度、失败重试和可选自动 Vision/OCR 证据采集；默认本地内存队列，Redis 协议模式已抽象为可部署队列适配
- 系统状态页和审查任务详情页：支持查看组件健康、必需/可选 Worker 状态、任务步骤时间线和失败细节
- 审图流程工作台：显示系统、登录、项目图纸、版本、审查、问题、报告的当前进度，并可在项目、图纸、版本列表中设置当前上下文
- dxf-viewer DXF正式预览，支持图层查看、问题聚焦和 CAD 范围高亮；Canvas仅用于人工诊断解析实体；复杂 DXF 样例已纳入
dxf-viewerparser 兼容门禁 - 问题定位高亮：优先按
ReviewEvidence.location的 CAD 范围定位，缺少证据范围时按解析图元或图层范围辅助定位 - YOLOv8 Vision Worker 骨架：支持使用版本渲染图或手动上传图像生成符号检测框，需配置模型权重
- OCR Worker 骨架：支持使用版本渲染图或手动上传图像生成文字区域，需安装 Tesseract OCR
- Easy Rules 规则审查：图层命名、空图层、标题栏、版次格式、占位文本、实体数量、OCR占位文本、YOLO/CAD标题栏交叉校验
- 带时间线的整改闭环、按来源分组的证据链展示、审查报告、服务端 Markdown 附件下载、统计看板和结构化版本对比
- 四角色操作级权限控制：管理员、审图专家、设计工程师、只读访客；管理员可筛选查看关键操作与越权拒绝审计日志
- 持久化可撤销会话、登录/注销审计、密码修改，以及管理员用户创建、角色调整、停用和密码重置
- 项目级数据隔离：管理员分配项目成员，非管理员只能访问已加入项目的图纸、版本、任务、问题、证据、报告和统计数据
- 数据库结构版本化：H2 启动时由 Flyway 自动迁移并由 JPA 校验；DM8 使用与代码版本同步的 DIsql 脚本和版本记录表
- GitHub 首次发布清单：
docs/github_publication.md - YOLO 首批数据集结构：
datasets/vision/ - 开源工具集成策略：
docs/integration_strategy.md - 多来源证据模型：
docs/evidence_model.md - CAD Viewer 预研：
docs/experiment_cad_viewer_integration.md - 工具调研清单：
docs/open_source_tools_survey.md
cd deploy
# 首次安全启动：显式设置初始管理员，Compose 默认不会创建开发账号
$env:SHIPCAD_BOOTSTRAP_ADMIN_USERNAME="admin"
$env:SHIPCAD_BOOTSTRAP_ADMIN_PASSWORD="ReplaceWithStrongPassword123"
$env:SHIPCAD_BOOTSTRAP_ADMIN_DISPLAY_NAME="系统管理员"
docker compose up --build
# 仅限本地开发：启用 dev Profile 后会创建文档列出的四个开发账号
$env:SPRING_PROFILES_ACTIVE="dev"
docker compose up --build
# 启动包含 YOLOv8 Vision Worker 的 profile
docker compose --profile vision up --build
# 启动包含 OCR Worker 的 profile
docker compose --profile ocr up --build
# 启动 MinIO，并把后端切到 S3 兼容对象存储模式
$env:SHIPCAD_OBJECT_STORAGE_MODE="s3"
$env:MINIO_ROOT_USER="ReplaceWithAccessKey"
$env:MINIO_ROOT_PASSWORD="ReplaceWithStrongObjectStoragePassword"
$env:SHIPCAD_S3_ACCESS_KEY=$env:MINIO_ROOT_USER
$env:SHIPCAD_S3_SECRET_KEY=$env:MINIO_ROOT_PASSWORD
docker compose --profile object-storage up --builddeploy/docker-compose.yml 不提供固定口令。初始管理员创建成功后，应从运行环境移除
SHIPCAD_BOOTSTRAP_ADMIN_PASSWORD；对象存储凭据也应由部署环境或 Secret 管理器提供。
云原生部署占位文件位于 deploy/kubernetes/shipcad-review.yaml，默认使用 prod Profile。部署后端前先创建 DM8 连接 Secret：
kubectl create secret generic shipcad-database `
--namespace shipcad-review `
--from-literal=SHIPCAD_DATASOURCE_URL=jdbc:dm://dm8.example.internal:5236 `
--from-literal=SHIPCAD_DATASOURCE_USERNAME=SHIPCAD `
--from-literal=SHIPCAD_DATASOURCE_PASSWORD=ReplaceWithDatabasePassword空数据库首次部署前还应创建初始管理员 Secret：
kubectl create secret generic shipcad-bootstrap-admin `
--namespace shipcad-review `
--from-literal=SHIPCAD_BOOTSTRAP_ADMIN_USERNAME=admin `
--from-literal=SHIPCAD_BOOTSTRAP_ADMIN_PASSWORD=ReplaceWithStrongPassword123 `
--from-literal=SHIPCAD_BOOTSTRAP_ADMIN_DISPLAY_NAME=系统管理员确认初始管理员已创建后，应删除或轮换该 Secret；后续用户由网页“账号与用户”页面管理。
本项目源码采用 GNU Affero General Public License v3.0，见 LICENSE。第三方依赖保留其各自许可证，详见 THIRD_PARTY_LICENSES.md。