CrossBorder_OS/backend

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字段