#  StudyAide

**Repository Path**: yangthy/study-aide

## Basic Information

- **Project Name**:  StudyAide
- **Description**: 学习助手（StudyAide）是一款基于HarmonyOS平台开发的智能学习管理应用软件，面向学生、家长和教育工作者提供全方位的学习管理服务。软件以"计划 → 执行 → 复盘 → 成长"为核心设计理念，通过数字化手段帮助用户科学合理地安排学习任务，追踪学习进度，巩固薄弱知识点，实现学习过程的系统化、科学化管理。
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-12-19
- **Last Updated**: 2026-04-28

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# StudyAide - 学习助手

#### 介绍
StudyAide 学习助手是一款基于 HarmonyOS 打造的智能学习管理应用，
面向学生和家长提供作业管理、学习计划、测验练习、学习统计与成长档案等一站式能力。
它以“计划 → 执行 → 复盘 → 成长”为主线，帮助用户合理安排每天和每周的学习任务，
追踪作业与任务完成情况，通过错题本和测验巩固薄弱知识点，
并利用周报 / 月报等可视化报告全面了解学习进度和效率。
同时，应用集成 AGC Account 与 CloudDB，实现多设备云端同步和安全的数据存储，让学习过程更高效、更可持续。

- 更清晰地 **规划每天 / 每周的学习任务**
- 及时掌握 **作业与任务的完成情况与截止时间**
- 通过测验与错题本 **巩固薄弱知识点**
- 通过学习报告与成长档案 **持续复盘与激励自己**

同时，StudyAide 深度集成 **AGC CloudDB / Account**，支持多设备云端同步，让学习数据更安全可靠。

#### 软件架构

本项目采用 **MVVM 架构模式**，结合 **Repository 模式**进行数据访问，使用 **CloudDB** 作为云端数据存储。

##### 架构说明

**数据流向：**
```
页面 (Page)
  ↓ 调用
视图模型 (ViewModel)
  ↓ 调用
数据仓储 (Repository)
  ↓ 调用
服务层 (Service) → CloudDB
```

**各层职责：**

1. **Page 层**：UI 展示层，只负责界面展示和用户交互
2. **ViewModel 层**：管理页面状态和业务逻辑，提供响应式数据给页面
3. **Repository 层**：统一数据访问入口，封装 CloudDB 调用细节
4. **Service 层**：基础服务能力，如 CloudDB 连接、Account 认证等
5. **Model 层**：数据模型定义，纯类型结构

#### 技术栈

- **开发框架**：HarmonyOS ArkUI
- **开发语言**：ArkTS (TypeScript)
- **数据存储**：AGC CloudDB（云端数据库）
- **认证服务**：AGC Account（华为账号认证）
- **架构模式**：MVVM + Repository

#### 安装教程

1. 安装 DevEco Studio（HarmonyOS 开发工具）
2. 克隆项目到本地
3. 配置 AGC（AppGallery Connect）服务
    - 在 AGC 控制台创建应用
    - 下载 `agconnect-services.json` 配置文件
    - 将配置文件放置到 `Application/entry/src/main/resources/rawfile/` 目录
4. 在 DevEco Studio 中打开项目
5. 同步依赖并编译运行

#### 使用说明

##### 主要功能

1. **用户管理**
    - 支持华为账号一键登录
    - 支持手机号验证码登录
    - 用户信息同步到 CloudDB

2. **作业管理**
    - 添加、查看、编辑作业
    - 作业状态管理（未完成、已完成、难题）
    - 作业分类和筛选

3. **学习计划**
    - 创建学习计划
    - 学习打卡记录
    - 学习计时器（番茄钟）

4. **测验功能**
    - 从错题本生成测验
    - 从知识点生成测验
    - 测验结果记录

5. **学习统计**
    - 学习时长统计
    - 作业完成率
    - 成长档案记录

##### 开发规范

1. **文件命名**
    - 服务文件：大驼峰命名（如 `AccountService.ets`）
    - Repository 文件：小驼峰命名（如 `userRepository.ets`）
    - Model 文件：大驼峰命名（如 `UserModel.ets`）
    - Page 文件：大驼峰命名（如 `Login.ets`）

2. **导入路径**
    - Model: `from '../data/models/UserModel'`
    - Repository: `from '../data/repository/userRepository'`
    - Service: `from '../services/cloud/AccountService'`
    - Common: `from '../common/constants/Routes'`
    - Utils: `from '../common/utils/date'`

3. **代码规范**
    - 遵循 ArkTS 语言规范
    - 使用 TypeScript 类型注解
    - 组件使用 `@Component` 装饰器
    - ViewModel 使用 `@Observed` 装饰器