# ps5

**Repository Path**: siegjan6/ps5

## Basic Information

- **Project Name**: ps5
- **Description**: test
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-04-01
- **Last Updated**: 2025-04-06

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Todo应用 - 基于Vue 3和Flask的待办事项管理系统

一个全栈待办事项应用，前端使用Vue 3 + Vant，后端使用Python Flask + SQLite。

## 项目结构

```
todo-app/
├── frontend/          # Vue 3 + Vant前端
└── backend/           # Python Flask后端
```

## Docker一键部署指南

### 前提条件

- 安装了Docker和Docker Compose的Ubuntu服务器
- 开放了80端口（用于HTTP访问）

### 部署步骤

1. 将代码克隆或上传到服务器

```bash
git clone https://gitee.com/siegjan6/ps5.git todoapp
cd todoapp
```

2. 运行部署脚本

```bash
chmod +x deploy.sh
./deploy.sh
```

这个脚本会：
- 检查并安装Docker和Docker Compose（如果需要）
- 生成一个随机的密钥
- 构建并启动Docker容器

3. 访问应用

部署完成后，您可以通过服务器的IP地址或域名访问应用：

```
http://your-server-ip
```

## 手动部署

如果您想手动部署，可以按照以下步骤操作：

1. 确保安装了Docker和Docker Compose
2. 修改`docker-compose.yml`文件中的`SECRET_KEY`
3. 运行以下命令：

```bash
docker-compose up -d --build
```

## 维护

- 查看日志：`docker-compose logs`
- 重启服务：`docker-compose restart`
- 停止服务：`docker-compose down`
- 更新应用：
  ```bash
  git pull
  docker-compose up -d --build
  ```

## 数据持久化

应用的数据库文件`todos.db`已配置为持久化存储，它被挂载为Docker卷，因此即使容器重启，数据也不会丢失。

## 自定义配置

您可以通过修改`docker-compose.yml`文件中的环境变量来自定义应用配置：

- `SECRET_KEY`：用于会话加密的密钥
- `CORS_ORIGIN`：允许的前端源（默认为http://localhost:5173）

## 故障排除

如果遇到问题，请检查Docker容器的日志：

```bash
docker-compose logs backend
docker-compose logs frontend
```

## 原始开发环境

### 前端

#### 技术栈
- Vue 3 (Composition API)
- Vant 4.x UI组件库
- Vite构建工具
- Axios用于API请求
- 移动优先设计

#### 运行前端

```bash
cd frontend
npm install
npm run dev
```

前端将在 http://localhost:5173 上可用

### 后端

#### 技术栈
- Python
- Flask Web框架
- SQLite数据库

#### 运行后端

```bash
cd backend
python -m venv .venv
source .venv/bin/activate  # 在Windows上: .venv\Scripts\activate
pip install -r requirements.txt
python run.py
```

后端API将在 http://localhost:8080 上可用

## Gitee特性

1. 使用 Readme\_XXX.md 来支持不同的语言，例如 Readme\_en.md, Readme\_zh.md
2. Gitee 官方博客 [blog.gitee.com](https://blog.gitee.com)
3. 你可以 [https://gitee.com/explore](https://gitee.com/explore) 这个地址来了解 Gitee 上的优秀开源项目
4. [GVP](https://gitee.com/gvp) 全称是 Gitee 最有价值开源项目，是综合评定出的优秀开源项目
5. Gitee 官方提供的使用手册 [https://gitee.com/help](https://gitee.com/help)
6. Gitee 封面人物是一档用来展示 Gitee 会员风采的栏目 [https://gitee.com/gitee-stars/](https://gitee.com/gitee-stars/)