# 样本生成后台

**Repository Path**: zzxxnn/sample-generation-backend

## Basic Information

- **Project Name**: 样本生成后台
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-11-19
- **Last Updated**: 2025-11-28

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# F1093 仿真系统

## 项目简介

F1093仿真系统是一个基于Spring Boot的仿真管理平台，主要用于管理模型、目标和仿真记录。该项目采用现代化的技术栈，提供了完整的RESTful API接口，支持文件管理、数据持久化和仿真流程控制。

## 🚀 功能特性

### 核心功能模块

1. **模型管理** - 支持模型文件的创建、查询、更新和删除
   - 支持多种模型格式（obj、jltf等）
   - 模型分类管理（飞机、舰船等）
   - 模型文件关联管理

2. **目标管理** - 管理仿真目标的属性和参数
   - 目标基本属性（名称、尺寸、重量等）
   - 目标型号和载荷配置
   - 目标与模型关联管理

3. **仿真记录** - 记录和跟踪仿真执行过程
   - 仿真状态跟踪（初始化、待仿真、仿真中、已完成、已评估）
   - 仿真记录查询和过滤
   - 仿真样本评价分析

4. **文件管理** - 上传、下载和管理模型文件
   - 单文件上传
   - 批量文件上传
   - 文件下载和信息查询
   - 文件删除功能

5. **图层管理** - 管理仿真场景中的图层信息
   - 图层配置保存
   - 图层信息获取

## 🛠️ 技术栈

- **Spring Boot 3.5.7** - 主要应用框架
- **Spring Data JPA** - 数据访问层
- **Hibernate Community Dialects** - 数据库ORM
- **SQLite** - 轻量级数据库
- **Thumbnailator** - 图像处理库
- **Lombok** - 代码简化工具
- **JUnit 5** - 单元测试框架

## 📁 项目结构

```
2025-JC20-F1093/
├── src/main/java/com/ganzhitianxia/
│   ├── Application.java                    # 主启动类
│   ├── common/                            # 通用组件
│   │   ├── jpa/                          # JPA基础类
│   │   ├── web/                          # Web层通用类
│   │   ├── log/                          # 日志组件
│   │   └── utils/                        # 工具类
│   ├── config/                           # 配置类
│   ├── controller/                       # 控制器层
│   │   ├── ModelController.java          # 模型管理
│   │   ├── TargetController.java         # 目标管理
│   │   ├── LayerController.java          # 图层管理
│   │   └── FileController.java           # 文件管理
│   ├── service/                          # 服务层
│   ├── repository/                       # 数据访问层
│   ├── model/                           # 实体类
│   ├── vo/                              # 值对象
│   └── event/                           # 事件处理
├── src/main/resources/                  # 资源文件
├── files/                               # 文件存储目录
│   ├── images/                          # 图片文件
│   └── models/                          # 模型文件
├── build.gradle                        # Gradle构建配置
├── openapi.yaml                         # API文档
└── f1093.db                            # SQLite数据库文件
```

## 🚀 快速开始

### 环境要求

- JDK 17 或更高版本
- Gradle 7.0 或更高版本

### 安装和运行

1. **克隆项目**
   ```bash
   git clone <repository-url>
   cd 2025-JC20-F1093
   ```

2. **构建项目**
   ```bash
   ./gradlew build
   ```

3. **运行应用**
   ```bash
   ./gradlew bootRun
   ```

4. **访问应用**
   - 应用地址：http://localhost:8080
   - API文档：查看 `openapi.yaml` 文件

## 📖 API接口说明

### 模型管理接口

- `GET /api/models` - 分页查询模型列表
- `POST /api/models` - 创建新模型
- `GET /api/models/{id}` - 根据ID获取模型
- `PUT /api/models/{id}` - 更新模型信息
- `DELETE /api/models/{id}` - 删除模型

### 目标管理接口

- `GET /api/targets` - 分页查询目标列表
- `POST /api/targets` - 创建新目标
- `GET /api/targets/{id}` - 根据ID获取目标
- `PUT /api/targets/{id}` - 更新目标信息
- `DELETE /api/targets/{id}` - 删除目标
- `GET /api/targets/model/{modelId}` - 根据模型ID获取目标列表

### 仿真记录接口

- `GET /api/simulation-records` - 分页查询仿真记录
- `POST /api/simulation-records` - 创建仿真记录
- `GET /api/simulation-records/{id}` - 根据ID获取仿真记录
- `PUT /api/simulation-records/{id}` - 更新仿真记录
- `DELETE /api/simulation-records/{id}` - 删除仿真记录
- `GET /api/simulation-records/{id}/compare` - 仿真记录样本评价
- `GET /api/simulation-records/target/{targetId}` - 根据目标ID获取仿真记录
- `GET /api/simulation-records/model/{modelId}` - 根据模型ID获取仿真记录

### 文件管理接口

- `POST /api/files/upload` - 上传单个文件
- `POST /api/files/upload/batch` - 批量上传文件
- `GET /api/files/download` - 下载文件
- `GET /api/files/info` - 获取文件信息
- `DELETE /api/files` - 删除文件

### 图层管理接口

- `POST /api/layer` - 保存图层信息
- `GET /api/layer` - 获取图层信息

## 🔧 配置说明

### 数据库配置

系统使用SQLite作为数据库，数据库文件位于项目根目录下的 `f1093.db`。

### 文件存储配置

- 图片文件：`files/images/`
- 模型文件：`files/models/`

## 📊 数据模型

### Model（模型）

```java
- name: 模型名称
- type: 模型类型（飞机、舰船等）
- modelFilePath: 模型文件地址
- modelFormat: 模型格式（obj、jltf等）
- description: 详细描述
```

### Target（目标）

```java
- name: 目标名称
- modelId: 关联的模型ID
- length: 长度（米）
- width: 宽度（米）
- height: 高度（米）
- weight: 重量（千克）
- modelNumber: 型号
- payload: 载荷（红外、雷达等）
- description: 详细描述
```

### SimulationRecord（仿真记录）

```java
- recordNumber: 记录编号（唯一）
- targetId: 关联的目标ID
- modelId: 关联的模型ID
- status: 仿真状态
- description: 详细描述
```

## 🧪 测试

运行单元测试：

```bash
./gradlew test
```

## 📝 开发规范

### 代码规范

- 使用Lombok简化代码
- 统一使用`ApiResponse`作为API响应格式
- 遵循RESTful API设计原则
- 使用Spring Data JPA进行数据访问

### 提交规范

- 提交信息使用中文
- 遵循约定式提交规范

## 📄 许可证

本项目为内部使用项目。

## 👥 联系信息

- 开发团队：赶志天下科技
- 邮箱：support@ganzhitianxia.com
- 项目版本：1.0.0
- 更新日期：2025-11-28

## 🔄 版本历史

- **v1.0.0** (2025-11-28)
  - 初始版本发布
  - 实现基础模型、目标、仿真记录管理
  - 支持文件上传下载功能
  - 集成Swagger API文档

## 🔮 未来规划

- [ ] 实现用户认证和权限管理
- [ ] 增加仿真结果可视化功能
- [ ] 支持更多模型格式
- [ ] 实现仿真任务的异步执行
- [ ] 添加系统监控和日志分析功能