# 🚀 DesignerCEP 部署配置手册（子域名方案）

## 📐 架构概览

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

---

## 🌐 第 1 步：配置 DNS（Cloudflare）

登录 Cloudflare，添加以下 DNS 记录：

| 类型 | 名称 | 内容 | 代理状态 | TTL |
|------|------|------|----------|-----|
| A | app | 103.97.201.136 | ☁️ 已代理 | 自动 |
| A | backend | 103.97.201.136 | ☁️ 已代理 | 自动 |
| A | @ | 103.97.201.136 | ☁️ 已代理 | 自动 |

> 注：103.97.201.136 是您的服务器 IP

---

## 📁 第 2 步：服务器目录准备

SSH 登录服务器：
```bash
ssh root@103.97.201.136
```

创建目录结构：
```bash
# 创建静态文件目录
sudo mkdir -p /var/www/DesignerCEP/Server/static/app

# 设置权限
sudo chown -R www-data:www-data /var/www/DesignerCEP
sudo chmod -R 755 /var/www/DesignerCEP
```

---

## ⚙️ 第 3 步：配置 Caddy

### 方法 A：直接使用提供的配置文件

```bash
# 1. 上传 Caddyfile 到服务器
# 在本地执行：
scp Caddyfile root@103.97.201.136:/etc/caddy/Caddyfile

# 2. SSH 登录服务器
ssh root@103.97.201.136

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

# 4. 重启 Caddy
sudo systemctl restart caddy

# 5. 查看状态
sudo systemctl status caddy
```

### 方法 B：手动编辑

```bash
# 编辑 Caddy 配置
sudo nano /etc/caddy/Caddyfile

# 粘贴 Caddyfile 的内容（已在项目根目录）

# 保存后验证
sudo caddy validate --config /etc/caddy/Caddyfile

# 重启
sudo systemctl restart caddy
```

---

## 📤 第 4 步：上传前端文件

### 构建前端

在本地执行：
```bash
cd Designer

# 构建主应用
npm run build:core

# 输出在 dist_core/ 目录
```

### 上传到服务器

#### 方法 A：手动上传（临时测试）

```bash
# 在本地 Designer 目录执行
cd dist_core

# 上传所有文件到服务器
scp -r * root@103.97.201.136:/var/www/DesignerCEP/Server/static/app/
```

#### 方法 B：使用自动化脚本（推荐）

修改 `AdminTool/deploy_config.json`：
```json
{
  "host": "103.97.201.136",
  "port": "22",
  "username": "root",
  "password": "tuEj-jkaw-8mFe",
  "remote_path": "/var/www/DesignerCEP/Server/static"
}
```

然后执行：
```bash
cd AdminTool
python auto_deploy_core.py --version 1.0.0 --deploy --update-db
```

---

## 🔍 第 5 步：验证部署

### 5.1 检查文件是否上传成功

SSH 登录服务器：
```bash
ssh root@103.97.201.136

# 检查文件
ls -la /var/www/DesignerCEP/Server/static/app/

# 应该看到：
# index-core.html
# assets/
# CSInterface.js
# vite.svg
```

### 5.2 测试静态文件访问

在浏览器访问：
```
https://app.aidg168.uk/index-core.html
```

**期望结果**：能看到页面（即使可能显示错误，至少文件能加载）

### 5.3 测试 API

```bash
# 测试健康检查
curl https://backend.aidg168.uk/health

# 期望输出：
# {"status":"healthy","timestamp":"...","env":"production"}
```

### 5.4 测试完整流程

1. 在浏览器打开：`https://app.aidg168.uk/`
2. 应该能看到登录页面（如果已合并）
3. 或者 404（如果还没合并 Shell 和 Core）

---

## ⚠️ 当前问题

### 问题 1：文件名不匹配

您的 Core 构建输出是 `index-core.html`，但 Caddy 和浏览器默认访问 `index.html`。

**解决方法 A**：修改 Caddy 配置
```caddy
app.aidg168.uk {
    root * /var/www/DesignerCEP/Server/static/app
    
    # 指定默认文件
    try_files {path} /index-core.html
    
    file_server
}
```

**解决方法 B**（推荐）：修改构建配置
```typescript
// Designer/vite.config.ts
build: {
  outDir: 'dist_core',
  rollupOptions: {
    input: 'index-core.html'  // ← 改成 'index.html'
  }
}
```

### 问题 2：Shell 和 Core 还没合并

目前 Shell（登录）和 Core（主功能）还是分开的。

需要：
- 把登录页面路由加到 Core 应用
- 或者先测试用 Core 的主页

---

## 🎯 快速测试方案

### 临时方案：先让 Core 能访问

1. **修改 Caddy 配置**（访问 index-core.html）：
```caddy
app.aidg168.uk {
    root * /var/www/DesignerCEP/Server/static/app
    
    # 默认访问 index-core.html
    @root {
        path /
    }
    rewrite @root /index-core.html
    
    try_files {path} /index-core.html
    file_server
    
    encode gzip
}
```

2. **上传文件**：
```bash
cd Designer/dist_core
scp -r * root@103.97.201.136:/var/www/DesignerCEP/Server/static/app/
```

3. **访问测试**：
```
https://app.aidg168.uk/
```

---

## 📋 完整 Caddyfile 配置

复制这个内容到服务器的 `/etc/caddy/Caddyfile`：

```caddy
# ==================== DesignerCEP Caddy 配置 ====================

{
    # 邮箱用于 HTTPS 证书申请
    email admin@aidg168.uk
    
    # 如果使用 Cloudflare 橙云代理，取消下面这行注释
    # auto_https off
}

# ==================== 前端应用 ====================
app.aidg168.uk {
    # 静态文件根目录
    root * /var/www/DesignerCEP/Server/static/app
    
    # SPA 路由支持（所有请求都返回 index-core.html）
    try_files {path} /index-core.html
    
    # 提供静态文件
    file_server
    
    # ========== 缓存策略 ==========
    
    # HTML 不缓存
    @html path *.html
    header @html Cache-Control "no-cache, no-store, must-revalidate"
    
    # JS/CSS 长期缓存
    @assets path *.js *.css *.woff *.woff2
    header @assets Cache-Control "public, max-age=31536000, immutable"
    
    # 图片缓存
    @images path *.png *.jpg *.jpeg *.gif *.svg *.ico
    header @images Cache-Control "public, max-age=2592000"
    
    # ========== 安全头 ==========
    header {
        X-Frame-Options "SAMEORIGIN"
        X-Content-Type-Options "nosniff"
        X-XSS-Protection "1; mode=block"
        -Server
    }
    
    # ========== 压缩 ==========
    encode gzip
    
    # ========== 日志 ==========
    log {
        output file /var/log/caddy/app.log {
            roll_size 50mb
            roll_keep 5
        }
    }
}

# ==================== 后端 API ====================
backend.aidg168.uk {
    # 反向代理到 FastAPI (端口 8000)
    reverse_proxy localhost:8000 {
        # 传递真实 IP
        header_up X-Real-IP {remote_host}
        header_up X-Forwarded-For {remote_host}
        header_up X-Forwarded-Proto {scheme}
        header_up X-Forwarded-Host {host}
    }
    
    # ========== 压缩 ==========
    encode gzip
    
    # ========== 日志 ==========
    log {
        output file /var/log/caddy/backend.log {
            roll_size 50mb
            roll_keep 5
        }
    }
}

# ==================== 主域名重定向（可选）====================
aidg168.uk, www.aidg168.uk {
    # 重定向到应用
    redir https://app.aidg168.uk{uri} permanent
}
```

---

## ✅ 部署清单

执行以下命令：

```bash
# ========== 在本地 ==========

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

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

# 3. 上传前端文件
cd dist_core
scp -r * root@103.97.201.136:/var/www/DesignerCEP/Server/static/app/

# ========== 在服务器 ==========

# 4. SSH 登录
ssh root@103.97.201.136

# 5. 验证 Caddy 配置
sudo caddy validate --config /etc/caddy/Caddyfile

# 6. 重启 Caddy
sudo systemctl restart caddy

# 7. 查看状态
sudo systemctl status caddy

# 8. 查看日志（如果有错误）
sudo journalctl -u caddy -n 50
```

---

## 🧪 测试

### 测试 1：静态文件
```bash
curl -I https://app.aidg168.uk/
# 期望：HTTP/2 200
```

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

### 测试 3：浏览器访问
```
https://app.aidg168.uk/
```

---

## 🔧 常见问题

### Q1: 访问 app.aidg168.uk 显示 404

**检查**：
```bash
ls -la /var/www/DesignerCEP/Server/static/app/index-core.html
```

### Q2: API 请求 CORS 错误

**检查**：FastAPI 的 `ALLOWED_ORIGINS` 是否包含 `https://app.aidg168.uk`

```bash
# 编辑 .env
sudo nano /var/www/DesignerCEP/Server/.env

# 确保有：
# ALLOWED_ORIGINS=https://app.aidg168.uk,https://backend.aidg168.uk
```

### Q3: Caddy 证书申请失败

如果使用 Cloudflare 橙云代理，修改 Caddyfile：
```caddy
{
    auto_https off  # ← 添加这行
}
```

然后重启 Caddy。

---

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