# t3d-j

**Repository Path**: GhostMask/t3d-j

## Basic Information

- **Project Name**: t3d-j
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-06-04
- **Last Updated**: 2026-06-29

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# T-3D Java 版

基于 Spring Boot 3.2 + Java 17 的三维可视化后端服务。

## 技术栈

- Spring Boot 3.2.5
- MyBatis-Plus 3.5.6 (ORM)
- MySQL (数据库)
- Spring Security + JWT (认证)
- Spring WebSocket + STOMP (实时通信，替代 .NET SignalR)
- EasyExcel (Excel 导出)
- Knife4j (API 文档)
- Caffeine (本地缓存)

## 启动

```bash
mvn clean package -DskipTests
java -jar target/t-3d-1.0.0.jar
```

## API 文档

启动后访问: http://localhost:5003/doc.html

## WebSocket

连接端点: ws://localhost:5003/hubs (SockJS)
STOMP 主题: /topic/scene/{sceneId}
STOMP 消息映射: /app/group/{sceneId}

## 与 .NET 版差异

1. SignalR → Spring WebSocket + STOMP
2. 前端需将 `@microsoft/signalr` 替换为 `@stomp/stompjs` + `sockjs-client`
3. API 路由、请求/响应格式完全兼容