# WorkPulse

**Repository Path**: hd092336/work-pulse

## Basic Information

- **Project Name**: WorkPulse
- **Description**: 周报 & 工时管理工具
- **Primary Language**: HTML
- **License**: GPL-3.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-21
- **Last Updated**: 2026-03-24

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# WorkPulse - 周报 & 工时管理工具

> 轻量级本地网页应用，每天简单记录，一键生成周报和月度工时汇总。

## 特性

- **开箱即用** — 单个 HTML 文件，双击打开即可，无需安装任何依赖
- **数据本地存储** — 使用浏览器 localStorage，不依赖服务器，隐私安全
- **一键生成周报** — 按项目维度自动组织，大项目按工作类型细分，格式贴近邮件正文
- **月度工时汇总** — 按项目汇总 + 明细展示，支持一键复制
- **数据可视化** — 周工时趋势柱状图、项目工时占比环形图、项目排行榜
- **灵活筛选** — 支持按日期/周/月/季度/年/自定义时间段查看数据
- **项目时间线** — 在项目管理页查看每个项目的完整工作记录

## 快速开始

下载 `work-log.html`，用浏览器打开即可。

支持 Chrome 90+、Edge 90+、Firefox 90+ 等现代浏览器。

## 功能概览

| 模块 | 说明 |
|------|------|
| **工作记录** | 按日期记录每天的工作内容，支持快速切换日期、复制记录为模板 |
| **项目管理** | 创建大项目/小项目，查看每个项目的累计工时和全部工作记录 |
| **周报生成** | 按自然周生成，大项目按类型细分，支持包含上月末关联内容，一键复制 |
| **工时汇总** | 按自然月汇总，统计卡片 + 明细表格，一键复制 |
| **数据统计** | 自定义时间段筛选，周工时趋势图 + 项目工时占比图 + 项目排行 |

## 数据结构

数据存储在浏览器 localStorage 中，key 为：

| Key | 类型 | 说明 |
|-----|------|------|
| `worklog_projects` | JSON Array | 项目列表 |
| `worklog_records` | JSON Array | 工作记录列表 |

### 项目字段

```
id          — 唯一标识
name        — 项目名称
type        — major（大项目）/ minor（小项目）
note        — 备注（选填）
```

### 工作记录字段

```
id          — 唯一标识
date        — 日期（YYYY-MM-DD）
projectId   — 关联项目 ID
hours       — 工时（小时）
workType    — 工作类型（code/design/test/doc/meeting/review/fix/other）
content     — 工作内容描述
note        — 备注（选填）
```

## 工作类型

| 标识 | 名称 |
|------|------|
| `code` | 代码编写 |
| `design` | 方案设计 |
| `test` | 测试联调 |
| `doc` | 文档编写 |
| `meeting` | 会议沟通 |
| `review` | 代码审查 |
| `fix` | 问题修复 |
| `other` | 其他 |

## 技术细节

- 纯前端实现，内联 CSS + 原生 JavaScript，无任何第三方依赖
- Canvas 原生绘图实现图表，轻量高效
- 内存缓存机制，避免重复 JSON 解析，万条级别数据无卡顿
- 数据量支持：日常使用 3 年（~2000 条）完全流畅，极限约 10000+ 条

## 后续计划

- [ ] 数据导入/导出（JSON）
- [ ] 暗色主题

## License

GPL-3.0