# tlias

**Repository Path**: xylve/tlias

## Basic Information

- **Project Name**: tlias
- **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-01-11
- **Last Updated**: 2026-01-11

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Tlias Web Management System

## 项目简介

Tlias 是一个基于 Spring Boot + Vue.js 的企业级 Web 管理系统，提供了完整的员工管理、部门管理、班级管理、学生管理等模块。系统采用前后端分离架构，支持文件上传、数据统计报表、操作日志等功能。

## 技术栈

### 后端技术
- **Java 17** - 编程语言
- **Spring Boot 3.2.10** - 应用框架
- **MyBatis 3.0.3** - ORM 框架
- **MySQL** - 数据库
- **JWT** - 身份认证
- **PageHelper** - 分页插件
- **阿里云 OSS** - 文件存储
- **Lombok** - 代码简化
- **Spring AOP** - 面向切面编程

### 前端技术
- **Vue 3** - 前端框架
- **Element Plus** - UI 组件库
- **Vue Router** - 路由管理
- **Pinia** - 状态管理
- **Axios** - HTTP 客户端
- **ECharts** - 数据可视化
- **Vite** - 构建工具

## 项目结构

```
tlias-web-management/
├── src/                          # 后端源码
│   ├── main/
│   │   ├── java/com/zy/
│   │   │   ├── controller/       # 控制器层
│   │   │   ├── service/          # 服务层
│   │   │   ├── mapper/           # 数据访问层
│   │   │   ├── pojo/             # 实体类
│   │   │   ├── config/           # 配置类
│   │   │   ├── exception/        # 异常处理
│   │   │   ├── filter/           # 过滤器
│   │   │   ├── interceptor/      # 拦截器
│   │   │   └── aop/              # 切面编程
│   │   └── resources/
│   │       └── application.yml   # 应用配置
│   └── test/                     # 测试代码
├── vue-tlias-management/         # 前端源码
│   ├── src/
│   │   ├── components/           # 组件
│   │   ├── views/                # 页面
│   │   ├── router/               # 路由配置
│   │   ├── stores/               # 状态管理
│   │   └── utils/                # 工具函数
│   ├── public/                   # 静态资源
│   └── dist/                     # 构建产物
├── doc/                          # 项目文档
│   ├── SQL/                      # 数据库脚本
│   └── 前端Web/                  # 前端文档
├── pom.xml                       # Maven 配置
└── README.md                     # 项目说明
```

## 核心功能模块

### 1. 用户认证与授权
- JWT Token 认证
- 登录/登出功能
- Token 拦截器验证

### 2. 员工管理 (Emp)
- 员工信息增删改查
- 员工分页查询
- 员工工作经验管理
- 员工操作日志记录

### 3. 部门管理 (Dept)
- 部门信息维护
- 部门层级管理

### 4. 班级管理 (Clazz)
- 班级信息管理
- 班级统计功能

### 5. 学生管理 (Student)
- 学生信息维护
- 学生与班级关联

### 6. 数据报表 (Report)
- 统计数据可视化
- ECharts 图表展示

### 7. 文件管理
- 阿里云 OSS 文件上传
- 文件下载功能

### 8. 系统日志
- AOP 操作日志记录
- 系统运行日志

## 快速开始

### 环境要求
- JDK 17+
- MySQL 8.0+
- Node.js 16+
- Maven 3.6+

### 数据库配置
1. 创建数据库 `tlias`
2. 执行 `doc/SQL/tlias.sql` 脚本初始化数据
3. 修改 `application.yml` 中的数据库连接信息

### 后端启动
```bash
# 进入项目根目录
cd tlias-web-management

# 编译打包
mvn clean package

# 启动应用
java -jar target/tlias-web-management-1.0-SNAPSHOT.jar
```

### 前端启动
```bash
# 进入前端目录
cd vue-tlias-management

# 安装依赖
npm install

# 启动开发服务器
npm run dev

# 构建生产版本
npm run build
```

## 配置说明

### 应用配置 (application.yml)
```yaml
spring:
  application:
    name: tlias-web-management
  datasource:
    url: jdbc:mysql://localhost:3306/tlias
    username: root
    password: root

# 阿里云 OSS 配置
aliyun:
  oss:
    endpoint: https://oss-cn-beijing.aliyuncs.com
    bucketName: your-bucket-name
    region: cn-beijing
```

## 部署说明

### 生产环境部署
1. 修改数据库连接配置
2. 配置阿里云 OSS 参数
3. 打包应用：`mvn clean package`
4. 部署到服务器并启动

### Docker 部署
```dockerfile
FROM openjdk:17
COPY target/tlias-web-management-1.0-SNAPSHOT.jar app.jar
EXPOSE 8080
ENTRYPOINT ["java", "-jar", "/app.jar"]
```

## 常见问题

### 1. 数据库连接失败
- 检查数据库服务是否启动
- 确认连接信息配置正确
- 验证数据库用户权限

### 2. 文件上传失败
- 检查阿里云 OSS 配置
- 确认 bucket 权限设置
- 验证文件大小限制

### 3. JWT Token 过期
- Token 有效期配置
- 前端自动刷新机制
- 登录状态检查

## 贡献指南

1. Fork 项目
2. 创建功能分支
3. 提交代码变更
4. 推送到分支
5. 创建 Pull Request

## 版本历史

- **v1.0.0** - 初始版本，包含基础管理功能

## 联系方式

- 项目维护者：zy
- 邮箱：2370089607@qq.com
- 项目地址：https://gitee.com/xylve/tlias.git

## 许可证

本项目采用 MIT 许可证，详情请查看 LICENSE 文件。