# t-twins-j

**Repository Path**: GhostMask/t-twins-j

## Basic Information

- **Project Name**: t-twins-j
- **Description**: 基础框架java版本，移植于.net版本
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

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

## Categories & Tags

**Categories**: Uncategorized

**Tags**: t-twins-j

## README

# T-Twins-J

基于 Java 21 + Spring Boot 3.3.6 的数字孪生平台后端，从 [.NET 版本 (t-twins)](https://gitee.com/GhostMask/t-twins) 完整移植。

## 技术栈

| 组件 | 技术 |
|------|------|
| 运行时 | Java 21 |
| 框架 | Spring Boot 3.3.6 |
| 安全 | Spring Security + JWT + OAuth 2.0 |
| ORM | MyBatis-Plus 3.5.9 |
| 数据库 | MySQL 8.0 |
| 缓存 | Spring Data Redis / MemoryCache |
| API 文档 | SpringDoc + Knife4j |

## 模块结构

```
t-twins-j/
├── t-twins-common/       共享: DTO、枚举、配置类、工具
├── t-twins-framework/    核心框架: 认证、权限、审计、通用 Controller
├── t-twins-business/     业务模块: TwinsModelConfig
├── t-twins-application/  Spring Boot 启动入口 + 配置
└── t-twins-test/         测试
```

## 快速开始

### 1. 初始化数据库

```bash
mysql -u root -p < Scripts/init-t-twins-j.sql
```

### 2. 修改配置

编辑 `t-twins-application/src/main/resources/application.yml`，配置数据库连接信息。

### 3. 启动

```bash
mvn spring-boot:run -pl t-twins-application
```

或 Docker 一键部署:

```bash
cd Docker && docker-compose up -d
```

### 4. 访问

- API 文档: http://localhost:5001/doc.html
- 健康检查: http://localhost:5001/actuator/health
- 默认管理员: `admin / admin123`

## 功能概览

- **认证**: JWT (8h Access + 7d Refresh) + OAuth 2.0 (client_credentials / authorization_code / refresh_token)
- **权限**: RBAC (用户-角色-权限)，支持菜单/按钮/API 三种权限类型
- **通用 CRUD**: BaseController 提供 9 个标准端点 (分页/全量/Top-N/按ID/编辑/删除/计数/导出/按条件删除)
- **审计日志**: 全量请求拦截，敏感字段脱敏，异步持久化
- **定时任务**: Cron 调度 HTTP 回调，支持启停/暂停/手动触发/重试
- **文件管理**: 上传/下载/批量上传，按业务类型关联
- **字典管理**: 系统字典，支持按类型/编码/键值查询

## 文档

| 文档 | 说明 |
|------|------|
| [DOTNET-JAVA-GUIDE.md](DOTNET-JAVA-GUIDE.md) | .NET → Java 开发对照手册 (含平移 SOP) |
| [DEPLOYMENT.md](DEPLOYMENT.md) | 部署文档 (本地开发 / Docker / 生产) |
| [ARCHITECTURE.md](ARCHITECTURE.md) | 架构设计文档 |

## 与 .NET 版本的关系

本项目是 [t-twins (.NET 8)](https://gitee.com/GhostMask/t-twins) 的 Java 移植版:

- **API 路由格式完全一致** — 前端无需修改
- **JSON 响应格式完全兼容** — PascalCase 字段命名
- **17 张数据库表结构对齐** — 可共用同一数据库实例
- **功能对齐率 ~95%** — 详见 DOTNET-JAVA-GUIDE.md 第 11 章