# 装备成本估算系统部署指南

## 一、系统打包

### 1. 创建部署包结构

```bash
mkdir -p deploy/equipment_cost_system/{backend,frontend,docs}
```

### 2. 准备部署文件

#### 2.1 后端文件

```bash
cd deploy/equipment_cost_system/backend
mkdir -p {src,scripts,config,data,logs,models}
cp -r ../../../src/* src/
cp ../../../requirements.txt ./
cp ../../../.env.example config/.env.template
```

#### 2.2 前端文件

```bash
cd ../frontend
mkdir -p {src,public,dist}
cp -r ../../frontend/src/* src/
cp -r ../../frontend/public/* public/
cp ../../../frontend/package.json ./
cp ../../../frontend/vite.config.js ./
cp ../../../frontend/.env.production ./
```

#### 2.3 复制文档

```bash
cd ../docs
cp -r ../../docs/deploy/* ./
```

#### 2.4 创建部署脚本

```bash
touch scripts/{install.sh,start.sh,stop.sh}
```

### 3. 部署脚本内容

#### 3.1 安装脚本 (install.sh)

```bash
#!/bin/bash

# 安装 Python 依赖
python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt

# 创建必要的目录
mkdir -p logs
mkdir -p data
mkdir -p models

# 配置文件
if [ ! -f config/.env ]; then
    cp config/.env.template config/.env
    echo "请修改 config/.env 中的配置"
fi

# 初始化数据库
read -p "请输入MySQL root密码: " mysqlpass
mysql -u root -p$mysqlpass < src/schema.sql

# 设置权限
chmod +x scripts/*.sh
```

#### 3.2 启动脚本 (start.sh)

```bash
#!/bin/bash

# 激活虚拟环境
source venv/bin/activate

# 检查配置文件
if [ ! -f config/.env ]; then
    echo "错误: 配置文件不存在"
    exit 1
fi

# 启动服务
export $(cat config/.env | xargs)
gunicorn -w 4 -b 0.0.0.0:5001 "src.app:create_app()" --daemon

echo "服务已启动，访问 http://localhost:5001"
```

#### 3.3 停止脚本 (stop.sh)

```bash
#!/bin/bash

# 查找并停止 gunicorn 进程
pkill -f gunicorn

echo "服务已停止"
```

### 4. 创建部署包

```bash
cd ..
tar -czf equipment_cost_system.tar.gz equipment_cost_system/
```

## 二、部署步骤

### 1. 系统要求

- Linux 服务器 (推荐 Ubuntu 20.04+)
- Python 3.8+
- MySQL 8.0+

### 2. 安装部署

```bash
# 解压部署包
tar -xzf equipment_cost_system.tar.gz
cd equipment_cost_system

# 运行安装脚本
bash scripts/install.sh

# 修改配置文件
vim config/.env

# 启动服务
bash scripts/start.sh
```

### 3. 验证部署

```bash
# 检查服务状态
curl http://localhost:5001/api/

# 检查日志
tail -f logs/api.log
```

## 三、维护说明

### 1. 日常维护

```bash
# 查看日志
tail -f logs/api.log

# 备份数据库
mysqldump -u root -p equipment_cost_db > backup/$(date +%Y%m%d).sql

# 清理旧日志
find logs/ -name "*.log" -mtime +30 -delete
```

### 2. 更新部署

```bash
# 停止服务
bash scripts/stop.sh

# 备份数据
cp -r data data_backup_$(date +%Y%m%d)

# 更新代码
# ... 更新相关文件 ...

# 重启服务
bash scripts/start.sh
```

### 3. 故障处理

```bash
# 检查服务状态
ps aux | grep gunicorn

# 检查数据库连接
mysql -u root -p -e "show databases;"

# 重启服务
bash scripts/stop.sh
bash scripts/start.sh
```

## 四、安全建议

1. 文件权限设置

```bash
# 设置适当的文件权限
chmod 755 scripts/*.sh
chmod 600 config/.env
chmod 700 logs models data
```

2. 数据库安全

- 使用强密码
- 限制数据库访问IP
- 定期备份数据

3. 服务器配置

- 配置防火墙规则
- 启用 SSL/TLS
- 定期更新系统

## 五、监控方案

### 1. 系统监控

```bash
# 检查CPU和内存使用
top -b -n 1

# 检查磁盘使用
df -h

# 检查网络连接
netstat -tunlp
```

### 2. 应用监控

```bash
# 检查API响应时间
curl -w "@curl-format.txt" -o /dev/null -s "http://localhost:5001/api/"

# 检查错误日志
grep "ERROR" logs/api.log
```

### 3. 告警设置

- 配置日志告警
- 设置资源使用阈值告警
- 配置服务可用性监控