# 项目管理与工时追踪系统

**Repository Path**: kaikz/project-time-tracker

## Basic Information

- **Project Name**: 项目管理与工时追踪系统
- **Description**: 一个专为开发者设计的轻量级项目管理与工时追踪桌面应用。无需数据库，无需启动服务，开箱即用。
- **Primary Language**: JavaScript
- **License**: GPL-3.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2025-10-24
- **Last Updated**: 2025-10-29

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 项目工时追踪系统 - Project Time Tracker

一个专为开发者设计的轻量级项目管理与工时追踪桌面应用。无需数据库，无需启动服务，开箱即用。

## 🌟 项目背景

作为一名Java后端工程师，我在接项目时经常遇到项目/工时记录混乱的问题。传统的项目管理工具要么过于复杂，要么需要启动数据库服务。为了解决这个问题，我开发了这个**纯前端、轻量化**的桌面应用，让工时记录变得简单高效。

## ✨ 核心特性

- **🚀 开箱即用** - 无需安装数据库，无需启动服务，双击即可使用
- **💾 本地存储** - 数据安全存储在本地，保护隐私
- **📊 智能统计** - 自动计算总工时、工作天数、日均工时
- **🔍 快速搜索** - 支持项目名称、描述、标签的实时搜索
- **📁 数据备份** - 支持JSON格式的导入导出，便于数据迁移
- **🎨 美观界面** - 现代化UI设计，操作直观简单
- **⚡ 轻量快速** - 基于Electron，资源占用低，启动迅速

## 🛠️ 技术栈

- **前端框架**: Electron 22.x
- **界面技术**: HTML5 + CSS3 + 原生JavaScript
- **数据存储**: 本地文件系统 (JSON格式)
- **打包工具**: electron-builder
- **跨平台支持**: Windows, macOS, Linux[macOS与linux请自行打包]

## 📦 快速开始

### 方法一：直接下载安装（推荐）

前往 [Releases页面](https://gitee.com/kaikz/project-time-tracker/releases)下载最新版本的安装包：

- Windows: `项目工时追踪系统 Setup 2.0.exe`

### 方法二：从源码构建

```
# 克隆项目
git clone https://gitee.com/kaikz/project-time-tracker.git
cd project-time-tracker

# 安装依赖
npm install

# 开发模式运行
npm start

# 打包应用
npm run build-win
```

## 📖 使用指南

### 创建项目

1. 点击"添加项目"按钮
2. 填写项目名称、描述、起止日期
3. 添加标签便于分类（如：前端、后端、紧急）

### 记录工时

1. 选择项目后点击"添加工时记录"
2. 选择工作日期、填写工时和工作内容
3. 系统自动统计总工时和平均工时

### 数据管理

- **导出**: 将数据备份为JSON文件
- **导入**: 从备份文件恢复数据
- **搜索**: 在搜索框输入关键词快速查找项目

## 🗂️ 项目结构

```
project-time-tracker/
├── main.js                 # Electron主进程
├── preload.js             # 预加载脚本
├── workorder.html         # 主界面
├── package.json           # 项目配置
├── build/                 # 构建资源
│   └── icon.ico          # 应用图标
└── dist/                  # 打包输出目录
```

## 🤝 参与贡献

我们欢迎各种形式的贡献！

### 贡献方式

- 🐛 报告Bug
- 💡 提出新功能建议
- 📝 改进文档
- 🔧 提交代码修复

## 📄 许可证

本项目基于 [GLP3.0许可证]开源。

## 🐛 问题反馈

如果您遇到任何问题或有改进建议，请通过以下方式反馈：

1. [提交Issue]

## 🔮 开发计划

-  数据可视化图表
-  工时报告导出（PDF/Excel）
-  多语言支持
-  云同步功能
-  插件系统

## 🙏 致谢

感谢所有为这个项目做出贡献的开发者！特别感谢：

- Electron 团队提供的优秀框架
- 开源社区的各种工具和库

------

**如果这个项目对您有帮助，请给个⭐Star支持一下！**

------

## 📞 联系方式

- **作者**: 伤心的红豆饼
- **Gitee**: [ @kkz ](https://gitee.com/kaikz)

*让工时记录变得简单，让项目管理更高效。*