Enhance deployment process and project structure. Added deployment scripts for Windows and Linux, a comprehensive deployment guide, and Docker support. Updated .gitignore to include additional files and directories. Introduced PM2 configuration for process management and health checks for backend and frontend ser

2 weeks ago · 0f154e78bf
17 changed files with 1400 additions and 15 deletions
--- a/.gitignore
+++ b/.gitignore
@ -1,12 +1,45 @@
+# 依赖
 node_modules/
+pnpm-lock.yaml
+
+# 构建产物
 dist/
-*.log
+build/
+
+# 环境变量
 .env
-.DS_Store
-database/*.sqlite3
-uploads/
+.env.local
+.env.production
+.env.development
+
+# 日志
+logs/
+*.log
+npm-debug.log*
+pnpm-debug.log*
+
+# 数据库
+*.sqlite3
+*.sqlite
+*.db
+
+# PM2
+.pm2/
+
+# IDE
 .vscode/
 .idea/
-backup/
-*.zip
+*.swp
+*.swo
+*~
+
+# 系统文件
+.DS_Store
+Thumbs.db
+
+# 上传文件
+uploads/

+# 临时文件
+tmp/
+temp/
--- a/DEPLOY.md
+++ b/DEPLOY.md
@ -0,0 +1,366 @@
+# 部署指南
+
+本项目提供多种部署方式，推荐使用 **PM2 一键部署**，简单快捷。
+
+## 🚀 方案一：PM2 一键部署（推荐）
+
+最简单的部署方式，适合 VPS、云服务器等场景。
+
+### Windows 部署
+
+```powershell
+# 1. 运行部署脚本
+.\deploy.ps1
+```
+
+### Linux/macOS 部署
+
+```bash
+# 1. 添加执行权限
+chmod +x deploy.sh
+
+# 2. 运行部署脚本
+./deploy.sh
+```
+
+### 部署脚本会自动完成：
+
+1. ✅ 检查并安装必要工具（Node.js、pnpm、PM2）
+2. ✅ 安装项目依赖
+3. ✅ 构建前后端项目
+4. ✅ 创建生产环境配置
+5. ✅ 运行数据库迁移
+6. ✅ 使用 PM2 启动服务
+7. ✅ 配置开机自启动
+
+### 常用命令
+
+```bash
+# 查看服务状态
+pm2 status
+
+# 查看日志
+pm2 logs
+
+# 查看指定服务日志
+pm2 logs just-demo-backend
+pm2 logs just-demo-frontend
+
+# 重启服务
+pm2 restart all
+pm2 restart just-demo-backend
+
+# 停止服务
+pm2 stop all
+
+# 删除服务
+pm2 delete all
+```
+
+### 访问地址
+
+部署成功后，可通过以下地址访问：
+
+- 前端：http://localhost:5500
+- 后端：http://localhost:3000
+
+---
+
+## 🐳 方案二：Docker Compose 部署
+
+适合需要容器化部署的场景。
+
+### 1. 创建 Dockerfile
+
+**backend/Dockerfile:**
+
+```dockerfile
+FROM node:18-alpine
+
+WORKDIR /app
+
+# 安装 pnpm
+RUN npm install -g pnpm
+
+# 复制依赖文件
+COPY package.json pnpm-lock.yaml ./
+
+# 安装依赖
+RUN pnpm install --prod
+
+# 复制构建产物
+COPY dist ./dist
+COPY database ./database
+COPY knexfile.js ./
+
+# 创建上传目录
+RUN mkdir -p uploads
+
+EXPOSE 3000
+
+CMD ["node", "dist/app.js"]
+```
+
+**frontend/Dockerfile:**
+
+```dockerfile
+FROM node:18-alpine
+
+WORKDIR /app
+
+# 安装 serve
+RUN npm install -g serve
+
+# 复制构建产物
+COPY dist ./dist
+
+EXPOSE 5500
+
+CMD ["serve", "dist", "-p", "5500", "-s"]
+```
+
+### 2. 创建 docker-compose.yml
+
+```yaml
+version: '3.8'
+
+services:
+  backend:
+    build:
+      context: ./backend
+      dockerfile: Dockerfile
+    ports:
+      - "3000:3000"
+    environment:
+      - NODE_ENV=production
+      - PORT=3000
+      - JWT_SECRET=${JWT_SECRET}
+      - FRONTEND_URL=http://localhost:5500
+    volumes:
+      - ./backend/database:/app/database
+      - ./backend/uploads:/app/uploads
+    restart: always
+
+  frontend:
+    build:
+      context: ./frontend
+      dockerfile: Dockerfile
+    ports:
+      - "5500:5500"
+    depends_on:
+      - backend
+    restart: always
+```
+
+### 3. 部署
+
+```bash
+# 构建项目
+pnpm build
+
+# 启动容器
+docker-compose up -d
+
+# 查看日志
+docker-compose logs -f
+
+# 停止容器
+docker-compose down
+```
+
+---
+
+## ☁️ 方案三：云平台部署
+
+### 3.1 Vercel + Railway
+
+**前端部署到 Vercel：**
+
+1. 在 Vercel 导入项目
+2. 设置构建配置：
+   - Build Command: `cd frontend && pnpm install && pnpm build`
+   - Output Directory: `frontend/dist`
+
+**后端部署到 Railway：**
+
+1. 在 Railway 创建新项目
+2. 连接 GitHub 仓库
+3. 设置环境变量：
+   ```
+   NODE_ENV=production
+   PORT=3000
+   JWT_SECRET=your-secret-key
+   FRONTEND_URL=your-vercel-url
+   ```
+
+### 3.2 Render
+
+1. 在 Render 创建 Web Service
+2. 后端配置：
+   - Build Command: `cd backend && pnpm install && pnpm build`
+   - Start Command: `cd backend && node dist/app.js`
+3. 前端配置：
+   - Build Command: `cd frontend && pnpm install && pnpm build`
+   - Publish Directory: `frontend/dist`
+
+---
+
+## 📝 生产环境配置
+
+### 必要的环境变量
+
+在 `backend/.env` 文件中配置：
+
+```env
+NODE_ENV=production
+PORT=3000
+JWT_SECRET=你的超级密钥-至少32字符
+FRONTEND_URL=http://your-frontend-domain.com
+UPLOAD_DIR=uploads
+```
+
+### 生成安全的 JWT_SECRET
+
+```bash
+# Linux/macOS
+openssl rand -base64 32
+
+# Windows PowerShell
+[Convert]::ToBase64String((1..32 | ForEach-Object { Get-Random -Maximum 256 }))
+```
+
+---
+
+## 🔒 安全建议
+
+1. **修改 JWT_SECRET**：不要使用默认密钥
+2. **配置 HTTPS**：使用 nginx + Let's Encrypt
+3. **限制文件上传大小**：防止恶意上传
+4. **定期备份数据库**：备份 `backend/database/*.sqlite3`
+5. **配置防火墙**：只开放必要端口
+
+---
+
+## 🌐 使用 Nginx 反向代理（可选）
+
+### 安装 Nginx
+
+```bash
+# Ubuntu/Debian
+sudo apt update
+sudo apt install nginx
+
+# CentOS/RHEL
+sudo yum install nginx
+```
+
+### 配置文件
+
+创建 `/etc/nginx/sites-available/just-demo`:
+
+```nginx
+server {
+    listen 80;
+    server_name your-domain.com;
+
+    # 前端
+    location / {
+        proxy_pass http://localhost:5500;
+        proxy_http_version 1.1;
+        proxy_set_header Upgrade $http_upgrade;
+        proxy_set_header Connection 'upgrade';
+        proxy_set_header Host $host;
+        proxy_cache_bypass $http_upgrade;
+    }
+
+    # 后端 API
+    location /api {
+        proxy_pass http://localhost:3000;
+        proxy_http_version 1.1;
+        proxy_set_header Upgrade $http_upgrade;
+        proxy_set_header Connection 'upgrade';
+        proxy_set_header Host $host;
+        proxy_set_header X-Real-IP $remote_addr;
+        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
+        proxy_set_header X-Forwarded-Proto $scheme;
+        proxy_cache_bypass $http_upgrade;
+    }
+}
+```
+
+### 启用配置
+
+```bash
+sudo ln -s /etc/nginx/sites-available/just-demo /etc/nginx/sites-enabled/
+sudo nginx -t
+sudo systemctl reload nginx
+```
+
+---
+
+## 🔧 故障排查
+
+### 服务无法启动
+
+```bash
+# 查看详细日志
+pm2 logs --lines 100
+
+# 检查端口占用
+# Linux/macOS
+lsof -i :3000
+
+# Windows
+netstat -ano | findstr :3000
+```
+
+### 数据库错误
+
+```bash
+# 重新运行迁移
+cd backend
+pnpm migrate:rollback:prod
+pnpm migrate:prod
+```
+
+### 前端无法访问后端
+
+检查 `backend/.env` 中的 `FRONTEND_URL` 配置是否正确。
+
+---
+
+## 📊 性能优化
+
+1. **启用 PM2 集群模式**：充分利用多核 CPU
+2. **配置 Nginx 缓存**：加快静态资源访问
+3. **使用 CDN**：加速前端资源加载
+4. **定期清理日志**：防止日志文件过大
+
+---
+
+## 🔄 更新部署
+
+```bash
+# 1. 拉取最新代码
+git pull
+
+# 2. 重新构建
+pnpm build
+
+# 3. 重启服务
+pm2 restart all
+
+# 或使用部署脚本
+./deploy.sh
+```
+
+---
+
+## 📞 技术支持
+
+如遇问题，请检查：
+1. Node.js 版本是否 >= 16
+2. 端口 3000 和 5500 是否被占用
+3. 数据库文件是否有读写权限
+4. 环境变量是否配置正确
+
--- a/DEPLOYMENT-GUIDE.md
+++ b/DEPLOYMENT-GUIDE.md
@ -0,0 +1,264 @@
+# 部署方案快速对比
+
+选择最适合你的部署方式 🚀
+
+## 📊 方案对比
+
+| 方案 | 难度 | 适用场景 | 优点 | 缺点 |
+|------|------|---------|------|------|
+| **PM2 一键部署** ⭐推荐 | ⭐ 简单 | VPS、云服务器 | 最简单、一键部署、进程管理 | 需要服务器 |
+| **Docker Compose** | ⭐⭐ 中等 | 容器化需求 | 环境隔离、易迁移 | 需要学习 Docker |
+| **云平台部署** | ⭐ 简单 | 快速上线 | 免费额度、自动扩展 | 可能有费用 |
+| **传统部署** | ⭐⭐⭐ 复杂 | 完全自定义 | 完全控制 | 配置复杂 |
+
+---
+
+## 🎯 方案一：PM2 一键部署（最简单）
+
+### 适用场景
+- ✅ 你有一台 VPS 或云服务器
+- ✅ 想要最快速的部署方式
+- ✅ 需要进程管理和自动重启
+- ✅ 想要开机自启动
+
+### 部署步骤
+
+#### Windows
+```powershell
+# 一行命令搞定
+.\deploy.ps1
+```
+
+#### Linux/macOS
+```bash
+# 一行命令搞定
+chmod +x deploy.sh && ./deploy.sh
+```
+
+### 特点
+- ⚡ **部署时间**: 3-5 分钟
+- 🎯 **一键完成**: 自动安装、构建、启动
+- 🔄 **自动重启**: 崩溃自动恢复
+- 📊 **进程监控**: PM2 提供完整的监控
+- 🚀 **开机自启**: 服务器重启自动启动
+
+### 访问地址
+- 前端：`http://你的服务器IP:5500`
+- 后端：`http://你的服务器IP:3000`
+
+---
+
+## 🐳 方案二：Docker 部署
+
+### 适用场景
+- ✅ 需要环境隔离
+- ✅ 多个项目部署
+- ✅ 需要容器编排
+- ✅ 跨平台部署
+
+### 部署步骤
+
+```bash
+# 一键 Docker 部署
+chmod +x docker-deploy.sh && ./docker-deploy.sh
+
+# 或手动部署
+docker-compose up -d
+```
+
+### 特点
+- ⚡ **部署时间**: 5-10 分钟（首次构建）
+- 📦 **环境隔离**: 不污染宿主机环境
+- 🔧 **易迁移**: 可在任何支持 Docker 的环境运行
+- 🔄 **自动重启**: 容器崩溃自动恢复
+
+---
+
+## ☁️ 方案三：云平台部署
+
+### 3.1 Vercel（前端）+ Railway（后端）
+
+#### 前端部署到 Vercel
+1. Fork/导入项目到 GitHub
+2. 在 Vercel 导入仓库
+3. 配置构建：
+   ```
+   Root Directory: frontend
+   Build Command: pnpm install && pnpm build
+   Output Directory: dist
+   ```
+
+#### 后端部署到 Railway
+1. 在 Railway 创建新项目
+2. 连接 GitHub 仓库
+3. 设置环境变量（自动生成）
+4. 自动部署
+
+### 特点
+- ⚡ **部署时间**: 5-10 分钟
+- 💰 **免费额度**: 都有免费版本
+- 🌍 **全球 CDN**: 访问速度快
+- 🔄 **自动部署**: Git push 自动部署
+
+---
+
+### 3.2 Render（All-in-One）
+
+#### 一站式部署
+1. 注册 Render 账号
+2. 连接 GitHub 仓库
+3. 创建两个 Web Services：
+   - **Backend**: 
+     - Build: `cd backend && pnpm install && pnpm build`
+     - Start: `cd backend && node dist/app.js`
+   - **Frontend**:
+     - Build: `cd frontend && pnpm install && pnpm build`
+     - Static Site
+     - Publish: `frontend/dist`
+
+### 特点
+- ⚡ **部署时间**: 10-15 分钟
+- 💰 **免费计划**: 每月有免费额度
+- 🔄 **自动部署**: Git push 触发
+- 🔒 **免费 SSL**: 自动配置 HTTPS
+
+---
+
+## 🎮 方案四：手动部署
+
+### 适用场景
+- ✅ 需要完全自定义配置
+- ✅ 学习部署流程
+- ✅ 特殊环境要求
+
+### 部署步骤
+
+```bash
+# 1. 克隆项目
+git clone <your-repo>
+cd just-demo
+
+# 2. 安装依赖
+pnpm install:all
+
+# 3. 构建
+pnpm build
+
+# 4. 配置环境变量
+cp backend/.env.example backend/.env
+# 编辑 backend/.env
+
+# 5. 数据库迁移
+cd backend && pnpm migrate:prod && cd ..
+
+# 6. 启动后端
+cd backend && node dist/app.js &
+
+# 7. 启动前端
+cd frontend && npx serve dist -p 5500 &
+```
+
+---
+
+## 🔧 配置 Nginx 反向代理（可选）
+
+如果你使用 PM2 或手动部署，可以配置 Nginx：
+
+```bash
+# 1. 安装 Nginx
+sudo apt install nginx  # Ubuntu/Debian
+
+# 2. 配置
+sudo cp nginx.conf /etc/nginx/sites-available/just-demo
+sudo ln -s /etc/nginx/sites-available/just-demo /etc/nginx/sites-enabled/
+
+# 3. 修改域名
+sudo nano /etc/nginx/sites-available/just-demo
+# 将 your-domain.com 改为你的域名
+
+# 4. 重启 Nginx
+sudo nginx -t
+sudo systemctl reload nginx
+```
+
+---
+
+## 📱 快速决策指南
+
+### 我该选哪个方案？
+
+#### 🏃 我想最快部署
+→ **选择 PM2 一键部署**
+```bash
+# Windows
+.\deploy.ps1
+
+# Linux/macOS
+./deploy.sh
+```
+
+#### 💰 我没有服务器/想省钱
+→ **选择云平台部署**
+- Vercel（前端免费）
+- Railway（后端有免费额度）
+- Render（全栈免费）
+
+#### 🐳 我想要容器化
+→ **选择 Docker 部署**
+```bash
+./docker-deploy.sh
+```
+
+#### 🎓 我想学习部署流程
+→ **选择手动部署**
+- 完整了解每个步骤
+- 便于排查问题
+
+---
+
+## 🆘 遇到问题？
+
+### PM2 方案
+```bash
+pm2 logs              # 查看日志
+pm2 status            # 查看状态
+pm2 restart all       # 重启服务
+```
+
+### Docker 方案
+```bash
+docker-compose logs -f        # 查看日志
+docker-compose ps             # 查看状态
+docker-compose restart        # 重启服务
+```
+
+### 云平台
+- 查看部署日志
+- 检查环境变量
+- 查看服务状态
+
+---
+
+## 📚 详细文档
+
+- [完整部署指南](./DEPLOY.md)
+- [项目说明](./README.md)
+
+---
+
+## 🎉 开始部署
+
+选择一个方案，立即开始：
+
+```bash
+# PM2（推荐）
+./deploy.sh          # Linux/macOS
+.\deploy.ps1         # Windows
+
+# Docker
+./docker-deploy.sh
+
+# 查看详细文档
+cat DEPLOY.md
+```
+
--- a/README.md
+++ b/README.md
@ -11,16 +11,13 @@

 ## 快速开始

-### 安装依赖
+### 开发环境

 ```bash
+# 1. 安装依赖
 pnpm install:all
-```
-
-### 开发

-```bash
-# 同时启动前后端
+# 2. 启动开发服务器
 pnpm dev

 # 或分别启动
@ -28,12 +25,62 @@ 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)
+
 ## 项目结构

 ```
--- a/backend/.dockerignore
+++ b/backend/.dockerignore
@ -0,0 +1,17 @@
+node_modules
+npm-debug.log
+pnpm-debug.log
+dist
+build
+.git
+.gitignore
+*.md
+.env
+.env.local
+.vscode
+.idea
+*.log
+uploads
+database/*.sqlite3
+database/*.db
+
--- a/backend/Dockerfile
+++ b/backend/Dockerfile
@ -0,0 +1,51 @@
+FROM node:18-alpine AS builder
+
+WORKDIR /app
+
+# 安装 pnpm
+RUN npm install -g pnpm
+
+# 复制依赖文件
+COPY package.json pnpm-lock.yaml ./
+
+# 安装依赖
+RUN pnpm install --frozen-lockfile
+
+# 复制源代码
+COPY . .
+
+# 构建
+RUN pnpm build
+
+# 生产阶段
+FROM node:18-alpine
+
+WORKDIR /app
+
+# 安装必要工具
+RUN apk add --no-cache wget && \
+    npm install -g pnpm
+
+# 只安装生产依赖
+COPY package.json pnpm-lock.yaml ./
+RUN pnpm install --prod --frozen-lockfile
+
+# 复制构建产物和必要文件
+COPY --from=builder /app/dist ./dist
+COPY knexfile.js ./
+
+# 创建必要的目录
+RUN mkdir -p uploads database && \
+    chown -R node:node /app
+
+# 使用非 root 用户
+USER node
+
+EXPOSE 3000
+
+# 健康检查
+HEALTHCHECK --interval=30s --timeout=10s --start-period=40s --retries=3 \
+  CMD wget --quiet --tries=1 --spider http://localhost:3000/api/health || exit 1
+
+CMD ["node", "dist/app.js"]
+
--- a/deploy.ps1
+++ b/deploy.ps1
@ -0,0 +1,93 @@
+# 一键部署脚本 - Windows PowerShell
+# 使用方法: .\deploy.ps1
+
+$ErrorActionPreference = "Stop"
+
+Write-Host "🚀 开始部署 Just-Demo 项目..." -ForegroundColor Cyan
+
+# 1. 检查 Node.js
+Write-Host "`n📦 检查 Node.js..." -ForegroundColor Blue
+if (-not (Get-Command node -ErrorAction SilentlyContinue)) {
+    Write-Host "❌ Node.js 未安装，请先安装 Node.js (v16+)" -ForegroundColor Red
+    Write-Host "下载地址: https://nodejs.org/" -ForegroundColor Yellow
+    exit 1
+}
+Write-Host "✅ Node.js 版本: $(node -v)" -ForegroundColor Green
+
+# 2. 检查 pnpm，如果没有则安装
+Write-Host "`n📦 检查 pnpm..." -ForegroundColor Blue
+if (-not (Get-Command pnpm -ErrorAction SilentlyContinue)) {
+    Write-Host "pnpm 未安装，正在安装..." -ForegroundColor Yellow
+    npm install -g pnpm
+}
+Write-Host "✅ pnpm 版本: $(pnpm -v)" -ForegroundColor Green
+
+# 3. 检查 PM2，如果没有则安装
+Write-Host "`n📦 检查 PM2..." -ForegroundColor Blue
+if (-not (Get-Command pm2 -ErrorAction SilentlyContinue)) {
+    Write-Host "PM2 未安装，正在安装..." -ForegroundColor Yellow
+    npm install -g pm2
+    npm install -g pm2-windows-startup
+    pm2-startup install
+}
+Write-Host "✅ PM2 已安装" -ForegroundColor Green
+
+# 4. 安装依赖
+Write-Host "`n📦 安装项目依赖..." -ForegroundColor Blue
+pnpm install:all
+
+# 5. 构建项目
+Write-Host "`n🔨 构建项目..." -ForegroundColor Blue
+pnpm build
+
+# 6. 创建生产环境配置
+Write-Host "`n⚙️  创建生产环境配置..." -ForegroundColor Blue
+if (-not (Test-Path "backend\.env")) {
+    # 生成随机密钥
+    $bytes = New-Object byte[] 32
+    $rng = [System.Security.Cryptography.RandomNumberGenerator]::Create()
+    $rng.GetBytes($bytes)
+    $jwtSecret = [Convert]::ToBase64String($bytes)
+    
+    @"
+NODE_ENV=production
+PORT=3000
+JWT_SECRET=$jwtSecret
+FRONTEND_URL=http://localhost:5500
+UPLOAD_DIR=uploads
+"@ | Out-File -FilePath "backend\.env" -Encoding UTF8
+    Write-Host "✅ 已创建 backend\.env" -ForegroundColor Green
+} else {
+    Write-Host "✅ backend\.env 已存在" -ForegroundColor Green
+}
+
+# 7. 运行数据库迁移
+Write-Host "`n🗄️  运行数据库迁移..." -ForegroundColor Blue
+Set-Location backend
+pnpm migrate:prod
+Set-Location ..
+
+# 8. 使用 PM2 启动服务
+Write-Host "`n🚀 使用 PM2 启动服务..." -ForegroundColor Blue
+pm2 delete just-demo-backend 2>$null
+pm2 start ecosystem.config.js
+
+# 9. 保存 PM2 配置
+Write-Host "`n💾 保存 PM2 配置..." -ForegroundColor Blue
+pm2 save
+
+# 10. 显示服务状态
+Write-Host "`n📊 服务状态：" -ForegroundColor Cyan
+pm2 status
+
+Write-Host "`n🎉 部署成功！" -ForegroundColor Green
+Write-Host "`n访问地址：" -ForegroundColor Cyan
+Write-Host "  - 前端: http://localhost:5500" -ForegroundColor White
+Write-Host "  - 后端: http://localhost:3000" -ForegroundColor White
+Write-Host "`n常用命令：" -ForegroundColor Cyan
+Write-Host "  pm2 status          # 查看服务状态" -ForegroundColor White
+Write-Host "  pm2 logs            # 查看日志" -ForegroundColor White
+Write-Host "  pm2 restart all     # 重启所有服务" -ForegroundColor White
+Write-Host "  pm2 stop all        # 停止所有服务" -ForegroundColor White
+Write-Host ""
+
--- a/deploy.sh
+++ b/deploy.sh
@ -0,0 +1,99 @@
+#!/bin/bash
+
+# 一键部署脚本 - Linux/macOS
+# 使用方法: chmod +x deploy.sh && ./deploy.sh
+
+set -e  # 遇到错误立即退出
+
+echo "🚀 开始部署 Just-Demo 项目..."
+
+# 颜色定义
+GREEN='\033[0;32m'
+BLUE='\033[0;34m'
+RED='\033[0;31m'
+NC='\033[0m' # No Color
+
+# 1. 检查 Node.js
+echo -e "${BLUE}📦 检查 Node.js...${NC}"
+if ! command -v node &> /dev/null; then
+    echo -e "${RED}❌ Node.js 未安装，请先安装 Node.js (v16+)${NC}"
+    exit 1
+fi
+echo -e "${GREEN}✅ Node.js 版本: $(node -v)${NC}"
+
+# 2. 检查 pnpm，如果没有则安装
+echo -e "${BLUE}📦 检查 pnpm...${NC}"
+if ! command -v pnpm &> /dev/null; then
+    echo "pnpm 未安装，正在安装..."
+    npm install -g pnpm
+fi
+echo -e "${GREEN}✅ pnpm 版本: $(pnpm -v)${NC}"
+
+# 3. 检查 PM2，如果没有则安装
+echo -e "${BLUE}📦 检查 PM2...${NC}"
+if ! command -v pm2 &> /dev/null; then
+    echo "PM2 未安装，正在安装..."
+    npm install -g pm2
+fi
+echo -e "${GREEN}✅ PM2 已安装${NC}"
+
+# 4. 安装依赖
+echo -e "${BLUE}📦 安装项目依赖...${NC}"
+pnpm install:all
+
+# 5. 构建项目
+echo -e "${BLUE}🔨 构建项目...${NC}"
+pnpm build
+
+# 6. 创建生产环境配置
+echo -e "${BLUE}⚙️  创建生产环境配置...${NC}"
+if [ ! -f backend/.env ]; then
+    cat > backend/.env << EOF
+NODE_ENV=production
+PORT=3000
+JWT_SECRET=$(openssl rand -base64 32)
+FRONTEND_URL=http://localhost:5500
+UPLOAD_DIR=uploads
+EOF
+    echo -e "${GREEN}✅ 已创建 backend/.env${NC}"
+else
+    echo -e "${GREEN}✅ backend/.env 已存在${NC}"
+fi
+
+# 7. 运行数据库迁移
+echo -e "${BLUE}🗄️  运行数据库迁移...${NC}"
+cd backend
+pnpm migrate:prod
+cd ..
+
+# 8. 使用 PM2 启动服务
+echo -e "${BLUE}🚀 使用 PM2 启动服务...${NC}"
+pm2 delete just-demo-backend 2>/dev/null || true
+pm2 start ecosystem.config.js
+
+# 9. 保存 PM2 配置（开机自启动）
+echo -e "${BLUE}💾 配置 PM2 开机自启动...${NC}"
+pm2 save
+pm2 startup
+
+# 10. 显示服务状态
+echo ""
+echo -e "${GREEN}✅ 部署完成！${NC}"
+echo ""
+echo "📊 服务状态："
+pm2 status
+
+echo ""
+echo -e "${GREEN}🎉 部署成功！${NC}"
+echo ""
+echo "访问地址："
+echo "  - 前端: http://localhost:5500"
+echo "  - 后端: http://localhost:3000"
+echo ""
+echo "常用命令："
+echo "  pm2 status          # 查看服务状态"
+echo "  pm2 logs            # 查看日志"
+echo "  pm2 restart all     # 重启所有服务"
+echo "  pm2 stop all        # 停止所有服务"
+echo ""
+
--- a/docker-compose.yml
+++ b/docker-compose.yml
@ -0,0 +1,48 @@
+version: '3.8'
+
+services:
+  backend:
+    build:
+      context: ./backend
+      dockerfile: Dockerfile
+    container_name: just-demo-backend
+    ports:
+      - "3000:3000"
+    environment:
+      - NODE_ENV=production
+      - PORT=3000
+      - JWT_SECRET=${JWT_SECRET:-your-secret-key-please-change}
+      - FRONTEND_URL=${FRONTEND_URL:-http://localhost:5500}
+      - UPLOAD_DIR=uploads
+    volumes:
+      - ./backend/database:/app/database
+      - ./backend/uploads:/app/uploads
+    restart: unless-stopped
+    healthcheck:
+      test: ["CMD", "wget", "--quiet", "--tries=1", "--spider", "http://localhost:3000/api/health"]
+      interval: 30s
+      timeout: 10s
+      retries: 3
+      start_period: 40s
+
+  frontend:
+    build:
+      context: ./frontend
+      dockerfile: Dockerfile
+    container_name: just-demo-frontend
+    ports:
+      - "5500:5500"
+    depends_on:
+      - backend
+    restart: unless-stopped
+    healthcheck:
+      test: ["CMD", "wget", "--quiet", "--tries=1", "--spider", "http://localhost:5500"]
+      interval: 30s
+      timeout: 10s
+      retries: 3
+      start_period: 20s
+
+networks:
+  default:
+    name: just-demo-network
+
--- a/docker-deploy.sh
+++ b/docker-deploy.sh
@ -0,0 +1,75 @@
+#!/bin/bash
+
+# Docker 一键部署脚本
+# 使用方法: chmod +x docker-deploy.sh && ./docker-deploy.sh
+
+set -e
+
+echo "🐳 开始 Docker 部署..."
+
+# 颜色定义
+GREEN='\033[0;32m'
+BLUE='\033[0;34m'
+RED='\033[0;31m'
+NC='\033[0m'
+
+# 1. 检查 Docker
+echo -e "${BLUE}📦 检查 Docker...${NC}"
+if ! command -v docker &> /dev/null; then
+    echo -e "${RED}❌ Docker 未安装${NC}"
+    echo "请访问 https://docs.docker.com/get-docker/ 安装 Docker"
+    exit 1
+fi
+echo -e "${GREEN}✅ Docker 版本: $(docker --version)${NC}"
+
+# 2. 检查 Docker Compose
+echo -e "${BLUE}📦 检查 Docker Compose...${NC}"
+if ! command -v docker-compose &> /dev/null && ! docker compose version &> /dev/null; then
+    echo -e "${RED}❌ Docker Compose 未安装${NC}"
+    exit 1
+fi
+echo -e "${GREEN}✅ Docker Compose 已安装${NC}"
+
+# 3. 创建环境配置
+echo -e "${BLUE}⚙️  创建环境配置...${NC}"
+if [ ! -f .env ]; then
+    JWT_SECRET=$(openssl rand -base64 32)
+    cat > .env << EOF
+JWT_SECRET=$JWT_SECRET
+FRONTEND_URL=http://localhost:5500
+EOF
+    echo -e "${GREEN}✅ 已创建 .env${NC}"
+else
+    echo -e "${GREEN}✅ .env 已存在${NC}"
+fi
+
+# 4. 构建和启动容器
+echo -e "${BLUE}🔨 构建和启动容器...${NC}"
+docker-compose down
+docker-compose build --no-cache
+docker-compose up -d
+
+# 5. 等待服务启动
+echo -e "${BLUE}⏳ 等待服务启动...${NC}"
+sleep 5
+
+# 6. 显示容器状态
+echo -e "${GREEN}✅ 部署完成！${NC}"
+echo ""
+echo "📊 容器状态："
+docker-compose ps
+
+echo ""
+echo -e "${GREEN}🎉 部署成功！${NC}"
+echo ""
+echo "访问地址："
+echo "  - 前端: http://localhost:5500"
+echo "  - 后端: http://localhost:3000"
+echo ""
+echo "常用命令："
+echo "  docker-compose ps           # 查看容器状态"
+echo "  docker-compose logs -f      # 查看日志"
+echo "  docker-compose restart      # 重启服务"
+echo "  docker-compose down         # 停止服务"
+echo ""
+
--- a/docker-test.bat
+++ b/docker-test.bat
@ -0,0 +1,56 @@
+@echo off
+echo 🐳 开始 Docker 构建测试...
+echo.
+
+echo [1/4] 检查 Docker 环境...
+docker --version >nul 2>&1
+if errorlevel 1 (
+    echo ❌ Docker 未安装或未启动
+    pause
+    exit /b 1
+)
+echo ✅ Docker 已就绪
+echo.
+
+echo [2/4] 停止旧容器...
+docker-compose down
+echo.
+
+echo [3/4] 构建镜像（这可能需要几分钟）...
+docker-compose build --no-cache
+if errorlevel 1 (
+    echo ❌ 构建失败
+    pause
+    exit /b 1
+)
+echo ✅ 构建成功
+echo.
+
+echo [4/4] 启动容器...
+docker-compose up -d
+if errorlevel 1 (
+    echo ❌ 启动失败
+    pause
+    exit /b 1
+)
+echo.
+
+echo ⏳ 等待服务启动（10秒）...
+timeout /t 10 /nobreak >nul
+echo.
+
+echo 📊 容器状态：
+docker-compose ps
+echo.
+
+echo 🎉 部署完成！
+echo.
+echo 访问地址：
+echo   前端: http://localhost:5500
+echo   后端: http://localhost:3000
+echo.
+echo 查看日志: docker-compose logs -f
+echo 停止服务: docker-compose down
+echo.
+pause
+
--- a/docker-test.sh
+++ b/docker-test.sh
@ -0,0 +1,53 @@
+#!/bin/bash
+
+# Docker 构建测试脚本
+echo "🐳 开始 Docker 构建测试..."
+echo ""
+
+echo "[1/4] 检查 Docker 环境..."
+if ! command -v docker &> /dev/null; then
+    echo "❌ Docker 未安装或未启动"
+    exit 1
+fi
+echo "✅ Docker 已就绪"
+echo ""
+
+echo "[2/4] 停止旧容器..."
+docker-compose down
+echo ""
+
+echo "[3/4] 构建镜像（这可能需要几分钟）..."
+docker-compose build --no-cache
+if [ $? -ne 0 ]; then
+    echo "❌ 构建失败"
+    exit 1
+fi
+echo "✅ 构建成功"
+echo ""
+
+echo "[4/4] 启动容器..."
+docker-compose up -d
+if [ $? -ne 0 ]; then
+    echo "❌ 启动失败"
+    exit 1
+fi
+echo ""
+
+echo "⏳ 等待服务启动（10秒）..."
+sleep 10
+echo ""
+
+echo "📊 容器状态："
+docker-compose ps
+echo ""
+
+echo "🎉 部署完成！"
+echo ""
+echo "访问地址："
+echo "  前端: http://localhost:5500"
+echo "  后端: http://localhost:3000"
+echo ""
+echo "查看日志: docker-compose logs -f"
+echo "停止服务: docker-compose down"
+echo ""
+
--- a/ecosystem.config.js
+++ b/ecosystem.config.js
@ -0,0 +1,50 @@
+// PM2 配置文件
+module.exports = {
+  apps: [
+    {
+      name: 'just-demo-backend',
+      script: './backend/dist/app.js',
+      cwd: './',
+      instances: 1,
+      autorestart: true,
+      watch: false,
+      max_memory_restart: '500M',
+      env: {
+        NODE_ENV: 'production',
+        PORT: 3000
+      },
+      env_production: {
+        NODE_ENV: 'production',
+        PORT: 3000
+      },
+      error_file: './logs/backend-error.log',
+      out_file: './logs/backend-out.log',
+      log_date_format: 'YYYY-MM-DD HH:mm:ss Z',
+      merge_logs: true,
+      // 自动重启策略
+      min_uptime: '10s',
+      max_restarts: 10,
+      // 启动延迟
+      listen_timeout: 3000,
+      kill_timeout: 5000
+    },
+    {
+      name: 'just-demo-frontend',
+      script: 'serve',
+      cwd: './frontend',
+      args: 'dist -p 5500 -s',
+      instances: 1,
+      autorestart: true,
+      watch: false,
+      max_memory_restart: '200M',
+      env: {
+        NODE_ENV: 'production'
+      },
+      error_file: './logs/frontend-error.log',
+      out_file: './logs/frontend-out.log',
+      log_date_format: 'YYYY-MM-DD HH:mm:ss Z',
+      merge_logs: true
+    }
+  ]
+};
+
--- a/frontend/.dockerignore
+++ b/frontend/.dockerignore
@ -0,0 +1,14 @@
+node_modules
+npm-debug.log
+pnpm-debug.log
+dist
+build
+.git
+.gitignore
+*.md
+.env
+.env.local
+.vscode
+.idea
+*.log
+
--- a/frontend/Dockerfile
+++ b/frontend/Dockerfile
@ -0,0 +1,42 @@
+FROM node:18-alpine AS builder
+
+WORKDIR /app
+
+# 安装 pnpm
+RUN npm install -g pnpm
+
+# 复制依赖文件
+COPY package.json pnpm-lock.yaml ./
+
+# 安装依赖
+RUN pnpm install --frozen-lockfile
+
+# 复制源代码
+COPY . .
+
+# 构建
+RUN pnpm build
+
+# 生产阶段
+FROM node:18-alpine
+
+WORKDIR /app
+
+# 安装必要工具
+RUN apk add --no-cache wget && \
+    npm install -g serve
+
+# 复制构建产物
+COPY --from=builder /app/dist ./dist
+
+# 使用非 root 用户
+RUN chown -R node:node /app
+USER node
+
+EXPOSE 5500
+
+HEALTHCHECK --interval=30s --timeout=10s --start-period=20s --retries=3 \
+  CMD wget --quiet --tries=1 --spider http://localhost:5500 || exit 1
+
+CMD ["serve", "dist", "-p", "5500", "-s"]
+
--- a/nginx.conf
+++ b/nginx.conf
@ -0,0 +1,72 @@
+server {
+    listen 80;
+    server_name your-domain.com;  # 修改为你的域名
+
+    # Gzip 压缩
+    gzip on;
+    gzip_vary on;
+    gzip_min_length 1024;
+    gzip_types text/plain text/css text/xml text/javascript application/x-javascript application/xml+rss application/json;
+
+    # 前端静态文件
+    location / {
+        proxy_pass http://localhost:5500;
+        proxy_http_version 1.1;
+        proxy_set_header Upgrade $http_upgrade;
+        proxy_set_header Connection 'upgrade';
+        proxy_set_header Host $host;
+        proxy_cache_bypass $http_upgrade;
+        
+        # 缓存设置
+        proxy_cache_valid 200 1d;
+        proxy_cache_bypass $http_upgrade;
+        add_header X-Cache-Status $upstream_cache_status;
+    }
+
+    # 后端 API
+    location /api {
+        proxy_pass http://localhost:3000;
+        proxy_http_version 1.1;
+        proxy_set_header Upgrade $http_upgrade;
+        proxy_set_header Connection 'upgrade';
+        proxy_set_header Host $host;
+        proxy_set_header X-Real-IP $remote_addr;
+        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
+        proxy_set_header X-Forwarded-Proto $scheme;
+        proxy_cache_bypass $http_upgrade;
+        
+        # 超时设置
+        proxy_connect_timeout 60s;
+        proxy_send_timeout 60s;
+        proxy_read_timeout 60s;
+    }
+
+    # 上传文件访问
+    location /uploads {
+        proxy_pass http://localhost:3000/uploads;
+        proxy_http_version 1.1;
+        proxy_set_header Host $host;
+        
+        # 缓存上传的文件
+        expires 30d;
+        add_header Cache-Control "public, immutable";
+    }
+
+    # 日志
+    access_log /var/log/nginx/just-demo-access.log;
+    error_log /var/log/nginx/just-demo-error.log;
+}
+
+# HTTPS 配置（使用 Let's Encrypt）
+# server {
+#     listen 443 ssl http2;
+#     server_name your-domain.com;
+# 
+#     ssl_certificate /etc/letsencrypt/live/your-domain.com/fullchain.pem;
+#     ssl_certificate_key /etc/letsencrypt/live/your-domain.com/privkey.pem;
+#     ssl_protocols TLSv1.2 TLSv1.3;
+#     ssl_ciphers HIGH:!aNULL:!MD5;
+# 
+#     # ... 其他配置同上
+# }
+
--- a/package.json
+++ b/package.json
@ -7,14 +7,19 @@
    "dev": "concurrently \"pnpm run dev:backend\" \"pnpm run dev:frontend\"",
    "dev:backend": "cd backend && pnpm run dev",
    "dev:frontend": "cd frontend && pnpm run dev",
-    "start": "cd backend && pnpm run start:p",
+    "start": "pm2 start ecosystem.config.js",
+    "stop": "pm2 stop all",
+    "restart": "pm2 restart all",
+    "status": "pm2 status",
+    "logs": "pm2 logs",
    "build": "pnpm run build:backend && pnpm run build:frontend",
    "build:backend": "cd backend && pnpm run build",
    "build:frontend": "cd frontend && pnpm run build",
    "install:all": "pnpm install && cd backend && pnpm install && cd ../frontend && pnpm install"
  },
  "devDependencies": {
-    "concurrently": "^8.2.2"
+    "concurrently": "^8.2.2",
+    "serve": "^14.2.1"
  }
 }