# Cross-border OMS Backend

## 技术栈

- Spring Boot 3.2.0
- Java 17
- MySQL 8.0
- MyBatis Plus 3.5.5
- Redis
- JWT Authentication

## 项目结构

```
backend/
├── src/main/java/com/oms/
│   ├── OmsApplication.java          # 启动类
│   ├── config/                       # 配置类
│   │   └── MybatisPlusConfig.java
│   ├── controller/                    # 控制器
│   │   └── AuthController.java
│   ├── service/                      # 服务层
│   │   └── SysUserService.java
│   ├── repository/                   # 数据访问层
│   │   └── SysUserRepository.java
│   ├── entity/                       # 实体类
│   │   ├── BaseEntity.java
│   │   └── SysUser.java
│   ├── dto/                          # 数据传输对象
│   └── common/                       # 通用类
│       └── ApiResponse.java
├── src/main/resources/
│   └── application.yml              # 应用配置
└── pom.xml                           # Maven配置

## 快速开始

### 1. 创建数据库
```sql
CREATE DATABASE oms DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
```

### 2. 修改配置
编辑 `src/main/resources/application.yml`，修改数据库连接信息。

### 3. 启动
```bash
mvn spring-boot:run
```

### 4. 访问API文档
http://localhost:8080/api/doc.html

## 模块说明

| 模块 | 说明 |
|-----|-----|
| controller | REST API控制器 |
| service | 业务逻辑层 |
| repository | 数据访问层(继承MyBatis Plus BaseMapper) |
| entity | JPA/MyBatis Plus实体类 |
| dto | 数据传输对象 |
| common | 通用响应、异常等 |
| config | Spring配置类 |

## 开发规范

1. 实体类继承`BaseEntity`，自动包含审计字段
2. 使用`BIGINT AUTO_INCREMENT`作为主键
3. API响应统一使用`ApiResponse`
4. 所有业务表包含`tenant_id`字段支持多租户
5. 使用逻辑删除`deleted`字段