# 前端简易部署项目

一个基于 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
```

### 生产部署 🚀

#### 部署

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

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

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

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

#### 常用命令

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

## 项目结构

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

## 功能特性

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