feat(time-tracking): 添加个人工时记录系统设计文档

- 完成系统架构和数据模型设计,包括项目、工时记录、休息日和周期表模型
- 设计项目管理模块,支持传统项目与PSI项目管理及批量导入功能
- 规划工时记录模块,含日期、事件描述、项目选择及工时计算规则
- 定义休息日分类,支持周末、国定节假日、个人假期及调休工时管理
- 制定统计分析模块设计,支持按Cut-Off周期的周统计与项目工时分布
- 设计周期管理模块,提供周期设置及预设模板功能
- 制定用户界面布局及各页面表单、样式设计方案
- 规划RESTful API端点,涵盖项目、工时记录、休息日、周期及统计数据操作
- 设计数据流示意,阐明操作流程及前后端交互逻辑
- 制定数据存储方案,包括SQLite数据库配置及备份导出机制
This commit is contained in:
2025-09-04 15:19:35 +08:00
parent cda1360ce4
commit ef9432f6da
11 changed files with 1163 additions and 0 deletions

45
README.md Normal file
View File

@@ -0,0 +1,45 @@
# 个人工时记录网站
## 安装和运行
1. 创建虚拟环境(可选):
```bash
python -m venv venv
# Windows
venv\Scripts\activate
# Linux/Mac
source venv/bin/activate
```
2. 安装依赖:
```bash
pip install -r requirements.txt
```
3. 运行应用:
```bash
python backend/app.py
```
4. 在浏览器中访问http://localhost:5000
## 功能特性
- 项目管理传统项目和PSI项目
- 工时记录和计算
- 休息日标记和工时统计
- Cut-Off周期管理
- 每周工时统计
- 数据导入导出
## 项目结构
```
time/
├── backend/ # Python Flask 后端
├── frontend/ # 前端页面
├── static/ # 静态资源
├── templates/ # HTML模板
├── data/ # 数据库文件
└── requirements.txt # Python依赖
```