# 日程管理

**Repository Path**: cloud-lumiere/schedule-management

## Basic Information

- **Project Name**: 日程管理
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-05-23
- **Last Updated**: 2026-05-27

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 大学生日程管理工具

基于 Flask + SQLite + Chart.js 的 Web 日程管理应用。

## 功能特性

### 时间记录（10分钟单元）
- 以10分钟为最小粒度记录每日活动
- 三级时间分类：**大项**（日常/学习/其它）→ **子项**（可自定义）
- 自动校验时间重叠、分钟倍数
- 支持记录的添加、修改、删除

### 日记本
- 每日日记，支持心情选择（6种表情）
- 3秒无操作自动保存
- 日记浏览历史列表
- 支持导出 JSON、删除日记

### 习惯打卡
- 自定义习惯（名称+颜色）
- 本周打卡网格视图，点击切换打卡状态
- 习惯管理（添加/编辑/删除）

### 分析统计
- **每日分析**：实际 vs 计划柱状图，标注偏差值
- **每周分析**：7天时间投入趋势图，可前后翻页
- **每月分析**：整月每日时间分布图
- **日历热力图**：月视图网格按颜色深浅显示每日总时长，鼠标悬停显示详情
- **时间线视图**：24小时时间轴上展示当天所有活动块，按类别着色

### 设置
- 时间类型子项管理（添加/归档/恢复/删除）
- 完整数据导出为 JSON
- 数据导入（支持多文件，自动冲突检测冲突则拒绝）
- 一键重置所有数据

### 数据导出
- JSON 完整导出（7张表全量数据）
- Excel 每日汇总表（日期/分类/实际/计划/偏差）
- 单篇日记导出为 JSON

## 项目结构

```
MyTimeManger/
├── app.py               # Flask 应用入口
├── schedule.db          # SQLite 数据库
├── README.md
├── templates/
│   └── index.html       # 页面模板
└── static/
    ├── style.css        # 样式表
    └── script.js        # 前端逻辑（Chart.js）
```

## 环境要求

- Python 3.9+

```bash
pip install flask pandas openpyxl
```

## 启动

```bash
cd MyTimeManger
python app.py
```

浏览器访问 `http://127.0.0.1:5000`

## 快速上手

1. **首次使用**：打开「设置 → 时间类型设置」，为三大类（日常/学习/其它）添加子项
2. **记录活动**：时间记录页选择大项 → 子项 → 设置时间 → 添加记录（自动约束10分钟倍数）
3. **设置计划**：分析页点击「设置计划」，为各分类设定目标分钟数
4. **查看分析**：分析页切换每日/每周/每月/日历热力图/时间线
5. **数据迁移**：设置页导出完整 JSON → 另一设备导入

## 数据库表

| 表名 | 说明 |
|---|---|
| `activities` | 活动记录（含子项关联） |
| `daily_plan` | 每日计划时长 |
| `categories` | 扁平类别列表 |
| `time_major_categories` | 时间大项（日常/学习/其它） |
| `time_subcategories` | 时间子项（支持归档） |
| `diaries` | 日记 |
| `habits` | 习惯定义 |
| `habit_checkins` | 习惯打卡记录 |