|
|
|
|
@ -1,21 +1,25 @@
|
|
|
|
|
# StudyingSpace - 个人学习空间
|
|
|
|
|
|
|
|
|
|
## 📖 项目简介
|
|
|
|
|
|
|
|
|
|
个人学习空间,帮助学习者记录学习过程、管理学习笔记,打造个性化的学习环境。
|
|
|
|
|
|
|
|
|
|
## ✨ 功能特性
|
|
|
|
|
|
|
|
|
|
### 🔐 用户系统
|
|
|
|
|
|
|
|
|
|
- [ ] 用户注册:创建个人账号
|
|
|
|
|
- [ ] 用户登录:安全登录个人空间
|
|
|
|
|
|
|
|
|
|
### 📅 每日打卡
|
|
|
|
|
|
|
|
|
|
- [ ] 每日学习打卡记录
|
|
|
|
|
- [ ] 打卡日历展示
|
|
|
|
|
- [ ] 连续打卡统计
|
|
|
|
|
- [ ] 学习时长记录
|
|
|
|
|
|
|
|
|
|
### 📝 笔记管理
|
|
|
|
|
|
|
|
|
|
- [ ] 笔记导入:支持从多种格式导入笔记
|
|
|
|
|
- [ ] 笔记导出:将笔记导出为常见格式
|
|
|
|
|
- [ ] 笔记分类与整理
|
|
|
|
|
@ -23,15 +27,18 @@
|
|
|
|
|
## 🛠️ 技术栈
|
|
|
|
|
|
|
|
|
|
### 前端
|
|
|
|
|
|
|
|
|
|
- **框架**: Vue 3
|
|
|
|
|
- **构建工具**: Vite
|
|
|
|
|
|
|
|
|
|
### 后端
|
|
|
|
|
|
|
|
|
|
- **框架**: Spring Boot
|
|
|
|
|
- **语言**: Java
|
|
|
|
|
- **数据库**: PostgreSQL
|
|
|
|
|
|
|
|
|
|
## 📁 项目结构
|
|
|
|
|
|
|
|
|
|
项目采用前后端分离架构,代码分别存放于两个目录:
|
|
|
|
|
|
|
|
|
|
```
|
|
|
|
|
@ -43,13 +50,13 @@ StudyingSpace/
|
|
|
|
|
## 🚀 快速开始
|
|
|
|
|
|
|
|
|
|
### 环境要求
|
|
|
|
|
|
|
|
|
|
- Node.js (前端)
|
|
|
|
|
- JDK 21+ (后端)
|
|
|
|
|
- PostgreSQL
|
|
|
|
|
|
|
|
|
|
### 安装步骤
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
### 运行项目
|
|
|
|
|
|
|
|
|
|
## 🐳 Docker 快速部署
|
|
|
|
|
@ -57,20 +64,23 @@ StudyingSpace/
|
|
|
|
|
你可以直接使用 Docker 一键部署整个应用,无需本地配置 Java/Node.js/PostgreSQL。
|
|
|
|
|
|
|
|
|
|
### 前置要求
|
|
|
|
|
|
|
|
|
|
- 安装 [Docker Desktop](https://www.docker.com/products/docker-desktop/)
|
|
|
|
|
- Docker Desktop 已启动
|
|
|
|
|
|
|
|
|
|
### 部署步骤
|
|
|
|
|
|
|
|
|
|
1. 克隆项目到本地:
|
|
|
|
|
|
|
|
|
|
```bash
|
|
|
|
|
git clone https://github.com/hetianci/StudyingSpace.git
|
|
|
|
|
cd StudyingSpace
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
2. 直接运行:
|
|
|
|
|
1. 直接运行:
|
|
|
|
|
|
|
|
|
|
```bash
|
|
|
|
|
docker-compose up -d
|
|
|
|
|
docker compose up -d
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
项目中已经包含 `docker-compose.yml`,会自动从 Docker Hub 拉取镜像并启动。
|
|
|
|
|
@ -79,33 +89,33 @@ docker-compose up -d
|
|
|
|
|
|
|
|
|
|
启动成功后,打开浏览器访问:
|
|
|
|
|
|
|
|
|
|
- 后端 API: http://localhost:8080
|
|
|
|
|
- Swagger API 文档: http://localhost:8080/swagger-ui.html
|
|
|
|
|
- 后端 API: <http://localhost:8080>
|
|
|
|
|
- Swagger API 文档: <http://localhost:8080/swagger-ui.html>
|
|
|
|
|
|
|
|
|
|
### 常用命令
|
|
|
|
|
|
|
|
|
|
```bash
|
|
|
|
|
# 查看运行状态
|
|
|
|
|
docker-compose ps
|
|
|
|
|
docker compose ps
|
|
|
|
|
|
|
|
|
|
# 查看后端日志
|
|
|
|
|
docker-compose logs backend
|
|
|
|
|
docker compose logs backend
|
|
|
|
|
|
|
|
|
|
# 实时查看日志
|
|
|
|
|
docker-compose logs -f backend
|
|
|
|
|
docker compose logs -f backend
|
|
|
|
|
|
|
|
|
|
# 停止所有容器
|
|
|
|
|
docker-compose down
|
|
|
|
|
docker compose down
|
|
|
|
|
|
|
|
|
|
# 停止但保留数据
|
|
|
|
|
docker-compose stop
|
|
|
|
|
docker compose stop
|
|
|
|
|
|
|
|
|
|
# 重新启动
|
|
|
|
|
docker-compose start
|
|
|
|
|
docker compose start
|
|
|
|
|
|
|
|
|
|
# 更新到最新镜像
|
|
|
|
|
docker-compose pull
|
|
|
|
|
docker-compose up -d
|
|
|
|
|
docker compose pull
|
|
|
|
|
docker compose up -d
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
### 注意事项
|
|
|
|
|
@ -114,12 +124,12 @@ docker-compose up -d
|
|
|
|
|
- 数据库数据会保存在 Docker 卷 `postgres-data` 中,即使删除容器数据也不会丢失
|
|
|
|
|
- 首次启动会自动拉取镜像,需要等待一段时间
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
## 📖 使用文档
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
### 用户注册登录
|
|
|
|
|
|
|
|
|
|
### 每日打卡使用
|
|
|
|
|
|
|
|
|
|
### 笔记导入导出
|
|
|
|
|
|
|
|
|
|
## 📈 开发计划
|
|
|
|
|
@ -131,5 +141,4 @@ docker-compose up -d
|
|
|
|
|
|
|
|
|
|
## 🤝 贡献指南
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
## 📄 许可证
|
|
|
|
|
|