# 🚀 DesignerCEP 完整部署指南

## 📊 最终架构

```
app.aidg168.uk          → 前端应用（Caddy 静态文件）
backend.aidg168.uk      → 后端 API（FastAPI + MySQL）
```

---

## 📁 项目目录结构

```
DesignerCEP/
│
├── Designer/                  ← 前端源代码
│   ├── src/                  ← Vue 源码
│   ├── dist_core/            ← ⭐ 构建输出（需要复制到 Server）
│   ├── package.json
│   └── vite.config.ts
│
├── Server/                    ← 后端 + 部署配置
│   ├── app/                  ← 后端代码（FastAPI）
│   │   ├── api/             ← API 路由
│   │   ├── models/          ← 数据模型
│   │   └── main.py          ← 入口文件
│   │
│   ├── static/               ← ⭐ 前端文件放这里
│   │   └── app/             ← ⭐ Designer/dist_core/ 复制到这里
│   │       ├── index.html
│   │       ├── assets/
│   │       └── ...
│   │
│   ├── archives/            ← Core 版本压缩包
│   ├── docker-compose.yml   ← Docker 配置
│   ├── Dockerfile           ← 后端镜像
│   ├── requirements.txt     ← Python 依赖
│   └── mysql.cnf            ← MySQL 配置
│
├── Caddyfile                 ← Caddy 配置
└── AdminTool/                ← 自动化部署工具
```

---

## 🔧 本地准备（您现在要做的）

### 步骤 1：构建前端

```bash
cd Designer
npm install
npm run build:core
```

**输出**：`Designer/dist_core/` 目录

### 步骤 2：复制前端到 Server

```powershell
# 在项目根目录执行
xcopy /E /Y Designer\dist_core\* Server\static\app\
```

**验证**：
```bash
dir Server\static\app\
# 应该看到：
# - index-core.html
# - assets/
# - CSInterface.js
# - vite.svg
```

### 步骤 3：配置环境变量

复制 `Server/.env.example` 为 `Server/.env`，并修改：

```env
ENV=production
SECRET_KEY=修改为随机密钥
ALLOWED_ORIGINS=https://app.aidg168.uk,https://backend.aidg168.uk
SMTP_USER=您的邮箱
SMTP_PASSWORD=您的邮箱密码
```

---

## 📤 上传到服务器

### 方法 A：打包上传（推荐）

```powershell
# 1. 压缩 Server 文件夹
Compress-Archive -Path Server\* -DestinationPath DesignerCEP-Server.zip

# 2. 上传到服务器
scp DesignerCEP-Server.zip root@103.97.201.136:/root/

# 3. 上传 Caddyfile
scp Caddyfile root@103.97.201.136:/etc/caddy/Caddyfile
```

### 方法 B：使用自动化脚本

```bash
cd AdminTool
python auto_deploy_core.py --version 1.0.0 --deploy
```

---

## 🐳 服务器部署

### SSH 登录服务器

```bash
ssh root@103.97.201.136
```

### 步骤 1：解压文件

```bash
cd /root
unzip DesignerCEP-Server.zip -d /var/www/DesignerCEP/Server
cd /var/www/DesignerCEP/Server
```

### 步骤 2：配置 Caddy

```bash
# Caddyfile 已上传到 /etc/caddy/Caddyfile

# 验证配置
caddy validate --config /etc/caddy/Caddyfile

# 重启 Caddy
systemctl restart caddy
systemctl status caddy
```

### 步骤 3：启动 Docker 服务

```bash
cd /var/www/DesignerCEP/Server

# 启动所有服务（Caddy + FastAPI + MySQL）
docker-compose up -d

# 查看日志
docker-compose logs -f

# 查看运行状态
docker-compose ps
```

---

## ✅ 验证部署

### 1. 检查服务状态

```bash
# Caddy
systemctl status caddy

# Docker 服务
docker-compose ps
```

### 2. 测试 API

```bash
curl https://backend.aidg168.uk/health
# 期望：{"status":"healthy"}
```

### 3. 测试前端

浏览器访问：
```
https://app.aidg168.uk/
```

**期望**：能看到登录页面

---

## 📋 完整部署清单

- [ ] 前端已构建：`Designer/dist_core/`
- [ ] 前端已复制到：`Server/static/app/`
- [ ] Server 文件夹已打包
- [ ] Caddyfile 已上传到服务器
- [ ] Server 已上传并解压
- [ ] `.env` 已配置
- [ ] Caddy 已重启
- [ ] Docker 服务已启动
- [ ] `https://app.aidg168.uk/` 可访问
- [ ] `https://backend.aidg168.uk/health` 可访问

---

## 🎯 快速命令汇总

### 本地准备

```powershell
# 1. 构建前端
cd Designer
npm run build:core

# 2. 复制前端到 Server
cd ..
xcopy /E /Y Designer\dist_core\* Server\static\app\

# 3. 检查文件
dir Server\static\app\

# 4. 打包 Server
Compress-Archive -Path Server\* -DestinationPath Server.zip
```

### 服务器部署

```bash
# 1. 上传文件
scp Server.zip root@103.97.201.136:/root/
scp Caddyfile root@103.97.201.136:/etc/caddy/Caddyfile

# 2. SSH 登录
ssh root@103.97.201.136

# 3. 解压并部署
cd /root
unzip Server.zip -d /var/www/DesignerCEP/Server
cd /var/www/DesignerCEP/Server

# 4. 启动服务
systemctl restart caddy
docker-compose up -d

# 5. 查看日志
docker-compose logs -f
```

---

**完成后访问 https://app.aidg168.uk/ 测试！** 🎉