# 前端简易部署项目

一个基于 Koa3 和 Vue3 的前端网页部署平台，支持上传单个 HTML 文件或完整项目文件夹，提供沙盒预览、文档管理、用户权限控制等功能。

## 技术栈

- 后端：Koa3 + TypeScript
- 前端：Vue3 + TypeScript + Vite
- 数据库：SQLite + Knex.js
- 包管理：pnpm

## 快速开始

### 开发环境

```bash
# 1. 安装依赖
pnpm install:all

# 2. 启动开发服务器
pnpm dev

# 或分别启动
pnpm dev:backend  # 后端：http://localhost:3000
pnpm dev:frontend # 前端：http://localhost:5173
```

### 生产部署 🚀

#### 一键部署（推荐）

**Windows:**
```powershell
.\deploy.ps1
```

**Linux/macOS:**
```bash
chmod +x deploy.sh
./deploy.sh
```

部署脚本会自动完成：
- ✅ 检查并安装必要工具（Node.js、pnpm、PM2）
- ✅ 安装项目依赖
- ✅ 构建前后端项目
- ✅ 创建生产环境配置
- ✅ 运行数据库迁移
- ✅ 使用 PM2 启动服务
- ✅ 配置开机自启动

部署成功后访问：
- 前端：http://localhost:5500
- 后端：http://localhost:3000

#### 手动部署

```bash
# 1. 构建项目
pnpm build

# 2. 创建环境配置
cp backend/.env.example backend/.env
# 编辑 backend/.env 修改配置

# 3. 运行数据库迁移
cd backend && pnpm migrate:prod && cd ..

# 4. 启动服务
pnpm start
```

#### 常用命令

```bash
pm2 status          # 查看服务状态
pm2 logs            # 查看日志
pm2 restart all     # 重启服务
pm2 stop all        # 停止服务
```

📖 详细部署说明请查看 [DEPLOY.md](./DEPLOY.md)

## 项目结构

```
just-demo/
├── backend/          # 后端服务
├── frontend/         # 前端应用
├── database/         # 数据库文件
└── package.json      # 根配置
```

## 功能特性

- 用户认证（注册、登录）
- 网页上传（单个HTML或ZIP文件夹）
- 项目展示和筛选
- 沙盒预览
- 文档管理
- 权限控制