快速开始

欢迎使用学习追踪系统！本指南将帮助你快速上手。

🎯 系统概述

学习追踪系统是一个现代化的学习项目追踪与管理平台，帮助用户：

• 📚 创建和管理学习项目
• ⏱️ 记录学习时间和进度
• 📊 分析学习数据和趋势
• 🏆 解锁成就和获得积分
• 💰 兑换虚拟商品

🚀 快速体验

在线体验

访问我们的在线演示：

• 主系统: https://yourdomain.com
• 文档系统: https://docs.yourdomain.com

本地开发

如果你想在本地运行系统：

# 克隆项目
git clone https://github.com/your-username/study-tracker.git

# 进入项目目录
cd study-tracker

# 安装依赖
npm install

# 配置环境
cp env.example .env

# 启动开发服务器
npm run dev

访问 http://your-server-ip:3001 开始体验！

📋 系统要求

开发环境

• Node.js: 18.x 或更高版本
• npm: 8.x 或更高版本
• PostgreSQL: 12.x 或更高版本
• Redis: 6.x 或更高版本

生产环境

• Docker: 20.10.x 或更高版本
• Docker Compose: 1.25.x 或更高版本
• 内存: 至少 2GB RAM
• 存储: 至少 10GB 可用空间

🔧 环境配置

1. 数据库配置

创建 PostgreSQL 数据库：

CREATE DATABASE study_tracker;
CREATE USER study_tracker WITH PASSWORD 'your_password';
GRANT ALL PRIVILEGES ON DATABASE study_tracker TO study_tracker;

2. Redis 配置

确保 Redis 服务正在运行：

# Ubuntu/Debian
sudo systemctl start redis-server

# CentOS/RHEL
sudo systemctl start redis

3. 环境变量

复制并配置环境变量文件：

cp env.example .env

主要配置项：

# 数据库配置
DB_HOST=your-server-ip
DB_PORT=5432
DB_NAME=study_tracker
DB_USER=study_tracker
DB_PASSWORD=your_password

# Redis 配置
REDIS_HOST=your-server-ip
REDIS_PORT=6379
REDIS_PASSWORD=your_redis_password

# JWT 配置
JWT_SECRET=your_jwt_secret
JWT_REFRESH_SECRET=your_refresh_secret

# 服务器配置
PORT=3001
NODE_ENV=development

🎮 功能体验

1. 用户注册和登录

1. 访问系统首页
2. 点击"注册"按钮
3. 填写用户信息并注册
4. 使用注册的账号登录

2. 创建学习项目

1. 登录后进入"项目管理"
2. 点击"新建项目"
3. 填写项目信息：
   • 项目名称
   • 项目描述
   • 学习目标
   • 预计完成时间

3. 记录学习时间

1. 选择要学习的项目
2. 点击"开始学习"
3. 系统自动记录开始时间
4. 学习完成后点击"结束学习"
5. 填写学习内容和心得

4. 查看学习统计

1. 进入"数据分析"页面
2. 查看学习时间统计
3. 分析学习趋势
4. 查看项目进度

5. 成就系统

1. 完成学习任务获得积分
2. 解锁各种成就徽章
3. 在"成就"页面查看已获得的成就

📚 下一步

• 安装配置 - 详细的安装和配置指南
• 功能指南 - 深入了解各个功能模块
• API 文档 - 开发者 API 参考
• 部署指南 - 生产环境部署指南

🤝 获取帮助

如果在使用过程中遇到问题：

1. 查看 常见问题
2. 提交 Issue
3. 加入 讨论区

---

开始你的学习之旅吧！ 🎓