# taskManager

**Repository Path**: dabaibai/task-manager

## Basic Information

- **Project Name**: taskManager
- **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-02
- **Last Updated**: 2026-05-03

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 日常任务管理器 (Daily Task Manager)

一款使用现代 Android 技术栈开发的移动任务管理应用。

## 技术栈

- **语言**: Kotlin
- **UI 框架**: Jetpack Compose
- **架构**: MVVM (Model-View-ViewModel)
- **数据库**: Room (SQLite)
- **依赖注入**: Hilt
- **设计系统**: Material Design 3

## 项目结构

```
app/
├── src/
│   ├── main/
│   │   ├── java/com/example/dailytaskmanager/
│   │   │   ├── data/              # 数据层
│   │   │   │   ├── local/         # Room DAO 和数据库
│   │   │   │   └── repository/   # Repository 实现
│   │   │   ├── domain/           # 领域层
│   │   │   │   ├── model/        # 数据模型
│   │   │   │   └── repository/   # Repository 接口
│   │   │   ├── di/               # 依赖注入模块
│   │   │   ├── ui/               # UI 层
│   │   │   │   ├── screens/      # Compose 屏幕
│   │   │   │   ├── components/   # 可复用组件
│   │   │   │   ├── viewmodel/    # ViewModel
│   │   │   │   ├── navigation/   # 导航配置
│   │   │   │   └── theme/        # 主题样式
│   │   │   └── DailyTaskManagerApplication.kt
│   │   ├── res/                  # Android 资源
│   │   └── AndroidManifest.xml
│   └── test/                     # 单元测试
└── build.gradle.kts
```

## 功能特性

### 核心功能
- ✅ 任务创建、编辑、删除（CRUD）
- ✅ 任务完成状态管理
- ✅ 三级优先级（高/中/低）
- ✅ 任务分类和筛选
- ✅ 截止日期设置
- ✅ 数据持久化（Room 数据库）

### UI 特性
- ✅ Material Design 3 设计
- ✅ Jetpack Compose 声明式 UI
- ✅ 优先级颜色标识（红/黄/绿）
- ✅ 任务完成删除线样式
- ✅ 逾期任务视觉提醒
- ✅ 空状态提示

### 架构特性
- ✅ MVVM 分层架构
- ✅ 依赖注入（Hilt）
- ✅ 响应式编程（Kotlin Flow）
- ✅ 仓库模式
- ✅ 单元测试覆盖

## 快速开始

### 环境要求
- Android Studio Hedgehog (2023.1.1) 或更高版本
- JDK 17
- Android SDK 34
- Gradle 8.2

### 构建步骤

1. 克隆项目到本地
2. 使用 Android Studio 打开项目
3. 等待 Gradle 同步完成
4. 运行应用（Ctrl + R 或点击 Run 按钮）

### 构建命令

```bash
# 调试版本
./gradlew assembleDebug

# 运行测试
./gradlew test

# 生成测试报告
./gradlew jacocoTestReport
```

## 依赖版本

| 库 | 版本 |
|---|---|
| Kotlin | 1.9.20 |
| Compose BOM | 2023.10.01 |
| Room | 2.6.1 |
| Hilt | 2.48.1 |
| Navigation Compose | 2.7.5 |
| Material 3 | 1.1.2 |

## 代码质量

### 测试覆盖率目标
- 业务逻辑：≥ 80%
- ViewModel: ≥ 70%
- UI 组件：≥ 50%

### 测试文件
- `TaskRepositoryImplTest.kt` - Repository 层测试
- `TaskViewModelTest.kt` - ViewModel 层测试

## 使用说明

### 添加任务
1. 点击主界面右下角浮动按钮（+）
2. 填写任务标题（必填）
3. 可选填写描述、优先级、分类、截止日期
4. 点击右上角勾选图标保存

### 管理任务
- **标记完成**: 点击任务左侧复选框
- **查看详情**: 点击任务项
- **编辑任务**: 在详情页点击编辑按钮
- **删除任务**: 点击任务右侧删除图标

### 筛选任务
- 点击右上角筛选按钮
- 可选择按优先级或分类筛选
- 支持查看已完成/未完成的任务

## 后续开发计划

- [ ] 拖拽排序功能
- [ ] 任务子功能
- [ ] 任务重复设置
- [ ] 通知提醒
- [ ] 数据备份和恢复
- [ ] 深色模式优化
- [ ] 桌面小部件

## 许可证

本项目仅供学习和参考使用。

## 项目规范文档

详细的需求文档和技术设计文档位于：
`.monkeycode/specs/2026-05-02-daily-task-manager/`

- `requirements.md` - 需求规格说明书
- `design.md` - 技术设计文档
- `tasklist.md` - 实施任务清单