# digital-twin-system

**Repository Path**: cnlyuhan/digital-twin-system

## Basic Information

- **Project Name**: digital-twin-system
- **Description**: A unified system for digital twin management, training subjects, and scene editing
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2025-02-18
- **Last Updated**: 2026-05-06

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 可配置引擎

数字孪生系统是一个统一的管理平台，支持数字孪生体的创建与管理、训练科目的配置与执行、以及场景的编辑与可视化。

---

## 功能模块
1. **数字孪生体管理**：
   - 创建、修改、删除数字孪生体。
   - 配置数字孪生体的基本属性、组件、电子教学信息和机理模型。
   - 生成并存储 X3D 文件。

2. **训练科目管理**：
   - 创建、修改、删除训练科目。
   - 配置训练科目的基本属性、关联数字孪生体、训练步骤和场景文件。
   - 生成并存储 X3D 文件。

3. **场景编辑器**：
   - 选择岛屿文件（2D 图像）。
   - 拖拽数字孪生体（2D 图标）并配置连接关系。
   - 生成并存储 X3D 文件。

---

## 技术栈
### 前端
- **框架**：Vue3
- **UI 组件库**：Element Plus
- **状态管理**：Pinia
- **HTTP 客户端**：Axios
- **3D 渲染**：Three.js

### 后端
- **框架**：Spring Boot
- **ORM**：MyBatis-Plus
- **数据库**：MySQL
- **文件存储**：MinIO
- **实时通信**：WebSocket

### 其他工具
- **Python 脚本**：用于 FBX 文件转换为 X3D 文件。
- **CI/CD**：GitHub Actions / Gitee Actions

---

## 开发环境
### IDE
- **前端**：VS Code 或 WebStorm
- **后端**：IntelliJ IDEA 或 Eclipse

### 依赖管理
- **前端**：npm / yarn
- **后端**：Maven

### 数据库
- **MySQL**：版本 8.0+
- **MongoDB**：版本 5.0+（用于存储非结构化数据）

---

## 分支管理

本项目采用分支策略开发，主要分支如下：

### 主分支
- **`main`**：稳定版本分支，用于发布和生产环境。

### 开发分支
- **`feature/main`**：主开发分支，用于整合各模块的代码。

### 模块分支
以下分支基于 `feature/main` 分支创建，分别用于开发不同模块：
- **`feature/digital-twin`**：数字孪生体管理模块。
- **`feature/training-subject`**：训练科目管理模块。
- **`feature/scene-editor`**：场景编辑器模块。

### 分支使用流程
1. **创建分支**：
   - 从 `feature/main` 分支创建新的模块分支：
     ```bash
     git checkout -b feature/your-module feature/main
     ```

2. **开发功能**：
   - 在模块分支上开发功能，并提交代码：
     ```bash
     git add .
     git commit -m "Add your feature"
     ```

3. **推送分支**：
   - 将模块分支推送到远程仓库：
     ```bash
     git push origin feature/your-module
     ```

4. **合并分支**：
   - 通过 Pull Request 将模块分支合并到 `feature/main` 分支。

5. **删除分支**：
   - 合并完成后，删除本地和远程的模块分支：
     ```bash
     git branch -d feature/your-module
     git push origin --delete feature/your-module
     ```

---