# lab4

**Repository Path**: larryivanhan/lab4

## Basic Information

- **Project Name**: lab4
- **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-06-18
- **Last Updated**: 2026-06-18

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Study Plan Workbench / 学习计划工作台

## 产品定位

一个面向自学者的 local-first 学习计划管理工具。用户可以同时推进多个学习目标，把"想学什么"转化为"每天具体要做什么"，并在统一日历中查看所有学习安排。

## 核心功能

- **创建学习计划**：填写主题、开始日期、天数、每日时长，系统自动生成结构化每日任务
- **统一日历**：所有计划的任务聚合在同一个月历中展示，同一天多计划任务合并显示
- **每日详情**：以日期为中心（`/day/YYYY-MM-DD`），展示当天所有计划的任务，支持勾选完成
- **完成状态持久化**：任务完成状态保存在 localStorage，刷新后仍然保留
- **历史计划管理**：查看、删除历史计划，删除后日历和进度同步更新
- **进度概览**：计划数、总天数、总时长、任务完成率
- **Markdown 导出**：单个计划导出为 Markdown 文件

## 技术栈

- React 19 + TypeScript + Vite
- Tailwind CSS v4
- react-router-dom v7
- date-fns（日期处理）
- uuid（唯一 ID 生成）
- Vitest + Testing Library（测试）
- localStorage（MVP 持久化层）

## 运行方式

```bash
# 安装依赖
npm install

# 启动开发服务器
npm run dev

# 构建生产版本
npm run build

# 运行测试
npm run test

# 代码检查
npm run lint
```

## 项目结构

```
src/
  components/     # 可复用 UI 组件
  pages/          # 页面组件
  types/          # TypeScript 类型定义
  utils/          # 工具函数（存储、日期、聚合、生成器）
  hooks/          # 自定义 React Hooks
  tests/          # 测试文件
  data/           # 数据模板和静态数据
```

## 数据安全

本项目默认 **不接外部大模型 API**，所有数据存储在浏览器 localStorage 中。

如需接入 AI 能力，请参考 `.env.example` 配置环境变量，切勿将 API Key 硬编码在前端代码中。