param-auto-manager/DEPLOYMENT.md

# Param Auto Manager 部署文档

## 📦 系统概览

**参数数据自动化管理系统** - 自动管理参数数据网站的系统，支持从内容库和互联网搜索数据，自动处理产品并提交到后台管理待审核区。

---

## 🚀 快速部署

### 1. 系统要求
- Python 3.10+
- Flask
- SQLite3
- Git

### 2. 安装依赖

```bash
cd works/param-auto-manager
pip install -r requirements.txt
```

### 3. 启动服务

```bash
# 方式1: 使用启动脚本
./start.sh

# 方式2: 直接运行
export PYTHONPATH="$HOME/.local/lib/python3.12/site-packages:$PYTHONPATH"
python3 app.py
```

### 4. 访问系统

- **前端界面**: http://localhost:16043 或 http://192.168.0.101:16043
- **API接口**: http://localhost:16043/api

---

## 🌐 前端界面功能

### 主要功能模块

1. **统计面板**
   - 内容库文章数量
   - 待处理产品数量
   - 处理中产品数量
   - 最近成功/失败数量

2. **待处理产品列表**
   - 查看所有待处理产品
   - 添加单个/批量产品
   - 手动触发处理
   - 移除产品
   - 批量处理按钮

3. **内容库文章**
   - 查看所有文章
   - 搜索文章（关键词）
   - 添加新文章
   - 查看文章详情
   - 删除文章

4. **处理历史**
   - 查看处理历史记录
   - 状态显示（已提交/失败/错误）
   - 查看处理详情

5. **系统配置**
   - 自动处理开关
   - 处理间隔设置
   - 批量处理数量

---

## 🔌 API接口

### 文章内容库 API
```bash
# 获取文章列表
GET /api/articles

# 搜索文章
GET /api/articles/search?q=关键词

# 创建文章
POST /api/articles
{
  "product_names": ["产品1", "产品2"],
  "category": "分类",
  "keywords": ["关键词"],
  "summary": "摘要",
  "content": "内容",
  "source": "来源"
}

# 删除文章
DELETE /api/articles/{id}
```

### 产品处理 API
```bash
# 待处理产品列表
GET /api/products/pending

# 添加产品
POST /api/products/pending
{
  "product_name": "产品名称",
  "category": "分类",
  "priority": 10
}

# 处理单个产品
POST /api/products/process
{
  "product_name": "产品名称"
}

# 批量处理
POST /api/products/process/batch
{
  "limit": 5
}

# 处理历史
GET /api/products/history
```

### 系统管理 API
```bash
# 系统统计
GET /api/system/stats

# 系统配置
GET /api/system/config
PUT /api/system/config

# 健康检查
GET /api/system/health
```

---

## ⚙️ Git仓库推送

### ⚠️ 注意事项

当前Git服务器不允许用户直接推送创建仓库（Push to create），需要管理员预先创建仓库。

### 推送步骤

**方式1: 管理员预先创建仓库**

1. 在Git服务器创建仓库:
   - 地址: `http://121.40.164.32:12007/hz4th_coder/param-auto-manager.git`
   - 账号: `hz4th_coder`

2. 推送代码:
```bash
cd works/param-auto-manager
git remote add origin http://hz4th_coder:262e7dbfce09c8cc21fbacff2b450cc3f1c3e265@121.40.164.32:12007/hz4th_coder/param-auto-manager.git
git push -u origin master
git push origin v1.1.0
```

**方式2: 请求管理员推送权限**

联系Git服务器管理员，开通用户的"Push to create"权限。

---

## 📊 使用示例

### 1. 通过前端界面操作

1. **添加待处理产品**
   - 点击"添加产品"按钮
   - 输入产品名称（如: GPT-4o）
   - 设置分类和优先级
   - 点击"添加"

2. **添加文章到内容库**
   - 点击"添加文章"按钮
   - 填写产品名称、摘要、内容等
   - 点击"添加"

3. **手动触发处理**
   - 在待处理产品列表找到产品
   - 点击"处理"按钮
   - 查看处理结果

### 2. 通过API操作

```bash
# 添加产品
curl -X POST http://localhost:16043/api/products/pending \
  -H "Content-Type: application/json" \
  -d '{"product_name":"GPT-4o","category":"AI模型","priority":10}'

# 添加文章
curl -X POST http://localhost:16043/api/articles \
  -H "Content-Type: application/json" \
  -d '{
    "product_names": ["GPT-4o"],
    "category": "AI模型",
    "keywords": ["大模型","多模态"],
    "summary": "OpenAI多模态大模型",
    "content": "详细内容...",
    "source": "官方网站"
  }'

# 触发处理
curl -X POST http://localhost:16043/api/products/process \
  -H "Content-Type: application/json" \
  -d '{"product_name":"GPT-4o"}'
```

---

## 🔧 系统配置

配置文件: `config.py`

```python
PORT = 16043                     # 服务端口
PARAMHUB_BASE_URL = 'http://localhost:16041'  # ParamHub API地址
PROCESS_INTERVAL = 300           # 自动处理间隔（秒）
BATCH_SIZE = 5                   # 批量处理数量
```

---

## 📁 项目结构

```
param-auto-manager/
├── app.py                      # 主应用
├── config.py                   # 配置文件
├── models/
│   └── database.py             # 数据库模型
├── routes/
│   ├── articles.py             # 文章API
│   ├── products.py             # 产品API
│   └── system.py               # 系统API
├── services/
│   ├── search_service.py       # 搜索服务
│   ├── process_service.py      # 处理服务
│   └── paramhub_client.py      # ParamHub客户端
├── templates/
│   └── index.html              # 前端页面
├── static/
│   ├── css/style.css           # 样式文件
│   └── js/app.js               # JavaScript文件
├── utils/
│   └── scheduler.py            # 定时任务
├── data/                       # 数据库文件
└── logs/                       # 日志文件
```

---

## ✅ 当前部署状态

- **端口**: 16043 ✅
- **状态**: 运行中
- **PID**: 2710498
- **前端**: http://192.168.0.101:16043 ✅
- **API**: http://192.168.0.101:16043/api ✅
- **数据库**: SQLite (param_auto.db) ✅
- **定时任务**: 每5分钟自动处理 ✅

---

## 📝 版本历史

- **v1.1.0** (2026-07-12): 添加前端界面和操作页面
- **v1.0.0** (2026-07-12): 初始版本，核心功能实现

---

## 🆘 常见问题

### Q: Git推送失败怎么办？
A: 需要在Git服务器上预先创建仓库，或联系管理员开通推送权限。

### Q: 如何查看日志？
A: 日志文件位于 `logs/app.log`

### Q: 如何停止服务？
A: 运行 `./stop.sh` 或手动杀掉进程

### Q: 前端页面打不开？
A: 检查服务是否启动，查看日志是否有错误

---

## 📞 支持

如有问题，请查看日志文件或联系系统管理员。