# time-record

**Repository Path**: ShuFanny/time-record

## Basic Information

- **Project Name**: time-record
- **Description**: 简单时间记录器，Java GUI实现
- **Primary Language**: Java
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-10-28
- **Last Updated**: 2026-04-16

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 时间记录器 (Time Record)

一个基于 JavaFX 的简单时间记录工具，帮助用户追踪和管理时间使用情况。

## 📌 功能简介

- **记录时间**：用户可以开始和结束时间记录，系统会自动计算持续时间。
- **分类管理**：支持为不同的时间记录设置分类和详细描述。
- **数据存储**：所有记录存储在本地 SQLite 数据库中，支持查询和删除操作。
- **界面友好**：使用 JavaFX 构建图形界面，提供直观的操作方式。

## 🛠️ 技术栈

- JavaFX：用于构建图形用户界面。
- SQLite：轻量级数据库，用于存储时间记录。
- JDBC：用于与数据库交互。
- Lombok：简化 Java 类的开发。
- Logback：用于日志记录。

## 📦 项目结构

- `App.java`：应用程序入口。
- `db/DBHelper.java`：数据库操作类，包括初始化、增删改查等功能。
- `entity/TimeRecord.java`：时间记录实体类。
- `ui/MainUI.java`：主界面和交互逻辑。
- `util/TimeUtils.java`：时间格式化工具类。
- `resources/style.css`：界面样式文件。

## 🧪 使用说明

1. **启动程序**  
   运行 `App.java` 中的 `main` 方法启动程序。

2. **开始记录**  
   在界面中选择或输入分类和详细描述，点击“开始”按钮记录起始时间。

3. **结束记录**  
   点击“结束”按钮记录结束时间，系统会自动计算持续时间并保存。

4. **查看记录**  
   所有记录会显示在下方表格中，支持按分类查看详细内容。

5. **删除记录**  
   点击记录旁的删除按钮，可以删除对应的时间记录。

## 🔧 数据库结构

- **表名**：`time_records`
- **字段**：
  - `id`：主键
  - `category`：分类
  - `details`：详细描述
  - `start_time`：开始时间
  - `end_time`：结束时间
  - `duration_seconds`：持续时间（秒）
  - `create_time`：创建时间
  - `update_time`：更新时间

## 📄 许可证

本项目使用 [MIT License](LICENSE)。

## 🤝 贡献指南

欢迎提交 Issue 和 Pull Request！请遵循项目代码风格并提供清晰的提交信息。

## 📬 联系方式

如有任何问题或建议，请通过 Gitee 私信联系作者。

---

**开发语言**：Java  
**图形界面**：JavaFX  
**数据库**：SQLite  
**构建工具**：Maven (`pom.xml`)  
**日志框架**：Logback (`@Slf4j`)  
**代码简化**：Lombok (`@Data`, `@NoArgsConstructor`)