# HomeworkRecord

**Repository Path**: tabortao/HomeworkRecord

## Basic Information

- **Project Name**: HomeworkRecord
- **Description**: 时间管理和学习打卡小程序、家庭积分管理小程序
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: https://tabortao.github.io/HomeworkRecord
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-10-16
- **Last Updated**: 2025-11-05

## Categories & Tags

**Categories**: Uncategorized

**Tags**: 积分

## README

# 时间管理打卡小程序

一个专为小学生设计的时间管理和学习打卡小程序，帮助学生有效地管理学习计划、追踪日常任务完成情况，并提供激励机制、小心愿系统和多用户支持。

## 🎯 功能特点

### 计划概览与统计
- 顶部数据统计：显示今日学习时间、运动户外时间、任务数量和完成率
- 统计图表汇总：提供学习时长、完成率和学科分布等多维度图表分析
- 荣誉勋章系统：根据完成情况颁发虚拟勋章，激励持续学习

### 日期选择与周视图
- 日历导航：显示当前周信息，支持周切换和快速返回本周
- 日期选择器：以卡片形式展示每周的每一天计划
- 今日标记：使用"今"字突出显示当天日期

### 多学科任务管理
- 学科分类：任务按学科（语文、数学、英语等）进行分类展示
- 任务卡片：包含任务标题、要求、完成状态、计划与实际时长
- 操作按钮：支持编辑、删除、计时和子任务管理
- 密码保护：任务的添加、编辑、删除操作均需密码验证，确保数据安全

### 任务添加与操作
- 浮动添加按钮：快速添加新的学习计划或任务
- 打卡功能：直接标记任务完成状态
- 筛选功能：按完成状态和学科筛选任务
- 用户反馈：支持对任务添加评论和反馈

### 小心愿系统
- 心愿管理：添加、编辑、查看和删除个人心愿
- 心愿兑换：完成任务获取积分，达到积分要求后可兑换心愿
- 密码验证：心愿相关操作（添加、编辑、删除、兑换）均需密码验证
- 心愿状态：心愿卡片显示标题、描述、所需积分和当前状态

## 🛠️ 技术栈

- HTML5：页面结构和语义化标签
- JavaScript：交互逻辑和数据处理
- Tailwind CSS v3：响应式UI设计和样式
- Font Awesome：图标库
- Chart.js：数据可视化图表
- 本地存储：数据持久化存储和用户隔离
- 密码验证机制：保护关键操作的安全
- Promise和异步处理：确保操作的正确执行顺序

## 🚀 快速开始

1. 克隆或下载本项目到本地
2. 使用浏览器打开 `index.html` 文件即可运行
3. 无需额外的服务器或数据库配置

## 📱 响应式设计

应用支持从手机到桌面的各种设备尺寸，在不同屏幕上都能提供良好的用户体验：
- 移动端：单列布局，优化触摸操作
- 平板：双列或三列布局
- 桌面：多列布局，充分利用屏幕空间

## 📊 数据存储

应用使用浏览器的本地存储（localStorage）来保存用户数据，包括：
- 用户任务信息（任务名称、学科、时长、状态等）
- 小心愿数据（心愿标题、描述、所需积分等）
- 统计数据和用户成就
- 用户设置和偏好

所有敏感操作都通过密码验证机制进行保护，确保数据安全。请注意，本地存储的数据仅保存在当前浏览器中，清除浏览器数据可能会导致数据丢失。

## 🎨 自定义配置

你可以通过修改以下文件来自定义应用：

- `tailwind.config.js`：修改颜色主题、字体和阴影等样式
- `js/app.js`：修改应用逻辑和功能
- `js/mockData.js`：调整模拟数据的生成规则

## 🔧 开发说明

如果你想进一步开发这个项目，可以：
1. 修改HTML结构以调整页面布局
2. 在app.js中添加新的功能模块
3. 创建新的CSS工具类来自定义样式
4. 扩展数据模型以支持更多功能

## 📝 注意事项

- 本应用为前端单页应用，所有数据存储在浏览器本地
- 建议使用现代浏览器（Chrome、Firefox、Safari、Edge等）以获得最佳体验
- 首次使用时会自动生成示例数据，方便用户了解应用功能
- 密码验证用于保护关键操作，默认密码为系统预设，请根据需要修改
- 小心愿系统中的积分可通过完成任务获得，达到要求后可兑换心愿

## 🤝 贡献

欢迎提出建议和改进，如果你有任何问题或想法，请随时提交Issue或Pull Request。