# Management

**Repository Path**: aptook/management

## Basic Information

- **Project Name**: Management
- **Description**: 自用轻量级管理系统
- **Primary Language**: Java
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2025-12-01
- **Last Updated**: 2026-10-16

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 轻量级管理系统

这是一个基于Spring Boot的轻量级管理系统，提供多种实用工具和功能模块。

## 功能特点

- **Base64编解码**：文件转Base64、Base64转文件（同步与异步两种接口）、文本Base64编码与解码
- **图片压缩**：支持调整压缩质量、尺寸和输出格式
- **时间戳转换**：时间戳与日期时间互转，支持时区转换和时间差计算
- **工时管理**：记录和统计工作时间，支持周统计与加班时间计算，法定节假日与调休自动判定
- **网址收藏**：收藏的增删改查、关键词搜索与拖拽排序
- **字节转换**：数据单位（B/KB/MB/GB 等）换算
- **速查手册**：8 个分类的常用速查条目检索，附带正则测试
- **用户管理**：登录、注册、用户列表管理和用户状态切换

## 技术架构

- **后端**：Spring Boot 2.7（Java 8），接口统一返回 `Result` 结构
- **前端**：Thymeleaf 模板 + 纯HTML/CSS/JavaScript，响应式设计
- **数据库**：MyBatis + Druid 连接池 + MySQL，建表脚本见 `src/main/resources/db/init.sql`
- **认证**：基于 Cookie Token 的登录校验
- **异步处理**：Base64 转换与收藏查询复用 `ForkJoinPool.commonPool()`，不额外创建业务线程池
- **节假日数据**：优先读取权威假期数据（远程 / 本地缓存），获取不到时按农历推算兜底，见 `LegalHolidayService`

## 安装部署

1. 克隆仓库：`git clone https://gitee.com/aptook/management.git`
2. 初始化数据库：执行 `src/main/resources/db/init.sql`
3. 构建项目：`mvn clean package -DskipTests`
4. 运行应用：`java -jar target/management-1.0.0.jar`
5. 访问首页：打开浏览器访问 `http://localhost:8080`

## 使用说明

- **首页**：访问 `/`（未登录会跳转到 `/login`）
- **Base64工具**：`/base64`（文件↔Base64）、`/base64-encode`（文本编解码）、`/base64-to-file`（Base64→文件）
- **图片压缩**：访问 `/image-compress`
- **时间戳转换**：访问 `/timestamp`
- **工时管理**：访问 `/worktime`
- **网址收藏**：访问 `/bookmark`
- **字节转换**：访问 `/byte-converter`
- **速查手册**：访问 `/quick-reference`，正则测试访问 `/regex-test`
- **用户管理**：访问 `/login`、`/userlist`

## API文档

所有API接口返回统一格式的JSON数据：
```json
{
  "code": 200,
  "message": "操作成功",
  "data": { },
  "timestamp": 1625648937123,
  "success": true
}
```

请求失败时 `success` 为 false，`code` 为业务错误码（如 401 未登录、400 参数错误），`message` 为提示信息。
具体接口定义请参考各模块控制器类。

## 配置说明

配置文件位于 `application.yml`，常用配置项：

- `server.port`：服务端口，默认 8080
- `spring.datasource.*`、`spring.datasource.druid.*`：数据库连接与连接池参数
- `spring.servlet.multipart.max-file-size` / `max-request-size`：上传文件大小限制
- `spring.thymeleaf.cache`：模板缓存开关（当前 false，模板改动即时生效）
- `file.upload-path`：文件上传根目录
- `file.max-file-size-mb`：业务层单个文件大小上限
- `worktime.holiday-cache-dir`：节假日数据本地缓存目录，默认 `./holiday-cache`
- `logging.file.path`：日志目录，默认 `../applog`（`LogCleanupScheduler` 按此目录清理过期日志）

## 贡献指南

欢迎贡献代码！请遵循以下步骤：
1. Fork仓库
2. 创建新分支
3. 提交代码更改
4. 创建Pull Request

## 许可证

本项目采用MIT许可证，详细信息请参阅LICENSE文件。