# quick-checkin

**Repository Path**: dentonliu/quick-checkin

## Basic Information

- **Project Name**: quick-checkin
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-12-22
- **Last Updated**: 2025-12-22

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 打卡应用（Quick Check-in）

## 项目介绍
一个基于HarmonyOS ArkTS开发的打卡应用，支持设置个性化打卡任务、桌面卡片快捷打卡以及数据本地存储与备份。

## 功能特性

### 核心功能
- ✅ 设置打卡任务名称、频率（每日/每周/每月）和卡片颜色
- ✅ 数据保存在本地关系型数据库（RelationalStore）
- ✅ 支持数据库备份与恢复功能

### 扩展功能
- ✅ 桌面卡片功能：可将单个打卡任务添加到桌面
- ✅ 点击桌面卡片快速完成打卡
- ✅ 支持设置每日打卡次数（1-10次）
- ✅ 任务卡片显示今日已完成/目标打卡次数

## 技术栈

- **开发语言**: ArkTS（HarmonyOS TypeScript扩展）
- **UI框架**: ArkUI（声明式UI组件）
- **数据库**: RelationalStore（HarmonyOS内置关系型数据库）
- **文件操作**: fs模块（用于数据库备份/恢复）
- **桌面卡片**: Service Widget（HarmonyOS服务卡片）

## 项目结构

```
quick-checkin/
├── entry/
│   └── src/main/ets/
│       ├── models/              # 数据模型
│       │   └── TaskModel.ets    # 打卡任务模型
│       ├── utils/               # 工具类
│       │   └── DatabaseManager.ets # 数据库管理
│       ├── pages/               # 页面
│       │   ├── TaskListPage.ets  # 任务列表页面
│       │   └── TaskDetailPage.ets # 任务详情页面
│       └── servicewidgets/      # 桌面卡片
│           └── PunchCardWidget/ # 打卡卡片实现
├── .gitignore                   # Git忽略文件
└── README.md                    # 项目说明
```

## 使用说明

1. **添加打卡任务**
   - 点击"添加任务"按钮
   - 设置任务名称、打卡频率、卡片颜色和每日打卡次数
   - 点击"保存"完成任务创建

2. **完成打卡**
   - 在任务列表页面点击打卡按钮
   - 或点击桌面卡片快速完成打卡
   - 打卡次数会实时更新显示

3. **数据管理**
   - 使用备份功能将数据库导出到本地文件
   - 使用恢复功能从备份文件恢复数据

4. **桌面卡片**
   - 在任务列表页面点击"添加到桌面"按钮
   - 长按桌面空白处可调整卡片位置

## 开发环境

- HarmonyOS DevEco Studio
- Node.js (如果需要npm依赖管理)
- HarmonyOS SDK

## 贡献说明

欢迎提交Issue和Pull Request来改进项目！

1. Fork本仓库
2. 创建特性分支 (`git checkout -b feature/AmazingFeature`)
3. 提交更改 (`git commit -m 'Add some AmazingFeature'`)
4. 推送到分支 (`git push origin feature/AmazingFeature`)
5. 打开Pull Request

## 许可证

本项目采用MIT许可证，详见LICENSE文件。