VelaSim · 高性能仿真云平台¶

云超算 · 云桌面 · 云数据 · 云应用 —— 面向制造业仿真（CAE）场景的一站式云平台。

在浏览器里完成「提交仿真作业 → 核时计量 → 远程桌面后处理 → 结果回传网盘」的完整仿真工作流。前后端分离单体架构：一个后端 jar + 一个前端 SPA，私有化部署友好，云厂商能力全部可插拔。

核心特性¶

云超算（HPC）

SGE + Slurm 双调度引擎，local / agent / SSH 三执行通道；作业状态机 + 实时推送，排队位置与预计等待可见；求解器模板化提交向导，核时计量与状态回写同事务幂等。
云桌面 / 云应用

浏览器内远程桌面（内嵌 Guacamole HTML5 隧道），一键连接、凭据不出后端；华为云 / 阿里云 ECS 自动开通可插拔；Windows 软件计时管控、连接审计与水印。
:material-folder-cloud: 云数据（网盘）

分片上传（断点续传 / 秒传 / 100GB+）、流式下载、目录树与回收站；共享存储直连（NFS/Lustre 零拷贝）与平台存储双模式。
运营内容

应用市场、机理模型库（工业品类 × 专业学科双维检索）、活动报名（含 H5）、视频课堂（FFmpeg 转码 + HLS）、资讯 / 工单。
安全与权限

JWT 双 token + 刷新轮换 + 会话版本吊销，URL 级 / 角色级 / @RequiresPerm 按钮级四层权限，登录限流 + 验证码 + 管理员 2FA。
平台运维

监控中心（基础设施 + 业务大盘）、报表中心、审计日志、数据备份；注册 / 备案 / 门户区块后台可配置，仅中文、深浅双主题。

整体架构¶

                        ┌──────────────────────────────────────┐
                        │       Nginx（静态托管 + 反代）           │
                        └──────────────┬───────────────────────┘
                                       │  /        /api
                        ┌──────────────▼───────────────────────┐
                        │   vela-boot 后端单体（Java 21 + SB 3.5）│
                        │   system / job / netdisk / desktop /   │
                        │   cloud / app / enlist / video / cms  │
                        │   / model …（+ common / framework）    │
                        └───┬─────────┬─────────┬──────────────┘
                            │         │         │
                  ┌─────────▼──┐ ┌────▼────┐ ┌──▼──────────────┐
                  │  MySQL 8   │ │ 本地磁盘 │ │  guacd / FFmpeg │
                  │  (单库)    │ │(文件/视频)│ │  (4822 / 转码)  │
                  └────────────┘ └─────────┘ └─────────────────┘
        集群侧（每 HPC 集群登录节点）        桌面机侧
   ┌───────────────────────────┐    ┌─────────────────────────┐
   │ vela-agent（无库 HTTP 代理） │    │ vela-host-agent（Windows）│
   │ Java 默认 / Go 原生变体    │    │ Java 默认 / .NET 原生变体 │
   └───────────────────────────┘    └─────────────────────────┘

关键设计：单体多模块（业务模块只依赖 vela-common / vela-framework）；7 类可插拔接口（调度器 / 执行通道 / 云厂商 / 短信 / 存储 / 通知渠道 / 认证）；JWT 双 token + 四层权限模型；H2 内存库 dev 档位零依赖启动。

界面一览¶

快速开始¶

dev 档位 10 分钟跑通：后端 H2 内存库 + 前端 Vite，本机无需 MySQL / guacd / FFmpeg。

环境要求：JDK 21 LTS · Maven 3.9+ · Node.js 20.19+（MySQL 仅生产需要）

cd velasim-server
mvn -B install -DskipTests              # 首次构建（全模块安装）
mvn -pl vela-boot spring-boot:run       # http://127.0.0.1:8080

cd velasim-web
npm install && npm run dev              # http://127.0.0.1:5173（/api 自动代理到 8080）

入口	地址
健康检查	http://127.0.0.1:8080/actuator/health
Swagger UI	http://127.0.0.1:8080/swagger-ui/index.html
OpenAPI 规范（Apifox 导入）	http://127.0.0.1:8080/v3/api-docs

dev 档位自动创建演示账号与种子数据，登录页可一键回填；生产档位首次启动生成随机初始密码并打印到启动日志（仅一次），首次登录强制改密。

文档导航¶

文档	说明
架构方案	需求范围、总体架构、模块划分、数据库设计、里程碑
二次开发指南	环境与版本清单、模块依赖、可插拔扩展点 step-by-step
用户手册	普通用户 / 租户管理员 / 平台管理员分册
部署手册	CentOS / Ubuntu / Docker 三分册
运维手册	备份恢复 / 告警处置 / 日志归档 / 故障排查
测试报告	测试体系与结果（E2E / 压测数据）
进度记录	里程碑实施进度

开源与参与¶

许可证：Apache License 2.0
贡献指南：CONTRIBUTING.md（提交规范 / 自测 / 安全约定）
开源发布：开源发布手册（发布清单 / 双平台同步 / 历史清理）
演示环境：演示环境手册（公开实例的账号与重置策略）

关于本站点¶

来源：docs/*.md（Markdown 为唯一事实源）
构建：python -m mkdocs build（产物输出到 site/，可离线双击浏览）
预览：python -m mkdocs serve
配置：根目录 mkdocs.yml（Material 主题，品牌色与产品 UI 一致）