# tliasbackenddevelop

**Repository Path**: icebin0722/tliasbackenddevelop

## Basic Information

- **Project Name**: tliasbackenddevelop
- **Description**: 专注于后端开发的开源团队，致力于构建高效、稳定的后端服务，支持多种应用场景，为开发者提供强大的技术支持。仅仅为一个演示项目
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-04-09
- **Last Updated**: 2026-04-26

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# TLIAS Web Management

教学管理系统后端 API 服务，基于 Spring Boot 3.2.10 + Java 17 开发。

## 项目简介

TLIAS (Teaching & Learning Information Assistant System) 是一套完整的教学管理后端解决方案，提供员工管理、班级管理、学生管理等功能。

## 技术栈

| 分类 | 技术 |
|------|------|
| 框架 | Spring Boot 3.2.10 |
| Java | 17 (LTS) |
| 数据库 | MySQL 8.0 |
| ORM | MyBatis 3.0.3 |
| 分页 | PageHelper 1.4.7 |
| 缓存 | Redis + Spring Cache |
| 文件存储 | 阿里云 OSS |
| 认证 | JWT (jjwt 0.12.5) |
| AOP | Spring Boot Starter AOP |
| 构建工具 | Maven |

## 项目结构

```
web-ai-project03/
├── tilas-parent/              # 父POM，统一版本管理
├── tlias-pojo/                 # POJO实体类模块
├── tlias-utils/                # 工具类模块
└── tlias-web-management/       # 主应用模块
    ├── src/main/java/com/itheima/
    │   ├── TliasWebManagementApplication.java  # 启动类
    │   ├── config/             # 配置类
    │   ├── controller/         # REST API控制器
    │   ├── service/impl/       # 业务逻辑实现
    │   ├── mapper/             # MyBatis数据访问层
    │   ├── filter/             # Servlet过滤器
    │   ├── interceptor/         # Spring拦截器
    │   ├── aspect/             # AOP切面
    │   ├── exception/          # 异常处理
    │   └── utils/              # 工具类
    └── src/main/resources/
        ├── application.yml     # 主配置文件
        ├── application-dev.yml  # 开发环境配置
        ├── application-prod.yml # 生产环境配置
        └── com/itheima/mapper/ # MyBatis XML映射文件
```

## 快速开始

### 环境要求

- JDK 17+
- Maven 3.6+
- MySQL 8.0+
- Redis 6.0+

### 配置

1. 复制并配置数据库：

```bash
# 设置环境变量或修改 application-dev.yml
export DB_HOST=localhost
export DB_PORT=3306
export DB_NAME=tlias
export DB_USERNAME=root
export DB_PASSWORD=your_password
```

2. 配置 Redis：

```bash
export REDIS_HOST=localhost
export REDIS_PORT=6379
export REDIS_PASSWORD=your_redis_password
```

3. 配置阿里云 OSS（可选）：

```bash
export OSS_ENDPOINT=https://oss-cn-beijing.aliyuncs.com
export OSS_BUCKET=your-bucket-name
export OSS_ACCESS_KEY_ID=your-access-key
export OSS_ACCESS_KEY_SECRET=your-secret-key
```

4. 配置 JWT 密钥：

```bash
export JWT_SECRET=your-256-bit-secret-key-here
export JWT_EXPIRATION=86400000
```

### 构建与运行

```bash
# 构建项目
mvn clean package

# 运行项目（开发环境）
mvn spring-boot:run

# 运行项目（指定环境）
mvn spring-boot:run -Dspring-boot.run.profiles=prod

# 运行测试
mvn test

# 跳过测试构建
mvn clean package -DskipTests
```

### API 端口

默认端口：`8080`

## 架构设计

### 三层架构

```
Controller (REST API) → Service (业务逻辑) → Mapper (数据访问)
```

### 统一响应格式

所有 API 返回 `Result` 对象：

```json
{
  "code": 200,
  "msg": "success",
  "data": {}
}
```

### 认证机制

- 使用 JWT Token 进行身份认证
- `TokenFilter`：Servlet 过滤器级别的 JWT 验证
- `TokenInterceptor`：Spring MVC 拦截器级别的请求验证
- 登录接口 `/login` 免认证

## 主要功能模块

| 模块 | 说明 |
|------|------|
| 员工管理 | 增删改查、密码管理 |
| 部门管理 | 部门信息的 CRUD |
| 班级管理 | 班级信息管理 |
| 学生管理 | 学生信息管理 |
| 日志管理 | 操作日志记录与查询 |
| 文件上传 | 阿里云 OSS 文件存储 |
| 数据报表 | 员工岗位统计等 |

## 环境配置

| 环境 | 配置文件 | 用途 |
|------|----------|------|
| 开发环境 | `application-dev.yml` | 本地开发测试 |
| 生产环境 | `application-prod.yml` | 正式部署 |

激活不同环境：

```bash
# 通过命令行
mvn spring-boot:run -Dspring-boot.run.profiles=prod

# 或在 application.yml 中设置
spring:
  profiles:
    active: prod
```

## 开发指南

### 添加新模块

1. 在 `tilas-parent/pom.xml` 的 `<modules>` 中添加新模块
2. 创建模块目录结构
3. 在父 POM 的 `<dependencyManagement>` 中添加依赖版本管理

### 代码规范

- 使用 Lombok 简化代码
- 所有 Controller 返回 `Result` 对象
- 使用 `@Log` 注解记录操作日志
- 敏感操作使用 AOP 拦截

### 测试

```bash
# 运行单个测试类
mvn test -Dtest=EmpServiceTest

# 生成测试覆盖率报告
mvn test jacoco:report
```

## 许可证

本项目仅供学习交流使用。

## 联系方式

如有问题，请提交 Issue。